@uwmd/core 1.7.0 → 1.8.0

package/dist/calc/errors.d.ts

@@ -1,5 +1,5 @@
 import type { ProtocolError } from '../protocol.js';
-export type CalcErrorCode = 'CALC-PARSE-001' | 'CALC-RESOLVE-001' | 'CALC-TYPE-001' | 'CALC-DIV-ZERO' | 'CALC-IRR-DIVERGE' | 'CALC-LIMIT-001';
+export type CalcErrorCode = 'CALC-PARSE-001' | 'CALC-RESOLVE-001' | 'CALC-TYPE-001' | 'CALC-DIV-ZERO' | 'CALC-IRR-DIVERGE' | 'CALC-LIMIT-001' | 'CALC-SENS-001' | 'CALC-SENS-002' | 'CALC-SENS-003' | 'CALC-SENS-004' | 'CALC-SENS-005' | 'CALC-STOCH-001' | 'CALC-STOCH-002' | 'CALC-STOCH-003' | 'CALC-STOCH-004' | 'CALC-STOCH-005' | 'CALC-STOCH-006';
 export declare function calcError(code: CalcErrorCode, message: string, pointer?: string): ProtocolError;
 export declare class CalcError extends Error {
     readonly proto: ProtocolError;

package/dist/calc/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/calc/errors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,aAAa,GACrB,gBAAgB,GAChB,kBAAkB,GAClB,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,gBAAgB,CAAC;AAErB,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,CAO/F;AAED,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;gBAClB,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAInE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/calc/errors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,aAAa,GACrB,gBAAgB,GAChB,kBAAkB,GAClB,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,gBAAgB,GAKhB,eAAe,GACf,eAAe,GACf,eAAe,GACf,eAAe,GACf,eAAe,GAIf,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,CAO/F;AAED,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;gBAClB,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAInE"}

package/dist/calc/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/calc/errors.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,uCAAuC;AAYvC,MAAM,UAAU,SAAS,CAAC,IAAmB,EAAE,OAAe,EAAE,OAAgB;IAC9E,OAAO;QACL,QAAQ,EAAE,MAAM;QAChB,IAAI;QACJ,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,KAAK,CAAgB;IAC9B,YAAY,IAAmB,EAAE,OAAe,EAAE,OAAgB;QAChE,KAAK,CAAC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/calc/errors.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,uCAAuC;AA8BvC,MAAM,UAAU,SAAS,CAAC,IAAmB,EAAE,OAAe,EAAE,OAAgB;IAC9E,OAAO;QACL,QAAQ,EAAE,MAAM;QAChB,IAAI;QACJ,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,KAAK,CAAgB;IAC9B,YAAY,IAAmB,EAAE,OAAe,EAAE,OAAgB;QAChE,KAAK,CAAC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/calc/evaluator.js

@@ -15,9 +15,18 @@ function evalNode(expr, ctx, state) {
     switch (expr.kind) {
         case 'literal':
             return expr.value;
-        case 'ident':
+        case 'ident': {
+            const overridden = lookupOverride(expr.name, ctx);
+            if (overridden !== undefined)
+                return overridden;
             return resolveIdentifier(expr.name, ctx);
+        }
         case 'path': {
+            // The whole dotted path is checked first, so `dcf.exit_cap_rate` can be
+            // overridden without shadowing everything else under `dcf`.
+            const overridden = lookupOverride([expr.head, ...expr.segments].join('.'), ctx);
+            if (overridden !== undefined)
+                return overridden;
             const head = resolveIdentifier(expr.head, ctx);
             if (head === null || head === undefined)
                 return null;
@@ -90,6 +99,21 @@ function evalNode(expr, ctx, state) {
     }
 }
 // ─── Variable resolution ──────────────────────────────────────────────────────
+/**
+ * An override for this exact path, or `undefined` when there is none.
+ *
+ * `undefined` rather than `null` is load-bearing: `null` is a legitimate
+ * override value meaning "treat this as absent", and collapsing the two would
+ * make it impossible to ask what a formula does when an input goes missing.
+ */
+function lookupOverride(path, ctx) {
+    const overrides = ctx.overrides;
+    if (!overrides)
+        return undefined;
+    if (!Object.prototype.hasOwnProperty.call(overrides, path))
+        return undefined;
+    return overrides[path] ?? null;
+}
 function resolveIdentifier(name, ctx) {
     // A blocked head is unresolvable for the same reason a blocked segment is:
     // no document-authored name may reach the prototype chain.

package/dist/calc/evaluator.js.map

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

package/dist/calc/prng.d.ts

@@ -0,0 +1,59 @@
+/** The algorithm identifier a result echoes back, so a reader can tell what produced it. */
+export declare const PRNG_ALGORITHM: "pcg-xsl-rr-128-64";
+export declare class Pcg64 {
+    private state;
+    /**
+     * Seeded exactly as the reference `srandom` does: zero the state, step it,
+     * add the seed, step again. Reproducing that sequence matters more than it
+     * looks — a host that merely assigned the seed to the state would produce a
+     * different stream from every correct implementation, while still being
+     * perfectly deterministic and therefore passing any self-consistency test.
+     */
+    constructor(seed: bigint | number);
+    private step;
+    /** One 64-bit output. */
+    nextUint64(): bigint;
+    /**
+     * A double in `[0, 1)`, using the top 53 bits — the exact width of a double's
+     * mantissa.
+     *
+     * 53 and not 64: dividing a 64-bit integer by 2^64 rounds, so two integers
+     * differing in their low bits can map to the same double while a third maps
+     * to `1.0`. Taking 53 bits and dividing by 2^53 is exact for every input, so
+     * the result is a faithful function of the draw and never reaches 1.0.
+     */
+    nextDouble(): number;
+}
+/** A uniform draw on `[min, max)`. Arithmetic only, so bit-exact everywhere. */
+export declare function sampleUniform(u: number, min: number, max: number): number;
+/**
+ * A triangular draw. Uses `sqrt`, which IEEE 754 specifies exactly, so this is
+ * bit-exact everywhere too.
+ *
+ * Worth having beyond its own merits: the asset-class default tables already
+ * carry `low`/`central`/`high`, which are exactly a triangular distribution's
+ * parameters. An adopter can turn the existing napkin-mode ranges into
+ * distributions without inventing any numbers (RFC 0005 §Range types).
+ */
+export declare function sampleTriangular(u: number, min: number, mode: number, max: number): number;
+/**
+ * Inverse standard-normal CDF — Acklam's rational approximation.
+ *
+ * **This one is not bit-exact across platforms, and the spec says so.** The
+ * central region (0.02425 ≤ p ≤ 0.97575, about 95% of draws) is arithmetic
+ * only and therefore exact. Both tails need `log`, which no standard requires
+ * to be correctly rounded, so two hosts can disagree in the last place there.
+ *
+ * The alternative was to reject the normal distribution outright, and that is
+ * worse: it is the distribution adopters actually reach for. So it ships, the
+ * limitation is normative (§VIII.8.4), and conformance compares normal-derived
+ * summaries at a stated tolerance while `uniform` and `triangular` are pinned
+ * exactly. Naming which distributions are exact is more useful than a blanket
+ * tolerance that hides the difference.
+ *
+ * Relative error of the approximation itself is about 1.15e-9.
+ */
+export declare function inverseNormalCdf(p: number): number;
+/** A normal draw, via {@link inverseNormalCdf}. */
+export declare function sampleNormal(u: number, mean: number, stddev: number): number;
+//# sourceMappingURL=prng.d.ts.map

package/dist/calc/prng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prng.d.ts","sourceRoot":"","sources":["../../src/calc/prng.ts"],"names":[],"mappings":"AAuCA,4FAA4F;AAC5F,eAAO,MAAM,cAAc,EAAG,mBAA4B,CAAC;AAE3D,qBAAa,KAAK;IAChB,OAAO,CAAC,KAAK,CAAS;IAEtB;;;;;;OAMG;gBACS,IAAI,EAAE,MAAM,GAAG,MAAM;IAOjC,OAAO,CAAC,IAAI;IAIZ,yBAAyB;IACzB,UAAU,IAAI,MAAM;IAUpB;;;;;;;;OAQG;IACH,UAAU,IAAI,MAAM;CAGrB;AAkBD,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAM1F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAqDlD;AAED,mDAAmD;AACnD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5E"}

package/dist/calc/prng.js

@@ -0,0 +1,181 @@
+// PCG-XSL-RR-128/64 ("pcg64") — the normative PRNG for stochastic
+// calculations (protocol §VIII.8, RFC 0005).
+//
+// The whole point of specifying an algorithm rather than reaching for a
+// library is that the seed and the algorithm together ARE the determinism
+// contract. Two conforming hosts given the same seed must produce the same
+// sample sequence, or a stochastic calc is not reproducible and the format's
+// core promise — that the numbers follow from the inputs — stops holding for
+// anything with uncertainty in it. A library dependency would make its version
+// part of that contract; forty lines here do not.
+//
+// BigInt rather than a 64-bit-pair trick: the state is 128 bits, and hand-rolled
+// limb arithmetic is exactly where an implementation quietly diverges from
+// every other one. Speed is not the constraint — the sample cap is 100,000
+// draws, which BigInt handles in milliseconds.
+//
+// ─────────────────────────────────────────────────────────────────────────────
+// VERIFICATION GAP, stated rather than buried:
+//
+// The test vector in `prng.test.ts` and in `conformance/stochastic/` was
+// generated BY THIS IMPLEMENTATION. It proves self-consistency across runs and
+// platforms; it does NOT prove agreement with the reference C implementation at
+// pcg-random.org. The algorithm below is written from the published
+// specification, but nobody has diffed its output against O'Neill's.
+//
+// That check is cheap and has not been done. Until it is, an implementer
+// porting this to another language should port THIS code, not write pcg64 from
+// the paper and assume the two agree. The steps to close it are in
+// docs/handoff/HUMAN-verify-pcg64-vector.md; RFC 0005 records the same caveat.
+// ─────────────────────────────────────────────────────────────────────────────
+const MASK_128 = (1n << 128n) - 1n;
+const MASK_64 = (1n << 64n) - 1n;
+/** PCG64 multiplier, from the reference implementation. */
+const MULTIPLIER = 47026247687942121848144207491837523525n;
+/** PCG64 default stream increment. */
+const INCREMENT = 117397592171526113268558934119004209487n;
+/** The algorithm identifier a result echoes back, so a reader can tell what produced it. */
+export const PRNG_ALGORITHM = 'pcg-xsl-rr-128-64';
+export class Pcg64 {
+    state;
+    /**
+     * Seeded exactly as the reference `srandom` does: zero the state, step it,
+     * add the seed, step again. Reproducing that sequence matters more than it
+     * looks — a host that merely assigned the seed to the state would produce a
+     * different stream from every correct implementation, while still being
+     * perfectly deterministic and therefore passing any self-consistency test.
+     */
+    constructor(seed) {
+        this.state = 0n;
+        this.step();
+        this.state = (this.state + (BigInt(seed) & MASK_128)) & MASK_128;
+        this.step();
+    }
+    step() {
+        this.state = (this.state * MULTIPLIER + INCREMENT) & MASK_128;
+    }
+    /** One 64-bit output. */
+    nextUint64() {
+        this.step();
+        // XSL: fold the high half into the low half.
+        const xorshifted = ((this.state >> 64n) ^ this.state) & MASK_64;
+        // RR: rotate right by the top six bits of the state.
+        const rot = Number((this.state >> 122n) & 63n);
+        if (rot === 0)
+            return xorshifted;
+        return ((xorshifted >> BigInt(rot)) | (xorshifted << BigInt(64 - rot))) & MASK_64;
+    }
+    /**
+     * A double in `[0, 1)`, using the top 53 bits — the exact width of a double's
+     * mantissa.
+     *
+     * 53 and not 64: dividing a 64-bit integer by 2^64 rounds, so two integers
+     * differing in their low bits can map to the same double while a third maps
+     * to `1.0`. Taking 53 bits and dividing by 2^53 is exact for every input, so
+     * the result is a faithful function of the draw and never reaches 1.0.
+     */
+    nextDouble() {
+        return Number(this.nextUint64() >> 11n) / 9007199254740992; // 2^53
+    }
+}
+// ─── Inverse-CDF sampling ────────────────────────────────────────────────────
+//
+// Every distribution is sampled by inverting its CDF at a uniform draw, and
+// that choice is about cross-implementation determinism rather than elegance.
+//
+// IEEE 754 exactly specifies `+ - * /` and `sqrt`. It does NOT specify `log`,
+// `exp`, `sin`, or `cos` — those are libm functions whose last-place results
+// differ between platforms and versions. So the textbook normal samplers are
+// unusable: Box-Muller needs `log` and `cos`, Marsaglia polar needs `log`.
+// Either produces samples that agree to about fifteen digits across hosts and
+// disagree in the sixteenth, which is how "reproducible" becomes "reproducible
+// on my machine".
+//
+// This buys exactness for two of the three distributions, and the third is
+// honest about not having it — see `inverseNormalCdf`.
+/** A uniform draw on `[min, max)`. Arithmetic only, so bit-exact everywhere. */
+export function sampleUniform(u, min, max) {
+    return min + u * (max - min);
+}
+/**
+ * A triangular draw. Uses `sqrt`, which IEEE 754 specifies exactly, so this is
+ * bit-exact everywhere too.
+ *
+ * Worth having beyond its own merits: the asset-class default tables already
+ * carry `low`/`central`/`high`, which are exactly a triangular distribution's
+ * parameters. An adopter can turn the existing napkin-mode ranges into
+ * distributions without inventing any numbers (RFC 0005 §Range types).
+ */
+export function sampleTriangular(u, min, mode, max) {
+    const span = max - min;
+    if (span === 0)
+        return min;
+    const split = (mode - min) / span;
+    if (u < split)
+        return min + Math.sqrt(u * span * (mode - min));
+    return max - Math.sqrt((1 - u) * span * (max - mode));
+}
+/**
+ * Inverse standard-normal CDF — Acklam's rational approximation.
+ *
+ * **This one is not bit-exact across platforms, and the spec says so.** The
+ * central region (0.02425 ≤ p ≤ 0.97575, about 95% of draws) is arithmetic
+ * only and therefore exact. Both tails need `log`, which no standard requires
+ * to be correctly rounded, so two hosts can disagree in the last place there.
+ *
+ * The alternative was to reject the normal distribution outright, and that is
+ * worse: it is the distribution adopters actually reach for. So it ships, the
+ * limitation is normative (§VIII.8.4), and conformance compares normal-derived
+ * summaries at a stated tolerance while `uniform` and `triangular` are pinned
+ * exactly. Naming which distributions are exact is more useful than a blanket
+ * tolerance that hides the difference.
+ *
+ * Relative error of the approximation itself is about 1.15e-9.
+ */
+export function inverseNormalCdf(p) {
+    if (!(p > 0 && p < 1)) {
+        throw new RangeError(`inverseNormalCdf expects p in (0, 1), got ${p}`);
+    }
+    const a1 = -3.969683028665376e1;
+    const a2 = 2.209460984245205e2;
+    const a3 = -2.759285104469687e2;
+    const a4 = 1.38357751867269e2;
+    const a5 = -3.066479806614716e1;
+    const a6 = 2.506628277459239;
+    const b1 = -5.447609879822406e1;
+    const b2 = 1.615858368580409e2;
+    const b3 = -1.556989798598866e2;
+    const b4 = 6.680131188771972e1;
+    const b5 = -1.328068155288572e1;
+    const c1 = -7.784894002430293e-3;
+    const c2 = -3.223964580411365e-1;
+    const c3 = -2.400758277161838;
+    const c4 = -2.549732539343734;
+    const c5 = 4.374664141464968;
+    const c6 = 2.938163982698783;
+    const d1 = 7.784695709041462e-3;
+    const d2 = 3.224671290700398e-1;
+    const d3 = 2.445134137142996;
+    const d4 = 3.754408661907416;
+    const P_LOW = 0.02425;
+    const P_HIGH = 1 - P_LOW;
+    if (p < P_LOW) {
+        const q = Math.sqrt(-2 * Math.log(p));
+        return ((((((c1 * q + c2) * q + c3) * q + c4) * q + c5) * q + c6) /
+            ((((d1 * q + d2) * q + d3) * q + d4) * q + 1));
+    }
+    if (p > P_HIGH) {
+        const q = Math.sqrt(-2 * Math.log(1 - p));
+        return -((((((c1 * q + c2) * q + c3) * q + c4) * q + c5) * q + c6) /
+            ((((d1 * q + d2) * q + d3) * q + d4) * q + 1));
+    }
+    const q = p - 0.5;
+    const r = q * q;
+    return (((((((a1 * r + a2) * r + a3) * r + a4) * r + a5) * r + a6) * q) /
+        (((((b1 * r + b2) * r + b3) * r + b4) * r + b5) * r + 1));
+}
+/** A normal draw, via {@link inverseNormalCdf}. */
+export function sampleNormal(u, mean, stddev) {
+    return mean + stddev * inverseNormalCdf(u);
+}
+//# sourceMappingURL=prng.js.map

package/dist/calc/prng.js.map

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

package/dist/calc/sensitivity.d.ts

@@ -0,0 +1,76 @@
+import type { CalcEvaluationContext, ProtocolError } from '../protocol.js';
+/** Hard ceiling on grid cells. RFC 0007's suggested bound. */
+export declare const MAX_SENSITIVITY_CELLS = 256;
+/** Hard ceiling per axis, so a 1x256 strip is refused as readily as 16x16. */
+export declare const MAX_SENSITIVITY_AXIS = 64;
+export interface SensitivityAxis {
+    /**
+     * The dotted path this axis varies, written exactly as an expression writes
+     * it: `dcf.exit_cap_rate`, not `exit_cap_rate`.
+     */
+    variable: string;
+    /** The values to sweep. At least two — a one-value axis is not an axis. */
+    values: number[];
+    /** Optional display label; defaults to `variable`. */
+    label?: string;
+}
+export interface SensitivityDecl {
+    id: string;
+    label: string;
+    /** An ordinary §VIII.1 safe expression. */
+    base_formula: string;
+    row_axis: SensitivityAxis;
+    col_axis: SensitivityAxis;
+    unit?: string;
+    /** Decimal places each cell is quantized to (§VIII.5). */
+    round_to?: number;
+}
+/** One cell: a value, or the error that stopped it. Never both. */
+export type SensitivityCell = {
+    ok: true;
+    value: number | string | boolean | null;
+} | {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+    };
+};
+export interface SensitivityResult {
+    calc_id: string;
+    ok: boolean;
+    /** Present only when the declaration itself was unusable. */
+    error?: ProtocolError;
+    row_axis?: SensitivityAxis;
+    col_axis?: SensitivityAxis;
+    /** `grid[rowIndex][colIndex]`, matching the axes' declared order. */
+    grid?: SensitivityCell[][];
+    unit?: string;
+    round_to?: number;
+    /**
+     * How many cells failed. A grid is `ok: true` with failed cells in it — a
+     * table where one combination divides by zero is still a useful table, and
+     * failing the whole thing would hide the 35 cells that worked.
+     */
+    failed_cells?: number;
+}
+/**
+ * Evaluate a sensitivity declaration into a grid.
+ *
+ * Total: a malformed declaration returns `ok: false` with a typed error rather
+ * than throwing, matching `evaluateCalc`. A cell that fails is recorded in
+ * place and does not stop the sweep.
+ */
+export declare function evaluateSensitivity(decl: SensitivityDecl, ctx: CalcEvaluationContext): SensitivityResult;
+/**
+ * Narrow an unknown declaration, for hosts reading `custom_calculations`.
+ *
+ * A block that carries `row_axis` and `col_axis` is a sensitivity declaration;
+ * one that carries `formula` is a scalar calc. The discriminator is structural
+ * rather than a `type` field, because every existing calc block would have to
+ * grow one otherwise.
+ */
+export declare function isSensitivityDecl(value: unknown): value is SensitivityDecl;
+/** Rethrown as a typed error by callers that prefer exceptions. */
+export declare function assertSensitivityOk(result: SensitivityResult): void;
+//# sourceMappingURL=sensitivity.d.ts.map

package/dist/calc/sensitivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensitivity.d.ts","sourceRoot":"","sources":["../../src/calc/sensitivity.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,qBAAqB,EAAc,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEvF,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,mEAAmE;AACnE,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;CAAE,GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,OAAO,CAAC;IACZ,6DAA6D;IAC7D,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,qEAAqE;IACrE,IAAI,CAAC,EAAE,eAAe,EAAE,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAUD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,qBAAqB,GACzB,iBAAiB,CA+FnB;AAiCD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAQ1E;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAOnE"}

package/dist/calc/sensitivity.js

@@ -0,0 +1,160 @@
+// Sensitivity tables (protocol §VIII.7, RFC 0007).
+//
+// A two-axis grid: one base formula, evaluated once per (row, column) pair
+// with the two axis variables overridden. The thing every underwriter builds
+// by hand in Excel, and the single most-requested calc capability after the
+// basic ratios.
+//
+// **Declared, not a builtin.** RFC 0007 proposed
+// `sensitivity_table(base_expr, {variable, values}, {variable, values})` as a
+// function inside the §VIII.1 grammar. That grammar has no object literals and
+// no array literals, and its `string` production is a value, not a program — so
+// the proposal needs three grammar extensions, one of which makes a string
+// argument executable. Widening a deliberately tiny sandbox that far, to reach
+// data that is already sitting in JSON one level up, is the wrong trade.
+//
+// So the axes are a JSON *declaration* — which is where every other calc
+// declaration already lives — and `base_formula` is an ordinary safe
+// expression. The sandbox does not change at all. The grid is computed by
+// `evaluateSensitivity`, which the Excel emitter and a calc-aware editor can
+// both consume without re-deriving structure from calc-id naming conventions.
+//
+// **The result is its own type.** It never travels through `CalcResult.value`,
+// which stays `number | string | boolean | null`. Receipts pin that union, the
+// CLI renders it, and Excel emits from it; smuggling a grid through it would
+// break all three for a feature none of them asked to carry.
+import { evaluateCalc } from './index.js';
+import { CalcError } from './errors.js';
+import { MAX_ROUND_TO, resolveRoundTo } from './quantize.js';
+/** Hard ceiling on grid cells. RFC 0007's suggested bound. */
+export const MAX_SENSITIVITY_CELLS = 256;
+/** Hard ceiling per axis, so a 1x256 strip is refused as readily as 16x16. */
+export const MAX_SENSITIVITY_AXIS = 64;
+function declError(id, code, message, pointer) {
+    return {
+        calc_id: id,
+        ok: false,
+        error: { category: 'calc', code, message, pointer },
+    };
+}
+/**
+ * Evaluate a sensitivity declaration into a grid.
+ *
+ * Total: a malformed declaration returns `ok: false` with a typed error rather
+ * than throwing, matching `evaluateCalc`. A cell that fails is recorded in
+ * place and does not stop the sweep.
+ */
+export function evaluateSensitivity(decl, ctx) {
+    const axisProblem = checkAxis(decl.id, decl.row_axis, 'row_axis') ?? checkAxis(decl.id, decl.col_axis, 'col_axis');
+    if (axisProblem)
+        return axisProblem;
+    if (decl.row_axis.variable === decl.col_axis.variable) {
+        // Both axes overriding one path means the second silently wins for every
+        // cell, producing a grid whose rows are identical and whose reader has no
+        // way to see why.
+        return declError(decl.id, 'CALC-SENS-004', `Both axes vary '${decl.row_axis.variable}'; a grid needs two different variables.`, 'col_axis.variable');
+    }
+    const cells = decl.row_axis.values.length * decl.col_axis.values.length;
+    if (cells > MAX_SENSITIVITY_CELLS) {
+        return declError(decl.id, 'CALC-SENS-003', `Grid is ${decl.row_axis.values.length}x${decl.col_axis.values.length} = ${cells} cells; the limit is ${MAX_SENSITIVITY_CELLS}.`, 'row_axis.values');
+    }
+    if (decl.round_to !== undefined && (!Number.isInteger(decl.round_to) || decl.round_to < 0 || decl.round_to > MAX_ROUND_TO)) {
+        return declError(decl.id, 'CALC-SENS-005', `round_to must be an integer in [0, ${MAX_ROUND_TO}].`, 'round_to');
+    }
+    const roundTo = resolveRoundTo({
+        ...(decl.unit !== undefined ? { unit: decl.unit } : {}),
+        ...(decl.round_to !== undefined ? { round_to: decl.round_to } : {}),
+    });
+    const grid = [];
+    let failed = 0;
+    for (const rowValue of decl.row_axis.values) {
+        const row = [];
+        for (const colValue of decl.col_axis.values) {
+            // Each cell is an independent `evaluateCalc` with two overrides layered
+            // on the same context. Nothing is mutated: the document the caller passed
+            // in is the document every cell reads, minus exactly two paths.
+            const result = evaluateCalc({
+                id: decl.id,
+                label: decl.label,
+                formula: decl.base_formula,
+                deterministic: true,
+                ...(decl.unit !== undefined ? { unit: decl.unit } : {}),
+                round_to: roundTo,
+            }, {
+                ...ctx,
+                overrides: {
+                    ...ctx.overrides,
+                    [decl.row_axis.variable]: rowValue,
+                    [decl.col_axis.variable]: colValue,
+                },
+            });
+            if (result.ok) {
+                row.push({ ok: true, value: result.value });
+            }
+            else {
+                failed++;
+                row.push({
+                    ok: false,
+                    error: {
+                        code: result.error?.code ?? 'CALC-UNKNOWN',
+                        message: result.error?.message ?? 'Cell evaluation failed.',
+                    },
+                });
+            }
+        }
+        grid.push(row);
+    }
+    return {
+        calc_id: decl.id,
+        ok: true,
+        row_axis: decl.row_axis,
+        col_axis: decl.col_axis,
+        grid,
+        ...(decl.unit !== undefined ? { unit: decl.unit } : {}),
+        round_to: roundTo,
+        failed_cells: failed,
+    };
+}
+function checkAxis(id, axis, pointer) {
+    if (!axis || typeof axis !== 'object') {
+        return declError(id, 'CALC-SENS-001', `${pointer} is missing.`, pointer);
+    }
+    if (typeof axis.variable !== 'string' || axis.variable.length === 0) {
+        return declError(id, 'CALC-SENS-001', `${pointer}.variable must be a non-empty path.`, `${pointer}.variable`);
+    }
+    if (!Array.isArray(axis.values) || axis.values.length < 2) {
+        // One value is not a sweep, and zero is not a table. Refusing here beats
+        // returning a degenerate 1xN grid that every consumer then has to
+        // special-case.
+        return declError(id, 'CALC-SENS-002', `${pointer}.values must list at least two numbers.`, `${pointer}.values`);
+    }
+    if (axis.values.length > MAX_SENSITIVITY_AXIS) {
+        return declError(id, 'CALC-SENS-003', `${pointer}.values has ${axis.values.length} entries; the per-axis limit is ${MAX_SENSITIVITY_AXIS}.`, `${pointer}.values`);
+    }
+    if (!axis.values.every((v) => typeof v === 'number' && Number.isFinite(v))) {
+        return declError(id, 'CALC-SENS-002', `${pointer}.values must be finite numbers.`, `${pointer}.values`);
+    }
+    return null;
+}
+/**
+ * Narrow an unknown declaration, for hosts reading `custom_calculations`.
+ *
+ * A block that carries `row_axis` and `col_axis` is a sensitivity declaration;
+ * one that carries `formula` is a scalar calc. The discriminator is structural
+ * rather than a `type` field, because every existing calc block would have to
+ * grow one otherwise.
+ */
+export function isSensitivityDecl(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'base_formula' in value &&
+        'row_axis' in value &&
+        'col_axis' in value);
+}
+/** Rethrown as a typed error by callers that prefer exceptions. */
+export function assertSensitivityOk(result) {
+    if (!result.ok) {
+        throw new CalcError((result.error?.code ?? 'CALC-SENS-001'), result.error?.message ?? 'Sensitivity declaration is unusable.');
+    }
+}
+//# sourceMappingURL=sensitivity.js.map

package/dist/calc/sensitivity.js.map

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