@actuarial-ts/interchange 0.2.0

package/dist/convert/selection.js

@@ -0,0 +1,383 @@
+import { ReservingError, computeDevelopmentFactors, fitTail, triangleFromGrid, } from "@actuarial-ts/core";
+import { DEFAULT_GENERATOR, INTERCHANGE_SPEC_VERSION, stampIntegrity, } from "../envelope.js";
+import { VALUE_AUTHORITATIVE_KINDS, selectionDocSchema, } from "../schemas/selection.js";
+import { docToTriangle } from "./triangle.js";
+/**
+ * core `LdfSelections` ↔ SelectionDoc, with the coherence rule (spec 3.2).
+ *
+ * THE COHERENCE RULE (normative): for COMPUTABLE intents (everything
+ * except judgmental/external), `value` MUST equal the intent's
+ * recomputation on the referenced triangle within 1e-9 relative. Every
+ * conforming importer verifies this and, per a strictness flag, warns or
+ * refuses (INCOHERENT_SELECTION) on divergence. Intent is authoritative
+ * for replay and promotion; values are authoritative only for
+ * judgmental/external intents.
+ *
+ * REPLAY CAPABILITY (spec 3.2 equivalence table): this shore recomputes
+ * only the cells the table marks `exact` for actuarial-ts —
+ * volume-weighted/simple all-period on any cadence, windowed n ∈ {5, 3}
+ * on 12-month cadence, geometric all-period, and medial {5, 1, 1} — via
+ * core's computeDevelopmentFactors, plus fitted tails via core's fitTail.
+ * Everything else (regression, other windows/trims, and any intent with
+ * origin exclusions, which core's menu machinery does not model) is
+ * value-only HERE: the value is accepted with a warning naming the
+ * limitation, never silently, and never recomputed with semantics the
+ * table does not claim. Cross-engine verification of those cells is the
+ * conformance suite's and the referee's business.
+ */
+/** Spec coherence tolerance: 1e-9 relative (spec 3.2). */
+export const COHERENCE_TOLERANCE = 1e-9;
+/** Menu key → interchange intent (the DEFAULT_AVERAGES mapping target). */
+const MENU_INTENTS = {
+    "all-wtd": { kind: "volume-weighted" },
+    "all-str": { kind: "simple" },
+    "5-wtd": { kind: "volume-weighted", windowOriginPeriods: 5 },
+    "5-str": { kind: "simple", windowOriginPeriods: 5 },
+    "3-wtd": { kind: "volume-weighted", windowOriginPeriods: 3 },
+    "3-str": { kind: "simple", windowOriginPeriods: 3 },
+    "med-5x1": { kind: "medial", windowOriginPeriods: 5, excludeHigh: 1, excludeLow: 1 },
+    "geo-all": { kind: "geometric" },
+};
+const MENU_KEYS = Object.keys(MENU_INTENTS);
+/** The interchange intent a standard-menu average key expresses. */
+export function intentFromAverageKey(key) {
+    return { ...MENU_INTENTS[key] };
+}
+function hasExclusions(intent) {
+    return intent.exclusions !== undefined && intent.exclusions.length > 0;
+}
+/**
+ * The standard-menu key that replays this intent EXACTLY on the given
+ * cadence per the spec 3.2 equivalence table, or null (value-only here).
+ */
+export function averageKeyForIntent(intent, originLengthMonths) {
+    if (hasExclusions(intent))
+        return null;
+    const window = intent.windowOriginPeriods;
+    switch (intent.kind) {
+        case "volume-weighted":
+            if (window === undefined)
+                return "all-wtd";
+            if (originLengthMonths === 12 && (window === 5 || window === 3)) {
+                return window === 5 ? "5-wtd" : "3-wtd";
+            }
+            return null;
+        case "simple":
+            if (window === undefined)
+                return "all-str";
+            if (originLengthMonths === 12 && (window === 5 || window === 3)) {
+                return window === 5 ? "5-str" : "3-str";
+            }
+            return null;
+        case "geometric":
+            return window === undefined ? "geo-all" : null;
+        case "medial":
+            return originLengthMonths === 12 &&
+                window === 5 &&
+                intent.excludeHigh === 1 &&
+                intent.excludeLow === 1
+                ? "med-5x1"
+                : null;
+        default:
+            return null;
+    }
+}
+function isValueAuthoritative(kind) {
+    return VALUE_AUTHORITATIVE_KINDS.includes(kind);
+}
+/** The AverageSpec core recomputes an exactly-replayable intent with. */
+function specForExactIntent(key) {
+    const kindByKey = {
+        "all-wtd": "weighted",
+        "all-str": "straight",
+        "5-wtd": "weighted",
+        "5-str": "straight",
+        "3-wtd": "weighted",
+        "3-str": "straight",
+        "med-5x1": "medial",
+        "geo-all": "geometric",
+    };
+    const spec = { key, label: key, kind: kindByKey[key] };
+    const years = MENU_INTENTS[key].windowOriginPeriods;
+    if (years !== undefined)
+        spec.years = years;
+    return spec;
+}
+const TAIL_METHOD_BY_FAMILY = {
+    "exponential-decay": "exponentialDecay",
+    "inverse-power": "inversePower",
+};
+function relativeDeviation(actual, expected) {
+    const scale = Math.max(Math.abs(actual), Math.abs(expected));
+    return scale === 0 ? 0 : Math.abs(actual - expected) / scale;
+}
+/** Maps development entries to triangle column indexes; refuses unknown or
+ * duplicated intervals. */
+function mapEntriesToColumns(development, agesMonths) {
+    const seen = new Set();
+    return development.map((entry) => {
+        const j = agesMonths.findIndex((age, idx) => age === entry.fromAgeMonths && agesMonths[idx + 1] === entry.toAgeMonths);
+        if (j < 0) {
+            throw new ReservingError("BAD_INTERCHANGE", `Development interval ${entry.fromAgeMonths}→${entry.toAgeMonths} months does not match ` +
+                `adjacent triangle ages (agesMonths: ${agesMonths.join(", ")})`);
+        }
+        if (seen.has(j)) {
+            throw new ReservingError("BAD_INTERCHANGE", `Duplicate development entry for ${entry.fromAgeMonths}→${entry.toAgeMonths} months`);
+        }
+        seen.add(j);
+        return j;
+    });
+}
+/** Two-age sub-triangle for column j: recomputation without cross-column effects. */
+function columnSubTriangle(tri, j) {
+    return triangleFromGrid(tri.kind, tri.origins, [tri.ages[j], tri.ages[j + 1]], tri.values.map((row) => [row[j] ?? null, row[j + 1] ?? null]));
+}
+/**
+ * Verifies the coherence rule for a selection body against its referenced
+ * triangle document. Verifies the appliesTo linkage first (tag + measure);
+ * a mismatch is BAD_INTERCHANGE, not incoherence.
+ */
+export function checkSelectionCoherence(selection, triangleDoc, options) {
+    if (selection.appliesTo.triangleIntegrity !== triangleDoc.integrity) {
+        throw new ReservingError("BAD_INTERCHANGE", `Selection applies to triangle ${selection.appliesTo.triangleIntegrity} but the supplied ` +
+            `triangle document's integrity is ${triangleDoc.integrity}`);
+    }
+    if (selection.appliesTo.measure !== triangleDoc.triangle.measure) {
+        throw new ReservingError("BAD_INTERCHANGE", `Selection applies to measure "${selection.appliesTo.measure}" but the triangle's measure ` +
+            `is "${triangleDoc.triangle.measure}"`);
+    }
+    const { triangle } = docToTriangle(triangleDoc);
+    const cadence = triangleDoc.triangle.originLengthMonths;
+    const agesMonths = triangleDoc.triangle.agesMonths;
+    const columns = mapEntriesToColumns(selection.development, agesMonths);
+    const findings = [];
+    const warnings = [];
+    selection.development.forEach((entry, idx) => {
+        const target = { fromAgeMonths: entry.fromAgeMonths, toAgeMonths: entry.toAgeMonths };
+        const label = `${entry.fromAgeMonths}→${entry.toAgeMonths}`;
+        if (isValueAuthoritative(entry.intent.kind)) {
+            findings.push({
+                target,
+                capability: "value-only",
+                authoritative: "value",
+                expected: null,
+                actual: entry.value,
+                relativeDeviation: null,
+                coherent: null,
+                note: `intent "${entry.intent.kind}": the value IS the judgment (rationale carries its justification)`,
+            });
+            return;
+        }
+        const menuKey = averageKeyForIntent(entry.intent, cadence);
+        if (menuKey === null) {
+            const reason = hasExclusions(entry.intent)
+                ? "origin exclusions are beyond this shore's exact replay in Phase A"
+                : `intent "${entry.intent.kind}"${entry.intent.windowOriginPeriods !== undefined
+                    ? ` with windowOriginPeriods ${entry.intent.windowOriginPeriods}`
+                    : ""} on ${cadence}-month cadence is not an exact actuarial-ts replay cell`;
+            findings.push({
+                target,
+                capability: "value-only",
+                authoritative: "intent",
+                expected: null,
+                actual: entry.value,
+                relativeDeviation: null,
+                coherent: null,
+                note: reason,
+            });
+            warnings.push(`Development ${label}: value accepted without recomputation — ${reason} ` +
+                "(spec 3.2 equivalence table)");
+            return;
+        }
+        const recomputed = computeDevelopmentFactors(columnSubTriangle(triangle, columns[idx]), [
+            specForExactIntent(menuKey),
+        ]).averages[0].values[0];
+        if (recomputed === null) {
+            findings.push({
+                target,
+                capability: "exact",
+                authoritative: "intent",
+                expected: null,
+                actual: entry.value,
+                relativeDeviation: null,
+                coherent: false,
+                note: "the intent produces no factor on this triangle (no usable pairs in the window)",
+            });
+            return;
+        }
+        const deviation = relativeDeviation(entry.value, recomputed);
+        findings.push({
+            target,
+            capability: "exact",
+            authoritative: "intent",
+            expected: recomputed,
+            actual: entry.value,
+            relativeDeviation: deviation,
+            coherent: deviation <= COHERENCE_TOLERANCE,
+        });
+    });
+    if (selection.tail !== undefined) {
+        const tail = selection.tail;
+        if (isValueAuthoritative(tail.intent.kind)) {
+            findings.push({
+                target: "tail",
+                capability: "value-only",
+                authoritative: "value",
+                expected: null,
+                actual: tail.value,
+                relativeDeviation: null,
+                coherent: null,
+                note: `tail intent "${tail.intent.kind}": the value IS the judgment`,
+            });
+        }
+        else {
+            // Fitted tail: refit core's curve on the selection's own development
+            // factors (the fit runs on SELECTED factors), masking columns below
+            // fitFromAgeMonths.
+            const selectedLdfs = new Array(agesMonths.length - 1).fill(null);
+            selection.development.forEach((entry, idx) => {
+                selectedLdfs[columns[idx]] =
+                    tail.intent.kind === "fitted" &&
+                        tail.intent.fitFromAgeMonths !== undefined &&
+                        entry.fromAgeMonths < tail.intent.fitFromAgeMonths
+                        ? null
+                        : entry.value;
+            });
+            const fit = fitTail({
+                method: TAIL_METHOD_BY_FAMILY[tail.intent.family],
+                selectedLdfs,
+            });
+            if (!fit.valid) {
+                findings.push({
+                    target: "tail",
+                    capability: "exact",
+                    authoritative: "intent",
+                    expected: null,
+                    actual: tail.value,
+                    relativeDeviation: null,
+                    coherent: false,
+                    note: `the fitted-tail intent does not produce a valid fit on this selection: ${fit.warnings.join("; ")}`,
+                });
+            }
+            else {
+                const deviation = relativeDeviation(tail.value, fit.tailFactor);
+                findings.push({
+                    target: "tail",
+                    capability: "exact",
+                    authoritative: "intent",
+                    expected: fit.tailFactor,
+                    actual: tail.value,
+                    relativeDeviation: deviation,
+                    coherent: deviation <= COHERENCE_TOLERANCE,
+                });
+            }
+        }
+    }
+    const divergent = findings.filter((f) => f.coherent === false);
+    for (const f of divergent) {
+        const where = f.target === "tail" ? "tail" : `${f.target.fromAgeMonths}→${f.target.toAgeMonths}`;
+        warnings.push(`INCOHERENT at ${where}: stated value ${f.actual}` +
+            (f.expected !== null
+                ? ` but the intent recomputes to ${f.expected} (relative deviation ${f.relativeDeviation?.toExponential(3)}, tolerance ${COHERENCE_TOLERANCE})`
+                : ` but the intent is not computable on this triangle${f.note !== undefined ? ` (${f.note})` : ""}`));
+    }
+    if (divergent.length > 0 && options.strictness === "refuse") {
+        throw new ReservingError("INCOHERENT_SELECTION", `Selection violates the coherence rule (spec 3.2) at ${divergent.length} target(s): ` +
+            warnings.filter((w) => w.startsWith("INCOHERENT")).join(" | "));
+    }
+    return { coherent: divergent.length === 0, findings, warnings };
+}
+function resolveIntent(input) {
+    return typeof input === "string" && MENU_KEYS.includes(input)
+        ? intentFromAverageKey(input)
+        : input;
+}
+export function selectionsToDoc(selections, options) {
+    const agesMonths = options.triangleDoc.triangle.agesMonths;
+    const nColumns = agesMonths.length - 1;
+    if (selections.selected.length !== nColumns) {
+        throw new ReservingError("SELECTION_SHAPE", `Expected ${nColumns} LDF selections (one per development interval), got ${selections.selected.length}`);
+    }
+    if (options.intents.length !== nColumns) {
+        throw new ReservingError("BAD_INTERCHANGE", `Expected ${nColumns} intents (one per development column), got ${options.intents.length}`);
+    }
+    const development = [];
+    for (let j = 0; j < nColumns; j++) {
+        const value = selections.selected[j];
+        if (value === null || value === undefined)
+            continue;
+        const intentInput = options.intents[j];
+        if (intentInput === null || intentInput === undefined) {
+            throw new ReservingError("BAD_INTERCHANGE", `Column ${agesMonths[j]}→${agesMonths[j + 1]} months has a selected factor but no intent; ` +
+                'hand-picked values need { kind: "judgmental", rationale: "..." }');
+        }
+        development.push({
+            fromAgeMonths: agesMonths[j],
+            toAgeMonths: agesMonths[j + 1],
+            value,
+            intent: resolveIntent(intentInput),
+        });
+    }
+    const body = {
+        appliesTo: {
+            measure: options.triangleDoc.triangle.measure,
+            triangleIntegrity: options.triangleDoc.integrity,
+        },
+        development,
+    };
+    if (options.tailIntent !== undefined) {
+        body.tail = { value: selections.tailFactor, intent: options.tailIntent };
+    }
+    else if (selections.tailFactor !== 1) {
+        throw new ReservingError("BAD_INTERCHANGE", `Tail factor ${selections.tailFactor} needs a tailIntent (fitted, or judgmental/external with rationale); ` +
+            "only a tail of exactly 1 may be omitted");
+    }
+    const coherence = checkSelectionCoherence(body, options.triangleDoc, {
+        strictness: options.strictness ?? "refuse",
+    });
+    const doc = stampIntegrity({
+        interchangeVersion: INTERCHANGE_SPEC_VERSION,
+        kind: "selection",
+        generator: options.generator ?? DEFAULT_GENERATOR,
+        createdAt: options.createdAt,
+        extensions: options.extensions ?? {},
+        selection: body,
+    });
+    const checked = selectionDocSchema.safeParse(doc);
+    if (!checked.success) {
+        throw new ReservingError("BAD_INTERCHANGE", `selectionsToDoc produced an invalid document: ${checked.error.issues
+            .map((i) => `${i.path.join(".") || "$"}: ${i.message}`)
+            .join("; ")}`);
+    }
+    return { doc: checked.data, coherence, warnings: coherence.warnings };
+}
+export function docToSelections(doc, options) {
+    const parsed = selectionDocSchema.safeParse(doc);
+    if (!parsed.success) {
+        throw new ReservingError("BAD_INTERCHANGE", `Not a valid SelectionDoc: ${parsed.error.issues
+            .map((i) => `${i.path.join(".") || "$"}: ${i.message}`)
+            .join("; ")}`);
+    }
+    const body = parsed.data.selection;
+    const agesMonths = options.triangleDoc.triangle.agesMonths;
+    const cadence = options.triangleDoc.triangle.originLengthMonths;
+    const coherence = checkSelectionCoherence(body, options.triangleDoc, {
+        strictness: options.strictness ?? "warn",
+    });
+    const columns = mapEntriesToColumns(body.development, agesMonths);
+    const selected = new Array(agesMonths.length - 1).fill(null);
+    const averageKeys = new Array(agesMonths.length - 1).fill(null);
+    body.development.forEach((entry, idx) => {
+        selected[columns[idx]] = entry.value;
+        averageKeys[columns[idx]] = isValueAuthoritative(entry.intent.kind)
+            ? null
+            : averageKeyForIntent(entry.intent, cadence);
+    });
+    return {
+        selections: { selected, tailFactor: body.tail?.value ?? 1 },
+        averageKeys,
+        coherence,
+        warnings: coherence.warnings,
+    };
+}
+//# sourceMappingURL=selection.js.map

package/dist/convert/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/convert/selection.ts"],"names":[],"mappings":"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"}

package/dist/convert/triangle.d.ts

@@ -0,0 +1,49 @@
+import { type Triangle } from "@actuarial-ts/core";
+import { type GeneratorStamp } from "../envelope.js";
+import { type Measure, type OriginLengthMonths, type TriangleBody, type TriangleDoc } from "../schemas/triangle.js";
+/**
+ * core `Triangle` ↔ TriangleDoc.
+ *
+ * - The seven core TriangleKind values are the interchange measures of the
+ *   same name, both directions.
+ * - Cadence: annual ("2023") and quarterly ("2023Q3") origin labels derive
+ *   starts and originLengthMonths automatically; anything else needs
+ *   explicit `originStarts` + `originLengthMonths`. Reading 1- or 6-month
+ *   cadences parses with a capability warning (spec 3.2).
+ * - `createdAt` and `valuationDate` are caller-supplied — this module
+ *   never reads a clock (purity rule).
+ * - Null means unobserved, both directions, always.
+ */
+export interface TriangleToDocOptions {
+    /** ISO timestamp for the envelope (caller-supplied; purity rule). */
+    createdAt: string;
+    /** ISO yyyy-mm-dd valuation date of the triangle. */
+    valuationDate: string;
+    /** Interchange measure; defaults to the core kind, which maps verbatim. */
+    measure?: Measure;
+    /** Whether values are cumulative. Core triangles are; defaults true. */
+    cumulative?: boolean;
+    /** Override when labels are not annual/quarterly (e.g. semiannual). */
+    originLengthMonths?: OriginLengthMonths;
+    /** Explicit origin period start dates; required when labels do not parse. */
+    originStarts?: string[];
+    basis?: TriangleBody["basis"];
+    units?: TriangleBody["units"];
+    segment?: TriangleBody["segment"];
+    extensions?: Record<string, unknown>;
+    generator?: GeneratorStamp;
+}
+export declare function triangleToDoc(tri: Triangle, options: TriangleToDocOptions): TriangleDoc;
+export interface DocToTriangleResult {
+    triangle: Triangle;
+    warnings: string[];
+}
+/**
+ * TriangleDoc → core `Triangle`. Validates the document SCHEMA (integrity
+ * verification is parseDocument's job — pass documents through it first
+ * when provenance matters), maps the measure to a core kind, cumulates incremental
+ * values through core's `incrementalToCumulative` (with a warning), and
+ * channels reader-capability warnings for 1-/6-month cadences.
+ */
+export declare function docToTriangle(doc: unknown): DocToTriangleResult;
+//# sourceMappingURL=triangle.d.ts.map

package/dist/convert/triangle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triangle.d.ts","sourceRoot":"","sources":["../../src/convert/triangle.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EAId,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,KAAK,cAAc,EAEpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAEjB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAqBD,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,oBAAoB,GAAG,WAAW,CA6DvF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAQD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,CAkD/D"}

package/dist/convert/triangle.js

@@ -0,0 +1,111 @@
+import { ReservingError, incrementalToCumulative, triangleFromGrid, } from "@actuarial-ts/core";
+import { DEFAULT_GENERATOR, INTERCHANGE_SPEC_VERSION, stampIntegrity, } from "../envelope.js";
+import { CORE_MEASURES, triangleDocSchema, } from "../schemas/triangle.js";
+function deriveOrigin(label) {
+    const annual = /^(\d{4})$/.exec(label);
+    if (annual)
+        return { start: `${annual[1]}-01-01`, lengthMonths: 12 };
+    const quarterly = /^(\d{4})[Qq]([1-4])$/.exec(label);
+    if (quarterly) {
+        const month = (Number(quarterly[2]) - 1) * 3 + 1;
+        return {
+            start: `${quarterly[1]}-${String(month).padStart(2, "0")}-01`,
+            lengthMonths: 3,
+        };
+    }
+    return null;
+}
+export function triangleToDoc(tri, options) {
+    let starts = options.originStarts;
+    let lengthMonths = options.originLengthMonths;
+    if (starts === undefined || lengthMonths === undefined) {
+        const derived = tri.origins.map(deriveOrigin);
+        const missing = derived.findIndex((d) => d === null);
+        if (missing >= 0) {
+            throw new ReservingError("BAD_INTERCHANGE", `Origin label "${tri.origins[missing]}" is neither annual ("2023") nor quarterly ` +
+                `("2023Q3"); supply originStarts and originLengthMonths explicitly`);
+        }
+        const lengths = new Set(derived.map((d) => d.lengthMonths));
+        if (lengths.size > 1) {
+            throw new ReservingError("BAD_INTERCHANGE", "Origin labels mix annual and quarterly forms; supply originStarts and originLengthMonths explicitly");
+        }
+        starts ??= derived.map((d) => d.start);
+        lengthMonths ??= derived[0].lengthMonths;
+    }
+    if (starts.length !== tri.origins.length) {
+        throw new ReservingError("BAD_INTERCHANGE", `originStarts has ${starts.length} entries but the triangle has ${tri.origins.length} origins`);
+    }
+    const body = {
+        measure: options.measure ?? tri.kind,
+        cumulative: options.cumulative ?? true,
+        originLengthMonths: lengthMonths,
+        origins: tri.origins.map((label, i) => ({ label, start: starts[i] })),
+        agesMonths: [...tri.ages],
+        values: tri.values.map((row) => [...row]),
+        valuationDate: options.valuationDate,
+    };
+    if (options.basis !== undefined)
+        body.basis = options.basis;
+    if (options.units !== undefined)
+        body.units = options.units;
+    if (options.segment !== undefined)
+        body.segment = options.segment;
+    const doc = stampIntegrity({
+        interchangeVersion: INTERCHANGE_SPEC_VERSION,
+        kind: "triangle",
+        generator: options.generator ?? DEFAULT_GENERATOR,
+        createdAt: options.createdAt,
+        extensions: options.extensions ?? {},
+        triangle: body,
+    });
+    const checked = triangleDocSchema.safeParse(doc);
+    if (!checked.success) {
+        throw new ReservingError("BAD_INTERCHANGE", `triangleToDoc produced an invalid document: ${checked.error.issues
+            .map((i) => i.message)
+            .join("; ")}`);
+    }
+    return checked.data;
+}
+function measureToKind(measure) {
+    return CORE_MEASURES.includes(measure)
+        ? measure
+        : null;
+}
+/**
+ * TriangleDoc → core `Triangle`. Validates the document SCHEMA (integrity
+ * verification is parseDocument's job — pass documents through it first
+ * when provenance matters), maps the measure to a core kind, cumulates incremental
+ * values through core's `incrementalToCumulative` (with a warning), and
+ * channels reader-capability warnings for 1-/6-month cadences.
+ */
+export function docToTriangle(doc) {
+    const parsed = triangleDocSchema.safeParse(doc);
+    if (!parsed.success) {
+        throw new ReservingError("BAD_INTERCHANGE", `Not a valid TriangleDoc: ${parsed.error.issues
+            .map((i) => `${i.path.join(".") || "$"}: ${i.message}`)
+            .join("; ")}`);
+    }
+    const triangleDoc = parsed.data;
+    const body = triangleDoc.triangle;
+    const kind = measureToKind(body.measure);
+    if (kind === null) {
+        throw new ReservingError("BAD_INTERCHANGE", `Measure "${body.measure}" has no core triangle kind (core kinds: ${CORE_MEASURES.join(", ")}); ` +
+            "premium and custom measures are handled as exposure/reference data, not core triangles");
+    }
+    if (body.values === undefined) {
+        throw new ReservingError("BAD_INTERCHANGE", "This triangle carries only a bulk-lane valuesRef; Phase A converters require inline values");
+    }
+    const warnings = [];
+    if (body.originLengthMonths === 1 || body.originLengthMonths === 6) {
+        warnings.push(`originLengthMonths ${body.originLengthMonths} parsed successfully, but actuarial-ts ` +
+            "computes natively on 12- and 3-month cadences; computation support is limited");
+    }
+    let triangle = triangleFromGrid(kind, body.origins.map((o) => o.label), body.agesMonths, body.values);
+    if (!body.cumulative) {
+        triangle = incrementalToCumulative(triangle);
+        warnings.push("Incremental values were cumulated via core incrementalToCumulative (a null stops " +
+            "accumulation for its row); core methods run on cumulative triangles");
+    }
+    return { triangle, warnings };
+}
+//# sourceMappingURL=triangle.js.map

package/dist/convert/triangle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triangle.js","sourceRoot":"","sources":["../../src/convert/triangle.ts"],"names":[],"mappings":"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"}