solve-engine 2.24.0 → 2.26.0

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 chunkRECRD45C_cjs=require('./chunk-RECRD45C.cjs');require('./chunk-S46R5QZP.cjs'),require('./chunk-NGBBNL4K.cjs'),require('./chunk-ZVPZQ66D.cjs'),require('./chunk-TTFO4YDP.cjs'),require('./chunk-RMCN5WFO.cjs'),require('./chunk-HG4NPDN5.cjs'),require('./chunk-F7QIBC4B.cjs'),require('./chunk-R2SZFJTT.cjs');var chunk2JSNWYYA_cjs=require('./chunk-2JSNWYYA.cjs');require('./chunk-RN3ISTM3.cjs'),require('./chunk-LTJV3VJE.cjs'),require('./chunk-5GL4SAVH.cjs'),require('./chunk-72N3ZRVE.cjs'),require('./chunk-UURM7P3P.cjs'),require('./chunk-ZLRJ7TDP.cjs'),require('./chunk-AUOE7MFI.cjs'),require('./chunk-MWWAKZOD.cjs'),require('./chunk-ABVDKMNF.cjs'),require('./chunk-TLG7VZRX.cjs'),require('./chunk-5TVI2UPZ.cjs'),require('./chunk-2VE4OW4A.cjs');var chunkDA7M6H63_cjs=require('./chunk-DA7M6H63.cjs');require('./chunk-ZKFCKAIX.cjs');var chunkUY3ID6JF_cjs=require('./chunk-UY3ID6JF.cjs');require('./chunk-IHAZL4EF.cjs'),require('./chunk-Y7O4D3BJ.cjs'),require('./chunk-UPH22K2T.cjs'),require('./chunk-5IJD5L3O.cjs'),require('./chunk-S3DFU33X.cjs'),require('./chunk-J4LSAHCY.cjs'),require('./chunk-EZKR44MA.cjs');var chunkELQQKZN3_cjs=require('./chunk-ELQQKZN3.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 chunkRECRD45C_cjs.n({locale:e,packages:r?chunk2JSNWYYA_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 chunkELQQKZN3_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 chunkDA7M6H63_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=chunkRECRD45C_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 chunkCQY23OF5_cjs=require('./chunk-CQY23OF5.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 chunkOPKJ2WWB_cjs=require('./chunk-OPKJ2WWB.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 chunkYS2OW75C_cjs=require('./chunk-YS2OW75C.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 chunkCQY23OF5_cjs.n({locale:e,packages:r?chunkOPKJ2WWB_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=chunkCQY23OF5_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=chunkUY3ID6JF_cjs.a){let e=chunkRECRD45C_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=chunkYS2OW75C_cjs.a){let e=chunkCQY23OF5_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

package/dist/testing.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/testing/index.ts"],"names":["ExpectationError","_ExpectationError","init","createTestEngine","packages","options","locale","includeBuiltins","engine","ExpressionEngine","BUILTIN_PACKAGES","pkg","evaluate","expression","value","error","EngineError","message","Value","numbersEqual","a","b","epsilon","describeValue","describeOutcome","outcome","ExpressionAssertion","expected","unit","describeExpected","matches","valueToComparableString","code","base","expectExpression","COMMON_PROSE_WORDS","SEVERITY_ORDER","claimedWords","claimed","vocab","word","tokenType","phrase","PackageAssertion","words","prose","w","shadowed","c","list","s","others","strictness","report","checkPackageCompatibility","threshold","failing","engineVersion","ENGINE_VERSION","result","checkEngineVersionCompatibility","detail","expectPackage"],"mappings":"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","file":"testing.cjs","sourcesContent":["/**\n * A test kit for package authors, the supported way to test a package by the\n * expressions it enables rather than by the opcodes it emits.\n *\n * Before this entry point a package author had two options, both bad: reach\n * into engine internals, or assert on whatever bytecode a parselet happened to\n * emit. The first is unstable across engine versions, the second pins the\n * implementation instead of the behaviour, so a refactor that keeps every\n * answer correct still breaks the tests. This module is a thin, dependency-free\n * layer over the same public surface a host uses: it constructs an\n * {@link ExpressionEngine} with the given packages and evaluates strings.\n *\n * It speaks in expressions. {@link expectExpression} evaluates a string and\n * asserts on the result or the failure code; {@link expectPackage} asserts on\n * the three mistakes a package actually makes (shadowing prose, colliding with\n * another package's vocabulary, and declaring an `engineVersion` range that the\n * running engine does not satisfy).\n *\n * Framework-agnostic on purpose. Nothing here imports jest, vitest or any\n * runner: an assertion that fails throws an {@link ExpectationError}, and one\n * that passes returns, so the kit drops into whatever runner the author already\n * has (or into a plain script, or `node:assert`). Runtime dependency-free and\n * side-effect free, so `solve-engine/testing` stays honest under the package's\n * `\"sideEffects\": false` contract.\n *\n * @example\n * ```ts\n * import { createTestEngine, expectExpression } from \"solve-engine/testing\";\n *\n * const engine = createTestEngine([myPackage]);\n * expectExpression(engine, \"2 gp + 3 gp\").toEqual(5, \"gp\");\n * expectExpression(engine, \"gp\").toFailWith(\"UNDEFINED_VARIABLE\");\n * ```\n */\n\nimport { ExpressionEngine } from \"@solve-js/engine/ExpressionEngine\";\nimport { BUILTIN_PACKAGES } from \"@solve-js/packages/builtins\";\nimport type { IEnginePackage } from \"@solve-js/api/PackageRegistry\";\nimport { Value, ValueType } from \"@solve-js/vm/Value\";\nimport { EngineError } from \"@solve-js/errors/EngineError\";\nimport {\n\tcheckPackageCompatibility,\n\ttype CompatibilityReport,\n\ttype CompatibilityConflict,\n\ttype CompatibilitySeverity,\n} from \"@solve-js/api/PackageCompatibility\";\nimport { checkEngineVersionCompatibility } from \"@solve-js/api/EngineVersionCompatibility\";\nimport { ENGINE_VERSION } from \"@solve-js/constants/version\";\n\n//#region Errors\n\n/**\n * The failure a matcher throws when an expectation is not met.\n *\n * A dedicated `Error` subclass rather than a bare `throw new Error`, so a\n * caller (or a reporter) can tell a kit assertion failure apart from an\n * unrelated exception with `instanceof`, and so the structured `expected` and\n * `actual` fields survive alongside the human-readable message. This is NOT an\n * {@link EngineError}: that type classifies pipeline-stage failures inside the\n * engine, whereas this classifies a test-assertion mismatch, a different\n * concern that would be miscategorised under any of `EngineError`'s categories.\n */\nexport class ExpectationError extends Error {\n\t/** A short, machine-readable label for which expectation failed. */\n\treadonly code: string;\n\t/** What the matcher was told to expect, in plain words. */\n\treadonly expected?: string;\n\t/** What it found instead. */\n\treadonly actual?: string;\n\n\tconstructor(init: { code: string; message: string; expected?: string; actual?: string }) {\n\t\tsuper(init.message);\n\t\tthis.name = \"ExpectationError\";\n\t\tthis.code = init.code;\n\t\tthis.expected = init.expected;\n\t\tthis.actual = init.actual;\n\t\t// Restore the prototype chain across the ES5 `Error` transpile target,\n\t\t// so `instanceof ExpectationError` holds for callers.\n\t\tObject.setPrototypeOf(this, ExpectationError.prototype);\n\t}\n}\n\n//#endregion\n\n//#region createTestEngine\n\n/** Options for {@link createTestEngine}. */\nexport interface TestEngineOptions {\n\t/** Locale passed to the engine. Defaults to `\"en\"`. */\n\tlocale?: string;\n\t/**\n\t * Whether to load the engine's built-in packages (arithmetic, units, dates,\n\t * and the rest) before the packages under test. Defaults to `true`, because\n\t * almost every package builds on arithmetic and most authors want a\n\t * realistic engine. Set `false` to test a package in isolation.\n\t */\n\tincludeBuiltins?: boolean;\n}\n\n/**\n * Build an {@link ExpressionEngine} loaded with the packages under test.\n *\n * The built-in packages load first (unless {@link TestEngineOptions.includeBuiltins}\n * is `false`), then each package in `packages` is registered in order, exactly\n * as a host would. Registration is honest: a package whose declared\n * `engineVersion` the running engine does not satisfy, or whose lexer keyword\n * collides with a built-in, throws here rather than being swallowed. That is\n * deliberately different from passing packages straight to the\n * `ExpressionEngine` constructor, which contains a bad package by logging and\n * continuing, useful in production, wrong for a test that needs to know the\n * package it is testing actually loaded.\n *\n * Call {@link ExpressionEngine.clear} when a test is finished with the engine\n * if the test creates many, see the engine's own lifecycle note.\n *\n * @example\n * ```ts\n * const engine = createTestEngine([myPackage]);\n * const engineOnly = createTestEngine([myPackage], { includeBuiltins: false });\n * ```\n */\nexport function createTestEngine(\n\tpackages: IEnginePackage[] = [],\n\toptions: TestEngineOptions = {},\n): ExpressionEngine {\n\tconst { locale = \"en\", includeBuiltins = true } = options;\n\n\t// Built-ins go through the constructor (their own containment applies);\n\t// the packages under test go through registerPackage() afterwards so their\n\t// failures surface as thrown errors instead of being logged and skipped.\n\tconst engine = new ExpressionEngine({ locale, packages: includeBuiltins ? BUILTIN_PACKAGES : [] });\n\tfor (const pkg of packages) {\n\t\tengine.registerPackage(pkg);\n\t}\n\treturn engine;\n}\n\n//#endregion\n\n//#region expectExpression\n\n/**\n * The normalised outcome of evaluating one expression, computed once when\n * {@link expectExpression} runs and read by every matcher on the result.\n *\n * The engine surfaces a failure two different ways, and a package author should\n * not have to know which: a parse/eval error is THROWN as an\n * {@link EngineError} (with a `.code`), while a plugin-raised error is RETURNED\n * as a {@link Value} of {@link ValueType.Error} (its `value` is the code, its\n * `unit` is the message). Both collapse to the `\"error\"` status here. A value\n * still resolving asynchronously is its own `\"pending\"` status, since the kit\n * evaluates synchronously and cannot report a final number for it.\n */\ntype Outcome =\n\t| { status: \"value\"; value: Value }\n\t| { status: \"pending\"; value: Value }\n\t| { status: \"error\"; code: string; message: string; source: EngineError | Value };\n\n/** Evaluate `expression` on `engine` and collapse both failure shapes to one outcome. */\nfunction evaluate(engine: ExpressionEngine, expression: string): Outcome {\n\ttry {\n\t\tconst value = engine.evaluateExpression(expression);\n\t\tif (value.isError()) {\n\t\t\treturn {\n\t\t\t\tstatus: \"error\",\n\t\t\t\tcode: value.errorCode ?? \"\",\n\t\t\t\tmessage: value.errorMessage ?? \"\",\n\t\t\t\tsource: value,\n\t\t\t};\n\t\t}\n\t\tif (value.isPending()) {\n\t\t\treturn { status: \"pending\", value };\n\t\t}\n\t\treturn { status: \"value\", value };\n\t} catch (error) {\n\t\tif (error instanceof EngineError) {\n\t\t\treturn { status: \"error\", code: error.code, message: error.message, source: error };\n\t\t}\n\t\t// Anything else thrown (a bug in a plugin handler, say) is still a\n\t\t// failure, wrapped so the matcher has a code and message to report.\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\treturn {\n\t\t\tstatus: \"error\",\n\t\t\tcode: \"UNKNOWN_ERROR\",\n\t\t\tmessage,\n\t\t\tsource: new Value(ValueType.Error, \"UNKNOWN_ERROR\", message),\n\t\t};\n\t}\n}\n\n/** Whether two numbers are equal within a small tolerance scaled to their magnitude. */\nfunction numbersEqual(a: number, b: number): boolean {\n\tif (Object.is(a, b)) return true;\n\tif (!Number.isFinite(a) || !Number.isFinite(b)) return false;\n\tconst epsilon = 1e-9 * Math.max(1, Math.abs(a), Math.abs(b));\n\treturn Math.abs(a - b) <= epsilon;\n}\n\n/** A short, readable rendering of a value for an assertion message, e.g. `5 gp` or `\"abc\"`. */\nfunction describeValue(value: Value): string {\n\tif (value.type === ValueType.String) return JSON.stringify(value.value);\n\tif (value.type === ValueType.Uom && typeof value.unit === \"string\") {\n\t\treturn `${String(value.value)} ${value.unit}`;\n\t}\n\treturn String(value.value);\n}\n\n/** A short, readable rendering of an outcome for an assertion message. */\nfunction describeOutcome(outcome: Outcome): string {\n\tswitch (outcome.status) {\n\t\tcase \"value\":\n\t\t\treturn describeValue(outcome.value);\n\t\tcase \"pending\":\n\t\t\treturn \"a pending async value\";\n\t\tcase \"error\":\n\t\t\treturn `an error (${outcome.code}: ${outcome.message})`;\n\t}\n}\n\n/**\n * Assertions about the result of one evaluated expression, returned by\n * {@link expectExpression}. Every matcher returns `this`, so assertions chain,\n * and throws an {@link ExpectationError} when it fails.\n */\nexport class ExpressionAssertion {\n\tconstructor(\n\t\tprivate readonly expression: string,\n\t\tprivate readonly outcome: Outcome,\n\t) {}\n\n\t/** The raw resolved {@link Value}, for an assertion the matchers do not cover. Throws if the expression failed. */\n\tget value(): Value {\n\t\tif (this.outcome.status === \"error\") {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_VALUE\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to evaluate, but it failed with ${describeOutcome(this.outcome)}.`,\n\t\t\t\texpected: \"a resolved value\",\n\t\t\t\tactual: describeOutcome(this.outcome),\n\t\t\t});\n\t\t}\n\t\treturn this.outcome.value;\n\t}\n\n\t/**\n\t * Assert the expression evaluated to a value (not an error, not a pending\n\t * async result). Says nothing about what the value is.\n\t */\n\ttoEvaluate(): this {\n\t\tif (this.outcome.status !== \"value\") {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_EVALUATE\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to evaluate to a value, but got ${describeOutcome(this.outcome)}.`,\n\t\t\t\texpected: \"a resolved value\",\n\t\t\t\tactual: describeOutcome(this.outcome),\n\t\t\t});\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Assert the expression evaluated to `expected`, and, when `unit` is given,\n\t * that the result carries exactly that unit. A number compares against the\n\t * value's numeric magnitude within a small floating-point tolerance; a\n\t * string compares against the value's own string; a boolean against its\n\t * boolean reading. Omitting `unit` leaves the unit unchecked, so\n\t * `toEqual(5)` passes for both `5` and `5 gp`.\n\t */\n\ttoEqual(expected: number | string | boolean, unit?: string): this {\n\t\tif (this.outcome.status !== \"value\") {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_EQUAL\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to equal ${describeExpected(expected, unit)}, but got ${describeOutcome(this.outcome)}.`,\n\t\t\t\texpected: describeExpected(expected, unit),\n\t\t\t\tactual: describeOutcome(this.outcome),\n\t\t\t});\n\t\t}\n\n\t\tconst value = this.outcome.value;\n\t\tlet matches: boolean;\n\t\tif (typeof expected === \"number\") {\n\t\t\tmatches = numbersEqual(value.toNumber(), expected);\n\t\t} else if (typeof expected === \"boolean\") {\n\t\t\t// A Boolean value stores the primitive directly; anything else can\n\t\t\t// never equal a boolean, so a mismatch reports the real value.\n\t\t\tmatches = value.type === ValueType.Boolean && value.value === expected;\n\t\t} else {\n\t\t\tmatches = valueToComparableString(value) === expected;\n\t\t}\n\n\t\tif (!matches) {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_EQUAL\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to equal ${describeExpected(expected, unit)}, but it was ${describeValue(value)}.`,\n\t\t\t\texpected: describeExpected(expected, unit),\n\t\t\t\tactual: describeValue(value),\n\t\t\t});\n\t\t}\n\n\t\tif (unit !== undefined && value.unit !== unit) {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_UNIT\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to carry the unit \"${unit}\", but it was ${value.unit === undefined ? \"unitless\" : `\"${value.unit}\"`}.`,\n\t\t\t\texpected: `unit \"${unit}\"`,\n\t\t\t\tactual: value.unit === undefined ? \"no unit\" : `unit \"${value.unit}\"`,\n\t\t\t});\n\t\t}\n\n\t\treturn this;\n\t}\n\n\t/** Assert the expression failed (a thrown engine error or a plugin-raised error value). Says nothing about the code. */\n\ttoBeError(): this {\n\t\tif (this.outcome.status !== \"error\") {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_ERROR\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to fail, but it produced ${describeOutcome(this.outcome)}.`,\n\t\t\t\texpected: \"an error\",\n\t\t\t\tactual: describeOutcome(this.outcome),\n\t\t\t});\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Assert the expression failed with exactly `code`, the error catalog code\n\t * (e.g. `\"UNDEFINED_VARIABLE\"`, or a package's own code). Reports the code\n\t * it actually got when they differ, so a near-miss is obvious.\n\t */\n\ttoFailWith(code: string): this {\n\t\tif (this.outcome.status !== \"error\") {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_FAIL_WITH\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to fail with \"${code}\", but it produced ${describeOutcome(this.outcome)}.`,\n\t\t\t\texpected: `error code \"${code}\"`,\n\t\t\t\tactual: describeOutcome(this.outcome),\n\t\t\t});\n\t\t}\n\t\tif (this.outcome.code !== code) {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_FAIL_WITH\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to fail with \"${code}\", but it failed with \"${this.outcome.code}\" (${this.outcome.message}).`,\n\t\t\t\texpected: `error code \"${code}\"`,\n\t\t\t\tactual: `error code \"${this.outcome.code}\"`,\n\t\t\t});\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Assert the expression returned a value still resolving asynchronously.\n\t * The kit evaluates synchronously, so a package whose result comes from an\n\t * async resolver reports pending on first evaluation, this is how a test\n\t * confirms the async path was taken without resolving it.\n\t */\n\ttoBePending(): this {\n\t\tif (this.outcome.status !== \"pending\") {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_PENDING\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to be pending, but got ${describeOutcome(this.outcome)}.`,\n\t\t\t\texpected: \"a pending async value\",\n\t\t\t\tactual: describeOutcome(this.outcome),\n\t\t\t});\n\t\t}\n\t\treturn this;\n\t}\n}\n\n/** Render an expected value (with optional unit) for an assertion message. */\nfunction describeExpected(expected: number | string | boolean, unit?: string): string {\n\tconst base = typeof expected === \"string\" ? JSON.stringify(expected) : String(expected);\n\treturn unit === undefined ? base : `${base} ${unit}`;\n}\n\n/** The string a non-numeric value compares against in {@link ExpressionAssertion.toEqual}. */\nfunction valueToComparableString(value: Value): string {\n\t// The stored primitive stringified. For a String value this is the string\n\t// itself; for a Hex value, its `0x...` text, which is what an author writes\n\t// in a `toEqual(\"0xff\")` assertion.\n\treturn String(value.value);\n}\n\n/**\n * Evaluate `expression` on `engine` and return an assertion object.\n *\n * The expression is evaluated once, immediately, and every matcher reads that\n * one outcome, so calling several matchers on the same result does not\n * re-evaluate.\n *\n * @example\n * ```ts\n * expectExpression(engine, \"2 gp + 3 gp\").toEqual(5, \"gp\");\n * expectExpression(engine, \"gp\").toFailWith(\"UNDEFINED_VARIABLE\");\n * ```\n */\nexport function expectExpression(engine: ExpressionEngine, expression: string): ExpressionAssertion {\n\treturn new ExpressionAssertion(expression, evaluate(engine, expression));\n}\n\n//#endregion\n\n//#region expectPackage\n\n/**\n * A modest set of everyday English words a package's keywords should not claim.\n *\n * A starting point for {@link PackageAssertion.notToShadow}, not an exhaustive\n * dictionary: it leans on the function words and common nouns/verbs a package\n * is most tempted to grab as a trigger (`price`, `of`, `per`, `sum`, `total`).\n * Pass your own list to check against the specific prose your package sits in.\n */\nexport const COMMON_PROSE_WORDS: readonly string[] = [\n\t\"a\", \"an\", \"and\", \"or\", \"but\", \"if\", \"then\", \"the\", \"this\", \"that\", \"these\", \"those\",\n\t\"in\", \"on\", \"at\", \"to\", \"of\", \"for\", \"from\", \"with\", \"by\", \"as\", \"per\", \"into\", \"over\",\n\t\"is\", \"are\", \"was\", \"were\", \"be\", \"been\", \"being\", \"do\", \"does\", \"did\", \"have\", \"has\", \"had\",\n\t\"will\", \"would\", \"can\", \"could\", \"should\", \"may\", \"might\", \"must\",\n\t\"price\", \"cost\", \"value\", \"total\", \"sum\", \"count\", \"rate\", \"amount\", \"number\",\n\t\"time\", \"date\", \"day\", \"week\", \"month\", \"year\", \"hour\", \"minute\", \"second\",\n\t\"add\", \"buy\", \"sell\", \"hold\", \"make\", \"take\", \"give\", \"get\", \"set\", \"run\",\n\t\"up\", \"down\", \"out\", \"off\", \"all\", \"some\", \"any\", \"no\", \"not\", \"more\", \"less\",\n\t\"one\", \"two\", \"three\", \"first\", \"last\", \"next\", \"each\", \"every\", \"here\", \"there\",\n];\n\n/** How strict {@link PackageAssertion.notToCollideWith} is about the conflicts it will accept. */\nexport type CollisionStrictness = \"error\" | \"warning\" | \"info\";\n\n/** One shadowed word found by {@link PackageAssertion.notToShadow}: the prose word and how the package claims it. */\nexport interface ShadowedWord {\n\t/** The prose word the package claims. */\n\tword: string;\n\t/** Which descriptor field claims it. */\n\tvia: \"keyword\" | \"unit\" | \"operator\" | \"phrase\";\n\t/** The token type the word becomes, when the field maps to one. */\n\ttokenType?: string;\n}\n\n/** Severities at or above the strictness threshold, ordered most to least severe. */\nconst SEVERITY_ORDER: CompatibilitySeverity[] = [\"error\", \"warning\", \"info\"];\n\n/** Gather the single words a package claims through its declared vocabulary, which is where prose shadowing comes from. */\nfunction claimedWords(pkg: IEnginePackage): ShadowedWord[] {\n\tconst claimed: ShadowedWord[] = [];\n\tconst vocab = pkg.lexerVocabulary;\n\tif (vocab?.keywords) {\n\t\tfor (const [word, tokenType] of Object.entries(vocab.keywords)) {\n\t\t\tclaimed.push({ word, via: \"keyword\", tokenType });\n\t\t}\n\t}\n\tif (vocab?.units) {\n\t\tfor (const word of vocab.units) {\n\t\t\tclaimed.push({ word, via: \"unit\" });\n\t\t}\n\t}\n\tif (vocab?.operators) {\n\t\tfor (const [word, tokenType] of Object.entries(vocab.operators)) {\n\t\t\tclaimed.push({ word, via: \"operator\", tokenType });\n\t\t}\n\t}\n\tif (pkg.phrases) {\n\t\tfor (const [phrase, tokenType] of Object.entries(pkg.phrases)) {\n\t\t\t// A multi-word phrase is the SAFE pattern the trigger-words guide\n\t\t\t// recommends (`next friday` reserves neither word), so only a\n\t\t\t// single-word phrase can shadow a prose word.\n\t\t\tif (!phrase.includes(\" \")) {\n\t\t\t\tclaimed.push({ word: phrase, via: \"phrase\", tokenType });\n\t\t\t}\n\t\t}\n\t}\n\treturn claimed;\n}\n\n/**\n * Assertions about a package's declared descriptor, returned by\n * {@link expectPackage}. These catch the three mistakes the issue calls out,\n * before the package is ever registered. Every matcher returns `this` and\n * throws an {@link ExpectationError} when it fails.\n */\nexport class PackageAssertion {\n\tconstructor(private readonly pkg: IEnginePackage) {}\n\n\t/**\n\t * Assert none of the package's claimed words shadow a prose word.\n\t *\n\t * A trigger word that is also an ordinary word turns a line of prose into\n\t * arithmetic, the single most common package mistake and the subject of the\n\t * trigger-words guide. This checks the words the package declares\n\t * (lexer keywords, units, operators, and single-word phrases) against\n\t * `words` (defaulting to {@link COMMON_PROSE_WORDS}), case-insensitively.\n\t *\n\t * @returns the shadowed words, empty when the package is clean, for a test\n\t * that wants to inspect rather than assert.\n\t */\n\tnotToShadow(words: readonly string[] = COMMON_PROSE_WORDS): ShadowedWord[] {\n\t\tconst prose = new Set(words.map((w) => w.toLowerCase()));\n\t\tconst shadowed = claimedWords(this.pkg).filter((c) => prose.has(c.word.toLowerCase()));\n\t\tif (shadowed.length > 0) {\n\t\t\tconst list = shadowed.map((s) => `\"${s.word}\" (${s.via})`).join(\", \");\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"PACKAGE_SHADOWS_PROSE\",\n\t\t\t\tmessage: `Package \"${this.pkg.name}\" claims prose word(s) as syntax: ${list}. A word that is also ordinary English turns prose into arithmetic; prefer a multi-word phrase or a form that requires a parenthesis.`,\n\t\t\t\texpected: \"no prose words claimed as syntax\",\n\t\t\t\tactual: list,\n\t\t\t});\n\t\t}\n\t\treturn shadowed;\n\t}\n\n\t/**\n\t * Assert the package does not collide with any of `others` in a way that\n\t * would silently break one of them (two packages claiming the same lexer\n\t * keyword, plugin-function index, async-resolver namespace, and so on).\n\t *\n\t * `strictness` sets which severities fail the assertion: `\"error\"` (the\n\t * default) fails only on the collisions that always break something,\n\t * `\"warning\"` also fails on the ones that silently pick a winner, `\"info\"`\n\t * fails on cosmetic overlaps too.\n\t *\n\t * @returns the full compatibility report, so a test can inspect every\n\t * conflict, including ones below the strictness threshold.\n\t */\n\tnotToCollideWith(\n\t\tothers: IEnginePackage[],\n\t\tstrictness: CollisionStrictness = \"error\",\n\t): CompatibilityReport {\n\t\tconst report = checkPackageCompatibility(this.pkg, others);\n\t\tconst threshold = SEVERITY_ORDER.indexOf(strictness);\n\t\tconst failing = report.conflicts.filter(\n\t\t\t(c: CompatibilityConflict) => SEVERITY_ORDER.indexOf(c.severity) <= threshold,\n\t\t);\n\t\tif (failing.length > 0) {\n\t\t\tconst list = failing.map((c) => `[${c.severity}] ${c.detail}`).join(\"\\n\");\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"PACKAGE_VOCABULARY_COLLISION\",\n\t\t\t\tmessage: `Package \"${this.pkg.name}\" collides with another package:\\n${list}`,\n\t\t\t\texpected: `no conflicts at or above \"${strictness}\" severity`,\n\t\t\t\tactual: `${failing.length} conflict(s)`,\n\t\t\t});\n\t\t}\n\t\treturn report;\n\t}\n\n\t/**\n\t * Assert the package's declared `engineVersion` range is satisfied by the\n\t * running engine (or by `engineVersion` when given).\n\t *\n\t * A package that declares a range and never checks it resolves is the third\n\t * mistake the issue names: it looks fine until the one engine version it\n\t * cannot run against, where the range either fails to match or turns out to\n\t * be a malformed string. A package with no declared range passes (no\n\t * constraint is always compatible).\n\t */\n\ttoDeclareCompatibleEngineVersion(engineVersion: string = ENGINE_VERSION): this {\n\t\tconst result = checkEngineVersionCompatibility(this.pkg, engineVersion);\n\t\tif (!result.compatible) {\n\t\t\tconst detail =\n\t\t\t\tresult.reason === \"invalid-range\"\n\t\t\t\t\t? `its range \"${result.declaredRange}\" is not valid semver`\n\t\t\t\t\t: `its range \"${result.declaredRange}\" is not satisfied by engine version \"${result.engineVersion}\"`;\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"PACKAGE_ENGINE_VERSION_INCOMPATIBLE\",\n\t\t\t\tmessage: `Package \"${this.pkg.name}\" declares an engineVersion that will be rejected at registration: ${detail}.`,\n\t\t\t\texpected: `an engineVersion satisfied by \"${engineVersion}\"`,\n\t\t\t\tactual: `\"${result.declaredRange}\"`,\n\t\t\t});\n\t\t}\n\t\treturn this;\n\t}\n}\n\n/**\n * Begin an assertion about a package's declared descriptor.\n *\n * @example\n * ```ts\n * expectPackage(myPackage).notToShadow([\"price\", \"in\", \"of\"]);\n * expectPackage(myPackage).notToCollideWith(BUILTIN_PACKAGES);\n * expectPackage(myPackage).toDeclareCompatibleEngineVersion();\n * ```\n */\nexport function expectPackage(pkg: IEnginePackage): PackageAssertion {\n\treturn new PackageAssertion(pkg);\n}\n\n//#endregion\n"]}
+{"version":3,"sources":["../src/testing/index.ts"],"names":["ExpectationError","_ExpectationError","init","createTestEngine","packages","options","locale","includeBuiltins","engine","ExpressionEngine","BUILTIN_PACKAGES","pkg","evaluate","expression","value","error","EngineError","message","Value","numbersEqual","a","b","epsilon","describeValue","describeOutcome","outcome","ExpressionAssertion","expected","unit","describeExpected","matches","valueToComparableString","code","base","expectExpression","COMMON_PROSE_WORDS","SEVERITY_ORDER","claimedWords","claimed","vocab","word","tokenType","phrase","PackageAssertion","words","prose","w","shadowed","c","list","s","others","strictness","report","checkPackageCompatibility","threshold","failing","engineVersion","ENGINE_VERSION","result","checkEngineVersionCompatibility","detail","expectPackage"],"mappings":"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","file":"testing.cjs","sourcesContent":["/**\n * A test kit for package authors, the supported way to test a package by the\n * expressions it enables rather than by the opcodes it emits.\n *\n * Before this entry point a package author had two options, both bad: reach\n * into engine internals, or assert on whatever bytecode a parselet happened to\n * emit. The first is unstable across engine versions, the second pins the\n * implementation instead of the behaviour, so a refactor that keeps every\n * answer correct still breaks the tests. This module is a thin, dependency-free\n * layer over the same public surface a host uses: it constructs an\n * {@link ExpressionEngine} with the given packages and evaluates strings.\n *\n * It speaks in expressions. {@link expectExpression} evaluates a string and\n * asserts on the result or the failure code; {@link expectPackage} asserts on\n * the three mistakes a package actually makes (shadowing prose, colliding with\n * another package's vocabulary, and declaring an `engineVersion` range that the\n * running engine does not satisfy).\n *\n * Framework-agnostic on purpose. Nothing here imports jest, vitest or any\n * runner: an assertion that fails throws an {@link ExpectationError}, and one\n * that passes returns, so the kit drops into whatever runner the author already\n * has (or into a plain script, or `node:assert`). Runtime dependency-free and\n * side-effect free, so `solve-engine/testing` stays honest under the package's\n * `\"sideEffects\": false` contract.\n *\n * @example\n * ```ts\n * import { createTestEngine, expectExpression } from \"solve-engine/testing\";\n *\n * const engine = createTestEngine([myPackage]);\n * expectExpression(engine, \"2 gp + 3 gp\").toEqual(5, \"gp\");\n * expectExpression(engine, \"gp\").toFailWith(\"UNDEFINED_VARIABLE\");\n * ```\n */\n\nimport { ExpressionEngine } from \"@solve-js/engine/ExpressionEngine\";\nimport { BUILTIN_PACKAGES } from \"@solve-js/packages/builtins\";\nimport type { IEnginePackage } from \"@solve-js/api/PackageRegistry\";\nimport { Value, ValueType } from \"@solve-js/vm/Value\";\nimport { EngineError } from \"@solve-js/errors/EngineError\";\nimport {\n\tcheckPackageCompatibility,\n\ttype CompatibilityReport,\n\ttype CompatibilityConflict,\n\ttype CompatibilitySeverity,\n} from \"@solve-js/api/PackageCompatibility\";\nimport { checkEngineVersionCompatibility } from \"@solve-js/api/EngineVersionCompatibility\";\nimport { ENGINE_VERSION } from \"@solve-js/constants/version\";\n\n//#region Errors\n\n/**\n * The failure a matcher throws when an expectation is not met.\n *\n * A dedicated `Error` subclass rather than a bare `throw new Error`, so a\n * caller (or a reporter) can tell a kit assertion failure apart from an\n * unrelated exception with `instanceof`, and so the structured `expected` and\n * `actual` fields survive alongside the human-readable message. This is NOT an\n * {@link EngineError}: that type classifies pipeline-stage failures inside the\n * engine, whereas this classifies a test-assertion mismatch, a different\n * concern that would be miscategorised under any of `EngineError`'s categories.\n */\nexport class ExpectationError extends Error {\n\t/** A short, machine-readable label for which expectation failed. */\n\treadonly code: string;\n\t/** What the matcher was told to expect, in plain words. */\n\treadonly expected?: string;\n\t/** What it found instead. */\n\treadonly actual?: string;\n\n\tconstructor(init: { code: string; message: string; expected?: string; actual?: string }) {\n\t\tsuper(init.message);\n\t\tthis.name = \"ExpectationError\";\n\t\tthis.code = init.code;\n\t\tthis.expected = init.expected;\n\t\tthis.actual = init.actual;\n\t\t// Restore the prototype chain across the ES5 `Error` transpile target,\n\t\t// so `instanceof ExpectationError` holds for callers.\n\t\tObject.setPrototypeOf(this, ExpectationError.prototype);\n\t}\n}\n\n//#endregion\n\n//#region createTestEngine\n\n/** Options for {@link createTestEngine}. */\nexport interface TestEngineOptions {\n\t/** Locale passed to the engine. Defaults to `\"en\"`. */\n\tlocale?: string;\n\t/**\n\t * Whether to load the engine's built-in packages (arithmetic, units, dates,\n\t * and the rest) before the packages under test. Defaults to `true`, because\n\t * almost every package builds on arithmetic and most authors want a\n\t * realistic engine. Set `false` to test a package in isolation.\n\t */\n\tincludeBuiltins?: boolean;\n}\n\n/**\n * Build an {@link ExpressionEngine} loaded with the packages under test.\n *\n * The built-in packages load first (unless {@link TestEngineOptions.includeBuiltins}\n * is `false`), then each package in `packages` is registered in order, exactly\n * as a host would. Registration is honest: a package whose declared\n * `engineVersion` the running engine does not satisfy, or whose lexer keyword\n * collides with a built-in, throws here rather than being swallowed. That is\n * deliberately different from passing packages straight to the\n * `ExpressionEngine` constructor, which contains a bad package by logging and\n * continuing, useful in production, wrong for a test that needs to know the\n * package it is testing actually loaded.\n *\n * Call {@link ExpressionEngine.clear} when a test is finished with the engine\n * if the test creates many, see the engine's own lifecycle note.\n *\n * @example\n * ```ts\n * const engine = createTestEngine([myPackage]);\n * const engineOnly = createTestEngine([myPackage], { includeBuiltins: false });\n * ```\n */\nexport function createTestEngine(\n\tpackages: IEnginePackage[] = [],\n\toptions: TestEngineOptions = {},\n): ExpressionEngine {\n\tconst { locale = \"en\", includeBuiltins = true } = options;\n\n\t// Built-ins go through the constructor (their own containment applies);\n\t// the packages under test go through registerPackage() afterwards so their\n\t// failures surface as thrown errors instead of being logged and skipped.\n\tconst engine = new ExpressionEngine({ locale, packages: includeBuiltins ? BUILTIN_PACKAGES : [] });\n\tfor (const pkg of packages) {\n\t\tengine.registerPackage(pkg);\n\t}\n\treturn engine;\n}\n\n//#endregion\n\n//#region expectExpression\n\n/**\n * The normalised outcome of evaluating one expression, computed once when\n * {@link expectExpression} runs and read by every matcher on the result.\n *\n * The engine surfaces a failure two different ways, and a package author should\n * not have to know which: a parse/eval error is THROWN as an\n * {@link EngineError} (with a `.code`), while a plugin-raised error is RETURNED\n * as a {@link Value} of {@link ValueType.Error} (its `value` is the code, its\n * `unit` is the message). Both collapse to the `\"error\"` status here. A value\n * still resolving asynchronously is its own `\"pending\"` status, since the kit\n * evaluates synchronously and cannot report a final number for it.\n */\ntype Outcome =\n\t| { status: \"value\"; value: Value }\n\t| { status: \"pending\"; value: Value }\n\t| { status: \"error\"; code: string; message: string; source: EngineError | Value };\n\n/** Evaluate `expression` on `engine` and collapse both failure shapes to one outcome. */\nfunction evaluate(engine: ExpressionEngine, expression: string): Outcome {\n\ttry {\n\t\tconst value = engine.evaluateExpression(expression);\n\t\tif (value.isError()) {\n\t\t\treturn {\n\t\t\t\tstatus: \"error\",\n\t\t\t\tcode: value.errorCode ?? \"\",\n\t\t\t\tmessage: value.errorMessage ?? \"\",\n\t\t\t\tsource: value,\n\t\t\t};\n\t\t}\n\t\tif (value.isPending()) {\n\t\t\treturn { status: \"pending\", value };\n\t\t}\n\t\treturn { status: \"value\", value };\n\t} catch (error) {\n\t\tif (error instanceof EngineError) {\n\t\t\treturn { status: \"error\", code: error.code, message: error.message, source: error };\n\t\t}\n\t\t// Anything else thrown (a bug in a plugin handler, say) is still a\n\t\t// failure, wrapped so the matcher has a code and message to report.\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\treturn {\n\t\t\tstatus: \"error\",\n\t\t\tcode: \"UNKNOWN_ERROR\",\n\t\t\tmessage,\n\t\t\tsource: new Value(ValueType.Error, \"UNKNOWN_ERROR\", message),\n\t\t};\n\t}\n}\n\n/** Whether two numbers are equal within a small tolerance scaled to their magnitude. */\nfunction numbersEqual(a: number, b: number): boolean {\n\tif (Object.is(a, b)) return true;\n\tif (!Number.isFinite(a) || !Number.isFinite(b)) return false;\n\tconst epsilon = 1e-9 * Math.max(1, Math.abs(a), Math.abs(b));\n\treturn Math.abs(a - b) <= epsilon;\n}\n\n/** A short, readable rendering of a value for an assertion message, e.g. `5 gp` or `\"abc\"`. */\nfunction describeValue(value: Value): string {\n\tif (value.type === ValueType.String) return JSON.stringify(value.value);\n\tif (value.type === ValueType.Uom && typeof value.unit === \"string\") {\n\t\treturn `${String(value.value)} ${value.unit}`;\n\t}\n\treturn String(value.value);\n}\n\n/** A short, readable rendering of an outcome for an assertion message. */\nfunction describeOutcome(outcome: Outcome): string {\n\tswitch (outcome.status) {\n\t\tcase \"value\":\n\t\t\treturn describeValue(outcome.value);\n\t\tcase \"pending\":\n\t\t\treturn \"a pending async value\";\n\t\tcase \"error\":\n\t\t\treturn `an error (${outcome.code}: ${outcome.message})`;\n\t}\n}\n\n/**\n * Assertions about the result of one evaluated expression, returned by\n * {@link expectExpression}. Every matcher returns `this`, so assertions chain,\n * and throws an {@link ExpectationError} when it fails.\n */\nexport class ExpressionAssertion {\n\tconstructor(\n\t\tprivate readonly expression: string,\n\t\tprivate readonly outcome: Outcome,\n\t) {}\n\n\t/** The raw resolved {@link Value}, for an assertion the matchers do not cover. Throws if the expression failed. */\n\tget value(): Value {\n\t\tif (this.outcome.status === \"error\") {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_VALUE\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to evaluate, but it failed with ${describeOutcome(this.outcome)}.`,\n\t\t\t\texpected: \"a resolved value\",\n\t\t\t\tactual: describeOutcome(this.outcome),\n\t\t\t});\n\t\t}\n\t\treturn this.outcome.value;\n\t}\n\n\t/**\n\t * Assert the expression evaluated to a value (not an error, not a pending\n\t * async result). Says nothing about what the value is.\n\t */\n\ttoEvaluate(): this {\n\t\tif (this.outcome.status !== \"value\") {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_EVALUATE\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to evaluate to a value, but got ${describeOutcome(this.outcome)}.`,\n\t\t\t\texpected: \"a resolved value\",\n\t\t\t\tactual: describeOutcome(this.outcome),\n\t\t\t});\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Assert the expression evaluated to `expected`, and, when `unit` is given,\n\t * that the result carries exactly that unit. A number compares against the\n\t * value's numeric magnitude within a small floating-point tolerance; a\n\t * string compares against the value's own string; a boolean against its\n\t * boolean reading. Omitting `unit` leaves the unit unchecked, so\n\t * `toEqual(5)` passes for both `5` and `5 gp`.\n\t */\n\ttoEqual(expected: number | string | boolean, unit?: string): this {\n\t\tif (this.outcome.status !== \"value\") {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_EQUAL\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to equal ${describeExpected(expected, unit)}, but got ${describeOutcome(this.outcome)}.`,\n\t\t\t\texpected: describeExpected(expected, unit),\n\t\t\t\tactual: describeOutcome(this.outcome),\n\t\t\t});\n\t\t}\n\n\t\tconst value = this.outcome.value;\n\t\tlet matches: boolean;\n\t\tif (typeof expected === \"number\") {\n\t\t\tmatches = numbersEqual(value.toNumber(), expected);\n\t\t} else if (typeof expected === \"boolean\") {\n\t\t\t// A Boolean value stores the primitive directly; anything else can\n\t\t\t// never equal a boolean, so a mismatch reports the real value.\n\t\t\tmatches = value.type === ValueType.Boolean && value.value === expected;\n\t\t} else {\n\t\t\tmatches = valueToComparableString(value) === expected;\n\t\t}\n\n\t\tif (!matches) {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_EQUAL\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to equal ${describeExpected(expected, unit)}, but it was ${describeValue(value)}.`,\n\t\t\t\texpected: describeExpected(expected, unit),\n\t\t\t\tactual: describeValue(value),\n\t\t\t});\n\t\t}\n\n\t\tif (unit !== undefined && value.unit !== unit) {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_UNIT\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to carry the unit \"${unit}\", but it was ${value.unit === undefined ? \"unitless\" : `\"${value.unit}\"`}.`,\n\t\t\t\texpected: `unit \"${unit}\"`,\n\t\t\t\tactual: value.unit === undefined ? \"no unit\" : `unit \"${value.unit}\"`,\n\t\t\t});\n\t\t}\n\n\t\treturn this;\n\t}\n\n\t/** Assert the expression failed (a thrown engine error or a plugin-raised error value). Says nothing about the code. */\n\ttoBeError(): this {\n\t\tif (this.outcome.status !== \"error\") {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_ERROR\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to fail, but it produced ${describeOutcome(this.outcome)}.`,\n\t\t\t\texpected: \"an error\",\n\t\t\t\tactual: describeOutcome(this.outcome),\n\t\t\t});\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Assert the expression failed with exactly `code`, the error catalog code\n\t * (e.g. `\"UNDEFINED_VARIABLE\"`, or a package's own code). Reports the code\n\t * it actually got when they differ, so a near-miss is obvious.\n\t */\n\ttoFailWith(code: string): this {\n\t\tif (this.outcome.status !== \"error\") {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_FAIL_WITH\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to fail with \"${code}\", but it produced ${describeOutcome(this.outcome)}.`,\n\t\t\t\texpected: `error code \"${code}\"`,\n\t\t\t\tactual: describeOutcome(this.outcome),\n\t\t\t});\n\t\t}\n\t\tif (this.outcome.code !== code) {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_FAIL_WITH\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to fail with \"${code}\", but it failed with \"${this.outcome.code}\" (${this.outcome.message}).`,\n\t\t\t\texpected: `error code \"${code}\"`,\n\t\t\t\tactual: `error code \"${this.outcome.code}\"`,\n\t\t\t});\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Assert the expression returned a value still resolving asynchronously.\n\t * The kit evaluates synchronously, so a package whose result comes from an\n\t * async resolver reports pending on first evaluation, this is how a test\n\t * confirms the async path was taken without resolving it.\n\t */\n\ttoBePending(): this {\n\t\tif (this.outcome.status !== \"pending\") {\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"EXPECTED_PENDING\",\n\t\t\t\tmessage: `Expected \"${this.expression}\" to be pending, but got ${describeOutcome(this.outcome)}.`,\n\t\t\t\texpected: \"a pending async value\",\n\t\t\t\tactual: describeOutcome(this.outcome),\n\t\t\t});\n\t\t}\n\t\treturn this;\n\t}\n}\n\n/** Render an expected value (with optional unit) for an assertion message. */\nfunction describeExpected(expected: number | string | boolean, unit?: string): string {\n\tconst base = typeof expected === \"string\" ? JSON.stringify(expected) : String(expected);\n\treturn unit === undefined ? base : `${base} ${unit}`;\n}\n\n/** The string a non-numeric value compares against in {@link ExpressionAssertion.toEqual}. */\nfunction valueToComparableString(value: Value): string {\n\t// The stored primitive stringified. For a String value this is the string\n\t// itself; for a Hex value, its `0x...` text, which is what an author writes\n\t// in a `toEqual(\"0xff\")` assertion.\n\treturn String(value.value);\n}\n\n/**\n * Evaluate `expression` on `engine` and return an assertion object.\n *\n * The expression is evaluated once, immediately, and every matcher reads that\n * one outcome, so calling several matchers on the same result does not\n * re-evaluate.\n *\n * @example\n * ```ts\n * expectExpression(engine, \"2 gp + 3 gp\").toEqual(5, \"gp\");\n * expectExpression(engine, \"gp\").toFailWith(\"UNDEFINED_VARIABLE\");\n * ```\n */\nexport function expectExpression(engine: ExpressionEngine, expression: string): ExpressionAssertion {\n\treturn new ExpressionAssertion(expression, evaluate(engine, expression));\n}\n\n//#endregion\n\n//#region expectPackage\n\n/**\n * A modest set of everyday English words a package's keywords should not claim.\n *\n * A starting point for {@link PackageAssertion.notToShadow}, not an exhaustive\n * dictionary: it leans on the function words and common nouns/verbs a package\n * is most tempted to grab as a trigger (`price`, `of`, `per`, `sum`, `total`).\n * Pass your own list to check against the specific prose your package sits in.\n */\nexport const COMMON_PROSE_WORDS: readonly string[] = [\n\t\"a\", \"an\", \"and\", \"or\", \"but\", \"if\", \"then\", \"the\", \"this\", \"that\", \"these\", \"those\",\n\t\"in\", \"on\", \"at\", \"to\", \"of\", \"for\", \"from\", \"with\", \"by\", \"as\", \"per\", \"into\", \"over\",\n\t\"is\", \"are\", \"was\", \"were\", \"be\", \"been\", \"being\", \"do\", \"does\", \"did\", \"have\", \"has\", \"had\",\n\t\"will\", \"would\", \"can\", \"could\", \"should\", \"may\", \"might\", \"must\",\n\t\"price\", \"cost\", \"value\", \"total\", \"sum\", \"count\", \"rate\", \"amount\", \"number\",\n\t\"time\", \"date\", \"day\", \"week\", \"month\", \"year\", \"hour\", \"minute\", \"second\",\n\t\"add\", \"buy\", \"sell\", \"hold\", \"make\", \"take\", \"give\", \"get\", \"set\", \"run\",\n\t\"up\", \"down\", \"out\", \"off\", \"all\", \"some\", \"any\", \"no\", \"not\", \"more\", \"less\",\n\t\"one\", \"two\", \"three\", \"first\", \"last\", \"next\", \"each\", \"every\", \"here\", \"there\",\n];\n\n/** How strict {@link PackageAssertion.notToCollideWith} is about the conflicts it will accept. */\nexport type CollisionStrictness = \"error\" | \"warning\" | \"info\";\n\n/** One shadowed word found by {@link PackageAssertion.notToShadow}: the prose word and how the package claims it. */\nexport interface ShadowedWord {\n\t/** The prose word the package claims. */\n\tword: string;\n\t/** Which descriptor field claims it. */\n\tvia: \"keyword\" | \"unit\" | \"operator\" | \"phrase\";\n\t/** The token type the word becomes, when the field maps to one. */\n\ttokenType?: string;\n}\n\n/** Severities at or above the strictness threshold, ordered most to least severe. */\nconst SEVERITY_ORDER: CompatibilitySeverity[] = [\"error\", \"warning\", \"info\"];\n\n/** Gather the single words a package claims through its declared vocabulary, which is where prose shadowing comes from. */\nfunction claimedWords(pkg: IEnginePackage): ShadowedWord[] {\n\tconst claimed: ShadowedWord[] = [];\n\tconst vocab = pkg.lexerVocabulary;\n\tif (vocab?.keywords) {\n\t\tfor (const [word, tokenType] of Object.entries(vocab.keywords)) {\n\t\t\tclaimed.push({ word, via: \"keyword\", tokenType });\n\t\t}\n\t}\n\tif (vocab?.units) {\n\t\tfor (const word of vocab.units) {\n\t\t\tclaimed.push({ word, via: \"unit\" });\n\t\t}\n\t}\n\tif (vocab?.operators) {\n\t\tfor (const [word, tokenType] of Object.entries(vocab.operators)) {\n\t\t\tclaimed.push({ word, via: \"operator\", tokenType });\n\t\t}\n\t}\n\tif (pkg.phrases) {\n\t\tfor (const [phrase, tokenType] of Object.entries(pkg.phrases)) {\n\t\t\t// A multi-word phrase is the SAFE pattern the trigger-words guide\n\t\t\t// recommends (`next friday` reserves neither word), so only a\n\t\t\t// single-word phrase can shadow a prose word.\n\t\t\tif (!phrase.includes(\" \")) {\n\t\t\t\tclaimed.push({ word: phrase, via: \"phrase\", tokenType });\n\t\t\t}\n\t\t}\n\t}\n\treturn claimed;\n}\n\n/**\n * Assertions about a package's declared descriptor, returned by\n * {@link expectPackage}. These catch the three mistakes the issue calls out,\n * before the package is ever registered. Every matcher returns `this` and\n * throws an {@link ExpectationError} when it fails.\n */\nexport class PackageAssertion {\n\tconstructor(private readonly pkg: IEnginePackage) {}\n\n\t/**\n\t * Assert none of the package's claimed words shadow a prose word.\n\t *\n\t * A trigger word that is also an ordinary word turns a line of prose into\n\t * arithmetic, the single most common package mistake and the subject of the\n\t * trigger-words guide. This checks the words the package declares\n\t * (lexer keywords, units, operators, and single-word phrases) against\n\t * `words` (defaulting to {@link COMMON_PROSE_WORDS}), case-insensitively.\n\t *\n\t * @returns the shadowed words, empty when the package is clean, for a test\n\t * that wants to inspect rather than assert.\n\t */\n\tnotToShadow(words: readonly string[] = COMMON_PROSE_WORDS): ShadowedWord[] {\n\t\tconst prose = new Set(words.map((w) => w.toLowerCase()));\n\t\tconst shadowed = claimedWords(this.pkg).filter((c) => prose.has(c.word.toLowerCase()));\n\t\tif (shadowed.length > 0) {\n\t\t\tconst list = shadowed.map((s) => `\"${s.word}\" (${s.via})`).join(\", \");\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"PACKAGE_SHADOWS_PROSE\",\n\t\t\t\tmessage: `Package \"${this.pkg.name}\" claims prose word(s) as syntax: ${list}. A word that is also ordinary English turns prose into arithmetic; prefer a multi-word phrase or a form that requires a parenthesis.`,\n\t\t\t\texpected: \"no prose words claimed as syntax\",\n\t\t\t\tactual: list,\n\t\t\t});\n\t\t}\n\t\treturn shadowed;\n\t}\n\n\t/**\n\t * Assert the package does not collide with any of `others` in a way that\n\t * would silently break one of them (two packages claiming the same lexer\n\t * keyword, plugin-function index, async-resolver namespace, and so on).\n\t *\n\t * `strictness` sets which severities fail the assertion: `\"error\"` (the\n\t * default) fails only on the collisions that always break something,\n\t * `\"warning\"` also fails on the ones that silently pick a winner, `\"info\"`\n\t * fails on cosmetic overlaps too.\n\t *\n\t * @returns the full compatibility report, so a test can inspect every\n\t * conflict, including ones below the strictness threshold.\n\t */\n\tnotToCollideWith(\n\t\tothers: IEnginePackage[],\n\t\tstrictness: CollisionStrictness = \"error\",\n\t): CompatibilityReport {\n\t\tconst report = checkPackageCompatibility(this.pkg, others);\n\t\tconst threshold = SEVERITY_ORDER.indexOf(strictness);\n\t\tconst failing = report.conflicts.filter(\n\t\t\t(c: CompatibilityConflict) => SEVERITY_ORDER.indexOf(c.severity) <= threshold,\n\t\t);\n\t\tif (failing.length > 0) {\n\t\t\tconst list = failing.map((c) => `[${c.severity}] ${c.detail}`).join(\"\\n\");\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"PACKAGE_VOCABULARY_COLLISION\",\n\t\t\t\tmessage: `Package \"${this.pkg.name}\" collides with another package:\\n${list}`,\n\t\t\t\texpected: `no conflicts at or above \"${strictness}\" severity`,\n\t\t\t\tactual: `${failing.length} conflict(s)`,\n\t\t\t});\n\t\t}\n\t\treturn report;\n\t}\n\n\t/**\n\t * Assert the package's declared `engineVersion` range is satisfied by the\n\t * running engine (or by `engineVersion` when given).\n\t *\n\t * A package that declares a range and never checks it resolves is the third\n\t * mistake the issue names: it looks fine until the one engine version it\n\t * cannot run against, where the range either fails to match or turns out to\n\t * be a malformed string. A package with no declared range passes (no\n\t * constraint is always compatible).\n\t */\n\ttoDeclareCompatibleEngineVersion(engineVersion: string = ENGINE_VERSION): this {\n\t\tconst result = checkEngineVersionCompatibility(this.pkg, engineVersion);\n\t\tif (!result.compatible) {\n\t\t\tconst detail =\n\t\t\t\tresult.reason === \"invalid-range\"\n\t\t\t\t\t? `its range \"${result.declaredRange}\" is not valid semver`\n\t\t\t\t\t: `its range \"${result.declaredRange}\" is not satisfied by engine version \"${result.engineVersion}\"`;\n\t\t\tthrow new ExpectationError({\n\t\t\t\tcode: \"PACKAGE_ENGINE_VERSION_INCOMPATIBLE\",\n\t\t\t\tmessage: `Package \"${this.pkg.name}\" declares an engineVersion that will be rejected at registration: ${detail}.`,\n\t\t\t\texpected: `an engineVersion satisfied by \"${engineVersion}\"`,\n\t\t\t\tactual: `\"${result.declaredRange}\"`,\n\t\t\t});\n\t\t}\n\t\treturn this;\n\t}\n}\n\n/**\n * Begin an assertion about a package's declared descriptor.\n *\n * @example\n * ```ts\n * expectPackage(myPackage).notToShadow([\"price\", \"in\", \"of\"]);\n * expectPackage(myPackage).notToCollideWith(BUILTIN_PACKAGES);\n * expectPackage(myPackage).toDeclareCompatibleEngineVersion();\n * ```\n */\nexport function expectPackage(pkg: IEnginePackage): PackageAssertion {\n\treturn new PackageAssertion(pkg);\n}\n\n//#endregion\n"]}

package/dist/testing.d.cts

@@ -1,17 +1,18 @@
-import { I as IEnginePackage, E as ExpressionEngine } from './PackageRegistry-B9-7fJGH.cjs';
-import { V as Value } from './Value-Ds3Gy07C.cjs';
-import { E as EngineError } from './EngineError-D1kXsjIj.cjs';
-import { C as CompatibilityReport } from './PackageCompatibility-CeAPVHZr.cjs';
-import './Parselet-4oH5OuRt.cjs';
-import './BytecodeBuilder-aqVa7Plx.cjs';
-import './Token-CbP_OutD.cjs';
-import './pipeline-69q2tsLE.cjs';
-import './Lexer-CCHFDcgP.cjs';
+import { I as IEnginePackage, E as ExpressionEngine } from './PackageRegistry-BHBCFswo.cjs';
+import { V as Value } from './Value-BYHw-x7q.cjs';
+import { E as EngineError } from './EngineError-C-kBwYlN.cjs';
+import { C as CompatibilityReport } from './PackageCompatibility-CNiTtC6S.cjs';
+import './Parselet-DF3864la.cjs';
+import './BytecodeBuilder-DSWKZi4f.cjs';
+import './Token-D8f7yaz1.cjs';
+import './pipeline-BYkKNpql.cjs';
+import './CalendarBackend-MdS3Bb4P.cjs';
+import './Lexer-DhGhoAa2.cjs';
 import './resolvers.cjs';
 import '@tanstack/query-core';
-import './TokenNormalizer-MXaKLJ_m.cjs';
-import './ScopeManager-DrXB3Nvm.cjs';
-import './Configuration-DnzYPmoK.cjs';
+import './TokenNormalizer-Pe3_390t.cjs';
+import './VMBuiltins-kv4rr0y5.cjs';
+import './Configuration-BxriK9Kw.cjs';
 
 /**
  * A test kit for package authors, the supported way to test a package by the

package/dist/testing.d.ts

@@ -1,17 +1,18 @@
-import { I as IEnginePackage, E as ExpressionEngine } from './PackageRegistry-CDEgfhT_.js';
-import { V as Value } from './Value-Ds3Gy07C.js';
-import { E as EngineError } from './EngineError-D1kXsjIj.js';
-import { C as CompatibilityReport } from './PackageCompatibility-Bq82y0ZN.js';
-import './Parselet-BwDqKFfK.js';
-import './BytecodeBuilder-aqVa7Plx.js';
-import './Token-CbP_OutD.js';
-import './pipeline-DTqGLPsV.js';
-import './Lexer-CqagTewQ.js';
+import { I as IEnginePackage, E as ExpressionEngine } from './PackageRegistry-CNZUwWHJ.js';
+import { V as Value } from './Value-BYHw-x7q.js';
+import { E as EngineError } from './EngineError-C-kBwYlN.js';
+import { C as CompatibilityReport } from './PackageCompatibility-fj_f7uqC.js';
+import './Parselet-Dgymjxzd.js';
+import './BytecodeBuilder-DSWKZi4f.js';
+import './Token-D8f7yaz1.js';
+import './pipeline-Cl7KW8CB.js';
+import './CalendarBackend-MdS3Bb4P.js';
+import './Lexer-DqtnZMC5.js';
 import './resolvers.js';
 import '@tanstack/query-core';
-import './TokenNormalizer-OTPS0Otq.js';
-import './ScopeManager-BQBhlDAu.js';
-import './Configuration-DnzYPmoK.js';
+import './TokenNormalizer-IF7nPRMp.js';
+import './VMBuiltins-CZiZRKn-.js';
+import './Configuration-BxriK9Kw.js';
 
 /**
  * A test kit for package authors, the supported way to test a package by the

package/dist/testing.js

@@ -1,4 +1,4 @@
-import {n as n$1,a,b}from'./chunk-NUF66H57.js';import'./chunk-WFOQRPA6.js';import'./chunk-2RWAXT6O.js';import'./chunk-IJHL3LMH.js';import'./chunk-MIQBJGGR.js';import'./chunk-D2Q2VFJ6.js';import'./chunk-JP4JMQOG.js';import'./chunk-RE6AIU6Y.js';import'./chunk-XEIDV5JP.js';import {z}from'./chunk-A4JV7HRB.js';import'./chunk-OMHRBKAT.js';import'./chunk-3SHWTGTP.js';import'./chunk-RENO2AWO.js';import'./chunk-PWWQZFAE.js';import'./chunk-76F3LCIL.js';import'./chunk-TCZSPH4A.js';import'./chunk-2BXNZM3G.js';import'./chunk-GP4H5OIT.js';import'./chunk-TZYMXNIB.js';import'./chunk-HFKDWQUL.js';import'./chunk-5TCSFTZD.js';import'./chunk-UXR7JIPX.js';import {m}from'./chunk-IPSOWFCA.js';import'./chunk-4CNYGIND.js';import {a as a$1}from'./chunk-HQ7BKXG7.js';import'./chunk-LM6ZQUEU.js';import'./chunk-JPFCXLJV.js';import'./chunk-XFJABR3B.js';import'./chunk-IJMNVBIS.js';import'./chunk-LHLW7JLS.js';import'./chunk-CHVGFTO3.js';import'./chunk-PRSXXDTA.js';import {b as b$1}from'./chunk-BDF4VCQX.js';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 n$1({locale:e,packages:r?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 b$1)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 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=a(this.pkg,t),s=$.indexOf(e),a$1=r.conflicts.filter(u=>$.indexOf(u.severity)<=s);if(a$1.length>0){let u=a$1.map(g=>`[${g.severity}] ${g.detail}`).join(`
+import {n as n$1,a,b}from'./chunk-MTN53APQ.js';import'./chunk-VQO54ZMA.js';import'./chunk-2RWAXT6O.js';import'./chunk-IJHL3LMH.js';import'./chunk-MIQBJGGR.js';import'./chunk-TC23XEAV.js';import'./chunk-JP4JMQOG.js';import'./chunk-ZC2NPRLO.js';import'./chunk-XEIDV5JP.js';import {z}from'./chunk-LMZDTQS5.js';import'./chunk-HANGBVEE.js';import'./chunk-S3ODNMJS.js';import'./chunk-YG7UWQFV.js';import'./chunk-LE6WZLJ4.js';import'./chunk-76F3LCIL.js';import'./chunk-TCZSPH4A.js';import'./chunk-CL7DM2FX.js';import'./chunk-D4VBWPWN.js';import'./chunk-ESZNJQ2C.js';import'./chunk-TZYMXNIB.js';import'./chunk-HFKDWQUL.js';import'./chunk-5TCSFTZD.js';import'./chunk-LTUYWJGO.js';import'./chunk-BLJ6E577.js';import'./chunk-J4K72CQN.js';import {m}from'./chunk-LQIRBP4Q.js';import'./chunk-4CNYGIND.js';import {a as a$1}from'./chunk-GQM6ICDM.js';import'./chunk-Y7XRA2EV.js';import'./chunk-JPFCXLJV.js';import'./chunk-RRUGQ6DM.js';import'./chunk-FAO6DQ74.js';import'./chunk-LHLW7JLS.js';import'./chunk-CHVGFTO3.js';import'./chunk-PRSXXDTA.js';import {b as b$1}from'./chunk-VB6QMU2W.js';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 n$1({locale:e,packages:r?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 b$1)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 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=a(this.pkg,t),s=$.indexOf(e),a$1=r.conflicts.filter(u=>$.indexOf(u.severity)<=s);if(a$1.length>0){let u=a$1.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$1.length} conflict(s)`})}return r}toDeclareCompatibleEngineVersion(t=a$1){let e=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)}export{O as COMMON_PROSE_WORDS,i as ExpectationError,d as ExpressionAssertion,p as PackageAssertion,V as createTestEngine,D as expectExpression,L as expectPackage};//# sourceMappingURL=testing.js.map
 //# sourceMappingURL=testing.js.map