@insiderfinance/totalfinance 0.1.0

package/modules/core/dist/validation.js

@@ -0,0 +1,415 @@
+/**
+ * The reusable closed-request validator (spec 3B.1b, first checkbox): ONE contract for required
+ * object, exact closed keys, primitive/container type, finite numeric input, nested consumed
+ * fields, and discriminated-union branch validation.
+ *
+ * The SPEC DATA is generated from the checker-derived contract inventory
+ * (`pnpm validation:update` → `packages/<pkg>/src/generated/validation-specs.ts`), never
+ * hand-authored: a hand-written key list and the declaration it mirrors are two artifacts that
+ * drift, and the drift is exactly a silently-accepted field or a rejected valid call. What stays
+ * hand-authored is the TEACHING — the worked example call and per-field unit hints — because a
+ * generator may not invent financial semantics (C03).
+ *
+ * Codes are the library's standing taxonomy (C11), one per distinct mistake:
+ *
+ *     unknown key            input.unknown_field   did-you-mean + the allowed list
+ *     missing required       input.missing_field   the worked example call
+ *     null (non-nullable)    input.invalid_enum    on an enum field (null is not a member)
+ *                            input.wrong_type      everywhere else (null is not omission)
+ *     wrong primitive        input.wrong_type
+ *     outside enum domain    input.invalid_enum
+ *     NaN                    input.nan
+ *     ±Infinity              input.not_finite
+ *     no union branch fits   input.wrong_shape     every declared alternative, rendered
+ *
+ * Union resolution is DISCRIMINANT-FIRST (the `phi: {}` lesson: a missing discriminant must never
+ * fall through to whichever branch a key-set match happens to pick): when a discriminant key is
+ * present its value is checked against the union of every branch's literals before any branch is
+ * entered. Branches without a literal discriminant — `Amortization`'s `{ principalByPeriod }` arm —
+ * are selected structurally by their required keys.
+ *
+ * HOT PATHS: validate ONCE at the public boundary, then call unchecked internals. The walk is
+ * O(declared fields) over static generated data; per-spec derived lookups (allowed-key arrays)
+ * are cached in a module WeakMap so repeated calls allocate nothing.
+ */
+import { ErrorCode, InputError, missingFieldError } from './errors.js';
+import { requireArgumentArray, requireArgumentObject } from './invariants.js';
+const FIELDS_INDEX = new WeakMap();
+function indexOf(fields) {
+    let index = FIELDS_INDEX.get(fields);
+    if (index === undefined) {
+        index = {
+            allowed: fields.map((field) => field.name),
+            byName: new Map(fields.map((field) => [field.name, field])),
+        };
+        FIELDS_INDEX.set(fields, index);
+    }
+    return index;
+}
+function describeValue(value) {
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'undefined';
+    if (typeof value === 'string')
+        return `"${value}" (string)`;
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
+        return String(value);
+    }
+    // This is an ERROR path over untrusted JavaScript input. Inspecting an object for a prettier
+    // rendering can execute its `toJSON`, `toString`, or `Symbol.toPrimitive` hook and replace the
+    // intended typed InputError with arbitrary user code. The type is the honest, side-effect-free
+    // description available at this boundary; callers can inspect their own value separately.
+    return typeof value;
+}
+/** Keep error context JSON-safe without retaining a caller-controlled object or function. */
+function contextValue(value) {
+    if (value === null)
+        return null;
+    if (typeof value === 'string' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : describeValue(value);
+    if (typeof value === 'bigint')
+        return `${value}n`;
+    return typeof value;
+}
+/** Damerau–Levenshtein ≤ 2 nearest match — the same did-you-mean `ensureKnownKeys` uses. */
+function nearestName(key, allowed) {
+    const dist = (a, b) => {
+        if (Math.abs(a.length - b.length) > 2)
+            return 3;
+        const d = Array.from({ length: a.length + 1 }, (_, i) => [i]);
+        for (let j = 1; j <= b.length; j++)
+            d[0][j] = j;
+        for (let i = 1; i <= a.length; i++) {
+            for (let j = 1; j <= b.length; j++) {
+                const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+                d[i][j] = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + cost);
+                if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
+                    d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + cost);
+                }
+            }
+        }
+        return d[a.length][b.length];
+    };
+    let best;
+    let bestD = 3;
+    const lower = key.toLowerCase();
+    for (const candidate of allowed) {
+        const d = dist(lower, candidate.toLowerCase());
+        if (d < bestD) {
+            bestD = d;
+            best = candidate;
+        }
+    }
+    return best;
+}
+function rejectUnknownKeys(functionName, containerPath, value, allowed) {
+    for (const key of Object.keys(value)) {
+        if (allowed.includes(key))
+            continue;
+        const suggestion = nearestName(key, allowed);
+        throw new InputError(`${functionName}: unknown field "${key}" in ${containerPath}${suggestion !== undefined ? ` — did you mean "${suggestion}"?` : ''} Allowed fields: ${allowed.join(', ')}.`, {
+            code: ErrorCode.InputUnknownField,
+            context: {
+                function: functionName,
+                field: containerPath,
+                key,
+                ...(suggestion !== undefined ? { suggestion } : {}),
+            },
+        });
+    }
+}
+function wrongType(functionName, path, expected, value) {
+    return new InputError(`${functionName}: ${path} must be ${expected}. Received ${describeValue(value)}.`, {
+        code: ErrorCode.InputWrongType,
+        context: {
+            function: functionName,
+            field: path,
+            received: value === null ? 'null' : typeof value,
+        },
+    });
+}
+function rejectOutsideDomain(functionName, path, value, literals) {
+    if (literals.includes(value))
+        return;
+    const rendered = literals.map((literal) => typeof literal === 'string' ? literal : String(literal));
+    throw new InputError(`${functionName}: ${path} must be one of ${rendered.join(', ')}; got ${describeValue(value)}.`, {
+        code: ErrorCode.InputInvalidEnum,
+        context: { function: functionName, field: path, value: contextValue(value) },
+    });
+}
+/** A compact rendering of one union alternative, for the no-branch-matched teaching error. */
+function renderBranch(branch) {
+    const parts = branch.fields
+        .filter((field) => field.optional !== true)
+        .map((field) => field.literals?.length === 1 ? `${field.name}: '${String(field.literals[0])}'` : field.name);
+    return `{ ${parts.join(', ')} }`;
+}
+/**
+ * Discriminant-first branch selection. Returns the branch to validate against, or throws the
+ * teaching error that names every declared alternative.
+ */
+function selectBranch(functionName, path, value, branches) {
+    // Discriminant candidates: names carrying a literal domain in at least one branch.
+    const discriminants = new Map();
+    for (const branch of branches) {
+        for (const field of branch.fields) {
+            // An OPTIONAL literal field is never a discriminant: a discriminant DECIDES the arm, and a
+            // field the caller may omit decides nothing. EntryRule made this concrete — every arm
+            // carries `price?: 'ask' | 'bid' | …`, and treating it as a discriminant refused every
+            // legal call that omitted it.
+            if (field.optional === true)
+                continue;
+            if (field.literals !== undefined && field.literals.length > 0) {
+                const pool = discriminants.get(field.name) ?? [];
+                for (const literal of field.literals)
+                    if (!pool.includes(literal))
+                        pool.push(literal);
+                discriminants.set(field.name, pool);
+            }
+        }
+    }
+    /**
+     * A PURE discriminated union (every arm carries the same literal discriminant — `SSVIPhi`)
+     * refuses a MISSING discriminant on the discriminant itself, with the whole domain: that is the
+     * library's standing `ensureEnum` convention for meaning-changing fields, and the curated
+     * `requirePhi` behavior this generalizes. A union with structural arms (`Amortization`) falls
+     * through to structural selection and the every-alternative teaching instead — `{}` there could
+     * be a malformed structural arm, not a forgotten discriminant.
+     */
+    for (const [name, pool] of discriminants) {
+        const inEveryArm = branches.every((branch) => branch.fields.some((field) => field.name === name && field.literals !== undefined && field.optional !== true));
+        if (inEveryArm && !Object.prototype.hasOwnProperty.call(value, name)) {
+            rejectOutsideDomain(functionName, path === 'input' ? name : `${path}.${name}`, undefined, pool);
+        }
+    }
+    for (const [name, pool] of discriminants) {
+        if (!Object.prototype.hasOwnProperty.call(value, name))
+            continue;
+        const provided = value[name];
+        // Validate the discriminant against the WHOLE declared domain first — a wrong or missing
+        // discriminant must teach, never fall through to an arbitrary branch (the `phi: {}` class).
+        rejectOutsideDomain(functionName, `${path}.${name}`, provided, pool);
+        const matches = branches.filter((branch) => branch.fields.some((field) => field.name === name && field.literals?.includes(provided)));
+        if (matches.length === 1)
+            return matches[0];
+    }
+    // Structural selection: branches whose required fields are all present. On a tie, prefer the
+    // branch whose allowed keys COVER the most of the value's keys — validating an ambiguous value
+    // against an arbitrary arm would reject keys that belong to the other one, and over-closure is
+    // the worse defect (it refuses valid calls in the name of strictness).
+    const structural = branches.filter((branch) => branch.fields.every((field) => field.optional === true || Object.prototype.hasOwnProperty.call(value, field.name)));
+    if (structural.length === 1)
+        return structural[0];
+    if (structural.length > 1) {
+        const keys = Object.keys(value);
+        let best = structural[0];
+        let bestCovered = -1;
+        for (const branch of structural) {
+            const allowed = indexOf(branch.fields).allowed;
+            const covered = keys.filter((key) => allowed.includes(key)).length;
+            if (covered > bestCovered) {
+                bestCovered = covered;
+                best = branch;
+            }
+        }
+        return best;
+    }
+    throw new InputError(`${functionName}: ${path} does not match any declared alternative. Expected one of: ${branches
+        .map(renderBranch)
+        .join(' | ')}.`, {
+        code: ErrorCode.InputWrongShape,
+        context: { function: functionName, field: path, received: Object.keys(value) },
+    });
+}
+function validateFields(functionName, containerPath, value, fields, teaching, fieldPrefix, openArtifact = false) {
+    const index = indexOf(fields);
+    if (!openArtifact)
+        rejectUnknownKeys(functionName, containerPath, value, index.allowed);
+    for (const field of fields) {
+        const path = fieldPrefix === '' ? field.name : `${fieldPrefix}.${field.name}`;
+        const provided = value[field.name];
+        if (provided === undefined) {
+            if (field.optional === true)
+                continue;
+            const example = teaching.exampleCall;
+            throw missingFieldError(functionName, path, typeof example === 'function' ? example() : example, teaching.hints?.[field.name]);
+        }
+        if (provided === null) {
+            if (field.nullable === true)
+                continue;
+            // Null is not omission. An enum field teaches invalid_enum (null is not a member); every
+            // other kind teaches wrong_type — the ruling the whole ladder now shares.
+            if (field.kind === 'enum' && field.literals !== undefined) {
+                rejectOutsideDomain(functionName, path, provided, field.literals);
+            }
+            throw wrongType(functionName, path, expectedOf(field), provided);
+        }
+        switch (field.kind) {
+            case 'numeric': {
+                if (typeof provided !== 'number')
+                    throw wrongType(functionName, path, 'a number', provided);
+                if (!Number.isFinite(provided)) {
+                    // A curated bound field accepts ±Infinity as its documented "unbounded"; NaN never means
+                    // anything and is rejected even there.
+                    if (field.allowsInfinity === true && !Number.isNaN(provided))
+                        break;
+                    throw new InputError(`${functionName}: ${path} must be a finite number. Received ${describeValue(provided)}.`, {
+                        code: Number.isNaN(provided) ? ErrorCode.InputNaN : ErrorCode.InputNotFinite,
+                        context: { function: functionName, field: path, value: provided },
+                    });
+                }
+                if (field.safeIntegerMaximum !== undefined &&
+                    (!Number.isSafeInteger(provided) || provided < 1 || provided > field.safeIntegerMaximum)) {
+                    throw new InputError(`${functionName}: ${path} must be a positive safe integer ≤ ${field.safeIntegerMaximum.toLocaleString('en-US')} (it controls synchronous work or allocation). Received ${String(provided)}.`, {
+                        code: ErrorCode.InputOutOfRange,
+                        context: {
+                            function: functionName,
+                            field: path,
+                            received: provided,
+                            max: field.safeIntegerMaximum,
+                        },
+                    });
+                }
+                break;
+            }
+            case 'enum': {
+                if (field.literals !== undefined) {
+                    if (field.literals.includes(provided))
+                        break;
+                    // A mixed union admits an open primitive beside the named members: `frequency: 4` is as
+                    // legal as `'quarterly'`. A number still runs the finite ladder — `frequency: NaN` is
+                    // not a frequency under any spelling.
+                    if (field.openKinds?.includes('numeric') === true && typeof provided === 'number') {
+                        if (!Number.isFinite(provided)) {
+                            throw new InputError(`${functionName}: ${path} must be a finite number or one of ${field.literals.join(', ')}. Received ${describeValue(provided)}.`, {
+                                code: Number.isNaN(provided) ? ErrorCode.InputNaN : ErrorCode.InputNotFinite,
+                                context: { function: functionName, field: path, value: provided },
+                            });
+                        }
+                        break;
+                    }
+                    if (field.openKinds?.includes('string') === true && typeof provided === 'string')
+                        break;
+                    if (field.openKinds?.includes('boolean') === true && typeof provided === 'boolean')
+                        break;
+                    const rendered = field.literals.map((literal) => String(literal));
+                    const open = field.openKinds?.length ? `, or any ${field.openKinds.join('/')} value` : '';
+                    throw new InputError(`${functionName}: ${path} must be one of ${rendered.join(', ')}${open}; got ${describeValue(provided)}.`, {
+                        code: ErrorCode.InputInvalidEnum,
+                        context: {
+                            function: functionName,
+                            field: path,
+                            value: contextValue(provided),
+                        },
+                    });
+                }
+                break;
+            }
+            case 'boolean': {
+                if (typeof provided !== 'boolean')
+                    throw wrongType(functionName, path, 'a boolean', provided);
+                break;
+            }
+            case 'string': {
+                if (typeof provided !== 'string')
+                    throw wrongType(functionName, path, 'a string', provided);
+                break;
+            }
+            case 'array': {
+                requireArgumentArray(functionName, path, provided);
+                if (field.safeIntegerElementsMaximum !== undefined) {
+                    const elements = provided;
+                    for (let index = 0; index < elements.length; index++) {
+                        const element = elements[index];
+                        const elementPath = `${path}[${index}]`;
+                        if (typeof element !== 'number') {
+                            throw wrongType(functionName, elementPath, 'a number', element);
+                        }
+                        if (!Number.isFinite(element)) {
+                            throw new InputError(`${functionName}: ${elementPath} must be a finite number. Received ${describeValue(element)}.`, {
+                                code: Number.isNaN(element) ? ErrorCode.InputNaN : ErrorCode.InputNotFinite,
+                                context: { function: functionName, field: elementPath, value: element },
+                            });
+                        }
+                        if (!Number.isSafeInteger(element) ||
+                            element < 1 ||
+                            element > field.safeIntegerElementsMaximum) {
+                            throw new InputError(`${functionName}: ${elementPath} must be a positive safe integer ≤ ${field.safeIntegerElementsMaximum.toLocaleString('en-US')} (it controls synchronous work or allocation). Received ${String(element)}.`, {
+                                code: ErrorCode.InputOutOfRange,
+                                context: {
+                                    function: functionName,
+                                    field: elementPath,
+                                    received: element,
+                                    max: field.safeIntegerElementsMaximum,
+                                },
+                            });
+                        }
+                    }
+                }
+                break;
+            }
+            case 'callback': {
+                if (typeof provided !== 'function')
+                    throw wrongType(functionName, path, 'a function', provided);
+                break;
+            }
+            case 'object': {
+                requireArgumentObject(functionName, path, provided);
+                const record = provided;
+                if (field.branches !== undefined) {
+                    const branch = selectBranch(functionName, path, record, field.branches);
+                    validateFields(functionName, path, record, branch.fields, teaching, path);
+                }
+                else if (field.fields !== undefined) {
+                    validateFields(functionName, path, record, field.fields, teaching, path);
+                }
+                break;
+            }
+            case 'unchecked':
+                break;
+        }
+    }
+}
+function expectedOf(field) {
+    switch (field.kind) {
+        case 'numeric':
+            return 'a number';
+        case 'boolean':
+            return 'a boolean';
+        case 'string':
+            return 'a string';
+        case 'array':
+            return 'an array';
+        case 'callback':
+            return 'a function';
+        case 'object':
+            return 'an object';
+        default:
+            return 'a value of its declared type';
+    }
+}
+/**
+ * Validate one public closed request against its GENERATED contract spec. Call ONCE at the public
+ * boundary; internals stay unchecked. Domain semantics (positivity, coordinate relationships,
+ * plausibility) remain the boundary's own code — this enforces shape, presence, type, finiteness,
+ * domain literals, and closedness, with the exact code each mistake owns.
+ */
+export function validateClosedRequest(functionName, value, specification, teaching) {
+    const argumentName = teaching.argumentName ?? 'input';
+    requireArgumentObject(functionName, argumentName, value);
+    // Top-level fields of the SUBJECT request keep their bare names (`volatility`, the seed-fixture
+    // convention); fields of a secondary argument are prefixed (`options.steps`) so a two-object
+    // call says which object to fix. Nested fields are always dotted from wherever they hang.
+    const fieldPrefix = teaching.subject === true || argumentName === 'input' ? '' : argumentName;
+    if (specification.branches !== undefined) {
+        const record = value;
+        const branch = selectBranch(functionName, argumentName, record, specification.branches);
+        validateFields(functionName, argumentName, record, branch.fields, teaching, fieldPrefix, teaching.open === true);
+        return;
+    }
+    validateFields(functionName, argumentName, value, specification.fields, teaching, fieldPrefix, teaching.open === true);
+}
+//# sourceMappingURL=validation.js.map

package/modules/core/dist/validation.js.map

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

package/modules/core/etc/core.api.md

@@ -0,0 +1,157 @@
+# @insiderfinance/totalfinance/core — public API
+
+> Generated by `tools/api-report`. Do not edit by hand. Run `pnpm api:update` after intentional
+> public API changes; `pnpm api:check` fails on undocumented drift.
+
+## Exports (150)
+
+- `class ArbitrageError`: typeof ArbitrageError
+- `class ConfigurationError`: typeof ConfigurationError
+- `class ConvergenceError`: typeof ConvergenceError
+- `class DataError`: typeof DataError
+- `class InputError`: typeof InputError
+- `class PostconditionError`: typeof PostconditionError
+- `class QuantError`: typeof QuantError
+- `class UnsupportedError`: typeof UnsupportedError
+- `const alwaysOpen`: Calendar
+- `const CONVENTIONS_VERSION`: '0.0.1'
+- `const DEFAULT_COMPOUNDING`: InterestCompounding
+- `const DEFAULT_DAY_COUNT`: DayCount
+- `const DEFAULT_DIVIDEND_YIELD`: 0
+- `const DEFAULT_GREEK_UNITS`: GreekUnits
+- `const ORDER_SIDES`: ReadonlyArray<OrderSide>
+- `const ORDER_TYPES`: ReadonlyArray<OrderType>
+- `const TIME_IN_FORCE_VALUES`: ReadonlyArray<TimeInForce>
+- `const US_EQUITY_HALF_DAY_RULES`: ReadonlyArray<HolidayRule>
+- `const weekendsOnly`: Calendar
+- `function addDays`: (date: string, days: number) => string
+- `function assertFiniteResult`: (label: string, result: Computed<unknown>) => void
+- `function assertFiniteValue`: (label: string, value: unknown) => void
+- `function between`: (value: number, min: number, max: number, options?: BetweenOptions) => boolean
+- `function clamp`: (value: number, min: number, max: number) => number
+- `function compoundFactor`: (annualRate: number, years: number, compounding?: InterestCompounding) => number
+- `function compoundingPeriodsPerYear`: (compounding: InterestCompounding) => number | null
+- `function createRuleCalendar`: (config: CalendarConfig) => Calendar
+- `function dayOfWeek`: (date: string) => Weekday
+- `function defineCalendar`: (config: CalendarConfig) => Calendar
+- `function discountFactor`: (annualRate: number, years: number, compounding?: InterestCompounding) => number
+- `function easterSunday`: (year: number) => { month: number; day: number; }
+- `function emptyDiagnostics`: () => Diagnostics
+- `function ensureEnum`: <T extends string>(value: unknown, allowed: readonly T[], field: string, functionName: string) => asserts value is T
+- `function ensureFinite`: (value: number, field: string, functionName: string) => void
+- `function ensureFiniteWhenPresent`: (value: unknown, field: string, functionName: string) => void
+- `function ensureKnownKeys`: (functionName: string, field: string, value: object, allowed: readonly string[]) => void
+- `function ensureNonNegative`: (value: number, field: string, functionName: string, code?: string) => void
+- `function ensurePositive`: (value: number, field: string, functionName: string, code?: string) => void
+- `function facade`: <Input, Output, Extra extends Record<string, unknown> = Record<never, never>, ExplainValue = Output>(label: string, call: (input: Input) => Output, explain: (input: Input) => Computed<ExplainValue, Extra>) => Facade<Input, Output, Extra, ExplainValue>
+- `function finalizeResult`: <Result extends Computed<unknown>>(label: string, result: Result) => Result
+- `function finiteOrNull`: (value: number) => number | null
+- `function formatMoney`: (value: number, options?: FormatMoneyOptions) => string
+- `function formatOccSymbol`: (option: Pick<OccOptionSymbol, 'root' | 'expiry' | 'type' | 'strike'>) => string
+- `function formatPercent`: (value: number, options?: FormatPercentOptions) => string
+- `function goodFriday`: (year: number) => string
+- `function isComputed`: (value: unknown) => value is Computed<unknown>
+- `function isFiniteNumber`: (value: unknown) => value is number
+- `function isNonNegative`: (value: unknown) => value is number
+- `function isOccOptionSymbol`: (symbol: string) => boolean
+- `function isoDateToEpochMs`: (value: string) => EpochMs
+- `function isPositive`: (value: unknown) => value is number
+- `function isQuantError`: (value: unknown, code?: string) => value is QuantError
+- `function isTrustworthy`: (result: unknown) => boolean
+- `function isUsEquityHalfDay`: (date: string) => boolean
+- `function lastWeekdayOfMonth`: (year: number, month: number, weekday: Weekday) => string
+- `function missingFieldError`: (functionName: string, field: string, example: string, hint?: string) => InputError
+- `function nthWeekdayOfMonth`: (year: number, month: number, weekday: Weekday, occurrence: number) => string | null
+- `function observedHoliday`: (year: number, month: number, day: number) => string
+- `function optionExpiryToMs`: (expiry: string) => EpochMs
+- `function parseIsoDate`: (value: string) => CalendarDate
+- `function parseOccSymbol`: (symbol: string) => OccOptionSymbol
+- `function plausibilityWarnings`: (inputs: { volatility?: number; timeToExpiryYears?: number; riskFreeRate?: number; }) => QuantWarning[]
+- `function requireArgumentArray`: (functionName: string, field: string, value: unknown) => void
+- `function requireArgumentObject`: (functionName: string, field: string, value: unknown) => void
+- `function requireFiniteFields`: (functionName: string, input: unknown, fields: readonly string[], options: RequireFiniteFieldsOptions) => void
+- `function requireRateCurveData`: (functionName: string, path: string, value: unknown) => RateCurve
+- `function requireRepresentableResult`: <T>(functionName: string, result: T) => T
+- `function resolveAsOf`: (asOf: EpochMs | string, functionName?: string) => EpochMs
+- `function resolvedExpiry`: (expiry: string) => { expiresAt: EpochMs; expiryConvention: 'us-equity-close' | 'explicit-instant'; }
+- `function resolveValuationAsOf`: (asOf: EpochMs | string, functionName?: string) => EpochMs
+- `function round`: (value: number, decimals?: number) => number
+- `function selectQuotePrice`: (quote: OptionQuote, source: PriceSource) => number | undefined
+- `function seriesFacade`: <Args extends unknown[], Output, Extra extends Record<string, unknown> = Record<never, never>>(label: string, call: (...callArguments: Args) => Output, explain: (...callArguments: Args) => Computed<Output, Extra>) => SeriesFacade<Args, Output, Extra>
+- `function sideOf`: (signed: number, functionName?: string) => OrderSide
+- `function signOf`: (side: OrderSide, functionName?: string) => 1 | -1
+- `function stableSum`: (addends: readonly number[]) => number
+- `function suspiciousReturnsWarning`: (returns: ArrayLike<number>) => QuantWarning | undefined
+- `function toFixedSafe`: (value: number, decimals?: number) => string
+- `function usEquityCloseUtcMs`: (year: number, month: number, day: number) => EpochMs
+- `function usEquityMarketDateUtcMs`: (epochMs: EpochMs) => EpochMs
+- `function usEquityMarketDayIndex`: (epochMs: EpochMs) => number
+- `function usEquitySessionInstant`: (date: string, session: 'open' | 'close') => EpochMs
+- `function validateClosedRequest`: (functionName: string, value: unknown, specification: ClosedRequestSpecification, teaching: ClosedRequestTeaching) => void
+- `function validateResolvedExpiry`: (functionName: string, expiry: string, expiresAt: unknown, expiryConvention: unknown) => void
+- `function warning`: (code: string, message: string, severity?: WarningSeverity, context?: Record<string, unknown>) => QuantWarning
+- `function wrongShapeError`: (functionName: string, expected: string, received: unknown) => InputError
+- `function yearFraction`: (from: string | EpochMs, to: string | EpochMs, dayCount?: DayCount) => number
+- `function ymd`: (year: number, month: number, day: number) => string
+- `interface Bar`: Bar
+- `interface BetweenOptions`: BetweenOptions
+- `interface Calendar`: Calendar
+- `interface CalendarConfig`: CalendarConfig
+- `interface CalendarDate`: CalendarDate
+- `interface ClosedRequestSpecification`: ClosedRequestSpecification
+- `interface ClosedRequestTeaching`: ClosedRequestTeaching
+- `interface Computed`: Computed<T, Extra>
+- `interface CorporateAction`: CorporateAction
+- `interface DaySession`: DaySession
+- `interface Deliverable`: Deliverable
+- `interface Diagnostics`: Diagnostics
+- `interface Dividend`: Dividend
+- `interface FormatMoneyOptions`: FormatMoneyOptions
+- `interface FormatPercentOptions`: FormatPercentOptions
+- `interface GreekUnits`: GreekUnits
+- `interface JSONSchema`: JSONSchema
+- `interface MarketInputs`: MarketInputs
+- `interface OccOptionSymbol`: OccOptionSymbol
+- `interface OptionContract`: OptionContract
+- `interface OptionQuote`: OptionQuote
+- `interface OptionQuoteGreeks`: OptionQuoteGreeks
+- `interface OptionQuoteGreeksProvenance`: OptionQuoteGreeksProvenance
+- `interface OptionTrade`: OptionTrade
+- `interface OrderBook`: OrderBook
+- `interface OrderBookLevel`: OrderBookLevel
+- `interface Provenance`: Provenance
+- `interface QuantErrorOptions`: QuantErrorOptions
+- `interface QuantWarning`: QuantWarning
+- `interface Quote`: Quote
+- `interface RateCurve`: RateCurve
+- `interface RateCurvePoint`: RateCurvePoint
+- `interface RawFundamentalsRecord`: RawFundamentalsRecord
+- `interface RequireFiniteFieldsOptions`: RequireFiniteFieldsOptions
+- `interface Trade`: Trade
+- `interface ValidationBranchSpecification`: ValidationBranchSpecification
+- `interface ValidationFieldSpecification`: ValidationFieldSpecification
+- `type Assumptions`: Assumptions<Extra>
+- `type DayCount`: DayCount
+- `type DividendModel`: DividendModel
+- `type EpochMs`: number
+- `type ErrorCode`: { readonly InputNaN: 'input.nan'; readonly InputNotFinite: 'input.not_finite'; readonly InputNegativeSpot: 'input.negative_spot'; readonly InputNegativeStrike: 'input.negative_strike'; readonly InputNegativeVolatility: 'input.negative_volatility'; readonly InputNegativeTime: 'input.negative_time'; readonly InputOutOfRange: 'input.out_of_range'; readonly InputInvalidEnum: 'input.invalid_enum'; readonly InputMissingField: 'input.missing_field'; readonly InputUnknownField: 'input.unknown_field'; readonly InputWrongType: 'input.wrong_type'; readonly InputWrongShape: 'input.wrong_shape'; readonly ImpliedVolatilityNoConvergence: 'implied_volatility.no_convergence'; readonly ImpliedVolatilityBelowIntrinsic: 'implied_volatility.below_intrinsic'; readonly ImpliedVolatilityAboveMax: 'implied_volatility.above_max_bound'; readonly EngineUnsupportedContract: 'engine.unsupported_contract'; readonly DataCrossedMarket: 'data.crossed_market'; readonly DataStaleQuote: 'data.stale_quote'; readonly SolverNoConvergence: 'solver.no_convergence'; readonly LinalgNoConvergence: 'linalg.no_convergence'; readonly LinalgNotPositiveDefinite: 'linalg.not_positive_definite'; readonly LinalgSingular: 'linalg.singular'; readonly IntegrationMaxDepth: 'integration.max_depth'; readonly InterpolationOutOfDomain: 'interpolation.out_of_domain'; readonly InterpolationDuplicateKnots: 'interpolation.duplicate_knots'; readonly InterpolationInvalidGrid: 'interpolation.invalid_grid'; readonly OptimizeInvalidBounds: 'optimize.invalid_bounds'; readonly VolatilityExpiryNotFound: 'volatility.expiry_not_found'; readonly VolatilityCalendarArbitrage: 'volatility.calendar_arbitrage'; readonly StrategyInvalidChartRange: 'strategy.invalid_chart_range'; readonly TimeTimezoneResolutionFailed: 'time.timezone_resolution_failed'; readonly TimeValuationInstantRequired: 'time.valuation_instant_required'; readonly BacktestDuplicateHandler: 'backtest.duplicate_handler'; readonly BacktestMixedSymbols: 'backtest.mixed_symbols'; readonly BacktestMarkUnavailable: 'backtest.mark_unavailable'; readonly BacktestAmbiguousIntrabar: 'backtest.ambiguous_intrabar'; readonly BacktestStaleQuote: 'backtest.stale_quote'; readonly BacktestAdapterNonconformant: 'backtest.adapter_nonconformant'; readonly BacktestInputTooLarge: 'backtest.input_too_large'; readonly BacktestDelistingReturnMissing: 'backtest.delisting_return_missing'; readonly BacktestUniverseMembershipUnknown: 'backtest.universe_membership_unknown'; readonly BacktestLedgerReconciliationFailed: 'backtest.ledger_reconciliation_failed'; readonly EnvironmentNotReset: 'environment.not_reset'; readonly EnvironmentDuplicateOrder: 'environment.duplicate_order'; readonly EnvironmentLimitBreach: 'environment.limit_breach'; readonly EnvironmentActionDisallowed: 'environment.action_disallowed'; readonly EnvironmentUnknownInstrument: 'environment.unknown_instrument'; readonly EnvironmentOrderInvalid: 'environment.order_invalid'; readonly EnvironmentActionInvalid: 'environment.action_invalid'; readonly EnvironmentEpisodeOver: 'environment.episode_over'; readonly TradePlanInvalid: 'trade.plan_invalid'; readonly TradePreflightDenied: 'trade.preflight_denied'; readonly TradeGrantInvalid: 'trade.grant_invalid'; readonly TradeGrantExpired: 'trade.grant_expired'; readonly TradeGrantConsumed: 'trade.grant_consumed'; readonly TradeIdempotencyConflict: 'trade.idempotency_conflict'; readonly TradeHalted: 'trade.halted'; readonly TradeLiveUnavailable: 'trade.live_unavailable'; readonly TradeJournalTransitionInvalid: 'trade.journal_transition_invalid'; readonly OperationCapabilityMissing: 'operation.capability_missing'; readonly OperationToolFiltered: 'operation.tool_filtered'; readonly BacktestGridTooLarge: 'backtest.grid_too_large'; readonly BacktestBookTooLarge: 'backtest.book_too_large'; readonly BacktestUnsupportedCorporateAction: 'backtest.unsupported_corporate_action'; readonly OperationUnknown: 'operation.unknown'; readonly OperationRegistrationRefused: 'operation.registration_refused'; readonly OperationInputTooLarge: 'operation.input_too_large'; readonly OperationDeadlineExceeded: 'operation.deadline_exceeded'; readonly OperationCancelled: 'operation.cancelled'; readonly OperationInternal: 'operation.internal'; readonly OperationHandleStoreMissing: 'operation.handle_store_missing'; readonly OperationHandleUnknown: 'operation.handle_unknown'; readonly OperationHandleKindMismatch: 'operation.handle_kind_mismatch'; readonly InputLengthMismatch: 'input.length_mismatch'; readonly McpDeadlineExceeded: 'mcp.deadline_exceeded'; readonly McpInputTooLarge: 'mcp.input_too_large'; readonly McpInternalError: 'mcp.internal_error'; readonly PostconditionNonFinite: 'postcondition.non_finite_result'; readonly McpUnknownTool: 'mcp.unknown_tool'; readonly PipelineDuplicateAlias: 'pipeline.duplicate_alias'; readonly PipelineLengthMismatch: 'pipeline.length_mismatch'; readonly RegistryAliasConflict: 'registry.alias_conflict'; readonly RegistryDuplicateAliasRow: 'registry.duplicate_alias_row'; readonly RegistryDuplicateIndicator: 'registry.duplicate_indicator'; readonly RegistryUnknownAliasTarget: 'registry.unknown_alias_target'; readonly SignalUnknownReference: 'signal.unknown_reference'; readonly SnapshotInvalidVersion: 'snapshot.invalid_version'; readonly SnapshotKindMismatch: 'snapshot.kind_mismatch'; readonly SnapshotUnknownKind: 'snapshot.unknown_kind'; readonly SnapshotUnsupportedVersion: 'snapshot.unsupported_version'; readonly SnapshotWrongShape: 'snapshot.wrong_shape'; readonly StrategyDeltaRequired: 'strategy.delta_required'; readonly StrategyMultiExpiryExpirationAnalytics: 'strategy.multi_expiry_expiration_analytics'; readonly StrategyExpiryConflict: 'strategy.expiry_conflict'; readonly StrategyStrikeUnavailable: 'strategy.strike_unavailable'; readonly VolatilityForwardUnavailable: 'volatility.forward_unavailable'; readonly VolatilitySnapshotVersionMismatch: 'volatility.snapshot_version_mismatch'; readonly EngineProbabilityOutOfRange: 'engine.probability_out_of_range'; readonly EngineResultOutOfBounds: 'engine.result_out_of_bounds'; readonly EngineDiscretizationInadequate: 'engine.discretization_inadequate'; readonly ImpliedVolatilityPriceBelowResolvable: 'implied_volatility.price_below_resolvable'; readonly RiskIllConditionedCovariance: 'risk.ill_conditioned_covariance'; readonly RiskQuantileBeyondSample: 'risk.quantile_beyond_sample'; readonly VolatilityCalibrationFitDeviation: 'volatility.calibration_fit_deviation'; readonly VolatilityNegativeVarianceForecast: 'volatility.negative_variance_forecast'; readonly MathIterationLimit: 'math.iteration_limit'; readonly BacktestOrderSplitAdjusted: 'backtest.order_split_adjusted'; readonly InputSuspiciousCouponRate: 'input.suspicious_coupon_rate'; readonly InputSuspiciousYield: 'input.suspicious_yield'; readonly ModelFellerConditionViolated: 'model.feller_condition_violated'; readonly PricerRequirementUnsatisfied: 'pricer.requirement_unsatisfied'; readonly PricerRequirementInvalid: 'pricer.requirement_invalid'; readonly PricerObservationInvalid: 'pricer.observation_invalid'; readonly PricerNonconformant: 'pricer.nonconformant'; readonly ScenarioInstructionUnmatched: 'scenario.instruction_unmatched'; readonly ScenarioTargetUnsupported: 'scenario.target_unsupported'; readonly ScenarioCellFailed: 'scenario.cell_failed'; readonly SerializationUnsupportedValue: 'serialization.unsupported_value'; readonly ArtifactMigrationMissing: 'artifact.migration_missing'; readonly ArtifactDuplicateMigration: 'artifact.duplicate_migration'; readonly ArtifactIdMismatch: 'artifact.id_mismatch'; readonly ArtifactTypeMismatch: 'artifact.type_mismatch'; readonly ArtifactFamilyMismatch: 'artifact.family_mismatch'; readonly ArtifactModelVersionUnsupported: 'artifact.model_version_unsupported'; readonly ArtifactNotReplayable: 'artifact.not_replayable'; readonly ArtifactReferencedDataMismatch: 'artifact.referenced_data_mismatch'; readonly ArtifactEmbeddedInputTooLarge: 'artifact.embedded_input_too_large'; readonly ArtifactOperationUnsupported: 'artifact.operation_unsupported'; readonly PortfolioDuplicateEventConflict: 'portfolio.duplicate_event_conflict'; readonly PortfolioLotUnavailable: 'portfolio.lot_unavailable'; readonly PortfolioMarkUnavailable: 'portfolio.mark_unavailable'; readonly PortfolioReversalTargetMissing: 'portfolio.reversal_target_missing'; readonly PortfolioReversalInfeasible: 'portfolio.reversal_infeasible'; }
+- `type ExerciseTime`: ExerciseTime
+- `type Facade`: Facade<Input, Output, Extra, ExplainValue>
+- `type HolidayRule`: HolidayRule
+- `type InterestCompounding`: InterestCompounding
+- `type OptionStyle`: OptionStyle
+- `type OptionType`: OptionType
+- `type OrderSide`: OrderSide
+- `type OrderType`: OrderType
+- `type PriceSource`: PriceSource
+- `type RhoUnit`: RhoUnit
+- `type SeriesFacade`: SeriesFacade<Args, Output, Extra>
+- `type Settlement`: Settlement
+- `type SymbolId`: string
+- `type ThetaUnit`: ThetaUnit
+- `type TimeInForce`: TimeInForce
+- `type ValidationFieldKind`: ValidationFieldKind
+- `type VegaUnit`: VegaUnit
+- `type WarningCode`: { readonly DataLockedMarket: 'data.locked_market'; readonly DataZeroBidAsk: 'data.zero_bid_ask'; readonly SurfaceExtrapolated: 'volatility.surface_extrapolated'; readonly BinomialStepsRoundedOdd: 'binomial.steps_rounded_odd'; readonly GreeksNotComputed: 'greeks.not_computed'; readonly SuspiciousVolatility: 'input.suspicious_volatility'; readonly SuspiciousTime: 'input.suspicious_time'; readonly SuspiciousRiskFreeRate: 'input.suspicious_risk_free_rate'; readonly SuspiciousReturns: 'input.suspicious_returns'; readonly DegenerateInput: 'input.degenerate'; readonly LambdaUndefined: 'greeks.lambda_undefined'; readonly CompoundingUndefined: 'crypto.compounding_undefined'; readonly CompoundingOverflow: 'crypto.compounding_overflow'; readonly CovarianceFloored: 'math.covariance_floored'; readonly GreeksUnsupportedByEngine: 'greeks.unsupported_by_engine'; readonly ModelLimitation: 'model.limitation'; readonly ScenarioUnusedCurrencyConversion: 'scenario.unused_currency_conversion'; readonly BacktestAssignment: 'backtest.assignment'; readonly BacktestDataDuplicateTimestamp: 'backtest.data_duplicate_timestamp'; readonly BacktestDataNonfinite: 'backtest.data_nonfinite'; readonly BacktestDataMissing: 'backtest.data_missing'; readonly BacktestLimitRejected: 'backtest.limit_rejected'; readonly BacktestComboLegUnfilled: 'backtest.combo_leg_unfilled'; readonly BacktestMarginBreach: 'backtest.margin_breach'; readonly BacktestForcedLiquidation: 'backtest.forced_liquidation'; readonly BacktestDataUnsorted: 'backtest.data_unsorted'; readonly BacktestEntrySkipped: 'backtest.entry_skipped'; readonly BacktestMarkFallback: 'backtest.mark_fallback'; readonly BacktestLookahead: 'backtest.lookahead'; readonly BacktestMarginRejected: 'backtest.margin_rejected'; readonly BacktestMarkedAtCost: 'backtest.marked_at_cost'; readonly BacktestNegativeCash: 'backtest.negative_cash'; readonly BacktestShortRejected: 'backtest.short_rejected'; readonly BacktestSignalWarmup: 'backtest.signal_warmup'; readonly CryptoCarryArbitrage: 'crypto.carry_arbitrage'; readonly CryptoExtremeFunding: 'crypto.extreme_funding'; readonly EstimateRiskNeutral: 'estimate.risk_neutral'; readonly FlowSweepsNotVenueVerified: 'flow.sweeps_not_venue_verified'; readonly HestonCosineExpansionUnstable: 'heston.cosine_expansion_unstable'; readonly HestonFellerViolated: 'heston.feller_violated'; readonly ImpliedVolatilityBracketExpanded: 'implied_volatility.bracket_expanded'; readonly ImpliedVolatilityFlatHistory: 'implied_volatility.flat_history'; readonly ImpliedVolatilityLowVega: 'implied_volatility.low_vega'; readonly LookbackZeroCarry: 'lookback.zero_carry'; readonly MathCovarianceEwmaEffectiveSample: 'math.covariance_ewma_effective_sample'; readonly MathCovarianceIllConditioned: 'math.covariance_ill_conditioned'; readonly MathCovarianceMethodAuto: 'math.covariance_method_auto'; readonly MathCovarianceSingular: 'math.covariance_singular'; readonly MonteCarloQuasiMonteCarloDimensionFallback: 'monte_carlo.quasi_monte_carlo_dimension_fallback'; readonly OptimizeNotConverged: 'optimize.not_converged'; readonly OperationUntypedWarning: 'operation.untyped_warning'; readonly OptionsDividendsNone: 'options.dividends_none'; readonly OptionsDividendsPast: 'options.dividends_past'; readonly OptionsExerciseDiscreteDividends: 'options.exercise_discrete_dividends'; readonly OptionsChainHealthModelNotRequested: 'options.chain_health.model_not_requested'; readonly PerformanceSuspiciousEquityInput: 'performance.suspicious_equity_input'; readonly PerformanceNonFiniteMetric: 'performance.non_finite_metric'; readonly PerformanceEmptySeries: 'performance.empty_series'; readonly RiskZeroGrossExposure: 'risk.zero_gross_exposure'; readonly OptionsEngineFailed: 'options.engine_failed'; readonly TechnicalAnalysisOpeningRangeTruncated: 'technical_analysis.opening_range_truncated'; readonly StructureFlatBaseline: 'structure.flat_baseline'; readonly VolatilityCalibrationNotConverged: 'volatility.calibration_not_converged'; readonly PerformanceUndefinedMetric: 'performance.undefined_metric'; readonly ResearchSurvivorshipBias: 'research.survivorship_bias'; readonly ResearchTrainTestLeakage: 'research.train_test_leakage'; readonly ResearchBacktestOverfittingProbabilityTrimmed: 'research.backtest_overfitting_probability_trimmed'; readonly RiskBrinsonWeights: 'risk.brinson_weights'; readonly RiskCornishFisherConditionalValueAtRiskGaussianFallback: 'risk.cornish_fisher_conditional_value_at_risk_gaussian_fallback'; readonly RiskCornishFisherOutOfDomain: 'risk.cornish_fisher_out_of_domain'; readonly RiskCostExceedsEdge: 'risk.cost_exceeds_edge'; readonly RiskAsOfUnscreened: 'risk.as_of_unscreened'; readonly RiskZeroVolatilitySharpe: 'risk.zero_volatility_sharpe'; readonly RiskFrontierUnboundedReturn: 'risk.frontier_unbounded_return'; readonly RiskFrontierNotMonotone: 'risk.frontier_not_monotone'; readonly RiskFrontierPointsFailed: 'risk.frontier_points_failed'; readonly RiskExtremeValueConfidenceOutsideTail: 'risk.extreme_value_confidence_outside_tail'; readonly RiskExtremeValueDegenerateFit: 'risk.extreme_value_degenerate_fit'; readonly RiskExtremeValueFewExceedances: 'risk.extreme_value_few_exceedances'; readonly RiskExtremeValueInfiniteMean: 'risk.extreme_value_infinite_mean'; readonly RiskExtremeValueInfiniteVariance: 'risk.extreme_value_infinite_variance'; readonly RiskExtremeValueMleFallback: 'risk.extreme_value_mle_fallback'; readonly RiskHighCostDrag: 'risk.high_cost_drag'; readonly RiskInfeasibleConstraints: 'risk.infeasible_constraints'; readonly RiskInfeasibleTangency: 'risk.infeasible_tangency'; readonly RiskKellyEstimationNoEdge: 'risk.kelly_estimation_no_edge'; readonly RiskKellyEstimationThinSample: 'risk.kelly_estimation_thin_sample'; readonly RiskKellyFatTails: 'risk.kelly_fat_tails'; readonly RiskKellyNaiveOverbet: 'risk.kelly_naive_overbet'; readonly RiskKellyNegativeSum: 'risk.kelly_negative_sum'; readonly RiskKellyNoEdge: 'risk.kelly_no_edge'; readonly RiskKellyOver: 'risk.kelly_over'; readonly RiskKellyUnbounded: 'risk.kelly_unbounded'; readonly RiskMeanExcessNoLinearRegion: 'risk.mean_excess_no_linear_region'; readonly RiskPnlUnexplainedResidual: 'risk.pnl_unexplained_residual'; readonly RiskUnboundedLoss: 'risk.unbounded_loss'; readonly StrategyVolatilityFloored: 'strategy.volatility_floored'; readonly StrategyRiskRewardUndefined: 'strategy.risk_reward_undefined'; readonly StrategyOptimizerZeroCapital: 'strategy.optimizer_zero_capital'; readonly StructureAggressorUnavailable: 'structure.aggressor_unavailable'; readonly StructureContractsSkipped: 'structure.contracts_skipped'; readonly StructureDuplicateContractQuotes: 'structure.duplicate_contract_quotes'; readonly StructureNoEligibleQuotes: 'structure.no_eligible_quotes'; readonly VolatilityButterflyArbitrage: 'volatility.butterfly_arbitrage'; readonly VolatilityEssviButterfly: 'volatility.essvi_butterfly'; readonly VolatilityEssviCalendar: 'volatility.essvi_calendar'; readonly VolatilityEssviCalendarData: 'volatility.essvi_calendar_data'; readonly VolatilityEssviNotConverged: 'volatility.essvi_not_converged'; readonly VolatilityFitInsufficientData: 'volatility.fit_insufficient_data'; readonly VolatilityFitUnconverged: 'volatility.fit_unconverged'; readonly VolatilityShockDegradedToInterpolated: 'volatility.shock_degraded_to_interpolated'; readonly VolatilityShockFloored: 'volatility.shock_floored'; readonly VolatilitySkewDeltaExtrapolated: 'volatility.skew_delta_extrapolated'; readonly VolatilityObservedSkewUnavailable: 'volatility.observed_skew_unavailable'; readonly VolatilityObservedSkewQuoteExcluded: 'volatility.observed_skew_quote_excluded'; readonly RiskKellyZeroVariance: 'risk.kelly_zero_variance'; readonly RiskSharpeUndefined: 'risk.sharpe_undefined'; readonly OptionsChainGreeksRowsSkipped: 'chain_greeks.rows_skipped'; readonly VolatilityObservedSkewMissingDelta: 'volatility.observed_skew_missing_delta'; readonly VolatilityObservedSkewDuplicateContract: 'volatility.observed_skew_duplicate_contract'; readonly VolatilitySsviButterfly: 'volatility.ssvi_butterfly'; readonly VolatilitySsviCalendarData: 'volatility.ssvi_calendar_data'; readonly VolatilitySsviNotConverged: 'volatility.ssvi_not_converged'; readonly VolatilityStickyIndeterminate: 'volatility.sticky_indeterminate'; readonly VolatilityStickyWeakFit: 'volatility.sticky_weak_fit'; readonly VolatilitySurfaceQuotesSkipped: 'volatility.surface_quotes_skipped'; readonly VolatilitySurfaceSparse: 'volatility.surface_sparse'; readonly VolatilitySwaptionCubeExtrapolated: 'volatility.swaption_cube_extrapolated'; readonly VolatilitySwaptionNodePoorFit: 'volatility.swaption_node_poor_fit'; readonly ArtifactLibraryVersionDiffers: 'artifact.library_version_differs'; readonly ArtifactComparisonDifferentMarket: 'artifact.comparison_different_market'; readonly ArtifactComparisonDifferentUniverse: 'artifact.comparison_different_universe'; readonly CurveExtrapolated: 'curve.extrapolated'; }
+- `type WarningSeverity`: WarningSeverity
+- `type Weekday`: Weekday