solve-engine 2.25.0 → 2.27.0

package/dist/temporal.d.cts

@@ -0,0 +1,201 @@
+import { C as CalendarBackend, a as CalendarFields, Z as ZonedFields } from './CalendarBackend-MdS3Bb4P.cjs';
+
+/**
+ * The `Temporal` calendar backend: the engine's date questions answered
+ * through a `Temporal` implementation the host supplies, in a time zone the
+ * host chooses.
+ *
+ * `Temporal` is the JavaScript standard library's replacement for `Date`. It
+ * ships unflagged in Node 26 and in current Chrome, Firefox and Deno, but not
+ * in Safari nor in Node 22 and 24, and the smallest polyfill adds about twenty
+ * kilobytes gzipped to a bundle. The engine therefore imports no `Temporal`
+ * and no polyfill: this module is reached only through the
+ * `solve-engine/temporal` entry, and the host hands it the implementation to
+ * use, `globalThis.Temporal` on a runtime that has one or a polyfill's export.
+ * A host that never imports the entry pays nothing for it.
+ *
+ * The backend answers exactly what the `Date` backend answers. That is a
+ * design constraint rather than a hope: `Temporal` and `Date` differ in what
+ * they do with an out-of-range instant (`RangeError` against `NaN`), a
+ * fractional millisecond (a throw against truncation), a day past the end of
+ * a month (a clamp or a throw against a roll into the next month) and a year
+ * from 0 to 99 (read literally against read as the 1900s), and every one of
+ * those is reproduced here the way `Date` does it, because the engine's
+ * results are measured against `Date` and a host switching backends must see
+ * no result move. The differential suite under `__tests__/temporal/` is what
+ * holds that line.
+ *
+ * The one thing that does change is the zone. `Date` reads the process's own
+ * zone and nothing else; this backend reads the zone it was constructed with,
+ * so a document can be computed in Tokyo from a server in London, or in a
+ * zone the reader picks. That is the capability the backend adds, and the
+ * only observable difference.
+ *
+ * The named-zone display strings go through the same `Intl.DateTimeFormat`
+ * helpers the `Date` backend uses (`calendar/IntlZone.ts`), and the zone-free
+ * arithmetic through `calendar/Gregorian.ts`, so the two backends share one
+ * implementation wherever an answer does not depend on which backend is in
+ * use. The one piece of arithmetic `Date` keeps inside its own setters, the
+ * normalisation of overflowing fields, is written out in `CivilDays.ts`.
+ *
+ * @module TemporalCalendar
+ */
+
+/**
+ * The part of a `Temporal.Instant` the backend reads: its epoch milliseconds,
+ * and the zoned date-time it shows in a named zone.
+ */
+interface TemporalInstantLike {
+    readonly epochMilliseconds: number;
+    toZonedDateTimeISO(timeZone: string): TemporalZonedDateTimeLike;
+}
+/**
+ * The part of a `Temporal.ZonedDateTime` the backend reads: the calendar
+ * fields (a one-based month and an ISO weekday, Monday 1 to Sunday 7, both
+ * translated at the boundary), the offset, and the instant.
+ */
+interface TemporalZonedDateTimeLike {
+    readonly year: number;
+    /** One-based month, 1 is January, as `Temporal` counts. */
+    readonly month: number;
+    readonly day: number;
+    /** ISO weekday: Monday is 1, Sunday is 7. */
+    readonly dayOfWeek: number;
+    readonly hour: number;
+    readonly minute: number;
+    readonly second: number;
+    readonly millisecond: number;
+    /** The zone's offset from UTC at this instant, in nanoseconds, positive when ahead. */
+    readonly offsetNanoseconds: number;
+    readonly epochMilliseconds: number;
+    /** The zone's canonical IANA identifier. */
+    readonly timeZoneId: string;
+}
+/** The part of a `Temporal.PlainDateTime` the backend uses: resolving a wall-clock time to an instant in a zone. */
+interface TemporalPlainDateTimeLike {
+    toZonedDateTime(timeZone: string, options?: {
+        disambiguation?: "compatible" | "earlier" | "later" | "reject";
+    }): TemporalZonedDateTimeLike;
+}
+/** The wall-clock fields a `Temporal.PlainDateTime` is built from, with a one-based month. */
+interface TemporalDateTimeFields {
+    year: number;
+    /** One-based month, 1 is January. */
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    second: number;
+    millisecond: number;
+}
+/**
+ * The subset of the `Temporal` namespace the backend uses, as a structural
+ * type, so the engine compiles and ships with no `Temporal` type installed
+ * and a host passes whichever implementation it has: `globalThis.Temporal`
+ * on Node 26 or a current browser, or the export of a polyfill such as
+ * `temporal-polyfill`. Both satisfy this shape as they are.
+ */
+interface TemporalLike {
+    readonly Now: {
+        instant(): TemporalInstantLike;
+        timeZoneId(): string;
+    };
+    readonly Instant: {
+        fromEpochMilliseconds(epochMilliseconds: number): TemporalInstantLike;
+    };
+    readonly PlainDateTime: {
+        from(fields: TemporalDateTimeFields, options?: {
+            overflow?: "constrain" | "reject";
+        }): TemporalPlainDateTimeLike;
+    };
+}
+/** What {@link createTemporalCalendar} takes beside the implementation. */
+interface TemporalCalendarOptions {
+    /**
+     * The IANA time zone the engine computes dates in (`"Asia/Tokyo"`,
+     * `"UTC"`). Defaults to the runtime's own zone, `Temporal.Now.timeZoneId()`,
+     * which is what the `Date` backend reads. A zone the implementation does
+     * not know is refused at construction with `TEMPORAL_TIME_ZONE_UNKNOWN`.
+     */
+    timeZone?: string;
+    /**
+     * The clock `now()` reads, in epoch milliseconds. Defaults to
+     * `Temporal.Now.instant()`. A test pins a date with this: a fake-timer
+     * library replaces `Date.now`, which the `Date` backend reads, but not
+     * `Temporal.Now`, so this backend needs telling separately.
+     */
+    now?: () => number;
+}
+/**
+ * A {@link CalendarBackend} over a `Temporal` implementation, computing in
+ * one named time zone. Build one with {@link createTemporalCalendar}.
+ *
+ * Every method answers what the `Date` backend answers for the same inputs
+ * when the zone is the process's own; see the module comment for the
+ * differences between `Temporal` and `Date` that are reproduced deliberately.
+ * The local methods answer `NaN` for an instant or a date the backend cannot
+ * represent and never throw; the four named-zone methods throw the runtime's
+ * `RangeError` for a zone it does not know or an instant it cannot represent,
+ * which is the contract the interface states.
+ */
+declare class TemporalCalendar implements CalendarBackend {
+    /** The IANA zone every local answer is computed in, in its canonical spelling. */
+    readonly timeZone: string;
+    private readonly temporal;
+    private readonly clock;
+    constructor(temporal: TemporalLike, options?: TemporalCalendarOptions);
+    now(): number;
+    fields(epochMs: number): CalendarFields;
+    localMidnight(year: number, month0: number, day: number): number;
+    localWallClock(year: number, month0: number, day: number, minutesPastMidnight: number): number;
+    addDays(epochMs: number, days: number): number;
+    addMonths(epochMs: number, months: number): number;
+    utcOffsetMinutes(epochMs: number): number;
+    parseIso8601(text: string): number;
+    formatLongDate(epochMs: number, locale: string): string;
+    formatTimeOfDay(epochMs: number, locale: string): string;
+    zoneOffsetMinutes(zone: string, epochMs: number): number;
+    fieldsInZone(zone: string, epochMs: number): ZonedFields;
+    /** The IANA zone this backend computes in, which is what `CalendarBackend.zone` documents. */
+    zone(): string;
+    formatTimeInZone(zone: string, epochMs: number): string;
+    formatDateInZone(zone: string, epochMs: number): string;
+    /** The zoned date-time of an instant, or `null` where `Date` would answer `NaN`. */
+    private zoned;
+    /**
+     * The instant a set of local wall-clock fields names, with the fields
+     * normalised the way `Date`'s constructor and setters normalise them
+     * (month 12 is next January, day 0 the last of the month before, a year
+     * from 0 to 99 the 1900s) before the zone is consulted.
+     */
+    private wallClock;
+    /**
+     * Normalised wall-clock fields resolved to an instant in the backend's
+     * zone, clipped to the range `Date` represents only then, as `Date` clips
+     * last. `compatible` disambiguation is `Date`'s rule: a time in a
+     * spring-forward gap moves later by the gap, and a time that occurs twice
+     * on a fall-back day is its first occurrence.
+     */
+    private resolve;
+}
+/**
+ * A calendar backend over the host's `Temporal`, for the engine's `calendar`
+ * option.
+ *
+ * ```ts
+ * import { createEngine } from "solve-engine";
+ * import { createTemporalCalendar } from "solve-engine/temporal";
+ *
+ * const calendar = createTemporalCalendar(globalThis.Temporal, { timeZone: "Asia/Tokyo" });
+ * const engine = createEngine({ calendar });
+ * ```
+ *
+ * @param temporal - The `Temporal` implementation: `globalThis.Temporal` where the runtime ships one, or a polyfill's export.
+ * @param options - The zone to compute in and, for a test, the clock to read; see {@link TemporalCalendarOptions}.
+ * @returns A backend that computes every date in that zone and answers what the `Date` backend would in it.
+ * @throws `TEMPORAL_IMPLEMENTATION_INVALID` when `temporal` lacks the members the backend uses, and
+ *   `TEMPORAL_TIME_ZONE_UNKNOWN` when the implementation does not know the zone asked for.
+ */
+declare function createTemporalCalendar(temporal: TemporalLike, options?: TemporalCalendarOptions): TemporalCalendar;
+
+export { CalendarBackend, CalendarFields, TemporalCalendar, type TemporalCalendarOptions, type TemporalDateTimeFields, type TemporalInstantLike, type TemporalLike, type TemporalPlainDateTimeLike, type TemporalZonedDateTimeLike, ZonedFields, createTemporalCalendar };

package/dist/temporal.d.ts

@@ -0,0 +1,201 @@
+import { C as CalendarBackend, a as CalendarFields, Z as ZonedFields } from './CalendarBackend-MdS3Bb4P.js';
+
+/**
+ * The `Temporal` calendar backend: the engine's date questions answered
+ * through a `Temporal` implementation the host supplies, in a time zone the
+ * host chooses.
+ *
+ * `Temporal` is the JavaScript standard library's replacement for `Date`. It
+ * ships unflagged in Node 26 and in current Chrome, Firefox and Deno, but not
+ * in Safari nor in Node 22 and 24, and the smallest polyfill adds about twenty
+ * kilobytes gzipped to a bundle. The engine therefore imports no `Temporal`
+ * and no polyfill: this module is reached only through the
+ * `solve-engine/temporal` entry, and the host hands it the implementation to
+ * use, `globalThis.Temporal` on a runtime that has one or a polyfill's export.
+ * A host that never imports the entry pays nothing for it.
+ *
+ * The backend answers exactly what the `Date` backend answers. That is a
+ * design constraint rather than a hope: `Temporal` and `Date` differ in what
+ * they do with an out-of-range instant (`RangeError` against `NaN`), a
+ * fractional millisecond (a throw against truncation), a day past the end of
+ * a month (a clamp or a throw against a roll into the next month) and a year
+ * from 0 to 99 (read literally against read as the 1900s), and every one of
+ * those is reproduced here the way `Date` does it, because the engine's
+ * results are measured against `Date` and a host switching backends must see
+ * no result move. The differential suite under `__tests__/temporal/` is what
+ * holds that line.
+ *
+ * The one thing that does change is the zone. `Date` reads the process's own
+ * zone and nothing else; this backend reads the zone it was constructed with,
+ * so a document can be computed in Tokyo from a server in London, or in a
+ * zone the reader picks. That is the capability the backend adds, and the
+ * only observable difference.
+ *
+ * The named-zone display strings go through the same `Intl.DateTimeFormat`
+ * helpers the `Date` backend uses (`calendar/IntlZone.ts`), and the zone-free
+ * arithmetic through `calendar/Gregorian.ts`, so the two backends share one
+ * implementation wherever an answer does not depend on which backend is in
+ * use. The one piece of arithmetic `Date` keeps inside its own setters, the
+ * normalisation of overflowing fields, is written out in `CivilDays.ts`.
+ *
+ * @module TemporalCalendar
+ */
+
+/**
+ * The part of a `Temporal.Instant` the backend reads: its epoch milliseconds,
+ * and the zoned date-time it shows in a named zone.
+ */
+interface TemporalInstantLike {
+    readonly epochMilliseconds: number;
+    toZonedDateTimeISO(timeZone: string): TemporalZonedDateTimeLike;
+}
+/**
+ * The part of a `Temporal.ZonedDateTime` the backend reads: the calendar
+ * fields (a one-based month and an ISO weekday, Monday 1 to Sunday 7, both
+ * translated at the boundary), the offset, and the instant.
+ */
+interface TemporalZonedDateTimeLike {
+    readonly year: number;
+    /** One-based month, 1 is January, as `Temporal` counts. */
+    readonly month: number;
+    readonly day: number;
+    /** ISO weekday: Monday is 1, Sunday is 7. */
+    readonly dayOfWeek: number;
+    readonly hour: number;
+    readonly minute: number;
+    readonly second: number;
+    readonly millisecond: number;
+    /** The zone's offset from UTC at this instant, in nanoseconds, positive when ahead. */
+    readonly offsetNanoseconds: number;
+    readonly epochMilliseconds: number;
+    /** The zone's canonical IANA identifier. */
+    readonly timeZoneId: string;
+}
+/** The part of a `Temporal.PlainDateTime` the backend uses: resolving a wall-clock time to an instant in a zone. */
+interface TemporalPlainDateTimeLike {
+    toZonedDateTime(timeZone: string, options?: {
+        disambiguation?: "compatible" | "earlier" | "later" | "reject";
+    }): TemporalZonedDateTimeLike;
+}
+/** The wall-clock fields a `Temporal.PlainDateTime` is built from, with a one-based month. */
+interface TemporalDateTimeFields {
+    year: number;
+    /** One-based month, 1 is January. */
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    second: number;
+    millisecond: number;
+}
+/**
+ * The subset of the `Temporal` namespace the backend uses, as a structural
+ * type, so the engine compiles and ships with no `Temporal` type installed
+ * and a host passes whichever implementation it has: `globalThis.Temporal`
+ * on Node 26 or a current browser, or the export of a polyfill such as
+ * `temporal-polyfill`. Both satisfy this shape as they are.
+ */
+interface TemporalLike {
+    readonly Now: {
+        instant(): TemporalInstantLike;
+        timeZoneId(): string;
+    };
+    readonly Instant: {
+        fromEpochMilliseconds(epochMilliseconds: number): TemporalInstantLike;
+    };
+    readonly PlainDateTime: {
+        from(fields: TemporalDateTimeFields, options?: {
+            overflow?: "constrain" | "reject";
+        }): TemporalPlainDateTimeLike;
+    };
+}
+/** What {@link createTemporalCalendar} takes beside the implementation. */
+interface TemporalCalendarOptions {
+    /**
+     * The IANA time zone the engine computes dates in (`"Asia/Tokyo"`,
+     * `"UTC"`). Defaults to the runtime's own zone, `Temporal.Now.timeZoneId()`,
+     * which is what the `Date` backend reads. A zone the implementation does
+     * not know is refused at construction with `TEMPORAL_TIME_ZONE_UNKNOWN`.
+     */
+    timeZone?: string;
+    /**
+     * The clock `now()` reads, in epoch milliseconds. Defaults to
+     * `Temporal.Now.instant()`. A test pins a date with this: a fake-timer
+     * library replaces `Date.now`, which the `Date` backend reads, but not
+     * `Temporal.Now`, so this backend needs telling separately.
+     */
+    now?: () => number;
+}
+/**
+ * A {@link CalendarBackend} over a `Temporal` implementation, computing in
+ * one named time zone. Build one with {@link createTemporalCalendar}.
+ *
+ * Every method answers what the `Date` backend answers for the same inputs
+ * when the zone is the process's own; see the module comment for the
+ * differences between `Temporal` and `Date` that are reproduced deliberately.
+ * The local methods answer `NaN` for an instant or a date the backend cannot
+ * represent and never throw; the four named-zone methods throw the runtime's
+ * `RangeError` for a zone it does not know or an instant it cannot represent,
+ * which is the contract the interface states.
+ */
+declare class TemporalCalendar implements CalendarBackend {
+    /** The IANA zone every local answer is computed in, in its canonical spelling. */
+    readonly timeZone: string;
+    private readonly temporal;
+    private readonly clock;
+    constructor(temporal: TemporalLike, options?: TemporalCalendarOptions);
+    now(): number;
+    fields(epochMs: number): CalendarFields;
+    localMidnight(year: number, month0: number, day: number): number;
+    localWallClock(year: number, month0: number, day: number, minutesPastMidnight: number): number;
+    addDays(epochMs: number, days: number): number;
+    addMonths(epochMs: number, months: number): number;
+    utcOffsetMinutes(epochMs: number): number;
+    parseIso8601(text: string): number;
+    formatLongDate(epochMs: number, locale: string): string;
+    formatTimeOfDay(epochMs: number, locale: string): string;
+    zoneOffsetMinutes(zone: string, epochMs: number): number;
+    fieldsInZone(zone: string, epochMs: number): ZonedFields;
+    /** The IANA zone this backend computes in, which is what `CalendarBackend.zone` documents. */
+    zone(): string;
+    formatTimeInZone(zone: string, epochMs: number): string;
+    formatDateInZone(zone: string, epochMs: number): string;
+    /** The zoned date-time of an instant, or `null` where `Date` would answer `NaN`. */
+    private zoned;
+    /**
+     * The instant a set of local wall-clock fields names, with the fields
+     * normalised the way `Date`'s constructor and setters normalise them
+     * (month 12 is next January, day 0 the last of the month before, a year
+     * from 0 to 99 the 1900s) before the zone is consulted.
+     */
+    private wallClock;
+    /**
+     * Normalised wall-clock fields resolved to an instant in the backend's
+     * zone, clipped to the range `Date` represents only then, as `Date` clips
+     * last. `compatible` disambiguation is `Date`'s rule: a time in a
+     * spring-forward gap moves later by the gap, and a time that occurs twice
+     * on a fall-back day is its first occurrence.
+     */
+    private resolve;
+}
+/**
+ * A calendar backend over the host's `Temporal`, for the engine's `calendar`
+ * option.
+ *
+ * ```ts
+ * import { createEngine } from "solve-engine";
+ * import { createTemporalCalendar } from "solve-engine/temporal";
+ *
+ * const calendar = createTemporalCalendar(globalThis.Temporal, { timeZone: "Asia/Tokyo" });
+ * const engine = createEngine({ calendar });
+ * ```
+ *
+ * @param temporal - The `Temporal` implementation: `globalThis.Temporal` where the runtime ships one, or a polyfill's export.
+ * @param options - The zone to compute in and, for a test, the clock to read; see {@link TemporalCalendarOptions}.
+ * @returns A backend that computes every date in that zone and answers what the `Date` backend would in it.
+ * @throws `TEMPORAL_IMPLEMENTATION_INVALID` when `temporal` lacks the members the backend uses, and
+ *   `TEMPORAL_TIME_ZONE_UNKNOWN` when the implementation does not know the zone asked for.
+ */
+declare function createTemporalCalendar(temporal: TemporalLike, options?: TemporalCalendarOptions): TemporalCalendar;
+
+export { CalendarBackend, CalendarFields, TemporalCalendar, type TemporalCalendarOptions, type TemporalDateTimeFields, type TemporalInstantLike, type TemporalLike, type TemporalPlainDateTimeLike, type TemporalZonedDateTimeLike, ZonedFields, createTemporalCalendar };

package/dist/temporal.js

@@ -0,0 +1,2 @@
+export{a as TemporalCalendar,b as createTemporalCalendar}from'./chunk-D4VBWPWN.js';import'./chunk-J4K72CQN.js';import'./chunk-VB6QMU2W.js';//# sourceMappingURL=temporal.js.map
+//# sourceMappingURL=temporal.js.map

package/dist/temporal.js.map

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

package/dist/testing.cjs

@@ -1,4 +1,4 @@
-'use strict';var chunkSPOVFRZO_cjs=require('./chunk-SPOVFRZO.cjs');require('./chunk-VMSCRVNX.cjs'),require('./chunk-NGBBNL4K.cjs'),require('./chunk-ZVPZQ66D.cjs'),require('./chunk-TTFO4YDP.cjs'),require('./chunk-JSM3O7EM.cjs'),require('./chunk-HG4NPDN5.cjs'),require('./chunk-XBGK3TTU.cjs'),require('./chunk-R2SZFJTT.cjs');var chunkUV3EUIBT_cjs=require('./chunk-UV3EUIBT.cjs');require('./chunk-NEGZZB7F.cjs'),require('./chunk-RAPEZR5L.cjs'),require('./chunk-FYTB7SDP.cjs'),require('./chunk-GBCN7FNV.cjs'),require('./chunk-UURM7P3P.cjs'),require('./chunk-ZLRJ7TDP.cjs'),require('./chunk-634ILVMP.cjs'),require('./chunk-FYAMQFZZ.cjs'),require('./chunk-ABVDKMNF.cjs'),require('./chunk-TLG7VZRX.cjs'),require('./chunk-5TVI2UPZ.cjs'),require('./chunk-WGP4UUO5.cjs');var chunkSQHBOWES_cjs=require('./chunk-SQHBOWES.cjs');require('./chunk-ZKFCKAIX.cjs');var chunk4NZXCHQL_cjs=require('./chunk-4NZXCHQL.cjs');require('./chunk-BMXYR5LI.cjs'),require('./chunk-Y7O4D3BJ.cjs'),require('./chunk-77KI7AKJ.cjs'),require('./chunk-5IJD5L3O.cjs'),require('./chunk-S3DFU33X.cjs'),require('./chunk-J4LSAHCY.cjs'),require('./chunk-EZKR44MA.cjs');var chunkYBQPEWT7_cjs=require('./chunk-YBQPEWT7.cjs');var i=class o extends Error{constructor(t){super(t.message),this.name="ExpectationError",this.code=t.code,this.expected=t.expected,this.actual=t.actual,Object.setPrototypeOf(this,o.prototype);}};function V(o=[],t={}){let{locale:e="en",includeBuiltins:r=true}=t,s=new chunkSPOVFRZO_cjs.n({locale:e,packages:r?chunkUV3EUIBT_cjs.z:[]});for(let a of o)s.registerPackage(a);return s}function v(o,t){try{let e=o.evaluateExpression(t);return e.isError()?{status:"error",code:e.errorCode??"",message:e.errorMessage??"",source:e}:e.isPending()?{status:"pending",value:e}:{status:"value",value:e}}catch(e){if(e instanceof chunkYBQPEWT7_cjs.b)return {status:"error",code:e.code,message:e.message,source:e};let r=e instanceof Error?e.message:String(e);return {status:"error",code:"UNKNOWN_ERROR",message:r,source:new chunkSQHBOWES_cjs.m(13,"UNKNOWN_ERROR",r)}}}function x(o,t){if(Object.is(o,t))return  true;if(!Number.isFinite(o)||!Number.isFinite(t))return  false;let e=1e-9*Math.max(1,Math.abs(o),Math.abs(t));return Math.abs(o-t)<=e}function l(o){return o.type===3?JSON.stringify(o.value):o.type===6&&typeof o.unit=="string"?`${String(o.value)} ${o.unit}`:String(o.value)}function n(o){switch(o.status){case "value":return l(o.value);case "pending":return "a pending async value";case "error":return `an error (${o.code}: ${o.message})`}}var d=class{constructor(t,e){this.expression=t;this.outcome=e;}get value(){if(this.outcome.status==="error")throw new i({code:"EXPECTED_VALUE",message:`Expected "${this.expression}" to evaluate, but it failed with ${n(this.outcome)}.`,expected:"a resolved value",actual:n(this.outcome)});return this.outcome.value}toEvaluate(){if(this.outcome.status!=="value")throw new i({code:"EXPECTED_EVALUATE",message:`Expected "${this.expression}" to evaluate to a value, but got ${n(this.outcome)}.`,expected:"a resolved value",actual:n(this.outcome)});return this}toEqual(t,e){if(this.outcome.status!=="value")throw new i({code:"EXPECTED_EQUAL",message:`Expected "${this.expression}" to equal ${c(t,e)}, but got ${n(this.outcome)}.`,expected:c(t,e),actual:n(this.outcome)});let r=this.outcome.value,s;if(typeof t=="number"?s=x(r.toNumber(),t):typeof t=="boolean"?s=r.type===10&&r.value===t:s=C(r)===t,!s)throw new i({code:"EXPECTED_EQUAL",message:`Expected "${this.expression}" to equal ${c(t,e)}, but it was ${l(r)}.`,expected:c(t,e),actual:l(r)});if(e!==void 0&&r.unit!==e)throw new i({code:"EXPECTED_UNIT",message:`Expected "${this.expression}" to carry the unit "${e}", but it was ${r.unit===void 0?"unitless":`"${r.unit}"`}.`,expected:`unit "${e}"`,actual:r.unit===void 0?"no unit":`unit "${r.unit}"`});return this}toBeError(){if(this.outcome.status!=="error")throw new i({code:"EXPECTED_ERROR",message:`Expected "${this.expression}" to fail, but it produced ${n(this.outcome)}.`,expected:"an error",actual:n(this.outcome)});return this}toFailWith(t){if(this.outcome.status!=="error")throw new i({code:"EXPECTED_FAIL_WITH",message:`Expected "${this.expression}" to fail with "${t}", but it produced ${n(this.outcome)}.`,expected:`error code "${t}"`,actual:n(this.outcome)});if(this.outcome.code!==t)throw new i({code:"EXPECTED_FAIL_WITH",message:`Expected "${this.expression}" to fail with "${t}", but it failed with "${this.outcome.code}" (${this.outcome.message}).`,expected:`error code "${t}"`,actual:`error code "${this.outcome.code}"`});return this}toBePending(){if(this.outcome.status!=="pending")throw new i({code:"EXPECTED_PENDING",message:`Expected "${this.expression}" to be pending, but got ${n(this.outcome)}.`,expected:"a pending async value",actual:n(this.outcome)});return this}};function c(o,t){let e=typeof o=="string"?JSON.stringify(o):String(o);return t===void 0?e:`${e} ${t}`}function C(o){return String(o.value)}function D(o,t){return new d(t,v(o,t))}var O=["a","an","and","or","but","if","then","the","this","that","these","those","in","on","at","to","of","for","from","with","by","as","per","into","over","is","are","was","were","be","been","being","do","does","did","have","has","had","will","would","can","could","should","may","might","must","price","cost","value","total","sum","count","rate","amount","number","time","date","day","week","month","year","hour","minute","second","add","buy","sell","hold","make","take","give","get","set","run","up","down","out","off","all","some","any","no","not","more","less","one","two","three","first","last","next","each","every","here","there"],$=["error","warning","info"];function k(o){let t=[],e=o.lexerVocabulary;if(e?.keywords)for(let[r,s]of Object.entries(e.keywords))t.push({word:r,via:"keyword",tokenType:s});if(e?.units)for(let r of e.units)t.push({word:r,via:"unit"});if(e?.operators)for(let[r,s]of Object.entries(e.operators))t.push({word:r,via:"operator",tokenType:s});if(o.phrases)for(let[r,s]of Object.entries(o.phrases))r.includes(" ")||t.push({word:r,via:"phrase",tokenType:s});return t}var p=class{constructor(t){this.pkg=t;}notToShadow(t=O){let e=new Set(t.map(s=>s.toLowerCase())),r=k(this.pkg).filter(s=>e.has(s.word.toLowerCase()));if(r.length>0){let s=r.map(a=>`"${a.word}" (${a.via})`).join(", ");throw new i({code:"PACKAGE_SHADOWS_PROSE",message:`Package "${this.pkg.name}" claims prose word(s) as syntax: ${s}. A word that is also ordinary English turns prose into arithmetic; prefer a multi-word phrase or a form that requires a parenthesis.`,expected:"no prose words claimed as syntax",actual:s})}return r}notToCollideWith(t,e="error"){let r=chunkSPOVFRZO_cjs.a(this.pkg,t),s=$.indexOf(e),a=r.conflicts.filter(u=>$.indexOf(u.severity)<=s);if(a.length>0){let u=a.map(g=>`[${g.severity}] ${g.detail}`).join(`
+'use strict';var chunkYSHWNCDH_cjs=require('./chunk-YSHWNCDH.cjs');require('./chunk-2SYYKQ4Q.cjs'),require('./chunk-NGBBNL4K.cjs'),require('./chunk-ZVPZQ66D.cjs'),require('./chunk-TTFO4YDP.cjs'),require('./chunk-GVL3ZMS7.cjs'),require('./chunk-HG4NPDN5.cjs'),require('./chunk-AZX4NTYN.cjs'),require('./chunk-R2SZFJTT.cjs');var chunkDFMAZ6XM_cjs=require('./chunk-DFMAZ6XM.cjs');require('./chunk-G2V33LFM.cjs'),require('./chunk-7RC6RBS6.cjs'),require('./chunk-ZDJTDFTR.cjs'),require('./chunk-ZSLVLMO5.cjs'),require('./chunk-UURM7P3P.cjs'),require('./chunk-ZLRJ7TDP.cjs'),require('./chunk-QQHHZPEW.cjs'),require('./chunk-ZE5KKMBV.cjs'),require('./chunk-TMQ37JQY.cjs'),require('./chunk-ABVDKMNF.cjs'),require('./chunk-TLG7VZRX.cjs'),require('./chunk-5TVI2UPZ.cjs'),require('./chunk-FDKTESBC.cjs'),require('./chunk-TPPM4QSS.cjs'),require('./chunk-E4HAKNBQ.cjs');var chunkGJZIJK2Q_cjs=require('./chunk-GJZIJK2Q.cjs');require('./chunk-ZKFCKAIX.cjs');var chunkO5PO4D2A_cjs=require('./chunk-O5PO4D2A.cjs');require('./chunk-CQLCTKMX.cjs'),require('./chunk-Y7O4D3BJ.cjs'),require('./chunk-6EYKVQT3.cjs'),require('./chunk-YBQOQTVL.cjs'),require('./chunk-S3DFU33X.cjs'),require('./chunk-J4LSAHCY.cjs'),require('./chunk-EZKR44MA.cjs');var chunkGXO7TSXQ_cjs=require('./chunk-GXO7TSXQ.cjs');var i=class o extends Error{constructor(t){super(t.message),this.name="ExpectationError",this.code=t.code,this.expected=t.expected,this.actual=t.actual,Object.setPrototypeOf(this,o.prototype);}};function V(o=[],t={}){let{locale:e="en",includeBuiltins:r=true}=t,s=new chunkYSHWNCDH_cjs.n({locale:e,packages:r?chunkDFMAZ6XM_cjs.z:[]});for(let a of o)s.registerPackage(a);return s}function v(o,t){try{let e=o.evaluateExpression(t);return e.isError()?{status:"error",code:e.errorCode??"",message:e.errorMessage??"",source:e}:e.isPending()?{status:"pending",value:e}:{status:"value",value:e}}catch(e){if(e instanceof chunkGXO7TSXQ_cjs.b)return {status:"error",code:e.code,message:e.message,source:e};let r=e instanceof Error?e.message:String(e);return {status:"error",code:"UNKNOWN_ERROR",message:r,source:new chunkGJZIJK2Q_cjs.m(13,"UNKNOWN_ERROR",r)}}}function x(o,t){if(Object.is(o,t))return  true;if(!Number.isFinite(o)||!Number.isFinite(t))return  false;let e=1e-9*Math.max(1,Math.abs(o),Math.abs(t));return Math.abs(o-t)<=e}function l(o){return o.type===3?JSON.stringify(o.value):o.type===6&&typeof o.unit=="string"?`${String(o.value)} ${o.unit}`:String(o.value)}function n(o){switch(o.status){case "value":return l(o.value);case "pending":return "a pending async value";case "error":return `an error (${o.code}: ${o.message})`}}var d=class{constructor(t,e){this.expression=t;this.outcome=e;}get value(){if(this.outcome.status==="error")throw new i({code:"EXPECTED_VALUE",message:`Expected "${this.expression}" to evaluate, but it failed with ${n(this.outcome)}.`,expected:"a resolved value",actual:n(this.outcome)});return this.outcome.value}toEvaluate(){if(this.outcome.status!=="value")throw new i({code:"EXPECTED_EVALUATE",message:`Expected "${this.expression}" to evaluate to a value, but got ${n(this.outcome)}.`,expected:"a resolved value",actual:n(this.outcome)});return this}toEqual(t,e){if(this.outcome.status!=="value")throw new i({code:"EXPECTED_EQUAL",message:`Expected "${this.expression}" to equal ${c(t,e)}, but got ${n(this.outcome)}.`,expected:c(t,e),actual:n(this.outcome)});let r=this.outcome.value,s;if(typeof t=="number"?s=x(r.toNumber(),t):typeof t=="boolean"?s=r.type===10&&r.value===t:s=C(r)===t,!s)throw new i({code:"EXPECTED_EQUAL",message:`Expected "${this.expression}" to equal ${c(t,e)}, but it was ${l(r)}.`,expected:c(t,e),actual:l(r)});if(e!==void 0&&r.unit!==e)throw new i({code:"EXPECTED_UNIT",message:`Expected "${this.expression}" to carry the unit "${e}", but it was ${r.unit===void 0?"unitless":`"${r.unit}"`}.`,expected:`unit "${e}"`,actual:r.unit===void 0?"no unit":`unit "${r.unit}"`});return this}toBeError(){if(this.outcome.status!=="error")throw new i({code:"EXPECTED_ERROR",message:`Expected "${this.expression}" to fail, but it produced ${n(this.outcome)}.`,expected:"an error",actual:n(this.outcome)});return this}toFailWith(t){if(this.outcome.status!=="error")throw new i({code:"EXPECTED_FAIL_WITH",message:`Expected "${this.expression}" to fail with "${t}", but it produced ${n(this.outcome)}.`,expected:`error code "${t}"`,actual:n(this.outcome)});if(this.outcome.code!==t)throw new i({code:"EXPECTED_FAIL_WITH",message:`Expected "${this.expression}" to fail with "${t}", but it failed with "${this.outcome.code}" (${this.outcome.message}).`,expected:`error code "${t}"`,actual:`error code "${this.outcome.code}"`});return this}toBePending(){if(this.outcome.status!=="pending")throw new i({code:"EXPECTED_PENDING",message:`Expected "${this.expression}" to be pending, but got ${n(this.outcome)}.`,expected:"a pending async value",actual:n(this.outcome)});return this}};function c(o,t){let e=typeof o=="string"?JSON.stringify(o):String(o);return t===void 0?e:`${e} ${t}`}function C(o){return String(o.value)}function D(o,t){return new d(t,v(o,t))}var O=["a","an","and","or","but","if","then","the","this","that","these","those","in","on","at","to","of","for","from","with","by","as","per","into","over","is","are","was","were","be","been","being","do","does","did","have","has","had","will","would","can","could","should","may","might","must","price","cost","value","total","sum","count","rate","amount","number","time","date","day","week","month","year","hour","minute","second","add","buy","sell","hold","make","take","give","get","set","run","up","down","out","off","all","some","any","no","not","more","less","one","two","three","first","last","next","each","every","here","there"],$=["error","warning","info"];function k(o){let t=[],e=o.lexerVocabulary;if(e?.keywords)for(let[r,s]of Object.entries(e.keywords))t.push({word:r,via:"keyword",tokenType:s});if(e?.units)for(let r of e.units)t.push({word:r,via:"unit"});if(e?.operators)for(let[r,s]of Object.entries(e.operators))t.push({word:r,via:"operator",tokenType:s});if(o.phrases)for(let[r,s]of Object.entries(o.phrases))r.includes(" ")||t.push({word:r,via:"phrase",tokenType:s});return t}var p=class{constructor(t){this.pkg=t;}notToShadow(t=O){let e=new Set(t.map(s=>s.toLowerCase())),r=k(this.pkg).filter(s=>e.has(s.word.toLowerCase()));if(r.length>0){let s=r.map(a=>`"${a.word}" (${a.via})`).join(", ");throw new i({code:"PACKAGE_SHADOWS_PROSE",message:`Package "${this.pkg.name}" claims prose word(s) as syntax: ${s}. A word that is also ordinary English turns prose into arithmetic; prefer a multi-word phrase or a form that requires a parenthesis.`,expected:"no prose words claimed as syntax",actual:s})}return r}notToCollideWith(t,e="error"){let r=chunkYSHWNCDH_cjs.a(this.pkg,t),s=$.indexOf(e),a=r.conflicts.filter(u=>$.indexOf(u.severity)<=s);if(a.length>0){let u=a.map(g=>`[${g.severity}] ${g.detail}`).join(`
 `);throw new i({code:"PACKAGE_VOCABULARY_COLLISION",message:`Package "${this.pkg.name}" collides with another package:
-${u}`,expected:`no conflicts at or above "${e}" severity`,actual:`${a.length} conflict(s)`})}return r}toDeclareCompatibleEngineVersion(t=chunk4NZXCHQL_cjs.a){let e=chunkSPOVFRZO_cjs.b(this.pkg,t);if(!e.compatible){let r=e.reason==="invalid-range"?`its range "${e.declaredRange}" is not valid semver`:`its range "${e.declaredRange}" is not satisfied by engine version "${e.engineVersion}"`;throw new i({code:"PACKAGE_ENGINE_VERSION_INCOMPATIBLE",message:`Package "${this.pkg.name}" declares an engineVersion that will be rejected at registration: ${r}.`,expected:`an engineVersion satisfied by "${t}"`,actual:`"${e.declaredRange}"`})}return this}};function L(o){return new p(o)}exports.COMMON_PROSE_WORDS=O;exports.ExpectationError=i;exports.ExpressionAssertion=d;exports.PackageAssertion=p;exports.createTestEngine=V;exports.expectExpression=D;exports.expectPackage=L;//# sourceMappingURL=testing.cjs.map
+${u}`,expected:`no conflicts at or above "${e}" severity`,actual:`${a.length} conflict(s)`})}return r}toDeclareCompatibleEngineVersion(t=chunkO5PO4D2A_cjs.a){let e=chunkYSHWNCDH_cjs.b(this.pkg,t);if(!e.compatible){let r=e.reason==="invalid-range"?`its range "${e.declaredRange}" is not valid semver`:`its range "${e.declaredRange}" is not satisfied by engine version "${e.engineVersion}"`;throw new i({code:"PACKAGE_ENGINE_VERSION_INCOMPATIBLE",message:`Package "${this.pkg.name}" declares an engineVersion that will be rejected at registration: ${r}.`,expected:`an engineVersion satisfied by "${t}"`,actual:`"${e.declaredRange}"`})}return this}};function L(o){return new p(o)}exports.COMMON_PROSE_WORDS=O;exports.ExpectationError=i;exports.ExpressionAssertion=d;exports.PackageAssertion=p;exports.createTestEngine=V;exports.expectExpression=D;exports.expectPackage=L;//# sourceMappingURL=testing.cjs.map
 //# sourceMappingURL=testing.cjs.map