@truecalc/workbook 8.2.1 → 8.2.2

package/package.json

@@ -2,7 +2,7 @@
   "name": "@truecalc/workbook",
   "type": "module",
   "description": "Spreadsheet workbook for the browser — full Workbook API compiled to WebAssembly",
-  "version": "8.2.1",
+  "version": "8.2.2",
   "license": "MIT",
   "repository": {
     "type": "git",

package/truecalc_wasm_workbook.d.ts

@@ -224,11 +224,13 @@ export class JsWorkbook {
      * the answer, not the answer. `truncated` is always present; branch on
      * it, not on `truncatedBy`.
      *
-     * The graph is rebuilt from the workbook's current formulas on every
-     * call, so the result is never stale: it reflects every `set` / `clear` /
-     * `defineName` since the last `recalc`, and is meaningful before any
-     * `recalc` at all. Building the graph costs `O(formula cells)` per call —
-     * an upper bound expected to improve, not a fixed contract.
+     * Reuses the workbook's cached dependency graph when it is warm (see
+     * `truecalc_workbook`'s `graph_cache` module docs) and builds fresh
+     * otherwise, so the result is never stale either way: it reflects every
+     * `set` / `clear` / `defineName` since the last `recalc`, and is
+     * meaningful before any `recalc` at all. A cold build costs
+     * `O(formula cells)` per call — an upper bound expected to improve, not
+     * a fixed contract.
      *
      * Throws on an unknown sheet or a malformed A1 address.
      */

package/truecalc_wasm_workbook.js

@@ -206,11 +206,13 @@ export class JsWorkbook {
      * the answer, not the answer. `truncated` is always present; branch on
      * it, not on `truncatedBy`.
      *
-     * The graph is rebuilt from the workbook's current formulas on every
-     * call, so the result is never stale: it reflects every `set` / `clear` /
-     * `defineName` since the last `recalc`, and is meaningful before any
-     * `recalc` at all. Building the graph costs `O(formula cells)` per call —
-     * an upper bound expected to improve, not a fixed contract.
+     * Reuses the workbook's cached dependency graph when it is warm (see
+     * `truecalc_workbook`'s `graph_cache` module docs) and builds fresh
+     * otherwise, so the result is never stale either way: it reflects every
+     * `set` / `clear` / `defineName` since the last `recalc`, and is
+     * meaningful before any `recalc` at all. A cold build costs
+     * `O(formula cells)` per call — an upper bound expected to improve, not
+     * a fixed contract.
      *
      * Throws on an unknown sheet or a malformed A1 address.
      * @param {string} sheet