@ricsam/formula-engine 0.2.8 → 0.2.10

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 ReplaceChange, type ReplaceTarget, type SearchMatch, type SearchOptions, 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
      */
@@ -482,6 +412,20 @@ export declare class FormulaEngine<TMetadata extends Metadata = Metadata, TCreat
         sheetName: string;
         workbookName: string;
     }): Map<string, SerializedCellValue>;
+    /**
+     * Search raw stored string content without evaluating cell values.
+     */
+    search(query: string, options?: SearchOptions): SearchMatch[];
+    /**
+     * Replace one specific search occurrence inside one addressed cell.
+     */
+    replace(query: string, replacement: string, target: ReplaceTarget, options?: {
+        caseSensitive?: boolean;
+    }): ReplaceChange;
+    /**
+     * Replace all matching raw string occurrences within the requested scope.
+     */
+    replaceAll(query: string, replacement: string, options?: SearchOptions): ReplaceChange[];
     addWorkbook(workbookName: string): void;
     removeWorkbook(workbookName: string): void;
     /**
@@ -499,7 +443,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 +450,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 +492,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";
@@ -59,6 +59,10 @@ export declare class DependencyManager {
     private coverageWatchersBySheet;
     private frontierWatchersBySheet;
     constructor(cacheManager: CacheManager, workbookManager: WorkbookManager);
+    private getSnapshotEligibilityState;
+    private logSnapshotRestoreWarning;
+    private getLogicalNodeSnapshotId;
+    private resetRestoredNodeToColdState;
     private getSheetWatcherKey;
     private addReverseEdge;
     private removeReverseEdge;

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/managers/workbook-manager.d.ts

@@ -1,4 +1,4 @@
-import { type CellAddress, type SerializedCellValue, type Sheet, type Workbook } from "../types";
+import { type CellAddress, type ReplaceChange, type ReplaceTarget, type SearchMatch, type SearchOptions, type SerializedCellValue, type Sheet, type Workbook } from "../types";
 import type { WorkbookManagerSnapshot } from "../engine-snapshot";
 import type { RangeAddress } from "../types";
 interface IndexEntry {
@@ -11,6 +11,18 @@ export interface SheetIndexes {
     cellsSortedByRow: IndexEntry[];
     cellsSortedByCol: IndexEntry[];
 }
+type PreparedReplace = {
+    address: CellAddress;
+    beforeContent: string;
+    afterContent: string;
+    change: ReplaceChange;
+};
+type PreparedCellReplaceAll = {
+    address: CellAddress;
+    beforeContent: string;
+    afterContent: string;
+    changes: ReplaceChange[];
+};
 /**
  * Utility class for binary search operations on IndexEntry arrays
  */
@@ -84,6 +96,16 @@ export declare class WorkbookManager {
         workbookName: string;
         sheetName: string;
     }): Map<string, SerializedCellValue>;
+    private resolveSearchScope;
+    private getStringContentKind;
+    private findMatchesInString;
+    private buildSearchMatchesInScope;
+    search(query: string, options?: SearchOptions): SearchMatch[];
+    private buildReplacedContent;
+    prepareReplace(query: string, replacement: string, target: ReplaceTarget, options?: {
+        caseSensitive?: boolean;
+    }): PreparedReplace;
+    prepareReplaceAll(query: string, replacement: string, options?: SearchOptions): PreparedCellReplaceAll[];
     /**
      * Add a cell to the grouped indexes
      */

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/core/types.d.ts

@@ -80,6 +80,41 @@ export type CellValue = CellNumber | CellString | CellBoolean | CellInfinity;
  * any empty values are deleted from the sheet content
  */
 export type SerializedCellValue = string | number | boolean | undefined;
+export interface SearchOptions {
+    workbookName?: string;
+    sheetName?: string;
+    caseSensitive?: boolean;
+}
+export interface SearchMatch {
+    workbookName: string;
+    sheetName: string;
+    cellReference: string;
+    cellContent: string;
+    contentKind: "formula" | "text";
+    occurrenceIndex: number;
+    startIndex: number;
+    endIndexExclusive: number;
+    matchedText: string;
+}
+export interface ReplaceTarget {
+    workbookName: string;
+    sheetName: string;
+    cellReference: string;
+    occurrenceIndex: number;
+}
+export interface ReplaceChange {
+    workbookName: string;
+    sheetName: string;
+    cellReference: string;
+    contentKind: "formula" | "text";
+    occurrenceIndex: number;
+    startIndex: number;
+    endIndexExclusive: number;
+    matchedText: string;
+    replacementText: string;
+    beforeContent: string;
+    afterContent: string;
+}
 export interface NamedExpression {
     name: string;
     expression: string;

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/dist/types/parser/parser.d.ts

@@ -21,13 +21,15 @@ export declare class Parser {
     private input;
     constructor(tokens: Token[], input?: string);
     /**
-     * Look ahead to determine if this is a workbook reference [Workbook]Sheet
+     * Look ahead to determine if this is a workbook reference like
+     * [Workbook]!Table[...] or [Workbook]Sheet...
      */
     private lookAheadForWorkbookReference;
     /**
-     * Parse workbook reference like [Workbook]Sheet or [Workbook]Sheet!A1
+     * Parse workbook reference like [Workbook]!Table[Column] or [Workbook]Sheet!A1
      */
     private parseWorkbookReference;
+    private parseWorkbookQualifiedTableReference;
     /**
      * Parse bare column reference like [Column] or [Column1:Column2]
      */
@@ -136,10 +138,6 @@ export declare class Parser {
      * Parse a range reference with workbook name
      */
     private parseRangeWithWorkbook;
-    /**
-     * Parse table reference with workbook and sheet name
-     */
-    private parseTableReferenceWithWorkbookAndSheet;
     /**
      * Parse a range reference (including infinite ranges)
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/formula-engine",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "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": []
-}