solve-engine 1.1.0 → 1.2.0

package/dist/{EngineError-B61GS1jp.d.cts → EngineError-CNA_rHY-.d.cts}

@@ -154,6 +154,12 @@ declare const CoreErrorCodes: {
     readonly THEREFORE_REQUIRES_EXPRESSION: "THEREFORE_REQUIRES_EXPRESSION";
     /** A `"=>"`-triggered expression called an async plugin (weather/stocks/currency). Same v1 scope restriction as user-function/map-reduce bodies. */
     readonly THEREFORE_ASYNC_UNSUPPORTED: "THEREFORE_ASYNC_UNSUPPORTED";
+    /** A compound assignment (`name += expr` / `name -= expr`) with nothing on the right, a line half-typed on the way to `total += 5`. */
+    readonly COMPOUND_ASSIGN_REQUIRES_EXPRESSION: "COMPOUND_ASSIGN_REQUIRES_EXPRESSION";
+    /** A running total (`+= / -=`) whose right-hand side calls an async plugin (weather/stocks/currency). The same v1 scope restriction as the `"=>"` and user-function bodies. */
+    readonly COMPOUND_ASSIGN_ASYNC_UNSUPPORTED: "COMPOUND_ASSIGN_ASYNC_UNSUPPORTED";
+    /** A savings-goal contribution period that is not one of daily/weekly/monthly/yearly (`how long to save $X at $Y <period>`). Names the accepted set. */
+    readonly UNKNOWN_SAVINGS_PERIOD: "UNKNOWN_SAVINGS_PERIOD";
     /** Colon-separated numbers that are not a time any clock can show ("24:00", "9:60", "100:5"). Raised by the labeled-line fallback, which used to answer them with whatever stood after the colon. */
     readonly INVALID_TIME_LITERAL: "INVALID_TIME_LITERAL";
     /** `fromJSON()` handed an object that is not a snapshot at all, or whose serialised-shape version does not match this engine's reader. The versioning gate that refuses an incompatible snapshot clearly rather than restoring it wrongly. See `engine/EngineSnapshot.ts`'s `assertRestorable()`. */

package/dist/{EngineError-B61GS1jp.d.ts → EngineError-CNA_rHY-.d.ts}

@@ -154,6 +154,12 @@ declare const CoreErrorCodes: {
     readonly THEREFORE_REQUIRES_EXPRESSION: "THEREFORE_REQUIRES_EXPRESSION";
     /** A `"=>"`-triggered expression called an async plugin (weather/stocks/currency). Same v1 scope restriction as user-function/map-reduce bodies. */
     readonly THEREFORE_ASYNC_UNSUPPORTED: "THEREFORE_ASYNC_UNSUPPORTED";
+    /** A compound assignment (`name += expr` / `name -= expr`) with nothing on the right, a line half-typed on the way to `total += 5`. */
+    readonly COMPOUND_ASSIGN_REQUIRES_EXPRESSION: "COMPOUND_ASSIGN_REQUIRES_EXPRESSION";
+    /** A running total (`+= / -=`) whose right-hand side calls an async plugin (weather/stocks/currency). The same v1 scope restriction as the `"=>"` and user-function bodies. */
+    readonly COMPOUND_ASSIGN_ASYNC_UNSUPPORTED: "COMPOUND_ASSIGN_ASYNC_UNSUPPORTED";
+    /** A savings-goal contribution period that is not one of daily/weekly/monthly/yearly (`how long to save $X at $Y <period>`). Names the accepted set. */
+    readonly UNKNOWN_SAVINGS_PERIOD: "UNKNOWN_SAVINGS_PERIOD";
     /** Colon-separated numbers that are not a time any clock can show ("24:00", "9:60", "100:5"). Raised by the labeled-line fallback, which used to answer them with whatever stood after the colon. */
     readonly INVALID_TIME_LITERAL: "INVALID_TIME_LITERAL";
     /** `fromJSON()` handed an object that is not a snapshot at all, or whose serialised-shape version does not match this engine's reader. The versioning gate that refuses an incompatible snapshot clearly rather than restoring it wrongly. See `engine/EngineSnapshot.ts`'s `assertRestorable()`. */

package/dist/{Lexer-BOs7euZe.d.cts → Lexer-B4C1qHXu.d.cts}

@@ -1,4 +1,4 @@
-import { T as Token } from './Token-B1hdkedD.cjs';
+import { T as Token } from './Token-CbP_OutD.cjs';
 
 /** Trie node for multi-word phrase matching. */
 interface PhraseNode {

package/dist/{Lexer-CSI_lwbW.d.ts → Lexer-DKMlj7Sy.d.ts}

@@ -1,4 +1,4 @@
-import { T as Token } from './Token-B1hdkedD.js';
+import { T as Token } from './Token-CbP_OutD.js';
 
 /** Trie node for multi-word phrase matching. */
 interface PhraseNode {

package/dist/{PackageCompatibility-B-7rK1TD.d.cts → PackageCompatibility-B6NX9IaN.d.cts}

@@ -1,4 +1,4 @@
-import { I as IEnginePackage } from './PackageRegistry-BHWJP83F.cjs';
+import { I as IEnginePackage } from './PackageRegistry-DnJYVw9G.cjs';
 
 /**
  * Package load-time compatibility checking, the "detect overlapping

package/dist/{PackageCompatibility-Dh59eF-X.d.ts → PackageCompatibility-Ceg5XdAp.d.ts}

@@ -1,4 +1,4 @@
-import { I as IEnginePackage } from './PackageRegistry-_8rDlvxI.js';
+import { I as IEnginePackage } from './PackageRegistry-DrCPQNyy.js';
 
 /**
  * Package load-time compatibility checking, the "detect overlapping

package/dist/{PackageRegistry-BHWJP83F.d.cts → PackageRegistry-DnJYVw9G.d.cts}

@@ -1,15 +1,15 @@
-import { a as PrecedenceParser, b as PrefixParselet, I as InfixParselet } from './Parselet-BHcgK9S7.cjs';
-import { V as Value, b as ValueType } from './Value-BUi1RA3S.cjs';
+import { a as PrecedenceParser, b as PrefixParselet, I as InfixParselet } from './Parselet-Cv7S7KRt.cjs';
+import { V as Value, b as ValueType } from './Value-DZNQ_PU7.cjs';
 import { IVariableSource } from './variables.cjs';
-import { M as MarkdownLineType, L as Lexer, e as TokenCategory, c as LexerVocabulary } from './Lexer-BOs7euZe.cjs';
+import { M as MarkdownLineType, L as Lexer, e as TokenCategory, c as LexerVocabulary } from './Lexer-B4C1qHXu.cjs';
 import { IAsyncResolver } from './resolvers.cjs';
-import { T as TokenFusion, c as TokenNormalizer, a as NormalizerRule } from './TokenNormalizer-DRc1Js1V.cjs';
-import { a as DependencyGraph, V as VM, D as DagSnapshot, b as EngineContext, S as ScopeManager, L as LineExecutionContext } from './ScopeManager-8vf02dwj.cjs';
+import { T as TokenFusion, c as TokenNormalizer, a as NormalizerRule } from './TokenNormalizer-DnlL7_8c.cjs';
+import { a as DependencyGraph, V as VM, D as DagSnapshot, b as EngineContext, S as ScopeManager, L as LineExecutionContext } from './ScopeManager-DRDBVfan.cjs';
 import { a as BytecodeProgram } from './BytecodeBuilder-Bp9xeTmX.cjs';
 import { QueryClient } from '@tanstack/query-core';
-import { E as EngineError } from './EngineError-B61GS1jp.cjs';
-import { a as DiagnosticReportJSON, D as DiagnosticPipeline } from './pipeline-CtfJtPQc.cjs';
-import { T as Token } from './Token-B1hdkedD.cjs';
+import { E as EngineError } from './EngineError-CNA_rHY-.cjs';
+import { a as DiagnosticReportJSON, D as DiagnosticPipeline } from './pipeline-DtSBJ8TS.cjs';
+import { T as Token } from './Token-CbP_OutD.cjs';
 import { D as DEFAULT_CONFIG, E as EngineConfig } from './Configuration-C9W8tJv_.cjs';
 
 /**
@@ -1522,6 +1522,14 @@ interface LineEvaluation {
 declare class ExpressionEngine {
     private dag;
     private lineCache;
+    /**
+     * Names ever used as a running-total target (`total += 5`). A document is
+     * re-parsed top-to-bottom on every keystroke, so each accumulator is reset
+     * to undefined at the start of a batch pass and re-seeds from its opening
+     * `+=`/`-=` this pass, rather than reading its own previous pass's value
+     * (which grew the total without bound). See {@link tryCompoundAssignment}.
+     */
+    private accumulatorNames;
     private scopeManager;
     private lexer;
     private registry;
@@ -1993,6 +2001,45 @@ declare class ExpressionEngine {
      * tolerated and skipped.
      */
     private tryDefineUserUnit;
+    /**
+     * `name += expr` / `name -= expr`, a running total. The accumulator reads
+     * its current value, adds or subtracts the right-hand side, stores the
+     * result, and answers with the new value, so a note becomes a live ledger
+     * where each line adjusts a balance in place. Returns null to decline
+     * anything that is not the compound shape.
+     *
+     * Handled here, in the same effectful, cache-bypassing channel as
+     * {@link tryDefineUserUnit} and the bare `count = 10` assignment (see
+     * {@link trySymbolicGrammar}), rather than as a parselet: a bare identifier
+     * is a Tier-1 prefix that emits `LOAD_VAR name` before any infix parselet on
+     * `+=` could run, and that pre-emitted load throws UNDEFINED_VARIABLE for a
+     * first-use accumulator. Seeding 0 for a first `+=`/`-=` is a one-line
+     * `getVar`/`setVar` here where it cannot be from a parselet, a deliberate
+     * departure from a plain reference, which still reports the undefined name.
+     *
+     * The right-hand side is parenthesised and run through the ORDINARY (not
+     * symbolic-tolerant) path, so `bal += 3 * 4` is `bal + 12`, a genuine typo in
+     * it (`total += nope`) is a real UNDEFINED_VARIABLE, and the accumulation
+     * goes through the VM's own ADD/SUB: money stays money, a unit stays its
+     * unit, and the seed 0 added to a typed right-hand side takes that type on
+     * first use. The colon (`:name`) and `global :name` grammars are untouched:
+     * they lex their own leading token, never IDENT/UNIT, so they decline here.
+     */
+    private tryCompoundAssignment;
+    /**
+     * Reset every running-total accumulator (`total += 5`) to undefined, and
+     * return their names.
+     *
+     * An accumulator seeds 0 only while its name is undefined, then reads that
+     * value on each `+=`/`-=`. A document is re-evaluated top-to-bottom on
+     * every keystroke, so unless the name is cleared first the total reads its
+     * own previous evaluation's value and grows without bound. The batch
+     * document pass (`parseDocument`/`evaluateLines`) calls this at the start
+     * of each pass; the incremental {@link ThreeTierEvaluator} calls it and
+     * then marks the lines that touch each name dirty, since it re-runs lines
+     * selectively rather than replaying the whole document.
+     */
+    resetAccumulators(): ReadonlySet<string>;
     private trySymbolicGrammar;
     /**
      * Stores a general scalar equation (`x^2 - 4 = 0`) keyed by its unknown, or

package/dist/{PackageRegistry-_8rDlvxI.d.ts → PackageRegistry-DrCPQNyy.d.ts}

@@ -1,15 +1,15 @@
-import { a as PrecedenceParser, b as PrefixParselet, I as InfixParselet } from './Parselet-BBT8riYh.js';
-import { V as Value, b as ValueType } from './Value-BUi1RA3S.js';
+import { a as PrecedenceParser, b as PrefixParselet, I as InfixParselet } from './Parselet-Bhf7d0_W.js';
+import { V as Value, b as ValueType } from './Value-DZNQ_PU7.js';
 import { IVariableSource } from './variables.js';
-import { M as MarkdownLineType, L as Lexer, e as TokenCategory, c as LexerVocabulary } from './Lexer-CSI_lwbW.js';
+import { M as MarkdownLineType, L as Lexer, e as TokenCategory, c as LexerVocabulary } from './Lexer-DKMlj7Sy.js';
 import { IAsyncResolver } from './resolvers.js';
-import { T as TokenFusion, c as TokenNormalizer, a as NormalizerRule } from './TokenNormalizer-C6VzZgHa.js';
-import { a as DependencyGraph, V as VM, D as DagSnapshot, b as EngineContext, S as ScopeManager, L as LineExecutionContext } from './ScopeManager-CxA24W5n.js';
+import { T as TokenFusion, c as TokenNormalizer, a as NormalizerRule } from './TokenNormalizer-DCWdZjGz.js';
+import { a as DependencyGraph, V as VM, D as DagSnapshot, b as EngineContext, S as ScopeManager, L as LineExecutionContext } from './ScopeManager-Bzq87GfA.js';
 import { a as BytecodeProgram } from './BytecodeBuilder-Bp9xeTmX.js';
 import { QueryClient } from '@tanstack/query-core';
-import { E as EngineError } from './EngineError-B61GS1jp.js';
-import { a as DiagnosticReportJSON, D as DiagnosticPipeline } from './pipeline-DCd5M6Gk.js';
-import { T as Token } from './Token-B1hdkedD.js';
+import { E as EngineError } from './EngineError-CNA_rHY-.js';
+import { a as DiagnosticReportJSON, D as DiagnosticPipeline } from './pipeline-D-PS9gVw.js';
+import { T as Token } from './Token-CbP_OutD.js';
 import { D as DEFAULT_CONFIG, E as EngineConfig } from './Configuration-C9W8tJv_.js';
 
 /**
@@ -1522,6 +1522,14 @@ interface LineEvaluation {
 declare class ExpressionEngine {
     private dag;
     private lineCache;
+    /**
+     * Names ever used as a running-total target (`total += 5`). A document is
+     * re-parsed top-to-bottom on every keystroke, so each accumulator is reset
+     * to undefined at the start of a batch pass and re-seeds from its opening
+     * `+=`/`-=` this pass, rather than reading its own previous pass's value
+     * (which grew the total without bound). See {@link tryCompoundAssignment}.
+     */
+    private accumulatorNames;
     private scopeManager;
     private lexer;
     private registry;
@@ -1993,6 +2001,45 @@ declare class ExpressionEngine {
      * tolerated and skipped.
      */
     private tryDefineUserUnit;
+    /**
+     * `name += expr` / `name -= expr`, a running total. The accumulator reads
+     * its current value, adds or subtracts the right-hand side, stores the
+     * result, and answers with the new value, so a note becomes a live ledger
+     * where each line adjusts a balance in place. Returns null to decline
+     * anything that is not the compound shape.
+     *
+     * Handled here, in the same effectful, cache-bypassing channel as
+     * {@link tryDefineUserUnit} and the bare `count = 10` assignment (see
+     * {@link trySymbolicGrammar}), rather than as a parselet: a bare identifier
+     * is a Tier-1 prefix that emits `LOAD_VAR name` before any infix parselet on
+     * `+=` could run, and that pre-emitted load throws UNDEFINED_VARIABLE for a
+     * first-use accumulator. Seeding 0 for a first `+=`/`-=` is a one-line
+     * `getVar`/`setVar` here where it cannot be from a parselet, a deliberate
+     * departure from a plain reference, which still reports the undefined name.
+     *
+     * The right-hand side is parenthesised and run through the ORDINARY (not
+     * symbolic-tolerant) path, so `bal += 3 * 4` is `bal + 12`, a genuine typo in
+     * it (`total += nope`) is a real UNDEFINED_VARIABLE, and the accumulation
+     * goes through the VM's own ADD/SUB: money stays money, a unit stays its
+     * unit, and the seed 0 added to a typed right-hand side takes that type on
+     * first use. The colon (`:name`) and `global :name` grammars are untouched:
+     * they lex their own leading token, never IDENT/UNIT, so they decline here.
+     */
+    private tryCompoundAssignment;
+    /**
+     * Reset every running-total accumulator (`total += 5`) to undefined, and
+     * return their names.
+     *
+     * An accumulator seeds 0 only while its name is undefined, then reads that
+     * value on each `+=`/`-=`. A document is re-evaluated top-to-bottom on
+     * every keystroke, so unless the name is cleared first the total reads its
+     * own previous evaluation's value and grows without bound. The batch
+     * document pass (`parseDocument`/`evaluateLines`) calls this at the start
+     * of each pass; the incremental {@link ThreeTierEvaluator} calls it and
+     * then marks the lines that touch each name dirty, since it re-runs lines
+     * selectively rather than replaying the whole document.
+     */
+    resetAccumulators(): ReadonlySet<string>;
     private trySymbolicGrammar;
     /**
      * Stores a general scalar equation (`x^2 - 4 = 0`) keyed by its unknown, or

package/dist/{Parselet-BBT8riYh.d.ts → Parselet-Bhf7d0_W.d.ts}

@@ -1,6 +1,6 @@
 import { B as BytecodeBuilder } from './BytecodeBuilder-Bp9xeTmX.js';
-import { T as Token } from './Token-B1hdkedD.js';
-import { D as DiagnosticPipeline } from './pipeline-DCd5M6Gk.js';
+import { T as Token } from './Token-CbP_OutD.js';
+import { D as DiagnosticPipeline } from './pipeline-D-PS9gVw.js';
 
 /**
  * Dual-keyed ParseletRegistry, accepts both string token types and

package/dist/{Parselet-BHcgK9S7.d.cts → Parselet-Cv7S7KRt.d.cts}

@@ -1,6 +1,6 @@
 import { B as BytecodeBuilder } from './BytecodeBuilder-Bp9xeTmX.cjs';
-import { T as Token } from './Token-B1hdkedD.cjs';
-import { D as DiagnosticPipeline } from './pipeline-CtfJtPQc.cjs';
+import { T as Token } from './Token-CbP_OutD.cjs';
+import { D as DiagnosticPipeline } from './pipeline-DtSBJ8TS.cjs';
 
 /**
  * Dual-keyed ParseletRegistry, accepts both string token types and

package/dist/{ScopeManager-CxA24W5n.d.ts → ScopeManager-Bzq87GfA.d.ts}

@@ -1,7 +1,7 @@
-import { V as Value } from './Value-BUi1RA3S.js';
+import { V as Value } from './Value-DZNQ_PU7.js';
 import { U as UserFunctionDef, A as AnonymousBodyDef, a as BytecodeProgram } from './BytecodeBuilder-Bp9xeTmX.js';
-import { E as EngineError } from './EngineError-B61GS1jp.js';
-import { D as DiagnosticPipeline } from './pipeline-DCd5M6Gk.js';
+import { E as EngineError } from './EngineError-CNA_rHY-.js';
+import { D as DiagnosticPipeline } from './pipeline-D-PS9gVw.js';
 import { VariableResolver } from './variables.js';
 
 /**
@@ -402,6 +402,13 @@ interface VM {
      */
     getVar(key: string): Value | undefined;
     setVar(key: string, value: Value): void;
+    /**
+     * Remove a top-level variable binding. Used at the start of each document
+     * pass to re-seed accumulators (`total += 5`): a running total must reset
+     * to its seed each full re-parse, otherwise it reads its own previous
+     * pass's value and grows without bound on every keystroke.
+     */
+    deleteVar(key: string): void;
     /**
      * User-defined-function call frame, a name-keyed `Map` of this call's
      * bound arguments, PUSHED before `CALL_USER_FUNCTION` executes the

package/dist/{ScopeManager-8vf02dwj.d.cts → ScopeManager-DRDBVfan.d.cts}

@@ -1,7 +1,7 @@
-import { V as Value } from './Value-BUi1RA3S.cjs';
+import { V as Value } from './Value-DZNQ_PU7.cjs';
 import { U as UserFunctionDef, A as AnonymousBodyDef, a as BytecodeProgram } from './BytecodeBuilder-Bp9xeTmX.cjs';
-import { E as EngineError } from './EngineError-B61GS1jp.cjs';
-import { D as DiagnosticPipeline } from './pipeline-CtfJtPQc.cjs';
+import { E as EngineError } from './EngineError-CNA_rHY-.cjs';
+import { D as DiagnosticPipeline } from './pipeline-DtSBJ8TS.cjs';
 import { VariableResolver } from './variables.cjs';
 
 /**
@@ -402,6 +402,13 @@ interface VM {
      */
     getVar(key: string): Value | undefined;
     setVar(key: string, value: Value): void;
+    /**
+     * Remove a top-level variable binding. Used at the start of each document
+     * pass to re-seed accumulators (`total += 5`): a running total must reset
+     * to its seed each full re-parse, otherwise it reads its own previous
+     * pass's value and grows without bound on every keystroke.
+     */
+    deleteVar(key: string): void;
     /**
      * User-defined-function call frame, a name-keyed `Map` of this call's
      * bound arguments, PUSHED before `CALL_USER_FUNCTION` executes the

package/dist/{Token-B1hdkedD.d.cts → Token-CbP_OutD.d.cts}

@@ -46,6 +46,8 @@ declare const TokenTypes: {
     readonly IDENT: "IDENT";
     readonly PLUS: "PLUS";
     readonly MINUS: "MINUS";
+    readonly PLUS_EQUALS: "PLUS_EQUALS";
+    readonly MINUS_EQUALS: "MINUS_EQUALS";
     readonly STAR: "STAR";
     readonly SLASH: "SLASH";
     readonly PLUS_MINUS: "PLUS_MINUS";
@@ -115,6 +117,10 @@ declare const TokenTypes: {
     readonly UNTIL: "UNTIL";
     readonly SINCE: "SINCE";
     readonly BETWEEN: "BETWEEN";
+    readonly SPLIT: "SPLIT";
+    readonly SPLIT_WAYS: "SPLIT_WAYS";
+    readonly WAYS: "WAYS";
+    readonly PEOPLE: "PEOPLE";
     readonly FROM: "FROM";
     readonly INCREASE: "INCREASE";
     readonly DECREASE: "DECREASE";
@@ -196,6 +202,7 @@ declare const TokenTypes: {
     readonly INLINE_SOLVE_START: "INLINE_SOLVE_START";
     readonly COMMENT: "COMMENT";
     readonly HEX_COLOUR: "HEX_COLOUR";
+    readonly TAG: "TAG";
     readonly COLOUR_CALL: "COLOUR_CALL";
     readonly VEC2: "VEC2";
     readonly VEC3: "VEC3";
@@ -228,6 +235,8 @@ declare const TokenTypes: {
     readonly WHAT_WAS: "WHAT_WAS";
     readonly VALUE_OF: "VALUE_OF";
     readonly WORTH_IN: "WORTH_IN";
+    readonly SAVINGS_HOW_LONG: "SAVINGS_HOW_LONG";
+    readonly SAVINGS_HOW_MUCH: "SAVINGS_HOW_MUCH";
     readonly ASSUMING: "ASSUMING";
     readonly IN_YEAR_DOLLARS: "IN_YEAR_DOLLARS";
     readonly INGREDIENT_NAME: "INGREDIENT_NAME";

package/dist/{Token-B1hdkedD.d.ts → Token-CbP_OutD.d.ts}

@@ -46,6 +46,8 @@ declare const TokenTypes: {
     readonly IDENT: "IDENT";
     readonly PLUS: "PLUS";
     readonly MINUS: "MINUS";
+    readonly PLUS_EQUALS: "PLUS_EQUALS";
+    readonly MINUS_EQUALS: "MINUS_EQUALS";
     readonly STAR: "STAR";
     readonly SLASH: "SLASH";
     readonly PLUS_MINUS: "PLUS_MINUS";
@@ -115,6 +117,10 @@ declare const TokenTypes: {
     readonly UNTIL: "UNTIL";
     readonly SINCE: "SINCE";
     readonly BETWEEN: "BETWEEN";
+    readonly SPLIT: "SPLIT";
+    readonly SPLIT_WAYS: "SPLIT_WAYS";
+    readonly WAYS: "WAYS";
+    readonly PEOPLE: "PEOPLE";
     readonly FROM: "FROM";
     readonly INCREASE: "INCREASE";
     readonly DECREASE: "DECREASE";
@@ -196,6 +202,7 @@ declare const TokenTypes: {
     readonly INLINE_SOLVE_START: "INLINE_SOLVE_START";
     readonly COMMENT: "COMMENT";
     readonly HEX_COLOUR: "HEX_COLOUR";
+    readonly TAG: "TAG";
     readonly COLOUR_CALL: "COLOUR_CALL";
     readonly VEC2: "VEC2";
     readonly VEC3: "VEC3";
@@ -228,6 +235,8 @@ declare const TokenTypes: {
     readonly WHAT_WAS: "WHAT_WAS";
     readonly VALUE_OF: "VALUE_OF";
     readonly WORTH_IN: "WORTH_IN";
+    readonly SAVINGS_HOW_LONG: "SAVINGS_HOW_LONG";
+    readonly SAVINGS_HOW_MUCH: "SAVINGS_HOW_MUCH";
     readonly ASSUMING: "ASSUMING";
     readonly IN_YEAR_DOLLARS: "IN_YEAR_DOLLARS";
     readonly INGREDIENT_NAME: "INGREDIENT_NAME";

package/dist/{TokenNormalizer-C6VzZgHa.d.ts → TokenNormalizer-DCWdZjGz.d.ts}

@@ -1,4 +1,4 @@
-import { T as Token } from './Token-B1hdkedD.js';
+import { T as Token } from './Token-CbP_OutD.js';
 
 /**
  * NormalizerRule, pluggable token normalization rule for the

package/dist/{TokenNormalizer-DRc1Js1V.d.cts → TokenNormalizer-DnlL7_8c.d.cts}

@@ -1,4 +1,4 @@
-import { T as Token } from './Token-B1hdkedD.cjs';
+import { T as Token } from './Token-CbP_OutD.cjs';
 
 /**
  * NormalizerRule, pluggable token normalization rule for the

package/dist/{VMCheckpoints-MK--EBH2.d.ts → VMCheckpoints-C6c17Hbo.d.ts}

@@ -1,5 +1,5 @@
-import { V as Value } from './Value-BUi1RA3S.js';
-import { V as VM } from './ScopeManager-CxA24W5n.js';
+import { V as Value } from './Value-DZNQ_PU7.js';
+import { V as VM } from './ScopeManager-Bzq87GfA.js';
 import { U as UserFunctionDef } from './BytecodeBuilder-Bp9xeTmX.js';
 
 /**

package/dist/{VMCheckpoints-ELYqITdF.d.cts → VMCheckpoints-dZxSMGHG.d.cts}

@@ -1,5 +1,5 @@
-import { V as Value } from './Value-BUi1RA3S.cjs';
-import { V as VM } from './ScopeManager-8vf02dwj.cjs';
+import { V as Value } from './Value-DZNQ_PU7.cjs';
+import { V as VM } from './ScopeManager-DRDBVfan.cjs';
 import { U as UserFunctionDef } from './BytecodeBuilder-Bp9xeTmX.cjs';
 
 /**

package/dist/{Value-BUi1RA3S.d.cts → Value-DZNQ_PU7.d.cts}

@@ -218,6 +218,31 @@ interface ColourData {
     readonly format: ColourFormat;
     readonly name?: string;
 }
+/**
+ * One tier of a bill split: an amount and how many people pay it. An even
+ * split is a single share; the odd-penny case is two shares (the base amount
+ * most people pay, then the base plus a cent that the remaining `count` pay),
+ * so the shares always add back to the exact total. `exact` carries the
+ * base-ten cents of a currency share so display rounds from the decimal rather
+ * than a drifted double, exactly as money does everywhere else.
+ */
+interface SplitShare {
+    readonly value: number;
+    readonly exact?: DecimalData;
+    readonly count: number;
+}
+/**
+ * The result of a per-person bill split (`split $180 between 4`). `unit` is the
+ * currency code when the amount was money, undefined for a bare number.
+ * `shares` is ordered base-first: `shares[0]` is the "each" amount, and a
+ * second share, when present, is the slightly larger amount the odd penny falls
+ * on. Lives in a {@link Value}'s `value` slot exactly as {@link ColourData} and
+ * {@link RangeData} do, a display-only payload the formatter renders.
+ */
+interface SplitData {
+    readonly unit?: string;
+    readonly shares: readonly SplitShare[];
+}
 /**
  * Discriminated union tag for {@link Value} objects.
  *
@@ -249,7 +274,9 @@ declare enum ValueType {
     /** Plugin-raised error propagated through the DAG. Value stores error code, unit stores message. */
     Error = 13,
     /** A colour (hex/rgb/hsl/named). Value is {@link ColourData}. */
-    Colour = 14
+    Colour = 14,
+    /** A per-person bill split (`split $180 between 4`). Value is {@link SplitData}. */
+    Split = 15
 }
 /**
  * Universal runtime value for the solve-js VM.
@@ -265,7 +292,7 @@ declare enum ValueType {
 declare class Value {
     private _cachedNumber;
     type: ValueType;
-    value: number | bigint | string | boolean | MatrixData | RangeData | ColourData | SymbolicNode;
+    value: number | bigint | string | boolean | MatrixData | RangeData | ColourData | SplitData | SymbolicNode;
     unit?: string;
     /** Set by async resolvers when a fetch timed out, the result is a fallback (typically 0). */
     timedOut?: boolean;
@@ -334,12 +361,12 @@ declare class Value {
      * by {@link recycle} alongside the other sidecars.
      */
     decimalPlaces?: number;
-    constructor(type: ValueType, value: number | bigint | string | boolean | MatrixData | RangeData | ColourData | SymbolicNode, unit?: string);
+    constructor(type: ValueType, value: number | bigint | string | boolean | MatrixData | RangeData | ColourData | SplitData | SymbolicNode, unit?: string);
     /**
      * Phase 5.3: Reset all fields for arena reuse.
      * Called by ValueArena.acquire(), zero allocation, just field assignment.
      */
-    recycle(type: ValueType, value: number | bigint | string | boolean | MatrixData | RangeData | ColourData | SymbolicNode, unit?: string): void;
+    recycle(type: ValueType, value: number | bigint | string | boolean | MatrixData | RangeData | ColourData | SplitData | SymbolicNode, unit?: string): void;
     isNumber(): this is Value & {
         value: number;
     };
@@ -414,4 +441,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 MatrixData as M, type RangeData as R, type SymbolicNode as S, Value as V, type MatrixEntry as a, ValueType as b, bigIntValue as c, colVectorValue as d, rowVectorValue as e, type ColourFormat as f, hexValue as h, matrixValue as m, numberValue as n, rangeValue as r, stringValue as s, uomValue as u };
+export { type ColourData as C, 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 SymbolicNode as f, type ColourFormat as g, hexValue as h, matrixValue as m, numberValue as n, rangeValue as r, stringValue as s, uomValue as u };

package/dist/{Value-BUi1RA3S.d.ts → Value-DZNQ_PU7.d.ts}

@@ -218,6 +218,31 @@ interface ColourData {
     readonly format: ColourFormat;
     readonly name?: string;
 }
+/**
+ * One tier of a bill split: an amount and how many people pay it. An even
+ * split is a single share; the odd-penny case is two shares (the base amount
+ * most people pay, then the base plus a cent that the remaining `count` pay),
+ * so the shares always add back to the exact total. `exact` carries the
+ * base-ten cents of a currency share so display rounds from the decimal rather
+ * than a drifted double, exactly as money does everywhere else.
+ */
+interface SplitShare {
+    readonly value: number;
+    readonly exact?: DecimalData;
+    readonly count: number;
+}
+/**
+ * The result of a per-person bill split (`split $180 between 4`). `unit` is the
+ * currency code when the amount was money, undefined for a bare number.
+ * `shares` is ordered base-first: `shares[0]` is the "each" amount, and a
+ * second share, when present, is the slightly larger amount the odd penny falls
+ * on. Lives in a {@link Value}'s `value` slot exactly as {@link ColourData} and
+ * {@link RangeData} do, a display-only payload the formatter renders.
+ */
+interface SplitData {
+    readonly unit?: string;
+    readonly shares: readonly SplitShare[];
+}
 /**
  * Discriminated union tag for {@link Value} objects.
  *
@@ -249,7 +274,9 @@ declare enum ValueType {
     /** Plugin-raised error propagated through the DAG. Value stores error code, unit stores message. */
     Error = 13,
     /** A colour (hex/rgb/hsl/named). Value is {@link ColourData}. */
-    Colour = 14
+    Colour = 14,
+    /** A per-person bill split (`split $180 between 4`). Value is {@link SplitData}. */
+    Split = 15
 }
 /**
  * Universal runtime value for the solve-js VM.
@@ -265,7 +292,7 @@ declare enum ValueType {
 declare class Value {
     private _cachedNumber;
     type: ValueType;
-    value: number | bigint | string | boolean | MatrixData | RangeData | ColourData | SymbolicNode;
+    value: number | bigint | string | boolean | MatrixData | RangeData | ColourData | SplitData | SymbolicNode;
     unit?: string;
     /** Set by async resolvers when a fetch timed out, the result is a fallback (typically 0). */
     timedOut?: boolean;
@@ -334,12 +361,12 @@ declare class Value {
      * by {@link recycle} alongside the other sidecars.
      */
     decimalPlaces?: number;
-    constructor(type: ValueType, value: number | bigint | string | boolean | MatrixData | RangeData | ColourData | SymbolicNode, unit?: string);
+    constructor(type: ValueType, value: number | bigint | string | boolean | MatrixData | RangeData | ColourData | SplitData | SymbolicNode, unit?: string);
     /**
      * Phase 5.3: Reset all fields for arena reuse.
      * Called by ValueArena.acquire(), zero allocation, just field assignment.
      */
-    recycle(type: ValueType, value: number | bigint | string | boolean | MatrixData | RangeData | ColourData | SymbolicNode, unit?: string): void;
+    recycle(type: ValueType, value: number | bigint | string | boolean | MatrixData | RangeData | ColourData | SplitData | SymbolicNode, unit?: string): void;
     isNumber(): this is Value & {
         value: number;
     };
@@ -414,4 +441,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 MatrixData as M, type RangeData as R, type SymbolicNode as S, Value as V, type MatrixEntry as a, ValueType as b, bigIntValue as c, colVectorValue as d, rowVectorValue as e, type ColourFormat as f, hexValue as h, matrixValue as m, numberValue as n, rangeValue as r, stringValue as s, uomValue as u };
+export { type ColourData as C, 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 SymbolicNode as f, type ColourFormat as g, hexValue as h, matrixValue as m, numberValue as n, rangeValue as r, stringValue as s, uomValue as u };

package/dist/{WorkerError-_-RkoQ5P.d.ts → WorkerError-B7t7R2-m.d.ts}

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

package/dist/{WorkerError-gzmaopj2.d.cts → WorkerError-Djd7GGGa.d.cts}

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

package/dist/{chunk-SSV46KFA.cjs → chunk-4K5W7EH2.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkZVTWQLK4_cjs = require('./chunk-ZVTWQLK4.cjs');
-var chunk2TZKENDH_cjs = require('./chunk-2TZKENDH.cjs');
+var chunkKXDQKVNX_cjs = require('./chunk-KXDQKVNX.cjs');
+var chunkIT74O4BE_cjs = require('./chunk-IT74O4BE.cjs');
 
 // src/parser/OperandWidth.ts
 var ONE_OPERAND = [
@@ -57,7 +57,7 @@ var CURRENCY_NS = "currency";
 var CurrencyAsyncResolver = class {
   constructor(exchange) {
     this.namespace = CURRENCY_NS;
-    this.exchange = exchange ?? chunkZVTWQLK4_cjs.currencyExchangeService;
+    this.exchange = exchange ?? chunkKXDQKVNX_cjs.currencyExchangeService;
   }
   preflight(_tokens, bytecode, packageId, signal, queryClient) {
     const { opcodes, strings } = bytecode;
@@ -89,7 +89,7 @@ var CurrencyAsyncResolver = class {
               const resolver = queryClient.fetchQuery({
                 queryKey: cacheKey,
                 queryFn: ({ signal: qSignal }) => {
-                  return this.exchange.getRate(fromUnit, toUnit, qSignal).then((rate) => chunk2TZKENDH_cjs.numberValue(rate));
+                  return this.exchange.getRate(fromUnit, toUnit, qSignal).then((rate) => chunkIT74O4BE_cjs.numberValue(rate));
                 },
                 staleTime: 5 * 60 * 1e3
               });
@@ -108,5 +108,5 @@ var CurrencyAsyncResolver = class {
 
 exports.CurrencyAsyncResolver = CurrencyAsyncResolver;
 exports.nextInstruction = nextInstruction;
-//# sourceMappingURL=chunk-SSV46KFA.cjs.map
-//# sourceMappingURL=chunk-SSV46KFA.cjs.map
+//# sourceMappingURL=chunk-4K5W7EH2.cjs.map
+//# sourceMappingURL=chunk-4K5W7EH2.cjs.map