@sheetxl/primitives 0.7.28-beta.2 → 0.7.28-beta.3

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 (4) hide show
  1. package/browser/esm/index.mjs +1 -1
  2. package/node/esm/index.mjs +1 -1
  3. package/package.json +1 -1
  4. package/types/src/IFormulaContext.d.ts +11 -4
package/browser/esm/index.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.7.28-beta.2
2
+ * @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.7.28-beta.3
3
3
  *
4
4
  * (C) 2026-present SheetXL Inc. & Michael T. Ford
5
5
  * License: The license can be found at https://www.sheetxl.com/license.
package/node/esm/index.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.7.28-beta.2
2
+ * @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.7.28-beta.3
3
3
  *
4
4
  * (C) 2026-present SheetXL Inc. & Michael T. Ford
5
5
  * License: The license can be found at https://www.sheetxl.com/license.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@sheetxl/primitives",
3
3
  "description": "Primitives - Base types for SheetXL functions.",
4
- "version": "0.7.28-beta.2",
4
+ "version": "0.7.28-beta.3",
5
5
  "license": "SEE LICENSE IN <LICENSE>",
6
6
  "type": "module",
7
7
  "exports": {
package/types/src/IFormulaContext.d.ts CHANGED
@@ -143,12 +143,19 @@ export interface IFormulaContext {
143
143
  */
144
144
  getFormulaAt(row: number, column: number, sheetName?: string): string | null;
145
145
  /**
146
- * Returns the spill range anchored at a cell.
146
+ * Returns the range the formula anchored at a cell OCCUPIES — what the spill anchor operator
147
+ * (`A1#`) resolves to.
147
148
  *
148
- * @param row The row where the spill starts.
149
- * @param column The column where the spill starts.
149
+ * @param row The row the formula is anchored at.
150
+ * @param column The column the formula is anchored at.
150
151
  * @param sheetName The name of the sheet. If not provided the current sheet is used.
151
- * @returns The spilled range, or `null` if nothing spills from that cell.
152
+ * @returns The range, or `null` if no formula is anchored there.
153
+ *
154
+ * @remarks
155
+ * The range is the formula's spill when it produced an array, the whole block for a legacy
156
+ * array formula, and the cell ITSELF for an ordinary formula — every formula occupies at least
157
+ * the cell it sits in. `null` means no formula is anchored at that cell: it holds a constant, it
158
+ * is empty, or it merely lies INSIDE another cell's spill or array block.
152
159
  */
153
160
  getSpillAt(row: number, column: number, sheetName?: string): IReferenceRange | null;
154
161
  /**