@lemmabase/lemma-engine 0.9.0 → 0.9.1

package/README.md

@@ -30,7 +30,7 @@ import { Lemma } from '@lemmabase/lemma-engine';
 const engine = await Lemma();
 await engine.load({ 'pricing.lemma': pricing });
 
-const response = engine.run(null, 'pricing', null, { quantity: 50, is_vip: false }, null, false);
+const response = engine.run({ spec: 'pricing', data: { quantity: 50, is_vip: false } });
 // response.results.unit_price → 16 eur
 // response.results.total      → 800 eur
 ```
@@ -40,7 +40,7 @@ The `Response` carries every rule's value (or `veto` if no result could be compu
 ## Why use it from JavaScript?
 
 - **Deterministic.** `(spec, data, effective_date) → result`. No DB, no clock, no ambient state. Same inputs → same outputs, every time.
-- **Explainable.** Pass `explain: true` (6th `run` argument) to get a per-rule explanation tree; see [explanation.v1.json](https://github.com/lemma/lemma/blob/main/documentation/schemas/explanation.v1.json). Pair with the [CLI](https://github.com/lemma/lemma) for human reasoning tables.
+- **Explainable.** Pass `explain: true` in your `run()` options to get a per-rule explanation tree; see [api.v1.json](https://github.com/lemma/lemma/blob/main/documentation/schemas/api.v1.json). Pair with the [CLI](https://github.com/lemma/lemma) for human reasoning tables.
 - **Time-aware.** Multiple versions of the same spec coexist. Pass an `effective` date and the engine resolves the version in force on that day.
 - **Statically checked.** Type errors, missing data, cycles, measure-family mismatches - all caught at `load()` time. Bad specs never reach `run()`.
 - **Runs anywhere JavaScript does.** ~2 MB package, no native binary, no postinstall script.
@@ -112,12 +112,12 @@ A pre-wired Monaco adapter ships at `@lemmabase/lemma-engine/monaco`.
 | Method | Description |
 |--------|-------------|
 | `load(code)` | Load inline Lemma source as a volatile workspace source |
-| `load(sources)` | Load multiple sources in one planning pass (`Record<label, text>` or `[label, code][]`; `@org/pkg` keys tag dependencies) |
+| `load(sources)` | Load multiple sources in one planning pass (`Record<label, text>` or `[label, code][]`; object keys keep insertion order; `@org/pkg` keys tag dependencies) |
 | `fetch(name)` | Download registry source only; resolves with `{ source, id }`. Does not load. Rejects with `EngineError[]`. |
 | `list()` | Slim catalog: `ResolvedRepository[]` with `repository` and temporal `specs` rows. Always includes embedded `lemma` / `spec units`. |
 | `show(repo, name, effective?)` | Spec interface + temporal window; `repo` null for workspace. |
 | `source(repo, spec?, effective?)` | Canonical Lemma source text. Omit `spec` for whole repository. |
-| `run(repo, name, effective?, data?, ruleNames?, explain?)` | Evaluate. Omit/`null` `ruleNames` for all rules; pass a non-empty array to scope. `[]` errors. Returns a `Response`. `explain: true` adds per-rule explanation trees. |
+| `run({ spec, repository?, effective?, data?, rules?, explain? })` | Evaluate. Omit `rules` for all rules; pass a non-empty array to scope. `[]` errors. Returns a `Response`. `explain: true` adds per-rule explanation trees. |
 | `remove(repo, name, effective?)` | Remove a temporal spec slice. |
 | `limits()` | Resource limits for this engine. |
 | `format(code, attribute?)` | Canonical formatting; throws `EngineError` on parse error. |

package/lemma.bindings.d.ts

@@ -44,8 +44,10 @@ export class Engine {
     remove(repository: string | null | undefined, spec: string, effective?: string | null): void;
     /**
      * Evaluate spec. Returns [`crate::evaluation::Response`] as a JS object. Throws on planning/runtime error.
+     *
+     * Accepts an options object: `{ spec, repository?, effective?, data?, rules?, explain? }`.
      */
-    run(repository: string | null | undefined, spec: string, effective: string | null | undefined, data_values: any, rule_names: any, explain?: boolean | null): any;
+    run(options: any): any;
     /**
      * Spec interface and temporal window at `effective`. Lemma text is [`Self::source`].
      */
@@ -117,19 +119,19 @@ export interface InitOutput {
     readonly intounderlyingsource_cancel: (a: number) => void;
     readonly intounderlyingsource_pull: (a: number, b: number) => number;
     readonly __wbg_engine_free: (a: number, b: number) => void;
-    readonly wasmengine_fetch: (a: number, b: number, c: number) => number;
-    readonly wasmengine_format: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
-    readonly wasmengine_limits: (a: number, b: number) => void;
-    readonly wasmengine_list: (a: number, b: number) => void;
-    readonly wasmengine_load: (a: number, b: number, c: number) => void;
-    readonly wasmengine_new: () => number;
-    readonly wasmengine_remove: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
-    readonly wasmengine_run: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => void;
-    readonly wasmengine_show: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
-    readonly wasmengine_source: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
-    readonly __wasm_bindgen_func_elem_12266: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_2732: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_12283: (a: number, b: number, c: number, d: number) => void;
+    readonly engine_fetch: (a: number, b: number, c: number) => number;
+    readonly engine_format: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly engine_limits: (a: number, b: number) => void;
+    readonly engine_list: (a: number, b: number) => void;
+    readonly engine_load: (a: number, b: number, c: number) => void;
+    readonly engine_new: () => number;
+    readonly engine_remove: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly engine_run: (a: number, b: number, c: number) => void;
+    readonly engine_show: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly engine_source: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly __wasm_bindgen_func_elem_12433: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_2735: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_12440: (a: number, b: number, c: number, d: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_export3: (a: number) => void;