exceljs-formula-recalc 0.33.1 → 0.34.0

package/AGENTS.md

@@ -0,0 +1,35 @@
+# exceljs-formula-recalc Agent Notes
+
+Use this package when a Node.js task already uses ExcelJS for workbook I/O but
+needs recalculated formula values after editing inputs.
+
+Start with the one-command proof:
+
+```sh
+npx --package exceljs-formula-recalc exceljs-recalc --demo --json
+```
+
+For a workbook that ExcelJS already wrote to disk:
+
+```sh
+npx --package exceljs-formula-recalc exceljs-recalc quote.xlsx \
+  --set Inputs!B2=48 \
+  --read Summary!B7 \
+  --out quote.recalculated.xlsx \
+  --json
+```
+
+Use the API when code needs the in-memory ExcelJS workbook patched:
+
+```ts
+import { recalculateExceljsWorkbook } from 'exceljs-formula-recalc'
+
+const result = await recalculateExceljsWorkbook(workbook, {
+  edits: [{ target: 'Inputs!B2', value: 48 }],
+  reads: ['Summary!B7'],
+})
+```
+
+ExcelJS stores formula text and cached results; it does not recalculate the
+workbook by itself. Treat unsupported functions, external links, macros, and
+volatile formulas as fixture candidates before promising production behavior.

package/README.md

@@ -10,6 +10,29 @@ ExcelJS can read and write formula cells, but it does not run an Excel-compatibl
 npm install exceljs exceljs-formula-recalc
 ```
 
+## CLI
+
+If your ExcelJS workflow has already written an `.xlsx` file, the package also
+ships an ExcelJS-named CLI for quick proof runs:
+
+```sh
+npx --package exceljs-formula-recalc exceljs-recalc --demo --json
+```
+
+For a real workbook saved by ExcelJS:
+
+```sh
+npx --package exceljs-formula-recalc exceljs-recalc quote.xlsx \
+  --set Inputs!B2=48 \
+  --set Inputs!B3=1500 \
+  --read Summary!B7 \
+  --out quote.recalculated.xlsx \
+  --json
+```
+
+Use the API below when backend code needs the recalculated values patched back
+onto the in-memory ExcelJS workbook object.
+
 ## Use With ExcelJS
 
 ```ts

package/SKILL.md

@@ -0,0 +1,36 @@
+# ExcelJS Formula Recalculation
+
+Use `exceljs-formula-recalc` when an agent or Node.js service already uses
+ExcelJS and needs fresh formula output values after changing cells.
+
+## First Check
+
+```sh
+npx --package exceljs-formula-recalc exceljs-recalc --demo --json
+```
+
+The demo should print `verified: true` and a `Summary!B2` value of `72000`.
+
+## Real Workbook
+
+```sh
+npx --package exceljs-formula-recalc exceljs-recalc workbook.xlsx \
+  --set Inputs!B2=48 \
+  --read Summary!B7 \
+  --out workbook.recalculated.xlsx \
+  --json
+```
+
+## TypeScript
+
+```ts
+import { recalculateExceljsWorkbook } from 'exceljs-formula-recalc'
+
+const result = await recalculateExceljsWorkbook(workbook, {
+  edits: [{ target: 'Inputs!B2', value: 48 }],
+  reads: ['Summary!B7'],
+})
+```
+
+Use `xlsx-formula-recalc` instead when the caller only has raw XLSX bytes and
+does not need an ExcelJS workbook object.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { runXlsxFormulaRecalcCli } from 'xlsx-formula-recalc/cli-api';
+process.exitCode = runXlsxFormulaRecalcCli(process.argv.slice(2), {
+    commandName: 'exceljs-recalc',
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAErE,OAAO,CAAC,QAAQ,GAAG,uBAAuB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IAChE,WAAW,EAAE,gBAAgB;CAC9B,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exceljs-formula-recalc",
-  "version": "0.33.1",
+  "version": "0.34.0",
   "description": "Recalculate ExcelJS XLSX workbook formulas in Node.js without Excel, LibreOffice, or browser automation.",
   "keywords": [
     "excel",
@@ -28,8 +28,13 @@
     "url": "git+https://github.com/proompteng/bilig.git",
     "directory": "packages/exceljs-formula-recalc"
   },
+  "bin": {
+    "exceljs-recalc": "./dist/cli.js"
+  },
   "files": [
     "dist",
+    "AGENTS.md",
+    "SKILL.md",
     "README.md",
     "LICENSE"
   ],
@@ -50,7 +55,7 @@
     "build": "pnpm --dir ../.. --filter xlsx-formula-recalc build && rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json"
   },
   "dependencies": {
-    "xlsx-formula-recalc": "0.33.1"
+    "xlsx-formula-recalc": "0.34.0"
   },
   "devDependencies": {
     "exceljs": "4.4.0"