@ricsam/formula-engine 0.2.8 → 0.2.9

package/dist/types/core/engine.d.ts

@@ -2,7 +2,7 @@
  * Main FormulaEngine class
  * Core API implementation for spreadsheet calculations
  */
-import { type CellAddress, type CellStyle, type ConditionalStyle, type CopyCellsOptions, type DirectCellStyle, type FiniteSpreadsheetRange, type NamedExpression, type RangeAddress, type SerializedCellValue, type Sheet, type SingleEvaluationResult, type SpreadsheetRange, type SpreadsheetRangeEnd, type TableDefinition } from "./types";
+import { type CellAddress, type CellStyle, type ConditionalStyle, type CopyCellsOptions, type DirectCellStyle, type NamedExpression, type RangeAddress, type SerializedCellValue, type Sheet, type SingleEvaluationResult, type SpreadsheetRange, type SpreadsheetRangeEnd, type TableDefinition } from "./types";
 import type { FillDirection } from "@ricsam/selection-manager";
 import { AutoFill } from "./autofill-utils";
 import { WorkbookManager } from "./managers/workbook-manager";
@@ -12,12 +12,6 @@ import { EventManager } from "./managers/event-manager";
 import { EvaluationManager } from "./managers/evaluation-manager";
 import { DependencyManager } from "./managers/dependency-manager";
 import { StyleManager } from "./managers/style-manager";
-import type { Schema, CreateSchema, SchemaDeclaration } from "./schema/schema";
-import { TableOrm } from "./schema/table-orm";
-import { CellOrm } from "./schema/cell-orm";
-import { GridOrm } from "./schema/grid-orm";
-import type { TableSchemaHeaders } from "./managers/schema-manager";
-import { type EngineAction } from "./commands/types";
 type Metadata = {
     cell?: unknown;
     sheet?: unknown;
@@ -26,11 +20,9 @@ type Metadata = {
 type MetadataType<TMetadata extends Metadata, TKey extends keyof Metadata> = TMetadata[TKey];
 /**
  * Main FormulaEngine class
- * @template TCellMetadata - Consumer-defined type for cell metadata (rich text, links, custom data, etc.)
- * @template TSheetMetadata - Consumer-defined type for sheet metadata (text boxes, frozen panes, etc.)
- * @template TWorkbookMetadata - Consumer-defined type for workbook metadata (themes, document properties, etc.)
- */
-export declare class FormulaEngine<TMetadata extends Metadata = Metadata, TCreateSchema extends CreateSchema<MetadataType<TMetadata, "cell">, Schema, SchemaDeclaration> | undefined = undefined> {
+* @template TMetadata - Consumer-defined metadata shape with optional cell, sheet, and workbook entries.
+*/
+export declare class FormulaEngine<TMetadata extends Metadata = Metadata> {
     private workbookManager;
     private namedExpressionManager;
     private tableManager;
@@ -41,10 +33,6 @@ export declare class FormulaEngine<TMetadata extends Metadata = Metadata, TCreat
     private styleManager;
     private copyManager;
     private referenceManager;
-    private schemaManager;
-    private commandExecutor;
-    schema: TCreateSchema extends CreateSchema<MetadataType<TMetadata, "cell">, Schema, SchemaDeclaration> ? TCreateSchema["schema"] : undefined;
-    private schemaDeclaration;
     /**
      * Public access to the store manager for testing
      */
@@ -56,73 +44,17 @@ export declare class FormulaEngine<TMetadata extends Metadata = Metadata, TCreat
     _autoFillManager: AutoFill;
     _dependencyManager: DependencyManager;
     _styleManager: StyleManager;
-    constructor(schema?: TCreateSchema);
+    constructor();
     /**
      * Static factory method to build an empty engine
-     * @template TC - Consumer-defined cell metadata type
-     * @template TS - Consumer-defined sheet metadata type
-     * @template TW - Consumer-defined workbook metadata type
-     */
-    static buildEmpty<TMetadata extends Metadata = Metadata, TSchemaDeclaration extends CreateSchema<MetadataType<TMetadata, "cell">, any, any> | undefined = undefined>(schema?: TSchemaDeclaration): FormulaEngine<TMetadata, TSchemaDeclaration>;
-    /**
-     * Add a table schema at runtime
-     * @param namespace - Unique namespace for the schema
-     * @param address - Table address (workbookName and tableName)
-     * @param headers - Table headers with parse functions
-     * @returns The TableOrm instance for immediate use
-     */
-    addTableSchema<THeaders extends TableSchemaHeaders<MetadataType<TMetadata, "cell">>>(namespace: string, address: {
-        workbookName: string;
-        tableName: string;
-    }, headers: THeaders): TableOrm<{
-        [K in keyof THeaders]: ReturnType<THeaders[K]["parse"]>;
-    }>;
-    /**
-     * Add a cell schema at runtime
-     * @param namespace - Unique namespace for the schema
-     * @param cellAddress - Address of the cell
-     * @param parse - Parse function for the cell value
-     * @returns The CellOrm instance for immediate use
-     */
-    addCellSchema<TValue>(namespace: string, cellAddress: CellAddress, parse: (value: unknown, metadata: MetadataType<TMetadata, "cell">) => TValue, write?: (value: TValue) => {
-        value: SerializedCellValue;
-        metadata?: MetadataType<TMetadata, "cell">;
-    }): CellOrm<TValue>;
-    /**
-     * Add a grid schema at runtime
-     * @param namespace - Unique namespace for the schema
-     * @param address - Grid address (workbookName and sheetName)
-     * @param range - Finite range of cells for the grid
-     * @param parse - Parse function for the cell values
-     * @param write - Write function for serializing values (optional for primitive types)
-     * @returns The GridOrm instance for immediate use
-     */
-    addGridSchema<TValue>(namespace: string, address: {
-        workbookName: string;
-        sheetName: string;
-    }, range: FiniteSpreadsheetRange, parse: (value: unknown, metadata: MetadataType<TMetadata, "cell">) => TValue, write?: (value: TValue) => {
-        value: SerializedCellValue;
-        metadata?: MetadataType<TMetadata, "cell">;
-    }): GridOrm<TValue, MetadataType<TMetadata, "cell">>;
-    /**
-     * Remove a table schema at runtime.
-     * @param namespace - Namespace of the table schema to remove
-     * @returns true when a matching table schema was removed, false otherwise
-     */
-    removeTableSchema(namespace: string): boolean;
-    /**
-     * Remove a cell schema at runtime.
-     * @param namespace - Namespace of the cell schema to remove
-     * @returns true when a matching cell schema was removed, false otherwise
-     */
-    removeCellSchema(namespace: string): boolean;
-    /**
-     * Remove a grid schema at runtime.
-     * @param namespace - Namespace of the grid schema to remove
-     * @returns true when a matching grid schema was removed, false otherwise
-     */
-    removeGridSchema(namespace: string): boolean;
-    private removeSchemaOfType;
+     * @template TMetadata - Consumer-defined metadata shape with optional cell, sheet, and workbook entries.
+     */
+    static buildEmpty<TMetadata extends Metadata = Metadata>(): FormulaEngine<TMetadata>;
+    private emitMutation;
+    private emitUpdate;
+    private getExistingSheetContent;
+    private getWorkbookResourceKeys;
+    private getSheetResourceKeys;
     getCellEvaluationResult(cellAddress: CellAddress): SingleEvaluationResult | undefined;
     getCellValue(cellAddress: CellAddress, debug?: boolean): SerializedCellValue;
     /**
@@ -260,6 +192,7 @@ export declare class FormulaEngine<TMetadata extends Metadata = Metadata, TCreat
         tableName: string;
         workbookName: string;
     }): void;
+    private getAllTables;
     /**
      * Check if a table exists
      */
@@ -277,12 +210,6 @@ export declare class FormulaEngine<TMetadata extends Metadata = Metadata, TCreat
     resetTables(tables: Map<string, Map<string, TableDefinition>>): void;
     getTables(workbookName: string): Map<string, TableDefinition>;
     isCellInTable(cellAddress: CellAddress): TableDefinition | undefined;
-    /**
-     * Get all data cells in a table (excluding header row).
-     * Since spills cannot enter tables (they get #SPILL! error), this only
-     * needs to return cells with direct content.
-     */
-    private getTableDataCells;
     /**
      * Add a conditional style rule
      */
@@ -338,6 +265,9 @@ export declare class FormulaEngine<TMetadata extends Metadata = Metadata, TCreat
      * Adjusts existing style ranges rather than deleting them entirely
      */
     clearCellStyles(range: RangeAddress): void;
+    private getTopLeftCell;
+    private dedupeAddresses;
+    private getPasteTouchedAddresses;
     /**
      * Paste cells from source to target
      */
@@ -499,7 +429,6 @@ export declare class FormulaEngine<TMetadata extends Metadata = Metadata, TCreat
      * @param sheetName - The name of the sheet to set the content of
      * @param content - A map of cell addresses to their serialized values
      * @remarks This method is used to set the content of a sheet. It will re-evaluate all sheets to ensure all dependencies are resolved correctly.
-     * @throws SchemaIntegrityError if any evaluated cell value violates a schema constraint
      */
     setSheetContent(opts: {
         sheetName: string;
@@ -507,7 +436,6 @@ export declare class FormulaEngine<TMetadata extends Metadata = Metadata, TCreat
     }, content: Map<string, SerializedCellValue>): void;
     /**
      * Set the content of a single cell.
-     * @throws SchemaIntegrityError if the evaluated value violates a schema constraint
      */
     setCellContent(address: CellAddress, content: SerializedCellValue): void;
     /**
@@ -550,51 +478,5 @@ export declare class FormulaEngine<TMetadata extends Metadata = Metadata, TCreat
     private buildSerializedSnapshot;
     serializeEngine(): string;
     resetToSerializedEngine(data: string): void;
-    /**
-     * Undo the last command.
-     * @returns true if undo was performed, false if nothing to undo
-     */
-    undo(): boolean;
-    /**
-     * Redo the last undone command.
-     * @returns true if redo was performed, false if nothing to redo
-     */
-    redo(): boolean;
-    /**
-     * Check if undo is available.
-     */
-    canUndo(): boolean;
-    /**
-     * Check if redo is available.
-     */
-    canRedo(): boolean;
-    /**
-     * Get the action log for persistence/collaboration.
-     * Actions can be serialized and replayed to reconstruct state.
-     */
-    getActionLog(): EngineAction[];
-    /**
-     * Clear the action log.
-     */
-    clearActionLog(): void;
-    /**
-     * Clear undo/redo history.
-     */
-    clearHistory(): void;
-    /**
-     * Get dependencies for structure commands.
-     * @internal
-     */
-    private getStructureCommandDeps;
-    /**
-     * Get dependencies for table commands.
-     * @internal
-     */
-    private getTableCommandDeps;
-    /**
-     * Get dependencies for named expression commands.
-     * @internal
-     */
-    private getNamedExpressionCommandDeps;
 }
 export {};

package/dist/types/core/managers/dependency-manager.d.ts

@@ -12,7 +12,7 @@ import type { DependencyNode } from "./dependency-node";
 import { WorkbookManager } from "./workbook-manager";
 import { VirtualCellValueNode } from "../../evaluator/dependency-nodes/virtual-cell-value-node";
 import type { EvaluationManager } from "./evaluation-manager";
-import type { MutationInvalidation } from "../commands/types";
+import type { MutationInvalidation } from "../mutation-invalidation";
 import { ResourceDependencyNode } from "../../evaluator/dependency-nodes/resource-dependency-node";
 export interface DependencyTreeNode {
     type: "cell" | "range" | "empty";

package/dist/types/core/managers/evaluation-manager.d.ts

@@ -11,7 +11,7 @@ import type { TableManager } from "./table-manager";
 import type { DependencyNode } from "./dependency-node";
 import { VirtualCellValueNode } from "../../evaluator/dependency-nodes/virtual-cell-value-node";
 import type { NodeSnapshotId, SerializedEvaluateAllCellsResultSnapshot, SerializedFunctionEvaluationResultSnapshot, SerializedSingleEvaluationResultSnapshot, SerializedSpillMetaEvaluationResultSnapshot } from "../engine-snapshot";
-import type { MutationInvalidation } from "../commands/types";
+import type { MutationInvalidation } from "../mutation-invalidation";
 export declare class EvaluationManager {
     private workbookManager;
     private tableManager;

package/dist/types/core/mutation-invalidation.d.ts

@@ -0,0 +1,46 @@
+import type { WorkbookManager } from "./managers/workbook-manager";
+import type { CellAddress, RangeAddress, SerializedCellValue, TableDefinition } from "./types";
+type CellContentKind = "empty" | "scalar" | "formula";
+export type RemovedScope = {
+    type: "workbook";
+    workbookName: string;
+} | {
+    type: "sheet";
+    workbookName: string;
+    sheetName: string;
+};
+export type MutationInvalidation = {
+    touchedCells: Array<{
+        address: CellAddress;
+        beforeKind: CellContentKind;
+        afterKind: CellContentKind;
+    }>;
+    /**
+     * Cells whose table membership or implicit current-row table context changed
+     * without necessarily changing their formula text.
+     */
+    tableContextChangedCells?: CellAddress[];
+    resourceKeys: string[];
+    removedScopes?: RemovedScope[];
+};
+export declare function getMutationAddressKey(address: CellAddress): string;
+export declare function buildTouchedCells(cells: Array<{
+    address: CellAddress;
+    before: SerializedCellValue | undefined;
+    after: SerializedCellValue | undefined;
+}>): MutationInvalidation["touchedCells"];
+export declare function buildFormulaTouchedCells(cells: CellAddress[]): MutationInvalidation["touchedCells"];
+export declare function captureCellContents(workbookManager: WorkbookManager, addresses: CellAddress[]): Map<string, SerializedCellValue | undefined>;
+export declare function buildSheetContentTouchedCells(opts: {
+    workbookName: string;
+    sheetName: string;
+}, beforeContent: Map<string, SerializedCellValue> | undefined, afterContent: Map<string, SerializedCellValue>): MutationInvalidation["touchedCells"];
+export declare function buildTableTouchedCells(workbookManager: WorkbookManager, tables: Array<TableDefinition | undefined>): MutationInvalidation["touchedCells"];
+export declare function buildTableContextChangedCells(workbookManager: WorkbookManager, tables: Array<TableDefinition | undefined>): CellAddress[];
+export declare function mergeTouchedCells(...groups: MutationInvalidation["touchedCells"][]): MutationInvalidation["touchedCells"];
+export declare function getNamedExpressionScopeResourceKeys(expressions: Iterable<string>, opts: {
+    workbookName?: string;
+    sheetName?: string;
+}): string[];
+export declare function getFiniteRangeAddresses(address: RangeAddress): CellAddress[];
+export {};

package/dist/types/lib.d.ts

@@ -2,11 +2,3 @@ export { FormulaEngine } from "./core/engine";
 export * from "./core/types";
 export * from "./core/utils";
 export * from "./core/utils/color-utils";
-export { defineSchema, defineHeader } from "./core/schema/schema";
-export type { CreateSchema, SchemaDeclaration, Schema, TableSchemaDefinition, CellSchemaDefinition, TableOrmSchema, CellOrmSchema } from "./core/schema/schema";
-export { TableOrm } from "./core/schema/table-orm";
-export { CellOrm } from "./core/schema/cell-orm";
-export { SchemaValidationError } from "./core/managers/schema-manager";
-export type { ValidationResult } from "./core/managers/schema-manager";
-export { SchemaIntegrityError } from "./core/commands/command-executor";
-export type { EngineAction, EngineCommand } from "./core/commands/types";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/formula-engine",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "module": "./dist/mjs/lib.mjs",
   "scripts": {
     "test": "bun test",

package/dist/cjs/core/commands/command-executor.cjs

@@ -1,149 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-function __accessProp(key) {
-  return this[key];
-}
-var __toCommonJS = (from) => {
-  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (var key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(entry, key))
-        __defProp(entry, key, {
-          get: __accessProp.bind(from, key),
-          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-        });
-  }
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __moduleCache;
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-  this[name] = __returnValue.bind(null, newValue);
-}
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: __exportSetter.bind(all, name)
-    });
-};
-
-// src/core/commands/command-executor.ts
-var exports_command_executor = {};
-__export(exports_command_executor, {
-  SchemaIntegrityError: () => SchemaIntegrityError,
-  CommandExecutor: () => CommandExecutor
-});
-module.exports = __toCommonJS(exports_command_executor);
-var import_types = require("./types.cjs");
-
-class SchemaIntegrityError extends Error {
-  errors;
-  constructor(errors) {
-    const messages = errors.map((e) => e.message).join("; ");
-    super(`Schema integrity violation: ${messages}`);
-    this.errors = errors;
-    this.name = "SchemaIntegrityError";
-  }
-}
-
-class CommandExecutor {
-  evaluationManager;
-  eventManager;
-  validateAllSchemas;
-  undoStack = [];
-  redoStack = [];
-  actionLog = [];
-  constructor(evaluationManager, eventManager, validateAllSchemas) {
-    this.evaluationManager = evaluationManager;
-    this.eventManager = eventManager;
-    this.validateAllSchemas = validateAllSchemas;
-  }
-  execute(command, options = {}) {
-    const {
-      validate = false,
-      skipUndoStack = false,
-      skipEmitUpdate = false
-    } = options;
-    command.execute();
-    if (command.requiresReevaluation) {
-      this.evaluationManager.invalidateFromMutation(command.getInvalidationFootprint?.("execute") ?? import_types.emptyMutationInvalidation());
-      if (validate) {
-        const validation = this.validateAllSchemas();
-        if (!validation.valid) {
-          command.undo();
-          this.evaluationManager.invalidateFromMutation(command.getInvalidationFootprint?.("undo") ?? import_types.emptyMutationInvalidation());
-          throw new SchemaIntegrityError(validation.errors);
-        }
-      }
-    }
-    if (!skipUndoStack) {
-      this.undoStack.push(command);
-      this.redoStack = [];
-    }
-    const action = command.toAction();
-    action.timestamp = Date.now();
-    this.actionLog.push(action);
-    if (!skipEmitUpdate) {
-      this.eventManager.emitUpdate();
-    }
-  }
-  undo() {
-    const command = this.undoStack.pop();
-    if (!command) {
-      return false;
-    }
-    command.undo();
-    if (command.requiresReevaluation) {
-      this.evaluationManager.invalidateFromMutation(command.getInvalidationFootprint?.("undo") ?? import_types.emptyMutationInvalidation());
-    }
-    this.redoStack.push(command);
-    this.eventManager.emitUpdate();
-    return true;
-  }
-  redo() {
-    const command = this.redoStack.pop();
-    if (!command) {
-      return false;
-    }
-    command.execute();
-    if (command.requiresReevaluation) {
-      this.evaluationManager.invalidateFromMutation(command.getInvalidationFootprint?.("execute") ?? import_types.emptyMutationInvalidation());
-    }
-    this.undoStack.push(command);
-    this.eventManager.emitUpdate();
-    return true;
-  }
-  canUndo() {
-    return this.undoStack.length > 0;
-  }
-  canRedo() {
-    return this.redoStack.length > 0;
-  }
-  getActionLog() {
-    return [...this.actionLog];
-  }
-  clearActionLog() {
-    this.actionLog = [];
-  }
-  clearHistory() {
-    this.undoStack = [];
-    this.redoStack = [];
-  }
-  getUndoStackSize() {
-    return this.undoStack.length;
-  }
-  getRedoStackSize() {
-    return this.redoStack.length;
-  }
-}
-
-//# debugId=43DC9858A49109E564756E2164756E21

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

@@ -1,10 +0,0 @@
-{
-  "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.cjs\";\nimport type { FormulaEngine } from \"../engine.cjs\";\nimport type { EvaluationManager } from \"../managers/evaluation-manager.cjs\";\nimport type { EventManager } from \"../managers/event-manager.cjs\";\nimport type { CellAddress, SerializedCellValue } from \"../types.cjs\";\nimport type {\n  EngineCommand,\n  EngineAction,\n  ExecuteOptions,\n  SchemaValidationResult,\n  SchemaValidationErrorInfo,\n} from \"./types.cjs\";\nimport { emptyMutationInvalidation } from \"./types.cjs\";\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": "43DC9858A49109E564756E2164756E21",
-  "names": []
-}