niceeval 0.12.2-canary.31 → 0.13.1

package/dist/projection/model.d.ts

@@ -1,49 +0,0 @@
-import type { AnalysisRun, AnalysisSample, CoreInvalidAnalysisSlot, ExcludedAnalysisSlot, IncludedAnalysisSlot, NotRecordedAnalysisSlot, RecordAttemptRef, RunId } from "../analysis/index.js";
-import type { ProjectedRecordAttachmentResult } from "./attachment-result.js";
-import type { ProjectionCoverage } from "./coverage.js";
-export type ProjectionAccess = "attempt-slot" | "attempt-origin-run" | "selected-run";
-export interface AttemptAttachmentOwner {
-    readonly kind: "attempt";
-    readonly attempt: RecordAttemptRef;
-}
-export interface RunAttachmentOwner {
-    readonly kind: "run";
-    readonly runId: RunId;
-}
-export type ProjectedSlotEntry<Owner, Value> = {
-    readonly state: "excluded";
-    readonly slot: ExcludedAnalysisSlot;
-} | {
-    readonly state: "not-recorded";
-    readonly slot: NotRecordedAnalysisSlot;
-} | {
-    readonly state: "core-invalid";
-    readonly slot: CoreInvalidAnalysisSlot;
-} | {
-    readonly state: "attachment-result";
-    readonly slot: IncludedAnalysisSlot;
-    readonly owner: Owner;
-    readonly attachment: ProjectedRecordAttachmentResult<Value>;
-};
-export type AttemptSlotProjectedEntry<Value> = ProjectedSlotEntry<AttemptAttachmentOwner, Value>;
-export type AttemptOriginRunProjectedEntry<Value> = ProjectedSlotEntry<RunAttachmentOwner, Value>;
-export interface SelectedRunProjectedEntry<Value> {
-    readonly state: "attachment-result";
-    readonly run: AnalysisRun;
-    readonly owner: RunAttachmentOwner;
-    readonly attachment: ProjectedRecordAttachmentResult<Value>;
-}
-export type ProjectedEntry<Access extends ProjectionAccess, Value> = Access extends "attempt-slot" ? AttemptSlotProjectedEntry<Value> : Access extends "attempt-origin-run" ? AttemptOriginRunProjectedEntry<Value> : SelectedRunProjectedEntry<Value>;
-/** A completed, self-contained projection never retains live reader capability. */
-export interface ProjectedSample<Access extends ProjectionAccess, Value> {
-    readonly sample: AnalysisSample;
-    readonly access: Access;
-    readonly entries: readonly ProjectedEntry<Access, Value>[];
-    readonly coverage: ProjectionCoverage;
-}
-export interface ProjectionLimitError {
-    readonly code: "projection-limit-exceeded";
-    readonly limit: "logical-entries";
-    readonly maximum: number;
-    readonly observedAtLeast: number;
-}

package/dist/projection/model.js

@@ -1,4 +0,0 @@
-import { createRequire as __niceevalCreateRequire } from "node:module";
-const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
-const __niceevalCanonical = __niceevalRequire("./model.cjs");
-//# sourceMappingURL=model.js.map

package/dist/projection/model.js.map

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

package/dist/projection/projector.cjs

@@ -1,111 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineRecordAttachmentProjector = defineRecordAttachmentProjector;
-exports.attemptSlotProjection = attemptSlotProjection;
-exports.attemptOriginRunProjection = attemptOriginRunProjection;
-exports.selectedRunProjection = selectedRunProjection;
-exports.withRecordAttachmentProjector = withRecordAttachmentProjector;
-exports.recordProjectionDeclaration = recordProjectionDeclaration;
-const internal_ts_1 = require("../record/attachment/internal.cjs");
-const recordAttachmentProjectorTypeId = Symbol("@niceeval/projection/RecordAttachmentProjector");
-const recordProjectionTypeId = Symbol("@niceeval/projection/RecordProjection");
-const recordAttachmentProjectorRuntimeTypeId = Symbol("@niceeval/projection/RecordAttachmentProjectorRuntime");
-const recordProjectionRuntimeTypeId = Symbol("@niceeval/projection/RecordProjectionRuntime");
-const projectorIdentityByProjector = new WeakMap();
-const projectionIdentityByProjection = new WeakMap();
-function defineRecordAttachmentProjector(input) {
-    const owner = (0, internal_ts_1.recordAttachmentFamilyOwner)(input.attachment);
-    if (owner === undefined) {
-        throw new TypeError("attachment must be a RecordAttachmentFamily created by NiceEval");
-    }
-    if (typeof input.project !== "function") {
-        throw new TypeError("project must be a synchronous function");
-    }
-    const runtime = Object.freeze({
-        use: (use) => use(input.attachment, input.project),
-    });
-    const projector = {
-        owner,
-        [recordAttachmentProjectorTypeId]: (value) => value,
-        [recordAttachmentProjectorRuntimeTypeId]: runtime,
-    };
-    const frozenProjector = Object.freeze(projector);
-    projectorIdentityByProjector.set(frozenProjector, Object.freeze({ owner }));
-    return frozenProjector;
-}
-function attemptSlotProjection(projector) {
-    assertRecordAttachmentProjectorOwner(projector, "attempt");
-    const declaration = Object.freeze({
-        access: "attempt-slot",
-        projector,
-    });
-    return makeRecordProjection("attempt-slot", declaration);
-}
-function attemptOriginRunProjection(projector) {
-    assertRecordAttachmentProjectorOwner(projector, "run");
-    const declaration = Object.freeze({
-        access: "attempt-origin-run",
-        projector,
-    });
-    return makeRecordProjection("attempt-origin-run", declaration);
-}
-function selectedRunProjection(projector) {
-    assertRecordAttachmentProjectorOwner(projector, "run");
-    const declaration = Object.freeze({
-        access: "selected-run",
-        projector,
-    });
-    return makeRecordProjection("selected-run", declaration);
-}
-/**
- * @internal Invokes a factory-captured generic closure after WeakMap identity
- * validation. This retains the exact attachment payload and public Value
- * without recovering either from erased map contents.
- */
-function withRecordAttachmentProjector(projector, use) {
-    if (!isPackageRecordAttachmentProjector(projector)) {
-        throw new TypeError("projector must be created by defineRecordAttachmentProjector");
-    }
-    return projector[recordAttachmentProjectorRuntimeTypeId].use(use);
-}
-/** @internal Rejects a copied or type-asserted projection before Record I/O. */
-function recordProjectionDeclaration(projection) {
-    if (!isPackageRecordProjection(projection)) {
-        throw new TypeError("projection must be created by a projection factory");
-    }
-    const identity = projectionIdentityByProjection.get(projection);
-    if (identity === undefined || identity.access !== projection.access) {
-        throw new TypeError("projection must be created by a projection factory");
-    }
-    const declaration = projection[recordProjectionRuntimeTypeId].declaration();
-    if (declaration.access !== identity.access) {
-        throw new Error("projection factory declaration lost its access invariant");
-    }
-    return declaration;
-}
-function makeRecordProjection(access, declaration) {
-    const runtime = Object.freeze({
-        declaration: () => declaration,
-    });
-    const projection = {
-        access,
-        [recordProjectionTypeId]: (value) => value,
-        [recordProjectionRuntimeTypeId]: runtime,
-    };
-    const frozenProjection = Object.freeze(projection);
-    projectionIdentityByProjection.set(frozenProjection, Object.freeze({ access }));
-    return frozenProjection;
-}
-function assertRecordAttachmentProjectorOwner(projector, owner) {
-    if (!isPackageRecordAttachmentProjector(projector) || projector.owner !== owner) {
-        throw new TypeError("projector owner does not match projection access");
-    }
-}
-function isPackageRecordAttachmentProjector(projector) {
-    const identity = projectorIdentityByProjector.get(projector);
-    return identity !== undefined && identity.owner === projector.owner;
-}
-function isPackageRecordProjection(projection) {
-    return projectionIdentityByProjection.has(projection);
-}
-//# sourceMappingURL=projector.cjs.map

package/dist/projection/projector.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"projector.js","sourceRoot":"","sources":["projector.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RecordAttachmentFamily, RecordAttachmentValue, } from \"../record/attachment/index.ts\";\nimport { recordAttachmentFamilyOwner } from \"../record/attachment/internal.ts\";\nimport type { RecordAttachmentOwner } from \"../record/model/core.ts\";\nimport type { ProjectionAccess } from \"./model.ts\";\nconst recordAttachmentProjectorTypeId: unique symbol = Symbol(\"@niceeval/projection/RecordAttachmentProjector\");\nconst recordProjectionTypeId: unique symbol = Symbol(\"@niceeval/projection/RecordProjection\");\nconst recordAttachmentProjectorRuntimeTypeId: unique symbol = Symbol(\"@niceeval/projection/RecordAttachmentProjectorRuntime\");\nconst recordProjectionRuntimeTypeId: unique symbol = Symbol(\"@niceeval/projection/RecordProjectionRuntime\");\n/**\n * A synchronous interpretation of exactly one owner-local Attachment family.\n * The nominal symbol only protects ordinary TypeScript construction; the\n * package-private WeakMap below is the actual runtime authority.\n */\nexport interface RecordAttachmentProjector<Owner extends RecordAttachmentOwner, Value> {\n    readonly owner: Owner;\n    readonly [recordAttachmentProjectorTypeId]: (value: Value) => Value;\n}\nexport interface RecordProjection<Access extends ProjectionAccess, Value> {\n    readonly access: Access;\n    readonly [recordProjectionTypeId]: (value: Value) => Value;\n}\ninterface ProjectorIdentity {\n    readonly owner: RecordAttachmentOwner;\n}\ninterface ProjectionIdentity {\n    readonly access: ProjectionAccess;\n}\ninterface ProjectorRuntime<Owner extends RecordAttachmentOwner, Value> {\n    readonly use: <Result>(use: <Payload>(family: RecordAttachmentFamily<Owner, Payload>, project: (value: RecordAttachmentValue<Payload>) => Value) => Result) => Result;\n}\ninterface PackageRecordAttachmentProjector<Owner extends RecordAttachmentOwner, Value> extends RecordAttachmentProjector<Owner, Value> {\n    readonly [recordAttachmentProjectorRuntimeTypeId]: ProjectorRuntime<Owner, Value>;\n}\ninterface AttemptSlotProjectionDeclaration<Value> {\n    readonly access: \"attempt-slot\";\n    readonly projector: RecordAttachmentProjector<\"attempt\", Value>;\n}\ninterface AttemptOriginRunProjectionDeclaration<Value> {\n    readonly access: \"attempt-origin-run\";\n    readonly projector: RecordAttachmentProjector<\"run\", Value>;\n}\ninterface SelectedRunProjectionDeclaration<Value> {\n    readonly access: \"selected-run\";\n    readonly projector: RecordAttachmentProjector<\"run\", Value>;\n}\n/**\n * @internal The factory closure is the Value witness. The union gives runtime\n * consumers an exact owner after discriminating access.\n */\nexport type RecordProjectionDeclaration<Value> = AttemptSlotProjectionDeclaration<Value> | AttemptOriginRunProjectionDeclaration<Value> | SelectedRunProjectionDeclaration<Value>;\ninterface ProjectionRuntime<Value> {\n    readonly declaration: () => RecordProjectionDeclaration<Value>;\n}\ninterface PackageRecordProjection<Access extends ProjectionAccess, Value> extends RecordProjection<Access, Value> {\n    readonly [recordProjectionRuntimeTypeId]: ProjectionRuntime<Value>;\n}\nconst projectorIdentityByProjector = new WeakMap<object, ProjectorIdentity>();\nconst projectionIdentityByProjection = new WeakMap<object, ProjectionIdentity>();\nexport function defineRecordAttachmentProjector<Owner extends RecordAttachmentOwner, Payload, Value>(input: {\n    readonly attachment: RecordAttachmentFamily<Owner, Payload>;\n    readonly project: (value: RecordAttachmentValue<Payload>) => Value;\n}): RecordAttachmentProjector<Owner, Value> {\n    const owner = recordAttachmentFamilyOwner(input.attachment);\n    if (owner === undefined) {\n        throw new TypeError(\"attachment must be a RecordAttachmentFamily created by NiceEval\");\n    }\n    if (typeof input.project !== \"function\") {\n        throw new TypeError(\"project must be a synchronous function\");\n    }\n    const runtime: ProjectorRuntime<Owner, Value> = Object.freeze({\n        use: <Result>(use: <CurrentPayload>(family: RecordAttachmentFamily<Owner, CurrentPayload>, project: (value: RecordAttachmentValue<CurrentPayload>) => Value) => Result): Result => use(input.attachment, input.project),\n    });\n    const projector: PackageRecordAttachmentProjector<Owner, Value> = {\n        owner,\n        [recordAttachmentProjectorTypeId]: (value: Value): Value => value,\n        [recordAttachmentProjectorRuntimeTypeId]: runtime,\n    };\n    const frozenProjector = Object.freeze(projector);\n    projectorIdentityByProjector.set(frozenProjector, Object.freeze({ owner }));\n    return frozenProjector;\n}\nexport function attemptSlotProjection<Value>(projector: RecordAttachmentProjector<\"attempt\", Value>): RecordProjection<\"attempt-slot\", Value> {\n    assertRecordAttachmentProjectorOwner(projector, \"attempt\");\n    const declaration: AttemptSlotProjectionDeclaration<Value> = Object.freeze({\n        access: \"attempt-slot\",\n        projector,\n    });\n    return makeRecordProjection(\"attempt-slot\", declaration);\n}\nexport function attemptOriginRunProjection<Value>(projector: RecordAttachmentProjector<\"run\", Value>): RecordProjection<\"attempt-origin-run\", Value> {\n    assertRecordAttachmentProjectorOwner(projector, \"run\");\n    const declaration: AttemptOriginRunProjectionDeclaration<Value> = Object.freeze({\n        access: \"attempt-origin-run\",\n        projector,\n    });\n    return makeRecordProjection(\"attempt-origin-run\", declaration);\n}\nexport function selectedRunProjection<Value>(projector: RecordAttachmentProjector<\"run\", Value>): RecordProjection<\"selected-run\", Value> {\n    assertRecordAttachmentProjectorOwner(projector, \"run\");\n    const declaration: SelectedRunProjectionDeclaration<Value> = Object.freeze({\n        access: \"selected-run\",\n        projector,\n    });\n    return makeRecordProjection(\"selected-run\", declaration);\n}\n/**\n * @internal Invokes a factory-captured generic closure after WeakMap identity\n * validation. This retains the exact attachment payload and public Value\n * without recovering either from erased map contents.\n */\nexport function withRecordAttachmentProjector<Owner extends RecordAttachmentOwner, Value, Result>(projector: RecordAttachmentProjector<Owner, Value>, use: <Payload>(family: RecordAttachmentFamily<Owner, Payload>, project: (value: RecordAttachmentValue<Payload>) => Value) => Result): Result {\n    if (!isPackageRecordAttachmentProjector(projector)) {\n        throw new TypeError(\"projector must be created by defineRecordAttachmentProjector\");\n    }\n    return projector[recordAttachmentProjectorRuntimeTypeId].use(use);\n}\n/** @internal Rejects a copied or type-asserted projection before Record I/O. */\nexport function recordProjectionDeclaration<Access extends ProjectionAccess, Value>(projection: RecordProjection<Access, Value>): RecordProjectionDeclaration<Value> {\n    if (!isPackageRecordProjection(projection)) {\n        throw new TypeError(\"projection must be created by a projection factory\");\n    }\n    const identity = projectionIdentityByProjection.get(projection);\n    if (identity === undefined || identity.access !== projection.access) {\n        throw new TypeError(\"projection must be created by a projection factory\");\n    }\n    const declaration = projection[recordProjectionRuntimeTypeId].declaration();\n    if (declaration.access !== identity.access) {\n        throw new Error(\"projection factory declaration lost its access invariant\");\n    }\n    return declaration;\n}\nfunction makeRecordProjection<Value>(access: \"attempt-slot\", declaration: AttemptSlotProjectionDeclaration<Value>): RecordProjection<\"attempt-slot\", Value>;\nfunction makeRecordProjection<Value>(access: \"attempt-origin-run\", declaration: AttemptOriginRunProjectionDeclaration<Value>): RecordProjection<\"attempt-origin-run\", Value>;\nfunction makeRecordProjection<Value>(access: \"selected-run\", declaration: SelectedRunProjectionDeclaration<Value>): RecordProjection<\"selected-run\", Value>;\nfunction makeRecordProjection<Value>(access: ProjectionAccess, declaration: RecordProjectionDeclaration<Value>): RecordProjection<ProjectionAccess, Value> {\n    const runtime: ProjectionRuntime<Value> = Object.freeze({\n        declaration: (): RecordProjectionDeclaration<Value> => declaration,\n    });\n    const projection: PackageRecordProjection<ProjectionAccess, Value> = {\n        access,\n        [recordProjectionTypeId]: (value: Value): Value => value,\n        [recordProjectionRuntimeTypeId]: runtime,\n    };\n    const frozenProjection = Object.freeze(projection);\n    projectionIdentityByProjection.set(frozenProjection, Object.freeze({ access }));\n    return frozenProjection;\n}\nfunction assertRecordAttachmentProjectorOwner<Owner extends RecordAttachmentOwner, Value>(projector: RecordAttachmentProjector<Owner, Value>, owner: Owner): void {\n    if (!isPackageRecordAttachmentProjector(projector) || projector.owner !== owner) {\n        throw new TypeError(\"projector owner does not match projection access\");\n    }\n}\nfunction isPackageRecordAttachmentProjector<Owner extends RecordAttachmentOwner, Value>(projector: RecordAttachmentProjector<Owner, Value>): projector is PackageRecordAttachmentProjector<Owner, Value> {\n    const identity = projectorIdentityByProjector.get(projector);\n    return identity !== undefined && identity.owner === projector.owner;\n}\nfunction isPackageRecordProjection<Access extends ProjectionAccess, Value>(projection: RecordProjection<Access, Value>): projection is PackageRecordProjection<Access, Value> {\n    return projectionIdentityByProjection.has(projection);\n}\n"]}

package/dist/projection/projector.d.cts

@@ -1,51 +0,0 @@
-import type { RecordAttachmentFamily, RecordAttachmentValue } from "../record/attachment/index.cjs";
-import type { RecordAttachmentOwner } from "../record/model/core.cjs";
-import type { ProjectionAccess } from "./model.cjs";
-declare const recordAttachmentProjectorTypeId: unique symbol;
-declare const recordProjectionTypeId: unique symbol;
-/**
- * A synchronous interpretation of exactly one owner-local Attachment family.
- * The nominal symbol only protects ordinary TypeScript construction; the
- * package-private WeakMap below is the actual runtime authority.
- */
-export interface RecordAttachmentProjector<Owner extends RecordAttachmentOwner, Value> {
-    readonly owner: Owner;
-    readonly [recordAttachmentProjectorTypeId]: (value: Value) => Value;
-}
-export interface RecordProjection<Access extends ProjectionAccess, Value> {
-    readonly access: Access;
-    readonly [recordProjectionTypeId]: (value: Value) => Value;
-}
-interface AttemptSlotProjectionDeclaration<Value> {
-    readonly access: "attempt-slot";
-    readonly projector: RecordAttachmentProjector<"attempt", Value>;
-}
-interface AttemptOriginRunProjectionDeclaration<Value> {
-    readonly access: "attempt-origin-run";
-    readonly projector: RecordAttachmentProjector<"run", Value>;
-}
-interface SelectedRunProjectionDeclaration<Value> {
-    readonly access: "selected-run";
-    readonly projector: RecordAttachmentProjector<"run", Value>;
-}
-/**
- * @internal The factory closure is the Value witness. The union gives runtime
- * consumers an exact owner after discriminating access.
- */
-export type RecordProjectionDeclaration<Value> = AttemptSlotProjectionDeclaration<Value> | AttemptOriginRunProjectionDeclaration<Value> | SelectedRunProjectionDeclaration<Value>;
-export declare function defineRecordAttachmentProjector<Owner extends RecordAttachmentOwner, Payload, Value>(input: {
-    readonly attachment: RecordAttachmentFamily<Owner, Payload>;
-    readonly project: (value: RecordAttachmentValue<Payload>) => Value;
-}): RecordAttachmentProjector<Owner, Value>;
-export declare function attemptSlotProjection<Value>(projector: RecordAttachmentProjector<"attempt", Value>): RecordProjection<"attempt-slot", Value>;
-export declare function attemptOriginRunProjection<Value>(projector: RecordAttachmentProjector<"run", Value>): RecordProjection<"attempt-origin-run", Value>;
-export declare function selectedRunProjection<Value>(projector: RecordAttachmentProjector<"run", Value>): RecordProjection<"selected-run", Value>;
-/**
- * @internal Invokes a factory-captured generic closure after WeakMap identity
- * validation. This retains the exact attachment payload and public Value
- * without recovering either from erased map contents.
- */
-export declare function withRecordAttachmentProjector<Owner extends RecordAttachmentOwner, Value, Result>(projector: RecordAttachmentProjector<Owner, Value>, use: <Payload>(family: RecordAttachmentFamily<Owner, Payload>, project: (value: RecordAttachmentValue<Payload>) => Value) => Result): Result;
-/** @internal Rejects a copied or type-asserted projection before Record I/O. */
-export declare function recordProjectionDeclaration<Access extends ProjectionAccess, Value>(projection: RecordProjection<Access, Value>): RecordProjectionDeclaration<Value>;
-export {};

package/dist/projection/projector.d.mts

@@ -1,51 +0,0 @@
-import type { RecordAttachmentFamily, RecordAttachmentValue } from "../record/attachment/index.mjs";
-import type { RecordAttachmentOwner } from "../record/model/core.mjs";
-import type { ProjectionAccess } from "./model.mjs";
-declare const recordAttachmentProjectorTypeId: unique symbol;
-declare const recordProjectionTypeId: unique symbol;
-/**
- * A synchronous interpretation of exactly one owner-local Attachment family.
- * The nominal symbol only protects ordinary TypeScript construction; the
- * package-private WeakMap below is the actual runtime authority.
- */
-export interface RecordAttachmentProjector<Owner extends RecordAttachmentOwner, Value> {
-    readonly owner: Owner;
-    readonly [recordAttachmentProjectorTypeId]: (value: Value) => Value;
-}
-export interface RecordProjection<Access extends ProjectionAccess, Value> {
-    readonly access: Access;
-    readonly [recordProjectionTypeId]: (value: Value) => Value;
-}
-interface AttemptSlotProjectionDeclaration<Value> {
-    readonly access: "attempt-slot";
-    readonly projector: RecordAttachmentProjector<"attempt", Value>;
-}
-interface AttemptOriginRunProjectionDeclaration<Value> {
-    readonly access: "attempt-origin-run";
-    readonly projector: RecordAttachmentProjector<"run", Value>;
-}
-interface SelectedRunProjectionDeclaration<Value> {
-    readonly access: "selected-run";
-    readonly projector: RecordAttachmentProjector<"run", Value>;
-}
-/**
- * @internal The factory closure is the Value witness. The union gives runtime
- * consumers an exact owner after discriminating access.
- */
-export type RecordProjectionDeclaration<Value> = AttemptSlotProjectionDeclaration<Value> | AttemptOriginRunProjectionDeclaration<Value> | SelectedRunProjectionDeclaration<Value>;
-export declare function defineRecordAttachmentProjector<Owner extends RecordAttachmentOwner, Payload, Value>(input: {
-    readonly attachment: RecordAttachmentFamily<Owner, Payload>;
-    readonly project: (value: RecordAttachmentValue<Payload>) => Value;
-}): RecordAttachmentProjector<Owner, Value>;
-export declare function attemptSlotProjection<Value>(projector: RecordAttachmentProjector<"attempt", Value>): RecordProjection<"attempt-slot", Value>;
-export declare function attemptOriginRunProjection<Value>(projector: RecordAttachmentProjector<"run", Value>): RecordProjection<"attempt-origin-run", Value>;
-export declare function selectedRunProjection<Value>(projector: RecordAttachmentProjector<"run", Value>): RecordProjection<"selected-run", Value>;
-/**
- * @internal Invokes a factory-captured generic closure after WeakMap identity
- * validation. This retains the exact attachment payload and public Value
- * without recovering either from erased map contents.
- */
-export declare function withRecordAttachmentProjector<Owner extends RecordAttachmentOwner, Value, Result>(projector: RecordAttachmentProjector<Owner, Value>, use: <Payload>(family: RecordAttachmentFamily<Owner, Payload>, project: (value: RecordAttachmentValue<Payload>) => Value) => Result): Result;
-/** @internal Rejects a copied or type-asserted projection before Record I/O. */
-export declare function recordProjectionDeclaration<Access extends ProjectionAccess, Value>(projection: RecordProjection<Access, Value>): RecordProjectionDeclaration<Value>;
-export {};

package/dist/projection/projector.d.ts

@@ -1,51 +0,0 @@
-import type { RecordAttachmentFamily, RecordAttachmentValue } from "../record/attachment/index.js";
-import type { RecordAttachmentOwner } from "../record/model/core.js";
-import type { ProjectionAccess } from "./model.js";
-declare const recordAttachmentProjectorTypeId: unique symbol;
-declare const recordProjectionTypeId: unique symbol;
-/**
- * A synchronous interpretation of exactly one owner-local Attachment family.
- * The nominal symbol only protects ordinary TypeScript construction; the
- * package-private WeakMap below is the actual runtime authority.
- */
-export interface RecordAttachmentProjector<Owner extends RecordAttachmentOwner, Value> {
-    readonly owner: Owner;
-    readonly [recordAttachmentProjectorTypeId]: (value: Value) => Value;
-}
-export interface RecordProjection<Access extends ProjectionAccess, Value> {
-    readonly access: Access;
-    readonly [recordProjectionTypeId]: (value: Value) => Value;
-}
-interface AttemptSlotProjectionDeclaration<Value> {
-    readonly access: "attempt-slot";
-    readonly projector: RecordAttachmentProjector<"attempt", Value>;
-}
-interface AttemptOriginRunProjectionDeclaration<Value> {
-    readonly access: "attempt-origin-run";
-    readonly projector: RecordAttachmentProjector<"run", Value>;
-}
-interface SelectedRunProjectionDeclaration<Value> {
-    readonly access: "selected-run";
-    readonly projector: RecordAttachmentProjector<"run", Value>;
-}
-/**
- * @internal The factory closure is the Value witness. The union gives runtime
- * consumers an exact owner after discriminating access.
- */
-export type RecordProjectionDeclaration<Value> = AttemptSlotProjectionDeclaration<Value> | AttemptOriginRunProjectionDeclaration<Value> | SelectedRunProjectionDeclaration<Value>;
-export declare function defineRecordAttachmentProjector<Owner extends RecordAttachmentOwner, Payload, Value>(input: {
-    readonly attachment: RecordAttachmentFamily<Owner, Payload>;
-    readonly project: (value: RecordAttachmentValue<Payload>) => Value;
-}): RecordAttachmentProjector<Owner, Value>;
-export declare function attemptSlotProjection<Value>(projector: RecordAttachmentProjector<"attempt", Value>): RecordProjection<"attempt-slot", Value>;
-export declare function attemptOriginRunProjection<Value>(projector: RecordAttachmentProjector<"run", Value>): RecordProjection<"attempt-origin-run", Value>;
-export declare function selectedRunProjection<Value>(projector: RecordAttachmentProjector<"run", Value>): RecordProjection<"selected-run", Value>;
-/**
- * @internal Invokes a factory-captured generic closure after WeakMap identity
- * validation. This retains the exact attachment payload and public Value
- * without recovering either from erased map contents.
- */
-export declare function withRecordAttachmentProjector<Owner extends RecordAttachmentOwner, Value, Result>(projector: RecordAttachmentProjector<Owner, Value>, use: <Payload>(family: RecordAttachmentFamily<Owner, Payload>, project: (value: RecordAttachmentValue<Payload>) => Value) => Result): Result;
-/** @internal Rejects a copied or type-asserted projection before Record I/O. */
-export declare function recordProjectionDeclaration<Access extends ProjectionAccess, Value>(projection: RecordProjection<Access, Value>): RecordProjectionDeclaration<Value>;
-export {};

package/dist/projection/projector.js

@@ -1,16 +0,0 @@
-import { createRequire as __niceevalCreateRequire } from "node:module";
-const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
-const __niceevalCanonical = __niceevalRequire("./projector.cjs");
-const __niceevalExport0 = __niceevalCanonical["attemptOriginRunProjection"];
-export { __niceevalExport0 as attemptOriginRunProjection };
-const __niceevalExport1 = __niceevalCanonical["attemptSlotProjection"];
-export { __niceevalExport1 as attemptSlotProjection };
-const __niceevalExport2 = __niceevalCanonical["defineRecordAttachmentProjector"];
-export { __niceevalExport2 as defineRecordAttachmentProjector };
-const __niceevalExport3 = __niceevalCanonical["recordProjectionDeclaration"];
-export { __niceevalExport3 as recordProjectionDeclaration };
-const __niceevalExport4 = __niceevalCanonical["selectedRunProjection"];
-export { __niceevalExport4 as selectedRunProjection };
-const __niceevalExport5 = __niceevalCanonical["withRecordAttachmentProjector"];
-export { __niceevalExport5 as withRecordAttachmentProjector };
-//# sourceMappingURL=projector.js.map

package/dist/projection/projector.js.map

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

package/dist/projection/runtime.cjs

@@ -1,246 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.projectAnalysisSample = projectAnalysisSample;
-const effect_1 = require("effect");
-const core_ts_1 = require("../record/model/core.cjs");
-const analysis_ts_1 = require("../sample/analysis.cjs");
-const attachment_result_ts_1 = require("./attachment-result.cjs");
-const coverage_ts_1 = require("./coverage.cjs");
-const projector_ts_1 = require("./projector.cjs");
-const MAXIMUM_LOGICAL_ENTRIES = 250000;
-/**
- * The only public execution boundary. Sample resolves the exact frozen view
- * originally bound to this genuine handle; callers cannot supply a pure sample
- * or a second reader.
- */
-function projectAnalysisSample(input) {
-    return effect_1.Effect.flatMap((0, analysis_ts_1.resolveAnalysisSampleHandle)(input.sampleHandle), ({ reader, sample }) => projectAnalysisSampleFromView({ reader, sample, projection: input.projection }));
-}
-/**
- * @internal The public handle boundary supplies a verified frozen view. This
- * function never receives a path, callback, or unbound sample reader.
- */
-function projectAnalysisSampleFromView(input) {
-    return effect_1.Effect.suspend(() => {
-        const projection = (0, projector_ts_1.recordProjectionDeclaration)(input.projection);
-        const logicalEntries = projection.access === "selected-run"
-            ? input.sample.runs.length
-            : input.sample.slots.length;
-        if (logicalEntries > MAXIMUM_LOGICAL_ENTRIES) {
-            return effect_1.Effect.fail(projectionLimitError(logicalEntries));
-        }
-        switch (projection.access) {
-            case "attempt-slot":
-                return projectAttemptSlots(input.reader, input.sample, projection.projector).pipe(effect_1.Effect.map((entries) => makeAttemptSlotSample(input.sample, entries)));
-            case "attempt-origin-run":
-                return projectAttemptOriginRuns(input.reader, input.sample, projection.projector).pipe(effect_1.Effect.map((entries) => makeAttemptOriginRunSample(input.sample, entries)));
-            case "selected-run":
-                return projectSelectedRuns(input.reader, input.sample, projection.projector).pipe(effect_1.Effect.map((entries) => makeSelectedRunSample(input.sample, entries)));
-        }
-    });
-}
-function projectAttemptSlots(reader, sample, projector) {
-    return (0, projector_ts_1.withRecordAttachmentProjector)(projector, (family, project) => projectAttemptSlotsForFamily(reader, sample, family, project));
-}
-function projectAttemptSlotsForFamily(reader, sample, family, project) {
-    return effect_1.Effect.gen(function* () {
-        const entries = [];
-        const byAttempt = new Map();
-        for (const slot of sample.slots) {
-            switch (slot.state) {
-                case "excluded":
-                    entries.push(Object.freeze({ state: "excluded", slot }));
-                    break;
-                case "not-recorded":
-                    entries.push(Object.freeze({ state: "not-recorded", slot }));
-                    break;
-                case "core-invalid":
-                    entries.push(Object.freeze({ state: "core-invalid", slot }));
-                    break;
-                case "included": {
-                    const key = (0, core_ts_1.recordAttemptReferenceKey)(slot.attempt);
-                    let resolved = byAttempt.get(key);
-                    if (resolved === undefined) {
-                        const owner = yield* reader.attempt(slot.attempt);
-                        resolved = yield* projectAttemptOwner(reader, owner, family, project);
-                        byAttempt.set(key, resolved);
-                    }
-                    entries.push(attemptEntryFor(slot, resolved));
-                    break;
-                }
-                default:
-                    unreachableProjectionState(slot);
-            }
-        }
-        return Object.freeze(entries);
-    });
-}
-function projectAttemptOriginRuns(reader, sample, projector) {
-    return (0, projector_ts_1.withRecordAttachmentProjector)(projector, (family, project) => projectAttemptOriginRunsForFamily(reader, sample, family, project));
-}
-function projectAttemptOriginRunsForFamily(reader, sample, family, project) {
-    return effect_1.Effect.gen(function* () {
-        const entries = [];
-        const byRun = new Map();
-        for (const slot of sample.slots) {
-            switch (slot.state) {
-                case "excluded":
-                    entries.push(Object.freeze({ state: "excluded", slot }));
-                    break;
-                case "not-recorded":
-                    entries.push(Object.freeze({ state: "not-recorded", slot }));
-                    break;
-                case "core-invalid":
-                    entries.push(Object.freeze({ state: "core-invalid", slot }));
-                    break;
-                case "included": {
-                    const runId = slot.attempt.originRunId;
-                    let resolved = byRun.get(runId);
-                    if (resolved === undefined) {
-                        const owner = yield* reader.run(runId);
-                        resolved = yield* projectRunOwner(reader, owner, family, project);
-                        byRun.set(runId, resolved);
-                    }
-                    entries.push(originRunEntryFor(slot, resolved));
-                    break;
-                }
-                default:
-                    unreachableProjectionState(slot);
-            }
-        }
-        return Object.freeze(entries);
-    });
-}
-function projectSelectedRuns(reader, sample, projector) {
-    return (0, projector_ts_1.withRecordAttachmentProjector)(projector, (family, project) => projectSelectedRunsForFamily(reader, sample, family, project));
-}
-function projectSelectedRunsForFamily(reader, sample, family, project) {
-    return effect_1.Effect.gen(function* () {
-        const entries = [];
-        const byRun = new Map();
-        for (const run of sample.runs) {
-            let attachment = byRun.get(run.runId);
-            if (attachment === undefined) {
-                const owner = yield* reader.run(run.runId);
-                const availableOwner = requireAvailableOwner(owner, "selected Run");
-                const read = yield* reader.readRunAttachment(availableOwner, family);
-                attachment = yield* (0, attachment_result_ts_1.projectRecordAttachmentRead)(read, project);
-                byRun.set(run.runId, attachment);
-            }
-            entries.push(selectedRunEntry(run, attachment));
-        }
-        return Object.freeze(entries);
-    });
-}
-function projectAttemptOwner(reader, owner, family, project) {
-    if (owner.state === "core-invalid") {
-        return effect_1.Effect.succeed(Object.freeze({ state: "core-invalid", issues: owner.issues }));
-    }
-    if (owner.state === "missing") {
-        return effect_1.Effect.succeed(Object.freeze({
-            state: "core-invalid",
-            issues: missingOwnerIssues("attempt"),
-        }));
-    }
-    return reader.readAttemptAttachment(owner.value, family).pipe(effect_1.Effect.flatMap((read) => (0, attachment_result_ts_1.projectRecordAttachmentRead)(read, project)), effect_1.Effect.map((attachment) => Object.freeze({ state: "attachment-result", attachment })));
-}
-function projectRunOwner(reader, owner, family, project) {
-    if (owner.state === "core-invalid") {
-        return effect_1.Effect.succeed(Object.freeze({ state: "core-invalid", issues: owner.issues }));
-    }
-    if (owner.state === "missing") {
-        return effect_1.Effect.succeed(Object.freeze({
-            state: "core-invalid",
-            issues: missingOwnerIssues("run"),
-        }));
-    }
-    return reader.readRunAttachment(owner.value, family).pipe(effect_1.Effect.flatMap((read) => (0, attachment_result_ts_1.projectRecordAttachmentRead)(read, project)), effect_1.Effect.map((attachment) => Object.freeze({ state: "attachment-result", attachment })));
-}
-function attemptEntryFor(slot, resolved) {
-    if (resolved.state === "core-invalid") {
-        return coreInvalidEntry(slot, resolved.issues);
-    }
-    return Object.freeze({
-        state: "attachment-result",
-        slot,
-        owner: Object.freeze({ kind: "attempt", attempt: slot.attempt }),
-        attachment: resolved.attachment,
-    });
-}
-function originRunEntryFor(slot, resolved) {
-    if (resolved.state === "core-invalid") {
-        return coreInvalidEntry(slot, resolved.issues);
-    }
-    return Object.freeze({
-        state: "attachment-result",
-        slot,
-        owner: Object.freeze({ kind: "run", runId: slot.attempt.originRunId }),
-        attachment: resolved.attachment,
-    });
-}
-function selectedRunEntry(run, attachment) {
-    return Object.freeze({
-        state: "attachment-result",
-        run,
-        owner: Object.freeze({ kind: "run", runId: run.runId }),
-        attachment,
-    });
-}
-function coreInvalidEntry(slot, issues) {
-    const coreInvalidSlot = Object.freeze({
-        runId: slot.runId,
-        slotId: slot.slotId,
-        state: "core-invalid",
-        issues,
-    });
-    return Object.freeze({ state: "core-invalid", slot: coreInvalidSlot });
-}
-function requireAvailableOwner(read, label) {
-    if (read.state === "available") {
-        return read.value;
-    }
-    throw new Error(`${label} disappeared or became invalid in a frozen Record view`);
-}
-function missingOwnerIssues(owner) {
-    const issue = Object.freeze({
-        code: owner === "attempt" ? "record-attempt-reference-missing" : "record-attempt-owner-invalid",
-        path: Object.freeze([owner]),
-    });
-    return Object.freeze([issue]);
-}
-function makeAttemptSlotSample(sample, entries) {
-    return Object.freeze({
-        sample,
-        access: "attempt-slot",
-        entries,
-        coverage: (0, coverage_ts_1.calculateProjectionCoverage)(sample, entries),
-    });
-}
-function makeAttemptOriginRunSample(sample, entries) {
-    return Object.freeze({
-        sample,
-        access: "attempt-origin-run",
-        entries,
-        coverage: (0, coverage_ts_1.calculateProjectionCoverage)(sample, entries),
-    });
-}
-function makeSelectedRunSample(sample, entries) {
-    return Object.freeze({
-        sample,
-        access: "selected-run",
-        entries,
-        coverage: (0, coverage_ts_1.calculateProjectionCoverage)(sample, entries),
-    });
-}
-function projectionLimitError(observedAtLeast) {
-    return Object.freeze({
-        code: "projection-limit-exceeded",
-        limit: "logical-entries",
-        maximum: MAXIMUM_LOGICAL_ENTRIES,
-        observedAtLeast,
-    });
-}
-function unreachableProjectionState(value) {
-    throw new Error(`unknown Analysis Sample slot state: ${String(value)}`);
-}
-//# sourceMappingURL=runtime.cjs.map