solve-engine 1.0.0-beta.0 → 1.0.0-beta.2

package/dist/chunk-FEAIOR7N.cjs

@@ -0,0 +1,91 @@
+'use strict';
+
+// src/variables/VariableResolver.ts
+var VariableResolver = class {
+  constructor() {
+    this.sources = [];
+    this.cache = /* @__PURE__ */ new Map();
+    this.cacheEnabled = true;
+  }
+  /**
+   * Register a variable source with a given priority.
+   * Sources are sorted so lower-priority-number sources are queried first.
+   *
+   * @param source - The variable source to register
+   */
+  registerSource(source) {
+    this.sources.push(source);
+    this.sources.sort((a, b) => a.priority - b.priority);
+  }
+  /**
+   * Remove a previously registered variable source (identity match).
+   * The lookup cache is cleared because resolution results may change
+   * once the source no longer participates.
+   *
+   * @param source - The exact source instance passed to registerSource.
+   */
+  unregisterSource(source) {
+    const idx = this.sources.indexOf(source);
+    if (idx !== -1) {
+      this.sources.splice(idx, 1);
+      this.cache.clear();
+    }
+  }
+  /**
+   * Resolve a variable name to its value.
+   *
+   * Checks the cache first (if enabled), then queries registered sources
+   * in priority order. The first source returning a non-undefined value wins.
+   * Cached results are stored and returned on subsequent calls until invalidated.
+   *
+   * @param name - The variable name to resolve
+   * @returns The resolved value, or undefined if not found in any source
+   */
+  async resolve(name) {
+    if (this.cacheEnabled) {
+      const cached = this.cache.get(name);
+      if (cached !== void 0) return cached;
+    }
+    for (const source of this.sources) {
+      const value = await source.get(name);
+      if (value !== void 0) {
+        if (this.cacheEnabled) {
+          this.cache.set(name, value);
+        }
+        return value;
+      }
+    }
+    return void 0;
+  }
+  /**
+   * Set a variable value across all registered sources.
+   * Also updates the local cache so subsequent reads return the new value.
+   *
+   * @param name - The variable name
+   * @param value - The value to set
+   */
+  async set(name, value) {
+    for (const source of this.sources) {
+      await source.set(name, value);
+    }
+    this.cache.set(name, value);
+  }
+  /** Invalidate a single variable in the cache, forcing re-resolution on next read. */
+  invalidate(name) {
+    this.cache.delete(name);
+  }
+  /** Invalidate all cached variable lookups. */
+  invalidateAll() {
+    this.cache.clear();
+  }
+  /** Enable or disable the lookup cache. When disabled, every read queries sources directly. */
+  setCacheEnabled(enabled) {
+    this.cacheEnabled = enabled;
+  }
+};
+var sharedVariableResolver = new VariableResolver();
+
+exports.VariableResolver = VariableResolver;
+exports.sharedVariableResolver = sharedVariableResolver;
+//# sourceMappingURL=chunk-FEAIOR7N.cjs.map
+//# sourceMappingURL=chunk-FEAIOR7N.cjs.map

package/dist/chunk-FEAIOR7N.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/variables/VariableResolver.ts"],"names":[],"mappings":";;;AASO,IAAM,mBAAN,MAAuB;AAAA,EAAvB,WAAA,GAAA;AACN,IAAA,IAAA,CAAQ,UAA6B,EAAC;AACtC,IAAA,IAAA,CAAQ,KAAA,uBAAsD,GAAA,EAAI;AAClE,IAAA,IAAA,CAAQ,YAAA,GAAe,IAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQvB,eAAe,MAAA,EAA+B;AAC7C,IAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,MAAM,CAAA;AACxB,IAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,CAAC,CAAA,EAAG,MAAM,CAAA,CAAE,QAAA,GAAW,EAAE,QAAQ,CAAA;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,iBAAiB,MAAA,EAA+B;AAC/C,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,OAAA,CAAQ,OAAA,CAAQ,MAAM,CAAA;AACvC,IAAA,IAAI,QAAQ,EAAA,EAAI;AACf,MAAA,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAO,GAAA,EAAK,CAAC,CAAA;AAC1B,MAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AAAA,IAClB;AAAA,EACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,QAAQ,IAAA,EAAoD;AACjE,IAAA,IAAI,KAAK,YAAA,EAAc;AACtB,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAI,CAAA;AAClC,MAAA,IAAI,MAAA,KAAW,QAAW,OAAO,MAAA;AAAA,IAClC;AAEA,IAAA,KAAA,MAAW,MAAA,IAAU,KAAK,OAAA,EAAS;AAClC,MAAA,MAAM,KAAA,GAAQ,MAAM,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA;AACnC,MAAA,IAAI,UAAU,MAAA,EAAW;AACxB,QAAA,IAAI,KAAK,YAAA,EAAc;AACtB,UAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAA,EAAM,KAAK,CAAA;AAAA,QAC3B;AACA,QAAA,OAAO,KAAA;AAAA,MACR;AAAA,IACD;AAEA,IAAA,OAAO,MAAA;AAAA,EACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,GAAA,CAAI,IAAA,EAAc,KAAA,EAAuC;AAC9D,IAAA,KAAA,MAAW,MAAA,IAAU,KAAK,OAAA,EAAS;AAClC,MAAA,MAAM,MAAA,CAAO,GAAA,CAAI,IAAA,EAAM,KAAK,CAAA;AAAA,IAC7B;AACA,IAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAA,EAAM,KAAK,CAAA;AAAA,EAC3B;AAAA;AAAA,EAGA,WAAW,IAAA,EAAoB;AAC9B,IAAA,IAAA,CAAK,KAAA,CAAM,OAAO,IAAI,CAAA;AAAA,EACvB;AAAA;AAAA,EAGA,aAAA,GAAsB;AACrB,IAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AAAA,EAClB;AAAA;AAAA,EAGA,gBAAgB,OAAA,EAAwB;AACvC,IAAA,IAAA,CAAK,YAAA,GAAe,OAAA;AAAA,EACrB;AACD;AAGO,IAAM,sBAAA,GAAyB,IAAI,gBAAA","file":"chunk-FEAIOR7N.cjs","sourcesContent":["import { IVariableSource } from \"@solve-js/variables/IVariableSource\";\n\n/**\n * Resolves variable names by querying registered {@link IVariableSource} instances\n * in priority order. Supports caching for repeated lookups.\n *\n * Sources are sorted by priority (lowest first) on registration. When resolving\n * a variable, sources are queried in order and the first non-undefined result wins.\n */\nexport class VariableResolver {\n\tprivate sources: IVariableSource[] = [];\n\tprivate cache: Map<string, number | string | undefined> = new Map();\n\tprivate cacheEnabled = true;\n\n\t/**\n\t * Register a variable source with a given priority.\n\t * Sources are sorted so lower-priority-number sources are queried first.\n\t *\n\t * @param source - The variable source to register\n\t */\n\tregisterSource(source: IVariableSource): void {\n\t\tthis.sources.push(source);\n\t\tthis.sources.sort((a, b) => a.priority - b.priority);\n\t}\n\n\t/**\n\t * Remove a previously registered variable source (identity match).\n\t * The lookup cache is cleared because resolution results may change\n\t * once the source no longer participates.\n\t *\n\t * @param source - The exact source instance passed to registerSource.\n\t */\n\tunregisterSource(source: IVariableSource): void {\n\t\tconst idx = this.sources.indexOf(source);\n\t\tif (idx !== -1) {\n\t\t\tthis.sources.splice(idx, 1);\n\t\t\tthis.cache.clear();\n\t\t}\n\t}\n\n\t/**\n\t * Resolve a variable name to its value.\n\t *\n\t * Checks the cache first (if enabled), then queries registered sources\n\t * in priority order. The first source returning a non-undefined value wins.\n\t * Cached results are stored and returned on subsequent calls until invalidated.\n\t *\n\t * @param name - The variable name to resolve\n\t * @returns The resolved value, or undefined if not found in any source\n\t */\n\tasync resolve(name: string): Promise<number | string | undefined> {\n\t\tif (this.cacheEnabled) {\n\t\t\tconst cached = this.cache.get(name);\n\t\t\tif (cached !== undefined) return cached;\n\t\t}\n\n\t\tfor (const source of this.sources) {\n\t\t\tconst value = await source.get(name);\n\t\t\tif (value !== undefined) {\n\t\t\t\tif (this.cacheEnabled) {\n\t\t\t\t\tthis.cache.set(name, value);\n\t\t\t\t}\n\t\t\t\treturn value;\n\t\t\t}\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Set a variable value across all registered sources.\n\t * Also updates the local cache so subsequent reads return the new value.\n\t *\n\t * @param name - The variable name\n\t * @param value - The value to set\n\t */\n\tasync set(name: string, value: number | string): Promise<void> {\n\t\tfor (const source of this.sources) {\n\t\t\tawait source.set(name, value);\n\t\t}\n\t\tthis.cache.set(name, value);\n\t}\n\n\t/** Invalidate a single variable in the cache, forcing re-resolution on next read. */\n\tinvalidate(name: string): void {\n\t\tthis.cache.delete(name);\n\t}\n\n\t/** Invalidate all cached variable lookups. */\n\tinvalidateAll(): void {\n\t\tthis.cache.clear();\n\t}\n\n\t/** Enable or disable the lookup cache. When disabled, every read queries sources directly. */\n\tsetCacheEnabled(enabled: boolean): void {\n\t\tthis.cacheEnabled = enabled;\n\t}\n}\n\n/** Shared singleton VariableResolver instance. */\nexport const sharedVariableResolver = new VariableResolver();\n"]}

package/dist/chunk-G535KJEG.js

@@ -0,0 +1,312 @@
+// src/diagnostics/pipeline.ts
+var DiagnosticPipeline = class {
+  constructor() {
+    this.collectors = [];
+  }
+  register(collector) {
+    this.collectors.push(collector);
+  }
+  unregister(collector) {
+    const idx = this.collectors.indexOf(collector);
+    if (idx !== -1) this.collectors.splice(idx, 1);
+  }
+  clear() {
+    this.collectors = [];
+  }
+  get hasCollectors() {
+    return this.collectors.length > 0;
+  }
+  get collectorCount() {
+    return this.collectors.length;
+  }
+  // Inline-optimized dispatchers, each checks length once then loops.
+  // When collectors.length === 0, the JIT eliminates the entire method body.
+  firePipelineStart(event) {
+    if (this.collectors.length === 0) return;
+    for (const c of this.collectors) c.onPipelineStart?.(event);
+  }
+  fireTokenEmitted(event) {
+    if (this.collectors.length === 0) return;
+    for (const c of this.collectors) c.onTokenEmitted?.(event);
+  }
+  fireNormalizerStart(event) {
+    if (this.collectors.length === 0) return;
+    for (const c of this.collectors) c.onNormalizerStart?.(event);
+  }
+  fireTokenFused(event) {
+    if (this.collectors.length === 0) return;
+    for (const c of this.collectors) c.onTokenFused?.(event);
+  }
+  fireNormalizerEnd(event) {
+    if (this.collectors.length === 0) return;
+    for (const c of this.collectors) c.onNormalizerEnd?.(event);
+  }
+  fireParseletMatched(event) {
+    if (this.collectors.length === 0) return;
+    for (const c of this.collectors) c.onParseletMatched?.(event);
+  }
+  fireBytecodeBuilt(event) {
+    if (this.collectors.length === 0) return;
+    for (const c of this.collectors) c.onBytecodeBuilt?.(event);
+  }
+  fireVmStep(event) {
+    if (this.collectors.length === 0) return;
+    for (const c of this.collectors) c.onVmStep?.(event);
+  }
+  fireVmHalt(event) {
+    if (this.collectors.length === 0) return;
+    for (const c of this.collectors) c.onVmHalt?.(event);
+  }
+  fireCacheHit(event) {
+    if (this.collectors.length === 0) return;
+    for (const c of this.collectors) c.onCacheHit?.(event);
+  }
+  fireCacheMiss(event) {
+    if (this.collectors.length === 0) return;
+    for (const c of this.collectors) c.onCacheMiss?.(event);
+  }
+  firePipelineEnd(event) {
+    if (this.collectors.length === 0) return;
+    for (const c of this.collectors) c.onPipelineEnd?.(event);
+  }
+  collectReports() {
+    const reports = [];
+    for (const c of this.collectors) {
+      const report = c.getReport();
+      if (report) reports.push(report);
+    }
+    return reports;
+  }
+  reset() {
+    for (const c of this.collectors) c.reset();
+  }
+};
+
+// src/diagnostics/collector.ts
+var DiagnosticCollector = class {
+  onPipelineStart(_event) {
+  }
+  onTokenEmitted(_event) {
+  }
+  onNormalizerStart(_event) {
+  }
+  onTokenFused(_event) {
+  }
+  onNormalizerEnd(_event) {
+  }
+  onParseletMatched(_event) {
+  }
+  onBytecodeBuilt(_event) {
+  }
+  onVmStep(_event) {
+  }
+  onVmHalt(_event) {
+  }
+  onCacheHit(_event) {
+  }
+  onCacheMiss(_event) {
+  }
+  onPipelineEnd(_event) {
+  }
+};
+
+// src/diagnostics/timeline-collector.ts
+var TimelineDiagnosticCollector = class extends DiagnosticCollector {
+  constructor() {
+    super(...arguments);
+    this.events = [];
+    this.startNs = 0;
+    this.parseletEntries = /* @__PURE__ */ new Map();
+    // Incrementally-maintained summary state. See getReport()'s doc comment
+    // for why these exist. Each mirrors exactly what getReport() used to
+    // recompute by rescanning the full `events` array on every call.
+    this.totalTokens = 0;
+    this.cacheHitSeen = false;
+    this.vmStepSeen = false;
+    this.hasBytecodeBuilt = false;
+    this.firstBytecodeOpcodesLength = 0;
+    this.parseletMatches = [];
+    this.lastExpression = "";
+    this.lastInputType = "";
+  }
+  /**
+   * Current cumulative count of `parselet_matched` events seen since
+   * construction (or the last `reset()`), a cheap peek that doesn't build
+   * the full report (`getReport()` copies the whole `parseletMatches`
+   * array). Used by `ExpressionEngine.evaluateExpressionWithDiagnostic()`
+   * to capture a "before" baseline per line, since `parseletMatches` itself
+   * is deliberately cumulative across an entire document pass (see
+   * `onPipelineStart`'s doc comment) rather than reset per line.
+   */
+  get parseletMatchCount() {
+    return this.parseletMatches.length;
+  }
+  reset() {
+    this.events = [];
+    this.parseletEntries.clear();
+    this.startNs = 0;
+    this.totalTokens = 0;
+    this.cacheHitSeen = false;
+    this.vmStepSeen = false;
+    this.hasBytecodeBuilt = false;
+    this.firstBytecodeOpcodesLength = 0;
+    this.parseletMatches = [];
+    this.lastExpression = "";
+    this.lastInputType = "";
+  }
+  /** Stamp the real wall-clock `elapsedNs` onto an event before storing it. */
+  stamp(event) {
+    const elapsedNs = this.startNs !== 0 ? performance.now() * 1e6 - this.startNs : 0;
+    return { ...event, elapsedNs };
+  }
+  onPipelineStart(event) {
+    if (this.startNs === 0) {
+      this.startNs = performance.now() * 1e6;
+    }
+    this.lastExpression = event.expression;
+    this.lastInputType = event.inputType;
+    this.events.push(this.stamp(event));
+  }
+  onTokenEmitted(event) {
+    this.events.push(this.stamp(event));
+    this.totalTokens++;
+  }
+  onNormalizerStart(event) {
+    this.events.push(this.stamp(event));
+  }
+  onTokenFused(event) {
+    this.events.push(this.stamp(event));
+  }
+  onNormalizerEnd(event) {
+    this.events.push(this.stamp(event));
+  }
+  onParseletMatched(event) {
+    this.events.push(this.stamp(event));
+    const entry = this.parseletEntries.get(event.parseletCategory);
+    if (entry) {
+      entry.count++;
+    } else {
+      this.parseletEntries.set(event.parseletCategory, {
+        category: event.parseletCategory,
+        count: 1
+      });
+    }
+    this.parseletMatches.push({
+      tokenType: event.tokenType,
+      tokenValue: event.tokenValue,
+      parseletCategory: event.parseletCategory,
+      parseletType: event.parseletType,
+      isPrefix: event.isPrefix,
+      bindingPower: event.bindingPower,
+      tokenOffset: event.tokenOffset
+    });
+  }
+  onBytecodeBuilt(event) {
+    this.events.push(this.stamp(event));
+    if (!this.hasBytecodeBuilt) {
+      this.hasBytecodeBuilt = true;
+      this.firstBytecodeOpcodesLength = event.opcodesLength;
+    }
+  }
+  onVmStep(event) {
+    this.events.push(this.stamp(event));
+    this.vmStepSeen = true;
+  }
+  onVmHalt(event) {
+    this.events.push(this.stamp(event));
+  }
+  onCacheHit(event) {
+    this.events.push(this.stamp(event));
+    this.cacheHitSeen = true;
+  }
+  onCacheMiss(event) {
+    this.events.push(this.stamp(event));
+  }
+  onPipelineEnd(event) {
+    this.events.push(this.stamp(event));
+  }
+  /**
+   * Build the summary/metadata/parselets report from this collector's
+   * running state.
+   *
+   * These fields used to be recomputed by rescanning the FULL `events`
+   * array on every single call (`.some()`/`.filter()`/a manual scan), since
+   * `events` is never cleared except by an explicit `reset()` (which nothing
+   * in `ExpressionEngine` currently calls, the cumulative-across-the-whole-
+   * document design is deliberate, see `onPipelineStart`'s comment and the
+   * playground's `buildLineStats()`, which slices per-line events out of
+   * this ever-growing array via cumulative-length diffing), that meant
+   * per-call cost grew linearly with total prior calls: O(n²) diagnostic-mode
+   * evaluation over a document's lifetime. Fixed by maintaining each of these
+   * incrementally as events arrive (see the `on*` handlers above), the same
+   * pattern already used for `parseletEntries`. Every value produced here is
+   * identical to what the old rescanning code produced, including its
+   * existing "first bytecode_built event wins" quirk. This is a performance
+   * fix, not a behavior change.
+   */
+  getReport() {
+    if (this.events.length === 0) return void 0;
+    const elapsedNs = performance.now() * 1e6 - this.startNs;
+    const parseCategories = /* @__PURE__ */ new Map();
+    for (const [, entry] of this.parseletEntries) {
+      parseCategories.set(entry.category, entry.count);
+    }
+    const totalOpcodes = this.firstBytecodeOpcodesLength;
+    const cacheHit = this.cacheHitSeen;
+    const totalTokens = this.totalTokens;
+    const report = {
+      events: this.events,
+      parselets: this.parseletMatches.map((e) => ({ ...e })),
+      summary: {
+        totalTokens,
+        totalParselets: parseCategories.size,
+        totalOpcodes,
+        cacheHit,
+        elapsedNs,
+        parseCategories
+      },
+      metadata: {
+        expression: this.lastExpression,
+        inputType: this.lastInputType,
+        timestamp: Date.now(),
+        vmTraceEnabled: this.vmStepSeen
+      },
+      toJSON() {
+        return {
+          events: report.events,
+          parselets: report.parselets,
+          summary: {
+            totalTokens: report.summary.totalTokens,
+            totalParselets: report.summary.totalParselets,
+            totalOpcodes: report.summary.totalOpcodes,
+            cacheHit: report.summary.cacheHit,
+            elapsedNs: report.summary.elapsedNs,
+            parseCategories: Object.fromEntries(report.summary.parseCategories)
+          },
+          metadata: { ...report.metadata }
+        };
+      }
+    };
+    return report;
+  }
+};
+
+// src/diagnostics/events.ts
+var DiagnosticEventType = {
+  TokenEmitted: "token_emitted",
+  NormalizerStart: "normalizer_start",
+  TokenFused: "token_fused",
+  NormalizerEnd: "normalizer_end",
+  ParseletMatched: "parselet_matched",
+  BytecodeBuilt: "bytecode_built",
+  VmStep: "vm_step",
+  VmHalt: "vm_halt",
+  CacheHit: "cache_hit",
+  CacheMiss: "cache_miss",
+  PipelineStart: "pipeline_start",
+  PipelineEnd: "pipeline_end"
+};
+
+export { DiagnosticEventType, DiagnosticPipeline, TimelineDiagnosticCollector };
+//# sourceMappingURL=chunk-G535KJEG.js.map
+//# sourceMappingURL=chunk-G535KJEG.js.map

package/dist/chunk-G535KJEG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/diagnostics/pipeline.ts","../src/diagnostics/collector.ts","../src/diagnostics/timeline-collector.ts","../src/diagnostics/events.ts"],"names":[],"mappings":"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","file":"chunk-G535KJEG.js","sourcesContent":["import { DiagnosticCollector } from \"./collector\";\nimport { DiagnosticEvent } from \"./events\";\nimport { DiagnosticReport } from \"./events\";\n\n/**\n * Dispatches diagnostic events to all registered collectors.\n *\n * Performance guarantee: when no collectors are registered (production mode),\n * every dispatch method is a branch on `this.collectors.length === 0` which\n * modern JS engines will predict and eliminate. The overhead is a single\n * comparison per call, effectively zero.\n */\nexport class DiagnosticPipeline {\n  private collectors: DiagnosticCollector[] = [];\n\n  register(collector: DiagnosticCollector): void {\n    this.collectors.push(collector);\n  }\n\n  unregister(collector: DiagnosticCollector): void {\n    const idx = this.collectors.indexOf(collector);\n    if (idx !== -1) this.collectors.splice(idx, 1);\n  }\n\n  clear(): void {\n    this.collectors = [];\n  }\n\n  get hasCollectors(): boolean {\n    return this.collectors.length > 0;\n  }\n\n  get collectorCount(): number {\n    return this.collectors.length;\n  }\n\n  // Inline-optimized dispatchers, each checks length once then loops.\n  // When collectors.length === 0, the JIT eliminates the entire method body.\n\n  firePipelineStart(event: DiagnosticEvent & { type: \"pipeline_start\" }): void {\n    if (this.collectors.length === 0) return;\n    for (const c of this.collectors) c.onPipelineStart?.(event);\n  }\n\n  fireTokenEmitted(event: DiagnosticEvent & { type: \"token_emitted\" }): void {\n    if (this.collectors.length === 0) return;\n    for (const c of this.collectors) c.onTokenEmitted?.(event);\n  }\n\n  fireNormalizerStart(event: DiagnosticEvent & { type: \"normalizer_start\" }): void {\n    if (this.collectors.length === 0) return;\n    for (const c of this.collectors) c.onNormalizerStart?.(event);\n  }\n\n  fireTokenFused(event: DiagnosticEvent & { type: \"token_fused\" }): void {\n    if (this.collectors.length === 0) return;\n    for (const c of this.collectors) c.onTokenFused?.(event);\n  }\n\n  fireNormalizerEnd(event: DiagnosticEvent & { type: \"normalizer_end\" }): void {\n    if (this.collectors.length === 0) return;\n    for (const c of this.collectors) c.onNormalizerEnd?.(event);\n  }\n\n  fireParseletMatched(event: DiagnosticEvent & { type: \"parselet_matched\" }): void {\n    if (this.collectors.length === 0) return;\n    for (const c of this.collectors) c.onParseletMatched?.(event);\n  }\n\n  fireBytecodeBuilt(event: DiagnosticEvent & { type: \"bytecode_built\" }): void {\n    if (this.collectors.length === 0) return;\n    for (const c of this.collectors) c.onBytecodeBuilt?.(event);\n  }\n\n  fireVmStep(event: DiagnosticEvent & { type: \"vm_step\" }): void {\n    if (this.collectors.length === 0) return;\n    for (const c of this.collectors) c.onVmStep?.(event);\n  }\n\n  fireVmHalt(event: DiagnosticEvent & { type: \"vm_halt\" }): void {\n    if (this.collectors.length === 0) return;\n    for (const c of this.collectors) c.onVmHalt?.(event);\n  }\n\n  fireCacheHit(event: DiagnosticEvent & { type: \"cache_hit\" }): void {\n    if (this.collectors.length === 0) return;\n    for (const c of this.collectors) c.onCacheHit?.(event);\n  }\n\n  fireCacheMiss(event: DiagnosticEvent & { type: \"cache_miss\" }): void {\n    if (this.collectors.length === 0) return;\n    for (const c of this.collectors) c.onCacheMiss?.(event);\n  }\n\n  firePipelineEnd(event: DiagnosticEvent & { type: \"pipeline_end\" }): void {\n    if (this.collectors.length === 0) return;\n    for (const c of this.collectors) c.onPipelineEnd?.(event);\n  }\n\n  collectReports(): DiagnosticReport[] {\n    const reports: DiagnosticReport[] = [];\n    for (const c of this.collectors) {\n      const report = c.getReport();\n      if (report) reports.push(report);\n    }\n    return reports;\n  }\n\n  reset(): void {\n    for (const c of this.collectors) c.reset();\n  }\n}","import { DiagnosticEvent } from \"./events\";\nimport { DiagnosticReport } from \"./events\";\n\n/**\n * Interface for collecting diagnostic data during pipeline execution.\n *\n * All methods are implemented as concrete no-ops so subclasses only\n * need to override the ones they care about. This avoids optional\n * method issues with TypeScript's strict mode.\n *\n * The parameters are named `_event` because these base implementations\n * deliberately ignore them. Overrides are free to name theirs `event` and use\n * it; TypeScript does not match parameter names when checking overrides.\n */\nexport abstract class DiagnosticCollector {\n  onPipelineStart(_event: DiagnosticEvent & { type: \"pipeline_start\" }): void {}\n  onTokenEmitted(_event: DiagnosticEvent & { type: \"token_emitted\" }): void {}\n  onNormalizerStart(_event: DiagnosticEvent & { type: \"normalizer_start\" }): void {}\n  onTokenFused(_event: DiagnosticEvent & { type: \"token_fused\" }): void {}\n  onNormalizerEnd(_event: DiagnosticEvent & { type: \"normalizer_end\" }): void {}\n  onParseletMatched(_event: DiagnosticEvent & { type: \"parselet_matched\" }): void {}\n  onBytecodeBuilt(_event: DiagnosticEvent & { type: \"bytecode_built\" }): void {}\n  onVmStep(_event: DiagnosticEvent & { type: \"vm_step\" }): void {}\n  onVmHalt(_event: DiagnosticEvent & { type: \"vm_halt\" }): void {}\n  onCacheHit(_event: DiagnosticEvent & { type: \"cache_hit\" }): void {}\n  onCacheMiss(_event: DiagnosticEvent & { type: \"cache_miss\" }): void {}\n  onPipelineEnd(_event: DiagnosticEvent & { type: \"pipeline_end\" }): void {}\n\n  abstract getReport(): DiagnosticReport | undefined;\n  abstract reset(): void;\n}","import { DiagnosticCollector } from \"./collector\";\nimport { DiagnosticReport, DiagnosticReportJSON, DiagnosticEvent, CategorizedParselet } from \"./events\";\n\n/**\n * Collects all pipeline events with high-resolution timestamps.\n *\n * Overrides the zero-filled `elapsedNs` on every incoming event with a\n * real `performance.now()` delta from `onPipelineStart`. This enables\n * per-stage timing extraction from the event timeline (lexer/parser/\n * compiler/VM breakdown) rather than relying on a single total elapsed.\n *\n * Produces a complete DiagnosticReport at the end of evaluation.\n */\nexport class TimelineDiagnosticCollector extends DiagnosticCollector {\n  private events: DiagnosticEvent[] = [];\n  private startNs: number = 0;\n  private parseletEntries: Map<string, { category: string; count: number }> = new Map();\n\n  // Incrementally-maintained summary state. See getReport()'s doc comment\n  // for why these exist. Each mirrors exactly what getReport() used to\n  // recompute by rescanning the full `events` array on every call.\n  private totalTokens = 0;\n  private cacheHitSeen = false;\n  private vmStepSeen = false;\n  private hasBytecodeBuilt = false;\n  private firstBytecodeOpcodesLength = 0;\n  private parseletMatches: CategorizedParselet[] = [];\n  private lastExpression = \"\";\n  private lastInputType = \"\";\n\n  /**\n   * Current cumulative count of `parselet_matched` events seen since\n   * construction (or the last `reset()`), a cheap peek that doesn't build\n   * the full report (`getReport()` copies the whole `parseletMatches`\n   * array). Used by `ExpressionEngine.evaluateExpressionWithDiagnostic()`\n   * to capture a \"before\" baseline per line, since `parseletMatches` itself\n   * is deliberately cumulative across an entire document pass (see\n   * `onPipelineStart`'s doc comment) rather than reset per line.\n   */\n  get parseletMatchCount(): number {\n    return this.parseletMatches.length;\n  }\n\n  reset(): void {\n    this.events = [];\n    this.parseletEntries.clear();\n    this.startNs = 0;\n    this.totalTokens = 0;\n    this.cacheHitSeen = false;\n    this.vmStepSeen = false;\n    this.hasBytecodeBuilt = false;\n    this.firstBytecodeOpcodesLength = 0;\n    this.parseletMatches = [];\n    this.lastExpression = \"\";\n    this.lastInputType = \"\";\n  }\n\n  /** Stamp the real wall-clock `elapsedNs` onto an event before storing it. */\n  private stamp<T extends DiagnosticEvent>(event: T): T {\n    const elapsedNs = this.startNs !== 0\n      ? performance.now() * 1e6 - this.startNs\n      : 0;\n    return { ...event, elapsedNs } as T;\n  }\n\n  onPipelineStart(event: DiagnosticEvent & { type: \"pipeline_start\" }): void {\n    // Set once per collector lifetime (until an explicit reset()), not on\n    // every pipeline, a multi-line evaluation pass fires pipeline_start\n    // once per line, all appending to the SAME `events` array (see\n    // buildLineStats() in the playground, which relies on that shared,\n    // ever-growing array to slice out each line's own events via\n    // cumulative-length diffing). Resetting the origin on every line meant\n    // every individual line's own timestamps were self-consistent, but\n    // nothing tied one line's clock to another's, any code trying to\n    // compare or span timestamps ACROSS lines (e.g. \"how far into this\n    // pass are we\") had no stable reference point to do it with.\n    if (this.startNs === 0) {\n      this.startNs = performance.now() * 1e6;\n    }\n    // Tracked incrementally (most-recent wins) so getReport()'s `metadata`\n    // describes the line THIS report is actually about, reading\n    // `events[0]` instead (the old code) froze `expression`/`inputType` on\n    // the very first line ever evaluated in the session, forever, which is\n    // wrong regardless of whether a field is meant to be cumulative or\n    // per-line: nothing downstream ever wanted \"line 1's expression\" once\n    // the document had moved on to line 50.\n    this.lastExpression = event.expression;\n    this.lastInputType = event.inputType;\n    this.events.push(this.stamp(event));\n  }\n\n  onTokenEmitted(event: DiagnosticEvent & { type: \"token_emitted\" }): void {\n    this.events.push(this.stamp(event));\n    this.totalTokens++;\n  }\n\n  onNormalizerStart(event: DiagnosticEvent & { type: \"normalizer_start\" }): void {\n    this.events.push(this.stamp(event));\n  }\n\n  onTokenFused(event: DiagnosticEvent & { type: \"token_fused\" }): void {\n    this.events.push(this.stamp(event));\n  }\n\n  onNormalizerEnd(event: DiagnosticEvent & { type: \"normalizer_end\" }): void {\n    this.events.push(this.stamp(event));\n  }\n\n  onParseletMatched(event: DiagnosticEvent & { type: \"parselet_matched\" }): void {\n    this.events.push(this.stamp(event));\n\n    const entry = this.parseletEntries.get(event.parseletCategory);\n    if (entry) {\n      entry.count++;\n    } else {\n      this.parseletEntries.set(event.parseletCategory, {\n        category: event.parseletCategory,\n        count: 1,\n      });\n    }\n\n    this.parseletMatches.push({\n      tokenType: event.tokenType,\n      tokenValue: event.tokenValue,\n      parseletCategory: event.parseletCategory,\n      parseletType: event.parseletType,\n      isPrefix: event.isPrefix,\n      bindingPower: event.bindingPower,\n      tokenOffset: event.tokenOffset,\n    });\n  }\n\n  onBytecodeBuilt(event: DiagnosticEvent & { type: \"bytecode_built\" }): void {\n    this.events.push(this.stamp(event));\n    // Matches getReport()'s original behavior: the FIRST bytecode_built\n    // event ever seen (not the most recent) wins, preserved as-is here\n    // this rewrite only changes HOW that value is computed, not what it is.\n    if (!this.hasBytecodeBuilt) {\n      this.hasBytecodeBuilt = true;\n      this.firstBytecodeOpcodesLength = event.opcodesLength;\n    }\n  }\n\n  onVmStep(event: DiagnosticEvent & { type: \"vm_step\" }): void {\n    this.events.push(this.stamp(event));\n    this.vmStepSeen = true;\n  }\n\n  onVmHalt(event: DiagnosticEvent & { type: \"vm_halt\" }): void {\n    this.events.push(this.stamp(event));\n  }\n\n  onCacheHit(event: DiagnosticEvent & { type: \"cache_hit\" }): void {\n    this.events.push(this.stamp(event));\n    this.cacheHitSeen = true;\n  }\n\n  onCacheMiss(event: DiagnosticEvent & { type: \"cache_miss\" }): void {\n    this.events.push(this.stamp(event));\n  }\n\n  onPipelineEnd(event: DiagnosticEvent & { type: \"pipeline_end\" }): void {\n    this.events.push(this.stamp(event));\n  }\n\n/**\n * Build the summary/metadata/parselets report from this collector's\n * running state.\n *\n * These fields used to be recomputed by rescanning the FULL `events`\n * array on every single call (`.some()`/`.filter()`/a manual scan), since\n * `events` is never cleared except by an explicit `reset()` (which nothing\n * in `ExpressionEngine` currently calls, the cumulative-across-the-whole-\n * document design is deliberate, see `onPipelineStart`'s comment and the\n * playground's `buildLineStats()`, which slices per-line events out of\n * this ever-growing array via cumulative-length diffing), that meant\n * per-call cost grew linearly with total prior calls: O(n²) diagnostic-mode\n * evaluation over a document's lifetime. Fixed by maintaining each of these\n * incrementally as events arrive (see the `on*` handlers above), the same\n * pattern already used for `parseletEntries`. Every value produced here is\n * identical to what the old rescanning code produced, including its\n * existing \"first bytecode_built event wins\" quirk. This is a performance\n * fix, not a behavior change.\n */\ngetReport(): DiagnosticReport | undefined {\n     if (this.events.length === 0) return undefined;\n\n     const elapsedNs = performance.now() * 1e6 - this.startNs;\n\n     const parseCategories = new Map<string, number>();\n     for (const [, entry] of this.parseletEntries) {\n       parseCategories.set(entry.category, entry.count);\n     }\n\n     const totalOpcodes = this.firstBytecodeOpcodesLength;\n     const cacheHit = this.cacheHitSeen;\n     const totalTokens = this.totalTokens;\n\n     const report: DiagnosticReport = {\n       events: this.events,\n       parselets: this.parseletMatches.map((e) => ({ ...e })),\n       summary: {\n         totalTokens,\n         totalParselets: parseCategories.size,\n         totalOpcodes,\n         cacheHit,\n         elapsedNs,\n         parseCategories,\n       },\n       metadata: {\n         expression: this.lastExpression,\n         inputType: this.lastInputType,\n         timestamp: Date.now(),\n         vmTraceEnabled: this.vmStepSeen,\n       },\n       toJSON(): DiagnosticReportJSON {\n         return {\n           events: report.events,\n           parselets: report.parselets,\n           summary: {\n             totalTokens: report.summary.totalTokens,\n             totalParselets: report.summary.totalParselets,\n             totalOpcodes: report.summary.totalOpcodes,\n             cacheHit: report.summary.cacheHit,\n             elapsedNs: report.summary.elapsedNs,\n             parseCategories: Object.fromEntries(report.summary.parseCategories),\n           },\n           metadata: { ...report.metadata },\n         };\n       },\n     };\n\n     return report;\n   }\n}","\n\nimport type { MatrixData, RangeData } from \"@solve-js/vm/Value\";\nimport type { SymbolicNode } from \"@solve-js/symbolic\";\n\n/**\n * Diagnostic event types as string constants (not const enum, for cross-module compatibility with isolatedModules)\n */\nexport const DiagnosticEventType = {\n  TokenEmitted: \"token_emitted\",\n  NormalizerStart: \"normalizer_start\",\n  TokenFused: \"token_fused\",\n  NormalizerEnd: \"normalizer_end\",\n  ParseletMatched: \"parselet_matched\",\n  BytecodeBuilt: \"bytecode_built\",\n  VmStep: \"vm_step\",\n  VmHalt: \"vm_halt\",\n  CacheHit: \"cache_hit\",\n  CacheMiss: \"cache_miss\",\n  PipelineStart: \"pipeline_start\",\n  PipelineEnd: \"pipeline_end\",\n} as const;\n\n/** Discriminator naming which pipeline event a diagnostic record describes. */\nexport type EventType = (typeof DiagnosticEventType)[keyof typeof DiagnosticEventType];\n\n/** Base event, all events include a timestamp relative to pipeline start */\nexport interface BaseEvent {\n  readonly type: string;\n  readonly elapsedNs: number;\n  readonly expression: string;\n}\n\n/** Emitted after each token is produced by the lexer */\nexport interface TokenEmittedEvent extends BaseEvent {\n  readonly type: \"token_emitted\";\n  readonly token: {\n    readonly type: string;\n    readonly value: string;\n    readonly offset: number;\n    readonly line: number;\n    readonly col: number;\n  };\n}\n\n/** Emitted when the parser resolves a parselet for a token */\nexport interface ParseletMatchedEvent extends BaseEvent {\n  readonly type: \"parselet_matched\";\n  readonly tokenType: string;\n  readonly tokenValue: string;\n  readonly parseletCategory: string;\n  readonly parseletType: string;\n  readonly isPrefix: boolean;\n  readonly bindingPower?: number;\n  readonly tokenOffset: number;\n}\n\n/** Emitted after bytecode is built */\nexport interface BytecodeBuiltEvent extends BaseEvent {\n  readonly type: \"bytecode_built\";\n  readonly opcodesLength: number;\n  readonly numbersLength: number;\n  readonly stringsLength: number;\n  readonly isCached: boolean;\n}\n\n/** Emitted after each VM opcode execution (only when vmTrace is enabled) */\nexport interface VmStepEvent extends BaseEvent {\n  readonly type: \"vm_step\";\n  readonly opcode: number;\n  readonly opcodeName: string;\n  readonly ip: number;\n  readonly stackDepth: number;\n  readonly instructionNumber: number;\n  readonly stack: ReadonlyArray<{\n    readonly type: number;\n    readonly value: number | bigint | string | boolean | MatrixData | RangeData | SymbolicNode;\n    readonly unit?: string;\n  }>;\n}\n\n/** Emitted when the VM halts with a result */\nexport interface VmHaltEvent extends BaseEvent {\n  readonly type: \"vm_halt\";\n  readonly result?: {\n    readonly type: number;\n    readonly value: number | bigint | string | boolean | MatrixData | RangeData | SymbolicNode;\n    readonly unit?: string;\n  };\n}\n\n/** Emitted on cache hit */\nexport interface CacheHitEvent extends BaseEvent {\n  readonly type: \"cache_hit\";\n  readonly cache: \"bytecode\" | \"line\";\n  readonly key: string;\n}\n\n/** Emitted on cache miss */\nexport interface CacheMissEvent extends BaseEvent {\n  readonly type: \"cache_miss\";\n  readonly cache: \"bytecode\" | \"line\";\n  readonly key: string;\n}\n\n/** Emitted when a pipeline evaluation begins */\nexport interface PipelineStartEvent extends BaseEvent {\n  readonly type: \"pipeline_start\";\n  readonly inputType: string;\n}\n\n/** Emitted when a pipeline evaluation completes */\nexport interface PipelineEndEvent extends BaseEvent {\n  readonly type: \"pipeline_end\";\n  readonly success: boolean;\n  readonly error?: string;\n  readonly totalTokens: number;\n  readonly totalOpcodes: number;\n}\n\n/** Emitted when the normalizer begins its pass */\nexport interface NormalizerStartEvent extends BaseEvent {\n  readonly type: \"normalizer_start\";\n  readonly inputTokenCount: number;\n}\n\n/** Emitted when the normalizer fuses tokens */\nexport interface TokenFusedEvent extends BaseEvent {\n  readonly type: \"token_fused\";\n  readonly ruleName: string;\n  readonly sourceTokenCount: number;\n  readonly fusedTokenType: string;\n  readonly fusedTokenValue: string;\n}\n\n/** Emitted when the normalizer completes its pass */\nexport interface NormalizerEndEvent extends BaseEvent {\n  readonly type: \"normalizer_end\";\n  readonly outputTokenCount: number;\n  readonly fusionsCount: number;\n}\n\n/** Union of all event types */\nexport type DiagnosticEvent =\n  | TokenEmittedEvent\n  | NormalizerStartEvent\n  | TokenFusedEvent\n  | NormalizerEndEvent\n  | ParseletMatchedEvent\n  | BytecodeBuiltEvent\n  | VmStepEvent\n  | VmHaltEvent\n  | CacheHitEvent\n  | CacheMissEvent\n  | PipelineStartEvent\n  | PipelineEndEvent;\n\n/** Categorized parselet info */\nexport interface CategorizedParselet {\n  readonly tokenType: string;\n  readonly tokenValue: string;\n  readonly parseletCategory: string;\n  readonly parseletType: string;\n  readonly isPrefix: boolean;\n  readonly bindingPower?: number;\n  readonly tokenOffset: number;\n}\n\n/** JSON-serializable representation of a DiagnosticReport */\nexport interface DiagnosticReportJSON {\n   readonly events: readonly DiagnosticEvent[];\n   readonly parselets: readonly CategorizedParselet[];\n   readonly summary: {\n     readonly totalTokens: number;\n     readonly totalParselets: number;\n     readonly totalOpcodes: number;\n     readonly cacheHit: boolean;\n     readonly elapsedNs: number;\n     readonly parseCategories: Record<string, number>;\n   };\n   readonly metadata: {\n     readonly expression: string;\n     readonly inputType: string;\n     readonly timestamp: number;\n     readonly vmTraceEnabled: boolean;\n   };\n}\n\n/** Structured diagnostic report */\nexport interface DiagnosticReport {\n   readonly events: readonly DiagnosticEvent[];\n   readonly parselets: readonly CategorizedParselet[];\n   readonly summary: {\n     readonly totalTokens: number;\n     readonly totalParselets: number;\n     readonly totalOpcodes: number;\n     readonly cacheHit: boolean;\n     readonly elapsedNs: number;\n     readonly parseCategories: ReadonlyMap<string, number>;\n   };\n   readonly metadata: {\n     readonly expression: string;\n     readonly inputType: string;\n     readonly timestamp: number;\n     readonly vmTraceEnabled: boolean;\n   };\n\n   /** Serialize to a JSON-safe plain object */\n   toJSON(): DiagnosticReportJSON;\n}\n\n/** JSON-serializable representation of a DiagnosticReport */\nexport interface DiagnosticReportJSON {\n   readonly events: readonly DiagnosticEvent[];\n   readonly parselets: readonly CategorizedParselet[];\n   readonly summary: {\n     readonly totalTokens: number;\n     readonly totalParselets: number;\n     readonly totalOpcodes: number;\n     readonly cacheHit: boolean;\n     readonly elapsedNs: number;\n     readonly parseCategories: Record<string, number>;\n   };\n   readonly metadata: {\n     readonly expression: string;\n     readonly inputType: string;\n     readonly timestamp: number;\n     readonly vmTraceEnabled: boolean;\n   };\n}"]}

package/dist/chunk-GCM5JHMX.js

@@ -0,0 +1,88 @@
+// src/variables/VariableResolver.ts
+var VariableResolver = class {
+  constructor() {
+    this.sources = [];
+    this.cache = /* @__PURE__ */ new Map();
+    this.cacheEnabled = true;
+  }
+  /**
+   * Register a variable source with a given priority.
+   * Sources are sorted so lower-priority-number sources are queried first.
+   *
+   * @param source - The variable source to register
+   */
+  registerSource(source) {
+    this.sources.push(source);
+    this.sources.sort((a, b) => a.priority - b.priority);
+  }
+  /**
+   * Remove a previously registered variable source (identity match).
+   * The lookup cache is cleared because resolution results may change
+   * once the source no longer participates.
+   *
+   * @param source - The exact source instance passed to registerSource.
+   */
+  unregisterSource(source) {
+    const idx = this.sources.indexOf(source);
+    if (idx !== -1) {
+      this.sources.splice(idx, 1);
+      this.cache.clear();
+    }
+  }
+  /**
+   * Resolve a variable name to its value.
+   *
+   * Checks the cache first (if enabled), then queries registered sources
+   * in priority order. The first source returning a non-undefined value wins.
+   * Cached results are stored and returned on subsequent calls until invalidated.
+   *
+   * @param name - The variable name to resolve
+   * @returns The resolved value, or undefined if not found in any source
+   */
+  async resolve(name) {
+    if (this.cacheEnabled) {
+      const cached = this.cache.get(name);
+      if (cached !== void 0) return cached;
+    }
+    for (const source of this.sources) {
+      const value = await source.get(name);
+      if (value !== void 0) {
+        if (this.cacheEnabled) {
+          this.cache.set(name, value);
+        }
+        return value;
+      }
+    }
+    return void 0;
+  }
+  /**
+   * Set a variable value across all registered sources.
+   * Also updates the local cache so subsequent reads return the new value.
+   *
+   * @param name - The variable name
+   * @param value - The value to set
+   */
+  async set(name, value) {
+    for (const source of this.sources) {
+      await source.set(name, value);
+    }
+    this.cache.set(name, value);
+  }
+  /** Invalidate a single variable in the cache, forcing re-resolution on next read. */
+  invalidate(name) {
+    this.cache.delete(name);
+  }
+  /** Invalidate all cached variable lookups. */
+  invalidateAll() {
+    this.cache.clear();
+  }
+  /** Enable or disable the lookup cache. When disabled, every read queries sources directly. */
+  setCacheEnabled(enabled) {
+    this.cacheEnabled = enabled;
+  }
+};
+var sharedVariableResolver = new VariableResolver();
+
+export { VariableResolver, sharedVariableResolver };
+//# sourceMappingURL=chunk-GCM5JHMX.js.map
+//# sourceMappingURL=chunk-GCM5JHMX.js.map

package/dist/chunk-GCM5JHMX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/variables/VariableResolver.ts"],"names":[],"mappings":";AASO,IAAM,mBAAN,MAAuB;AAAA,EAAvB,WAAA,GAAA;AACN,IAAA,IAAA,CAAQ,UAA6B,EAAC;AACtC,IAAA,IAAA,CAAQ,KAAA,uBAAsD,GAAA,EAAI;AAClE,IAAA,IAAA,CAAQ,YAAA,GAAe,IAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQvB,eAAe,MAAA,EAA+B;AAC7C,IAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,MAAM,CAAA;AACxB,IAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,CAAC,CAAA,EAAG,MAAM,CAAA,CAAE,QAAA,GAAW,EAAE,QAAQ,CAAA;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,iBAAiB,MAAA,EAA+B;AAC/C,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,OAAA,CAAQ,OAAA,CAAQ,MAAM,CAAA;AACvC,IAAA,IAAI,QAAQ,EAAA,EAAI;AACf,MAAA,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAO,GAAA,EAAK,CAAC,CAAA;AAC1B,MAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AAAA,IAClB;AAAA,EACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,QAAQ,IAAA,EAAoD;AACjE,IAAA,IAAI,KAAK,YAAA,EAAc;AACtB,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAI,CAAA;AAClC,MAAA,IAAI,MAAA,KAAW,QAAW,OAAO,MAAA;AAAA,IAClC;AAEA,IAAA,KAAA,MAAW,MAAA,IAAU,KAAK,OAAA,EAAS;AAClC,MAAA,MAAM,KAAA,GAAQ,MAAM,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA;AACnC,MAAA,IAAI,UAAU,MAAA,EAAW;AACxB,QAAA,IAAI,KAAK,YAAA,EAAc;AACtB,UAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAA,EAAM,KAAK,CAAA;AAAA,QAC3B;AACA,QAAA,OAAO,KAAA;AAAA,MACR;AAAA,IACD;AAEA,IAAA,OAAO,MAAA;AAAA,EACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,GAAA,CAAI,IAAA,EAAc,KAAA,EAAuC;AAC9D,IAAA,KAAA,MAAW,MAAA,IAAU,KAAK,OAAA,EAAS;AAClC,MAAA,MAAM,MAAA,CAAO,GAAA,CAAI,IAAA,EAAM,KAAK,CAAA;AAAA,IAC7B;AACA,IAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAA,EAAM,KAAK,CAAA;AAAA,EAC3B;AAAA;AAAA,EAGA,WAAW,IAAA,EAAoB;AAC9B,IAAA,IAAA,CAAK,KAAA,CAAM,OAAO,IAAI,CAAA;AAAA,EACvB;AAAA;AAAA,EAGA,aAAA,GAAsB;AACrB,IAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AAAA,EAClB;AAAA;AAAA,EAGA,gBAAgB,OAAA,EAAwB;AACvC,IAAA,IAAA,CAAK,YAAA,GAAe,OAAA;AAAA,EACrB;AACD;AAGO,IAAM,sBAAA,GAAyB,IAAI,gBAAA","file":"chunk-GCM5JHMX.js","sourcesContent":["import { IVariableSource } from \"@solve-js/variables/IVariableSource\";\n\n/**\n * Resolves variable names by querying registered {@link IVariableSource} instances\n * in priority order. Supports caching for repeated lookups.\n *\n * Sources are sorted by priority (lowest first) on registration. When resolving\n * a variable, sources are queried in order and the first non-undefined result wins.\n */\nexport class VariableResolver {\n\tprivate sources: IVariableSource[] = [];\n\tprivate cache: Map<string, number | string | undefined> = new Map();\n\tprivate cacheEnabled = true;\n\n\t/**\n\t * Register a variable source with a given priority.\n\t * Sources are sorted so lower-priority-number sources are queried first.\n\t *\n\t * @param source - The variable source to register\n\t */\n\tregisterSource(source: IVariableSource): void {\n\t\tthis.sources.push(source);\n\t\tthis.sources.sort((a, b) => a.priority - b.priority);\n\t}\n\n\t/**\n\t * Remove a previously registered variable source (identity match).\n\t * The lookup cache is cleared because resolution results may change\n\t * once the source no longer participates.\n\t *\n\t * @param source - The exact source instance passed to registerSource.\n\t */\n\tunregisterSource(source: IVariableSource): void {\n\t\tconst idx = this.sources.indexOf(source);\n\t\tif (idx !== -1) {\n\t\t\tthis.sources.splice(idx, 1);\n\t\t\tthis.cache.clear();\n\t\t}\n\t}\n\n\t/**\n\t * Resolve a variable name to its value.\n\t *\n\t * Checks the cache first (if enabled), then queries registered sources\n\t * in priority order. The first source returning a non-undefined value wins.\n\t * Cached results are stored and returned on subsequent calls until invalidated.\n\t *\n\t * @param name - The variable name to resolve\n\t * @returns The resolved value, or undefined if not found in any source\n\t */\n\tasync resolve(name: string): Promise<number | string | undefined> {\n\t\tif (this.cacheEnabled) {\n\t\t\tconst cached = this.cache.get(name);\n\t\t\tif (cached !== undefined) return cached;\n\t\t}\n\n\t\tfor (const source of this.sources) {\n\t\t\tconst value = await source.get(name);\n\t\t\tif (value !== undefined) {\n\t\t\t\tif (this.cacheEnabled) {\n\t\t\t\t\tthis.cache.set(name, value);\n\t\t\t\t}\n\t\t\t\treturn value;\n\t\t\t}\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Set a variable value across all registered sources.\n\t * Also updates the local cache so subsequent reads return the new value.\n\t *\n\t * @param name - The variable name\n\t * @param value - The value to set\n\t */\n\tasync set(name: string, value: number | string): Promise<void> {\n\t\tfor (const source of this.sources) {\n\t\t\tawait source.set(name, value);\n\t\t}\n\t\tthis.cache.set(name, value);\n\t}\n\n\t/** Invalidate a single variable in the cache, forcing re-resolution on next read. */\n\tinvalidate(name: string): void {\n\t\tthis.cache.delete(name);\n\t}\n\n\t/** Invalidate all cached variable lookups. */\n\tinvalidateAll(): void {\n\t\tthis.cache.clear();\n\t}\n\n\t/** Enable or disable the lookup cache. When disabled, every read queries sources directly. */\n\tsetCacheEnabled(enabled: boolean): void {\n\t\tthis.cacheEnabled = enabled;\n\t}\n}\n\n/** Shared singleton VariableResolver instance. */\nexport const sharedVariableResolver = new VariableResolver();\n"]}