@bilig/xlsx-formula-recalc 0.107.8 → 0.119.0

package/README.md

@@ -1,6 +1,7 @@
 # @bilig/xlsx-formula-recalc
 
-Scoped XLSX formula recalculation package for Node.js without Excel, LibreOffice, or browser automation.
+Recalculate XLSX formula values in Node.js after SheetJS, ExcelJS, or
+xlsx-populate edits without Excel, LibreOffice, or browser automation.
 
 This package is the canonical scoped Bilig entrypoint for the high-friction Node
 XLSX workflow:
@@ -58,7 +59,33 @@ npx --package @bilig/xlsx-formula-recalc xlsx-recalc --demo --json
 
 That command creates a tiny workbook, changes `Inputs!B2` and `Inputs!B3`,
 recalculates `Summary!B2`, writes `bilig-formula-recalc-demo.xlsx`, and prints
-`verified: true` with the recalculated value.
+a proof object with `verified: true`, the recalculated value, and explicit next
+actions:
+
+```json
+{
+  "reads": {
+    "Summary!B2": {
+      "value": 72000
+    }
+  },
+  "warnings": [],
+  "verified": true,
+  "star": "https://github.com/proompteng/bilig/stargazers",
+  "watchReleases": "https://github.com/proompteng/bilig/subscription",
+  "adoptionBlocker": "https://github.com/proompteng/bilig/discussions/new?category=general",
+  "nextStep": {
+    "ifUseful": "If this proof fixed your stale XLSX formula workflow, star or bookmark Bilig so you can find it again.",
+    "star": "https://github.com/proompteng/bilig/stargazers",
+    "watchReleases": "https://github.com/proompteng/bilig/subscription",
+    "ifBlocked": "If this is close but blocked by a workbook edge case, open an adoption blocker with a reduced fixture.",
+    "adoptionBlocker": "https://github.com/proompteng/bilig/discussions/new?category=general"
+  }
+}
+```
+
+Keep the proof first: use the star or release-watch links only after the
+recalculated value and warnings match the workflow you are evaluating.
 
 For an existing workbook:
 
@@ -100,6 +127,10 @@ Ambiguous companion matches fail closed: the command preserves existing
 external-link cache values, emits a warning, and includes hydration diagnostics
 in JSON output.
 
+For a maintained external-workbook proof with companion hydration diagnostics,
+run
+[external workbook recalculation proof in Node.js](https://proompteng.github.io/bilig/external-workbook-recalc-proof.html).
+
 ## API
 
 ```ts
@@ -158,6 +189,19 @@ from `@bilig/workpaper`.
 | Excel, LibreOffice, Microsoft Graph | exact spreadsheet application behavior                 | you cannot depend on an external app or API call |
 | `@bilig/workpaper`                  | service-owned formula workbook state with JSON storage | the workbook does not have to stay XLSX-first    |
 
+## After The Proof
+
+If `verified: true` matches the Node/XLSX workflow you need, star or bookmark
+the repo so you can find it again:
+<https://github.com/proompteng/bilig/stargazers>.
+
+Watch releases if the package is close to a production path:
+<https://github.com/proompteng/bilig/subscription>.
+
+If a real workbook edge case blocks adoption, open the smallest reduced
+workbook blocker:
+<https://github.com/proompteng/bilig/discussions/new?category=general>.
+
 ## Scope
 
 Use this when a Node service needs deterministic formula readback after it

package/package.json

@@ -1,26 +1,32 @@
 {
   "name": "@bilig/xlsx-formula-recalc",
-  "version": "0.107.8",
-  "description": "Scoped XLSX formula recalculation package for Node.js without Excel, LibreOffice, or browser automation.",
+  "version": "0.119.0",
+  "description": "Recalculate XLSX formula values in Node.js after SheetJS, ExcelJS, or xlsx-populate edits without Excel, LibreOffice, or browser automation.",
   "keywords": [
     "bilig",
     "excel",
     "excel-formulas",
     "formula-engine",
     "formula-recalculation",
+    "formula-result-not-updating",
+    "libreoffice-alternative",
     "node",
+    "recalculate-xlsx",
     "sheetjs",
+    "sheetjs-recalc",
     "spreadsheet",
     "spreadsheet-formulas",
+    "stale-xlsx-cache",
     "workbook",
     "xlsx",
     "xlsx-calc",
     "xlsx-formula",
     "xlsx-formula-recalculation",
+    "xlsx-populate",
     "xlsx-recalc",
     "xlsx-recalculation"
   ],
-  "homepage": "https://proompteng.github.io/bilig/xlsx-formula-recalculation-node.html",
+  "homepage": "https://proompteng.github.io/bilig/eval-xlsx-recalc.html",
   "bugs": {
     "url": "https://github.com/proompteng/bilig/issues"
   },
@@ -63,7 +69,7 @@
     "smoke": "node ./dist/cli.js --help"
   },
   "dependencies": {
-    "xlsx-formula-recalc": "0.107.8"
+    "xlsx-formula-recalc": "0.119.0"
   },
   "engines": {
     "node": ">=22.0.0"