@sheetxl/primitives 0.8.0-beta.18 → 0.8.0-beta.19

package/browser/esm/index.mjs

@@ -1,5 +1,5 @@
 /**
-* @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.8.0-beta.18
+* @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.8.0-beta.19
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
 * License: MIT
@@ -465,7 +465,6 @@ var v = class {
 	getSheetCount() {
 		return 1;
 	}
-	markVolatile() {}
 	defer(e, t) {}
 	formatResults(e) {}
 	filterHidden(e, t) {
@@ -655,9 +654,6 @@ var v = class {
 	getSheetCount() {
 		return this._getScope().getSheetCount?.() ?? 1;
 	}
-	markVolatile() {
-		this._getScope().markVolatile?.();
-	}
 	defer(e, t) {
 		return this._getScope().defer?.(e, t);
 	}

package/node/esm/index.mjs

@@ -1,5 +1,5 @@
 /**
-* @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.8.0-beta.18
+* @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.8.0-beta.19
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
 * License: MIT
@@ -470,7 +470,6 @@ var f = class {
 	getSheetCount() {
 		return 1;
 	}
-	markVolatile() {}
 	defer(e, t) {}
 	formatResults(e) {}
 	filterHidden(e, t) {
@@ -660,9 +659,6 @@ var f = class {
 	getSheetCount() {
 		return this._getScope().getSheetCount?.() ?? 1;
 	}
-	markVolatile() {
-		this._getScope().markVolatile?.();
-	}
 	defer(e, t) {
 		return this._getScope().defer?.(e, t);
 	}
@@ -782,5 +778,5 @@ var f = class {
 		sensitivity: "base",
 		numeric: !0
 	})
-}), k = new P();
-export { T as DEFAULT_LOCALE_PROFILE, k as FormulaContext, n as FormulaError, t as IRange, o as IRangeStats, a as InteropScalarType, f as Observable, e as Scalar, s as ScalarType, P as ScopedFormulaContext, A as StubbedFormulaContext, i as ValueKind, l as WildCard, d as isLazyValue };
+}), v = new P();
+export { T as DEFAULT_LOCALE_PROFILE, v as FormulaContext, n as FormulaError, t as IRange, o as IRangeStats, a as InteropScalarType, f as Observable, e as Scalar, s as ScalarType, P as ScopedFormulaContext, A as StubbedFormulaContext, i as ValueKind, l as WildCard, d as isLazyValue };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sheetxl/primitives",
   "description": "Primitives - Base types for SheetXL functions.",
-  "version": "0.8.0-beta.18",
+  "version": "0.8.0-beta.19",
   "license": "MIT",
   "type": "module",
   "exports": {

package/types/src/FormulaContext.d.ts

@@ -62,8 +62,6 @@ export declare class StubbedFormulaContext implements IFormulaContext {
     getSheetIndex(sheet?: string | IReferenceRange): number;
     /** @inheritdoc IFormulaContext.getSheetCount */
     getSheetCount(): number | null;
-    /** @inheritdoc IFormulaContext.markVolatile */
-    markVolatile(): void;
     /** @inheritdoc IFormulaContext.defer */
     defer(_executor: IFormulaContext.DeferExecutor, _payload?: unknown): unknown;
     /** @inheritdoc IFormulaContext.formatResults */
@@ -240,8 +238,6 @@ export declare class ScopedFormulaContext implements IFormulaContext {
     getSheetIndex(sheet?: string | IReferenceRange): number;
     /** @inheritdoc IFormulaContext.getSheetCount */
     getSheetCount(): number | null;
-    /** @inheritdoc IFormulaContext.markVolatile */
-    markVolatile(): void;
     /** @inheritdoc IFormulaContext.defer */
     defer(executor: IFormulaContext.DeferExecutor, payload?: unknown): unknown;
     /** @inheritdoc IFormulaContext.formatResults */

package/types/src/IFormulaContext.d.ts

@@ -29,7 +29,7 @@ import { IRichData } from './IRichData';
  *
  * | Category | Key methods |
  * |---|---|
- * | Evaluation lifecycle | `markVolatile`, `getRow`, `getColumn`, `getEntireCoords`, `getRandom` |
+ * | Evaluation lifecycle | `getRow`, `getColumn`, `getEntireCoords`, `getRandom` |
  * | Answering later | `defer` |
  * | Argument reflection | `getArgs` |
  * | Output hints | `formatResults` |
@@ -277,14 +277,6 @@ export interface IFormulaContext {
      * chosen one. When a range is returned every cell takes the same format.
      */
     formatResults(numFmt: string): void;
-    /**
-     * Marks this function as volatile, so it re-evaluates on every calculation.
-     *
-     * @remarks
-     * Call this when the result depends on something outside the arguments, such as the clock.
-     * A function can also be declared volatile in its registration instead.
-     */
-    markVolatile(): void;
     /**
      * Coerces a value to a serial date.
      *
@@ -468,15 +460,14 @@ export interface IFormulaContext {
      * @remarks
      * Always read the clock through this, never `Date.now()`. The time is fixed for the whole
      * calculation pass, so every cell in one pass agrees, collaborators evaluating the same
-     * workbook agree, and tests can pin it. Pair it with {@link markVolatile} so the function
+     * workbook agree, and tests can pin it. Pair it with `Volatile<T>` so the function
      * picks up a fresh time on the next pass.
      *
      * This is a calendar clock, not a stopwatch — use `performance.now()` to measure elapsed time.
      *
      * @example
      * ```typescript
-     * export function NOW(): number {
-     *   FormulaContext.markVolatile();
+     * export function NOW(): Volatile<number> {
      *   return FormulaContext.getNow();
      * }
      * ```
@@ -1044,7 +1035,7 @@ export declare namespace IFormulaContext {
          * @remarks
          * Valid for as long as the executor runs, across every `await`. The ambient `FormulaContext`
          * is not: it belongs to the cell being evaluated, and an executor runs after that evaluation
-         * ends. What needs a cell (`getRow`, `getReference`, `getValueAt`, `defer`, `markVolatile`,
+         * ends. What needs a cell (`getRow`, `getReference`, `getValueAt`, `defer`,
          * `formatResults`, `getRandom`) throws here; {@link getRandom} is the executor's own.
          */
         getFormulaContext(): IFormulaContext;