solve-engine 1.1.1 → 2.0.0

package/dist/chunk-X6K3HUOY.cjs

@@ -1,86 +0,0 @@
-'use strict';
-
-// src/resolvers/ResolverRegistry.ts
-var ResolverRegistry = class {
-  constructor() {
-    this.resolvers = /* @__PURE__ */ new Map();
-  }
-  /**
-   * Register an async resolver.
-   *
-   * Each resolver must have a unique `namespace`. If a resolver with the
-   * same namespace is already registered, the old one is destroyed and
-   * replaced (with a console warning). Packages that need multiple async
-   * operations should use `asyncResolvers: [...]` with distinct namespaces
-   * (e.g., `"weather:current"`, `"weather:forecast"`).
-   */
-  register(resolver) {
-    if (this.resolvers.has(resolver.namespace)) {
-      console.warn(
-        `[ResolverRegistry] Namespace "${resolver.namespace}" already registered. Destroying old resolver and overwriting. Use distinct namespaces (e.g., "${resolver.namespace}:sub1", "${resolver.namespace}:sub2") to avoid collisions when a package needs multiple async resolvers.`
-      );
-      this.resolvers.get(resolver.namespace).destroy();
-    }
-    this.resolvers.set(resolver.namespace, resolver);
-  }
-  /**
-   * Unregister a resolver by namespace.
-   * Calls destroy() and clears all cache entries with that namespace prefix.
-   */
-  unregister(namespace, queryClient) {
-    const resolver = this.resolvers.get(namespace);
-    if (resolver) {
-      resolver.destroy();
-      this.resolvers.delete(namespace);
-    }
-    if (queryClient) {
-      queryClient.removeQueries({ queryKey: [namespace] });
-    }
-  }
-  /**
-   * Run all registered resolvers' preflight checks against compiled bytecode.
-   *
-   * Returns the first AsyncCheckResult found, or null if all data is ready.
-   * Short-circuits on first pending, subsequent pending ops will be
-   * discovered on re-evaluation when the first resolves.
-   */
-  preflightAll(tokens, bytecode, packageId, signal, queryClient) {
-    for (const resolver of this.resolvers.values()) {
-      if (!resolver.preflight) continue;
-      const result = resolver.preflight(tokens, bytecode, packageId, signal, queryClient);
-      if (result) return result;
-    }
-    return null;
-  }
-  /**
-   * Get a resolver by namespace.
-   * Returns undefined if no resolver is registered for that namespace.
-   */
-  get(namespace) {
-    return this.resolvers.get(namespace);
-  }
-  /** Number of registered resolvers. */
-  get size() {
-    return this.resolvers.size;
-  }
-  /**
-   * Check if a resolver is registered for the given namespace.
-   */
-  has(namespace) {
-    return this.resolvers.has(namespace);
-  }
-  /**
-   * Clear all resolvers (document switch, engine reset).
-   * Calls destroy() on each resolver and clears the map.
-   */
-  clear() {
-    for (const resolver of this.resolvers.values()) {
-      resolver.destroy();
-    }
-    this.resolvers.clear();
-  }
-};
-
-exports.ResolverRegistry = ResolverRegistry;
-//# sourceMappingURL=chunk-X6K3HUOY.cjs.map
-//# sourceMappingURL=chunk-X6K3HUOY.cjs.map

package/dist/chunk-X6K3HUOY.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resolvers/ResolverRegistry.ts"],"names":[],"mappings":";;;AAuEO,IAAM,mBAAN,MAAuB;AAAA,EAAvB,WAAA,GAAA;AACN,IAAA,IAAA,CAAQ,SAAA,uBAAgB,GAAA,EAA4B;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWpD,SAAS,QAAA,EAAgC;AAExC,IAAA,IAAI,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,QAAA,CAAS,SAAS,CAAA,EAAG;AAC3C,MAAA,OAAA,CAAQ,IAAA;AAAA,QACP,CAAA,8BAAA,EAAiC,SAAS,SAAS,CAAA,+FAAA,EAExC,SAAS,SAAS,CAAA,SAAA,EAAY,SAAS,SAAS,CAAA,0EAAA;AAAA,OAE5D;AACA,MAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,QAAA,CAAS,SAAS,EAAG,OAAA,EAAQ;AAAA,IACjD;AACA,IAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,QAAA,CAAS,SAAA,EAAW,QAAQ,CAAA;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAAA,CAAW,WAAmB,WAAA,EAAiC;AAC9D,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,SAAS,CAAA;AAC7C,IAAA,IAAI,QAAA,EAAU;AACb,MAAA,QAAA,CAAS,OAAA,EAAQ;AACjB,MAAA,IAAA,CAAK,SAAA,CAAU,OAAO,SAAS,CAAA;AAAA,IAChC;AAGA,IAAA,IAAI,WAAA,EAAa;AAChB,MAAA,WAAA,CAAY,cAAc,EAAE,QAAA,EAAU,CAAC,SAAS,GAAG,CAAA;AAAA,IACpD;AAAA,EACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,YAAA,CAAa,MAAA,EAAiB,QAAA,EAA2B,SAAA,EAAmB,QAAqB,WAAA,EAAmD;AACnJ,IAAA,KAAA,MAAW,QAAA,IAAY,IAAA,CAAK,SAAA,CAAU,MAAA,EAAO,EAAG;AAC/C,MAAA,IAAI,CAAC,SAAS,SAAA,EAAW;AACzB,MAAA,MAAM,SAAS,QAAA,CAAS,SAAA,CAAU,QAAQ,QAAA,EAAU,SAAA,EAAW,QAAQ,WAAW,CAAA;AAClF,MAAA,IAAI,QAAQ,OAAO,MAAA;AAAA,IACpB;AACA,IAAA,OAAO,IAAA;AAAA,EACR;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,SAAA,EAA+C;AAClD,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,SAAS,CAAA;AAAA,EACpC;AAAA;AAAA,EAGA,IAAI,IAAA,GAAe;AAClB,IAAA,OAAO,KAAK,SAAA,CAAU,IAAA;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,SAAA,EAA4B;AAC/B,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,SAAS,CAAA;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,KAAA,GAAc;AACb,IAAA,KAAA,MAAW,QAAA,IAAY,IAAA,CAAK,SAAA,CAAU,MAAA,EAAO,EAAG;AAC/C,MAAA,QAAA,CAAS,OAAA,EAAQ;AAAA,IAClB;AACA,IAAA,IAAA,CAAK,UAAU,KAAA,EAAM;AAAA,EACtB;AACD","file":"chunk-X6K3HUOY.cjs","sourcesContent":["import type { QueryClient } from \"@tanstack/query-core\";\nimport type { Token } from \"@solve-js/lexer\";\nimport type { BytecodeProgram } from \"@solve-js/parser/BytecodeBuilder\";\nimport type { Value } from \"@solve-js/vm/Value\";\n\n/**\n * Result from a resolver's preflight() check.\n * Returned when async data is needed, the orchestrator uses this\n * to subscribe to the resolver and return a Pending value immediately.\n */\nexport interface AsyncCheckResult {\n\t/** Unique cache key for deduplication (e.g., \"{packageId}:rates:USD:GBP\") */\n\tqueryKey: string;\n\t/** Promise that resolves to the final Value */\n\tresolver: Promise<Value>;\n\t/** Package owning this resolver */\n\tpackageId: string;\n\t/** AbortSignal for stale-data prevention */\n\tsignal: AbortSignal;\n\t/** Optional metadata for diagnostics */\n\tmetadata?: Record<string, unknown>;\n}\n\n/**\n * Interface for async resolvers registered by packages/plugins.\n *\n * Each resolver handles a domain of async data (currency rates,\n * weather, stock prices, etc.). The preflight() method is called\n * BEFORE VM execution to check if all data is cached. If not,\n * it returns an AsyncCheckResult and the engine skips the VM,\n * returning a Pending value instead.\n */\nexport interface IAsyncResolver {\n\t/** Unique namespace for cache key scoping (e.g., \"currency\", \"weather\") */\n\treadonly namespace: string;\n\n\t/**\n\t * Pre-flight check: called BEFORE VM execution.\n\t *\n\t * Returns null if all data for this expression is cached and ready.\n\t * Returns an AsyncCheckResult if async work is needed.\n\t *\n\t * This method is synchronous, it only checks caches, never fetches.\n\t * If data is missing, it creates a Promise and returns immediately.\n\t *\n\t * @param tokens - The lexed tokens for the expression\n\t * @param bytecode - The compiled bytecode program\n\t * @param pluginId - The plugin ID (for cache key scoping)\n\t * @param signal - AbortSignal for the current evaluation\n\t */\n\tpreflight?(tokens: Token[], bytecode: BytecodeProgram, packageId: string, signal: AbortSignal, queryClient: QueryClient): AsyncCheckResult | null;\n\n\t/**\n\t * Called when the resolver's namespace is being unregistered.\n\t * Clean up any in-flight promises, clear caches, unsubscribe.\n\t */\n\tdestroy(): void;\n}\n\n/**\n * Registry of async resolvers, keyed by namespace.\n *\n * Plugins/packages register resolvers alongside their parselets\n * and opcode handlers. The engine calls preflightAll() before\n * VM execution to short-circuit async expressions.\n *\n * Lifecycle:\n * - register(), when a package is loaded\n * - unregister(), when a package is unloaded (clears cache entries)\n * - clear(), on document switch (clears all resolvers)\n */\nexport class ResolverRegistry {\n\tprivate resolvers = new Map<string, IAsyncResolver>();\n\n\t/**\n\t * Register an async resolver.\n\t *\n\t * Each resolver must have a unique `namespace`. If a resolver with the\n\t * same namespace is already registered, the old one is destroyed and\n\t * replaced (with a console warning). Packages that need multiple async\n\t * operations should use `asyncResolvers: [...]` with distinct namespaces\n\t * (e.g., `\"weather:current\"`, `\"weather:forecast\"`).\n\t */\n\tregister(resolver: IAsyncResolver): void {\n\t\t// Clean up previous resolver with same namespace if any\n\t\tif (this.resolvers.has(resolver.namespace)) {\n\t\t\tconsole.warn(\n\t\t\t\t`[ResolverRegistry] Namespace \"${resolver.namespace}\" already registered. ` +\n\t\t\t\t`Destroying old resolver and overwriting. Use distinct namespaces ` +\n\t\t\t\t`(e.g., \"${resolver.namespace}:sub1\", \"${resolver.namespace}:sub2\") ` +\n\t\t\t\t`to avoid collisions when a package needs multiple async resolvers.`,\n\t\t\t);\n\t\t\tthis.resolvers.get(resolver.namespace)!.destroy();\n\t\t}\n\t\tthis.resolvers.set(resolver.namespace, resolver);\n\t}\n\n\t/**\n\t * Unregister a resolver by namespace.\n\t * Calls destroy() and clears all cache entries with that namespace prefix.\n\t */\n\tunregister(namespace: string, queryClient?: QueryClient): void {\n\t\tconst resolver = this.resolvers.get(namespace);\n\t\tif (resolver) {\n\t\t\tresolver.destroy();\n\t\t\tthis.resolvers.delete(namespace);\n\t\t}\n\t\t// Clear all cache entries for this namespace via TanStack Query\n\t\t// Hierarchical keys: [\"osrs\"] clears all [\"osrs\", ...] queries\n\t\tif (queryClient) {\n\t\t\tqueryClient.removeQueries({ queryKey: [namespace] });\n\t\t}\n\t}\n\n\t/**\n\t * Run all registered resolvers' preflight checks against compiled bytecode.\n\t *\n\t * Returns the first AsyncCheckResult found, or null if all data is ready.\n\t * Short-circuits on first pending, subsequent pending ops will be\n\t * discovered on re-evaluation when the first resolves.\n\t */\n\tpreflightAll(tokens: Token[], bytecode: BytecodeProgram, packageId: string, signal: AbortSignal, queryClient: QueryClient): AsyncCheckResult | null {\n\t\tfor (const resolver of this.resolvers.values()) {\n\t\t\tif (!resolver.preflight) continue;\n\t\t\tconst result = resolver.preflight(tokens, bytecode, packageId, signal, queryClient);\n\t\t\tif (result) return result;\n\t\t}\n\t\treturn null;\n\t}\n\n\t/**\n\t * Get a resolver by namespace.\n\t * Returns undefined if no resolver is registered for that namespace.\n\t */\n\tget(namespace: string): IAsyncResolver | undefined {\n\t\treturn this.resolvers.get(namespace);\n\t}\n\n\t/** Number of registered resolvers. */\n\tget size(): number {\n\t\treturn this.resolvers.size;\n\t}\n\n\t/**\n\t * Check if a resolver is registered for the given namespace.\n\t */\n\thas(namespace: string): boolean {\n\t\treturn this.resolvers.has(namespace);\n\t}\n\n\t/**\n\t * Clear all resolvers (document switch, engine reset).\n\t * Calls destroy() on each resolver and clears the map.\n\t */\n\tclear(): void {\n\t\tfor (const resolver of this.resolvers.values()) {\n\t\t\tresolver.destroy();\n\t\t}\n\t\tthis.resolvers.clear();\n\t}\n}\n"]}

package/dist/chunk-XA4CKRML.cjs

@@ -1,316 +0,0 @@
-'use strict';
-
-// 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"
-};
-
-exports.DiagnosticEventType = DiagnosticEventType;
-exports.DiagnosticPipeline = DiagnosticPipeline;
-exports.TimelineDiagnosticCollector = TimelineDiagnosticCollector;
-//# sourceMappingURL=chunk-XA4CKRML.cjs.map
-//# sourceMappingURL=chunk-XA4CKRML.cjs.map

package/dist/chunk-XA4CKRML.cjs.map

@@ -1 +0,0 @@
-{"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-XA4CKRML.cjs","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, ColourData } 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 | ColourData | 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 | ColourData | 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}"]}