@ricsam/formula-engine 0.0.16 → 0.0.18

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

@@ -0,0 +1,140 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// src/core/commands/command-executor.ts
+var exports_command_executor = {};
+__export(exports_command_executor, {
+  SchemaIntegrityError: () => SchemaIntegrityError,
+  CommandExecutor: () => CommandExecutor
+});
+module.exports = __toCommonJS(exports_command_executor);
+
+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 {
+  apiDeclaration;
+  evaluationManager;
+  eventManager;
+  validateAllSchemas;
+  undoStack = [];
+  redoStack = [];
+  actionLog = [];
+  constructor(apiDeclaration, evaluationManager, eventManager, validateAllSchemas) {
+    this.apiDeclaration = apiDeclaration;
+    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.clearEvaluationCache();
+      if (validate && this.apiDeclaration) {
+        const validation = this.validateAllSchemas();
+        if (!validation.valid) {
+          command.undo();
+          this.evaluationManager.clearEvaluationCache();
+          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.clearEvaluationCache();
+    }
+    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.clearEvaluationCache();
+    }
+    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=640E8B745969195364756E2164756E21

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

@@ -0,0 +1,10 @@
+{
+  "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 { Declaration } from \"../api/api.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\";\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 apiDeclaration: Declaration | undefined,\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 and API is defined\n      if (validate && this.apiDeclaration) {\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"
+  ],
+  "mappings": "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",
+  "debugId": "640E8B745969195364756E2164756E21",
+  "names": []
+}