niceeval 0.12.2-canary.31 → 0.13.0

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

@@ -1,241 +0,0 @@
-import type { AnalysisSample } from "../../analysis/index.js";
-import type { ProjectedSample, ProjectionAccess } from "../../projection/model.js";
-import { type RecordProjection } from "../../projection/projector.js";
-import type { ReportCalculationResult } from "../execution/results.js";
-import type { ReportDocument } from "../semantic/document.js";
-import { type ReportComponentId, type ReportDownloadPath, type ReportId, type ReportInstanceKey, type ReportRoute } from "./identity.js";
-declare const reportDataPlanTypeId: unique symbol;
-declare const reportDataPlanCardinalityTypeId: unique symbol;
-declare const reportCalculationTypeId: unique symbol;
-declare const reportPageTypeId: unique symbol;
-declare const reportPageFamilyTypeId: unique symbol;
-declare const reportDownloadTypeId: unique symbol;
-declare const reportTypeId: unique symbol;
-type DataPlanCardinality = "empty" | "non-empty";
-type AnyRecordProjection = RecordProjection<any, any>;
-interface DataPlan<Shape extends object, Cardinality extends DataPlanCardinality> {
-    readonly [reportDataPlanTypeId]: {
-        readonly _Shape: () => Shape;
-    };
-    readonly [reportDataPlanCardinalityTypeId]: Cardinality;
-}
-/**
- * A package-created, named projection shape. Its actual declarations live in
- * a private WeakMap rather than in a forgeable object field.
- */
-export type ReportDataPlan<Shape extends object = object> = DataPlan<Shape, DataPlanCardinality>;
-type EmptyReportDataPlan = DataPlan<object, "empty">;
-type NonEmptyReportDataPlan = DataPlan<object, "non-empty">;
-export type ReportDataShape<Plan extends ReportDataPlan> = Plan extends DataPlan<infer Shape, DataPlanCardinality> ? Shape : never;
-export type ReportProjectedValues<Plan extends ReportDataPlan> = {
-    readonly [Key in keyof ReportDataShape<Plan>]: ReportDataShape<Plan>[Key] extends RecordProjection<infer Access, infer Value> ? ProjectedSample<Access, Value> : never;
-};
-export type ReportCompleteness = "allow-partial" | "require-complete";
-export interface ReportDataState {
-    readonly state: "complete" | "partial";
-}
-type CalculationCompleteness<Inputs extends ReportDataPlan> = Inputs extends NonEmptyReportDataPlan ? {
-    readonly completeness: ReportCompleteness;
-} : {
-    readonly completeness?: never;
-};
-/** One static projection-derived value with no dependency on another Calculation. */
-export type ReportCalculation<Inputs extends ReportDataPlan, Value> = Readonly<{
-    readonly id: ReportComponentId;
-    readonly inputs: Inputs;
-    readonly calculate: (context: {
-        readonly sample: AnalysisSample;
-        readonly inputs: ReportProjectedValues<Inputs>;
-    }) => Value;
-    readonly [reportCalculationTypeId]: (value: Value) => Value;
-}> & CalculationCompleteness<Inputs>;
-export type AnyReportCalculation = ReportCalculation<any, any>;
-export type ReportCalculationSet = Readonly<Record<string, AnyReportCalculation>>;
-export type ReportCalculationResults<Set extends object> = {
-    readonly [Key in keyof Set]: Set[Key] extends ReportCalculation<any, infer Value> ? ReportCalculationResult<Value> : never;
-};
-export type ReportComponentContext<Inputs extends ReportDataPlan | undefined = undefined, Calculations extends object = {}> = {
-    readonly sample: AnalysisSample;
-    readonly inputs: Inputs extends ReportDataPlan ? ReportProjectedValues<Inputs> : {};
-    readonly calculations: ReportCalculationResults<Calculations>;
-};
-/** An opaque fixed Page. Its callback is retained only in package-private authority. */
-export interface ReportPage {
-    readonly id: ReportComponentId;
-    readonly route: ReportRoute;
-    readonly [reportPageTypeId]: () => void;
-}
-/** An opaque PageFamily whose instances are expanded only from already-formed values. */
-export interface ReportPageFamily {
-    readonly id: ReportComponentId;
-    readonly [reportPageFamilyTypeId]: () => void;
-}
-export interface ReportDownloadFile {
-    readonly path: ReportDownloadPath;
-    readonly mediaType: string;
-    readonly bytes: Uint8Array;
-}
-/** An opaque authored Download. */
-export interface ReportDownload {
-    readonly id: ReportComponentId;
-    readonly [reportDownloadTypeId]: () => void;
-}
-/** The sole public aggregate for a Report authoring module. */
-export interface Report {
-    readonly id: ReportId;
-    readonly calculations: ReportCalculationSet;
-    readonly pages: readonly (ReportPage | ReportPageFamily)[];
-    readonly downloads: readonly ReportDownload[];
-    readonly [reportTypeId]: () => void;
-}
-interface DataPlanContents {
-    readonly entries: readonly {
-        readonly key: string;
-        readonly projection: RecordProjection<ProjectionAccess, unknown>;
-    }[];
-    readonly cardinality: DataPlanCardinality;
-}
-type AuthorCallback = (...arguments_: never[]) => unknown;
-interface ComponentContents {
-    readonly calculations: ReportCalculationSet;
-    readonly calculationsById: readonly AnyReportCalculation[];
-    readonly inputs?: ReportDataPlan;
-    readonly completeness?: ReportCompleteness;
-}
-interface CalculationContents {
-    readonly calculations: ReportCalculationSet;
-    readonly calculationsById: readonly AnyReportCalculation[];
-    readonly inputs: ReportDataPlan;
-    readonly completeness?: ReportCompleteness;
-    readonly calculate: AuthorCallback;
-}
-interface PageContents extends ComponentContents {
-    readonly render: AuthorCallback;
-}
-interface PageFamilyContents extends ComponentContents {
-    readonly instances: AuthorCallback;
-    readonly key: AuthorCallback;
-    readonly route: AuthorCallback;
-    readonly render: AuthorCallback;
-}
-interface DownloadContents extends ComponentContents {
-    readonly build: AuthorCallback;
-}
-interface ReportContents {
-    readonly calculations: ReportCalculationSet;
-    readonly calculationsById: readonly AnyReportCalculation[];
-    readonly pages: readonly (ReportPage | ReportPageFamily)[];
-    readonly downloads: readonly ReportDownload[];
-}
-type ProjectionShapeCheck<Shape extends object> = {
-    readonly [Key in keyof Shape]: Shape[Key] extends AnyRecordProjection ? unknown : never;
-};
-type ShapeCardinality<Shape extends object> = keyof Shape extends never ? "empty" : "non-empty";
-type CalculationSetCheck<Set extends object> = {
-    readonly [Key in keyof Set]: Set[Key] extends AnyReportCalculation ? unknown : never;
-};
-/**
- * Captures an exact named projection shape. Runtime validation rejects copied
- * projections, accessors, symbols, and non-plain objects before any host I/O.
- */
-export declare function reportInputs<const Shape extends object>(shape: Shape & ProjectionShapeCheck<Shape>): DataPlan<Shape, ShapeCardinality<Shape>>;
-export declare function defineCalculation<Inputs extends EmptyReportDataPlan, Value>(definition: {
-    readonly id: ReportComponentId;
-    readonly inputs: Inputs;
-    readonly completeness?: never;
-    readonly calculate: (context: {
-        readonly sample: AnalysisSample;
-        readonly inputs: ReportProjectedValues<Inputs>;
-    }) => Value;
-}): ReportCalculation<Inputs, Value>;
-export declare function defineCalculation<Inputs extends NonEmptyReportDataPlan, Value>(definition: {
-    readonly id: ReportComponentId;
-    readonly inputs: Inputs;
-    readonly completeness: ReportCompleteness;
-    readonly calculate: (context: {
-        readonly sample: AnalysisSample;
-        readonly inputs: ReportProjectedValues<Inputs>;
-    }) => Value;
-}): ReportCalculation<Inputs, Value>;
-export declare function definePage<Calculations extends object = {}>(definition: {
-    readonly id: ReportComponentId;
-    readonly route: ReportRoute;
-    readonly inputs?: never;
-    readonly completeness?: never;
-    readonly calculations?: Calculations & CalculationSetCheck<Calculations>;
-    readonly render: (context: ReportComponentContext<undefined, Calculations>) => ReportDocument;
-}): ReportPage;
-export declare function definePage<Inputs extends NonEmptyReportDataPlan, Calculations extends object = {}>(definition: {
-    readonly id: ReportComponentId;
-    readonly route: ReportRoute;
-    readonly inputs: Inputs;
-    readonly completeness: ReportCompleteness;
-    readonly calculations?: Calculations & CalculationSetCheck<Calculations>;
-    readonly render: (context: ReportComponentContext<Inputs, Calculations>) => ReportDocument;
-}): ReportPage;
-export declare function definePageFamily<Instance, Calculations extends object = {}>(definition: {
-    readonly id: ReportComponentId;
-    readonly inputs?: never;
-    readonly completeness?: never;
-    readonly calculations?: Calculations & CalculationSetCheck<Calculations>;
-    readonly instances: (context: ReportComponentContext<undefined, Calculations>) => Iterable<Instance>;
-    readonly key: (instance: Instance) => ReportInstanceKey;
-    readonly route: (instance: Instance) => ReportRoute;
-    readonly render: (context: ReportComponentContext<undefined, Calculations> & {
-        readonly instance: Instance;
-    }) => ReportDocument;
-}): ReportPageFamily;
-export declare function definePageFamily<Inputs extends NonEmptyReportDataPlan, Instance, Calculations extends object = {}>(definition: {
-    readonly id: ReportComponentId;
-    readonly inputs: Inputs;
-    readonly completeness: ReportCompleteness;
-    readonly calculations?: Calculations & CalculationSetCheck<Calculations>;
-    readonly instances: (context: ReportComponentContext<Inputs, Calculations>) => Iterable<Instance>;
-    readonly key: (instance: Instance) => ReportInstanceKey;
-    readonly route: (instance: Instance) => ReportRoute;
-    readonly render: (context: ReportComponentContext<Inputs, Calculations> & {
-        readonly instance: Instance;
-    }) => ReportDocument;
-}): ReportPageFamily;
-export declare function defineDownload<Calculations extends object = {}>(definition: {
-    readonly id: ReportComponentId;
-    readonly inputs?: never;
-    readonly completeness?: never;
-    readonly calculations?: Calculations & CalculationSetCheck<Calculations>;
-    readonly build: (context: ReportComponentContext<undefined, Calculations>) => Iterable<ReportDownloadFile>;
-}): ReportDownload;
-export declare function defineDownload<Inputs extends NonEmptyReportDataPlan, Calculations extends object = {}>(definition: {
-    readonly id: ReportComponentId;
-    readonly inputs: Inputs;
-    readonly completeness: ReportCompleteness;
-    readonly calculations?: Calculations & CalculationSetCheck<Calculations>;
-    readonly build: (context: ReportComponentContext<Inputs, Calculations>) => Iterable<ReportDownloadFile>;
-}): ReportDownload;
-export declare function defineReport<Calculations extends object = {}>(definition: {
-    readonly id: ReportId;
-    readonly calculations?: Calculations & CalculationSetCheck<Calculations>;
-    readonly pages: readonly (ReportPage | ReportPageFamily)[];
-    readonly downloads?: readonly ReportDownload[];
-}): Report;
-export declare function isReport(value: unknown): value is Report;
-/** @internal Exact-identity bridge used only by author/internal.ts. */
-export declare function authorInternalReportContents(report: Report): ReportContents;
-/** @internal Exact-identity bridge used only by author/internal.ts. */
-export declare function authorInternalDataPlanContents(plan: ReportDataPlan): DataPlanContents;
-/** @internal Exact-identity bridge used only by author/internal.ts. */
-export declare function authorInternalCalculationContents(calculation: AnyReportCalculation): CalculationContents;
-/** @internal Exact-identity bridge used only by author/internal.ts. */
-export declare function authorInternalPageContents(page: ReportPage): PageContents;
-/** @internal Exact-identity bridge used only by author/internal.ts. */
-export declare function authorInternalPageFamilyContents(family: ReportPageFamily): PageFamilyContents;
-/** @internal Exact-identity bridge used only by author/internal.ts. */
-export declare function authorInternalPageMemberContents(member: ReportPage | ReportPageFamily): {
-    readonly kind: "page";
-    readonly contents: PageContents;
-} | {
-    readonly kind: "page-family";
-    readonly contents: PageFamilyContents;
-};
-/** @internal Exact-identity bridge used only by author/internal.ts. */
-export declare function authorInternalDownloadContents(download: ReportDownload): DownloadContents;
-export {};

package/dist/report/author/model.js

@@ -1,32 +0,0 @@
-import { createRequire as __niceevalCreateRequire } from "node:module";
-const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
-const __niceevalCanonical = __niceevalRequire("./model.cjs");
-const __niceevalExport0 = __niceevalCanonical["authorInternalCalculationContents"];
-export { __niceevalExport0 as authorInternalCalculationContents };
-const __niceevalExport1 = __niceevalCanonical["authorInternalDataPlanContents"];
-export { __niceevalExport1 as authorInternalDataPlanContents };
-const __niceevalExport2 = __niceevalCanonical["authorInternalDownloadContents"];
-export { __niceevalExport2 as authorInternalDownloadContents };
-const __niceevalExport3 = __niceevalCanonical["authorInternalPageContents"];
-export { __niceevalExport3 as authorInternalPageContents };
-const __niceevalExport4 = __niceevalCanonical["authorInternalPageFamilyContents"];
-export { __niceevalExport4 as authorInternalPageFamilyContents };
-const __niceevalExport5 = __niceevalCanonical["authorInternalPageMemberContents"];
-export { __niceevalExport5 as authorInternalPageMemberContents };
-const __niceevalExport6 = __niceevalCanonical["authorInternalReportContents"];
-export { __niceevalExport6 as authorInternalReportContents };
-const __niceevalExport7 = __niceevalCanonical["defineCalculation"];
-export { __niceevalExport7 as defineCalculation };
-const __niceevalExport8 = __niceevalCanonical["defineDownload"];
-export { __niceevalExport8 as defineDownload };
-const __niceevalExport9 = __niceevalCanonical["definePage"];
-export { __niceevalExport9 as definePage };
-const __niceevalExport10 = __niceevalCanonical["definePageFamily"];
-export { __niceevalExport10 as definePageFamily };
-const __niceevalExport11 = __niceevalCanonical["defineReport"];
-export { __niceevalExport11 as defineReport };
-const __niceevalExport12 = __niceevalCanonical["isReport"];
-export { __niceevalExport12 as isReport };
-const __niceevalExport13 = __niceevalCanonical["reportInputs"];
-export { __niceevalExport13 as reportInputs };
-//# sourceMappingURL=model.js.map

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

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

package/dist/report/execution/index.cjs

@@ -1,20 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./model.cjs"), exports);
-__exportStar(require("./problems.cjs"), exports);
-__exportStar(require("./results.cjs"), exports);
-//# sourceMappingURL=index.cjs.map

package/dist/report/execution/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,gDAA8B;AAC9B,+CAA6B","sourcesContent":["export * from \"./model.ts\";\nexport * from \"./problems.ts\";\nexport * from \"./results.ts\";\n"]}

package/dist/report/execution/index.d.cts

@@ -1,3 +0,0 @@
-export * from "./model.cjs";
-export * from "./problems.cjs";
-export * from "./results.cjs";

package/dist/report/execution/index.d.mts

@@ -1,3 +0,0 @@
-export * from "./model.mjs";
-export * from "./problems.mjs";
-export * from "./results.mjs";

package/dist/report/execution/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./model.js";
-export * from "./problems.js";
-export * from "./results.js";

package/dist/report/execution/index.js

@@ -1,30 +0,0 @@
-import { createRequire as __niceevalCreateRequire } from "node:module";
-const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
-const __niceevalCanonical = __niceevalRequire("./index.cjs");
-const __niceevalExport0 = __niceevalCanonical["REPORT_DOWNLOAD_FILES_MAX"];
-export { __niceevalExport0 as REPORT_DOWNLOAD_FILES_MAX };
-const __niceevalExport1 = __niceevalCanonical["REPORT_DOWNLOAD_FILE_BYTES_MAX"];
-export { __niceevalExport1 as REPORT_DOWNLOAD_FILE_BYTES_MAX };
-const __niceevalExport2 = __niceevalCanonical["REPORT_PAGES_MAX"];
-export { __niceevalExport2 as REPORT_PAGES_MAX };
-const __niceevalExport3 = __niceevalCanonical["REPORT_PROBLEM_TABLE_MAX"];
-export { __niceevalExport3 as REPORT_PROBLEM_TABLE_MAX };
-const __niceevalExport4 = __niceevalCanonical["isReportExecution"];
-export { __niceevalExport4 as isReportExecution };
-const __niceevalExport5 = __niceevalCanonical["isReportProblemId"];
-export { __niceevalExport5 as isReportProblemId };
-const __niceevalExport6 = __niceevalCanonical["isReportProblemTable"];
-export { __niceevalExport6 as isReportProblemTable };
-const __niceevalExport7 = __niceevalCanonical["isReportProjectionId"];
-export { __niceevalExport7 as isReportProjectionId };
-const __niceevalExport8 = __niceevalCanonical["makeReportExecution"];
-export { __niceevalExport8 as makeReportExecution };
-const __niceevalExport9 = __niceevalCanonical["reportExecution"];
-export { __niceevalExport9 as reportExecution };
-const __niceevalExport10 = __niceevalCanonical["reportProblemIdFor"];
-export { __niceevalExport10 as reportProblemIdFor };
-const __niceevalExport11 = __niceevalCanonical["reportProblemTable"];
-export { __niceevalExport11 as reportProblemTable };
-const __niceevalExport12 = __niceevalCanonical["reportProjectionId"];
-export { __niceevalExport12 as reportProjectionId };
-//# sourceMappingURL=index.js.map

package/dist/report/execution/problems.cjs

@@ -1,210 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.REPORT_PROBLEM_TABLE_MAX = void 0;
-exports.reportProblemTable = reportProblemTable;
-exports.isReportProblemTable = isReportProblemTable;
-exports.reportProblemIdFor = reportProblemIdFor;
-exports.isReportProblemId = isReportProblemId;
-const effect_1 = require("effect");
-const identity_ts_1 = require("../author/identity.cjs");
-const reportProblemIdTypeId = Symbol("@niceeval/report/ReportProblemId");
-const reportProblemTableTypeId = Symbol("@niceeval/report/ReportProblemTable");
-/** The table is bounded independently of the number of logical entries. */
-exports.REPORT_PROBLEM_TABLE_MAX = 20000;
-const inputKeyPattern = /^[a-z][a-z0-9_-]*$/;
-const executionCodes = new Set([
-    "projection-callback-defect",
-    "calculation-callback-defect",
-    "page-family-instances-defect",
-    "page-family-key-defect",
-    "page-family-key-conflict",
-    "page-execution-failed",
-    "download-execution-failed",
-    "semantic-document-invalid",
-    "route-conflict",
-]);
-const dataCodes = new Set([
-    "unavailable",
-    "migration-required",
-    "migration-unavailable",
-    "unsupported",
-    "invalid",
-]);
-const encoder = new TextEncoder();
-const SUMMARY_BYTES_MAX = 1024;
-const idsByTable = new WeakMap();
-/**
- * Assigns zero-based IDs in supplied stable traversal order. Repeating the
- * exact same problem object reuses its ID; equal-but-distinct facts remain
- * distinct so a host keeps control over de-duplication boundaries.
- */
-function reportProblemTable(problems) {
-    if (!Array.isArray(problems)) {
-        return effect_1.Either.left(invalid("a problem table must be created from an array"));
-    }
-    const entries = [];
-    const ids = new Map();
-    for (const candidate of problems) {
-        if (typeof candidate !== "object" || candidate === null) {
-            return effect_1.Either.left(invalid("every problem must be an object"));
-        }
-        const existing = ids.get(candidate);
-        if (existing !== undefined) {
-            continue;
-        }
-        if (entries.length >= exports.REPORT_PROBLEM_TABLE_MAX) {
-            return effect_1.Either.left(Object.freeze({
-                code: "report-problem-table-limit",
-                maximum: exports.REPORT_PROBLEM_TABLE_MAX,
-                observedAtLeast: entries.length + 1,
-            }));
-        }
-        const normalized = normalizeProblem(candidate);
-        if (normalized._tag === "invalid") {
-            return effect_1.Either.left(normalized.error);
-        }
-        const id = mintProblemId(entries.length);
-        const entry = Object.freeze({ id, problem: normalized.problem });
-        entries.push(entry);
-        ids.set(candidate, id);
-        ids.set(normalized.problem, id);
-    }
-    const table = entries;
-    Object.defineProperty(table, reportProblemTableTypeId, {
-        value: () => undefined,
-        enumerable: false,
-        writable: false,
-        configurable: false,
-    });
-    Object.freeze(table);
-    idsByTable.set(table, ids);
-    return effect_1.Either.right(table);
-}
-function isReportProblemTable(value) {
-    return typeof value === "object" && value !== null && idsByTable.has(value);
-}
-/** Hosts can turn a canonical problem object into its stable table ID. */
-function reportProblemIdFor(table, problem) {
-    return idsByTable.get(table)?.get(problem);
-}
-function isReportProblemId(value) {
-    return typeof value === "number" &&
-        Number.isInteger(value) &&
-        value >= 0 &&
-        value <= 4294967295;
-}
-function normalizeProblem(value) {
-    const record = ownDataRecord(value);
-    if (record === undefined) {
-        return { _tag: "invalid", error: invalid("a problem must be a plain data object") };
-    }
-    if (record.category === "recorded-data") {
-        return normalizeDataProblem(record);
-    }
-    if (record.category === "execution") {
-        return normalizeExecutionProblem(record);
-    }
-    return { _tag: "invalid", error: invalid("a problem category must be recorded-data or execution") };
-}
-function normalizeDataProblem(record) {
-    if (!hasExactKeys(record, ["category", "code", "consumerId", "inputKey", "slotId", "runId"])) {
-        return { _tag: "invalid", error: invalid("a recorded-data problem has an unknown field") };
-    }
-    if (!dataCodes.has(record.code)) {
-        return { _tag: "invalid", error: invalid("a recorded-data problem code is not recognized") };
-    }
-    if (!(0, identity_ts_1.isReportComponentId)(record.consumerId)) {
-        return { _tag: "invalid", error: invalid("a recorded-data problem needs a ReportComponentId") };
-    }
-    if (record.inputKey !== undefined && (typeof record.inputKey !== "string" || !inputKeyPattern.test(record.inputKey))) {
-        return { _tag: "invalid", error: invalid("a recorded-data input key is invalid") };
-    }
-    if (record.slotId !== undefined && (typeof record.slotId !== "string" || record.slotId.length === 0)) {
-        return { _tag: "invalid", error: invalid("a recorded-data slot ID is invalid") };
-    }
-    if (record.runId !== undefined && (typeof record.runId !== "string" || record.runId.length === 0)) {
-        return { _tag: "invalid", error: invalid("a recorded-data run ID is invalid") };
-    }
-    return {
-        _tag: "problem",
-        problem: Object.freeze({
-            category: "recorded-data",
-            code: record.code,
-            consumerId: record.consumerId,
-            ...(record.inputKey === undefined ? {} : { inputKey: record.inputKey }),
-            ...(record.slotId === undefined ? {} : { slotId: record.slotId }),
-            ...(record.runId === undefined ? {} : { runId: record.runId }),
-        }),
-    };
-}
-function normalizeExecutionProblem(record) {
-    if (!hasExactKeys(record, ["category", "code", "consumerId", "summary"])) {
-        return { _tag: "invalid", error: invalid("an execution problem has an unknown field") };
-    }
-    if (!executionCodes.has(record.code)) {
-        return { _tag: "invalid", error: invalid("an execution problem code is not recognized") };
-    }
-    if (!(0, identity_ts_1.isReportComponentId)(record.consumerId)) {
-        return { _tag: "invalid", error: invalid("an execution problem needs a ReportComponentId") };
-    }
-    if (typeof record.summary !== "string" ||
-        !hasOnlyUnicodeScalars(record.summary) ||
-        encoder.encode(record.summary).byteLength > SUMMARY_BYTES_MAX) {
-        return { _tag: "invalid", error: invalid("an execution problem summary is invalid or unbounded") };
-    }
-    return {
-        _tag: "problem",
-        problem: Object.freeze({
-            category: "execution",
-            code: record.code,
-            consumerId: record.consumerId,
-            summary: record.summary,
-        }),
-    };
-}
-function ownDataRecord(value) {
-    if (Array.isArray(value)) {
-        return undefined;
-    }
-    const prototype = Object.getPrototypeOf(value);
-    if (prototype !== Object.prototype && prototype !== null) {
-        return undefined;
-    }
-    for (const key of Reflect.ownKeys(value)) {
-        if (typeof key !== "string") {
-            return undefined;
-        }
-        const descriptor = Object.getOwnPropertyDescriptor(value, key);
-        if (descriptor === undefined || !descriptor.enumerable || !("value" in descriptor)) {
-            return undefined;
-        }
-    }
-    return value;
-}
-function hasExactKeys(record, allowed) {
-    const allowedKeys = new Set(allowed);
-    return Object.keys(record).every((key) => allowedKeys.has(key));
-}
-function hasOnlyUnicodeScalars(value) {
-    for (let index = 0; index < value.length; index += 1) {
-        const code = value.charCodeAt(index);
-        if (code >= 0xd800 && code <= 0xdbff) {
-            const next = value.charCodeAt(index + 1);
-            if (next < 0xdc00 || next > 0xdfff) {
-                return false;
-            }
-            index += 1;
-        }
-        else if (code >= 0xdc00 && code <= 0xdfff) {
-            return false;
-        }
-    }
-    return true;
-}
-function mintProblemId(value) {
-    return value;
-}
-function invalid(reason) {
-    return Object.freeze({ code: "report-problem-table-invalid", reason });
-}
-//# sourceMappingURL=problems.cjs.map

package/dist/report/execution/problems.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"problems.js","sourceRoot":"","sources":["problems.ts"],"names":[],"mappings":"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","sourcesContent":["import { Either } from \"effect\";\nimport type { RunId, SlotId } from \"../../analysis/index.ts\";\nimport { isReportComponentId, type ReportComponentId, } from \"../author/identity.ts\";\nconst reportProblemIdTypeId: unique symbol = Symbol(\"@niceeval/report/ReportProblemId\");\nconst reportProblemTableTypeId: unique symbol = Symbol(\"@niceeval/report/ReportProblemTable\");\nexport type ReportProblemId = number & {\n    readonly [reportProblemIdTypeId]: true;\n};\nexport interface ReportRecordedDataProblem {\n    readonly category: \"recorded-data\";\n    readonly code: \"unavailable\" | \"migration-required\" | \"migration-unavailable\" | \"unsupported\" | \"invalid\";\n    readonly consumerId: ReportComponentId;\n    readonly inputKey?: string;\n    readonly slotId?: SlotId;\n    readonly runId?: RunId;\n}\nexport interface ReportExecutionProblem {\n    readonly category: \"execution\";\n    readonly code: \"projection-callback-defect\" | \"calculation-callback-defect\" | \"page-family-instances-defect\" | \"page-family-key-defect\" | \"page-family-key-conflict\" | \"page-execution-failed\" | \"download-execution-failed\" | \"semantic-document-invalid\" | \"route-conflict\";\n    readonly consumerId: ReportComponentId;\n    readonly summary: string;\n}\nexport type ReportProblem = ReportRecordedDataProblem | ReportExecutionProblem;\nexport interface ReportProblemTableEntry {\n    readonly id: ReportProblemId;\n    readonly problem: ReportProblem;\n}\n/** A host-owned, canonical table. Passing copied entries cannot forge it. */\nexport type ReportProblemTable = readonly ReportProblemTableEntry[] & {\n    readonly [reportProblemTableTypeId]: () => void;\n};\nexport interface ReportProblemTableInvalid {\n    readonly code: \"report-problem-table-invalid\";\n    readonly reason: string;\n}\nexport interface ReportProblemTableLimit {\n    readonly code: \"report-problem-table-limit\";\n    readonly maximum: number;\n    readonly observedAtLeast: number;\n}\nexport type ReportProblemTableError = ReportProblemTableInvalid | ReportProblemTableLimit;\n/** The table is bounded independently of the number of logical entries. */\nexport const REPORT_PROBLEM_TABLE_MAX = 20000;\nconst inputKeyPattern = /^[a-z][a-z0-9_-]*$/;\nconst executionCodes = new Set<ReportExecutionProblem[\"code\"]>([\n    \"projection-callback-defect\",\n    \"calculation-callback-defect\",\n    \"page-family-instances-defect\",\n    \"page-family-key-defect\",\n    \"page-family-key-conflict\",\n    \"page-execution-failed\",\n    \"download-execution-failed\",\n    \"semantic-document-invalid\",\n    \"route-conflict\",\n]);\nconst dataCodes = new Set<ReportRecordedDataProblem[\"code\"]>([\n    \"unavailable\",\n    \"migration-required\",\n    \"migration-unavailable\",\n    \"unsupported\",\n    \"invalid\",\n]);\nconst encoder = new TextEncoder();\nconst SUMMARY_BYTES_MAX = 1024;\nconst idsByTable = new WeakMap<object, ReadonlyMap<object, ReportProblemId>>();\n/**\n * Assigns zero-based IDs in supplied stable traversal order. Repeating the\n * exact same problem object reuses its ID; equal-but-distinct facts remain\n * distinct so a host keeps control over de-duplication boundaries.\n */\nexport function reportProblemTable(problems: readonly ReportProblem[]): Either.Either<ReportProblemTable, ReportProblemTableError> {\n    if (!Array.isArray(problems)) {\n        return Either.left(invalid(\"a problem table must be created from an array\"));\n    }\n    const entries: ReportProblemTableEntry[] = [];\n    const ids = new Map<object, ReportProblemId>();\n    for (const candidate of problems) {\n        if (typeof candidate !== \"object\" || candidate === null) {\n            return Either.left(invalid(\"every problem must be an object\"));\n        }\n        const existing = ids.get(candidate);\n        if (existing !== undefined) {\n            continue;\n        }\n        if (entries.length >= REPORT_PROBLEM_TABLE_MAX) {\n            return Either.left(Object.freeze({\n                code: \"report-problem-table-limit\" as const,\n                maximum: REPORT_PROBLEM_TABLE_MAX,\n                observedAtLeast: entries.length + 1,\n            }));\n        }\n        const normalized = normalizeProblem(candidate);\n        if (normalized._tag === \"invalid\") {\n            return Either.left(normalized.error);\n        }\n        const id = mintProblemId(entries.length);\n        const entry = Object.freeze({ id, problem: normalized.problem });\n        entries.push(entry);\n        ids.set(candidate, id);\n        ids.set(normalized.problem, id);\n    }\n    const table = entries as unknown as ReportProblemTable;\n    Object.defineProperty(table, reportProblemTableTypeId, {\n        value: (): void => undefined,\n        enumerable: false,\n        writable: false,\n        configurable: false,\n    });\n    Object.freeze(table);\n    idsByTable.set(table, ids);\n    return Either.right(table);\n}\nexport function isReportProblemTable(value: unknown): value is ReportProblemTable {\n    return typeof value === \"object\" && value !== null && idsByTable.has(value);\n}\n/** Hosts can turn a canonical problem object into its stable table ID. */\nexport function reportProblemIdFor(table: ReportProblemTable, problem: ReportProblem): ReportProblemId | undefined {\n    return idsByTable.get(table)?.get(problem);\n}\nexport function isReportProblemId(value: unknown): value is ReportProblemId {\n    return typeof value === \"number\" &&\n        Number.isInteger(value) &&\n        value >= 0 &&\n        value <= 4294967295;\n}\nfunction normalizeProblem(value: object): {\n    readonly _tag: \"problem\";\n    readonly problem: ReportProblem;\n} | {\n    readonly _tag: \"invalid\";\n    readonly error: ReportProblemTableInvalid;\n} {\n    const record = ownDataRecord(value);\n    if (record === undefined) {\n        return { _tag: \"invalid\", error: invalid(\"a problem must be a plain data object\") };\n    }\n    if (record.category === \"recorded-data\") {\n        return normalizeDataProblem(record);\n    }\n    if (record.category === \"execution\") {\n        return normalizeExecutionProblem(record);\n    }\n    return { _tag: \"invalid\", error: invalid(\"a problem category must be recorded-data or execution\") };\n}\nfunction normalizeDataProblem(record: Record<string, unknown>): {\n    readonly _tag: \"problem\";\n    readonly problem: ReportRecordedDataProblem;\n} | {\n    readonly _tag: \"invalid\";\n    readonly error: ReportProblemTableInvalid;\n} {\n    if (!hasExactKeys(record, [\"category\", \"code\", \"consumerId\", \"inputKey\", \"slotId\", \"runId\"])) {\n        return { _tag: \"invalid\", error: invalid(\"a recorded-data problem has an unknown field\") };\n    }\n    if (!dataCodes.has(record.code as ReportRecordedDataProblem[\"code\"])) {\n        return { _tag: \"invalid\", error: invalid(\"a recorded-data problem code is not recognized\") };\n    }\n    if (!isReportComponentId(record.consumerId)) {\n        return { _tag: \"invalid\", error: invalid(\"a recorded-data problem needs a ReportComponentId\") };\n    }\n    if (record.inputKey !== undefined && (typeof record.inputKey !== \"string\" || !inputKeyPattern.test(record.inputKey))) {\n        return { _tag: \"invalid\", error: invalid(\"a recorded-data input key is invalid\") };\n    }\n    if (record.slotId !== undefined && (typeof record.slotId !== \"string\" || record.slotId.length === 0)) {\n        return { _tag: \"invalid\", error: invalid(\"a recorded-data slot ID is invalid\") };\n    }\n    if (record.runId !== undefined && (typeof record.runId !== \"string\" || record.runId.length === 0)) {\n        return { _tag: \"invalid\", error: invalid(\"a recorded-data run ID is invalid\") };\n    }\n    return {\n        _tag: \"problem\",\n        problem: Object.freeze({\n            category: \"recorded-data\" as const,\n            code: record.code as ReportRecordedDataProblem[\"code\"],\n            consumerId: record.consumerId,\n            ...(record.inputKey === undefined ? {} : { inputKey: record.inputKey }),\n            ...(record.slotId === undefined ? {} : { slotId: record.slotId as SlotId }),\n            ...(record.runId === undefined ? {} : { runId: record.runId as RunId }),\n        }),\n    };\n}\nfunction normalizeExecutionProblem(record: Record<string, unknown>): {\n    readonly _tag: \"problem\";\n    readonly problem: ReportExecutionProblem;\n} | {\n    readonly _tag: \"invalid\";\n    readonly error: ReportProblemTableInvalid;\n} {\n    if (!hasExactKeys(record, [\"category\", \"code\", \"consumerId\", \"summary\"])) {\n        return { _tag: \"invalid\", error: invalid(\"an execution problem has an unknown field\") };\n    }\n    if (!executionCodes.has(record.code as ReportExecutionProblem[\"code\"])) {\n        return { _tag: \"invalid\", error: invalid(\"an execution problem code is not recognized\") };\n    }\n    if (!isReportComponentId(record.consumerId)) {\n        return { _tag: \"invalid\", error: invalid(\"an execution problem needs a ReportComponentId\") };\n    }\n    if (typeof record.summary !== \"string\" ||\n        !hasOnlyUnicodeScalars(record.summary) ||\n        encoder.encode(record.summary).byteLength > SUMMARY_BYTES_MAX) {\n        return { _tag: \"invalid\", error: invalid(\"an execution problem summary is invalid or unbounded\") };\n    }\n    return {\n        _tag: \"problem\",\n        problem: Object.freeze({\n            category: \"execution\" as const,\n            code: record.code as ReportExecutionProblem[\"code\"],\n            consumerId: record.consumerId,\n            summary: record.summary,\n        }),\n    };\n}\nfunction ownDataRecord(value: object): Record<string, unknown> | undefined {\n    if (Array.isArray(value)) {\n        return undefined;\n    }\n    const prototype = Object.getPrototypeOf(value);\n    if (prototype !== Object.prototype && prototype !== null) {\n        return undefined;\n    }\n    for (const key of Reflect.ownKeys(value)) {\n        if (typeof key !== \"string\") {\n            return undefined;\n        }\n        const descriptor = Object.getOwnPropertyDescriptor(value, key);\n        if (descriptor === undefined || !descriptor.enumerable || !(\"value\" in descriptor)) {\n            return undefined;\n        }\n    }\n    return value as Record<string, unknown>;\n}\nfunction hasExactKeys(record: Record<string, unknown>, allowed: readonly string[]): boolean {\n    const allowedKeys = new Set(allowed);\n    return Object.keys(record).every((key) => allowedKeys.has(key));\n}\nfunction hasOnlyUnicodeScalars(value: string): boolean {\n    for (let index = 0; index < value.length; index += 1) {\n        const code = value.charCodeAt(index);\n        if (code >= 0xd800 && code <= 0xdbff) {\n            const next = value.charCodeAt(index + 1);\n            if (next < 0xdc00 || next > 0xdfff) {\n                return false;\n            }\n            index += 1;\n        }\n        else if (code >= 0xdc00 && code <= 0xdfff) {\n            return false;\n        }\n    }\n    return true;\n}\nfunction mintProblemId(value: number): ReportProblemId {\n    return value as ReportProblemId;\n}\nfunction invalid(reason: string): ReportProblemTableInvalid {\n    return Object.freeze({ code: \"report-problem-table-invalid\", reason });\n}\n"]}

package/dist/report/execution/problems.d.cts

@@ -1,54 +0,0 @@
-import { Either } from "effect";
-import type { RunId, SlotId } from "../../analysis/index.cjs";
-import { type ReportComponentId } from "../author/identity.cjs";
-declare const reportProblemIdTypeId: unique symbol;
-declare const reportProblemTableTypeId: unique symbol;
-export type ReportProblemId = number & {
-    readonly [reportProblemIdTypeId]: true;
-};
-export interface ReportRecordedDataProblem {
-    readonly category: "recorded-data";
-    readonly code: "unavailable" | "migration-required" | "migration-unavailable" | "unsupported" | "invalid";
-    readonly consumerId: ReportComponentId;
-    readonly inputKey?: string;
-    readonly slotId?: SlotId;
-    readonly runId?: RunId;
-}
-export interface ReportExecutionProblem {
-    readonly category: "execution";
-    readonly code: "projection-callback-defect" | "calculation-callback-defect" | "page-family-instances-defect" | "page-family-key-defect" | "page-family-key-conflict" | "page-execution-failed" | "download-execution-failed" | "semantic-document-invalid" | "route-conflict";
-    readonly consumerId: ReportComponentId;
-    readonly summary: string;
-}
-export type ReportProblem = ReportRecordedDataProblem | ReportExecutionProblem;
-export interface ReportProblemTableEntry {
-    readonly id: ReportProblemId;
-    readonly problem: ReportProblem;
-}
-/** A host-owned, canonical table. Passing copied entries cannot forge it. */
-export type ReportProblemTable = readonly ReportProblemTableEntry[] & {
-    readonly [reportProblemTableTypeId]: () => void;
-};
-export interface ReportProblemTableInvalid {
-    readonly code: "report-problem-table-invalid";
-    readonly reason: string;
-}
-export interface ReportProblemTableLimit {
-    readonly code: "report-problem-table-limit";
-    readonly maximum: number;
-    readonly observedAtLeast: number;
-}
-export type ReportProblemTableError = ReportProblemTableInvalid | ReportProblemTableLimit;
-/** The table is bounded independently of the number of logical entries. */
-export declare const REPORT_PROBLEM_TABLE_MAX = 20000;
-/**
- * Assigns zero-based IDs in supplied stable traversal order. Repeating the
- * exact same problem object reuses its ID; equal-but-distinct facts remain
- * distinct so a host keeps control over de-duplication boundaries.
- */
-export declare function reportProblemTable(problems: readonly ReportProblem[]): Either.Either<ReportProblemTable, ReportProblemTableError>;
-export declare function isReportProblemTable(value: unknown): value is ReportProblemTable;
-/** Hosts can turn a canonical problem object into its stable table ID. */
-export declare function reportProblemIdFor(table: ReportProblemTable, problem: ReportProblem): ReportProblemId | undefined;
-export declare function isReportProblemId(value: unknown): value is ReportProblemId;
-export {};