solve-engine 2.38.4 → 2.38.6

package/dist/{PackageCompatibility-DscVGabN.d.ts → PackageCompatibility-BvKJ84Nt.d.ts}

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

package/dist/{PackageCompatibility-CuUVgjBW.d.cts → PackageCompatibility-UpD1nhk6.d.cts}

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

package/dist/{PackageRegistry-G6qyHROU.d.cts → PackageRegistry-DEFOYdGm.d.cts}

@@ -2,7 +2,7 @@ import { a as PrecedenceParser, b as PrefixParselet, I as InfixParselet } from '
 import { M as MarkdownLineType, L as Lexer, e as TokenCategory, c as LexerVocabulary } from './Lexer-DaWkCu84.cjs';
 import { IAsyncResolver } from './resolvers.cjs';
 import { T as TokenFusion, c as TokenNormalizer, a as NormalizerRule } from './TokenNormalizer-D382VSYh.cjs';
-import { D as DependencyGraph, V as VM, f as DagSnapshot, g as EngineContext, S as ScopeManager, P as PluginFunctionHandler, A as AsConverter } from './VMBuiltins-RpmR0yHh.cjs';
+import { D as DependencyGraph, V as VM, f as DagSnapshot, g as EngineContext, S as ScopeManager, P as PluginFunctionHandler, A as AsConverter } from './VMBuiltins-BdQaT3DC.cjs';
 import { V as Value, b as ValueType, D as DatetimeGrain } from './Value-B55Hvn3e.cjs';
 import { a as BytecodeProgram } from './BytecodeBuilder-DSWKZi4f.cjs';
 import { C as CalendarBackend } from './CalendarBackend-MdS3Bb4P.cjs';

package/dist/{PackageRegistry-DJekaRdM.d.ts → PackageRegistry-DIUOXCa1.d.ts}

@@ -2,7 +2,7 @@ import { a as PrecedenceParser, b as PrefixParselet, I as InfixParselet } from '
 import { M as MarkdownLineType, L as Lexer, e as TokenCategory, c as LexerVocabulary } from './Lexer-DPn5dfCH.js';
 import { IAsyncResolver } from './resolvers.js';
 import { T as TokenFusion, c as TokenNormalizer, a as NormalizerRule } from './TokenNormalizer-DAzPp-j1.js';
-import { D as DependencyGraph, V as VM, f as DagSnapshot, g as EngineContext, S as ScopeManager, P as PluginFunctionHandler, A as AsConverter } from './VMBuiltins-BnE1KdV5.js';
+import { D as DependencyGraph, V as VM, f as DagSnapshot, g as EngineContext, S as ScopeManager, P as PluginFunctionHandler, A as AsConverter } from './VMBuiltins-CKMK3-LX.js';
 import { V as Value, b as ValueType, D as DatetimeGrain } from './Value-B55Hvn3e.js';
 import { a as BytecodeProgram } from './BytecodeBuilder-DSWKZi4f.js';
 import { C as CalendarBackend } from './CalendarBackend-MdS3Bb4P.js';

package/dist/{VMBuiltins-RpmR0yHh.d.cts → VMBuiltins-BdQaT3DC.d.cts}

@@ -591,6 +591,8 @@ declare const sharedOpRegistry: OpRegistry;
 /** Serialized snapshot of the dependency graph for diagnostic rendering. */
 interface DagSnapshot {
     consumers: Record<string, number[]>;
+    /** key -> the lines that write it, the mirror of `consumers`. */
+    producers: Record<string, number[]>;
     writes: Record<number, string[]>;
     reads: Record<number, string[]>;
     dataSourceDeps: Record<number, string[]>;
@@ -607,12 +609,36 @@ interface DagSnapshot {
  * - Efficient removal of deleted lines (removeLine)
  */
 declare class DependencyGraph {
+    /** key -> the lines that READ it. Answers "what does an edit to this affect". */
     private consumers;
+    /**
+     * key -> the lines that WRITE it. Answers "what is in this group".
+     *
+     * The half that was missing. `consumers` alone can say which lines ask about
+     * `#food`; only this can say which lines are *in* it, which is what a
+     * category-tag aggregate needs and why it used to walk the whole document
+     * instead of asking.
+     */
+    private producers;
     private dependencies;
     private writes;
     private lineReads;
-    private dataSourceDependencies;
-    private dataSourceConsumers;
+    /**
+     * line -> the keys it reads that {@link registerLine} must not replace.
+     *
+     * Variable and tag edges are recovered from the line's text every time it is
+     * registered, so registering replaces them. A data-source edge is discovered
+     * at run time, after that registration, so replacing would drop it. Both live
+     * in the same {@link consumers} index; only the bookkeeping differs.
+     */
+    private pinnedReads;
+    /**
+     * Whether this line already carries exactly these edges.
+     *
+     * Reads are compared against the stored set minus its pinned keys, since a
+     * pinned key (a data source) is not part of what a caller passes.
+     */
+    private hasSameEdges;
     /**
      * Register a line's variable reads and writes in the dependency graph.
      *
@@ -668,7 +694,7 @@ declare class DependencyGraph {
      * @param queryKey - The query key that was updated
      * @returns Set of line numbers that need re-evaluation
      */
-    getAffectedLinesByDataSource(dataSourceId: string, queryKey: string[]): Set<number>;
+    getAffectedLinesByDataSource(dataSourceId: string, queryKey: string[]): ReadonlySet<number>;
     /**
      * Remove a line from the dependency graph (e.g., when a line is deleted from the document).
      *
@@ -684,21 +710,33 @@ declare class DependencyGraph {
      * @param variable - The variable name
      * @returns Set of line numbers that read this variable, or empty set if none
      */
-    getConsumers(variable: string): Set<number>;
+    getConsumers(variable: string): ReadonlySet<number>;
+    /**
+     * Get all line numbers that produce (write) a given key.
+     *
+     * The mirror of {@link getConsumers}, and the reason the producer index
+     * exists: for a category tag it is the group's membership, so an aggregate
+     * over `#food` costs the size of the group rather than the size of the
+     * document.
+     *
+     * @param key - The key, from {@link edgeKey}
+     * @returns Set of line numbers that write this key, or empty set if none
+     */
+    getProducers(key: string): ReadonlySet<number>;
     /**
      * Get all variables that a line depends on (reads).
      *
      * @param lineNumber - The line number to query
      * @returns Set of variable names this line reads, or empty set if none
      */
-    getDependencies(lineNumber: number): Set<string>;
+    getDependencies(lineNumber: number): ReadonlySet<string>;
     /**
      * Get all variables that a line writes (assigns to).
      *
      * @param lineNumber - The line number to query
      * @returns Set of variable names this line writes, or empty set if none
      */
-    getWrites(lineNumber: number): Set<string>;
+    getWrites(lineNumber: number): ReadonlySet<string>;
     /**
      * Get a serializable snapshot of the entire dependency graph for diagnostics.
      *

package/dist/{VMBuiltins-BnE1KdV5.d.ts → VMBuiltins-CKMK3-LX.d.ts}

@@ -591,6 +591,8 @@ declare const sharedOpRegistry: OpRegistry;
 /** Serialized snapshot of the dependency graph for diagnostic rendering. */
 interface DagSnapshot {
     consumers: Record<string, number[]>;
+    /** key -> the lines that write it, the mirror of `consumers`. */
+    producers: Record<string, number[]>;
     writes: Record<number, string[]>;
     reads: Record<number, string[]>;
     dataSourceDeps: Record<number, string[]>;
@@ -607,12 +609,36 @@ interface DagSnapshot {
  * - Efficient removal of deleted lines (removeLine)
  */
 declare class DependencyGraph {
+    /** key -> the lines that READ it. Answers "what does an edit to this affect". */
     private consumers;
+    /**
+     * key -> the lines that WRITE it. Answers "what is in this group".
+     *
+     * The half that was missing. `consumers` alone can say which lines ask about
+     * `#food`; only this can say which lines are *in* it, which is what a
+     * category-tag aggregate needs and why it used to walk the whole document
+     * instead of asking.
+     */
+    private producers;
     private dependencies;
     private writes;
     private lineReads;
-    private dataSourceDependencies;
-    private dataSourceConsumers;
+    /**
+     * line -> the keys it reads that {@link registerLine} must not replace.
+     *
+     * Variable and tag edges are recovered from the line's text every time it is
+     * registered, so registering replaces them. A data-source edge is discovered
+     * at run time, after that registration, so replacing would drop it. Both live
+     * in the same {@link consumers} index; only the bookkeeping differs.
+     */
+    private pinnedReads;
+    /**
+     * Whether this line already carries exactly these edges.
+     *
+     * Reads are compared against the stored set minus its pinned keys, since a
+     * pinned key (a data source) is not part of what a caller passes.
+     */
+    private hasSameEdges;
     /**
      * Register a line's variable reads and writes in the dependency graph.
      *
@@ -668,7 +694,7 @@ declare class DependencyGraph {
      * @param queryKey - The query key that was updated
      * @returns Set of line numbers that need re-evaluation
      */
-    getAffectedLinesByDataSource(dataSourceId: string, queryKey: string[]): Set<number>;
+    getAffectedLinesByDataSource(dataSourceId: string, queryKey: string[]): ReadonlySet<number>;
     /**
      * Remove a line from the dependency graph (e.g., when a line is deleted from the document).
      *
@@ -684,21 +710,33 @@ declare class DependencyGraph {
      * @param variable - The variable name
      * @returns Set of line numbers that read this variable, or empty set if none
      */
-    getConsumers(variable: string): Set<number>;
+    getConsumers(variable: string): ReadonlySet<number>;
+    /**
+     * Get all line numbers that produce (write) a given key.
+     *
+     * The mirror of {@link getConsumers}, and the reason the producer index
+     * exists: for a category tag it is the group's membership, so an aggregate
+     * over `#food` costs the size of the group rather than the size of the
+     * document.
+     *
+     * @param key - The key, from {@link edgeKey}
+     * @returns Set of line numbers that write this key, or empty set if none
+     */
+    getProducers(key: string): ReadonlySet<number>;
     /**
      * Get all variables that a line depends on (reads).
      *
      * @param lineNumber - The line number to query
      * @returns Set of variable names this line reads, or empty set if none
      */
-    getDependencies(lineNumber: number): Set<string>;
+    getDependencies(lineNumber: number): ReadonlySet<string>;
     /**
      * Get all variables that a line writes (assigns to).
      *
      * @param lineNumber - The line number to query
      * @returns Set of variable names this line writes, or empty set if none
      */
-    getWrites(lineNumber: number): Set<string>;
+    getWrites(lineNumber: number): ReadonlySet<string>;
     /**
      * Get a serializable snapshot of the entire dependency graph for diagnostics.
      *

package/dist/{VMCheckpoints-D0_5-IIa.d.cts → VMCheckpoints-Bmb47bFF.d.cts}

@@ -1,5 +1,5 @@
 import { V as Value } from './Value-B55Hvn3e.cjs';
-import { V as VM } from './VMBuiltins-RpmR0yHh.cjs';
+import { V as VM } from './VMBuiltins-BdQaT3DC.cjs';
 import { U as UserFunctionDef } from './BytecodeBuilder-DSWKZi4f.cjs';
 
 /**

package/dist/{VMCheckpoints-DpHlGjJ3.d.ts → VMCheckpoints-DRbJOzVW.d.ts}

@@ -1,5 +1,5 @@
 import { V as Value } from './Value-B55Hvn3e.js';
-import { V as VM } from './VMBuiltins-BnE1KdV5.js';
+import { V as VM } from './VMBuiltins-CKMK3-LX.js';
 import { U as UserFunctionDef } from './BytecodeBuilder-DSWKZi4f.js';
 
 /**