niceeval 0.12.2-canary.31 → 0.13.0

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

@@ -0,0 +1,73 @@
+import { type AnalysisIssue, type EvidenceRef, type MeasureFormat, type MetricValue } from "../../analysis/index.mjs";
+/**
+ * Analysis owns every metric's denominator, missingness, state, Evidence, and
+ * provenance. These descriptors are the small Report catalog expressed with
+ * current Analysis definitions.
+ */
+export declare const passRate: import("../../analysis/definitions.mjs").Measure<import("../../analysis/definitions.mjs").LogicalSlot, number>;
+/** Mean recorded `eval.run` duration across the fixed logical-Slot denominator. */
+export declare const durationMs: import("../../analysis/definitions.mjs").Measure<import("../../analysis/definitions.mjs").LogicalSlot, number>;
+/** Mean recorded input plus output token count across the fixed denominator. */
+export declare const tokens: import("../../analysis/definitions.mjs").Measure<import("../../analysis/definitions.mjs").LogicalSlot, number>;
+export { costUSD, totalCostUSD } from "../../analysis/index.mjs";
+/**
+ * Presentation facts retain the original metric and every Analysis-owned
+ * diagnostic channel.  They are safe for a component to inspect, but not a
+ * replacement metric that can be re-aggregated.
+ */
+export interface MetricFacts<Value = number> {
+    readonly value: Value | null;
+    readonly state: MetricValue<Value>["state"];
+    readonly samples: number;
+    readonly total: number;
+    readonly basis: MetricValue<Value>["basis"];
+    readonly issues: readonly AnalysisIssue[];
+    readonly refs: readonly EvidenceRef[];
+    readonly unit?: string;
+    readonly format?: MeasureFormat;
+    readonly better?: MetricValue<Value>["better"];
+    readonly bounds?: MetricValue<Value>["bounds"];
+    readonly complete: boolean;
+    readonly coverage: number | null;
+    readonly metric: MetricValue<Value>;
+}
+/** Extract display facts without discarding the complete MetricValue. */
+export declare function metricFacts<Value>(metric: MetricValue<Value>): MetricFacts<Value>;
+/** The contributor/denominator fraction; null means the declared denominator is zero. */
+export declare function metricCoverage(metric: MetricValue): number | null;
+/** A numeric metric is usable only when Analysis closed a finite scalar. */
+export declare function hasMetricValue(metric: MetricValue): metric is MetricValue<number> & {
+    readonly value: number;
+};
+/**
+ * A closed business row may collect existing MetricValue diagnostics, but it
+ * cannot manufacture one or alter its total, state, issues, refs, or value.
+ */
+export interface EvidenceRow {
+    readonly issues: readonly AnalysisIssue[];
+    readonly refs: readonly EvidenceRef[];
+}
+declare const evidenceRowMetricDiagnostic: unique symbol;
+type MetricFieldKeys<Fields extends object> = {
+    [Key in keyof Fields]-?: Fields[Key] extends MetricValue ? Key : never;
+}[keyof Fields];
+type EvidenceRowInput<Fields extends object> = [MetricFieldKeys<Fields>] extends [never] ? {
+    readonly [evidenceRowMetricDiagnostic]: "evidenceRow requires at least one MetricValue field";
+} : unknown;
+/**
+ * Structural validation for an already-closed Analysis MetricValue.  It is a
+ * display-boundary guard, not a constructor: Report never exports
+ * `metricValue()`.
+ */
+export declare function isMetricValue(value: unknown): value is MetricValue;
+/**
+ * Copies an ordinary presentation row while deterministically retaining the
+ * existing Analysis diagnostics from all its metric fields.
+ */
+export declare function evidenceRow<const Fields extends object>(fields: Fields & EvidenceRowInput<Fields>): Readonly<Fields & EvidenceRow>;
+/**
+ * Sorting changes only display order.  Unlike Analysis-issued ClosedRows, the
+ * result is an ordinary frozen array and deliberately has no closed-row
+ * identity or aggregate metadata.
+ */
+export declare function sortRowsByMetric<Row extends object>(rows: readonly Row[], field: keyof Row, direction?: "asc" | "desc"): readonly Row[];

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

@@ -0,0 +1,73 @@
+import { type AnalysisIssue, type EvidenceRef, type MeasureFormat, type MetricValue } from "../../analysis/index.js";
+/**
+ * Analysis owns every metric's denominator, missingness, state, Evidence, and
+ * provenance. These descriptors are the small Report catalog expressed with
+ * current Analysis definitions.
+ */
+export declare const passRate: import("../../analysis/definitions.js").Measure<import("../../analysis/definitions.js").LogicalSlot, number>;
+/** Mean recorded `eval.run` duration across the fixed logical-Slot denominator. */
+export declare const durationMs: import("../../analysis/definitions.js").Measure<import("../../analysis/definitions.js").LogicalSlot, number>;
+/** Mean recorded input plus output token count across the fixed denominator. */
+export declare const tokens: import("../../analysis/definitions.js").Measure<import("../../analysis/definitions.js").LogicalSlot, number>;
+export { costUSD, totalCostUSD } from "../../analysis/index.js";
+/**
+ * Presentation facts retain the original metric and every Analysis-owned
+ * diagnostic channel.  They are safe for a component to inspect, but not a
+ * replacement metric that can be re-aggregated.
+ */
+export interface MetricFacts<Value = number> {
+    readonly value: Value | null;
+    readonly state: MetricValue<Value>["state"];
+    readonly samples: number;
+    readonly total: number;
+    readonly basis: MetricValue<Value>["basis"];
+    readonly issues: readonly AnalysisIssue[];
+    readonly refs: readonly EvidenceRef[];
+    readonly unit?: string;
+    readonly format?: MeasureFormat;
+    readonly better?: MetricValue<Value>["better"];
+    readonly bounds?: MetricValue<Value>["bounds"];
+    readonly complete: boolean;
+    readonly coverage: number | null;
+    readonly metric: MetricValue<Value>;
+}
+/** Extract display facts without discarding the complete MetricValue. */
+export declare function metricFacts<Value>(metric: MetricValue<Value>): MetricFacts<Value>;
+/** The contributor/denominator fraction; null means the declared denominator is zero. */
+export declare function metricCoverage(metric: MetricValue): number | null;
+/** A numeric metric is usable only when Analysis closed a finite scalar. */
+export declare function hasMetricValue(metric: MetricValue): metric is MetricValue<number> & {
+    readonly value: number;
+};
+/**
+ * A closed business row may collect existing MetricValue diagnostics, but it
+ * cannot manufacture one or alter its total, state, issues, refs, or value.
+ */
+export interface EvidenceRow {
+    readonly issues: readonly AnalysisIssue[];
+    readonly refs: readonly EvidenceRef[];
+}
+declare const evidenceRowMetricDiagnostic: unique symbol;
+type MetricFieldKeys<Fields extends object> = {
+    [Key in keyof Fields]-?: Fields[Key] extends MetricValue ? Key : never;
+}[keyof Fields];
+type EvidenceRowInput<Fields extends object> = [MetricFieldKeys<Fields>] extends [never] ? {
+    readonly [evidenceRowMetricDiagnostic]: "evidenceRow requires at least one MetricValue field";
+} : unknown;
+/**
+ * Structural validation for an already-closed Analysis MetricValue.  It is a
+ * display-boundary guard, not a constructor: Report never exports
+ * `metricValue()`.
+ */
+export declare function isMetricValue(value: unknown): value is MetricValue;
+/**
+ * Copies an ordinary presentation row while deterministically retaining the
+ * existing Analysis diagnostics from all its metric fields.
+ */
+export declare function evidenceRow<const Fields extends object>(fields: Fields & EvidenceRowInput<Fields>): Readonly<Fields & EvidenceRow>;
+/**
+ * Sorting changes only display order.  Unlike Analysis-issued ClosedRows, the
+ * result is an ordinary frozen array and deliberately has no closed-row
+ * identity or aggregate metadata.
+ */
+export declare function sortRowsByMetric<Row extends object>(rows: readonly Row[], field: keyof Row, direction?: "asc" | "desc"): readonly Row[];

package/dist/report/model/metrics.js

@@ -0,0 +1,26 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./metrics.cjs");
+const __niceevalExport0 = __niceevalCanonical["costUSD"];
+export { __niceevalExport0 as costUSD };
+const __niceevalExport1 = __niceevalCanonical["durationMs"];
+export { __niceevalExport1 as durationMs };
+const __niceevalExport2 = __niceevalCanonical["evidenceRow"];
+export { __niceevalExport2 as evidenceRow };
+const __niceevalExport3 = __niceevalCanonical["hasMetricValue"];
+export { __niceevalExport3 as hasMetricValue };
+const __niceevalExport4 = __niceevalCanonical["isMetricValue"];
+export { __niceevalExport4 as isMetricValue };
+const __niceevalExport5 = __niceevalCanonical["metricCoverage"];
+export { __niceevalExport5 as metricCoverage };
+const __niceevalExport6 = __niceevalCanonical["metricFacts"];
+export { __niceevalExport6 as metricFacts };
+const __niceevalExport7 = __niceevalCanonical["passRate"];
+export { __niceevalExport7 as passRate };
+const __niceevalExport8 = __niceevalCanonical["sortRowsByMetric"];
+export { __niceevalExport8 as sortRowsByMetric };
+const __niceevalExport9 = __niceevalCanonical["tokens"];
+export { __niceevalExport9 as tokens };
+const __niceevalExport10 = __niceevalCanonical["totalCostUSD"];
+export { __niceevalExport10 as totalCostUSD };
+//# sourceMappingURL=metrics.js.map

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

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

package/dist/report/model/pricing.cjs

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COST_SCATTER_NO_PROFILE_TEXT = exports.COST_SUMMARY_NO_PROFILE_TEXT = void 0;
+exports.formatCostProjectionAmountText = formatCostProjectionAmountText;
+exports.formatCostProjectionCellText = formatCostProjectionCellText;
+exports.formatCostProjectionCellDetail = formatCostProjectionCellDetail;
+exports.isCostMetricValue = isCostMetricValue;
+const cost_ts_1 = require("../../analysis/cost.cjs");
+const locale_ts_1 = require("./locale.cjs");
+const metrics_ts_1 = require("./metrics.cjs");
+/** Exact no-profile copy for the official total-cost summary. */
+exports.COST_SUMMARY_NO_PROFILE_TEXT = Object.freeze({
+    en: "Cost unavailable — this report does not declare a PricingProfile.",
+    "zh-CN": "成本不可用——此报告未声明 PricingProfile。",
+});
+/** Exact no-profile copy for the official cost × pass-rate scatter. */
+exports.COST_SCATTER_NO_PROFILE_TEXT = Object.freeze({
+    en: "Cost × pass rate scatter unavailable — this report does not declare a PricingProfile.",
+    "zh-CN": "成本 × 通过率散点图不可用——此报告未声明 PricingProfile。",
+});
+/** Compact table-cell amount copied from the Analysis-closed projection. */
+function formatCostProjectionAmountText(cell, locale) {
+    switch (cell.projection.state) {
+        case "available":
+        case "partial":
+            return `$${cell.projection.combined.amount}`;
+        case "unavailable":
+            return (0, locale_ts_1.localeText)(locale, "costProjection.unavailable");
+        default: {
+            const exhaustive = cell.projection;
+            return exhaustive;
+        }
+    }
+}
+/**
+ * Produces a compact display from the closed projection. Amount strings pass
+ * through verbatim: Report deliberately does not parse, round, or otherwise
+ * re-compute Analysis's canonical decimal values.
+ */
+function formatCostProjectionCellText(cell, locale) {
+    const projection = cell.projection;
+    if (projection.state === "unavailable" || projection.combined === null) {
+        return Object.freeze({
+            text: (0, locale_ts_1.localeText)(locale, "costProjection.unavailable"),
+            detail: formatCostProjectionCellDetail(cell, locale),
+        });
+    }
+    const parts = [
+        `${knownValueLabel(projection, locale)} ${moneyText(projection.combined)}`,
+        (0, locale_ts_1.localeText)(locale, `costProjection.basis.${projection.basis}`),
+    ];
+    if (projection.state === "partial") {
+        parts.push((0, locale_ts_1.localeText)(locale, "costProjection.state.partial"));
+    }
+    return Object.freeze({
+        text: parts.join(" · "),
+        detail: formatCostProjectionCellDetail(cell, locale),
+    });
+}
+/**
+ * Preserves the closed ledger summary in text form. This is presentation only:
+ * all values are copied directly from `cell.projection`.
+ */
+function formatCostProjectionCellDetail(cell, locale) {
+    const projection = cell.projection;
+    const lines = [];
+    lines.push((0, locale_ts_1.localeText)(locale, "costProjection.profile", {
+        identity: projection.profile.contentIdentity,
+        currency: projection.profile.currency,
+        decimals: projection.profile.display.decimalPlaces,
+    }));
+    lines.push((0, locale_ts_1.localeText)(locale, "costProjection.provenance", {
+        source: projection.profile.provenance.source,
+        asOf: projection.profile.provenance.asOf,
+    }));
+    if (projection.observed !== null) {
+        lines.push(`${(0, locale_ts_1.localeText)(locale, "costProjection.providerObserved").padEnd(20)} ${moneyText(projection.observed)}`);
+    }
+    if (projection.estimated !== null) {
+        lines.push(`${(0, locale_ts_1.localeText)(locale, "costProjection.profileEstimated").padEnd(20)} ${moneyText(projection.estimated)}`);
+    }
+    if (projection.combined !== null) {
+        lines.push(`${knownValueLabel(projection, locale).padEnd(28)} ${moneyText(projection.combined)} · ` +
+            (0, locale_ts_1.localeText)(locale, "costProjection.coverage", { samples: cell.samples, total: cell.total }));
+    }
+    for (const entry of projection.observedOtherCurrencies) {
+        lines.push(`${(0, locale_ts_1.localeText)(locale, "costProjection.observedElsewhere").padEnd(20)} ${entry.currency} ${entry.amount} · ` +
+            (0, locale_ts_1.localeText)(locale, "costProjection.notConverted"));
+    }
+    for (const reason of projection.reasons) {
+        lines.push((0, locale_ts_1.localeText)(locale, "costProjection.reason", {
+            provider: reason.provider ?? "",
+            code: reason.code,
+        }));
+    }
+    return lines.join("\n");
+}
+/**
+ * Runtime narrowing for an Analysis-issued cost cell. Analysis owns the deep
+ * projection guard; Report verifies only the normal MetricValue shell and its
+ * required cost presentation fields.
+ */
+function isCostMetricValue(value) {
+    if (!(0, metrics_ts_1.isMetricValue)(value) || !Object.hasOwn(value, "projection"))
+        return false;
+    if (value.format !== "currency-usd" || value.better !== "lower")
+        return false;
+    const projection = value.projection;
+    // The Host's machine boundary additionally matches this identity against
+    // the captured cost measure entry before a projection leaves the Report.
+    return (0, cost_ts_1.isCostProjectionValue)(projection) && projection.state === value.state;
+}
+function moneyText(value) {
+    return `${value.currency} ${value.amount}`;
+}
+function knownValueLabel(projection, locale) {
+    switch (projection.aggregate.kind) {
+        case "mean":
+            return (0, locale_ts_1.localeText)(locale, "costProjection.meanPerContributingSlot");
+        case "total":
+            return (0, locale_ts_1.localeText)(locale, "costProjection.totalKnownCost");
+        default:
+            return (0, locale_ts_1.localeText)(locale, "costProjection.knownValue");
+    }
+}
+//# sourceMappingURL=pricing.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["pricing.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Report's one-way view of Analysis-owned cost projections.\n *\n * Pricing, decimal arithmetic, display rounding, and projection construction\n * all belong to Analysis. This module only reads the already-closed\n * `CostMetricValue.projection` carried by the same metric cell that supplies\n * the ordinary numeric axis value.\n */\nimport type { CostMetricValue, CostProjectionValue, } from \"../../analysis/index.ts\";\nimport { isCostProjectionValue } from \"../../analysis/cost.ts\";\nimport { localeText, type LocalizedText, type ReportLocale, } from \"./locale.ts\";\nimport { isMetricValue } from \"./metrics.ts\";\n/** Exact no-profile copy for the official total-cost summary. */\nexport const COST_SUMMARY_NO_PROFILE_TEXT: LocalizedText = Object.freeze({\n    en: \"Cost unavailable — this report does not declare a PricingProfile.\",\n    \"zh-CN\": \"成本不可用——此报告未声明 PricingProfile。\",\n});\n/** Exact no-profile copy for the official cost × pass-rate scatter. */\nexport const COST_SCATTER_NO_PROFILE_TEXT: LocalizedText = Object.freeze({\n    en: \"Cost × pass rate scatter unavailable — this report does not declare a PricingProfile.\",\n    \"zh-CN\": \"成本 × 通过率散点图不可用——此报告未声明 PricingProfile。\",\n});\nexport interface CostProjectionCellText {\n    readonly text: string;\n    readonly detail?: string;\n}\n/** Compact table-cell amount copied from the Analysis-closed projection. */\nexport function formatCostProjectionAmountText(cell: CostMetricValue, locale: ReportLocale): string {\n    switch (cell.projection.state) {\n        case \"available\":\n        case \"partial\":\n            return `$${cell.projection.combined.amount}`;\n        case \"unavailable\":\n            return localeText(locale, \"costProjection.unavailable\");\n        default: {\n            const exhaustive: never = cell.projection;\n            return exhaustive;\n        }\n    }\n}\n/**\n * Produces a compact display from the closed projection. Amount strings pass\n * through verbatim: Report deliberately does not parse, round, or otherwise\n * re-compute Analysis's canonical decimal values.\n */\nexport function formatCostProjectionCellText(cell: CostMetricValue, locale: ReportLocale): CostProjectionCellText {\n    const projection = cell.projection;\n    if (projection.state === \"unavailable\" || projection.combined === null) {\n        return Object.freeze({\n            text: localeText(locale, \"costProjection.unavailable\"),\n            detail: formatCostProjectionCellDetail(cell, locale),\n        });\n    }\n    const parts = [\n        `${knownValueLabel(projection, locale)} ${moneyText(projection.combined)}`,\n        localeText(locale, `costProjection.basis.${projection.basis}`),\n    ];\n    if (projection.state === \"partial\") {\n        parts.push(localeText(locale, \"costProjection.state.partial\"));\n    }\n    return Object.freeze({\n        text: parts.join(\" · \"),\n        detail: formatCostProjectionCellDetail(cell, locale),\n    });\n}\n/**\n * Preserves the closed ledger summary in text form. This is presentation only:\n * all values are copied directly from `cell.projection`.\n */\nexport function formatCostProjectionCellDetail(cell: CostMetricValue, locale: ReportLocale): string {\n    const projection = cell.projection;\n    const lines: string[] = [];\n    lines.push(localeText(locale, \"costProjection.profile\", {\n        identity: projection.profile.contentIdentity,\n        currency: projection.profile.currency,\n        decimals: projection.profile.display.decimalPlaces,\n    }));\n    lines.push(localeText(locale, \"costProjection.provenance\", {\n        source: projection.profile.provenance.source,\n        asOf: projection.profile.provenance.asOf,\n    }));\n    if (projection.observed !== null) {\n        lines.push(`${localeText(locale, \"costProjection.providerObserved\").padEnd(20)} ${moneyText(projection.observed)}`);\n    }\n    if (projection.estimated !== null) {\n        lines.push(`${localeText(locale, \"costProjection.profileEstimated\").padEnd(20)} ${moneyText(projection.estimated)}`);\n    }\n    if (projection.combined !== null) {\n        lines.push(`${knownValueLabel(projection, locale).padEnd(28)} ${moneyText(projection.combined)} · ` +\n            localeText(locale, \"costProjection.coverage\", { samples: cell.samples, total: cell.total }));\n    }\n    for (const entry of projection.observedOtherCurrencies) {\n        lines.push(`${localeText(locale, \"costProjection.observedElsewhere\").padEnd(20)} ${entry.currency} ${entry.amount} · ` +\n            localeText(locale, \"costProjection.notConverted\"));\n    }\n    for (const reason of projection.reasons) {\n        lines.push(localeText(locale, \"costProjection.reason\", {\n            provider: reason.provider ?? \"\",\n            code: reason.code,\n        }));\n    }\n    return lines.join(\"\\n\");\n}\n/**\n * Runtime narrowing for an Analysis-issued cost cell. Analysis owns the deep\n * projection guard; Report verifies only the normal MetricValue shell and its\n * required cost presentation fields.\n */\nexport function isCostMetricValue(value: unknown): value is CostMetricValue {\n    if (!isMetricValue(value) || !Object.hasOwn(value, \"projection\"))\n        return false;\n    if (value.format !== \"currency-usd\" || value.better !== \"lower\")\n        return false;\n    const projection = (value as {\n        readonly projection?: unknown;\n    }).projection;\n    // The Host's machine boundary additionally matches this identity against\n    // the captured cost measure entry before a projection leaves the Report.\n    return isCostProjectionValue(projection) && projection.state === value.state;\n}\nfunction moneyText(value: {\n    readonly currency: string;\n    readonly amount: string;\n}): string {\n    return `${value.currency} ${value.amount}`;\n}\nfunction knownValueLabel(projection: CostProjectionValue, locale: ReportLocale): string {\n    switch (projection.aggregate.kind) {\n        case \"mean\":\n            return localeText(locale, \"costProjection.meanPerContributingSlot\");\n        case \"total\":\n            return localeText(locale, \"costProjection.totalKnownCost\");\n        default:\n            return localeText(locale, \"costProjection.knownValue\");\n    }\n}\n"]}

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

@@ -0,0 +1,37 @@
+/**
+ * Report's one-way view of Analysis-owned cost projections.
+ *
+ * Pricing, decimal arithmetic, display rounding, and projection construction
+ * all belong to Analysis. This module only reads the already-closed
+ * `CostMetricValue.projection` carried by the same metric cell that supplies
+ * the ordinary numeric axis value.
+ */
+import type { CostMetricValue } from "../../analysis/index.cjs";
+import { type LocalizedText, type ReportLocale } from "./locale.cjs";
+/** Exact no-profile copy for the official total-cost summary. */
+export declare const COST_SUMMARY_NO_PROFILE_TEXT: LocalizedText;
+/** Exact no-profile copy for the official cost × pass-rate scatter. */
+export declare const COST_SCATTER_NO_PROFILE_TEXT: LocalizedText;
+export interface CostProjectionCellText {
+    readonly text: string;
+    readonly detail?: string;
+}
+/** Compact table-cell amount copied from the Analysis-closed projection. */
+export declare function formatCostProjectionAmountText(cell: CostMetricValue, locale: ReportLocale): string;
+/**
+ * Produces a compact display from the closed projection. Amount strings pass
+ * through verbatim: Report deliberately does not parse, round, or otherwise
+ * re-compute Analysis's canonical decimal values.
+ */
+export declare function formatCostProjectionCellText(cell: CostMetricValue, locale: ReportLocale): CostProjectionCellText;
+/**
+ * Preserves the closed ledger summary in text form. This is presentation only:
+ * all values are copied directly from `cell.projection`.
+ */
+export declare function formatCostProjectionCellDetail(cell: CostMetricValue, locale: ReportLocale): string;
+/**
+ * Runtime narrowing for an Analysis-issued cost cell. Analysis owns the deep
+ * projection guard; Report verifies only the normal MetricValue shell and its
+ * required cost presentation fields.
+ */
+export declare function isCostMetricValue(value: unknown): value is CostMetricValue;

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

@@ -0,0 +1,37 @@
+/**
+ * Report's one-way view of Analysis-owned cost projections.
+ *
+ * Pricing, decimal arithmetic, display rounding, and projection construction
+ * all belong to Analysis. This module only reads the already-closed
+ * `CostMetricValue.projection` carried by the same metric cell that supplies
+ * the ordinary numeric axis value.
+ */
+import type { CostMetricValue } from "../../analysis/index.mjs";
+import { type LocalizedText, type ReportLocale } from "./locale.mjs";
+/** Exact no-profile copy for the official total-cost summary. */
+export declare const COST_SUMMARY_NO_PROFILE_TEXT: LocalizedText;
+/** Exact no-profile copy for the official cost × pass-rate scatter. */
+export declare const COST_SCATTER_NO_PROFILE_TEXT: LocalizedText;
+export interface CostProjectionCellText {
+    readonly text: string;
+    readonly detail?: string;
+}
+/** Compact table-cell amount copied from the Analysis-closed projection. */
+export declare function formatCostProjectionAmountText(cell: CostMetricValue, locale: ReportLocale): string;
+/**
+ * Produces a compact display from the closed projection. Amount strings pass
+ * through verbatim: Report deliberately does not parse, round, or otherwise
+ * re-compute Analysis's canonical decimal values.
+ */
+export declare function formatCostProjectionCellText(cell: CostMetricValue, locale: ReportLocale): CostProjectionCellText;
+/**
+ * Preserves the closed ledger summary in text form. This is presentation only:
+ * all values are copied directly from `cell.projection`.
+ */
+export declare function formatCostProjectionCellDetail(cell: CostMetricValue, locale: ReportLocale): string;
+/**
+ * Runtime narrowing for an Analysis-issued cost cell. Analysis owns the deep
+ * projection guard; Report verifies only the normal MetricValue shell and its
+ * required cost presentation fields.
+ */
+export declare function isCostMetricValue(value: unknown): value is CostMetricValue;

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

@@ -0,0 +1,37 @@
+/**
+ * Report's one-way view of Analysis-owned cost projections.
+ *
+ * Pricing, decimal arithmetic, display rounding, and projection construction
+ * all belong to Analysis. This module only reads the already-closed
+ * `CostMetricValue.projection` carried by the same metric cell that supplies
+ * the ordinary numeric axis value.
+ */
+import type { CostMetricValue } from "../../analysis/index.js";
+import { type LocalizedText, type ReportLocale } from "./locale.js";
+/** Exact no-profile copy for the official total-cost summary. */
+export declare const COST_SUMMARY_NO_PROFILE_TEXT: LocalizedText;
+/** Exact no-profile copy for the official cost × pass-rate scatter. */
+export declare const COST_SCATTER_NO_PROFILE_TEXT: LocalizedText;
+export interface CostProjectionCellText {
+    readonly text: string;
+    readonly detail?: string;
+}
+/** Compact table-cell amount copied from the Analysis-closed projection. */
+export declare function formatCostProjectionAmountText(cell: CostMetricValue, locale: ReportLocale): string;
+/**
+ * Produces a compact display from the closed projection. Amount strings pass
+ * through verbatim: Report deliberately does not parse, round, or otherwise
+ * re-compute Analysis's canonical decimal values.
+ */
+export declare function formatCostProjectionCellText(cell: CostMetricValue, locale: ReportLocale): CostProjectionCellText;
+/**
+ * Preserves the closed ledger summary in text form. This is presentation only:
+ * all values are copied directly from `cell.projection`.
+ */
+export declare function formatCostProjectionCellDetail(cell: CostMetricValue, locale: ReportLocale): string;
+/**
+ * Runtime narrowing for an Analysis-issued cost cell. Analysis owns the deep
+ * projection guard; Report verifies only the normal MetricValue shell and its
+ * required cost presentation fields.
+ */
+export declare function isCostMetricValue(value: unknown): value is CostMetricValue;

package/dist/report/model/pricing.js

@@ -0,0 +1,16 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./pricing.cjs");
+const __niceevalExport0 = __niceevalCanonical["COST_SCATTER_NO_PROFILE_TEXT"];
+export { __niceevalExport0 as COST_SCATTER_NO_PROFILE_TEXT };
+const __niceevalExport1 = __niceevalCanonical["COST_SUMMARY_NO_PROFILE_TEXT"];
+export { __niceevalExport1 as COST_SUMMARY_NO_PROFILE_TEXT };
+const __niceevalExport2 = __niceevalCanonical["formatCostProjectionAmountText"];
+export { __niceevalExport2 as formatCostProjectionAmountText };
+const __niceevalExport3 = __niceevalCanonical["formatCostProjectionCellDetail"];
+export { __niceevalExport3 as formatCostProjectionCellDetail };
+const __niceevalExport4 = __niceevalCanonical["formatCostProjectionCellText"];
+export { __niceevalExport4 as formatCostProjectionCellText };
+const __niceevalExport5 = __niceevalCanonical["isCostMetricValue"];
+export { __niceevalExport5 as isCostMetricValue };
+//# sourceMappingURL=pricing.js.map

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

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

package/dist/report/model/text-layout.cjs

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.columns = exports.bar = exports.indent = exports.wrapText = exports.padStart = exports.padEnd = void 0;
 exports.charDisplayWidth = charDisplayWidth;
 exports.stringWidth = stringWidth;
 exports.padDisplay = padDisplay;
@@ -182,4 +183,11 @@ function joinColumns(blocks, columnWidths, separator = " │ ") {
     }
     return out.join("\n");
 }
+/** v0.12 public aliases sharing the exact same width implementation. */
+exports.padEnd = padDisplay;
+exports.padStart = padStartDisplay;
+exports.wrapText = wrapDisplay;
+exports.indent = indentBlock;
+exports.bar = textBar;
+exports.columns = joinColumns;
 //# sourceMappingURL=text-layout.cjs.map

package/dist/report/model/text-layout.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"text-layout.js","sourceRoot":"","sources":["text-layout.ts"],"names":[],"mappings":"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","sourcesContent":["// text 面的排版工具:显示宽度(CJK 记 2 列)、填充、折行、对齐列、字符条形。\n// 全部纯函数、零依赖;niceeval show 的终端输出与 Row 分栏都建立在这几样上。\n//\n// 其中七个是公开面(`niceeval/report` 以 stringWidth / padEnd / padStart / wrapText /\n// indent / bar / columns 的名字导出,见 ../index.ts):自定义组件的 text 面必须拿到与\n// 官方组件同一把尺子,否则「用户组件与官方组件对等」是假的。它们的 TSDoc 就是公开文档,\n// 改签名即破坏公开面。renderAlignedRows 不导出 —— 表格的能力由 <Table> 原语承担。\n/** 终端显示宽度:CJK / 全角记 2 列,其余记 1。启发式覆盖常用区段,够对齐表格用。 */\nexport function charDisplayWidth(codePoint: number): number {\n    if ((codePoint >= 0x1100 && codePoint <= 0x115f) ||\n        (codePoint >= 0x2e80 && codePoint <= 0x303e) ||\n        (codePoint >= 0x3041 && codePoint <= 0x33ff) ||\n        (codePoint >= 0x3400 && codePoint <= 0x4dbf) ||\n        (codePoint >= 0x4e00 && codePoint <= 0x9fff) ||\n        (codePoint >= 0xa000 && codePoint <= 0xa4cf) ||\n        (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||\n        (codePoint >= 0xf900 && codePoint <= 0xfaff) ||\n        (codePoint >= 0xfe30 && codePoint <= 0xfe4f) ||\n        (codePoint >= 0xff00 && codePoint <= 0xff60) ||\n        (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||\n        (codePoint >= 0x20000 && codePoint <= 0x3fffd)) {\n        return 2;\n    }\n    return 1;\n}\n/**\n * 一段文本在终端里占几列:CJK / 全角字符记 2 列,其余记 1 列。\n *\n * 对齐终端输出用它,不要用 `String.prototype.length`——`length` 数的是 UTF-16 码元,\n * 一个汉字占 2 个显示列却只算 1 个码元,中文一进来列就错位。\n *\n * @param text 任意文本。\n * @returns 显示列数。\n */\nexport function stringWidth(text: string): number {\n    let width = 0;\n    for (const ch of text)\n        width += charDisplayWidth(ch.codePointAt(0)!);\n    return width;\n}\n/**\n * 按显示宽度在右侧补空格(左对齐)。超宽不截断,如实溢出。\n *\n * `String.prototype.padEnd` 的显示宽度版:内容含中文时才对得齐。\n *\n * @param text 要补齐的文本。\n * @param width 目标显示宽度。\n * @returns 补齐后的文本。\n */\nexport function padDisplay(text: string, width: number): string {\n    const gap = width - stringWidth(text);\n    return gap > 0 ? text + \" \".repeat(gap) : text;\n}\n/**\n * 按显示宽度在左侧补空格(右对齐)。超宽不截断,如实溢出。\n *\n * 数字列靠它对齐小数点。\n *\n * @param text 要补齐的文本。\n * @param width 目标显示宽度。\n * @returns 补齐后的文本。\n */\nexport function padStartDisplay(text: string, width: number): string {\n    const gap = width - stringWidth(text);\n    return gap > 0 ? \" \".repeat(gap) + text : text;\n}\n/**\n * 按显示宽度折行:优先在空格处断,单个词超宽(URL / 中文长句)按列宽硬断。\n *\n * @param text 要折行的文本(`\\n` 分段)。\n * @param width 每行的最大显示宽度。\n * @returns 折好的行;至少一行(空串输入 → `[\"\"]`)。\n */\nexport function wrapDisplay(text: string, width: number): string[] {\n    const max = Math.max(4, width);\n    const lines: string[] = [];\n    for (const paragraph of text.split(\"\\n\")) {\n        let line = \"\";\n        let lineWidth = 0;\n        const flush = () => {\n            lines.push(line);\n            line = \"\";\n            lineWidth = 0;\n        };\n        for (const word of paragraph.split(\" \")) {\n            const wordWidth = stringWidth(word);\n            if (lineWidth > 0 && lineWidth + 1 + wordWidth > max)\n                flush();\n            if (wordWidth > max) {\n                // 单词本身超宽(URL / 中文长句):逐字符硬断\n                for (const ch of word) {\n                    const w = charDisplayWidth(ch.codePointAt(0)!);\n                    if (lineWidth + w > max)\n                        flush();\n                    line += ch;\n                    lineWidth += w;\n                }\n                continue;\n            }\n            if (lineWidth > 0) {\n                line += \" \";\n                lineWidth += 1;\n            }\n            line += word;\n            lineWidth += wordWidth;\n        }\n        flush();\n    }\n    return lines.length > 0 ? lines : [\"\"];\n}\n/**\n * 给一整块文本的每行加同一段前缀(嵌套块缩进)。空行不加,不留尾随空格。\n *\n * @param block 多行文本。\n * @param indent 每行的前缀,通常是若干空格。\n * @returns 缩进后的文本块。\n */\nexport function indentBlock(block: string, indent: string): string {\n    return block\n        .split(\"\\n\")\n        .map((line) => (line.length > 0 ? indent + line : line))\n        .join(\"\\n\");\n}\n/** 列对齐方向:`\"left\"` 是默认,`\"right\"` 按显示宽度右对齐(数字列用)。 */\nexport type ColumnAlign = \"left\" | \"right\";\n/**\n * 对齐列渲染:每列宽 = 该列最宽格的显示宽度,列间 3 空格,行尾不留空白。首行是表头。\n * `align[c]` 给第 c 列的对齐方向,缺省 `\"left\"`。\n *\n * 内部件:公开面是 <Table> 原语(见 ./table.ts 的 renderTableText,它先按 ctx.width\n * 定好列宽再调这里)。不导出到 `niceeval/report` —— 两条并行的建表路径只会让作者选错。\n */\nexport function renderAlignedRows(rows: string[][], align: readonly ColumnAlign[] = [], separator = \"   \"): string {\n    const columnCount = Math.max(...rows.map((r) => r.length), 0);\n    const widths: number[] = [];\n    for (let c = 0; c < columnCount; c++) {\n        widths.push(Math.max(...rows.map((r) => stringWidth(r[c] ?? \"\"))));\n    }\n    return rows\n        .map((row) => row\n        .map((cell, c) => (align[c] === \"right\" ? padStartDisplay(cell, widths[c]) : padDisplay(cell, widths[c])))\n        .join(separator)\n        .replace(/\\s+$/, \"\"))\n        .join(\"\\n\");\n}\n/**\n * 字符条形:比例 → `█` 填充、`░` 补齐到 `barWidth` 显示列。比例超出 [0, 1] 时钳住。\n *\n * @param ratio 填充比例,0 到 1。\n * @param barWidth 整条的显示宽度。\n * @returns 定宽的字符条。\n */\nexport function textBar(ratio: number, barWidth: number): string {\n    const clamped = Math.max(0, Math.min(1, ratio));\n    const filled = Math.round(clamped * barWidth);\n    return \"█\".repeat(filled) + \"░\".repeat(barWidth - filled);\n}\n/**\n * 多块文本并排成栏(`Row` 的 text 面):逐行拼接,各栏按显示宽度补齐,短栏补空行。\n *\n * @param blocks 每栏一块多行文本。\n * @param columnWidths 每栏的显示宽度,与 `blocks` 一一对应。\n * @param separator 栏间分隔符,默认 `\" │ \"`。\n * @returns 并排后的文本块。\n */\nexport function joinColumns(blocks: string[], columnWidths: number[], separator = \" │ \"): string {\n    const columns = blocks.map((block) => block.split(\"\\n\"));\n    const height = Math.max(...columns.map((lines) => lines.length), 0);\n    const out: string[] = [];\n    for (let i = 0; i < height; i++) {\n        const parts = columns.map((lines, c) => padDisplay(lines[i] ?? \"\", columnWidths[c]));\n        out.push(parts.join(separator).replace(/\\s+$/, \"\"));\n    }\n    return out.join(\"\\n\");\n}\n"]}
+{"version":3,"file":"text-layout.js","sourceRoot":"","sources":["text-layout.ts"],"names":[],"mappings":"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","sourcesContent":["// text 面的排版工具:显示宽度(CJK 记 2 列)、填充、折行、对齐列、字符条形。\n// 全部纯函数、零依赖;niceeval show 的终端输出与 Row 分栏都建立在这几样上。\n//\n// 其中七个是公开面(`niceeval/report` 以 stringWidth / padEnd / padStart / wrapText /\n// indent / bar / columns 的名字导出,见 ../index.ts):自定义组件的 text 面必须拿到与\n// 官方组件同一把尺子,否则「用户组件与官方组件对等」是假的。它们的 TSDoc 就是公开文档,\n// 改签名即破坏公开面。renderAlignedRows 不导出 —— 表格的能力由 <Table> 原语承担。\n/** 终端显示宽度:CJK / 全角记 2 列,其余记 1。启发式覆盖常用区段,够对齐表格用。 */\nexport function charDisplayWidth(codePoint: number): number {\n    if ((codePoint >= 0x1100 && codePoint <= 0x115f) ||\n        (codePoint >= 0x2e80 && codePoint <= 0x303e) ||\n        (codePoint >= 0x3041 && codePoint <= 0x33ff) ||\n        (codePoint >= 0x3400 && codePoint <= 0x4dbf) ||\n        (codePoint >= 0x4e00 && codePoint <= 0x9fff) ||\n        (codePoint >= 0xa000 && codePoint <= 0xa4cf) ||\n        (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||\n        (codePoint >= 0xf900 && codePoint <= 0xfaff) ||\n        (codePoint >= 0xfe30 && codePoint <= 0xfe4f) ||\n        (codePoint >= 0xff00 && codePoint <= 0xff60) ||\n        (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||\n        (codePoint >= 0x20000 && codePoint <= 0x3fffd)) {\n        return 2;\n    }\n    return 1;\n}\n/**\n * 一段文本在终端里占几列:CJK / 全角字符记 2 列,其余记 1 列。\n *\n * 对齐终端输出用它,不要用 `String.prototype.length`——`length` 数的是 UTF-16 码元,\n * 一个汉字占 2 个显示列却只算 1 个码元,中文一进来列就错位。\n *\n * @param text 任意文本。\n * @returns 显示列数。\n */\nexport function stringWidth(text: string): number {\n    let width = 0;\n    for (const ch of text)\n        width += charDisplayWidth(ch.codePointAt(0)!);\n    return width;\n}\n/**\n * 按显示宽度在右侧补空格(左对齐)。超宽不截断,如实溢出。\n *\n * `String.prototype.padEnd` 的显示宽度版:内容含中文时才对得齐。\n *\n * @param text 要补齐的文本。\n * @param width 目标显示宽度。\n * @returns 补齐后的文本。\n */\nexport function padDisplay(text: string, width: number): string {\n    const gap = width - stringWidth(text);\n    return gap > 0 ? text + \" \".repeat(gap) : text;\n}\n/**\n * 按显示宽度在左侧补空格(右对齐)。超宽不截断,如实溢出。\n *\n * 数字列靠它对齐小数点。\n *\n * @param text 要补齐的文本。\n * @param width 目标显示宽度。\n * @returns 补齐后的文本。\n */\nexport function padStartDisplay(text: string, width: number): string {\n    const gap = width - stringWidth(text);\n    return gap > 0 ? \" \".repeat(gap) + text : text;\n}\n/**\n * 按显示宽度折行:优先在空格处断,单个词超宽(URL / 中文长句)按列宽硬断。\n *\n * @param text 要折行的文本(`\\n` 分段)。\n * @param width 每行的最大显示宽度。\n * @returns 折好的行;至少一行(空串输入 → `[\"\"]`)。\n */\nexport function wrapDisplay(text: string, width: number): string[] {\n    const max = Math.max(4, width);\n    const lines: string[] = [];\n    for (const paragraph of text.split(\"\\n\")) {\n        let line = \"\";\n        let lineWidth = 0;\n        const flush = () => {\n            lines.push(line);\n            line = \"\";\n            lineWidth = 0;\n        };\n        for (const word of paragraph.split(\" \")) {\n            const wordWidth = stringWidth(word);\n            if (lineWidth > 0 && lineWidth + 1 + wordWidth > max)\n                flush();\n            if (wordWidth > max) {\n                // 单词本身超宽(URL / 中文长句):逐字符硬断\n                for (const ch of word) {\n                    const w = charDisplayWidth(ch.codePointAt(0)!);\n                    if (lineWidth + w > max)\n                        flush();\n                    line += ch;\n                    lineWidth += w;\n                }\n                continue;\n            }\n            if (lineWidth > 0) {\n                line += \" \";\n                lineWidth += 1;\n            }\n            line += word;\n            lineWidth += wordWidth;\n        }\n        flush();\n    }\n    return lines.length > 0 ? lines : [\"\"];\n}\n/**\n * 给一整块文本的每行加同一段前缀(嵌套块缩进)。空行不加,不留尾随空格。\n *\n * @param block 多行文本。\n * @param indent 每行的前缀,通常是若干空格。\n * @returns 缩进后的文本块。\n */\nexport function indentBlock(block: string, indent: string): string {\n    return block\n        .split(\"\\n\")\n        .map((line) => (line.length > 0 ? indent + line : line))\n        .join(\"\\n\");\n}\n/** 列对齐方向:`\"left\"` 是默认,`\"right\"` 按显示宽度右对齐(数字列用)。 */\nexport type ColumnAlign = \"left\" | \"right\";\n/**\n * 对齐列渲染:每列宽 = 该列最宽格的显示宽度,列间 3 空格,行尾不留空白。首行是表头。\n * `align[c]` 给第 c 列的对齐方向,缺省 `\"left\"`。\n *\n * 内部件:公开面是 <Table> 原语(见 ./table.ts 的 renderTableText,它先按 ctx.width\n * 定好列宽再调这里)。不导出到 `niceeval/report` —— 两条并行的建表路径只会让作者选错。\n */\nexport function renderAlignedRows(rows: string[][], align: readonly ColumnAlign[] = [], separator = \"   \"): string {\n    const columnCount = Math.max(...rows.map((r) => r.length), 0);\n    const widths: number[] = [];\n    for (let c = 0; c < columnCount; c++) {\n        widths.push(Math.max(...rows.map((r) => stringWidth(r[c] ?? \"\"))));\n    }\n    return rows\n        .map((row) => row\n        .map((cell, c) => (align[c] === \"right\" ? padStartDisplay(cell, widths[c]) : padDisplay(cell, widths[c])))\n        .join(separator)\n        .replace(/\\s+$/, \"\"))\n        .join(\"\\n\");\n}\n/**\n * 字符条形:比例 → `█` 填充、`░` 补齐到 `barWidth` 显示列。比例超出 [0, 1] 时钳住。\n *\n * @param ratio 填充比例,0 到 1。\n * @param barWidth 整条的显示宽度。\n * @returns 定宽的字符条。\n */\nexport function textBar(ratio: number, barWidth: number): string {\n    const clamped = Math.max(0, Math.min(1, ratio));\n    const filled = Math.round(clamped * barWidth);\n    return \"█\".repeat(filled) + \"░\".repeat(barWidth - filled);\n}\n/**\n * 多块文本并排成栏(`Row` 的 text 面):逐行拼接,各栏按显示宽度补齐,短栏补空行。\n *\n * @param blocks 每栏一块多行文本。\n * @param columnWidths 每栏的显示宽度,与 `blocks` 一一对应。\n * @param separator 栏间分隔符,默认 `\" │ \"`。\n * @returns 并排后的文本块。\n */\nexport function joinColumns(blocks: string[], columnWidths: number[], separator = \" │ \"): string {\n    const columns = blocks.map((block) => block.split(\"\\n\"));\n    const height = Math.max(...columns.map((lines) => lines.length), 0);\n    const out: string[] = [];\n    for (let i = 0; i < height; i++) {\n        const parts = columns.map((lines, c) => padDisplay(lines[i] ?? \"\", columnWidths[c]));\n        out.push(parts.join(separator).replace(/\\s+$/, \"\"));\n    }\n    return out.join(\"\\n\");\n}\n/** v0.12 public aliases sharing the exact same width implementation. */\nexport const padEnd = padDisplay;\nexport const padStart = padStartDisplay;\nexport const wrapText = wrapDisplay;\nexport const indent = indentBlock;\nexport const bar = textBar;\nexport const columns = joinColumns;\n"]}

package/dist/report/model/text-layout.d.cts

@@ -73,3 +73,10 @@ export declare function textBar(ratio: number, barWidth: number): string;
  * @returns 并排后的文本块。
  */
 export declare function joinColumns(blocks: string[], columnWidths: number[], separator?: string): string;
+/** v0.12 public aliases sharing the exact same width implementation. */
+export declare const padEnd: typeof padDisplay;
+export declare const padStart: typeof padStartDisplay;
+export declare const wrapText: typeof wrapDisplay;
+export declare const indent: typeof indentBlock;
+export declare const bar: typeof textBar;
+export declare const columns: typeof joinColumns;

package/dist/report/model/text-layout.d.mts

@@ -73,3 +73,10 @@ export declare function textBar(ratio: number, barWidth: number): string;
  * @returns 并排后的文本块。
  */
 export declare function joinColumns(blocks: string[], columnWidths: number[], separator?: string): string;
+/** v0.12 public aliases sharing the exact same width implementation. */
+export declare const padEnd: typeof padDisplay;
+export declare const padStart: typeof padStartDisplay;
+export declare const wrapText: typeof wrapDisplay;
+export declare const indent: typeof indentBlock;
+export declare const bar: typeof textBar;
+export declare const columns: typeof joinColumns;

package/dist/report/model/text-layout.d.ts

@@ -73,3 +73,10 @@ export declare function textBar(ratio: number, barWidth: number): string;
  * @returns 并排后的文本块。
  */
 export declare function joinColumns(blocks: string[], columnWidths: number[], separator?: string): string;
+/** v0.12 public aliases sharing the exact same width implementation. */
+export declare const padEnd: typeof padDisplay;
+export declare const padStart: typeof padStartDisplay;
+export declare const wrapText: typeof wrapDisplay;
+export declare const indent: typeof indentBlock;
+export declare const bar: typeof textBar;
+export declare const columns: typeof joinColumns;