@ricsam/formula-engine 0.2.1 → 0.2.3

package/dist/mjs/core/commands/command-executor.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/core/commands/command-executor.ts"],
   "sourcesContent": [
-    "/**\n * CommandExecutor - Executes commands with undo/redo support and schema validation\n *\n * Handles:\n * - Command execution with optional re-evaluation\n * - Schema validation after re-evaluation\n * - Automatic rollback on validation failure\n * - Undo/redo stacks\n * - Action serialization for persistence\n */\n\nimport type { SchemaDeclaration } from \"../schema/schema.mjs\";\nimport type { FormulaEngine } from \"../engine.mjs\";\nimport type { EvaluationManager } from \"../managers/evaluation-manager.mjs\";\nimport type { EventManager } from \"../managers/event-manager.mjs\";\nimport type { CellAddress, SerializedCellValue } from \"../types.mjs\";\nimport type {\n  EngineCommand,\n  EngineAction,\n  ExecuteOptions,\n  SchemaValidationResult,\n  SchemaValidationErrorInfo,\n} from \"./types.mjs\";\n\n/**\n * Error thrown when schema integrity validation fails.\n * Contains all validation errors that occurred.\n */\nexport class SchemaIntegrityError extends Error {\n  constructor(public errors: SchemaValidationErrorInfo[]) {\n    const messages = errors.map((e) => e.message).join(\"; \");\n    super(`Schema integrity violation: ${messages}`);\n    this.name = \"SchemaIntegrityError\";\n  }\n}\n\n/**\n * CommandExecutor manages command execution with validation and undo/redo support.\n */\nexport class CommandExecutor {\n  private undoStack: EngineCommand[] = [];\n  private redoStack: EngineCommand[] = [];\n  private actionLog: EngineAction[] = [];\n\n  constructor(\n    private evaluationManager: EvaluationManager,\n    private eventManager: EventManager,\n    private validateAllSchemas: () => SchemaValidationResult\n  ) {}\n\n  /**\n   * Execute a command with optional schema validation.\n   *\n   * @param command - The command to execute\n   * @param options - Execution options\n   * @throws SchemaIntegrityError if validation fails\n   */\n  execute(command: EngineCommand, options: ExecuteOptions = {}): void {\n    const {\n      validate = false,\n      skipUndoStack = false,\n      skipEmitUpdate = false,\n    } = options;\n\n    // Execute the command\n    command.execute();\n\n    // Re-evaluate if needed\n    if (command.requiresReevaluation) {\n      this.evaluationManager.clearEvaluationCache();\n\n      // Validate schemas if requested\n      if (validate) {\n        const validation = this.validateAllSchemas();\n\n        if (!validation.valid) {\n          // Rollback: undo the command and re-evaluate\n          command.undo();\n          this.evaluationManager.clearEvaluationCache();\n          throw new SchemaIntegrityError(validation.errors);\n        }\n      }\n    }\n\n    // Add to undo stack\n    if (!skipUndoStack) {\n      this.undoStack.push(command);\n      // Clear redo stack on new action\n      this.redoStack = [];\n    }\n\n    // Log the action\n    const action = command.toAction();\n    action.timestamp = Date.now();\n    this.actionLog.push(action);\n\n    // Emit update event\n    if (!skipEmitUpdate) {\n      this.eventManager.emitUpdate();\n    }\n  }\n\n  /**\n   * Undo the last command.\n   *\n   * @returns true if undo was performed, false if nothing to undo\n   */\n  undo(): boolean {\n    const command = this.undoStack.pop();\n    if (!command) {\n      return false;\n    }\n\n    command.undo();\n\n    if (command.requiresReevaluation) {\n      this.evaluationManager.clearEvaluationCache();\n    }\n\n    this.redoStack.push(command);\n    this.eventManager.emitUpdate();\n\n    return true;\n  }\n\n  /**\n   * Redo the last undone command.\n   *\n   * @returns true if redo was performed, false if nothing to redo\n   */\n  redo(): boolean {\n    const command = this.redoStack.pop();\n    if (!command) {\n      return false;\n    }\n\n    command.execute();\n\n    if (command.requiresReevaluation) {\n      this.evaluationManager.clearEvaluationCache();\n    }\n\n    this.undoStack.push(command);\n    this.eventManager.emitUpdate();\n\n    return true;\n  }\n\n  /**\n   * Check if undo is available.\n   */\n  canUndo(): boolean {\n    return this.undoStack.length > 0;\n  }\n\n  /**\n   * Check if redo is available.\n   */\n  canRedo(): boolean {\n    return this.redoStack.length > 0;\n  }\n\n  /**\n   * Get the action log for persistence/collaboration.\n   */\n  getActionLog(): EngineAction[] {\n    return [...this.actionLog];\n  }\n\n  /**\n   * Clear the action log.\n   */\n  clearActionLog(): void {\n    this.actionLog = [];\n  }\n\n  /**\n   * Clear undo/redo stacks.\n   */\n  clearHistory(): void {\n    this.undoStack = [];\n    this.redoStack = [];\n  }\n\n  /**\n   * Get the number of commands in the undo stack.\n   */\n  getUndoStackSize(): number {\n    return this.undoStack.length;\n  }\n\n  /**\n   * Get the number of commands in the redo stack.\n   */\n  getRedoStackSize(): number {\n    return this.redoStack.length;\n  }\n}\n"
+    "/**\n * CommandExecutor - Executes commands with undo/redo support and schema validation\n *\n * Handles:\n * - Command execution with optional re-evaluation\n * - Schema validation after re-evaluation\n * - Automatic rollback on validation failure\n * - Undo/redo stacks\n * - Action serialization for persistence\n */\n\nimport type { SchemaDeclaration } from \"../schema/schema.mjs\";\nimport type { FormulaEngine } from \"../engine.mjs\";\nimport type { EvaluationManager } from \"../managers/evaluation-manager.mjs\";\nimport type { EventManager } from \"../managers/event-manager.mjs\";\nimport type { CellAddress, SerializedCellValue } from \"../types.mjs\";\nimport type {\n  EngineCommand,\n  EngineAction,\n  ExecuteOptions,\n  SchemaValidationResult,\n  SchemaValidationErrorInfo,\n} from \"./types.mjs\";\nimport { emptyMutationInvalidation } from \"./types.mjs\";\n\n/**\n * Error thrown when schema integrity validation fails.\n * Contains all validation errors that occurred.\n */\nexport class SchemaIntegrityError extends Error {\n  constructor(public errors: SchemaValidationErrorInfo[]) {\n    const messages = errors.map((e) => e.message).join(\"; \");\n    super(`Schema integrity violation: ${messages}`);\n    this.name = \"SchemaIntegrityError\";\n  }\n}\n\n/**\n * CommandExecutor manages command execution with validation and undo/redo support.\n */\nexport class CommandExecutor {\n  private undoStack: EngineCommand[] = [];\n  private redoStack: EngineCommand[] = [];\n  private actionLog: EngineAction[] = [];\n\n  constructor(\n    private evaluationManager: EvaluationManager,\n    private eventManager: EventManager,\n    private validateAllSchemas: () => SchemaValidationResult\n  ) {}\n\n  /**\n   * Execute a command with optional schema validation.\n   *\n   * @param command - The command to execute\n   * @param options - Execution options\n   * @throws SchemaIntegrityError if validation fails\n   */\n  execute(command: EngineCommand, options: ExecuteOptions = {}): void {\n    const {\n      validate = false,\n      skipUndoStack = false,\n      skipEmitUpdate = false,\n    } = options;\n\n    // Execute the command\n    command.execute();\n\n    // Re-evaluate if needed\n    if (command.requiresReevaluation) {\n      this.evaluationManager.invalidateFromMutation(\n        command.getInvalidationFootprint?.(\"execute\") ??\n          emptyMutationInvalidation()\n      );\n\n      // Validate schemas if requested\n      if (validate) {\n        const validation = this.validateAllSchemas();\n\n        if (!validation.valid) {\n          // Rollback: undo the command and re-evaluate\n          command.undo();\n          this.evaluationManager.invalidateFromMutation(\n            command.getInvalidationFootprint?.(\"undo\") ??\n              emptyMutationInvalidation()\n          );\n          throw new SchemaIntegrityError(validation.errors);\n        }\n      }\n    }\n\n    // Add to undo stack\n    if (!skipUndoStack) {\n      this.undoStack.push(command);\n      // Clear redo stack on new action\n      this.redoStack = [];\n    }\n\n    // Log the action\n    const action = command.toAction();\n    action.timestamp = Date.now();\n    this.actionLog.push(action);\n\n    // Emit update event\n    if (!skipEmitUpdate) {\n      this.eventManager.emitUpdate();\n    }\n  }\n\n  /**\n   * Undo the last command.\n   *\n   * @returns true if undo was performed, false if nothing to undo\n   */\n  undo(): boolean {\n    const command = this.undoStack.pop();\n    if (!command) {\n      return false;\n    }\n\n    command.undo();\n\n    if (command.requiresReevaluation) {\n      this.evaluationManager.invalidateFromMutation(\n        command.getInvalidationFootprint?.(\"undo\") ??\n          emptyMutationInvalidation()\n      );\n    }\n\n    this.redoStack.push(command);\n    this.eventManager.emitUpdate();\n\n    return true;\n  }\n\n  /**\n   * Redo the last undone command.\n   *\n   * @returns true if redo was performed, false if nothing to redo\n   */\n  redo(): boolean {\n    const command = this.redoStack.pop();\n    if (!command) {\n      return false;\n    }\n\n    command.execute();\n\n    if (command.requiresReevaluation) {\n      this.evaluationManager.invalidateFromMutation(\n        command.getInvalidationFootprint?.(\"execute\") ??\n          emptyMutationInvalidation()\n      );\n    }\n\n    this.undoStack.push(command);\n    this.eventManager.emitUpdate();\n\n    return true;\n  }\n\n  /**\n   * Check if undo is available.\n   */\n  canUndo(): boolean {\n    return this.undoStack.length > 0;\n  }\n\n  /**\n   * Check if redo is available.\n   */\n  canRedo(): boolean {\n    return this.redoStack.length > 0;\n  }\n\n  /**\n   * Get the action log for persistence/collaboration.\n   */\n  getActionLog(): EngineAction[] {\n    return [...this.actionLog];\n  }\n\n  /**\n   * Clear the action log.\n   */\n  clearActionLog(): void {\n    this.actionLog = [];\n  }\n\n  /**\n   * Clear undo/redo stacks.\n   */\n  clearHistory(): void {\n    this.undoStack = [];\n    this.redoStack = [];\n  }\n\n  /**\n   * Get the number of commands in the undo stack.\n   */\n  getUndoStackSize(): number {\n    return this.undoStack.length;\n  }\n\n  /**\n   * Get the number of commands in the redo stack.\n   */\n  getRedoStackSize(): number {\n    return this.redoStack.length;\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "383A6EB14F8F793264756E2164756E21",
+  "mappings": "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",
+  "debugId": "B70925EB1761ED8F64756E2164756E21",
   "names": []
 }

package/dist/mjs/core/commands/content-commands.mjs

@@ -1,6 +1,31 @@
 // src/core/commands/content-commands.ts
-import { ActionTypes } from "./types.mjs";
+import {
+  ActionTypes,
+  emptyMutationInvalidation,
+  getSerializedCellValueKind
+} from "./types.mjs";
 import { getCellReference, parseCellReference } from "../utils.mjs";
+function buildTouchedCells(cells) {
+  const deduped = new Map;
+  for (const cell of cells) {
+    deduped.set(`${cell.address.workbookName}:${cell.address.sheetName}:${getCellReference(cell.address)}`, {
+      address: cell.address,
+      beforeKind: getSerializedCellValueKind(cell.before),
+      afterKind: getSerializedCellValueKind(cell.after)
+    });
+  }
+  return Array.from(deduped.values());
+}
+function getAddressKey(address) {
+  return `${address.workbookName}:${address.sheetName}:${getCellReference(address)}`;
+}
+function captureCellContents(workbookManager, addresses) {
+  const contents = new Map;
+  for (const address of addresses) {
+    contents.set(getAddressKey(address), workbookManager.getCellContent(address));
+  }
+  return contents;
+}
 
 class SetCellContentCommand {
   workbookManager;
@@ -9,6 +34,8 @@ class SetCellContentCommand {
   requiresReevaluation = true;
   previousValue;
   hadPreviousValue = false;
+  executeFootprint = emptyMutationInvalidation();
+  undoFootprint = emptyMutationInvalidation();
   constructor(workbookManager, address, newContent) {
     this.workbookManager = workbookManager;
     this.address = address;
@@ -25,6 +52,26 @@ class SetCellContentCommand {
       this.previousValue = sheet.content.get(key);
     }
     this.workbookManager.setCellContent(this.address, this.newContent);
+    this.executeFootprint = {
+      touchedCells: buildTouchedCells([
+        {
+          address: this.address,
+          before: this.previousValue,
+          after: this.newContent
+        }
+      ]),
+      resourceKeys: []
+    };
+    this.undoFootprint = {
+      touchedCells: buildTouchedCells([
+        {
+          address: this.address,
+          before: this.newContent,
+          after: this.hadPreviousValue ? this.previousValue : undefined
+        }
+      ]),
+      resourceKeys: []
+    };
   }
   undo() {
     if (this.hadPreviousValue) {
@@ -33,6 +80,9 @@ class SetCellContentCommand {
       this.workbookManager.setCellContent(this.address, undefined);
     }
   }
+  getInvalidationFootprint(phase) {
+    return phase === "execute" ? this.executeFootprint : this.undoFootprint;
+  }
   toAction() {
     return {
       type: ActionTypes.SET_CELL_CONTENT,
@@ -50,6 +100,8 @@ class SetSheetContentCommand {
   newContent;
   requiresReevaluation = true;
   previousContent;
+  executeFootprint = emptyMutationInvalidation();
+  undoFootprint = emptyMutationInvalidation();
   constructor(workbookManager, opts, newContent) {
     this.workbookManager = workbookManager;
     this.opts = opts;
@@ -61,12 +113,44 @@ class SetSheetContentCommand {
       this.previousContent = new Map(sheet.content);
     }
     this.workbookManager.setSheetContent(this.opts, this.newContent);
+    const touchedKeys = new Set([
+      ...Array.from(this.previousContent?.keys() ?? []),
+      ...Array.from(this.newContent.keys())
+    ]);
+    const touchedCells = buildTouchedCells(Array.from(touchedKeys, (key) => ({
+      address: {
+        workbookName: this.opts.workbookName,
+        sheetName: this.opts.sheetName,
+        ...parseCellReference(key)
+      },
+      before: this.previousContent?.get(key),
+      after: this.newContent.get(key)
+    })));
+    this.executeFootprint = {
+      touchedCells,
+      resourceKeys: []
+    };
+    this.undoFootprint = {
+      touchedCells: buildTouchedCells(Array.from(touchedKeys, (key) => ({
+        address: {
+          workbookName: this.opts.workbookName,
+          sheetName: this.opts.sheetName,
+          ...parseCellReference(key)
+        },
+        before: this.newContent.get(key),
+        after: this.previousContent?.get(key)
+      }))),
+      resourceKeys: []
+    };
   }
   undo() {
     if (this.previousContent) {
       this.workbookManager.setSheetContent(this.opts, this.previousContent);
     }
   }
+  getInvalidationFootprint(phase) {
+    return phase === "execute" ? this.executeFootprint : this.undoFootprint;
+  }
   toAction() {
     return {
       type: ActionTypes.SET_SHEET_CONTENT,
@@ -83,11 +167,14 @@ class ClearRangeCommand {
   address;
   requiresReevaluation = true;
   clearedCells = new Map;
+  executeFootprint = emptyMutationInvalidation();
+  undoFootprint = emptyMutationInvalidation();
   constructor(workbookManager, address) {
     this.workbookManager = workbookManager;
     this.address = address;
   }
   execute() {
+    this.clearedCells.clear();
     try {
       for (const cellAddress of this.workbookManager.iterateCellsInRange(this.address)) {
         const key = getCellReference(cellAddress);
@@ -98,6 +185,30 @@ class ClearRangeCommand {
       }
     } catch {}
     this.workbookManager.clearSpreadsheetRange(this.address);
+    this.executeFootprint = {
+      touchedCells: buildTouchedCells(Array.from(this.clearedCells.entries(), ([key, before]) => ({
+        address: {
+          workbookName: this.address.workbookName,
+          sheetName: this.address.sheetName,
+          ...parseCellReference(key)
+        },
+        before,
+        after: undefined
+      }))),
+      resourceKeys: []
+    };
+    this.undoFootprint = {
+      touchedCells: buildTouchedCells(Array.from(this.clearedCells.entries(), ([key, after]) => ({
+        address: {
+          workbookName: this.address.workbookName,
+          sheetName: this.address.sheetName,
+          ...parseCellReference(key)
+        },
+        before: undefined,
+        after
+      }))),
+      resourceKeys: []
+    };
   }
   undo() {
     for (const [key, value] of this.clearedCells) {
@@ -110,6 +221,9 @@ class ClearRangeCommand {
       }, value);
     }
   }
+  getInvalidationFootprint(phase) {
+    return phase === "execute" ? this.executeFootprint : this.undoFootprint;
+  }
   toAction() {
     return {
       type: ActionTypes.CLEAR_RANGE,
@@ -129,6 +243,9 @@ class PasteCellsCommand {
   requiresReevaluation = true;
   targetSnapshots = [];
   sourceSnapshots = [];
+  executeFootprint = emptyMutationInvalidation();
+  undoFootprint = emptyMutationInvalidation();
+  executedContents = new Map;
   constructor(workbookManager, copyManager, source, target, options) {
     this.workbookManager = workbookManager;
     this.copyManager = copyManager;
@@ -137,6 +254,9 @@ class PasteCellsCommand {
     this.options = options;
   }
   execute() {
+    this.targetSnapshots = [];
+    this.sourceSnapshots = [];
+    this.executedContents.clear();
     if (this.source.length > 0) {
       const firstSource = this.source[0];
       const colOffset = this.target.colIndex - firstSource.colIndex;
@@ -179,6 +299,22 @@ class PasteCellsCommand {
       }
     }
     this.copyManager.pasteCells(this.source, this.target, this.options);
+    const touchedAddresses = [
+      ...this.targetSnapshots.map((snapshot) => snapshot.address),
+      ...this.sourceSnapshots.map((snapshot) => snapshot.address)
+    ];
+    this.executedContents = captureCellContents(this.workbookManager, touchedAddresses);
+    this.executeFootprint = {
+      touchedCells: buildTouchedCells(touchedAddresses.map((address) => {
+        const beforeSnapshot = this.targetSnapshots.find((snapshot) => snapshot.address.workbookName === address.workbookName && snapshot.address.sheetName === address.sheetName && snapshot.address.colIndex === address.colIndex && snapshot.address.rowIndex === address.rowIndex) ?? this.sourceSnapshots.find((snapshot) => snapshot.address.workbookName === address.workbookName && snapshot.address.sheetName === address.sheetName && snapshot.address.colIndex === address.colIndex && snapshot.address.rowIndex === address.rowIndex);
+        return {
+          address,
+          before: beforeSnapshot?.content,
+          after: this.executedContents.get(getAddressKey(address))
+        };
+      })),
+      resourceKeys: []
+    };
   }
   undo() {
     for (const snapshot of this.targetSnapshots) {
@@ -195,6 +331,23 @@ class PasteCellsCommand {
         }
       }
     }
+    const touchedAddresses = [
+      ...this.targetSnapshots.map((snapshot) => snapshot.address),
+      ...this.sourceSnapshots.map((snapshot) => snapshot.address)
+    ];
+    this.undoFootprint = {
+      touchedCells: buildTouchedCells(touchedAddresses.map((address) => {
+        return {
+          address,
+          before: this.executedContents.get(getAddressKey(address)),
+          after: this.workbookManager.getCellContent(address)
+        };
+      })),
+      resourceKeys: []
+    };
+  }
+  getInvalidationFootprint(phase) {
+    return phase === "execute" ? this.executeFootprint : this.undoFootprint;
   }
   toAction() {
     return {
@@ -216,6 +369,9 @@ class FillAreasCommand {
   options;
   requiresReevaluation = true;
   targetSnapshots = new Map;
+  executeFootprint = emptyMutationInvalidation();
+  undoFootprint = emptyMutationInvalidation();
+  executedContents = new Map;
   constructor(workbookManager, copyManager, seedRange, targetRanges, options) {
     this.workbookManager = workbookManager;
     this.copyManager = copyManager;
@@ -224,6 +380,8 @@ class FillAreasCommand {
     this.options = options;
   }
   execute() {
+    this.targetSnapshots.clear();
+    this.executedContents.clear();
     for (const targetRange of this.targetRanges) {
       const sheet = this.workbookManager.getSheet({
         workbookName: targetRange.workbookName,
@@ -255,6 +413,16 @@ class FillAreasCommand {
       }
     }
     this.copyManager.fillAreas(this.seedRange, this.targetRanges, this.options);
+    const touchedAddresses = Array.from(this.targetSnapshots.values()).map((snapshot) => snapshot.address);
+    this.executedContents = captureCellContents(this.workbookManager, touchedAddresses);
+    this.executeFootprint = {
+      touchedCells: buildTouchedCells(touchedAddresses.map((address) => ({
+        address,
+        before: this.targetSnapshots.get(getAddressKey(address))?.content,
+        after: this.executedContents.get(getAddressKey(address))
+      }))),
+      resourceKeys: []
+    };
   }
   undo() {
     for (const snapshot of this.targetSnapshots.values()) {
@@ -263,6 +431,18 @@ class FillAreasCommand {
         this.workbookManager.setCellMetadata(snapshot.address, snapshot.metadata);
       }
     }
+    const touchedAddresses = Array.from(this.targetSnapshots.values()).map((snapshot) => snapshot.address);
+    this.undoFootprint = {
+      touchedCells: buildTouchedCells(touchedAddresses.map((address) => ({
+        address,
+        before: this.executedContents.get(getAddressKey(address)),
+        after: this.workbookManager.getCellContent(address)
+      }))),
+      resourceKeys: []
+    };
+  }
+  getInvalidationFootprint(phase) {
+    return phase === "execute" ? this.executeFootprint : this.undoFootprint;
   }
   toAction() {
     return {
@@ -284,6 +464,9 @@ class MoveCellCommand {
   requiresReevaluation = true;
   sourceSnapshot;
   targetSnapshot;
+  executeFootprint = emptyMutationInvalidation();
+  undoFootprint = emptyMutationInvalidation();
+  executedContents = new Map;
   constructor(workbookManager, copyManager, source, target) {
     this.workbookManager = workbookManager;
     this.copyManager = copyManager;
@@ -291,6 +474,9 @@ class MoveCellCommand {
     this.target = target;
   }
   execute() {
+    this.sourceSnapshot = undefined;
+    this.targetSnapshot = undefined;
+    this.executedContents.clear();
     const sourceSheet = this.workbookManager.getSheet({
       workbookName: this.source.workbookName,
       sheetName: this.source.sheetName
@@ -320,6 +506,16 @@ class MoveCellCommand {
       type: "formula",
       include: "all"
     });
+    const touchedAddresses = [this.source, this.target];
+    this.executedContents = captureCellContents(this.workbookManager, touchedAddresses);
+    this.executeFootprint = {
+      touchedCells: buildTouchedCells(touchedAddresses.map((address) => ({
+        address,
+        before: this.sourceSnapshot?.address === address ? this.sourceSnapshot.content : this.targetSnapshot?.content,
+        after: this.executedContents.get(getAddressKey(address))
+      }))),
+      resourceKeys: []
+    };
   }
   undo() {
     if (this.sourceSnapshot) {
@@ -334,6 +530,18 @@ class MoveCellCommand {
         this.workbookManager.setCellMetadata(this.targetSnapshot.address, this.targetSnapshot.metadata);
       }
     }
+    const touchedAddresses = [this.source, this.target];
+    this.undoFootprint = {
+      touchedCells: buildTouchedCells(touchedAddresses.map((address) => ({
+        address,
+        before: this.executedContents.get(getAddressKey(address)),
+        after: this.workbookManager.getCellContent(address)
+      }))),
+      resourceKeys: []
+    };
+  }
+  getInvalidationFootprint(phase) {
+    return phase === "execute" ? this.executeFootprint : this.undoFootprint;
   }
   toAction() {
     return {
@@ -354,6 +562,9 @@ class MoveRangeCommand {
   requiresReevaluation = true;
   sourceSnapshots = [];
   targetSnapshots = [];
+  executeFootprint = emptyMutationInvalidation();
+  undoFootprint = emptyMutationInvalidation();
+  executedContents = new Map;
   constructor(workbookManager, copyManager, sourceRange, target) {
     this.workbookManager = workbookManager;
     this.copyManager = copyManager;
@@ -361,6 +572,9 @@ class MoveRangeCommand {
     this.target = target;
   }
   execute() {
+    this.sourceSnapshots = [];
+    this.targetSnapshots = [];
+    this.executedContents.clear();
     const sourceCells = this.copyManager.expandRangeToCells(this.sourceRange);
     for (const cell of sourceCells) {
       const sheet = this.workbookManager.getSheet({
@@ -406,6 +620,22 @@ class MoveRangeCommand {
       type: "formula",
       include: "all"
     });
+    const touchedAddresses = [
+      ...this.sourceSnapshots.map((snapshot) => snapshot.address),
+      ...this.targetSnapshots.map((snapshot) => snapshot.address)
+    ];
+    this.executedContents = captureCellContents(this.workbookManager, touchedAddresses);
+    this.executeFootprint = {
+      touchedCells: buildTouchedCells(touchedAddresses.map((address) => {
+        const snapshot = this.sourceSnapshots.find((candidate) => getAddressKey(candidate.address) === getAddressKey(address)) ?? this.targetSnapshots.find((candidate) => getAddressKey(candidate.address) === getAddressKey(address));
+        return {
+          address,
+          before: snapshot?.content,
+          after: this.executedContents.get(getAddressKey(address))
+        };
+      })),
+      resourceKeys: []
+    };
   }
   undo() {
     for (const snapshot of this.sourceSnapshots) {
@@ -420,6 +650,21 @@ class MoveRangeCommand {
         this.workbookManager.setCellMetadata(snapshot.address, snapshot.metadata);
       }
     }
+    const touchedAddresses = [
+      ...this.sourceSnapshots.map((snapshot) => snapshot.address),
+      ...this.targetSnapshots.map((snapshot) => snapshot.address)
+    ];
+    this.undoFootprint = {
+      touchedCells: buildTouchedCells(touchedAddresses.map((address) => ({
+        address,
+        before: this.executedContents.get(getAddressKey(address)),
+        after: this.workbookManager.getCellContent(address)
+      }))),
+      resourceKeys: []
+    };
+  }
+  getInvalidationFootprint(phase) {
+    return phase === "execute" ? this.executeFootprint : this.undoFootprint;
   }
   toAction() {
     return {
@@ -443,6 +688,10 @@ class AutoFillCommand {
   requiresReevaluation = true;
   previousContent = new Map;
   previousMetadata = new Map;
+  executeFootprint = emptyMutationInvalidation();
+  undoFootprint = emptyMutationInvalidation();
+  touchedAddresses = [];
+  executedContents = new Map;
   constructor(workbookManager, styleManager, autoFillManager, opts, seedRange, fillRanges, direction) {
     this.workbookManager = workbookManager;
     this.styleManager = styleManager;
@@ -453,6 +702,10 @@ class AutoFillCommand {
     this.direction = direction;
   }
   execute() {
+    this.previousContent.clear();
+    this.previousMetadata.clear();
+    this.touchedAddresses = [];
+    this.executedContents.clear();
     for (const fillRange of this.fillRanges) {
       if (fillRange.end.col.type === "infinity" || fillRange.end.row.type === "infinity") {
         continue;
@@ -470,6 +723,7 @@ class AutoFillCommand {
             colIndex: col,
             rowIndex: row
           };
+          this.touchedAddresses.push(address);
           const content = this.workbookManager.getCellContent(address);
           if (content !== undefined) {
             this.previousContent.set(key, content);
@@ -482,6 +736,18 @@ class AutoFillCommand {
       }
     }
     this.autoFillManager.fill(this.opts, this.seedRange, this.fillRanges, this.direction);
+    this.executedContents = captureCellContents(this.workbookManager, this.touchedAddresses);
+    this.executeFootprint = {
+      touchedCells: buildTouchedCells(this.touchedAddresses.map((address) => {
+        const key = getCellReference(address);
+        return {
+          address,
+          before: this.previousContent.get(key),
+          after: this.executedContents.get(getAddressKey(address))
+        };
+      })),
+      resourceKeys: []
+    };
   }
   undo() {
     const currentContent = this.workbookManager.getSheetSerialized(this.opts);
@@ -517,6 +783,17 @@ class AutoFillCommand {
       }
     }
     this.workbookManager.setSheetContent(this.opts, newContent);
+    this.undoFootprint = {
+      touchedCells: buildTouchedCells(this.touchedAddresses.map((address) => ({
+        address,
+        before: this.executedContents.get(getAddressKey(address)),
+        after: this.workbookManager.getCellContent(address)
+      }))),
+      resourceKeys: []
+    };
+  }
+  getInvalidationFootprint(phase) {
+    return phase === "execute" ? this.executeFootprint : this.undoFootprint;
   }
   toAction() {
     return {
@@ -541,4 +818,4 @@ export {
   AutoFillCommand
 };
 
-//# debugId=D1EC078DEF90C73764756E2164756E21
+//# debugId=827AAF04E7067A3964756E2164756E21