fhirpath-ts 0.0.0-bootstrap.0

package/dist/values/datetime.d.ts

@@ -0,0 +1,54 @@
+export type TemporalKind = 'date' | 'dateTime' | 'time';
+export type TemporalPrecision = 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second' | 'millisecond';
+/**
+ * A Date, DateTime, or Time value with partial precision. Components beyond the
+ * value's precision are undefined; comparison across precisions is decided by the
+ * operators (spec §6.2/§6.4), not here.
+ */
+export declare class Temporal {
+    readonly kind: TemporalKind;
+    readonly year: number | undefined;
+    readonly month: number | undefined;
+    readonly day: number | undefined;
+    readonly hour: number | undefined;
+    readonly minute: number | undefined;
+    readonly second: number | undefined;
+    /** Fraction-of-second digits as written, e.g. `559` or `5591`; undefined when absent. */
+    readonly fraction: string | undefined;
+    /** Offset in minutes; 0 for `Z`; undefined when the literal has no timezone. */
+    readonly timezoneOffsetMinutes: number | undefined;
+    private constructor();
+    /** Parse the text of a date literal (`2014-01`) or FHIR date value. */
+    static parseDate(text: string): Temporal | undefined;
+    /** Parse the text of a dateTime literal (`2014-01-25T14:30:00Z`, `2014T`). */
+    static parseDateTime(text: string): Temporal | undefined;
+    /** Parse the text of a time literal (`14:30:14.559`). Times have no timezone. */
+    static parseTime(text: string): Temporal | undefined;
+    /** Build from components with the same range validation as parsing. */
+    static fromFields(kind: TemporalKind, fields: {
+        year?: number | undefined;
+        month?: number | undefined;
+        day?: number | undefined;
+        hour?: number | undefined;
+        minute?: number | undefined;
+        second?: number | undefined;
+        fraction?: string | undefined;
+        timezoneOffsetMinutes?: number | undefined;
+    }): Temporal | undefined;
+    private static build;
+    get precision(): TemporalPrecision;
+    private withKind;
+    toString(): string;
+    /** Literal form including the `@` (and `@T` for times); used when printing values. */
+    toLiteralString(): string;
+}
+/**
+ * Offset added to a FHIRPath year before handing it to `Date.UTC`, which maps
+ * years 0–99 to 1900–1999. Shifting by a whole multiple of 400 preserves the
+ * proleptic Gregorian leap rule exactly while moving small years out of that
+ * remapped range, so date math on years 1–99 stays correct.
+ */
+export declare const GREGORIAN_UTC_YEAR_OFFSET = 400;
+/** Days in a month (1-based), correct across the full FHIRPath year range. */
+export declare function daysInMonth(year: number, month: number): number;
+//# sourceMappingURL=datetime.d.ts.map

package/dist/values/datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../../src/values/datetime.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAA;AAEvD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAA;AAMvG;;;;GAIG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,gFAAgF;IAChF,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,SAAS,CAAA;IAElD,OAAO;IAsBP,uEAAuE;IACvE,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAapD,8EAA8E;IAC9E,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAqCxD,iFAAiF;IACjF,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAcpD,uEAAuE;IACvE,MAAM,CAAC,UAAU,CACf,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACzB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACxB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACzB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC7B,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC3C,GACA,QAAQ,GAAG,SAAS;IAIvB,OAAO,CAAC,MAAM,CAAC,KAAK;IAqCpB,IAAI,SAAS,IAAI,iBAAiB,CAoBjC;IAED,OAAO,CAAC,QAAQ;IAchB,QAAQ,IAAI,MAAM;IAgClB,sFAAsF;IACtF,eAAe,IAAI,MAAM;CAG1B;AAMD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/dist/values/datetime.js

@@ -0,0 +1,226 @@
+const DATE_PATTERN = /^(\d{4})(?:-(\d{2})(?:-(\d{2}))?)?$/;
+const TIME_PATTERN = /^(\d{2})(?::(\d{2})(?::(\d{2})(?:\.(\d+))?)?)?$/;
+const TIMEZONE_PATTERN = /(Z|[+-]\d{2}:\d{2})$/;
+/**
+ * A Date, DateTime, or Time value with partial precision. Components beyond the
+ * value's precision are undefined; comparison across precisions is decided by the
+ * operators (spec §6.2/§6.4), not here.
+ */
+export class Temporal {
+    kind;
+    year;
+    month;
+    day;
+    hour;
+    minute;
+    second;
+    /** Fraction-of-second digits as written, e.g. `559` or `5591`; undefined when absent. */
+    fraction;
+    /** Offset in minutes; 0 for `Z`; undefined when the literal has no timezone. */
+    timezoneOffsetMinutes;
+    constructor(fields) {
+        this.kind = fields.kind;
+        this.year = fields.year;
+        this.month = fields.month;
+        this.day = fields.day;
+        this.hour = fields.hour;
+        this.minute = fields.minute;
+        this.second = fields.second;
+        this.fraction = fields.fraction;
+        this.timezoneOffsetMinutes = fields.timezoneOffsetMinutes;
+    }
+    /** Parse the text of a date literal (`2014-01`) or FHIR date value. */
+    static parseDate(text) {
+        const match = DATE_PATTERN.exec(text);
+        if (!match) {
+            return undefined;
+        }
+        const [, year, month, day] = match;
+        return Temporal.build('date', {
+            year: Number(year),
+            month: optionalNumber(month),
+            day: optionalNumber(day),
+        });
+    }
+    /** Parse the text of a dateTime literal (`2014-01-25T14:30:00Z`, `2014T`). */
+    static parseDateTime(text) {
+        const timeSeparator = text.indexOf('T');
+        if (timeSeparator === -1) {
+            const dateOnly = Temporal.parseDate(text);
+            return dateOnly ? dateOnly.withKind('dateTime') : undefined;
+        }
+        const datePart = text.slice(0, timeSeparator);
+        let timePart = text.slice(timeSeparator + 1);
+        const dateMatch = DATE_PATTERN.exec(datePart);
+        if (!dateMatch) {
+            return undefined;
+        }
+        let timezoneOffsetMinutes;
+        const timezoneMatch = TIMEZONE_PATTERN.exec(timePart);
+        if (timezoneMatch) {
+            timezoneOffsetMinutes = parseTimezone(timezoneMatch[1]);
+            timePart = timePart.slice(0, -timezoneMatch[1].length);
+        }
+        let time = null;
+        if (timePart !== '') {
+            time = TIME_PATTERN.exec(timePart);
+            if (!time) {
+                return undefined;
+            }
+        }
+        return Temporal.build('dateTime', {
+            year: Number(dateMatch[1]),
+            month: optionalNumber(dateMatch[2]),
+            day: optionalNumber(dateMatch[3]),
+            hour: optionalNumber(time?.[1]),
+            minute: optionalNumber(time?.[2]),
+            second: optionalNumber(time?.[3]),
+            fraction: time?.[4],
+            timezoneOffsetMinutes,
+        });
+    }
+    /** Parse the text of a time literal (`14:30:14.559`). Times have no timezone. */
+    static parseTime(text) {
+        const match = TIME_PATTERN.exec(text);
+        if (!match) {
+            return undefined;
+        }
+        const [, hour, minute, second, fraction] = match;
+        return Temporal.build('time', {
+            hour: Number(hour),
+            minute: optionalNumber(minute),
+            second: optionalNumber(second),
+            fraction,
+        });
+    }
+    /** Build from components with the same range validation as parsing. */
+    static fromFields(kind, fields) {
+        return Temporal.build(kind, fields);
+    }
+    static build(kind, fields) {
+        if (!(inRange(fields.month, 1, 12) &&
+            inRange(fields.day, 1, 31) &&
+            inRange(fields.hour, 0, 23) &&
+            inRange(fields.minute, 0, 59) &&
+            inRange(fields.second, 0, 60))) {
+            return undefined;
+        }
+        // @2019-02-29 is not a date; timezone offsets only exist within -12:00..+14:00.
+        if (fields.day !== undefined &&
+            fields.month !== undefined &&
+            fields.year !== undefined &&
+            fields.day > daysInMonth(fields.year, fields.month)) {
+            return undefined;
+        }
+        if (fields.timezoneOffsetMinutes !== undefined && Math.abs(fields.timezoneOffsetMinutes) > 14 * 60) {
+            return undefined;
+        }
+        return new Temporal({ kind, ...fields });
+    }
+    get precision() {
+        if (this.fraction !== undefined) {
+            return 'millisecond';
+        }
+        if (this.second !== undefined) {
+            return 'second';
+        }
+        if (this.minute !== undefined) {
+            return 'minute';
+        }
+        if (this.hour !== undefined) {
+            return 'hour';
+        }
+        if (this.day !== undefined) {
+            return 'day';
+        }
+        if (this.month !== undefined) {
+            return 'month';
+        }
+        return 'year';
+    }
+    withKind(kind) {
+        return new Temporal({
+            kind,
+            year: this.year,
+            month: this.month,
+            day: this.day,
+            hour: this.hour,
+            minute: this.minute,
+            second: this.second,
+            fraction: this.fraction,
+            timezoneOffsetMinutes: this.timezoneOffsetMinutes,
+        });
+    }
+    toString() {
+        const parts = [];
+        if (this.year !== undefined) {
+            parts.push(pad4(this.year));
+            if (this.month !== undefined) {
+                parts.push(`-${pad2(this.month)}`);
+                if (this.day !== undefined) {
+                    parts.push(`-${pad2(this.day)}`);
+                }
+            }
+        }
+        if (this.kind === 'dateTime' && this.hour !== undefined) {
+            parts.push('T');
+        }
+        if (this.hour !== undefined) {
+            parts.push(pad2(this.hour));
+            if (this.minute !== undefined) {
+                parts.push(`:${pad2(this.minute)}`);
+                if (this.second !== undefined) {
+                    parts.push(`:${pad2(this.second)}`);
+                    if (this.fraction !== undefined) {
+                        parts.push(`.${this.fraction}`);
+                    }
+                }
+            }
+            if (this.timezoneOffsetMinutes !== undefined) {
+                parts.push(formatTimezone(this.timezoneOffsetMinutes));
+            }
+        }
+        return parts.join('');
+    }
+    /** Literal form including the `@` (and `@T` for times); used when printing values. */
+    toLiteralString() {
+        return this.kind === 'time' ? `@T${this.toString()}` : `@${this.toString()}`;
+    }
+}
+function optionalNumber(text) {
+    return text === undefined ? undefined : Number(text);
+}
+/**
+ * Offset added to a FHIRPath year before handing it to `Date.UTC`, which maps
+ * years 0–99 to 1900–1999. Shifting by a whole multiple of 400 preserves the
+ * proleptic Gregorian leap rule exactly while moving small years out of that
+ * remapped range, so date math on years 1–99 stays correct.
+ */
+export const GREGORIAN_UTC_YEAR_OFFSET = 400;
+/** Days in a month (1-based), correct across the full FHIRPath year range. */
+export function daysInMonth(year, month) {
+    return new Date(Date.UTC(year + GREGORIAN_UTC_YEAR_OFFSET, month, 0)).getUTCDate();
+}
+function inRange(value, min, max) {
+    return value === undefined || (value >= min && value <= max);
+}
+function parseTimezone(text) {
+    if (text === 'Z') {
+        return 0;
+    }
+    const sign = text.startsWith('-') ? -1 : 1;
+    const hours = Number(text.slice(1, 3));
+    const minutes = Number(text.slice(4, 6));
+    return sign * (hours * 60 + minutes);
+}
+function formatTimezone(offsetMinutes) {
+    if (offsetMinutes === 0) {
+        return 'Z';
+    }
+    const sign = offsetMinutes < 0 ? '-' : '+';
+    const absolute = Math.abs(offsetMinutes);
+    return `${sign}${pad2(Math.floor(absolute / 60))}:${pad2(absolute % 60)}`;
+}
+const pad2 = (value) => String(value).padStart(2, '0');
+const pad4 = (value) => String(value).padStart(4, '0');
+//# sourceMappingURL=datetime.js.map

package/dist/values/datetime.js.map

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

package/dist/values/decimal.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Exact decimal arithmetic on a BigInt mantissa with an explicit scale (count of
+ * fraction digits). The scale doubles as the value's precision: `1.10` keeps scale 2,
+ * which `precision()` and the boundary functions rely on. No floats are involved in
+ * `+ - * / div mod`, comparison, or rounding, so `0.1 + 0.2 = 0.3` holds exactly.
+ */
+export declare class Decimal {
+    /** Scaled integer including the sign: `-1.25` is digits `-125n`, scale 2. */
+    readonly digits: bigint;
+    /** Number of fraction digits; never negative. */
+    readonly scale: number;
+    constructor(digits: bigint, scale: number);
+    /** Parse a decimal string. Accepts exponent notation for values arriving from JSON numbers. */
+    static fromString(text: string): Decimal | undefined;
+    static fromNumber(value: number): Decimal | undefined;
+    static zero(): Decimal;
+    isZero(): boolean;
+    isNegative(): boolean;
+    /** True when the value has no fraction part (trailing fraction zeros count as none). */
+    isInteger(): boolean;
+    negate(): Decimal;
+    abs(): Decimal;
+    add(other: Decimal): Decimal;
+    subtract(other: Decimal): Decimal;
+    multiply(other: Decimal): Decimal;
+    /** Division; empty (undefined) when dividing by zero. Result is exact up to 24+ fraction digits, then rounded half away from zero and trimmed. */
+    divide(other: Decimal): Decimal | undefined;
+    /** Truncated integer division (`div`); empty when dividing by zero. */
+    integerDivide(other: Decimal): Decimal | undefined;
+    /** Remainder (`mod`) with the sign of the dividend; empty when dividing by zero. */
+    modulo(other: Decimal): Decimal | undefined;
+    compare(other: Decimal): -1 | 0 | 1;
+    /** Numeric equality; trailing zeros do not matter (`0.5 = 0.50`). */
+    equals(other: Decimal): boolean;
+    /** Round half away from zero to `fractionDigits` fraction digits. */
+    round(fractionDigits?: number): Decimal;
+    /** Drop the fraction part toward zero. */
+    truncate(): Decimal;
+    ceiling(): Decimal;
+    floor(): Decimal;
+    /** Reduce the scale by removing trailing fraction zeros, keeping at least `minScale`. */
+    trimTrailingZeros(minScale?: number): Decimal;
+    /** Rescale to exactly `scale` fraction digits (padding with zeros or rounding). */
+    withScale(scale: number): Decimal;
+    toString(): string;
+    toNumber(): number;
+}
+//# sourceMappingURL=decimal.d.ts.map

package/dist/values/decimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../../src/values/decimal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;gBAEV,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAKzC,+FAA+F;IAC/F,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IA2BpD,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAOrD,MAAM,CAAC,IAAI,IAAI,OAAO;IAItB,MAAM,IAAI,OAAO;IAIjB,UAAU,IAAI,OAAO;IAIrB,wFAAwF;IACxF,SAAS,IAAI,OAAO;IAIpB,MAAM,IAAI,OAAO;IAIjB,GAAG,IAAI,OAAO;IAId,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAK5B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAKjC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIjC,kJAAkJ;IAClJ,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IAS3C,uEAAuE;IACvE,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IAQlD,oFAAoF;IACpF,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IAQ3C,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAQnC,qEAAqE;IACrE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAI/B,qEAAqE;IACrE,KAAK,CAAC,cAAc,SAAI,GAAG,OAAO;IAQlC,0CAA0C;IAC1C,QAAQ,IAAI,OAAO;IAInB,OAAO,IAAI,OAAO;IAQlB,KAAK,IAAI,OAAO;IAQhB,yFAAyF;IACzF,iBAAiB,CAAC,QAAQ,SAAI,GAAG,OAAO;IAUxC,mFAAmF;IACnF,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOjC,QAAQ,IAAI,MAAM;IAQlB,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/values/decimal.js

@@ -0,0 +1,188 @@
+/**
+ * Exact decimal arithmetic on a BigInt mantissa with an explicit scale (count of
+ * fraction digits). The scale doubles as the value's precision: `1.10` keeps scale 2,
+ * which `precision()` and the boundary functions rely on. No floats are involved in
+ * `+ - * / div mod`, comparison, or rounding, so `0.1 + 0.2 = 0.3` holds exactly.
+ */
+export class Decimal {
+    /** Scaled integer including the sign: `-1.25` is digits `-125n`, scale 2. */
+    digits;
+    /** Number of fraction digits; never negative. */
+    scale;
+    constructor(digits, scale) {
+        this.digits = digits;
+        this.scale = scale;
+    }
+    /** Parse a decimal string. Accepts exponent notation for values arriving from JSON numbers. */
+    static fromString(text) {
+        const match = /^([+-]?)(\d+)(?:\.(\d+))?(?:[eE]([+-]?\d+))?$/.exec(text.trim());
+        if (!match) {
+            return undefined;
+        }
+        const [, sign, whole, fraction = '', exponentText] = match;
+        let digits = BigInt(`${whole}${fraction}`);
+        if (sign === '-') {
+            digits = -digits;
+        }
+        let scale = fraction.length;
+        const exponent = exponentText === undefined ? 0 : Number.parseInt(exponentText, 10);
+        // JS numbers never stringify past e±308; a larger exponent can only come from
+        // hostile input and would allocate a giant BigInt.
+        if (Math.abs(exponent) > 400) {
+            return undefined;
+        }
+        if (exponent > 0) {
+            const shift = Math.min(exponent, scale);
+            scale -= shift;
+            digits *= 10n ** BigInt(exponent - shift);
+        }
+        else if (exponent < 0) {
+            scale -= exponent;
+        }
+        return new Decimal(digits, scale);
+    }
+    static fromNumber(value) {
+        if (!Number.isFinite(value)) {
+            return undefined;
+        }
+        return Decimal.fromString(String(value));
+    }
+    static zero() {
+        return new Decimal(0n, 0);
+    }
+    isZero() {
+        return this.digits === 0n;
+    }
+    isNegative() {
+        return this.digits < 0n;
+    }
+    /** True when the value has no fraction part (trailing fraction zeros count as none). */
+    isInteger() {
+        return this.digits % 10n ** BigInt(this.scale) === 0n;
+    }
+    negate() {
+        return new Decimal(-this.digits, this.scale);
+    }
+    abs() {
+        return this.digits < 0n ? this.negate() : this;
+    }
+    add(other) {
+        const [a, b, scale] = alignScales(this, other);
+        return new Decimal(a + b, scale);
+    }
+    subtract(other) {
+        const [a, b, scale] = alignScales(this, other);
+        return new Decimal(a - b, scale);
+    }
+    multiply(other) {
+        return new Decimal(this.digits * other.digits, this.scale + other.scale);
+    }
+    /** Division; empty (undefined) when dividing by zero. Result is exact up to 24+ fraction digits, then rounded half away from zero and trimmed. */
+    divide(other) {
+        if (other.digits === 0n) {
+            return undefined;
+        }
+        const targetScale = Math.max(this.scale, other.scale, 8) + 16;
+        const numerator = this.digits * 10n ** BigInt(targetScale + other.scale - this.scale);
+        return new Decimal(divideHalfAwayFromZero(numerator, other.digits), targetScale).trimTrailingZeros();
+    }
+    /** Truncated integer division (`div`); empty when dividing by zero. */
+    integerDivide(other) {
+        if (other.digits === 0n) {
+            return undefined;
+        }
+        const [a, b] = alignScales(this, other);
+        return new Decimal(a / b, 0);
+    }
+    /** Remainder (`mod`) with the sign of the dividend; empty when dividing by zero. */
+    modulo(other) {
+        if (other.digits === 0n) {
+            return undefined;
+        }
+        const [a, b, scale] = alignScales(this, other);
+        return new Decimal(a % b, scale);
+    }
+    compare(other) {
+        const [a, b] = alignScales(this, other);
+        if (a < b) {
+            return -1;
+        }
+        return a > b ? 1 : 0;
+    }
+    /** Numeric equality; trailing zeros do not matter (`0.5 = 0.50`). */
+    equals(other) {
+        return this.compare(other) === 0;
+    }
+    /** Round half away from zero to `fractionDigits` fraction digits. */
+    round(fractionDigits = 0) {
+        if (fractionDigits >= this.scale) {
+            return this;
+        }
+        const factor = 10n ** BigInt(this.scale - fractionDigits);
+        return new Decimal(divideHalfAwayFromZero(this.digits, factor), fractionDigits);
+    }
+    /** Drop the fraction part toward zero. */
+    truncate() {
+        return new Decimal(this.digits / 10n ** BigInt(this.scale), 0);
+    }
+    ceiling() {
+        const whole = this.truncate();
+        if (this.digits > 0n && !this.isInteger()) {
+            return new Decimal(whole.digits + 1n, 0);
+        }
+        return whole;
+    }
+    floor() {
+        const whole = this.truncate();
+        if (this.digits < 0n && !this.isInteger()) {
+            return new Decimal(whole.digits - 1n, 0);
+        }
+        return whole;
+    }
+    /** Reduce the scale by removing trailing fraction zeros, keeping at least `minScale`. */
+    trimTrailingZeros(minScale = 0) {
+        let digits = this.digits;
+        let scale = this.scale;
+        while (scale > minScale && digits % 10n === 0n) {
+            digits /= 10n;
+            scale -= 1;
+        }
+        return scale === this.scale ? this : new Decimal(digits, scale);
+    }
+    /** Rescale to exactly `scale` fraction digits (padding with zeros or rounding). */
+    withScale(scale) {
+        if (scale <= this.scale) {
+            return this.round(scale);
+        }
+        return new Decimal(this.digits * 10n ** BigInt(scale - this.scale), scale);
+    }
+    toString() {
+        const negative = this.digits < 0n;
+        const text = (negative ? -this.digits : this.digits).toString().padStart(this.scale + 1, '0');
+        const whole = text.slice(0, text.length - this.scale);
+        const fraction = this.scale > 0 ? `.${text.slice(text.length - this.scale)}` : '';
+        return `${negative ? '-' : ''}${whole}${fraction}`;
+    }
+    toNumber() {
+        return Number(this.toString());
+    }
+}
+function alignScales(a, b) {
+    const scale = Math.max(a.scale, b.scale);
+    return [a.digits * 10n ** BigInt(scale - a.scale), b.digits * 10n ** BigInt(scale - b.scale), scale];
+}
+function divideHalfAwayFromZero(numerator, denominator) {
+    const quotient = numerator / denominator;
+    const remainder = numerator % denominator;
+    if (remainder === 0n) {
+        return quotient;
+    }
+    const absRemainder = remainder < 0n ? -remainder : remainder;
+    const absDenominator = denominator < 0n ? -denominator : denominator;
+    if (absRemainder * 2n >= absDenominator) {
+        const negativeResult = numerator < 0n !== denominator < 0n;
+        return quotient + (negativeResult ? -1n : 1n);
+    }
+    return quotient;
+}
+//# sourceMappingURL=decimal.js.map

package/dist/values/decimal.js.map

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

package/dist/values/numeric.d.ts

@@ -0,0 +1,24 @@
+import { Decimal } from './decimal.ts';
+import { type TypedValue } from './typed-value.ts';
+export type NumericKind = 'Integer' | 'Long' | 'Decimal';
+export interface NumericOperand {
+    kind: NumericKind;
+    value: Decimal;
+}
+export declare const LONG_MIN = -9223372036854775808n;
+export declare const LONG_MAX = 9223372036854775807n;
+/** Read an Integer/Long/Decimal operand as a Decimal, remembering its kind. */
+export declare function asNumeric(item: TypedValue): NumericOperand | undefined;
+/** The wider of two numeric kinds: Decimal > Long > Integer (spec implicit conversion). */
+export declare function widerKind(a: NumericKind, b: NumericKind): NumericKind;
+/**
+ * Wrap a numeric result as the narrowest type that represents it exactly.
+ * Integer is 32-bit and Long is 64-bit, so their arithmetic can produce a whole
+ * number too large for the type. When that happens, widen to the next integer
+ * type that holds the value (Integer → Long → Decimal), but never below the
+ * operands' own kind. This keeps the value exact rather than dropping it (empty)
+ * or wrapping it around the way some engines do. Decimal results pass through
+ * unchanged.
+ */
+export declare function wrapNumeric(value: Decimal, kind: NumericKind): TypedValue;
+//# sourceMappingURL=numeric.d.ts.map

package/dist/values/numeric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numeric.d.ts","sourceRoot":"","sources":["../../src/values/numeric.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAA6D,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7G,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAA;AAExD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,OAAO,CAAA;CACf;AAID,eAAO,MAAM,QAAQ,wBAAwB,CAAA;AAC7C,eAAO,MAAM,QAAQ,uBAAuB,CAAA;AAE5C,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,CAWtE;AAED,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,WAAW,CAQrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAazE"}

package/dist/values/numeric.js

@@ -0,0 +1,53 @@
+import { Decimal } from "./decimal.js";
+import { SYSTEM_DECIMAL, SYSTEM_INTEGER, SYSTEM_LONG, systemTypeOf } from "./typed-value.js";
+const INTEGER_MIN = -2147483648n;
+const INTEGER_MAX = 2147483647n;
+export const LONG_MIN = -9223372036854775808n;
+export const LONG_MAX = 9223372036854775807n;
+/** Read an Integer/Long/Decimal operand as a Decimal, remembering its kind. */
+export function asNumeric(item) {
+    switch (systemTypeOf(item)) {
+        case SYSTEM_INTEGER:
+            return { kind: 'Integer', value: Decimal.fromString(String(item.value)) };
+        case SYSTEM_LONG:
+            return { kind: 'Long', value: Decimal.fromString(item.value.toString()) };
+        case SYSTEM_DECIMAL:
+            return { kind: 'Decimal', value: item.value };
+        default:
+            return undefined;
+    }
+}
+/** The wider of two numeric kinds: Decimal > Long > Integer (spec implicit conversion). */
+export function widerKind(a, b) {
+    if (a === 'Decimal' || b === 'Decimal') {
+        return 'Decimal';
+    }
+    if (a === 'Long' || b === 'Long') {
+        return 'Long';
+    }
+    return 'Integer';
+}
+/**
+ * Wrap a numeric result as the narrowest type that represents it exactly.
+ * Integer is 32-bit and Long is 64-bit, so their arithmetic can produce a whole
+ * number too large for the type. When that happens, widen to the next integer
+ * type that holds the value (Integer → Long → Decimal), but never below the
+ * operands' own kind. This keeps the value exact rather than dropping it (empty)
+ * or wrapping it around the way some engines do. Decimal results pass through
+ * unchanged.
+ */
+export function wrapNumeric(value, kind) {
+    if (kind === 'Decimal') {
+        return { type: SYSTEM_DECIMAL, value };
+    }
+    const whole = value.trimTrailingZeros();
+    const big = BigInt(whole.toString());
+    if (kind === 'Integer' && big >= INTEGER_MIN && big <= INTEGER_MAX) {
+        return { type: SYSTEM_INTEGER, value: Number(big) };
+    }
+    if (big >= LONG_MIN && big <= LONG_MAX) {
+        return { type: SYSTEM_LONG, value: big };
+    }
+    return { type: SYSTEM_DECIMAL, value: whole };
+}
+//# sourceMappingURL=numeric.js.map

package/dist/values/numeric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numeric.js","sourceRoot":"","sources":["../../src/values/numeric.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAmB,MAAM,kBAAkB,CAAA;AAS7G,MAAM,WAAW,GAAG,CAAC,WAAW,CAAA;AAChC,MAAM,WAAW,GAAG,WAAW,CAAA;AAC/B,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,oBAAoB,CAAA;AAC7C,MAAM,CAAC,MAAM,QAAQ,GAAG,oBAAoB,CAAA;AAE5C,+EAA+E;AAC/E,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,QAAQ,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,KAAK,cAAc;YACjB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAY,EAAE,CAAA;QAChG,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,UAAU,CAAE,IAAI,CAAC,KAAgB,CAAC,QAAQ,EAAE,CAAY,EAAE,CAAA;QAClG,KAAK,cAAc;YACjB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,KAAgB,EAAE,CAAA;QAC1D;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,SAAS,CAAC,CAAc,EAAE,CAAc;IACtD,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;QACjC,OAAO,MAAM,CAAA;IACf,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,IAAiB;IAC3D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAA;IACxC,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,iBAAiB,EAAE,CAAA;IACvC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;IACpC,IAAI,IAAI,KAAK,SAAS,IAAI,GAAG,IAAI,WAAW,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;QACnE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAA;IACrD,CAAC;IACD,IAAI,GAAG,IAAI,QAAQ,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;IAC1C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AAC/C,CAAC"}