@bilig/xlsx-formula-recalc 0.119.5 → 0.121.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +33 -0
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -87,6 +87,39 @@ actions:
87
87
  Keep the proof first: use the star or release-watch links only after the
88
88
  recalculated value and warnings match the workflow you are evaluating.
89
89
 
90
+ If you have a real workbook but do not yet know which formula cells matter,
91
+ inspect it without writing an output file:
92
+
93
+ ```sh
94
+ npx --package @bilig/xlsx-formula-recalc xlsx-recalc pricing.xlsx --inspect --json
95
+ ```
96
+
97
+ Inspection imports the workbook, lists formula cells, recomputes a bounded
98
+ sample, reports stale cached values, and returns suggested `--read` targets for
99
+ the recalculation command:
100
+
101
+ ```json
102
+ {
103
+ "formulaCellCount": 12,
104
+ "inspectedFormulaCellCount": 12,
105
+ "staleCachedFormulaCount": 3,
106
+ "suggestedReads": ["Summary!B7"],
107
+ "formulas": [
108
+ {
109
+ "target": "Summary!B7",
110
+ "formula": "=Inputs!B2*Inputs!B3",
111
+ "cachedValue": 60000,
112
+ "literalRecalculatedValue": 72000,
113
+ "staleCachedValue": true
114
+ }
115
+ ],
116
+ "verified": true,
117
+ "nextStep": {
118
+ "command": "xlsx-recalc pricing.xlsx --read 'Summary!B7' --json"
119
+ }
120
+ }
121
+ ```
122
+
90
123
  For an existing workbook:
91
124
 
92
125
  ```sh
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bilig/xlsx-formula-recalc",
3
- "version": "0.119.5",
3
+ "version": "0.121.0",
4
4
  "description": "Recalculate XLSX formula values in Node.js after SheetJS, ExcelJS, or xlsx-populate edits without Excel, LibreOffice, or browser automation.",
5
5
  "keywords": [
6
6
  "bilig",
@@ -69,7 +69,7 @@
69
69
  "smoke": "node ./dist/cli.js --help"
70
70
  },
71
71
  "dependencies": {
72
- "xlsx-formula-recalc": "0.119.5"
72
+ "xlsx-formula-recalc": "0.121.0"
73
73
  },
74
74
  "engines": {
75
75
  "node": ">=22.0.0"