solve-engine 1.1.1 → 2.0.0

package/dist/index.d.cts

@@ -1,20 +1,19 @@
-import { I as IEnginePackage } from './PackageRegistry-BHWJP83F.cjs';
-export { a as EngineRestoreOptions, b as EngineSnapshot, c as EvalResults, d as Explanation, e as ExplanationStep, E as ExpressionEngine, f as IPackageRegistry, L as LineEvaluation, P as PackageRegistry, S as SNAPSHOT_FORMAT, g as SNAPSHOT_VERSION, h as SerializedAnonymousBody, i as SerializedBytecode, j as SerializedDecimal, k as SerializedLineCacheEntry, l as SerializedNumber, m as SerializedRational, n as SerializedUserFunction, o as SerializedValue, p as SnapshotErrorCodes, q as packageRegistry } from './PackageRegistry-BHWJP83F.cjs';
-export { a as CompatibilityConflict, b as CompatibilityConflictKind, C as CompatibilityReport, c as CompatibilitySeverity, d as checkPackageCompatibility } from './PackageCompatibility-B-7rK1TD.cjs';
+import { I as IEnginePackage, a as EngineOptions, E as ExpressionEngine } from './PackageRegistry-dpdurBVO.cjs';
+export { b as EngineRestoreOptions, c as EngineSnapshot, d as Explanation, e as ExplanationStep, S as SNAPSHOT_FORMAT, f as SNAPSHOT_VERSION, g as SerializedAnonymousBody, h as SerializedBytecode, i as SerializedDecimal, j as SerializedLineCacheEntry, k as SerializedNumber, l as SerializedRational, m as SerializedUserFunction, n as SerializedValue, o as SnapshotErrorCodes } from './PackageRegistry-dpdurBVO.cjs';
+export { a as CompatibilityConflict, b as CompatibilityConflictKind, C as CompatibilityReport, c as CompatibilitySeverity, d as checkPackageCompatibility } from './PackageCompatibility-Bn5jnBtA.cjs';
+export { E as EngineConfigOverride } from './Configuration-B6W0-T67.cjs';
 export { ENGINE_VERSION } from './constants.cjs';
-import './Parselet-BHcgK9S7.cjs';
-import './BytecodeBuilder-Bp9xeTmX.cjs';
-import './Token-B1hdkedD.cjs';
-import './pipeline-CtfJtPQc.cjs';
-import './Value-BUi1RA3S.cjs';
-import './variables.cjs';
-import './Lexer-BOs7euZe.cjs';
+import './Parselet-C4Wu055_.cjs';
+import './BytecodeBuilder-DGGeByAP.cjs';
+import './Token-CbP_OutD.cjs';
+import './pipeline-DCQicwWX.cjs';
+import './Value-CCi_Eecs.cjs';
+import './Lexer-B4C1qHXu.cjs';
 import './resolvers.cjs';
 import '@tanstack/query-core';
-import './TokenNormalizer-DRc1Js1V.cjs';
-import './ScopeManager-8vf02dwj.cjs';
-import './EngineError-B61GS1jp.cjs';
-import './Configuration-C9W8tJv_.cjs';
+import './TokenNormalizer-DnlL7_8c.cjs';
+import './ScopeManager-D7uMXbhS.cjs';
+import './EngineError-Ce1lPkjZ.cjs';
 
 /**
  * A higher-level, declarative way to contribute a single `name(args)`
@@ -88,16 +87,16 @@ declare const DefineFunctionErrorCodes: {
  *
  * This is the higher-level API from issue #102. It derives, from the
  * declaration alone, everything the low-level contract asks an author to write
- * by hand: a plugin function index ({@link allocatePluginFunctionIndex}), a
- * lexer keyword so the name tokenises, a call-syntax parselet emitting
- * `CALL_PLUGIN`, and a handler that checks arity and argument types (yielding
+ * by hand: a named plugin function (the engine assigns its `CALL_PLUGIN`
+ * index), a lexer keyword so the name tokenises, a call-syntax parselet emitting
+ * that call by name, and a handler that checks arity and argument types (yielding
  * the engine's own structured errors) before invoking `call` and wrapping its
  * result. Anything needing custom parsing keeps writing a raw parselet exactly
  * as before, this sits on top of that contract and does not change it.
  *
  * @example
  * ```ts
- * const engine = new ExpressionEngine("en", false, undefined, undefined, [
+ * const engine = new ExpressionEngine({ packages: [
  *   ...BUILTIN_PACKAGES,
  *   defineFunction({
  *     name: "vat",
@@ -105,7 +104,7 @@ declare const DefineFunctionErrorCodes: {
  *     returns: "number",
  *     call: (amount) => amount * 1.2,
  *   }),
- * ]);
+ * ] });
  * engine.evaluateExpression("vat(100)"); // 120
  * ```
  *
@@ -148,9 +147,9 @@ declare function defineFunction<const A extends readonly FunctionArg[], R extend
  * `checkPackageCompatibility()`'s "return a result, caller decides" shape,
  * and this codebase's own testing convention of asserting against plain
  * result objects rather than `toThrow()` for a pure function).
- * `assertEngineVersionCompatible()` is the thin throwing wrapper both
- * `ExpressionEngine.registerPackage()` and the `PackageRegistry` singleton
- * call as the very first thing they do. See `ARCHITECTURE.md` §5.3.
+ * `assertEngineVersionCompatible()` is the thin throwing wrapper
+ * `ExpressionEngine.registerPackage()` calls as the very first thing it
+ * does. See `ARCHITECTURE.md` §5.3.
  */
 type EngineVersionCheckResult = {
     compatible: true;
@@ -185,4 +184,37 @@ declare function checkEngineVersionCompatibility(pkg: IEnginePackage, engineVers
  */
 declare function assertEngineVersionCompatible(pkg: IEnginePackage, engineVersion?: string): void;
 
-export { DefineFunctionErrorCodes, type EngineVersionCheckResult, type FunctionArg, type FunctionSpec, type FunctionValueType, IEnginePackage, assertEngineVersionCompatible, checkEngineVersionCompatibility, defineFunction };
+/** Options for {@link createEngine}: the engine options, minus `packages` (the
+ *  built-in set is always registered), plus `extraPackages` to add your own. */
+interface CreateEngineOptions extends Omit<EngineOptions, "packages"> {
+    /** Packages to register ON TOP of the built-in set (e.g. an OSRS or stocks package). */
+    extraPackages?: IEnginePackage[];
+}
+/**
+ * A batteries-included {@link ExpressionEngine} with every built-in package
+ * registered.
+ *
+ * The constructor registers only the packages it is given, so a consumer's
+ * bundler can tree-shake away the built-ins they never use: an engine built
+ * with `new ExpressionEngine({ packages: [ARITHMETIC_PACKAGE] })` carries no
+ * finance, colour or weather code. This convenience is the opposite trade: it
+ * pulls the FULL built-in set (`BUILTIN_PACKAGES`) for the common "I want
+ * everything" case, so importing it defeats that tree-shaking. Reach for the
+ * constructor with an explicit package list when bundle size matters, and for
+ * `createEngine` when it does not.
+ *
+ * @param options - Engine options ({@link EngineOptions}) minus `packages`, plus
+ *   an optional `extraPackages` to register alongside the built-in set.
+ * @returns An engine with the built-in packages (and any extras) registered.
+ *
+ * @example
+ * ```typescript
+ * import { createEngine } from "solve-engine";
+ * const engine = createEngine();
+ * const value = engine.evaluateExpression("2 + 2 * 10");
+ * console.log(value.toNumber()); // 22
+ * ```
+ */
+declare function createEngine(options?: CreateEngineOptions): ExpressionEngine;
+
+export { type CreateEngineOptions, DefineFunctionErrorCodes, EngineOptions, type EngineVersionCheckResult, ExpressionEngine, type FunctionArg, type FunctionSpec, type FunctionValueType, IEnginePackage, assertEngineVersionCompatible, checkEngineVersionCompatibility, createEngine, defineFunction };

package/dist/index.d.ts

@@ -1,20 +1,19 @@
-import { I as IEnginePackage } from './PackageRegistry-_8rDlvxI.js';
-export { a as EngineRestoreOptions, b as EngineSnapshot, c as EvalResults, d as Explanation, e as ExplanationStep, E as ExpressionEngine, f as IPackageRegistry, L as LineEvaluation, P as PackageRegistry, S as SNAPSHOT_FORMAT, g as SNAPSHOT_VERSION, h as SerializedAnonymousBody, i as SerializedBytecode, j as SerializedDecimal, k as SerializedLineCacheEntry, l as SerializedNumber, m as SerializedRational, n as SerializedUserFunction, o as SerializedValue, p as SnapshotErrorCodes, q as packageRegistry } from './PackageRegistry-_8rDlvxI.js';
-export { a as CompatibilityConflict, b as CompatibilityConflictKind, C as CompatibilityReport, c as CompatibilitySeverity, d as checkPackageCompatibility } from './PackageCompatibility-Dh59eF-X.js';
+import { I as IEnginePackage, a as EngineOptions, E as ExpressionEngine } from './PackageRegistry-DzeiWcv4.js';
+export { b as EngineRestoreOptions, c as EngineSnapshot, d as Explanation, e as ExplanationStep, S as SNAPSHOT_FORMAT, f as SNAPSHOT_VERSION, g as SerializedAnonymousBody, h as SerializedBytecode, i as SerializedDecimal, j as SerializedLineCacheEntry, k as SerializedNumber, l as SerializedRational, m as SerializedUserFunction, n as SerializedValue, o as SnapshotErrorCodes } from './PackageRegistry-DzeiWcv4.js';
+export { a as CompatibilityConflict, b as CompatibilityConflictKind, C as CompatibilityReport, c as CompatibilitySeverity, d as checkPackageCompatibility } from './PackageCompatibility-CIvq2MP5.js';
+export { E as EngineConfigOverride } from './Configuration-B6W0-T67.js';
 export { ENGINE_VERSION } from './constants.js';
-import './Parselet-BBT8riYh.js';
-import './BytecodeBuilder-Bp9xeTmX.js';
-import './Token-B1hdkedD.js';
-import './pipeline-DCd5M6Gk.js';
-import './Value-BUi1RA3S.js';
-import './variables.js';
-import './Lexer-CSI_lwbW.js';
+import './Parselet-B-zoPrTa.js';
+import './BytecodeBuilder-DGGeByAP.js';
+import './Token-CbP_OutD.js';
+import './pipeline-72QmQlGx.js';
+import './Value-CCi_Eecs.js';
+import './Lexer-DKMlj7Sy.js';
 import './resolvers.js';
 import '@tanstack/query-core';
-import './TokenNormalizer-C6VzZgHa.js';
-import './ScopeManager-CxA24W5n.js';
-import './EngineError-B61GS1jp.js';
-import './Configuration-C9W8tJv_.js';
+import './TokenNormalizer-DCWdZjGz.js';
+import './ScopeManager-C2LDOrDx.js';
+import './EngineError-Ce1lPkjZ.js';
 
 /**
  * A higher-level, declarative way to contribute a single `name(args)`
@@ -88,16 +87,16 @@ declare const DefineFunctionErrorCodes: {
  *
  * This is the higher-level API from issue #102. It derives, from the
  * declaration alone, everything the low-level contract asks an author to write
- * by hand: a plugin function index ({@link allocatePluginFunctionIndex}), a
- * lexer keyword so the name tokenises, a call-syntax parselet emitting
- * `CALL_PLUGIN`, and a handler that checks arity and argument types (yielding
+ * by hand: a named plugin function (the engine assigns its `CALL_PLUGIN`
+ * index), a lexer keyword so the name tokenises, a call-syntax parselet emitting
+ * that call by name, and a handler that checks arity and argument types (yielding
  * the engine's own structured errors) before invoking `call` and wrapping its
  * result. Anything needing custom parsing keeps writing a raw parselet exactly
  * as before, this sits on top of that contract and does not change it.
  *
  * @example
  * ```ts
- * const engine = new ExpressionEngine("en", false, undefined, undefined, [
+ * const engine = new ExpressionEngine({ packages: [
  *   ...BUILTIN_PACKAGES,
  *   defineFunction({
  *     name: "vat",
@@ -105,7 +104,7 @@ declare const DefineFunctionErrorCodes: {
  *     returns: "number",
  *     call: (amount) => amount * 1.2,
  *   }),
- * ]);
+ * ] });
  * engine.evaluateExpression("vat(100)"); // 120
  * ```
  *
@@ -148,9 +147,9 @@ declare function defineFunction<const A extends readonly FunctionArg[], R extend
  * `checkPackageCompatibility()`'s "return a result, caller decides" shape,
  * and this codebase's own testing convention of asserting against plain
  * result objects rather than `toThrow()` for a pure function).
- * `assertEngineVersionCompatible()` is the thin throwing wrapper both
- * `ExpressionEngine.registerPackage()` and the `PackageRegistry` singleton
- * call as the very first thing they do. See `ARCHITECTURE.md` §5.3.
+ * `assertEngineVersionCompatible()` is the thin throwing wrapper
+ * `ExpressionEngine.registerPackage()` calls as the very first thing it
+ * does. See `ARCHITECTURE.md` §5.3.
  */
 type EngineVersionCheckResult = {
     compatible: true;
@@ -185,4 +184,37 @@ declare function checkEngineVersionCompatibility(pkg: IEnginePackage, engineVers
  */
 declare function assertEngineVersionCompatible(pkg: IEnginePackage, engineVersion?: string): void;
 
-export { DefineFunctionErrorCodes, type EngineVersionCheckResult, type FunctionArg, type FunctionSpec, type FunctionValueType, IEnginePackage, assertEngineVersionCompatible, checkEngineVersionCompatibility, defineFunction };
+/** Options for {@link createEngine}: the engine options, minus `packages` (the
+ *  built-in set is always registered), plus `extraPackages` to add your own. */
+interface CreateEngineOptions extends Omit<EngineOptions, "packages"> {
+    /** Packages to register ON TOP of the built-in set (e.g. an OSRS or stocks package). */
+    extraPackages?: IEnginePackage[];
+}
+/**
+ * A batteries-included {@link ExpressionEngine} with every built-in package
+ * registered.
+ *
+ * The constructor registers only the packages it is given, so a consumer's
+ * bundler can tree-shake away the built-ins they never use: an engine built
+ * with `new ExpressionEngine({ packages: [ARITHMETIC_PACKAGE] })` carries no
+ * finance, colour or weather code. This convenience is the opposite trade: it
+ * pulls the FULL built-in set (`BUILTIN_PACKAGES`) for the common "I want
+ * everything" case, so importing it defeats that tree-shaking. Reach for the
+ * constructor with an explicit package list when bundle size matters, and for
+ * `createEngine` when it does not.
+ *
+ * @param options - Engine options ({@link EngineOptions}) minus `packages`, plus
+ *   an optional `extraPackages` to register alongside the built-in set.
+ * @returns An engine with the built-in packages (and any extras) registered.
+ *
+ * @example
+ * ```typescript
+ * import { createEngine } from "solve-engine";
+ * const engine = createEngine();
+ * const value = engine.evaluateExpression("2 + 2 * 10");
+ * console.log(value.toNumber()); // 22
+ * ```
+ */
+declare function createEngine(options?: CreateEngineOptions): ExpressionEngine;
+
+export { type CreateEngineOptions, DefineFunctionErrorCodes, EngineOptions, type EngineVersionCheckResult, ExpressionEngine, type FunctionArg, type FunctionSpec, type FunctionValueType, IEnginePackage, assertEngineVersionCompatible, checkEngineVersionCompatibility, createEngine, defineFunction };

package/dist/index.js

@@ -1,279 +1,2 @@
-import './chunk-LHZ6VOA7.js';
-import { assertEngineVersionCompatible } from './chunk-NNZAEUDW.js';
-export { ExpressionEngine, SNAPSHOT_FORMAT, SNAPSHOT_VERSION, SnapshotErrorCodes, assertEngineVersionCompatible, checkEngineVersionCompatibility, checkPackageCompatibility } from './chunk-NNZAEUDW.js';
-import { sharedParseletRegistry } from './chunk-I4GAWIPW.js';
-import './chunk-2RWAXT6O.js';
-import './chunk-3VGDNEE3.js';
-import './chunk-5ON7PUAZ.js';
-import './chunk-FD5ZZHEU.js';
-import './chunk-WXEHD6TT.js';
-import './chunk-CCBZZQAE.js';
-import './chunk-3OWCDIPN.js';
-import './chunk-UKQHXPGW.js';
-import './chunk-4HQKTMWG.js';
-import { BindingPower } from './chunk-ENKKJYD3.js';
-import './chunk-BYJBUL7U.js';
-import './chunk-3BOK2LDK.js';
-import './chunk-7KYSUDQO.js';
-import './chunk-NLNDMWZC.js';
-import { allocatePluginFunctionIndex } from './chunk-NKW7LKYU.js';
-import { sharedVariableResolver } from './chunk-GCM5JHMX.js';
-import './chunk-Z7XGGLI2.js';
-import './chunk-BLI4NIQY.js';
-import './chunk-Z4X2RWOF.js';
-import './chunk-5HRB36DK.js';
-import './chunk-NNQ2TYDF.js';
-import { Value, boolValue, stringValue, numberValue } from './chunk-267JPOTF.js';
-import './chunk-MVTOCRV2.js';
-export { ENGINE_VERSION } from './chunk-GLA4JXBO.js';
-import { sharedLexer } from './chunk-DLEBSLF4.js';
-import './chunk-UO6BUV6K.js';
-import './chunk-JG6ZJ2WU.js';
-import './chunk-4D6NIHE2.js';
-import './chunk-XBTEO4OB.js';
-import './chunk-SBUFNJVE.js';
-import './chunk-V4XG5QF6.js';
-import { ErrorFactory } from './chunk-ERCOHGXD.js';
-import './chunk-YLJ4XMA6.js';
-
-// src/api/PackageRegistry.ts
-var PackageRegistry = class {
-  constructor() {
-    this.Value = Value;
-  }
-  registerPrefixParselet(tokenType, parselet) {
-    sharedParseletRegistry.registerPrefix(tokenType, parselet);
-  }
-  registerInfixParselet(tokenType, parselet) {
-    sharedParseletRegistry.registerInfix(tokenType, parselet);
-  }
-  registerVariableSource(source) {
-    sharedVariableResolver.registerSource(source);
-  }
-  registerPackage(pkg) {
-    assertEngineVersionCompatible(pkg);
-    if (pkg.lexerVocabulary) {
-      sharedLexer.registerVocabulary(pkg.lexerVocabulary);
-    }
-    if (pkg.prefixParselets) {
-      for (const pp of pkg.prefixParselets) {
-        this.registerPrefixParselet(pp.tokenType, pp.parselet);
-      }
-    }
-    if (pkg.infixParselets) {
-      for (const ip of pkg.infixParselets) {
-        this.registerInfixParselet(ip.tokenType, ip.parselet);
-      }
-    }
-    if (pkg.variableSources) {
-      for (const vs of pkg.variableSources) {
-        this.registerVariableSource(vs);
-      }
-    }
-  }
-};
-var packageRegistry = new PackageRegistry();
-
-// src/api/defineFunction.ts
-var DefineFunctionErrorCodes = {
-  /** The spec's `name` is not a single identifier. Thrown by `defineFunction`, before any engine sees it. */
-  DEFINE_FUNCTION_INVALID_NAME: "DEFINE_FUNCTION_INVALID_NAME",
-  /** The spec is otherwise malformed (bad `args`, unsupported type, missing `call`). Thrown by `defineFunction`. */
-  DEFINE_FUNCTION_INVALID_SPEC: "DEFINE_FUNCTION_INVALID_SPEC",
-  /** The call site passed the wrong number of arguments. Raised at evaluation time. */
-  DEFINE_FUNCTION_ARITY_MISMATCH: "DEFINE_FUNCTION_ARITY_MISMATCH",
-  /** An argument was the wrong value type. Raised at evaluation time. */
-  DEFINE_FUNCTION_ARGUMENT_TYPE: "DEFINE_FUNCTION_ARGUMENT_TYPE",
-  /** The `call` implementation returned a value that did not match `returns`. Raised at evaluation time, an authoring bug rather than a user one. */
-  DEFINE_FUNCTION_RETURN_TYPE: "DEFINE_FUNCTION_RETURN_TYPE"
-};
-var NAME_PATTERN = /^[a-z_][a-z0-9_]*$/i;
-var SUPPORTED_TYPES = /* @__PURE__ */ new Set(["number", "string", "boolean"]);
-function plural(count) {
-  return count === 1 ? "1 argument" : `${count} arguments`;
-}
-function describeValueType(v) {
-  switch (v.type) {
-    case 0 /* Number */:
-    case 1 /* Hex */:
-      return "a number";
-    case 3 /* String */:
-      return "a string";
-    case 10 /* Boolean */:
-      return "a boolean";
-    case 2 /* BigInt */:
-      return "a big integer";
-    case 5 /* Percentage */:
-      return "a percentage";
-    case 6 /* Uom */:
-      return "a value with a unit";
-    case 4 /* Datetime */:
-      return "a date";
-    case 7 /* Matrix */:
-      return "a matrix";
-    case 8 /* Range */:
-      return "a range";
-    case 9 /* Symbolic */:
-      return "a symbolic expression";
-    default:
-      return "an unsupported value";
-  }
-}
-function coerceArgument(value, arg, fnName) {
-  switch (arg.type) {
-    case "number":
-      if (value.type === 0 /* Number */ || value.type === 1 /* Hex */) {
-        return value.toNumber();
-      }
-      break;
-    case "string":
-      if (value.type === 3 /* String */) return value.value;
-      break;
-    case "boolean":
-      if (value.type === 10 /* Boolean */) return value.value;
-      break;
-  }
-  throw ErrorFactory.execution({
-    code: DefineFunctionErrorCodes.DEFINE_FUNCTION_ARGUMENT_TYPE,
-    message: `${fnName}() expects "${arg.name}" to be a ${arg.type}, but was given ${describeValueType(value)}`,
-    expected: `a ${arg.type}`,
-    found: describeValueType(value),
-    context: { functionName: fnName, argName: arg.name, expectedType: arg.type }
-  });
-}
-function wrapReturn(result, returns, fnName) {
-  switch (returns) {
-    case "number":
-      if (typeof result === "number") return numberValue(result);
-      break;
-    case "string":
-      if (typeof result === "string") return stringValue(result);
-      break;
-    case "boolean":
-      if (typeof result === "boolean") return boolValue(result);
-      break;
-  }
-  throw ErrorFactory.internal({
-    code: DefineFunctionErrorCodes.DEFINE_FUNCTION_RETURN_TYPE,
-    message: `${fnName}() is declared to return a ${returns}, but its implementation returned ${typeof result}`,
-    expected: `a ${returns}`,
-    found: typeof result,
-    context: { functionName: fnName, expectedType: returns }
-  });
-}
-var DefinedFunctionParselet = class {
-  constructor(fnIndex, fnName) {
-    this.fnIndex = fnIndex;
-    this.fnName = fnName;
-    this.category = "Function";
-  }
-  parse(parser, _token, builder) {
-    parser.consume("LPAREN");
-    let argCount = 0;
-    if (parser.peek()?.type !== "RPAREN") {
-      parser.parseExpression(BindingPower.Lowest, builder);
-      argCount++;
-      while (parser.match("COMMA")) {
-        parser.parseExpression(BindingPower.Lowest, builder);
-        argCount++;
-      }
-    }
-    parser.consume("RPAREN");
-    builder.emitOpcode(50 /* CALL_PLUGIN */);
-    builder.emitIndex(this.fnIndex);
-    builder.emitIndex(argCount);
-  }
-};
-function makeHandler(spec) {
-  const arity = spec.args.length;
-  return (args) => {
-    if (args.length !== arity) {
-      throw ErrorFactory.execution({
-        code: DefineFunctionErrorCodes.DEFINE_FUNCTION_ARITY_MISMATCH,
-        message: `${spec.name}() takes ${plural(arity)}, but was given ${args.length === 0 ? "none" : plural(args.length)}`,
-        expected: plural(arity),
-        found: args.length === 0 ? "none" : plural(args.length),
-        context: { functionName: spec.name, expected: arity, actual: args.length }
-      });
-    }
-    const jsArgs = new Array(arity);
-    for (let i = 0; i < arity; i++) {
-      jsArgs[i] = coerceArgument(args[i], spec.args[i], spec.name);
-    }
-    const result = spec.call(...jsArgs);
-    return wrapReturn(result, spec.returns, spec.name);
-  };
-}
-function validateSpec(spec) {
-  if (typeof spec?.name !== "string" || !NAME_PATTERN.test(spec.name)) {
-    throw ErrorFactory.config({
-      code: DefineFunctionErrorCodes.DEFINE_FUNCTION_INVALID_NAME,
-      message: `defineFunction: name must be a single identifier, got ${JSON.stringify(spec?.name)}`,
-      suggestion: 'e.g. "vat" or "net_price"',
-      context: { name: spec?.name }
-    });
-  }
-  if (!Array.isArray(spec.args)) {
-    throw ErrorFactory.config({
-      code: DefineFunctionErrorCodes.DEFINE_FUNCTION_INVALID_SPEC,
-      message: `defineFunction: "${spec.name}" args must be an array`,
-      context: { name: spec.name }
-    });
-  }
-  for (const arg of spec.args) {
-    if (typeof arg?.name !== "string" || arg.name.length === 0) {
-      throw ErrorFactory.config({
-        code: DefineFunctionErrorCodes.DEFINE_FUNCTION_INVALID_SPEC,
-        message: `defineFunction: "${spec.name}" has an argument with no name`,
-        context: { name: spec.name }
-      });
-    }
-    if (!SUPPORTED_TYPES.has(arg.type)) {
-      throw ErrorFactory.config({
-        code: DefineFunctionErrorCodes.DEFINE_FUNCTION_INVALID_SPEC,
-        message: `defineFunction: "${spec.name}" argument "${arg.name}" has unsupported type ${JSON.stringify(arg.type)}`,
-        suggestion: "supported argument types are number, string, boolean",
-        context: { name: spec.name, argName: arg.name, type: arg.type }
-      });
-    }
-  }
-  if (!SUPPORTED_TYPES.has(spec.returns)) {
-    throw ErrorFactory.config({
-      code: DefineFunctionErrorCodes.DEFINE_FUNCTION_INVALID_SPEC,
-      message: `defineFunction: "${spec.name}" has unsupported return type ${JSON.stringify(spec.returns)}`,
-      suggestion: "supported return types are number, string, boolean",
-      context: { name: spec.name, returns: spec.returns }
-    });
-  }
-  if (typeof spec.call !== "function") {
-    throw ErrorFactory.config({
-      code: DefineFunctionErrorCodes.DEFINE_FUNCTION_INVALID_SPEC,
-      message: `defineFunction: "${spec.name}" is missing a call implementation`,
-      context: { name: spec.name }
-    });
-  }
-}
-function defineFunction(spec) {
-  validateSpec(spec);
-  const name = spec.name;
-  const tokenType = `DEFINE_FN_${name.toUpperCase()}`;
-  const index = allocatePluginFunctionIndex();
-  return {
-    name: `solve-fn-${name}`,
-    lexerVocabulary: {
-      // Lowercased because the lexer lowercases input before lookup, so the
-      // call is matched case-insensitively.
-      keywords: { [name.toLowerCase()]: tokenType }
-    },
-    prefixParselets: [
-      { tokenType, parselet: new DefinedFunctionParselet(index, name) }
-    ],
-    pluginFunctions: [
-      { index, handler: makeHandler(spec) }
-    ]
-  };
-}
-
-export { DefineFunctionErrorCodes, PackageRegistry, defineFunction, packageRegistry };
-//# sourceMappingURL=index.js.map
+import'./chunk-JSPKKNPQ.js';import'./chunk-RAF57WYO.js';import {n}from'./chunk-XR7HEC7B.js';export{n as ExpressionEngine,d as SNAPSHOT_FORMAT,e as SNAPSHOT_VERSION,f as SnapshotErrorCodes,c as assertEngineVersionCompatible,b as checkEngineVersionCompatibility,a as checkPackageCompatibility}from'./chunk-XR7HEC7B.js';import'./chunk-XNIWQHXY.js';import'./chunk-2RWAXT6O.js';import'./chunk-7GK3XEZF.js';import'./chunk-MIQBJGGR.js';import'./chunk-YJ2OPULK.js';import'./chunk-TWC7K3ZX.js';import'./chunk-J4LZD4ZY.js';import'./chunk-XEIDV5JP.js';import {y as y$1}from'./chunk-EYRBENHC.js';import'./chunk-6G3PMEPA.js';import'./chunk-6CY44ZPG.js';import {a}from'./chunk-YVKHEAFT.js';import'./chunk-QXQE7X4S.js';import'./chunk-76F3LCIL.js';import'./chunk-TCZSPH4A.js';import'./chunk-W2JAR233.js';import'./chunk-YAYBVVG2.js';import'./chunk-E6Z4NQAS.js';import'./chunk-HFKDWQUL.js';import'./chunk-R2ENWQ76.js';import'./chunk-RSF25YSJ.js';import {J,t,n as n$1}from'./chunk-EVAOPEO4.js';import'./chunk-WGZ3FNHI.js';export{a as ENGINE_VERSION}from'./chunk-L3FPQSGN.js';import'./chunk-GOIQYUWV.js';import'./chunk-JPFCXLJV.js';import'./chunk-UI6IFGBT.js';import'./chunk-IJMNVBIS.js';import'./chunk-62LMTO4F.js';import'./chunk-TRBXW6HW.js';import'./chunk-2JMFUQZH.js';import {c}from'./chunk-MPB7KUN5.js';var r={DEFINE_FUNCTION_INVALID_NAME:"DEFINE_FUNCTION_INVALID_NAME",DEFINE_FUNCTION_INVALID_SPEC:"DEFINE_FUNCTION_INVALID_SPEC",DEFINE_FUNCTION_ARITY_MISMATCH:"DEFINE_FUNCTION_ARITY_MISMATCH",DEFINE_FUNCTION_ARGUMENT_TYPE:"DEFINE_FUNCTION_ARGUMENT_TYPE",DEFINE_FUNCTION_RETURN_TYPE:"DEFINE_FUNCTION_RETURN_TYPE"},b=/^[a-z_][a-z0-9_]*$/i,y=new Set(["number","string","boolean"]);function u(e){return e===1?"1 argument":`${e} arguments`}function f(e){switch(e.type){case 0:case 1:return "a number";case 3:return "a string";case 10:return "a boolean";case 2:return "a big integer";case 5:return "a percentage";case 6:return "a value with a unit";case 4:return "a date";case 7:return "a matrix";case 8:return "a range";case 9:return "a symbolic expression";default:return "an unsupported value"}}function A(e,n,t){switch(n.type){case "number":if(e.type===0||e.type===1)return e.toNumber();break;case "string":if(e.type===3)return e.value;break;case "boolean":if(e.type===10)return e.value;break}throw c.execution({code:r.DEFINE_FUNCTION_ARGUMENT_TYPE,message:`${t}() expects "${n.name}" to be a ${n.type}, but was given ${f(e)}`,expected:`a ${n.type}`,found:f(e),context:{functionName:t,argName:n.name,expectedType:n.type}})}function S(e,n,t$1){switch(n){case "number":if(typeof e=="number")return n$1(e);break;case "string":if(typeof e=="string")return t(e);break;case "boolean":if(typeof e=="boolean")return J(e);break}throw c.internal({code:r.DEFINE_FUNCTION_RETURN_TYPE,message:`${t$1}() is declared to return a ${n}, but its implementation returned ${typeof e}`,expected:`a ${n}`,found:typeof e,context:{functionName:t$1,expectedType:n}})}var p=class{constructor(n){this.fnName=n;this.category="Function";}parse(n,t,i){n.consume("LPAREN");let a$1=0;if(n.peek()?.type!=="RPAREN")for(n.parseExpression(a.Lowest,i),a$1++;n.match("COMMA");)n.parseExpression(a.Lowest,i),a$1++;n.consume("RPAREN"),i.emitPluginCall(this.fnName,a$1);}};function P(e){let n=e.args.length;return t=>{if(t.length!==n)throw c.execution({code:r.DEFINE_FUNCTION_ARITY_MISMATCH,message:`${e.name}() takes ${u(n)}, but was given ${t.length===0?"none":u(t.length)}`,expected:u(n),found:t.length===0?"none":u(t.length),context:{functionName:e.name,expected:n,actual:t.length}});let i=new Array(n);for(let s=0;s<n;s++)i[s]=A(t[s],e.args[s],e.name);let a=e.call(...i);return S(a,e.returns,e.name)}}function V(e){if(typeof e?.name!="string"||!b.test(e.name))throw c.config({code:r.DEFINE_FUNCTION_INVALID_NAME,message:`defineFunction: name must be a single identifier, got ${JSON.stringify(e?.name)}`,suggestion:'e.g. "vat" or "net_price"',context:{name:e?.name}});if(!Array.isArray(e.args))throw c.config({code:r.DEFINE_FUNCTION_INVALID_SPEC,message:`defineFunction: "${e.name}" args must be an array`,context:{name:e.name}});for(let n of e.args){if(typeof n?.name!="string"||n.name.length===0)throw c.config({code:r.DEFINE_FUNCTION_INVALID_SPEC,message:`defineFunction: "${e.name}" has an argument with no name`,context:{name:e.name}});if(!y.has(n.type))throw c.config({code:r.DEFINE_FUNCTION_INVALID_SPEC,message:`defineFunction: "${e.name}" argument "${n.name}" has unsupported type ${JSON.stringify(n.type)}`,suggestion:"supported argument types are number, string, boolean",context:{name:e.name,argName:n.name,type:n.type}})}if(!y.has(e.returns))throw c.config({code:r.DEFINE_FUNCTION_INVALID_SPEC,message:`defineFunction: "${e.name}" has unsupported return type ${JSON.stringify(e.returns)}`,suggestion:"supported return types are number, string, boolean",context:{name:e.name,returns:e.returns}});if(typeof e.call!="function")throw c.config({code:r.DEFINE_FUNCTION_INVALID_SPEC,message:`defineFunction: "${e.name}" is missing a call implementation`,context:{name:e.name}})}function O(e){V(e);let n=e.name,t=`DEFINE_FN_${n.toUpperCase()}`;return {name:`solve-fn-${n}`,lexerVocabulary:{keywords:{[n.toLowerCase()]:t}},prefixParselets:{[t]:new p(n)},pluginFunctions:{[n]:P(e)}}}function h(e={}){let{extraPackages:n$1=[],...t}=e;return new n({...t,packages:n$1.length>0?[...y$1,...n$1]:y$1})}export{r as DefineFunctionErrorCodes,h as createEngine,O as defineFunction};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map