solve-engine 1.0.2 → 1.1.1

package/dist/chunk-GLA4JXBO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../package.json","../src/constants/version.ts","../src/constants/Configuration.ts"],"names":[],"mappings":"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","file":"chunk-GLA4JXBO.js","sourcesContent":["{\n  \"name\": \"solve-engine\",\n  \"version\": \"1.1.1\",\n  \"description\": \"An embeddable expression engine for natural-language calculations: units, currencies, percentages, dates and matrices, with the parsing and evaluation plumbing already built.\",\n  \"keywords\": [\n    \"expression-evaluator\",\n    \"calculator\",\n    \"bytecode-vm\",\n    \"parser\",\n    \"lexer\",\n    \"dsl\",\n    \"markdown\",\n    \"obsidian\"\n  ],\n  \"license\": \"MIT\",\n  \"author\": \"Liam Riddell\",\n  \"homepage\": \"https://liamriddell.github.io/solve-engine/\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/LiamRiddell/solve-engine.git\",\n    \"directory\": \"packages/engine\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/LiamRiddell/solve-engine/issues\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  },\n  \"type\": \"module\",\n  \"engines\": {\n    \"node\": \">=22\"\n  },\n  \"files\": [\n    \"dist\",\n    \"LICENSE\"\n  ],\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"import\": {\n        \"types\": \"./dist/index.d.ts\",\n        \"default\": \"./dist/index.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/index.d.cts\",\n        \"default\": \"./dist/index.cjs\"\n      }\n    },\n    \"./engine\": {\n      \"import\": {\n        \"types\": \"./dist/engine.d.ts\",\n        \"default\": \"./dist/engine.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/engine.d.cts\",\n        \"default\": \"./dist/engine.cjs\"\n      }\n    },\n    \"./vm\": {\n      \"import\": {\n        \"types\": \"./dist/vm.d.ts\",\n        \"default\": \"./dist/vm.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/vm.d.cts\",\n        \"default\": \"./dist/vm.cjs\"\n      }\n    },\n    \"./format\": {\n      \"import\": {\n        \"types\": \"./dist/format.d.ts\",\n        \"default\": \"./dist/format.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/format.d.cts\",\n        \"default\": \"./dist/format.cjs\"\n      }\n    },\n    \"./language\": {\n      \"import\": {\n        \"types\": \"./dist/language.d.ts\",\n        \"default\": \"./dist/language.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/language.d.cts\",\n        \"default\": \"./dist/language.cjs\"\n      }\n    },\n    \"./packages\": {\n      \"import\": {\n        \"types\": \"./dist/packages.d.ts\",\n        \"default\": \"./dist/packages.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/packages.d.cts\",\n        \"default\": \"./dist/packages.cjs\"\n      }\n    },\n    \"./constants\": {\n      \"import\": {\n        \"types\": \"./dist/constants.d.ts\",\n        \"default\": \"./dist/constants.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/constants.d.cts\",\n        \"default\": \"./dist/constants.cjs\"\n      }\n    },\n    \"./lexer\": {\n      \"import\": {\n        \"types\": \"./dist/lexer.d.ts\",\n        \"default\": \"./dist/lexer.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/lexer.d.cts\",\n        \"default\": \"./dist/lexer.cjs\"\n      }\n    },\n    \"./parser\": {\n      \"import\": {\n        \"types\": \"./dist/parser.d.ts\",\n        \"default\": \"./dist/parser.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/parser.d.cts\",\n        \"default\": \"./dist/parser.cjs\"\n      }\n    },\n    \"./normalizer\": {\n      \"import\": {\n        \"types\": \"./dist/normalizer.d.ts\",\n        \"default\": \"./dist/normalizer.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/normalizer.d.cts\",\n        \"default\": \"./dist/normalizer.cjs\"\n      }\n    },\n    \"./variables\": {\n      \"import\": {\n        \"types\": \"./dist/variables.d.ts\",\n        \"default\": \"./dist/variables.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/variables.d.cts\",\n        \"default\": \"./dist/variables.cjs\"\n      }\n    },\n    \"./resolvers\": {\n      \"import\": {\n        \"types\": \"./dist/resolvers.d.ts\",\n        \"default\": \"./dist/resolvers.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/resolvers.d.cts\",\n        \"default\": \"./dist/resolvers.cjs\"\n      }\n    },\n    \"./errors\": {\n      \"import\": {\n        \"types\": \"./dist/errors.d.ts\",\n        \"default\": \"./dist/errors.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/errors.d.cts\",\n        \"default\": \"./dist/errors.cjs\"\n      }\n    },\n    \"./utilities\": {\n      \"import\": {\n        \"types\": \"./dist/utilities.d.ts\",\n        \"default\": \"./dist/utilities.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/utilities.d.cts\",\n        \"default\": \"./dist/utilities.cjs\"\n      }\n    },\n    \"./uom\": {\n      \"import\": {\n        \"types\": \"./dist/uom.d.ts\",\n        \"default\": \"./dist/uom.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/uom.d.cts\",\n        \"default\": \"./dist/uom.cjs\"\n      }\n    },\n    \"./services\": {\n      \"import\": {\n        \"types\": \"./dist/services.d.ts\",\n        \"default\": \"./dist/services.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/services.d.cts\",\n        \"default\": \"./dist/services.cjs\"\n      }\n    },\n    \"./worker\": {\n      \"import\": {\n        \"types\": \"./dist/worker.d.ts\",\n        \"default\": \"./dist/worker.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/worker.d.cts\",\n        \"default\": \"./dist/worker.cjs\"\n      }\n    },\n    \"./testing\": {\n      \"import\": {\n        \"types\": \"./dist/testing.d.ts\",\n        \"default\": \"./dist/testing.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/testing.d.cts\",\n        \"default\": \"./dist/testing.cjs\"\n      }\n    }\n  },\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"prepublishOnly\": \"npm run build && node ../../scripts/assert-publishable.mjs .\",\n    \"dev\": \"tsup --watch\",\n    \"test\": \"jest --config jest.config.cjs --no-coverage\",\n    \"typecheck\": \"tsgo --noEmit --skipLibCheck\",\n    \"typecheck:tsc\": \"tsc --noEmit --skipLibCheck\"\n  },\n  \"dependencies\": {\n    \"@tanstack/query-core\": \"^5.100.10\"\n  },\n  \"devDependencies\": {\n    \"@jest/globals\": \"^30.4.1\",\n    \"@types/node\": \"^26.2.0\",\n    \"@types/semver\": \"^7.5.0\",\n    \"convert\": \"^7.0.0\",\n    \"jest\": \"^30.4.2\",\n    \"semver\": \"^7.6.0\",\n    \"ts-jest\": \"^29.4.12\",\n    \"tsup\": \"8.5.1\",\n    \"typescript\": \"5.9.3\"\n  },\n  \"//sideEffects\": \"Load-bearing claim, not boilerplate. tsup's splitting emits bare chunk imports at the top of dist/index.js, and this field tells Rollup, webpack and Vite they may delete them, which esbuild reports as [ignored-bare-import] once per import during `npm run size`. The engine does have module-level work to lose: registerAllTokenTypes(), _PrecedenceParser.BP_TABLE and its cached token ids, and several process-wide registries. It is safe because every chunk doing that work is also imported for its bindings somewhere, so no bundler can drop it. That is a property of how tsup currently splits the code rather than a design guarantee, so `npm run smoke:bundled` (scripts/check-tree-shaking.mjs) proves it on every run of `npm run verify` instead of assuming it, and its header explains the two fixes if it ever stops holding.\",\n  \"sideEffects\": false\n}\n","/**\n * The running engine's own semver version, sourced directly from this\n * package's package.json so it can never drift from what's actually\n * published. Exists so IEnginePackage.engineVersion range checks\n * (api/EngineVersionCompatibility.ts) have something real to check\n * against.\n */\nimport { version } from \"../../package.json\";\n\n/**\n * The running engine's version, taken from package.json.\n *\n * What a package's `engineVersion` range is checked against at registration.\n * A prerelease is compared by its coerced release version, so a 1.0.0 beta\n * satisfies `^1.0.0`. See `api/EngineVersionCompatibility.ts`.\n */\nexport const ENGINE_VERSION: string = version;\n","/**\n * Configuration Module for solve-js Engine\n * \n * This module provides the **single source of truth** for all engine configuration.\n * Every configurable aspect of the engine, from safety limits and performance\n * budgets to VM constraints and worker pool sizing, is defined here.\n * \n * ### Design principles\n * \n * 1. **Engine owns its config.** The engine defines its own config shape and defaults.\n *    Consumers (e.g., the Obsidian plugin) pass partial overrides; all unspecified\n *    fields fall back to `DEFAULT_CONFIG`.\n * \n * 2. **Self-documenting.** Every interface and field has descriptive JSDoc so the\n *    config is understandable at a glance, whether you're using the engine as an\n *    npm package or reading the source.\n * \n * 3. **Minimal consumer knowledge.** Consumers only need to pass `Partial<EngineConfig>`.\n *    They don't need to replicate the full config shape, just the fields they\n *    want to override.\n * \n * @module Configuration\n */\n\nimport { ErrorFactory } from \"@solve-js/errors/UnifiedErrorFramework\";\n\n/**\n * A host's test for whether a calendar date is a public holiday, given the\n * `Date` for that day at local midnight. Return `true` to exclude it from\n * working-day arithmetic.\n */\nexport type HolidayPredicate = (date: Date) => boolean;\n\n/**\n * The host-supplied public-holiday calendar, in the same \"bring your own data\"\n * shape the stocks and weather packages already use for a host callback (see\n * `packages/stocks/StocksPackage.ts`): weekends are decidable from the date\n * alone, holidays are not, so they come from the host or not at all.\n *\n * Either a {@link HolidayPredicate}, for a host that computes holidays itself\n * (an existing library, a region rule), or an iterable of specific dates as\n * `YYYY-MM-DD` strings, epoch-millisecond numbers or `Date` objects, for a host\n * that just has a list. Resolved to one internal predicate by\n * `vm/HolidayCalendar.ts`'s `resolveHolidayPredicate()`.\n *\n * Left unset, working-day arithmetic skips weekends only, which is the honest\n * default: the engine excludes exactly the days it can prove are non-working.\n */\nexport type HolidayCalendar = HolidayPredicate | Iterable<string | number | Date>;\n\n/**\n * Date-related configuration.\n * Controls the bounds and formatting for date/time expression evaluation\n * (e.g., `today + 20 days`, `last monday`).\n */\nexport interface DateConfig {\n  /**\n   * How far forward a date offset whose COST grows with the offset may reach,\n   * in years. Enforced by `vm/VM.ts`'s `addBusinessDays()`.\n   *\n   * Bounds the walk, not the calendar. Every other date offset in the engine\n   * is arithmetic on a Date field, so `today + 100000 days` costs exactly what\n   * one day costs and needs no ceiling; workdays are the one offset that has\n   * to step day by day, because which days are skipped depends on where each\n   * step lands. `today + 100000000 workdays` therefore froze the host for\n   * thirteen seconds inside a single ADD opcode (where `vm.maxInstructions`\n   * cannot see it) and then answered \"Invalid Date\", and a trillion never\n   * returned at all.\n   *\n   * Release hardening: this field was declared, documented as a \"safety\n   * limit\", and read nowhere, so it bounded nothing. A limit a host can\n   * configure and the engine ignores is worse than no limit, because it reads\n   * as protection that is not there.\n   */\n  readonly maxOffsetYears: number;\n  /** How far BACK the same walk may reach, in years, as a negative number. See {@link maxOffsetYears}. */\n  readonly minOffsetYears: number;\n  /** Default date string format for display (moment.js format string) */\n  readonly defaultFormat: string;\n  /**\n   * Public-holiday calendar for working-day arithmetic (`N working days after\n   * <date>`, `working days between <date> and <date>`, `<date> + N workdays`).\n   * See {@link HolidayCalendar}.\n   *\n   * Optional and unset by default: with no calendar, working-day arithmetic\n   * skips weekends only. A host that wants holidays excluded too supplies one\n   * here (`new ExpressionEngine(\"en\", false, { date: { holidays } })`), the\n   * same way stocks and weather take a host data source. Threaded into the VM\n   * by `engine/ExpressionEngine.ts` exactly as {@link maxOffsetYears} is,\n   * because working-day math is a VM operation several grammar forms share, so\n   * the calendar has to be one source the VM owns rather than per-package state\n   * the VM cannot see.\n   */\n  readonly holidays?: HolidayCalendar;\n}\n\n/**\n * Performance-related configuration.\n * Controls caching, timeouts, and processing limits to prevent runaway\n * resource consumption on large documents.\n */\nexport interface PerformanceConfig {\n  /**\n   * Maximum number of entries in {@link ExpressionEngine}'s bytecode cache\n   * (per-instance, keyed by expression text) before the oldest entry is\n   * evicted. Raise this for documents with many distinct expressions if\n   * repeated re-evaluation (e.g. scrolling) is re-parsing instead of\n   * hitting cache, bug fix (release hardening pass): this field used to\n   * be read nowhere; the cache size was a hardcoded, unconfigurable\n   * constant. Note this does NOT bound {@link LineCache}, which has no\n   * size limit of its own.\n   */\n  readonly defaultCacheSize: number;\n  /**\n   * Maximum lines a document may have for the engine to process it in one\n   * pass. Enforced by `ExpressionEngine.parseDocument()` and by\n   * `engine/DocumentModel.ts`'s `setDocument()`, the two entry points that\n   * take a whole document.\n   *\n   * A document costs memory per line whatever each line says: a parsed line\n   * record, a cache entry, a dependency-graph node. Two hundred thousand\n   * lines of `1 + 1` therefore exhausted the heap and aborted the process\n   * before any per-line limit had anything to object to, which is the same\n   * shape of hole as an unbounded expression and needs the same kind of\n   * ceiling. Refusing the document names the limit; a host that genuinely has\n   * a larger one raises this field.\n   *\n   * Release hardening: declared and read nowhere until now.\n   */\n  readonly maxDocumentLines: number;\n}\n\n/**\n * Validation / safety-limit configuration.\n * Protects against runaway expressions that could cause excessive memory use\n * or stack overflow. These limits are checked during lexing and parsing.\n */\n/** Bounds on untrusted input: expression length and nesting depth. */\nexport interface ValidationConfig {\n  /** Maximum expression length in characters. Prevents excessively long strings from entering the pipeline. */\n  readonly maxExpressionLength: number;\n  /** Maximum expression complexity score (`tokens + functionCalls×5 + nestingDepth×10`). Protects against deeply nested or combinatorially complex expressions. */\n  readonly maxComplexity: number;\n  /** Maximum parentheses nesting depth. Prevents stack overflow in the recursive-descent parser. */\n  readonly maxNestingDepth: number;\n  /**\n   * Auto-balance unmatched parentheses by appending missing closing parens\n   * or prepending missing opening parens. When disabled, unbalanced expressions\n   * cause parse errors instead of being silently corrected.\n   *\n   * Disabled by default for strict parsing. Enable for forgiving user input\n   * (e.g., chat-style calculators where users often omit closing parens).\n   * Has zero overhead when disabled, the O(n) paren-count scan is skipped.\n   */\n  readonly autoBalanceParens: boolean;\n}\n\n/**\n * Worker pool configuration.\n * Controls the parallel execution workers used for batch evaluation.\n */\nexport interface WorkerConfig {\n  /** Maximum number of concurrent Web Workers allowed */\n  readonly maxConcurrentWorkers: number;\n  /** Time (ms) a worker stays alive while idle before being terminated */\n  readonly idleTimeoutMs: number;\n  /** Maximum retry attempts for a failed worker operation */\n  readonly maxRetries: number;\n  /** Base backoff delay (ms) between retries (exponential backoff applied on top) */\n  readonly baseBackoffMs: number;\n}  /**\n   * Diagnostic / telemetry configuration.\n   * Controls the diagnostic event pipeline for profiling and debugging.\n   * All diagnostics are disabled by default for maximum production performance.\n   */\n  export interface DiagnosticConfig {\n    /** Master switch: enable the diagnostic pipeline (collectors receive events for all pipeline stages) */\n    readonly enabled: boolean;\n    /** Enable VM trace mode, emits per-opcode execution events (very verbose; disables some optimizations) */\n    readonly vmTraceEnabled: boolean;\n  }\n\n  /**\n   * Virtual Machine configuration.\n   * Controls the internal bytecode VM that executes compiled expressions.\n   */\n  export interface VMConfig {\n    /** Maximum stack depth (value slots) for VM execution, prevents stack overflow in recursive/pratt-parser generated bytecode */\n    readonly maxStackDepth: number;\n    /** Maximum opcodes executed per expression, halts runaway infinite loops */\n    readonly maxInstructions: number;\n    /**\n     * Maximum elements a collection may be expanded to before `map`/`reduce`/\n     * `sum`/`prod` will iterate it.\n     *\n     * A Range is stored as its two bounds and costs nothing until something\n     * materializes it, at which point it becomes one Value per element. Twenty\n     * characters (`sum(x, 1:100000000)`) therefore asked for a hundred million\n     * of them, and neither `maxInstructions` nor `maxStackDepth` could see it:\n     * the expansion happens inside a single opcode, so the instruction counter\n     * is never consulted while it runs, and the elements never reach the value\n     * stack. V8 aborted the whole process with \"Reached heap limit\", which a\n     * host embedding the engine cannot catch.\n     */\n    readonly maxCollectionSize: number;\n    /**\n     * Maximum elements (collection Values, matrix cells) one evaluation may\n     * materialize in total.\n     *\n     * `maxCollectionSize` above bounds a single collection. This bounds the sum\n     * of everything an expression asks for, which is a different question and\n     * the one that actually protects the host: two collections that are\n     * individually legal are legal together, and an operation whose result is\n     * the PRODUCT of two legal operands is bounded by neither of them. A matrix\n     * multiply is exactly that shape, so three lines within every other limit\n     * (`:a = map(1*x, 0:20000)`, `:b = transpose(a)`, `b * a`) asked for four\n     * hundred million cells and aborted the process.\n     *\n     * Counted in elements rather than bytes, because a count is what a call\n     * site has before it allocates. An element is 8 bytes as a numeric matrix\n     * cell and closer to a hundred as a full Value, so the default is worth\n     * roughly 16 MB of matrix or 200 MB of expanded collection: far past any\n     * document and far short of what an editor cannot survive.\n     */\n    readonly maxAllocatedElements: number;\n    /**\n     * Maximum user-defined-function calls one evaluation may make in TOTAL,\n     * however deeply or widely they nest.\n     *\n     * `maxFunctionRecursionDepth` bounds how DEEP calls nest and cannot see\n     * how MANY there are, and those are different numbers. Twenty-two lines of\n     * `f(n)(v) = f(n-1)(v) + f(n-1)(v)` reach a depth of only 22 against a\n     * limit of 50, and make 2,097,152 calls doing it: a fatal heap abort in\n     * under a second. `maxInstructions` cannot bound it either, because\n     * `executeBytecode()` re-enters itself per call and each reentrant call\n     * gets its OWN instruction count, so recursion refreshes its allowance on\n     * the way in. This is the tally that does not refresh; see\n     * `vm/AllocationBudget.ts`, which holds it for the same reason it holds\n     * the element tally.\n     *\n     * Counted in calls rather than in the instructions they run, because the\n     * call is the thing that multiplies: every call allocates a frame, its\n     * arguments and its result whatever its body says.\n     */\n    readonly maxFunctionCalls: number;\n    /**\n     * Hard ceiling on how many bisection steps goal seek (`solve line N for\n     * <var> = <target>`, see `packages/goalseek/`) may take before it gives up\n     * with a structured error rather than continuing.\n     *\n     * Goal seek re-evaluates the target line's expression once per step while\n     * narrowing an interval, and an untrusted document must never be able to\n     * make that loop spin. `maxInstructions` bounds each individual\n     * re-evaluation, but not how many of them the search performs, so this is\n     * the tally that bounds the search itself, the same reason `maxFunctionCalls`\n     * exists alongside `maxInstructions`. Bisection halves the interval every\n     * step, so a hundred steps resolves an input to roughly one part in 2^100:\n     * far past any precision a document needs, and a definite stop either way.\n     */\n    readonly maxGoalSeekIterations: number;\n  }\n\n/**\n * Complete engine configuration.\n *\n * Every field has a default in `DEFAULT_CONFIG`. To customize, pass a\n * `Partial<EngineConfig>` when constructing `ExpressionEngine`. Only the\n * sections/fields you supply are overridden; all others use their defaults.\n *\n * @example\n * ```typescript\n * import { ExpressionEngine } from \"solve-js\";\n *\n * const engine = new ExpressionEngine(\"en\", false, {\n *   validation: {\n *     maxExpressionLength: 1000,\n *     maxComplexity: 200,\n *   },\n *   // date, performance, vm, worker, diagnostic all use defaults\n * });\n * ```\n */\nexport interface EngineConfig {\n    /** Date/time expression evaluation bounds and formatting */\n    readonly date: DateConfig;\n    /** Performance budgets and cache sizing */\n    readonly performance: PerformanceConfig;\n    /** Safety limits for expression complexity */\n    readonly validation: ValidationConfig;\n    /** Internal bytecode VM configuration */\n    readonly vm: VMConfig;\n    /** Parallel worker pool configuration */\n    readonly worker: WorkerConfig;\n    /** Diagnostic pipeline configuration */\n    readonly diagnostic: DiagnosticConfig;\n  }\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONFIG: EngineConfig = {\n   date: {\n     // A century of workdays is about 26,000 steps, which is microseconds,\n     // and past any offset a person means. The walk is what these bound; see\n     // DateConfig above for why no other date offset needs a ceiling.\n     maxOffsetYears: 100,\n     minOffsetYears: -100,\n     defaultFormat: 'YYYY-MM-DD'\n   },\n   performance: {\n     // Preserves the effective cache size the hardcoded (now-removed)\n     // BYTECODE_CACHE_MAX_ENTRIES constant had, so wiring this field up\n     // doesn't silently shrink the default cache for existing consumers.\n     defaultCacheSize: 2000,\n     // Raised from the 10,000 this field was declared with, which was never\n     // enforced and turned out to be under what this engine already supports:\n     // its paging design is tested against a 20,000-line document\n     // (`engine/PageManager.ts` and its spec) and its throughput benchmark\n     // parses a 50,000-line one. Twice the largest of those, and the same\n     // number `ConfigManager.validate()` already refuses to go above.\n     //\n     // Measured under a 256MB heap: setting a 100,000-line document costs\n     // 64MB, evaluating every line of a 20,000-line one costs 106MB, and\n     // 200,000 lines aborts the process before a single expression is looked\n     // at. A host with a small heap should lower this; the ceiling is here to\n     // stop the size that cannot work anywhere.\n     maxDocumentLines: 100000,\n   },\n    validation: {\n      maxExpressionLength: 2000,\n      maxComplexity: 500,\n      maxNestingDepth: 50,\n      autoBalanceParens: false,\n    },\n    vm: {\n      maxStackDepth: 200,\n      maxInstructions: 50000,\n      // Two orders of magnitude above anything a person types by hand (the\n      // longest range in the test suite is 1000 elements) and small enough\n      // that expanding it is measured in milliseconds rather than in whether\n      // the host survives.\n      maxCollectionSize: 100000,\n      // Twenty times the single-collection ceiling above, so an expression may\n      // legitimately handle a number of large collections, and two hundred\n      // times below the allocation that took the process down.\n      maxAllocatedElements: 2000000,\n      // Six hundred times the largest call count any test or example makes\n      // (five levels of composition is sixteen calls), and small enough that\n      // the calls it does allow cost single-digit megabytes rather than the\n      // heap. A document that needs more than ten thousand calls on one line\n      // is doing something a calculator was not built for.\n      maxFunctionCalls: 10000,\n      // A hundred bisection steps resolve an input to one part in 2^100, far\n      // finer than any document needs and a firm stop for an untrusted one. A\n      // continuous, monotonic relationship converges in tens of steps, well\n      // under this; hitting it means the target is unreachable or the\n      // relationship is not the smooth one goal seek assumes.\n      maxGoalSeekIterations: 100,\n    },\n    worker: {\n      maxConcurrentWorkers: 4,\n      idleTimeoutMs: 30000,\n      maxRetries: 3,\n      baseBackoffMs: 1000,\n    },\n    diagnostic: {\n      enabled: false,\n      vmTraceEnabled: false,\n    },\n  };\n\n/**\n * Merge a partial config override onto a base `EngineConfig`, section by\n * section, `{ ...base.section, ...override.section }` for each of the 7\n * top-level sections, not a single top-level spread.\n *\n * A shallow `{ ...base, ...override }` at the TOP level replaces an entire\n * section wholesale the moment a caller overrides even one field in it\n * (e.g. `{ performance: { defaultCacheSize: 500 } }` would silently drop\n * every other `performance.*` field back to `undefined`, not to its\n * default). This function exists specifically so every config consumer\n * shares one correct merge instead of each hand-rolling (and risking) its\n * own. `ConfigManager` and `ExpressionEngine` both call this rather than\n * either duplicating the section list or instantiating a whole\n * `ConfigManager` just to reuse its private merge logic.\n */\nexport function mergeEngineConfig(\n  base: EngineConfig,\n  override: Partial<EngineConfig>\n): EngineConfig {\n  return {\n    date: { ...base.date, ...override.date },\n    performance: { ...base.performance, ...override.performance },\n    validation: { ...base.validation, ...override.validation },\n    vm: { ...base.vm, ...override.vm },\n    worker: { ...base.worker, ...override.worker },\n    diagnostic: { ...base.diagnostic, ...override.diagnostic },\n  };\n}\n\n/**\n * Configuration manager for engine settings\n *\n * @example\n * ```typescript\n * const configManager = new ConfigManager();\n * configManager.set('performance.defaultCacheSize', 2000);\n * const cacheSize = configManager.get('performance.defaultCacheSize');\n * ```\n */\nexport class ConfigManager {\n  private config: EngineConfig;\n\n  constructor(config: Partial<EngineConfig> = {}) {\n    this.config = mergeEngineConfig(DEFAULT_CONFIG, config);\n  }\n\n  /**\n   * Get configuration value by path\n   * \n   * @param path - Dot-notation path to config value\n   * @returns Configuration value\n   */\n  get<T>(path: string): T {\n    const keys = path.split('.');\n    let current: unknown = this.config;\n\n    for (const key of keys) {\n      if (current && typeof current === 'object' && key in current) {\n        current = (current as Record<string, unknown>)[key];\n      } else {\n        throw ErrorFactory.config(\n          \"CONFIG_PATH_NOT_FOUND\",\n          `Configuration path not found: ${path}`,\n          { path }\n        );\n      }\n    }\n\n    return current as T;\n  }\n\n  /**\n   * Set configuration value by path\n   * \n   * @param path - Dot-notation path to config value\n   * @param value - New value\n   */\n  set<T>(path: string, value: T): void {\n    const keys = path.split('.');\n    if (keys.length < 2) {\n      throw ErrorFactory.config(\n        \"INVALID_CONFIG_PATH\",\n        `Invalid path: ${path}. Must be in format 'section.property'`,\n        { path }\n      );\n    }\n    \n    const section = keys[0];\n    const property = keys[1];\n    \n    if (!(section in this.config)) {\n      throw ErrorFactory.config(\n        \"CONFIG_SECTION_NOT_FOUND\",\n        `Configuration section not found: ${section}`,\n        { section, path }\n      );\n    }\n    \n    const sectionConfig = this.config[section as keyof EngineConfig];\n    if (sectionConfig && typeof sectionConfig === 'object') {\n      (sectionConfig as unknown as Record<string, unknown>)[property] = value;\n    } else {\n      throw ErrorFactory.config(\n        \"CONFIG_PROPERTY_NOT_FOUND\",\n        `Configuration property not found: ${path}`,\n        { path }\n      );\n    }\n  }\n\n  /**\n   * Get complete configuration.\n   *\n   * A detached copy, section objects included. A top-level spread would hand\n   * the caller this manager's own section objects, so `getConfig().vm.x = 1`\n   * would be an undeclared back door into {@link set}, bypassing its path\n   * validation and reaching every later {@link get}.\n   */\n  getConfig(): EngineConfig {\n    return mergeEngineConfig(this.config, {});\n  }\n\n  /**\n   * Update multiple configuration values\n   */\n  update(config: Partial<EngineConfig>): void {\n    this.config = mergeEngineConfig(this.config, config);\n  }\n\n  /**\n   * Reset to default configuration.\n   *\n   * Goes through {@link mergeEngineConfig} for the same reason the constructor\n   * does. A top-level `{ ...DEFAULT_CONFIG }` copies the six section\n   * references, not the sections, so after a reset this manager's\n   * `performance` object WAS `DEFAULT_CONFIG.performance` and the next\n   * `set('performance.x', ...)` wrote into the module constant. That constant\n   * is what every `ExpressionEngine` is built from, so one manager's reset\n   * could change the cache size, instruction ceiling or allocation budget of\n   * every engine constructed later in the process.\n   */\n  reset(): void {\n    this.config = mergeEngineConfig(DEFAULT_CONFIG, {});\n  }\n\n  /**\n   * Validate configuration values\n   */\n  validate(): ValidationResult {\n    const errors: string[] = [];\n\n    // Validate performance config\n    if (this.config.performance.maxDocumentLines > 100000) {\n      errors.push('maxDocumentLines cannot exceed 100,000');\n    }\n\n    // Validate date config\n    if (this.config.date.maxOffsetYears > 1000) {\n      errors.push('maxOffsetYears cannot exceed 1000');\n    }\n\n    return {\n      valid: errors.length === 0,\n      error: errors.join('; '),\n      warnings: []\n    };\n  }\n}\n\n/**\n * Result type for {@link ConfigManager.validate}.\n */\nexport interface ValidationResult {\n  valid: boolean;\n  error?: string;\n  warnings?: string[];\n}\n\n"]}

package/dist/{chunk-UM6BVY2S.cjs → chunk-HIQ5HSZL.cjs}

@@ -1,7 +1,125 @@
 'use strict';
 
-var chunkJMXUNXQS_cjs = require('./chunk-JMXUNXQS.cjs');
-var chunk5KMIY374_cjs = require('./chunk-5KMIY374.cjs');
+var chunk2TZKENDH_cjs = require('./chunk-2TZKENDH.cjs');
+var chunkB4HBEFTB_cjs = require('./chunk-B4HBEFTB.cjs');
+
+// src/decimal/Decimal.ts
+var DEFAULT_DIVISION_SCALE = 20;
+var POW10 = [1n];
+function pow10(n) {
+  if (n < 0) {
+    throw chunkB4HBEFTB_cjs.ErrorFactory.internal("DECIMAL_NEGATIVE_POWER", `pow10 needs a non-negative exponent, got ${n}`, { exponent: n });
+  }
+  for (let i = POW10.length; i <= n; i++) POW10[i] = POW10[i - 1] * 10n;
+  return POW10[n];
+}
+function decimalFromInteger(n) {
+  return { coef: typeof n === "bigint" ? n : BigInt(n), scale: 0 };
+}
+function decimalFromNumberIfExact(n) {
+  if (!Number.isFinite(n) || !Number.isInteger(n)) return null;
+  return decimalFromInteger(BigInt(n));
+}
+function decimalFromLiteral(text) {
+  let s = text;
+  let negative = false;
+  if (s.startsWith("-")) {
+    negative = true;
+    s = s.slice(1);
+  } else if (s.startsWith("+")) {
+    s = s.slice(1);
+  }
+  const dot = s.indexOf(".");
+  const intPart = dot < 0 ? s : s.slice(0, dot);
+  const fracPart = dot < 0 ? "" : s.slice(dot + 1);
+  const digits = intPart + fracPart || "0";
+  if (!/^[0-9]+$/.test(digits)) {
+    throw chunkB4HBEFTB_cjs.ErrorFactory.parsing("INVALID_DECIMAL_LITERAL", `Not a decimal literal: "${text}"`, { raw: text });
+  }
+  let coef = BigInt(digits);
+  if (negative) coef = -coef;
+  return { coef, scale: fracPart.length };
+}
+function align(a, b) {
+  if (a.scale === b.scale) return { ca: a.coef, cb: b.coef, scale: a.scale };
+  if (a.scale > b.scale) return { ca: a.coef, cb: b.coef * pow10(a.scale - b.scale), scale: a.scale };
+  return { ca: a.coef * pow10(b.scale - a.scale), cb: b.coef, scale: b.scale };
+}
+function decimalAdd(a, b) {
+  const { ca, cb, scale } = align(a, b);
+  return { coef: ca + cb, scale };
+}
+function decimalSubtract(a, b) {
+  const { ca, cb, scale } = align(a, b);
+  return { coef: ca - cb, scale };
+}
+function decimalMultiply(a, b) {
+  return { coef: a.coef * b.coef, scale: a.scale + b.scale };
+}
+function decimalNegate(a) {
+  return { coef: -a.coef, scale: a.scale };
+}
+function decimalIsZero(a) {
+  return a.coef === 0n;
+}
+function roundCoefToScale(coef, scale, targetScale) {
+  if (targetScale >= scale) return coef * pow10(targetScale - scale);
+  const divisor = pow10(scale - targetScale);
+  const negative = coef < 0n;
+  const magnitude = negative ? -coef : coef;
+  let q = magnitude / divisor;
+  const r = magnitude % divisor;
+  if (r * 2n >= divisor) q += 1n;
+  return negative ? -q : q;
+}
+function decimalRound(a, targetScale) {
+  return { coef: roundCoefToScale(a.coef, a.scale, targetScale), scale: targetScale };
+}
+function decimalDivide(a, b, maxFractionDigits = DEFAULT_DIVISION_SCALE) {
+  if (decimalIsZero(b)) {
+    throw chunkB4HBEFTB_cjs.ErrorFactory.internal("DECIMAL_DIVISION_BY_ZERO", "decimalDivide was called with a zero divisor", {});
+  }
+  const s = maxFractionDigits;
+  const numerator = a.coef * pow10(s + b.scale);
+  const denominator = b.coef * pow10(a.scale);
+  const negative = numerator < 0n !== denominator < 0n;
+  const num = numerator < 0n ? -numerator : numerator;
+  const den = denominator < 0n ? -denominator : denominator;
+  let q = num / den;
+  const r = num % den;
+  if (r * 2n >= den) q += 1n;
+  return { coef: negative ? -q : q, scale: s };
+}
+function decimalCompare(a, b) {
+  const { ca, cb } = align(a, b);
+  if (ca < cb) return -1;
+  if (ca > cb) return 1;
+  return 0;
+}
+function decimalToString(a) {
+  const negative = a.coef < 0n;
+  let digits = (negative ? -a.coef : a.coef).toString();
+  if (a.scale === 0) return negative ? `-${digits}` : digits;
+  if (digits.length <= a.scale) digits = digits.padStart(a.scale + 1, "0");
+  const cut = digits.length - a.scale;
+  const whole = digits.slice(0, cut);
+  const frac = digits.slice(cut);
+  return `${negative ? "-" : ""}${whole}.${frac}`;
+}
+function decimalToNumber(a) {
+  return Number(decimalToString(a));
+}
+function decimalToFixed(a, fractionDigits) {
+  const rounded = decimalRound(a, fractionDigits);
+  const negative = rounded.coef < 0n && rounded.coef !== 0n;
+  let digits = (rounded.coef < 0n ? -rounded.coef : rounded.coef).toString();
+  if (fractionDigits === 0) return negative ? `-${digits}` : digits;
+  if (digits.length <= fractionDigits) digits = digits.padStart(fractionDigits + 1, "0");
+  const cut = digits.length - fractionDigits;
+  const whole = digits.slice(0, cut);
+  const frac = digits.slice(cut);
+  return `${negative ? "-" : ""}${whole}.${frac}`;
+}
 
 // src/symbolic/Rational.ts
 var RATIONAL_ZERO = { n: 0n, d: 1n };
@@ -33,7 +151,7 @@ function gcd(a, b) {
 function guardMagnitude(n, d) {
   const magnitude = n < 0n ? -n : n;
   if (magnitude >= MAX_MAGNITUDE || d >= MAX_MAGNITUDE) {
-    throw chunk5KMIY374_cjs.ErrorFactory.execution(
+    throw chunkB4HBEFTB_cjs.ErrorFactory.execution(
       "SYMBOLIC_RATIONAL_OVERFLOW",
       `This calculation produced a fraction too large to represent exactly (over ${RATIONAL_MAX_BITS} bits).`,
       { limitBits: RATIONAL_MAX_BITS }
@@ -42,7 +160,7 @@ function guardMagnitude(n, d) {
 }
 function normalize(n, d) {
   if (d === 0n) {
-    throw chunk5KMIY374_cjs.ErrorFactory.execution("SYMBOLIC_DIVISION_BY_ZERO", "Division by zero in a symbolic expression.");
+    throw chunkB4HBEFTB_cjs.ErrorFactory.execution("SYMBOLIC_DIVISION_BY_ZERO", "Division by zero in a symbolic expression.");
   }
   if (n === 0n) return RATIONAL_ZERO;
   let numerator = d < 0n ? -n : n;
@@ -59,7 +177,7 @@ function rational(numerator, denominator = 1n) {
 var DECIMAL_FORM = /^(-?)(\d+)(?:\.(\d+))?(?:[eE]([+-]?\d+))?$/;
 function rationalFromNumber(value) {
   if (!Number.isFinite(value)) {
-    throw chunk5KMIY374_cjs.ErrorFactory.execution(
+    throw chunkB4HBEFTB_cjs.ErrorFactory.execution(
       "SYMBOLIC_NONFINITE_OPERAND",
       `"${String(value)}" has no exact value, so it cannot appear in a symbolic expression.`,
       { value: String(value) }
@@ -68,7 +186,7 @@ function rationalFromNumber(value) {
   if (Number.isInteger(value)) return normalize(BigInt(value), 1n);
   const parts = DECIMAL_FORM.exec(String(value));
   if (parts === null) {
-    throw chunk5KMIY374_cjs.ErrorFactory.internal(
+    throw chunkB4HBEFTB_cjs.ErrorFactory.internal(
       "INTERNAL_RATIONAL_PARSE",
       `Internal error: could not read "${String(value)}" as a decimal number.`,
       { value: String(value) }
@@ -100,7 +218,7 @@ function rationalMul(a, b) {
 }
 function rationalDiv(a, b) {
   if (b.n === 0n) {
-    throw chunk5KMIY374_cjs.ErrorFactory.execution("SYMBOLIC_DIVISION_BY_ZERO", "Division by zero in a symbolic expression.");
+    throw chunkB4HBEFTB_cjs.ErrorFactory.execution("SYMBOLIC_DIVISION_BY_ZERO", "Division by zero in a symbolic expression.");
   }
   return normalize(a.n * b.d, a.d * b.n);
 }
@@ -111,7 +229,7 @@ function rationalPow(base, exponent) {
   if (exponent === 0n) return RATIONAL_ONE;
   if (exponent < 0n) {
     if (base.n === 0n) {
-      throw chunk5KMIY374_cjs.ErrorFactory.execution("SYMBOLIC_DIVISION_BY_ZERO", "Zero raised to a negative power is undefined.");
+      throw chunkB4HBEFTB_cjs.ErrorFactory.execution("SYMBOLIC_DIVISION_BY_ZERO", "Zero raised to a negative power is undefined.");
     }
     const positive = -exponent;
     return normalize(bigintPow(base.d, positive), bigintPow(base.n, positive));
@@ -191,7 +309,7 @@ function complexMul(a, b) {
 }
 function complexDiv(a, b) {
   if (isComplexZero(b)) {
-    throw chunk5KMIY374_cjs.ErrorFactory.execution("SYMBOLIC_DIVISION_BY_ZERO", "Division by zero in a complex expression.");
+    throw chunkB4HBEFTB_cjs.ErrorFactory.execution("SYMBOLIC_DIVISION_BY_ZERO", "Division by zero in a complex expression.");
   }
   const denominator = rationalAdd(rationalMul(b.re, b.re), rationalMul(b.im, b.im));
   return {
@@ -212,7 +330,7 @@ function complexPow(base, exponent) {
   if (exponent === 0n) return COMPLEX_ONE;
   if (exponent < 0n) {
     if (isComplexZero(base)) {
-      throw chunk5KMIY374_cjs.ErrorFactory.execution("SYMBOLIC_DIVISION_BY_ZERO", "Zero raised to a negative power is undefined.");
+      throw chunkB4HBEFTB_cjs.ErrorFactory.execution("SYMBOLIC_DIVISION_BY_ZERO", "Zero raised to a negative power is undefined.");
     }
     return complexDiv(COMPLEX_ONE, complexPow(base, -exponent));
   }
@@ -925,7 +1043,7 @@ function foldCall(name, args) {
 }
 function simplifySymbolic(node) {
   if (nodeCount(node, SYMBOLIC_MAX_NODES) > SYMBOLIC_MAX_NODES) {
-    throw chunk5KMIY374_cjs.ErrorFactory.execution(
+    throw chunkB4HBEFTB_cjs.ErrorFactory.execution(
       "SYMBOLIC_NODE_LIMIT_EXCEEDED",
       `This symbolic expression is too large to simplify (over ${SYMBOLIC_MAX_NODES} terms).`,
       { limit: SYMBOLIC_MAX_NODES }
@@ -1277,9 +1395,9 @@ function symbolicToEntry(node) {
   return simplified.kind === "const" ? rationalToNumber(simplified.value) : simplified;
 }
 function matrixEntryToValue(cell) {
-  if (typeof cell === "boolean") return chunkJMXUNXQS_cjs.boolValue(cell);
-  if (typeof cell === "object" && cell !== null) return chunkJMXUNXQS_cjs.symbolicValue(cell);
-  return chunkJMXUNXQS_cjs.numberValue(cell);
+  if (typeof cell === "boolean") return chunk2TZKENDH_cjs.boolValue(cell);
+  if (typeof cell === "object" && cell !== null) return chunk2TZKENDH_cjs.symbolicValue(cell);
+  return chunk2TZKENDH_cjs.numberValue(cell);
 }
 function rowMajorToColumnMajor(rows, cols, rowMajorData) {
   const data = new Array(rows * cols);
@@ -1308,21 +1426,21 @@ function matrixMultiply(l, r) {
     if (useSymbolic) {
       const scalarNode = entryToSymbolic(scalarOperand.data[0]);
       const result2 = matrixOperand.data.map((v) => symbolicToEntry(simplifySymbolic({ kind: "mul", left: entryToSymbolic(v), right: scalarNode })));
-      return chunkJMXUNXQS_cjs.matrixValue(matrixOperand.rows, matrixOperand.cols, result2);
+      return chunk2TZKENDH_cjs.matrixValue(matrixOperand.rows, matrixOperand.cols, result2);
     }
     const scalar = scalarOperand.data[0];
     const result = matrixOperand.data.map((v) => v * scalar);
-    return chunkJMXUNXQS_cjs.matrixValue(matrixOperand.rows, matrixOperand.cols, result);
+    return chunk2TZKENDH_cjs.matrixValue(matrixOperand.rows, matrixOperand.cols, result);
   }
   if (l.cols !== r.rows) {
-    return chunkJMXUNXQS_cjs.errorValue(
+    return chunk2TZKENDH_cjs.errorValue(
       "DIMENSION_MISMATCH",
       `Cannot multiply a ${l.rows}x${l.cols} matrix by a ${r.rows}x${r.cols} matrix \u2014 inner dimensions must match (${l.cols} !== ${r.rows}).`
     );
   }
   const resultRows = l.rows;
   const resultCols = r.cols;
-  const data = chunkJMXUNXQS_cjs.checkedArray(resultRows * resultCols, "matrix cells");
+  const data = chunk2TZKENDH_cjs.checkedArray(resultRows * resultCols, "matrix cells");
   for (let row = 0; row < resultRows; row++) {
     for (let col = 0; col < resultCols; col++) {
       if (useSymbolic) {
@@ -1341,14 +1459,14 @@ function matrixMultiply(l, r) {
       }
     }
   }
-  return chunkJMXUNXQS_cjs.matrixValue(resultRows, resultCols, data);
+  return chunk2TZKENDH_cjs.matrixValue(resultRows, resultCols, data);
 }
 function matrixPower(m, exponent) {
   if (!isSquare(m)) {
-    return chunkJMXUNXQS_cjs.errorValue("MATRIX_POWER_REQUIRES_SQUARE_MATRIX", `^: only a square matrix can be raised to a power (got ${m.rows}x${m.cols}).`);
+    return chunk2TZKENDH_cjs.errorValue("MATRIX_POWER_REQUIRES_SQUARE_MATRIX", `^: only a square matrix can be raised to a power (got ${m.rows}x${m.cols}).`);
   }
   if (!Number.isInteger(exponent) || exponent < 0) {
-    return chunkJMXUNXQS_cjs.errorValue(
+    return chunk2TZKENDH_cjs.errorValue(
       "MATRIX_POWER_REQUIRES_WHOLE_EXPONENT",
       `^: a matrix can only be raised to a whole number of 0 or more (got ${exponent}); "^-1" means the inverse and "^T" the transpose.`
     );
@@ -1372,18 +1490,18 @@ function matrixPower(m, exponent) {
       squared = doubled.value;
     }
   }
-  return chunkJMXUNXQS_cjs.matrixValue(accumulated.rows, accumulated.cols, accumulated.data);
+  return chunk2TZKENDH_cjs.matrixValue(accumulated.rows, accumulated.cols, accumulated.data);
 }
 function matrixCompare(l, r, cmp) {
   if (!sameShape(l, r)) {
-    return chunkJMXUNXQS_cjs.errorValue(
+    return chunk2TZKENDH_cjs.errorValue(
       "DIMENSION_MISMATCH",
       `Cannot compare matrices of different shapes: ${l.rows}x${l.cols} and ${r.rows}x${r.cols}`
     );
   }
   const data = new Array(l.data.length);
   for (let i = 0; i < l.data.length; i++) data[i] = cmp(l.data[i], r.data[i]);
-  return chunkJMXUNXQS_cjs.matrixValue(l.rows, l.cols, data);
+  return chunk2TZKENDH_cjs.matrixValue(l.rows, l.cols, data);
 }
 function transpose(m) {
   const data = new Array(m.rows * m.cols);
@@ -1392,7 +1510,7 @@ function transpose(m) {
       data[r + c * m.cols] = matAt(m, c, r);
     }
   }
-  return chunkJMXUNXQS_cjs.matrixValue(m.cols, m.rows, data);
+  return chunk2TZKENDH_cjs.matrixValue(m.cols, m.rows, data);
 }
 function toWorkingRows(m) {
   const rows = [];
@@ -1448,7 +1566,7 @@ function integerDeterminant(rows) {
 }
 function numericDeterminant(m) {
   const integers = toIntegerRows(m);
-  if (integers !== null) return chunkJMXUNXQS_cjs.numberValue(Number(integerDeterminant(integers)));
+  if (integers !== null) return chunk2TZKENDH_cjs.numberValue(Number(integerDeterminant(integers)));
   const n = m.rows;
   const a = toWorkingRows(m);
   let det = 1;
@@ -1461,7 +1579,7 @@ function numericDeterminant(m) {
         pivotRow = r;
       }
     }
-    if (maxAbs === 0) return chunkJMXUNXQS_cjs.numberValue(0);
+    if (maxAbs === 0) return chunk2TZKENDH_cjs.numberValue(0);
     if (pivotRow !== col) {
       const tmp = a[col];
       a[col] = a[pivotRow];
@@ -1475,7 +1593,7 @@ function numericDeterminant(m) {
       for (let c = col; c < n; c++) a[r][c] -= factor * a[col][c];
     }
   }
-  return chunkJMXUNXQS_cjs.numberValue(det);
+  return chunk2TZKENDH_cjs.numberValue(det);
 }
 function symbolicDeterminant(m) {
   const n = m.rows;
@@ -1488,7 +1606,7 @@ function symbolicDeterminant(m) {
   let det = constNode(1);
   for (let col = 0; col < n; col++) {
     const pivot = simplifySymbolic(a[col][col]);
-    if (pivot.kind === "const" && isRationalZero(pivot.value)) return chunkJMXUNXQS_cjs.numberValue(0);
+    if (pivot.kind === "const" && isRationalZero(pivot.value)) return chunk2TZKENDH_cjs.numberValue(0);
     det = simplifySymbolic({ kind: "mul", left: det, right: pivot });
     for (let r = col + 1; r < n; r++) {
       const factor = simplifySymbolic({ kind: "div", left: a[r][col], right: pivot });
@@ -1497,11 +1615,11 @@ function symbolicDeterminant(m) {
       }
     }
   }
-  return det.kind === "const" ? chunkJMXUNXQS_cjs.numberValue(rationalToNumber(det.value)) : chunkJMXUNXQS_cjs.symbolicValue(det);
+  return det.kind === "const" ? chunk2TZKENDH_cjs.numberValue(rationalToNumber(det.value)) : chunk2TZKENDH_cjs.symbolicValue(det);
 }
 function determinant(m) {
   if (!isSquare(m)) {
-    return chunkJMXUNXQS_cjs.errorValue("DETERMINANT_REQUIRES_SQUARE_MATRIX", `det: matrix must be square (got ${m.rows}x${m.cols}).`);
+    return chunk2TZKENDH_cjs.errorValue("DETERMINANT_REQUIRES_SQUARE_MATRIX", `det: matrix must be square (got ${m.rows}x${m.cols}).`);
   }
   return m.hasSymbolic ? symbolicDeterminant(m) : numericDeterminant(m);
 }
@@ -1521,7 +1639,7 @@ function numericInverse(m) {
       }
     }
     if (maxAbs < 1e-10) {
-      return chunkJMXUNXQS_cjs.errorValue("SINGULAR_MATRIX", `inv: a ${n}x${n} matrix with a zero (or near-zero) pivot column is not invertible.`);
+      return chunk2TZKENDH_cjs.errorValue("SINGULAR_MATRIX", `inv: a ${n}x${n} matrix with a zero (or near-zero) pivot column is not invertible.`);
     }
     if (pivotRow !== col) {
       const tmp = a[col];
@@ -1541,13 +1659,13 @@ function numericInverse(m) {
   for (let r = 0; r < n; r++) {
     for (let c = 0; c < n; c++) data[r + c * n] = a[r][n + c];
   }
-  return chunkJMXUNXQS_cjs.matrixValue(n, n, data);
+  return chunk2TZKENDH_cjs.matrixValue(n, n, data);
 }
 var SYMBOLIC_INVERSE_DIMENSION_LIMIT = 9;
 function symbolicInverse(m) {
   const n = m.rows;
   if (n >= SYMBOLIC_INVERSE_DIMENSION_LIMIT) {
-    return chunkJMXUNXQS_cjs.errorValue(
+    return chunk2TZKENDH_cjs.errorValue(
       "SYMBOLIC_INVERSE_DIMENSION_LIMIT",
       `Symbolic matrix inversion is limited to matrices smaller than ${SYMBOLIC_INVERSE_DIMENSION_LIMIT}x${SYMBOLIC_INVERSE_DIMENSION_LIMIT} (got ${n}x${n}).`
     );
@@ -1562,7 +1680,7 @@ function symbolicInverse(m) {
   for (let col = 0; col < n; col++) {
     const pivot = simplifySymbolic(a[col][col]);
     if (pivot.kind === "const" && isRationalZero(pivot.value)) {
-      return chunkJMXUNXQS_cjs.errorValue(
+      return chunk2TZKENDH_cjs.errorValue(
         "SYMBOLIC_SINGULAR_OR_UNSUPPORTED_PIVOT",
         `Symbolic inverse: the pivot at row/col ${col} is exactly zero \u2014 this matrix's structure isn't invertible via this engine's diagonal-first symbolic elimination (no row-swapping); try reordering rows manually.`
       );
@@ -1583,22 +1701,22 @@ function symbolicInverse(m) {
   for (let r = 0; r < n; r++) {
     for (let c = 0; c < n; c++) data[r + c * n] = symbolicToEntry(a[r][n + c]);
   }
-  return chunkJMXUNXQS_cjs.matrixValue(n, n, data);
+  return chunk2TZKENDH_cjs.matrixValue(n, n, data);
 }
 function inverse(m) {
   if (!isSquare(m)) {
-    return chunkJMXUNXQS_cjs.errorValue("INVERSE_REQUIRES_SQUARE_MATRIX", `inv: matrix must be square (got ${m.rows}x${m.cols}).`);
+    return chunk2TZKENDH_cjs.errorValue("INVERSE_REQUIRES_SQUARE_MATRIX", `inv: matrix must be square (got ${m.rows}x${m.cols}).`);
   }
   return m.hasSymbolic ? symbolicInverse(m) : numericInverse(m);
 }
 function tooLarge(length, maxElements) {
-  return chunkJMXUNXQS_cjs.errorValue(
+  return chunk2TZKENDH_cjs.errorValue(
     "COLLECTION_TOO_LARGE",
     `This collection has ${length} elements, past the limit of ${maxElements} (see the engine's vm.maxCollectionSize setting).`
   );
 }
 function collectionToValues(v, maxElements = Number.POSITIVE_INFINITY) {
-  const faulted = chunkJMXUNXQS_cjs.faultedOperand(v);
+  const faulted = chunk2TZKENDH_cjs.faultedOperand(v);
   if (faulted) return faulted;
   if (v.type === 7 /* Matrix */) {
     const m = v.value;
@@ -1610,10 +1728,10 @@ function collectionToValues(v, maxElements = Number.POSITIVE_INFINITY) {
     const length = r.max - r.min + 1;
     if (length > maxElements) return tooLarge(length, maxElements);
     const out = new Array(length);
-    for (let i = 0; i < length; i++) out[i] = chunkJMXUNXQS_cjs.numberValue(r.min + i);
+    for (let i = 0; i < length; i++) out[i] = chunk2TZKENDH_cjs.numberValue(r.min + i);
     return out;
   }
-  return chunkJMXUNXQS_cjs.errorValue(
+  return chunk2TZKENDH_cjs.errorValue(
     "MAP_REDUCE_REQUIRES_COLLECTION",
     `map/reduce requires a Matrix or Range collection (e.g. "[1,2,3]" or "0:3").`
   );
@@ -1740,6 +1858,19 @@ exports.compareMonomials = compareMonomials;
 exports.complex = complex;
 exports.complexNode = complexNode;
 exports.constNode = constNode;
+exports.decimalAdd = decimalAdd;
+exports.decimalCompare = decimalCompare;
+exports.decimalDivide = decimalDivide;
+exports.decimalFromInteger = decimalFromInteger;
+exports.decimalFromLiteral = decimalFromLiteral;
+exports.decimalFromNumberIfExact = decimalFromNumberIfExact;
+exports.decimalIsZero = decimalIsZero;
+exports.decimalMultiply = decimalMultiply;
+exports.decimalNegate = decimalNegate;
+exports.decimalRound = decimalRound;
+exports.decimalSubtract = decimalSubtract;
+exports.decimalToFixed = decimalToFixed;
+exports.decimalToNumber = decimalToNumber;
 exports.determinant = determinant;
 exports.exactIntegerCbrt = exactIntegerCbrt;
 exports.exactIntegerSqrt = exactIntegerSqrt;
@@ -1766,6 +1897,7 @@ exports.polyDegree = polyDegree;
 exports.polyUnivariateVar = polyUnivariateVar;
 exports.polynomialDivide = polynomialDivide;
 exports.powNode = powNode;
+exports.rational = rational;
 exports.rationalAdd = rationalAdd;
 exports.rationalCompare = rationalCompare;
 exports.rationalDiv = rationalDiv;
@@ -1787,5 +1919,5 @@ exports.symbolicToEntry = symbolicToEntry;
 exports.toPolynomial = toPolynomial;
 exports.transpose = transpose;
 exports.varNode = varNode;
-//# sourceMappingURL=chunk-UM6BVY2S.cjs.map
-//# sourceMappingURL=chunk-UM6BVY2S.cjs.map
+//# sourceMappingURL=chunk-HIQ5HSZL.cjs.map
+//# sourceMappingURL=chunk-HIQ5HSZL.cjs.map