solve-engine 2.25.0 → 2.27.0

package/dist/{ScopeManager-B636am7Y.d.ts → VMBuiltins-CZiZRKn-.d.ts}

@@ -1,7 +1,8 @@
-import { V as Value } from './Value-Ds3Gy07C.js';
+import { V as Value } from './Value-BYHw-x7q.js';
 import { U as UserFunctionDef, A as AnonymousBodyDef, a as BytecodeProgram } from './BytecodeBuilder-DSWKZi4f.js';
-import { E as EngineError } from './EngineError-fR1K1rvx.js';
-import { D as DiagnosticPipeline } from './pipeline-DTqGLPsV.js';
+import { C as CalendarBackend } from './CalendarBackend-MdS3Bb4P.js';
+import { E as EngineError } from './EngineError-C-kBwYlN.js';
+import { D as DiagnosticPipeline } from './pipeline-Cl7KW8CB.js';
 
 /**
  * Create a new VM instance with the given opcode registry and configurable limits.
@@ -83,6 +84,14 @@ interface LineExecutionContext {
      * message that describes a different fault. Absent means enabled.
      */
     networkEnabled?: boolean;
+    /**
+     * The calendar backend this engine computes dates with (`EngineContext.calendar`).
+     * A plugin function that reads or steps a date computes through it, so the
+     * date it answers agrees with the one the VM's own opcodes would produce.
+     * Absent means the `Date` backend; `calendarOf()` in
+     * `calendar/DateCalendar.ts` resolves either case.
+     */
+    calendar?: CalendarBackend;
     /** Look up another line's cached result by 1-based line number. `undefined` = not evaluated yet (or out of range), distinct from a line that evaluated to an actual `undefined`-like Value, which can't happen (every Value type has a concrete representation). */
     getLineResult?: (lineNumber: number) => Value | undefined;
     /** Whether line `lineNumber` is a blank line or a `#` heading, the stopping condition for "total above"/"sum above"/"average above" aggregation. */
@@ -190,11 +199,13 @@ declare function executeBytecode(bytecode: Bytecode, vm: VM, pipeline?: Diagnost
  * by that engine. Anything that needs one of these registries receives the
  * context rather than importing a singleton.
  *
- * Runtime imports here are restricted to leaf modules of `vm/`. This file is
- * imported by `vm/`, which `engine/` imports in turn, so pulling in anything
- * that reaches back into `engine/` would close a cycle. `OpRegistry` is safe
- * because it imports only types plus the error factory. Everything else arrives
- * through `import type`, which is erased before the code runs.
+ * Runtime imports here are restricted to leaf modules of `vm/` and
+ * `calendar/`. This file is imported by `vm/`, which `engine/` imports in
+ * turn, so pulling in anything that reaches back into `engine/` would close a
+ * cycle. `OpRegistry` is safe because it imports only types plus the error
+ * factory, and the `Date` calendar backend imports nothing of the engine's at
+ * all. Everything else arrives through `import type`, which is erased before
+ * the code runs.
  */
 
 /**
@@ -268,6 +279,18 @@ interface EngineContext {
      * the context is the one object every VM already holds.
      */
     readonly networkEnabled: boolean;
+    /**
+     * The calendar this engine computes dates with, from the engine's
+     * `calendar` option.
+     *
+     * One backend per engine, held here for the same reason the network
+     * switch is: the VM is where a date literal is stepped, a working-day
+     * walk runs and `now` is read, and every plugin function that touches a
+     * date reaches it through the execution context the VM builds from this
+     * one object. Defaults to Temporal where the runtime has it and `Date`
+     * where it does not. See `calendar/resolveCalendar.ts`.
+     */
+    readonly calendar: CalendarBackend;
 }
 
 /**
@@ -705,4 +728,63 @@ declare class ScopeManager {
     clear(): void;
 }
 
-export { type Bytecode as B, DependencyGraph as D, type ExpressionRecord as E, OpRegistry as O, type PluginFunctionHandler as P, ScopeManager as S, type VM as V, type DagSnapshot as a, type EngineContext as b, createVM as c, executeBytecode as e, sharedOpRegistry as s };
+/**
+ * Registry of built-in mathematical functions.
+ * Indexed by the number pushed as an operand of OpCode.CALL_BUILTIN.
+ */
+declare const builtinFunctions: Record<number, (args: Value[]) => Value>;
+/**
+ * Registry of package-registered functions, indexed by the number pushed as an
+ * operand of `OpCode.CALL_PLUGIN`.
+ *
+ * Functions may return a promise. The orchestrator resolves it and re-executes
+ * rather than blocking the VM.
+ *
+ * Populated declaratively via {@link IEnginePackage.pluginFunctions} at
+ * package-registration time. Entries are cleared on unregister.
+ *
+ * @deprecated This is the {@link defaultEngineContext}'s map, kept as a
+ * module-level alias so existing callers keep working during the context
+ * migration. An engine registers into its own context, so writing here affects
+ * only code that has not been migrated. Take an {@link EngineContext} instead.
+ */
+declare const pluginFunctionRegistry: Record<number, PluginFunctionHandler>;
+/**
+ * Allocate a unique index into {@link pluginFunctionRegistry} for a package's
+ * plugin function.
+ *
+ * Call once per function, typically at module scope, right where the
+ * function is defined, and store the result in a constant. Don't hardcode
+ * an index: two packages independently picking the same arbitrary number
+ * would silently overwrite each other's handler in the shared registry.
+ *
+ * @throws If the index pool is exhausted (up to 65536: two opcode-stream bytes
+ *         via CALL_PLUGIN_WIDE, the first 256 via the one-byte CALL_PLUGIN).
+ */
+declare function allocatePluginFunctionIndex(): number;
+/**
+ * The stable index for a package's named plugin function, allocated once per
+ * `${packageName}:${functionName}` and cached process-wide, so the same function
+ * always maps to the same {@link pluginFunctionRegistry} slot no matter which
+ * engine registers it or in what order: the property compiled bytecode, and so
+ * a snapshot, relies on.
+ *
+ * The engine calls this at {@link ExpressionEngine.registerPackage} time for each
+ * entry of a package's `pluginFunctions` record, so a package author names the
+ * function and never sees an index. {@link allocatePluginFunctionIndex} remains
+ * for a host that needs a raw index directly.
+ */
+declare function pluginFunctionIndexFor(qualifiedName: string): number;
+/**
+ * A package-registered `as <name>` converter: the value on the left of `as`
+ * in, the converted value out.
+ *
+ * The optional `context` is the per-line execution context the VM passes to
+ * a plugin function, handed to a converter for the same reason: a converter
+ * that reads a date computes through the engine's calendar backend on it
+ * rather than a module-level default, so `<date> as weekday` and `weekday on
+ * <date>` cannot disagree. A converter that needs nothing from it ignores it.
+ */
+type AsConverter = (value: Value, context?: LineExecutionContext) => Value;
+
+export { type AsConverter as A, type Bytecode as B, DependencyGraph as D, type ExpressionRecord as E, type LineExecutionContext as L, OpRegistry as O, type PluginFunctionHandler as P, ScopeManager as S, type VM as V, allocatePluginFunctionIndex as a, builtinFunctions as b, createVM as c, pluginFunctionRegistry as d, executeBytecode as e, type DagSnapshot as f, type EngineContext as g, pluginFunctionIndexFor as p, sharedOpRegistry as s };

package/dist/{ScopeManager-CdwX0VTw.d.cts → VMBuiltins-kv4rr0y5.d.cts}

@@ -1,7 +1,8 @@
-import { V as Value } from './Value-Ds3Gy07C.cjs';
+import { V as Value } from './Value-BYHw-x7q.cjs';
 import { U as UserFunctionDef, A as AnonymousBodyDef, a as BytecodeProgram } from './BytecodeBuilder-DSWKZi4f.cjs';
-import { E as EngineError } from './EngineError-fR1K1rvx.cjs';
-import { D as DiagnosticPipeline } from './pipeline-69q2tsLE.cjs';
+import { C as CalendarBackend } from './CalendarBackend-MdS3Bb4P.cjs';
+import { E as EngineError } from './EngineError-C-kBwYlN.cjs';
+import { D as DiagnosticPipeline } from './pipeline-BYkKNpql.cjs';
 
 /**
  * Create a new VM instance with the given opcode registry and configurable limits.
@@ -83,6 +84,14 @@ interface LineExecutionContext {
      * message that describes a different fault. Absent means enabled.
      */
     networkEnabled?: boolean;
+    /**
+     * The calendar backend this engine computes dates with (`EngineContext.calendar`).
+     * A plugin function that reads or steps a date computes through it, so the
+     * date it answers agrees with the one the VM's own opcodes would produce.
+     * Absent means the `Date` backend; `calendarOf()` in
+     * `calendar/DateCalendar.ts` resolves either case.
+     */
+    calendar?: CalendarBackend;
     /** Look up another line's cached result by 1-based line number. `undefined` = not evaluated yet (or out of range), distinct from a line that evaluated to an actual `undefined`-like Value, which can't happen (every Value type has a concrete representation). */
     getLineResult?: (lineNumber: number) => Value | undefined;
     /** Whether line `lineNumber` is a blank line or a `#` heading, the stopping condition for "total above"/"sum above"/"average above" aggregation. */
@@ -190,11 +199,13 @@ declare function executeBytecode(bytecode: Bytecode, vm: VM, pipeline?: Diagnost
  * by that engine. Anything that needs one of these registries receives the
  * context rather than importing a singleton.
  *
- * Runtime imports here are restricted to leaf modules of `vm/`. This file is
- * imported by `vm/`, which `engine/` imports in turn, so pulling in anything
- * that reaches back into `engine/` would close a cycle. `OpRegistry` is safe
- * because it imports only types plus the error factory. Everything else arrives
- * through `import type`, which is erased before the code runs.
+ * Runtime imports here are restricted to leaf modules of `vm/` and
+ * `calendar/`. This file is imported by `vm/`, which `engine/` imports in
+ * turn, so pulling in anything that reaches back into `engine/` would close a
+ * cycle. `OpRegistry` is safe because it imports only types plus the error
+ * factory, and the `Date` calendar backend imports nothing of the engine's at
+ * all. Everything else arrives through `import type`, which is erased before
+ * the code runs.
  */
 
 /**
@@ -268,6 +279,18 @@ interface EngineContext {
      * the context is the one object every VM already holds.
      */
     readonly networkEnabled: boolean;
+    /**
+     * The calendar this engine computes dates with, from the engine's
+     * `calendar` option.
+     *
+     * One backend per engine, held here for the same reason the network
+     * switch is: the VM is where a date literal is stepped, a working-day
+     * walk runs and `now` is read, and every plugin function that touches a
+     * date reaches it through the execution context the VM builds from this
+     * one object. Defaults to Temporal where the runtime has it and `Date`
+     * where it does not. See `calendar/resolveCalendar.ts`.
+     */
+    readonly calendar: CalendarBackend;
 }
 
 /**
@@ -705,4 +728,63 @@ declare class ScopeManager {
     clear(): void;
 }
 
-export { type Bytecode as B, DependencyGraph as D, type ExpressionRecord as E, OpRegistry as O, type PluginFunctionHandler as P, ScopeManager as S, type VM as V, type DagSnapshot as a, type EngineContext as b, createVM as c, executeBytecode as e, sharedOpRegistry as s };
+/**
+ * Registry of built-in mathematical functions.
+ * Indexed by the number pushed as an operand of OpCode.CALL_BUILTIN.
+ */
+declare const builtinFunctions: Record<number, (args: Value[]) => Value>;
+/**
+ * Registry of package-registered functions, indexed by the number pushed as an
+ * operand of `OpCode.CALL_PLUGIN`.
+ *
+ * Functions may return a promise. The orchestrator resolves it and re-executes
+ * rather than blocking the VM.
+ *
+ * Populated declaratively via {@link IEnginePackage.pluginFunctions} at
+ * package-registration time. Entries are cleared on unregister.
+ *
+ * @deprecated This is the {@link defaultEngineContext}'s map, kept as a
+ * module-level alias so existing callers keep working during the context
+ * migration. An engine registers into its own context, so writing here affects
+ * only code that has not been migrated. Take an {@link EngineContext} instead.
+ */
+declare const pluginFunctionRegistry: Record<number, PluginFunctionHandler>;
+/**
+ * Allocate a unique index into {@link pluginFunctionRegistry} for a package's
+ * plugin function.
+ *
+ * Call once per function, typically at module scope, right where the
+ * function is defined, and store the result in a constant. Don't hardcode
+ * an index: two packages independently picking the same arbitrary number
+ * would silently overwrite each other's handler in the shared registry.
+ *
+ * @throws If the index pool is exhausted (up to 65536: two opcode-stream bytes
+ *         via CALL_PLUGIN_WIDE, the first 256 via the one-byte CALL_PLUGIN).
+ */
+declare function allocatePluginFunctionIndex(): number;
+/**
+ * The stable index for a package's named plugin function, allocated once per
+ * `${packageName}:${functionName}` and cached process-wide, so the same function
+ * always maps to the same {@link pluginFunctionRegistry} slot no matter which
+ * engine registers it or in what order: the property compiled bytecode, and so
+ * a snapshot, relies on.
+ *
+ * The engine calls this at {@link ExpressionEngine.registerPackage} time for each
+ * entry of a package's `pluginFunctions` record, so a package author names the
+ * function and never sees an index. {@link allocatePluginFunctionIndex} remains
+ * for a host that needs a raw index directly.
+ */
+declare function pluginFunctionIndexFor(qualifiedName: string): number;
+/**
+ * A package-registered `as <name>` converter: the value on the left of `as`
+ * in, the converted value out.
+ *
+ * The optional `context` is the per-line execution context the VM passes to
+ * a plugin function, handed to a converter for the same reason: a converter
+ * that reads a date computes through the engine's calendar backend on it
+ * rather than a module-level default, so `<date> as weekday` and `weekday on
+ * <date>` cannot disagree. A converter that needs nothing from it ignores it.
+ */
+type AsConverter = (value: Value, context?: LineExecutionContext) => Value;
+
+export { type AsConverter as A, type Bytecode as B, DependencyGraph as D, type ExpressionRecord as E, type LineExecutionContext as L, OpRegistry as O, type PluginFunctionHandler as P, ScopeManager as S, type VM as V, allocatePluginFunctionIndex as a, builtinFunctions as b, createVM as c, pluginFunctionRegistry as d, executeBytecode as e, type DagSnapshot as f, type EngineContext as g, pluginFunctionIndexFor as p, sharedOpRegistry as s };

package/dist/{VMCheckpoints-DDlxNssY.d.ts → VMCheckpoints-DXze6ypg.d.ts}

@@ -1,5 +1,5 @@
-import { V as Value } from './Value-Ds3Gy07C.js';
-import { V as VM } from './ScopeManager-B636am7Y.js';
+import { V as Value } from './Value-BYHw-x7q.js';
+import { V as VM } from './VMBuiltins-CZiZRKn-.js';
 import { U as UserFunctionDef } from './BytecodeBuilder-DSWKZi4f.js';
 
 /**

package/dist/{VMCheckpoints-CYqeq8IV.d.cts → VMCheckpoints-yun4ocSv.d.cts}

@@ -1,5 +1,5 @@
-import { V as Value } from './Value-Ds3Gy07C.cjs';
-import { V as VM } from './ScopeManager-CdwX0VTw.cjs';
+import { V as Value } from './Value-BYHw-x7q.cjs';
+import { V as VM } from './VMBuiltins-kv4rr0y5.cjs';
 import { U as UserFunctionDef } from './BytecodeBuilder-DSWKZi4f.cjs';
 
 /**

package/dist/{Value-Ds3Gy07C.d.cts → Value-BYHw-x7q.d.cts}

@@ -250,6 +250,23 @@ interface SplitData {
  * switches on `kind` keeps working for the ones it already knows.
  */
 type ChartKind = "sparkline" | "plot";
+/**
+ * What a `Datetime`'s epoch-millisecond payload anchors.
+ *
+ * Three questions share one number and mean different things by it, which is
+ * why the distinction is recorded rather than inferred:
+ *
+ * - `date`: a calendar day, held as its local midnight (`2026-04-03`,
+ *   `3 April 2026`, `03/04/2026`). The time of day carries no meaning.
+ * - `datetime`: a wall-clock reading on a day, in the calendar backend's own
+ *   zone (`2026-04-03T09:30`, `6pm`). The reading is what was named; the
+ *   instant follows from the zone it is read in.
+ * - `instant`: a fixed point on the timeline, named without depending on a
+ *   zone (`2026-04-03T10:30:00Z`, `...+09:00`, `now`).
+ *
+ * See {@link Value.grain} for why the number cannot answer this on its own.
+ */
+type DatetimeGrain = "date" | "datetime" | "instant";
 /**
  * A chart specification: the DATA to draw, never pixels. One shape holds every
  * visual the engine produces, `[1,2,3] as sparkline` and `plot sin(x) from 0 to
@@ -407,6 +424,45 @@ declare class Value {
      * by {@link recycle} alongside the other sidecars.
      */
     decimalPlaces?: number;
+    /**
+     * What this instant anchors: a calendar day, a wall-clock reading on one, or
+     * a fixed point on the timeline.
+     *
+     * The fifth sidecar, the same shape as {@link exact}, {@link rational},
+     * {@link uncertainty} and {@link decimalPlaces} and for the same reason: a
+     * `Datetime`'s payload is epoch milliseconds and has to stay a plain number,
+     * because the arena union, the worker DTO, the snapshot's Datetime variant
+     * and the `Datetime` SUB path all read it as one. The number cannot say
+     * which of three questions it is the answer to, and the difference is not
+     * recoverable from it: `formatDatetime` decides whether to print a time by
+     * testing whether the local hour, minute, second and millisecond are all
+     * zero, which is a guess that `2026-04-03T09:00:00+09:00` under `TZ=UTC`
+     * gets wrong, because the nine o'clock the reader typed IS UTC midnight.
+     *
+     * Set only where the shape is known: a date literal is `'date'`, a
+     * wall-clock literal (`2026-04-03T09:30`, `6pm`) is `'datetime'`, a literal
+     * carrying `Z` or an offset is `'instant'`, and so is `now`. Absent means
+     * not recorded, which every reader treats as an instant rather than
+     * inferring one. Nothing in 2.26.0 displays it: the formatter does not read
+     * it, so every rendered date is byte-identical to 2.25.0. Cleared by
+     * {@link recycle} alongside the other sidecars.
+     */
+    grain?: DatetimeGrain;
+    /**
+     * The zone this instant should be read and displayed in, when the line
+     * named one.
+     *
+     * A zone reference in the encoding `calendar/IntlZone.ts` documents: an IANA
+     * name (`"Asia/Tokyo"`) or a fixed offset (`"UTCOFFSET:540"`). Set by
+     * `<datetime> in <zone>` and by an ISO literal carrying `Z` or an explicit
+     * offset, which names an offset rather than a zone and so records one.
+     * Absent means the value is read in the calendar backend's own zone, which
+     * is what every `Datetime` meant before this sidecar existed. Like
+     * {@link grain} it is recorded and readable in 2.26.0 and read by the
+     * formatter from 3.0. Cleared by {@link recycle} alongside the other
+     * sidecars.
+     */
+    zone?: string;
     constructor(type: ValueType, value: number | bigint | string | boolean | MatrixData | RangeData | ColourData | SplitData | ChartData | IpCidrData | SymbolicNode, unit?: string);
     /**
      * Phase 5.3: Reset all fields for arena reuse.
@@ -533,4 +589,4 @@ declare function colVectorValue(data: readonly number[]): Value;
 /** Create a Range value, a first-class integer range `min:max`, both bounds inclusive. */
 declare function rangeValue(min: number, max: number): Value;
 
-export { type ColourData as C, type IpCidrData as I, type MatrixData as M, type RangeData as R, type SplitData as S, Value as V, ValueType as a, type MatrixEntry as b, bigIntValue as c, colVectorValue as d, rowVectorValue as e, type ChartData as f, type SymbolicNode as g, hexValue as h, type ColourFormat as i, matrixValue as m, numberValue as n, rangeValue as r, stringValue as s, uomValue as u };
+export { type ColourData as C, type DatetimeGrain as D, type IpCidrData as I, type MatrixData as M, type RangeData as R, type SplitData as S, Value as V, type MatrixEntry as a, ValueType as b, bigIntValue as c, colVectorValue as d, rowVectorValue as e, type ChartData as f, type SymbolicNode as g, hexValue as h, type ColourFormat as i, matrixValue as m, numberValue as n, rangeValue as r, stringValue as s, uomValue as u };

package/dist/{Value-Ds3Gy07C.d.ts → Value-BYHw-x7q.d.ts}

@@ -250,6 +250,23 @@ interface SplitData {
  * switches on `kind` keeps working for the ones it already knows.
  */
 type ChartKind = "sparkline" | "plot";
+/**
+ * What a `Datetime`'s epoch-millisecond payload anchors.
+ *
+ * Three questions share one number and mean different things by it, which is
+ * why the distinction is recorded rather than inferred:
+ *
+ * - `date`: a calendar day, held as its local midnight (`2026-04-03`,
+ *   `3 April 2026`, `03/04/2026`). The time of day carries no meaning.
+ * - `datetime`: a wall-clock reading on a day, in the calendar backend's own
+ *   zone (`2026-04-03T09:30`, `6pm`). The reading is what was named; the
+ *   instant follows from the zone it is read in.
+ * - `instant`: a fixed point on the timeline, named without depending on a
+ *   zone (`2026-04-03T10:30:00Z`, `...+09:00`, `now`).
+ *
+ * See {@link Value.grain} for why the number cannot answer this on its own.
+ */
+type DatetimeGrain = "date" | "datetime" | "instant";
 /**
  * A chart specification: the DATA to draw, never pixels. One shape holds every
  * visual the engine produces, `[1,2,3] as sparkline` and `plot sin(x) from 0 to
@@ -407,6 +424,45 @@ declare class Value {
      * by {@link recycle} alongside the other sidecars.
      */
     decimalPlaces?: number;
+    /**
+     * What this instant anchors: a calendar day, a wall-clock reading on one, or
+     * a fixed point on the timeline.
+     *
+     * The fifth sidecar, the same shape as {@link exact}, {@link rational},
+     * {@link uncertainty} and {@link decimalPlaces} and for the same reason: a
+     * `Datetime`'s payload is epoch milliseconds and has to stay a plain number,
+     * because the arena union, the worker DTO, the snapshot's Datetime variant
+     * and the `Datetime` SUB path all read it as one. The number cannot say
+     * which of three questions it is the answer to, and the difference is not
+     * recoverable from it: `formatDatetime` decides whether to print a time by
+     * testing whether the local hour, minute, second and millisecond are all
+     * zero, which is a guess that `2026-04-03T09:00:00+09:00` under `TZ=UTC`
+     * gets wrong, because the nine o'clock the reader typed IS UTC midnight.
+     *
+     * Set only where the shape is known: a date literal is `'date'`, a
+     * wall-clock literal (`2026-04-03T09:30`, `6pm`) is `'datetime'`, a literal
+     * carrying `Z` or an offset is `'instant'`, and so is `now`. Absent means
+     * not recorded, which every reader treats as an instant rather than
+     * inferring one. Nothing in 2.26.0 displays it: the formatter does not read
+     * it, so every rendered date is byte-identical to 2.25.0. Cleared by
+     * {@link recycle} alongside the other sidecars.
+     */
+    grain?: DatetimeGrain;
+    /**
+     * The zone this instant should be read and displayed in, when the line
+     * named one.
+     *
+     * A zone reference in the encoding `calendar/IntlZone.ts` documents: an IANA
+     * name (`"Asia/Tokyo"`) or a fixed offset (`"UTCOFFSET:540"`). Set by
+     * `<datetime> in <zone>` and by an ISO literal carrying `Z` or an explicit
+     * offset, which names an offset rather than a zone and so records one.
+     * Absent means the value is read in the calendar backend's own zone, which
+     * is what every `Datetime` meant before this sidecar existed. Like
+     * {@link grain} it is recorded and readable in 2.26.0 and read by the
+     * formatter from 3.0. Cleared by {@link recycle} alongside the other
+     * sidecars.
+     */
+    zone?: string;
     constructor(type: ValueType, value: number | bigint | string | boolean | MatrixData | RangeData | ColourData | SplitData | ChartData | IpCidrData | SymbolicNode, unit?: string);
     /**
      * Phase 5.3: Reset all fields for arena reuse.
@@ -533,4 +589,4 @@ declare function colVectorValue(data: readonly number[]): Value;
 /** Create a Range value, a first-class integer range `min:max`, both bounds inclusive. */
 declare function rangeValue(min: number, max: number): Value;
 
-export { type ColourData as C, type IpCidrData as I, type MatrixData as M, type RangeData as R, type SplitData as S, Value as V, ValueType as a, type MatrixEntry as b, bigIntValue as c, colVectorValue as d, rowVectorValue as e, type ChartData as f, type SymbolicNode as g, hexValue as h, type ColourFormat as i, matrixValue as m, numberValue as n, rangeValue as r, stringValue as s, uomValue as u };
+export { type ColourData as C, type DatetimeGrain as D, type IpCidrData as I, type MatrixData as M, type RangeData as R, type SplitData as S, Value as V, type MatrixEntry as a, ValueType as b, bigIntValue as c, colVectorValue as d, rowVectorValue as e, type ChartData as f, type SymbolicNode as g, hexValue as h, type ColourFormat as i, matrixValue as m, numberValue as n, rangeValue as r, stringValue as s, uomValue as u };

package/dist/{WorkerError-B1dF3VYT.d.cts → WorkerError-BLZyNq6M.d.cts}

@@ -1,4 +1,4 @@
-import { c as ErrorCategory, S as SourceSpan, E as EngineError } from './EngineError-fR1K1rvx.cjs';
+import { c as ErrorCategory, S as SourceSpan, E as EngineError } from './EngineError-C-kBwYlN.cjs';
 
 /**
  * Structured errors for the off-main-thread worker harness, and the pair of

package/dist/{WorkerError-dneODN-u.d.ts → WorkerError-CfBJYueR.d.ts}

@@ -1,4 +1,4 @@
-import { c as ErrorCategory, S as SourceSpan, E as EngineError } from './EngineError-fR1K1rvx.js';
+import { c as ErrorCategory, S as SourceSpan, E as EngineError } from './EngineError-C-kBwYlN.js';
 
 /**
  * Structured errors for the off-main-thread worker harness, and the pair of

package/dist/chunk-2SYYKQ4Q.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunkHG4NPDN5_cjs=require('./chunk-HG4NPDN5.cjs'),chunkZDJTDFTR_cjs=require('./chunk-ZDJTDFTR.cjs'),chunkTPPM4QSS_cjs=require('./chunk-TPPM4QSS.cjs'),chunkYBQOQTVL_cjs=require('./chunk-YBQOQTVL.cjs'),chunkS3DFU33X_cjs=require('./chunk-S3DFU33X.cjs'),chunkGXO7TSXQ_cjs=require('./chunk-GXO7TSXQ.cjs');var D=/^\d{1,3}(\.\d{3}){2,}$/,T=/^\d*\.\d*$/,n=class n{constructor(e,t=50,r="en",l,a=chunkTPPM4QSS_cjs.b){this.tokens=[];this.current=0;this.depth=0;this.currentExpression="";this.infixMinBindingPower=0;this.registry=e,this.maxDepth=t,this.localeCode=r;let p=chunkS3DFU33X_cjs.a(r).display;this.decimalSeparator=p.decimalSeparator,this.thousandsSeparator=p.thousandsSeparator,this.pluginFunctionIndex=l,this.calendar=a;}getLocaleCode(){return this.localeCode}getCalendar(){return this.calendar}setDiagnosticPipeline(e,t){this.diagnosticPipeline=e,this.currentExpression=t??"";}load(e,t){if(t===false){this.tokens=e,this.current=0,this.depth=0;return}let r=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.LPAREN),l=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.RPAREN),a=0;for(let p=0;p<e.length;p++)e[p].typeId===r?a++:e[p].typeId===l&&a--;this.tokens=a===0?e:this.balanceParens(e,a),this.current=0,this.depth=0;}balanceParens(e,t){let r=e.slice();if(t>0){let l=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.RPAREN);for(let a=0;a<t;a++){let p=e[e.length-1];r.push({type:chunkYBQOQTVL_cjs.a.RPAREN,typeId:l,value:")",text:")",offset:p?p.offset+p.text.length:0,lineBreaks:0,line:p?p.line:1,col:p?p.col+p.text.length:1});}}else if(t<0){let l=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.LPAREN);for(let a=0;a<-t;a++)r.unshift({type:chunkYBQOQTVL_cjs.a.LPAREN,typeId:l,value:"(",text:"(",offset:0,lineBreaks:0,line:1,col:1});}return r}parseExpression(e=0,t){let r=this.builder;t&&(this.builder=t),this.depth++;try{if(this.depth>this.maxDepth)throw chunkGXO7TSXQ_cjs.c.parsing("NESTING_DEPTH_EXCEEDED",`Parse nesting depth ${this.depth} exceeds maximum of ${this.maxDepth}`,{maxDepth:this.maxDepth,currentDepth:this.depth});this.parseExpressionBody(e);}finally{this.depth--,t&&(this.builder=r);}}parseExpressionBody(e){let t=this.consume();if(!t)throw chunkGXO7TSXQ_cjs.c.parsing({code:"UNEXPECTED_END",message:"Unexpected end of expression",span:this.spanAtEnd()});this.parsePrefix(t);let r=this.tokens,l=r.length,a=n.BP_TABLE,p=this.registry,o=this.builder,h=this.current;for(;h<l;){let d=r[h];if(!d)break;let c=a[d.typeId];if(c>0){if(c<=e)break;if(this.diagnosticPipeline){let I=p.getInfix(d.typeId);I&&this.fireParseletMatched(I,d,false,c);}this.current=++h;let f=d.typeId;if(f===n.PERCENT_ID)o.emitOpcode(10),o.emitNumber(100),o.emitOpcode(23),o.emitOpcode(74);else if(!(f===n.CARET_ID&&this.tryEmitMatrixCaretOp(o))){let I=f===n.CARET_ID?c-1:c+1;this.parseExpression(I,o),o.emitOpcode(n.INFIX_OPCODE[f]);}}else {let f=p.getInfix(d.typeId);if(!f||f.bindingPower<=e)break;this.current=++h,this.diagnosticPipeline&&this.fireParseletMatched(f,d,false,f.bindingPower);let I=this.infixMinBindingPower;this.infixMinBindingPower=e;try{f.parse(this,t,d,o);}finally{this.infixMinBindingPower=I;}}h=this.current;}this.current=h;}parsePrefix(e){let t=this.builder,r=e.typeId;if(this.diagnosticPipeline){let a=this.registry.getPrefix(r);a&&this.fireParseletMatched(a,e,true);}switch(r){case n.NUMBER_ID:{let a,p=null,o=e.value;if(this.decimalSeparator==="."){let h=0,d=o.length>0;for(let c=0;c<o.length;c++){let f=o.charCodeAt(c);if(!(f>=48&&f<=57)){if(f===46&&h===0){h=1;continue}d=false;break}}if(d){if(h===1){t.emitOpcode(16),t.emitString(o);return}t.emitOpcode(10),t.emitNumber(+o);return}}if(o.startsWith("0x")||o.startsWith("0X")){if(a=parseInt(o,16),Number.isNaN(a))throw chunkGXO7TSXQ_cjs.c.parsing({code:"INVALID_NUMBER_LITERAL",message:`Invalid hex literal: "${o}"`,context:{raw:o},span:this.spanOf(e)})}else if(o.startsWith("0b")||o.startsWith("0B")){if(a=parseInt(o.slice(2),2),Number.isNaN(a))throw chunkGXO7TSXQ_cjs.c.parsing({code:"INVALID_NUMBER_LITERAL",message:`Invalid binary literal: "${o}"`,context:{raw:o},span:this.spanOf(e)})}else if(o.startsWith("0o")||o.startsWith("0O")){if(a=parseInt(o.slice(2),8),Number.isNaN(a))throw chunkGXO7TSXQ_cjs.c.parsing({code:"INVALID_NUMBER_LITERAL",message:`Invalid octal literal: "${o}"`,context:{raw:o},span:this.spanOf(e)})}else if(D.test(o))a=parseFloat(o.split(".").join(""));else {let h=this.decimalSeparator,d=this.thousandsSeparator,c=o;d&&c.indexOf(d)!==-1&&(c=c.split(d).join("")),h&&h!=="."&&(c=c.replace(h,".")),a=parseFloat(c),T.test(c)&&(p=c);}if(p!==null){t.emitOpcode(16),t.emitString(p);return}t.emitOpcode(10),t.emitNumber(a);return}case n.BIGINT_ID:{t.emitOpcode(11),t.emitString(chunkZDJTDFTR_cjs.e(e.value,this.localeCode));return}case n.STRING_ID:{t.emitOpcode(13),t.emitString(e.value);return}case n.IDENT_ID:{if(this.peek()?.typeId===n.LPAREN_ID){this.parseUserFunctionDefOrCall(e,t);return}t.emitOpcode(60),t.emitString(e.value);return}case n.LPAREN_ID:{this.parseExpression(0,t);let a=1;for(;this.match(chunkYBQOQTVL_cjs.a.COMMA);)this.parseExpression(0,t),a++;this.consume(chunkYBQOQTVL_cjs.a.RPAREN),a>1&&(t.emitOpcode(152),t.emitIndex(1),t.emitIndex(a));return}case n.MINUS_ID:{this.parseExpression(chunkZDJTDFTR_cjs.a.Prefix,t),t.emitOpcode(26);return}case n.PLUS_ID:{this.parseExpression(chunkZDJTDFTR_cjs.a.Prefix,t),t.emitOpcode(27);return}case n.KEYWORD_ID:}let l=this.registry.getPrefix(r);if(!l)throw chunkGXO7TSXQ_cjs.c.parsing({code:"NO_PREFIX_PARSELET",message:`No prefix parselet found for token: ${e.type} ("${e.value}")`,context:{tokenType:e.type,tokenValue:e.value},span:this.spanOf(e)});l.parse(this,e,t);}tryEmitMatrixCaretOp(e){for(let t of n.CARET_SUFFIX_RULES)if(t.matches(this))return t.emit(this,e),true;return  false}findMatchingRParen(e){let t=0;for(let r=e;r<this.tokens.length;r++){let l=this.tokens[r];if(l.typeId===n.LPAREN_ID)t++;else if(l.typeId===n.RPAREN_ID&&(t--,t===0))return r}return null}parseUserFunctionDefOrCall(e,t){let r=this.findMatchingRParen(this.current);if(r===null){t.emitOpcode(60),t.emitString(e.value);return}this.tokens[r+1]?.type===chunkYBQOQTVL_cjs.a.EQUALS?this.parseUserFunctionDefinition(e,t):this.parseUserFunctionCall(e,t);}consumeParamName(){let e=this.peek();if(e?.type===chunkYBQOQTVL_cjs.a.IDENT||e?.type===chunkYBQOQTVL_cjs.a.UNIT)return this.consume(),e.value;throw chunkGXO7TSXQ_cjs.c.parsing({code:"USER_FUNCTION_INVALID_PARAM_NAME",message:`Expected a parameter name but got "${e?.type??"end of input"}"${e?` ("${e.value}")`:""}`,context:{actualType:e?.type},span:e?this.spanOf(e):this.spanAtEnd()})}parseUserFunctionDefinition(e,t){this.consume(chunkYBQOQTVL_cjs.a.LPAREN);let r=[];if(this.peek()?.type!==chunkYBQOQTVL_cjs.a.RPAREN)for(r.push(this.consumeParamName());this.match(chunkYBQOQTVL_cjs.a.COMMA);)r.push(this.consumeParamName());if(this.consume(chunkYBQOQTVL_cjs.a.RPAREN),this.consume(chunkYBQOQTVL_cjs.a.EQUALS),r.length===0)throw chunkGXO7TSXQ_cjs.c.parsing({code:"USER_FUNCTION_NO_PARAMS",message:`"${e.value}()" has no parameters -- user-defined functions need at least one (a zero-argument definition is indistinguishable from a plain function CALL with no args, which this grammar doesn't otherwise support)`,context:{name:e.value},span:this.spanOf(e)});let l=new chunkZDJTDFTR_cjs.d(this.pluginFunctionIndex);this.parseExpression(chunkZDJTDFTR_cjs.a.Lowest,l),this.setBuilder(t);let a=l.build();if(a.hasAsync)throw chunkGXO7TSXQ_cjs.c.parsing({code:"FUNCTION_BODY_MUST_BE_SYNCHRONOUS",message:`"${e.value}(...)"'s body calls an async operation (weather, stocks, currency, ...) \u2014 user-defined function bodies must be synchronous`,context:{name:e.value},span:this.spanOf(e)});let p=t.emitUserFunctionBody(e.value,r,a);t.emitOpcode(150),t.emitIndex(p),t.emitOpcode(13),t.emitString(`${e.value}(${r.join(", ")}) defined`);}parseUserFunctionCall(e,t){this.consume(chunkYBQOQTVL_cjs.a.LPAREN);let r=0;if(this.peek()?.type!==chunkYBQOQTVL_cjs.a.RPAREN)for(this.parseExpression(chunkZDJTDFTR_cjs.a.Lowest,t),r++;this.match(chunkYBQOQTVL_cjs.a.COMMA);)this.parseExpression(chunkZDJTDFTR_cjs.a.Lowest,t),r++;this.consume(chunkYBQOQTVL_cjs.a.RPAREN),t.emitOpcode(151),t.emitString(e.value),t.emitByte(r);}spanOf(e){return {start:e.offset,end:e.sourceEnd??e.offset+e.text.length,line:e.line,col:e.col}}spanAtEnd(){let e=this.tokens[this.tokens.length-1];if(!e)return {start:0,end:0};let t=e.sourceEnd??e.offset+e.text.length;return {start:t,end:t,line:e.line,col:e.col+(t-e.offset)}}consume(e){let t=this.tokens[this.current];if(!t)throw chunkGXO7TSXQ_cjs.c.parsing({code:"UNEXPECTED_END_OF_INPUT",message:"Unexpected end of input",span:this.spanAtEnd()});if(e!==void 0){let r=chunkYBQOQTVL_cjs.c(e);if(t.typeId!==r)throw chunkGXO7TSXQ_cjs.c.parsing({code:"UNEXPECTED_TOKEN_TYPE",message:`Expected token type "${e}" but got "${t.type}" ("${t.value}")`,context:{expectedType:e,actualType:t.type,actualValue:t.value},span:this.spanOf(t)})}return this.current++,t}match(e){let t=this.peek();return t&&t.typeId===chunkYBQOQTVL_cjs.c(e)?(this.advance(),true):false}peek(){return this.tokens[this.current]}peekAt(e){return this.tokens[this.current+e]}previous(){return this.current>0?this.tokens[this.current-1]:void 0}advance(){this.current++;}setBuilder(e){this.builder=e;}fireParseletMatched(e,t,r,l){let a=this.diagnosticPipeline,p={type:chunkHG4NPDN5_cjs.c.ParseletMatched,elapsedNs:0,expression:this.currentExpression,tokenType:t.type,tokenValue:t.value,parseletCategory:e.category,parseletType:e.constructor?.name??"unknown",isPrefix:r,bindingPower:l,tokenOffset:t.offset||0};a.fireParseletMatched(p);}};n.BP_TABLE=chunkZDJTDFTR_cjs.b(),n.NUMBER_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.NUMBER),n.BIGINT_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.BIGINT),n.STRING_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.STRING),n.IDENT_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.IDENT),n.LPAREN_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.LPAREN),n.RPAREN_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.RPAREN),n.MINUS_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.MINUS),n.PLUS_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.PLUS),n.KEYWORD_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.KEYWORD),n.STAR_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.STAR),n.SLASH_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.SLASH),n.MOD_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.MOD),n.CARET_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.CARET),n.LSHIFT_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.LSHIFT),n.RSHIFT_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.RSHIFT),n.URSHIFT_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.URSHIFT),n.BIT_AND_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.BIT_AND),n.BIT_OR_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.BIT_OR),n.BIT_XOR_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.BIT_XOR),n.PERCENT_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.PERCENT),n.OF_ID=chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.OF),n.INFIX_OPCODE={[chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.PLUS)]:20,[chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.MINUS)]:21,[chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.STAR)]:22,[chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.SLASH)]:23,[chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.MOD)]:24,[chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.CARET)]:25,[chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.LSHIFT)]:30,[chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.RSHIFT)]:31,[chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.URSHIFT)]:32,[chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.BIT_AND)]:33,[chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.BIT_OR)]:34,[chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.BIT_XOR)]:35,[chunkYBQOQTVL_cjs.c(chunkYBQOQTVL_cjs.a.OF)]:22},n.CARET_SUFFIX_RULES=[{name:"transpose (^T)",matches:e=>{let t=e.peek();return t?.type===chunkYBQOQTVL_cjs.a.IDENT&&t.value==="T"},emit:(e,t)=>{e.advance(),t.emitOpcode(51),t.emitIndex(63),t.emitIndex(1);}},{name:"inverse (^-1)",matches:e=>{if(e.peek()?.typeId!==n.MINUS_ID)return  false;let r=e.peekAt(1);return r?.type===chunkYBQOQTVL_cjs.a.NUMBER&&r.value==="1"},emit:(e,t)=>{e.advance(),e.advance(),t.emitOpcode(51),t.emitIndex(65),t.emitIndex(1);}}];var v=n;var m=class{constructor(){this.prefixParselets=new Map;this.infixParselets=new Map;this.prefixById=new Map;this.infixById=new Map;}registerPrefix(e,t){let r=this.prefixParselets.get(e);r&&r!==t&&console.warn(`[ParseletRegistry] Prefix parselet for token "${e}" is already registered (category: "${r.category??"unknown"}"). Overwriting with a new parselet (category: "${t.category??"unknown"}") \u2014 the previous parselet is now unreachable. Two packages may be claiming the same token type.`),this.prefixParselets.set(e,t),this.prefixById.set(chunkYBQOQTVL_cjs.c(e),t);}registerInfix(e,t){let r=this.infixParselets.get(e);r&&r!==t&&console.warn(`[ParseletRegistry] Infix parselet for token "${e}" is already registered (category: "${r.category??"unknown"}"). Overwriting with a new parselet (category: "${t.category??"unknown"}") \u2014 the previous parselet is now unreachable. Two packages may be claiming the same token type.`),this.infixParselets.set(e,t),this.infixById.set(chunkYBQOQTVL_cjs.c(e),t);}getAllPrefix(){let e=[];for(let[t,r]of this.prefixParselets)e.push({tokenType:t,bindingPower:r.bindingPower??chunkZDJTDFTR_cjs.a.Prefix,category:r.category});return e}getAllInfix(){let e=[];for(let[t,r]of this.infixParselets){let l=r.bindingPower??0;e.push({tokenType:t,leftBindingPower:l,rightBindingPower:l+1,category:r.category});}return e}get prefixCount(){return this.prefixParselets.size}get infixCount(){return this.infixParselets.size}getPrefix(e){return typeof e=="number"?this.prefixById.get(e):this.prefixParselets.get(e)}getInfix(e){return typeof e=="number"?this.infixById.get(e):this.infixParselets.get(e)}hasPrefix(e){return this.prefixParselets.has(e)}hasInfix(e){return this.infixParselets.has(e)}clear(){this.prefixParselets.clear(),this.infixParselets.clear(),this.prefixById.clear(),this.infixById.clear();}},$=new m;exports.a=v;exports.b=m;exports.c=$;//# sourceMappingURL=chunk-2SYYKQ4Q.cjs.map
+//# sourceMappingURL=chunk-2SYYKQ4Q.cjs.map