EngineSnapshot

Defined in: packages/engine/src/engine/EngineSnapshot.ts:246

A complete, JSON-safe snapshot of an engine’s session state.

Produced by ExpressionEngine.toJSON and consumed by ExpressionEngine.fromJSON. Safe to JSON.stringify, store, and JSON.parse back into fromJSON.

Properties

bytecodeCache

bytecodeCache: {
  expression: string;
  program: SerializedBytecode;
}[];

Defined in: packages/engine/src/engine/EngineSnapshot.ts:262

The expression-keyed bytecode cache, a pure recompilation cache, carried so a warm start skips re-parsing unchanged expressions.

expression

expression: string;

program

program: SerializedBytecode;

---

engineVersion

engineVersion: string;

Defined in: packages/engine/src/engine/EngineSnapshot.ts:252

The engine’s semver at write time, for diagnostics and forward compatibility decisions. Not itself a gate.

---

format

format: "solve-engine/snapshot";

Defined in: packages/engine/src/engine/EngineSnapshot.ts:248

Always SNAPSHOT_FORMAT. Identifies the object as a snapshot before anything reads deeper.

---

frozen?

frozen?: SerializedFrozenRecord[];

Defined in: packages/engine/src/engine/EngineSnapshot.ts:268

The answers this engine’s frozen lines keep, so a restored document reads the same answers with no network. Absent on a snapshot written before frozen lines existed, which restores with none.

---

lineCache

lineCache: SerializedLineCacheEntry[];

Defined in: packages/engine/src/engine/EngineSnapshot.ts:260

Cached lines, minus any backed by an async resolver.

---

locale

locale: string;

Defined in: packages/engine/src/engine/EngineSnapshot.ts:254

The locale the snapshot was taken under, so fromJSON can rebuild a matching lexer when the caller does not override it.

---

userFunctions

userFunctions: SerializedUserFunction[];

Defined in: packages/engine/src/engine/EngineSnapshot.ts:258

User-defined functions (f(x) = ...).

---

variables

variables: Record<string, SerializedValue>;

Defined in: packages/engine/src/engine/EngineSnapshot.ts:256

Named variables, by name. Async-backed and in-flight variables are omitted (see the module doc).

---

version

version: number;

Defined in: packages/engine/src/engine/EngineSnapshot.ts:250

The serialised-shape version, SNAPSHOT_VERSION at write time. fromJSON refuses any other value.