@ricsam/formula-engine 0.2.1 → 0.2.3

package/dist/cjs/core/commands/table-commands.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/core/commands/table-commands.ts"],
   "sourcesContent": [
-    "/**\n * Table Commands - Commands that modify table definitions\n *\n * These commands all require re-evaluation after execution.\n */\n\nimport type { TableManager } from \"../managers/table-manager.cjs\";\nimport type { NamedExpressionManager } from \"../managers/named-expression-manager.cjs\";\nimport type { WorkbookManager } from \"../managers/workbook-manager.cjs\";\nimport type { SchemaManager } from \"../managers/schema-manager.cjs\";\nimport type {\n  CellAddress,\n  SerializedCellValue,\n  SpreadsheetRangeEnd,\n  TableDefinition,\n} from \"../types.cjs\";\nimport type { EngineCommand, EngineAction } from \"./types.cjs\";\nimport { ActionTypes } from \"./types.cjs\";\n\n/**\n * Dependencies needed for table commands.\n */\nexport interface TableCommandDeps {\n  tableManager: TableManager;\n  namedExpressionManager: NamedExpressionManager;\n  workbookManager: WorkbookManager;\n  apiSchemaManager: SchemaManager;\n  getCellValue: (cellAddress: CellAddress) => SerializedCellValue;\n  renameTableInFormula: (\n    formula: string,\n    oldName: string,\n    newName: string\n  ) => string;\n}\n\n/**\n * Command to add a table.\n */\nexport class AddTableCommand implements EngineCommand {\n  readonly requiresReevaluation = true;\n\n  constructor(\n    private deps: TableCommandDeps,\n    private props: {\n      tableName: string;\n      sheetName: string;\n      workbookName: string;\n      start: string;\n      numRows: SpreadsheetRangeEnd;\n      numCols: number;\n    }\n  ) {}\n\n  execute(): void {\n    this.deps.tableManager.addTable({\n      ...this.props,\n      getCellValue: this.deps.getCellValue,\n    });\n  }\n\n  undo(): void {\n    this.deps.tableManager.removeTable({\n      workbookName: this.props.workbookName,\n      tableName: this.props.tableName,\n    });\n  }\n\n  toAction(): EngineAction {\n    return {\n      type: ActionTypes.ADD_TABLE,\n      payload: this.props,\n    };\n  }\n}\n\n/**\n * Command to remove a table.\n */\nexport class RemoveTableCommand implements EngineCommand {\n  readonly requiresReevaluation = true;\n  private removedTable: TableDefinition | undefined;\n\n  constructor(\n    private deps: TableCommandDeps,\n    private opts: { tableName: string; workbookName: string }\n  ) {}\n\n  execute(): void {\n    // Capture table before removal\n    this.removedTable = this.deps.tableManager.getTable({\n      workbookName: this.opts.workbookName,\n      name: this.opts.tableName,\n    });\n\n    this.deps.tableManager.removeTable(this.opts);\n  }\n\n  undo(): void {\n    if (!this.removedTable) return;\n\n    // Recreate the table\n    const { start, endRow, headers, sheetName } = this.removedTable;\n    const startRef = `${String.fromCharCode(65 + start.colIndex)}${start.rowIndex + 1}`;\n\n    this.deps.tableManager.addTable({\n      workbookName: this.opts.workbookName,\n      tableName: this.opts.tableName,\n      sheetName,\n      start: startRef,\n      numRows: endRow,\n      numCols: headers.size,\n      getCellValue: this.deps.getCellValue,\n    });\n  }\n\n  toAction(): EngineAction {\n    return {\n      type: ActionTypes.REMOVE_TABLE,\n      payload: this.opts,\n    };\n  }\n}\n\n/**\n * Command to rename a table.\n */\nexport class RenameTableCommand implements EngineCommand {\n  readonly requiresReevaluation = true;\n\n  constructor(\n    private deps: TableCommandDeps,\n    private workbookName: string,\n    private oldName: string,\n    private newName: string\n  ) {}\n\n  execute(): void {\n    this.deps.tableManager.renameTable(this.workbookName, {\n      oldName: this.oldName,\n      newName: this.newName,\n    });\n\n    // Update formulas in sheet cells\n    this.deps.workbookManager.updateAllFormulas((formula) =>\n      this.deps.renameTableInFormula(formula, this.oldName, this.newName)\n    );\n\n    // Update named expressions\n    this.deps.namedExpressionManager.updateAllNamedExpressions((formula) =>\n      this.deps.renameTableInFormula(formula, this.oldName, this.newName)\n    );\n\n    // Update API schemas\n    this.deps.apiSchemaManager.updateForTableRename(\n      this.workbookName,\n      this.oldName,\n      this.newName\n    );\n  }\n\n  undo(): void {\n    // Rename back\n    this.deps.tableManager.renameTable(this.workbookName, {\n      oldName: this.newName,\n      newName: this.oldName,\n    });\n\n    // Update formulas back\n    this.deps.workbookManager.updateAllFormulas((formula) =>\n      this.deps.renameTableInFormula(formula, this.newName, this.oldName)\n    );\n\n    // Update named expressions back\n    this.deps.namedExpressionManager.updateAllNamedExpressions((formula) =>\n      this.deps.renameTableInFormula(formula, this.newName, this.oldName)\n    );\n\n    // Update API schemas back\n    this.deps.apiSchemaManager.updateForTableRename(\n      this.workbookName,\n      this.newName,\n      this.oldName\n    );\n  }\n\n  toAction(): EngineAction {\n    return {\n      type: ActionTypes.RENAME_TABLE,\n      payload: {\n        workbookName: this.workbookName,\n        oldName: this.oldName,\n        newName: this.newName,\n      },\n    };\n  }\n}\n\n/**\n * Command to update a table.\n */\nexport class UpdateTableCommand implements EngineCommand {\n  readonly requiresReevaluation = true;\n  private previousTable: TableDefinition | undefined;\n\n  constructor(\n    private deps: TableCommandDeps,\n    private opts: {\n      tableName: string;\n      sheetName?: string;\n      start?: string;\n      numRows?: SpreadsheetRangeEnd;\n      numCols?: number;\n      workbookName: string;\n    }\n  ) {}\n\n  execute(): void {\n    // Capture previous table state\n    this.previousTable = this.deps.tableManager.getTable({\n      workbookName: this.opts.workbookName,\n      name: this.opts.tableName,\n    });\n\n    this.deps.tableManager.updateTable({\n      ...this.opts,\n      getCellValue: this.deps.getCellValue,\n    });\n  }\n\n  undo(): void {\n    if (!this.previousTable) return;\n\n    // Restore previous table state\n    const { start, endRow, headers, sheetName } = this.previousTable;\n    const startRef = `${String.fromCharCode(65 + start.colIndex)}${start.rowIndex + 1}`;\n\n    this.deps.tableManager.updateTable({\n      workbookName: this.opts.workbookName,\n      tableName: this.opts.tableName,\n      sheetName,\n      start: startRef,\n      numRows: endRow,\n      numCols: headers.size,\n      getCellValue: this.deps.getCellValue,\n    });\n  }\n\n  toAction(): EngineAction {\n    return {\n      type: ActionTypes.UPDATE_TABLE,\n      payload: this.opts,\n    };\n  }\n}\n\n/**\n * Command to reset all tables.\n */\nexport class ResetTablesCommand implements EngineCommand {\n  readonly requiresReevaluation = true;\n  private previousTables: Map<string, Map<string, TableDefinition>> | undefined;\n\n  constructor(\n    private deps: TableCommandDeps,\n    private newTables: Map<string, Map<string, TableDefinition>>\n  ) {}\n\n  execute(): void {\n    // Capture previous tables\n    this.previousTables = new Map();\n    for (const [workbookName, tables] of this.deps.tableManager.tables) {\n      this.previousTables.set(workbookName, new Map(tables));\n    }\n\n    this.deps.tableManager.resetTables(this.newTables);\n  }\n\n  undo(): void {\n    if (!this.previousTables) return;\n    this.deps.tableManager.resetTables(this.previousTables);\n  }\n\n  toAction(): EngineAction {\n    return {\n      type: ActionTypes.RESET_TABLES,\n      payload: {\n        tables: Array.from(this.newTables.entries()).map(([wb, tables]) => [\n          wb,\n          Array.from(tables.entries()),\n        ]),\n      },\n    };\n  }\n}\n\n"
+    "/**\n * Table Commands - Commands that modify table definitions\n *\n * These commands all require re-evaluation after execution.\n */\n\nimport type { TableManager } from \"../managers/table-manager.cjs\";\nimport type { NamedExpressionManager } from \"../managers/named-expression-manager.cjs\";\nimport type { WorkbookManager } from \"../managers/workbook-manager.cjs\";\nimport type { SchemaManager } from \"../managers/schema-manager.cjs\";\nimport type {\n  CellAddress,\n  SerializedCellValue,\n  SpreadsheetRangeEnd,\n  TableDefinition,\n} from \"../types.cjs\";\nimport type {\n  EngineCommand,\n  EngineAction,\n  MutationInvalidation,\n} from \"./types.cjs\";\nimport { ActionTypes, emptyMutationInvalidation } from \"./types.cjs\";\nimport { getTableResourceKey } from \"../resource-keys.cjs\";\n\n/**\n * Dependencies needed for table commands.\n */\nexport interface TableCommandDeps {\n  tableManager: TableManager;\n  namedExpressionManager: NamedExpressionManager;\n  workbookManager: WorkbookManager;\n  apiSchemaManager: SchemaManager;\n  getCellValue: (cellAddress: CellAddress) => SerializedCellValue;\n  renameTableInFormula: (\n    formula: string,\n    oldName: string,\n    newName: string\n  ) => string;\n}\n\n/**\n * Command to add a table.\n */\nexport class AddTableCommand implements EngineCommand {\n  readonly requiresReevaluation = true;\n  private executeFootprint = emptyMutationInvalidation();\n  private undoFootprint = emptyMutationInvalidation();\n\n  constructor(\n    private deps: TableCommandDeps,\n    private props: {\n      tableName: string;\n      sheetName: string;\n      workbookName: string;\n      start: string;\n      numRows: SpreadsheetRangeEnd;\n      numCols: number;\n    }\n  ) {}\n\n  execute(): void {\n    this.deps.tableManager.addTable({\n      ...this.props,\n      getCellValue: this.deps.getCellValue,\n    });\n    const resourceKey = getTableResourceKey({\n      workbookName: this.props.workbookName,\n      tableName: this.props.tableName,\n    });\n    this.executeFootprint = {\n      touchedCells: [],\n      resourceKeys: [resourceKey],\n    };\n    this.undoFootprint = this.executeFootprint;\n  }\n\n  undo(): void {\n    this.deps.tableManager.removeTable({\n      workbookName: this.props.workbookName,\n      tableName: this.props.tableName,\n    });\n  }\n\n  getInvalidationFootprint(phase: \"execute\" | \"undo\"): MutationInvalidation {\n    return phase === \"execute\" ? this.executeFootprint : this.undoFootprint;\n  }\n\n  toAction(): EngineAction {\n    return {\n      type: ActionTypes.ADD_TABLE,\n      payload: this.props,\n    };\n  }\n}\n\n/**\n * Command to remove a table.\n */\nexport class RemoveTableCommand implements EngineCommand {\n  readonly requiresReevaluation = true;\n  private removedTable: TableDefinition | undefined;\n  private executeFootprint = emptyMutationInvalidation();\n  private undoFootprint = emptyMutationInvalidation();\n\n  constructor(\n    private deps: TableCommandDeps,\n    private opts: { tableName: string; workbookName: string }\n  ) {}\n\n  execute(): void {\n    // Capture table before removal\n    this.removedTable = this.deps.tableManager.getTable({\n      workbookName: this.opts.workbookName,\n      name: this.opts.tableName,\n    });\n\n    this.deps.tableManager.removeTable(this.opts);\n    const resourceKey = getTableResourceKey({\n      workbookName: this.opts.workbookName,\n      tableName: this.opts.tableName,\n    });\n    this.executeFootprint = {\n      touchedCells: [],\n      resourceKeys: [resourceKey],\n    };\n    this.undoFootprint = this.executeFootprint;\n  }\n\n  undo(): void {\n    if (!this.removedTable) return;\n\n    // Recreate the table\n    const { start, endRow, headers, sheetName } = this.removedTable;\n    const startRef = `${String.fromCharCode(65 + start.colIndex)}${start.rowIndex + 1}`;\n\n    this.deps.tableManager.addTable({\n      workbookName: this.opts.workbookName,\n      tableName: this.opts.tableName,\n      sheetName,\n      start: startRef,\n      numRows: endRow,\n      numCols: headers.size,\n      getCellValue: this.deps.getCellValue,\n    });\n  }\n\n  getInvalidationFootprint(phase: \"execute\" | \"undo\"): MutationInvalidation {\n    return phase === \"execute\" ? this.executeFootprint : this.undoFootprint;\n  }\n\n  toAction(): EngineAction {\n    return {\n      type: ActionTypes.REMOVE_TABLE,\n      payload: this.opts,\n    };\n  }\n}\n\n/**\n * Command to rename a table.\n */\nexport class RenameTableCommand implements EngineCommand {\n  readonly requiresReevaluation = true;\n  private executeFootprint = emptyMutationInvalidation();\n  private undoFootprint = emptyMutationInvalidation();\n\n  constructor(\n    private deps: TableCommandDeps,\n    private workbookName: string,\n    private oldName: string,\n    private newName: string\n  ) {}\n\n  execute(): void {\n    this.deps.tableManager.renameTable(this.workbookName, {\n      oldName: this.oldName,\n      newName: this.newName,\n    });\n\n    // Update formulas in sheet cells\n    const changedCells = this.deps.workbookManager.updateAllFormulas((formula) =>\n      this.deps.renameTableInFormula(formula, this.oldName, this.newName)\n    );\n\n    // Update named expressions\n    const changedNamedExpressions =\n      this.deps.namedExpressionManager.updateAllNamedExpressions((formula) =>\n      this.deps.renameTableInFormula(formula, this.oldName, this.newName)\n    );\n\n    // Update API schemas\n    this.deps.apiSchemaManager.updateForTableRename(\n      this.workbookName,\n      this.oldName,\n      this.newName\n    );\n\n    this.executeFootprint = {\n      touchedCells: changedCells.map((address) => ({\n        address,\n        beforeKind: \"formula\" as const,\n        afterKind: \"formula\" as const,\n      })),\n      resourceKeys: [\n        getTableResourceKey({\n          workbookName: this.workbookName,\n          tableName: this.oldName,\n        }),\n        getTableResourceKey({\n          workbookName: this.workbookName,\n          tableName: this.newName,\n        }),\n        ...changedNamedExpressions,\n      ],\n    };\n  }\n\n  undo(): void {\n    // Rename back\n    this.deps.tableManager.renameTable(this.workbookName, {\n      oldName: this.newName,\n      newName: this.oldName,\n    });\n\n    // Update formulas back\n    const changedCells = this.deps.workbookManager.updateAllFormulas((formula) =>\n      this.deps.renameTableInFormula(formula, this.newName, this.oldName)\n    );\n\n    // Update named expressions back\n    const changedNamedExpressions =\n      this.deps.namedExpressionManager.updateAllNamedExpressions((formula) =>\n      this.deps.renameTableInFormula(formula, this.newName, this.oldName)\n    );\n\n    // Update API schemas back\n    this.deps.apiSchemaManager.updateForTableRename(\n      this.workbookName,\n      this.newName,\n      this.oldName\n    );\n\n    this.undoFootprint = {\n      touchedCells: changedCells.map((address) => ({\n        address,\n        beforeKind: \"formula\" as const,\n        afterKind: \"formula\" as const,\n      })),\n      resourceKeys: [\n        getTableResourceKey({\n          workbookName: this.workbookName,\n          tableName: this.oldName,\n        }),\n        getTableResourceKey({\n          workbookName: this.workbookName,\n          tableName: this.newName,\n        }),\n        ...changedNamedExpressions,\n      ],\n    };\n  }\n\n  getInvalidationFootprint(phase: \"execute\" | \"undo\"): MutationInvalidation {\n    return phase === \"execute\" ? this.executeFootprint : this.undoFootprint;\n  }\n\n  toAction(): EngineAction {\n    return {\n      type: ActionTypes.RENAME_TABLE,\n      payload: {\n        workbookName: this.workbookName,\n        oldName: this.oldName,\n        newName: this.newName,\n      },\n    };\n  }\n}\n\n/**\n * Command to update a table.\n */\nexport class UpdateTableCommand implements EngineCommand {\n  readonly requiresReevaluation = true;\n  private previousTable: TableDefinition | undefined;\n  private executeFootprint = emptyMutationInvalidation();\n  private undoFootprint = emptyMutationInvalidation();\n\n  constructor(\n    private deps: TableCommandDeps,\n    private opts: {\n      tableName: string;\n      sheetName?: string;\n      start?: string;\n      numRows?: SpreadsheetRangeEnd;\n      numCols?: number;\n      workbookName: string;\n    }\n  ) {}\n\n  execute(): void {\n    // Capture previous table state\n    this.previousTable = this.deps.tableManager.getTable({\n      workbookName: this.opts.workbookName,\n      name: this.opts.tableName,\n    });\n\n    this.deps.tableManager.updateTable({\n      ...this.opts,\n      getCellValue: this.deps.getCellValue,\n    });\n    const resourceKey = getTableResourceKey({\n      workbookName: this.opts.workbookName,\n      tableName: this.opts.tableName,\n    });\n    this.executeFootprint = {\n      touchedCells: [],\n      resourceKeys: [resourceKey],\n    };\n    this.undoFootprint = this.executeFootprint;\n  }\n\n  undo(): void {\n    if (!this.previousTable) return;\n\n    // Restore previous table state\n    const { start, endRow, headers, sheetName } = this.previousTable;\n    const startRef = `${String.fromCharCode(65 + start.colIndex)}${start.rowIndex + 1}`;\n\n    this.deps.tableManager.updateTable({\n      workbookName: this.opts.workbookName,\n      tableName: this.opts.tableName,\n      sheetName,\n      start: startRef,\n      numRows: endRow,\n      numCols: headers.size,\n      getCellValue: this.deps.getCellValue,\n    });\n  }\n\n  getInvalidationFootprint(phase: \"execute\" | \"undo\"): MutationInvalidation {\n    return phase === \"execute\" ? this.executeFootprint : this.undoFootprint;\n  }\n\n  toAction(): EngineAction {\n    return {\n      type: ActionTypes.UPDATE_TABLE,\n      payload: this.opts,\n    };\n  }\n}\n\n/**\n * Command to reset all tables.\n */\nexport class ResetTablesCommand implements EngineCommand {\n  readonly requiresReevaluation = true;\n  private previousTables: Map<string, Map<string, TableDefinition>> | undefined;\n  private executeFootprint = emptyMutationInvalidation();\n  private undoFootprint = emptyMutationInvalidation();\n\n  constructor(\n    private deps: TableCommandDeps,\n    private newTables: Map<string, Map<string, TableDefinition>>\n  ) {}\n\n  execute(): void {\n    // Capture previous tables\n    this.previousTables = new Map();\n    for (const [workbookName, tables] of this.deps.tableManager.tables) {\n      this.previousTables.set(workbookName, new Map(tables));\n    }\n\n    this.deps.tableManager.resetTables(this.newTables);\n    const resourceKeys = new Set<string>();\n    for (const [workbookName, tables] of this.previousTables ?? []) {\n      for (const tableName of tables.keys()) {\n        resourceKeys.add(\n          getTableResourceKey({\n            workbookName,\n            tableName,\n          })\n        );\n      }\n    }\n    for (const [workbookName, tables] of this.newTables) {\n      for (const tableName of tables.keys()) {\n        resourceKeys.add(\n          getTableResourceKey({\n            workbookName,\n            tableName,\n          })\n        );\n      }\n    }\n    this.executeFootprint = {\n      touchedCells: [],\n      resourceKeys: Array.from(resourceKeys),\n    };\n    this.undoFootprint = this.executeFootprint;\n  }\n\n  undo(): void {\n    if (!this.previousTables) return;\n    this.deps.tableManager.resetTables(this.previousTables);\n  }\n\n  getInvalidationFootprint(phase: \"execute\" | \"undo\"): MutationInvalidation {\n    return phase === \"execute\" ? this.executeFootprint : this.undoFootprint;\n  }\n\n  toAction(): EngineAction {\n    return {\n      type: ActionTypes.RESET_TABLES,\n      payload: {\n        tables: Array.from(this.newTables.entries()).map(([wb, tables]) => [\n          wb,\n          Array.from(tables.entries()),\n        ]),\n      },\n    };\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "9756D299A175406A64756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBuD,IAAvD;AACoC,IAApC;AAAA;AAqBO,MAAM,gBAAyC;AAAA,EAM1C;AAAA,EACA;AAAA,EAND,uBAAuB;AAAA,EACxB,mBAAmB,uCAA0B;AAAA,EAC7C,gBAAgB,uCAA0B;AAAA,EAElD,WAAW,CACD,MACA,OAQR;AAAA,IATQ;AAAA,IACA;AAAA;AAAA,EAUV,OAAO,GAAS;AAAA,IACd,KAAK,KAAK,aAAa,SAAS;AAAA,SAC3B,KAAK;AAAA,MACR,cAAc,KAAK,KAAK;AAAA,IAC1B,CAAC;AAAA,IACD,MAAM,cAAc,yCAAoB;AAAA,MACtC,cAAc,KAAK,MAAM;AAAA,MACzB,WAAW,KAAK,MAAM;AAAA,IACxB,CAAC;AAAA,IACD,KAAK,mBAAmB;AAAA,MACtB,cAAc,CAAC;AAAA,MACf,cAAc,CAAC,WAAW;AAAA,IAC5B;AAAA,IACA,KAAK,gBAAgB,KAAK;AAAA;AAAA,EAG5B,IAAI,GAAS;AAAA,IACX,KAAK,KAAK,aAAa,YAAY;AAAA,MACjC,cAAc,KAAK,MAAM;AAAA,MACzB,WAAW,KAAK,MAAM;AAAA,IACxB,CAAC;AAAA;AAAA,EAGH,wBAAwB,CAAC,OAAiD;AAAA,IACxE,OAAO,UAAU,YAAY,KAAK,mBAAmB,KAAK;AAAA;AAAA,EAG5D,QAAQ,GAAiB;AAAA,IACvB,OAAO;AAAA,MACL,MAAM,yBAAY;AAAA,MAClB,SAAS,KAAK;AAAA,IAChB;AAAA;AAEJ;AAAA;AAKO,MAAM,mBAA4C;AAAA,EAO7C;AAAA,EACA;AAAA,EAPD,uBAAuB;AAAA,EACxB;AAAA,EACA,mBAAmB,uCAA0B;AAAA,EAC7C,gBAAgB,uCAA0B;AAAA,EAElD,WAAW,CACD,MACA,MACR;AAAA,IAFQ;AAAA,IACA;AAAA;AAAA,EAGV,OAAO,GAAS;AAAA,IAEd,KAAK,eAAe,KAAK,KAAK,aAAa,SAAS;AAAA,MAClD,cAAc,KAAK,KAAK;AAAA,MACxB,MAAM,KAAK,KAAK;AAAA,IAClB,CAAC;AAAA,IAED,KAAK,KAAK,aAAa,YAAY,KAAK,IAAI;AAAA,IAC5C,MAAM,cAAc,yCAAoB;AAAA,MACtC,cAAc,KAAK,KAAK;AAAA,MACxB,WAAW,KAAK,KAAK;AAAA,IACvB,CAAC;AAAA,IACD,KAAK,mBAAmB;AAAA,MACtB,cAAc,CAAC;AAAA,MACf,cAAc,CAAC,WAAW;AAAA,IAC5B;AAAA,IACA,KAAK,gBAAgB,KAAK;AAAA;AAAA,EAG5B,IAAI,GAAS;AAAA,IACX,IAAI,CAAC,KAAK;AAAA,MAAc;AAAA,IAGxB,QAAQ,OAAO,QAAQ,SAAS,cAAc,KAAK;AAAA,IACnD,MAAM,WAAW,GAAG,OAAO,aAAa,KAAK,MAAM,QAAQ,IAAI,MAAM,WAAW;AAAA,IAEhF,KAAK,KAAK,aAAa,SAAS;AAAA,MAC9B,cAAc,KAAK,KAAK;AAAA,MACxB,WAAW,KAAK,KAAK;AAAA,MACrB;AAAA,MACA,OAAO;AAAA,MACP,SAAS;AAAA,MACT,SAAS,QAAQ;AAAA,MACjB,cAAc,KAAK,KAAK;AAAA,IAC1B,CAAC;AAAA;AAAA,EAGH,wBAAwB,CAAC,OAAiD;AAAA,IACxE,OAAO,UAAU,YAAY,KAAK,mBAAmB,KAAK;AAAA;AAAA,EAG5D,QAAQ,GAAiB;AAAA,IACvB,OAAO;AAAA,MACL,MAAM,yBAAY;AAAA,MAClB,SAAS,KAAK;AAAA,IAChB;AAAA;AAEJ;AAAA;AAKO,MAAM,mBAA4C;AAAA,EAM7C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EARD,uBAAuB;AAAA,EACxB,mBAAmB,uCAA0B;AAAA,EAC7C,gBAAgB,uCAA0B;AAAA,EAElD,WAAW,CACD,MACA,cACA,SACA,SACR;AAAA,IAJQ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA;AAAA,EAGV,OAAO,GAAS;AAAA,IACd,KAAK,KAAK,aAAa,YAAY,KAAK,cAAc;AAAA,MACpD,SAAS,KAAK;AAAA,MACd,SAAS,KAAK;AAAA,IAChB,CAAC;AAAA,IAGD,MAAM,eAAe,KAAK,KAAK,gBAAgB,kBAAkB,CAAC,YAChE,KAAK,KAAK,qBAAqB,SAAS,KAAK,SAAS,KAAK,OAAO,CACpE;AAAA,IAGA,MAAM,0BACJ,KAAK,KAAK,uBAAuB,0BAA0B,CAAC,YAC5D,KAAK,KAAK,qBAAqB,SAAS,KAAK,SAAS,KAAK,OAAO,CACpE;AAAA,IAGA,KAAK,KAAK,iBAAiB,qBACzB,KAAK,cACL,KAAK,SACL,KAAK,OACP;AAAA,IAEA,KAAK,mBAAmB;AAAA,MACtB,cAAc,aAAa,IAAI,CAAC,aAAa;AAAA,QAC3C;AAAA,QACA,YAAY;AAAA,QACZ,WAAW;AAAA,MACb,EAAE;AAAA,MACF,cAAc;AAAA,QACZ,yCAAoB;AAAA,UAClB,cAAc,KAAK;AAAA,UACnB,WAAW,KAAK;AAAA,QAClB,CAAC;AAAA,QACD,yCAAoB;AAAA,UAClB,cAAc,KAAK;AAAA,UACnB,WAAW,KAAK;AAAA,QAClB,CAAC;AAAA,QACD,GAAG;AAAA,MACL;AAAA,IACF;AAAA;AAAA,EAGF,IAAI,GAAS;AAAA,IAEX,KAAK,KAAK,aAAa,YAAY,KAAK,cAAc;AAAA,MACpD,SAAS,KAAK;AAAA,MACd,SAAS,KAAK;AAAA,IAChB,CAAC;AAAA,IAGD,MAAM,eAAe,KAAK,KAAK,gBAAgB,kBAAkB,CAAC,YAChE,KAAK,KAAK,qBAAqB,SAAS,KAAK,SAAS,KAAK,OAAO,CACpE;AAAA,IAGA,MAAM,0BACJ,KAAK,KAAK,uBAAuB,0BAA0B,CAAC,YAC5D,KAAK,KAAK,qBAAqB,SAAS,KAAK,SAAS,KAAK,OAAO,CACpE;AAAA,IAGA,KAAK,KAAK,iBAAiB,qBACzB,KAAK,cACL,KAAK,SACL,KAAK,OACP;AAAA,IAEA,KAAK,gBAAgB;AAAA,MACnB,cAAc,aAAa,IAAI,CAAC,aAAa;AAAA,QAC3C;AAAA,QACA,YAAY;AAAA,QACZ,WAAW;AAAA,MACb,EAAE;AAAA,MACF,cAAc;AAAA,QACZ,yCAAoB;AAAA,UAClB,cAAc,KAAK;AAAA,UACnB,WAAW,KAAK;AAAA,QAClB,CAAC;AAAA,QACD,yCAAoB;AAAA,UAClB,cAAc,KAAK;AAAA,UACnB,WAAW,KAAK;AAAA,QAClB,CAAC;AAAA,QACD,GAAG;AAAA,MACL;AAAA,IACF;AAAA;AAAA,EAGF,wBAAwB,CAAC,OAAiD;AAAA,IACxE,OAAO,UAAU,YAAY,KAAK,mBAAmB,KAAK;AAAA;AAAA,EAG5D,QAAQ,GAAiB;AAAA,IACvB,OAAO;AAAA,MACL,MAAM,yBAAY;AAAA,MAClB,SAAS;AAAA,QACP,cAAc,KAAK;AAAA,QACnB,SAAS,KAAK;AAAA,QACd,SAAS,KAAK;AAAA,MAChB;AAAA,IACF;AAAA;AAEJ;AAAA;AAKO,MAAM,mBAA4C;AAAA,EAO7C;AAAA,EACA;AAAA,EAPD,uBAAuB;AAAA,EACxB;AAAA,EACA,mBAAmB,uCAA0B;AAAA,EAC7C,gBAAgB,uCAA0B;AAAA,EAElD,WAAW,CACD,MACA,MAQR;AAAA,IATQ;AAAA,IACA;AAAA;AAAA,EAUV,OAAO,GAAS;AAAA,IAEd,KAAK,gBAAgB,KAAK,KAAK,aAAa,SAAS;AAAA,MACnD,cAAc,KAAK,KAAK;AAAA,MACxB,MAAM,KAAK,KAAK;AAAA,IAClB,CAAC;AAAA,IAED,KAAK,KAAK,aAAa,YAAY;AAAA,SAC9B,KAAK;AAAA,MACR,cAAc,KAAK,KAAK;AAAA,IAC1B,CAAC;AAAA,IACD,MAAM,cAAc,yCAAoB;AAAA,MACtC,cAAc,KAAK,KAAK;AAAA,MACxB,WAAW,KAAK,KAAK;AAAA,IACvB,CAAC;AAAA,IACD,KAAK,mBAAmB;AAAA,MACtB,cAAc,CAAC;AAAA,MACf,cAAc,CAAC,WAAW;AAAA,IAC5B;AAAA,IACA,KAAK,gBAAgB,KAAK;AAAA;AAAA,EAG5B,IAAI,GAAS;AAAA,IACX,IAAI,CAAC,KAAK;AAAA,MAAe;AAAA,IAGzB,QAAQ,OAAO,QAAQ,SAAS,cAAc,KAAK;AAAA,IACnD,MAAM,WAAW,GAAG,OAAO,aAAa,KAAK,MAAM,QAAQ,IAAI,MAAM,WAAW;AAAA,IAEhF,KAAK,KAAK,aAAa,YAAY;AAAA,MACjC,cAAc,KAAK,KAAK;AAAA,MACxB,WAAW,KAAK,KAAK;AAAA,MACrB;AAAA,MACA,OAAO;AAAA,MACP,SAAS;AAAA,MACT,SAAS,QAAQ;AAAA,MACjB,cAAc,KAAK,KAAK;AAAA,IAC1B,CAAC;AAAA;AAAA,EAGH,wBAAwB,CAAC,OAAiD;AAAA,IACxE,OAAO,UAAU,YAAY,KAAK,mBAAmB,KAAK;AAAA;AAAA,EAG5D,QAAQ,GAAiB;AAAA,IACvB,OAAO;AAAA,MACL,MAAM,yBAAY;AAAA,MAClB,SAAS,KAAK;AAAA,IAChB;AAAA;AAEJ;AAAA;AAKO,MAAM,mBAA4C;AAAA,EAO7C;AAAA,EACA;AAAA,EAPD,uBAAuB;AAAA,EACxB;AAAA,EACA,mBAAmB,uCAA0B;AAAA,EAC7C,gBAAgB,uCAA0B;AAAA,EAElD,WAAW,CACD,MACA,WACR;AAAA,IAFQ;AAAA,IACA;AAAA;AAAA,EAGV,OAAO,GAAS;AAAA,IAEd,KAAK,iBAAiB,IAAI;AAAA,IAC1B,YAAY,cAAc,WAAW,KAAK,KAAK,aAAa,QAAQ;AAAA,MAClE,KAAK,eAAe,IAAI,cAAc,IAAI,IAAI,MAAM,CAAC;AAAA,IACvD;AAAA,IAEA,KAAK,KAAK,aAAa,YAAY,KAAK,SAAS;AAAA,IACjD,MAAM,eAAe,IAAI;AAAA,IACzB,YAAY,cAAc,WAAW,KAAK,kBAAkB,CAAC,GAAG;AAAA,MAC9D,WAAW,aAAa,OAAO,KAAK,GAAG;AAAA,QACrC,aAAa,IACX,yCAAoB;AAAA,UAClB;AAAA,UACA;AAAA,QACF,CAAC,CACH;AAAA,MACF;AAAA,IACF;AAAA,IACA,YAAY,cAAc,WAAW,KAAK,WAAW;AAAA,MACnD,WAAW,aAAa,OAAO,KAAK,GAAG;AAAA,QACrC,aAAa,IACX,yCAAoB;AAAA,UAClB;AAAA,UACA;AAAA,QACF,CAAC,CACH;AAAA,MACF;AAAA,IACF;AAAA,IACA,KAAK,mBAAmB;AAAA,MACtB,cAAc,CAAC;AAAA,MACf,cAAc,MAAM,KAAK,YAAY;AAAA,IACvC;AAAA,IACA,KAAK,gBAAgB,KAAK;AAAA;AAAA,EAG5B,IAAI,GAAS;AAAA,IACX,IAAI,CAAC,KAAK;AAAA,MAAgB;AAAA,IAC1B,KAAK,KAAK,aAAa,YAAY,KAAK,cAAc;AAAA;AAAA,EAGxD,wBAAwB,CAAC,OAAiD;AAAA,IACxE,OAAO,UAAU,YAAY,KAAK,mBAAmB,KAAK;AAAA;AAAA,EAG5D,QAAQ,GAAiB;AAAA,IACvB,OAAO;AAAA,MACL,MAAM,yBAAY;AAAA,MAClB,SAAS;AAAA,QACP,QAAQ,MAAM,KAAK,KAAK,UAAU,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,YAAY;AAAA,UACjE;AAAA,UACA,MAAM,KAAK,OAAO,QAAQ,CAAC;AAAA,QAC7B,CAAC;AAAA,MACH;AAAA,IACF;AAAA;AAEJ;",
+  "debugId": "A5F238226D88790C64756E2164756E21",
   "names": []
 }

package/dist/cjs/core/commands/types.cjs

@@ -2,36 +2,63 @@ var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
+function __accessProp(key) {
+  return this[key];
+}
 var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
+  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")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
+  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: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 
 // src/core/commands/types.ts
 var exports_types = {};
 __export(exports_types, {
+  getSerializedCellValueKind: () => getSerializedCellValueKind,
+  emptyMutationInvalidation: () => emptyMutationInvalidation,
   ActionTypes: () => ActionTypes
 });
 module.exports = __toCommonJS(exports_types);
+function getSerializedCellValueKind(value) {
+  if (value === undefined || typeof value === "string" && value.length === 0) {
+    return "empty";
+  }
+  if (typeof value === "string" && value.startsWith("=")) {
+    return "formula";
+  }
+  return "scalar";
+}
+function emptyMutationInvalidation() {
+  return {
+    touchedCells: [],
+    resourceKeys: []
+  };
+}
 var ActionTypes = {
   SET_CELL_CONTENT: "SET_CELL_CONTENT",
   SET_SHEET_CONTENT: "SET_SHEET_CONTENT",
@@ -69,4 +96,4 @@ var ActionTypes = {
   RESET_TO_SERIALIZED: "RESET_TO_SERIALIZED"
 };
 
-//# debugId=5FF5E5C922367E6D64756E2164756E21
+//# debugId=65098011DD3A30FD64756E2164756E21

package/dist/cjs/core/commands/types.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/core/commands/types.ts"],
   "sourcesContent": [
-    "/**\n * Command Pattern Types for FormulaEngine\n *\n * Commands encapsulate all mutating operations on the engine,\n * enabling undo/redo, schema validation with rollback, and action serialization.\n */\n\nimport type { CellAddress, RangeAddress, SerializedCellValue } from \"../types.cjs\";\n\n/**\n * Serializable action representation of a command.\n * Used for persistence, collaboration, and changelog functionality.\n */\nexport interface EngineAction {\n  type: string;\n  payload: unknown;\n  timestamp?: number;\n}\n\n/**\n * Base interface for all engine commands.\n */\nexport interface EngineCommand {\n  /**\n   * Whether this command affects cell values/formulas and requires re-evaluation.\n   * Commands that only affect metadata or styles don't need re-evaluation.\n   */\n  readonly requiresReevaluation: boolean;\n\n  /**\n   * Execute the command (forward operation).\n   */\n  execute(): void;\n\n  /**\n   * Undo the command (reverse operation).\n   */\n  undo(): void;\n\n  /**\n   * Convert the command to a serializable action for persistence/collaboration.\n   */\n  toAction(): EngineAction;\n}\n\n/**\n * Options for command execution.\n */\nexport interface ExecuteOptions {\n  /**\n   * Whether to validate schema constraints after execution.\n   * Only applies to commands that require re-evaluation.\n   */\n  validate?: boolean;\n\n  /**\n   * Whether to skip adding to undo stack (for internal use).\n   */\n  skipUndoStack?: boolean;\n\n  /**\n   * Whether to skip emitting update events.\n   */\n  skipEmitUpdate?: boolean;\n}\n\n/**\n * Result of schema validation.\n */\nexport interface SchemaValidationResult {\n  valid: boolean;\n  errors: SchemaValidationErrorInfo[];\n}\n\n/**\n * Information about a schema validation error.\n */\nexport interface SchemaValidationErrorInfo {\n  message: string;\n  cellAddress?: CellAddress;\n  schemaNamespace?: string;\n  columnName?: string;\n  originalError?: Error;\n}\n\n/**\n * Action types for all commands.\n * Used for serialization and deserialization.\n */\nexport const ActionTypes = {\n  // Content commands\n  SET_CELL_CONTENT: \"SET_CELL_CONTENT\",\n  SET_SHEET_CONTENT: \"SET_SHEET_CONTENT\",\n  CLEAR_RANGE: \"CLEAR_RANGE\",\n  PASTE_CELLS: \"PASTE_CELLS\",\n  FILL_AREAS: \"FILL_AREAS\",\n  MOVE_CELL: \"MOVE_CELL\",\n  MOVE_RANGE: \"MOVE_RANGE\",\n  AUTO_FILL: \"AUTO_FILL\",\n\n  // Structure commands - Workbook\n  ADD_WORKBOOK: \"ADD_WORKBOOK\",\n  REMOVE_WORKBOOK: \"REMOVE_WORKBOOK\",\n  RENAME_WORKBOOK: \"RENAME_WORKBOOK\",\n  CLONE_WORKBOOK: \"CLONE_WORKBOOK\",\n\n  // Structure commands - Sheet\n  ADD_SHEET: \"ADD_SHEET\",\n  REMOVE_SHEET: \"REMOVE_SHEET\",\n  RENAME_SHEET: \"RENAME_SHEET\",\n\n  // Table commands\n  ADD_TABLE: \"ADD_TABLE\",\n  REMOVE_TABLE: \"REMOVE_TABLE\",\n  RENAME_TABLE: \"RENAME_TABLE\",\n  UPDATE_TABLE: \"UPDATE_TABLE\",\n  RESET_TABLES: \"RESET_TABLES\",\n\n  // Named expression commands\n  ADD_NAMED_EXPRESSION: \"ADD_NAMED_EXPRESSION\",\n  REMOVE_NAMED_EXPRESSION: \"REMOVE_NAMED_EXPRESSION\",\n  UPDATE_NAMED_EXPRESSION: \"UPDATE_NAMED_EXPRESSION\",\n  RENAME_NAMED_EXPRESSION: \"RENAME_NAMED_EXPRESSION\",\n  SET_NAMED_EXPRESSIONS: \"SET_NAMED_EXPRESSIONS\",\n\n  // Metadata commands\n  SET_CELL_METADATA: \"SET_CELL_METADATA\",\n  SET_SHEET_METADATA: \"SET_SHEET_METADATA\",\n  SET_WORKBOOK_METADATA: \"SET_WORKBOOK_METADATA\",\n\n  // Style commands\n  ADD_CONDITIONAL_STYLE: \"ADD_CONDITIONAL_STYLE\",\n  REMOVE_CONDITIONAL_STYLE: \"REMOVE_CONDITIONAL_STYLE\",\n  ADD_CELL_STYLE: \"ADD_CELL_STYLE\",\n  REMOVE_CELL_STYLE: \"REMOVE_CELL_STYLE\",\n  CLEAR_CELL_STYLES: \"CLEAR_CELL_STYLES\",\n\n  // State commands\n  RESET_TO_SERIALIZED: \"RESET_TO_SERIALIZED\",\n} as const;\n\nexport type ActionType = (typeof ActionTypes)[keyof typeof ActionTypes];\n\n"
+    "/**\n * Command Pattern Types for FormulaEngine\n *\n * Commands encapsulate all mutating operations on the engine,\n * enabling undo/redo, schema validation with rollback, and action serialization.\n */\n\nimport type { CellAddress, RangeAddress, SerializedCellValue } from \"../types.cjs\";\n\nexport type CellContentKind = \"empty\" | \"scalar\" | \"formula\";\n\nexport type RemovedScope =\n  | { type: \"workbook\"; workbookName: string }\n  | { type: \"sheet\"; workbookName: string; sheetName: string };\n\nexport type MutationInvalidation = {\n  touchedCells: Array<{\n    address: CellAddress;\n    beforeKind: CellContentKind;\n    afterKind: CellContentKind;\n  }>;\n  resourceKeys: string[];\n  removedScopes?: RemovedScope[];\n};\n\nexport function getSerializedCellValueKind(\n  value: SerializedCellValue | undefined\n): CellContentKind {\n  if (\n    value === undefined ||\n    (typeof value === \"string\" && value.length === 0)\n  ) {\n    return \"empty\";\n  }\n  if (typeof value === \"string\" && value.startsWith(\"=\")) {\n    return \"formula\";\n  }\n  return \"scalar\";\n}\n\nexport function emptyMutationInvalidation(): MutationInvalidation {\n  return {\n    touchedCells: [],\n    resourceKeys: [],\n  };\n}\n\n/**\n * Serializable action representation of a command.\n * Used for persistence, collaboration, and changelog functionality.\n */\nexport interface EngineAction {\n  type: string;\n  payload: unknown;\n  timestamp?: number;\n}\n\n/**\n * Base interface for all engine commands.\n */\nexport interface EngineCommand {\n  /**\n   * Whether this command affects cell values/formulas and requires re-evaluation.\n   * Commands that only affect metadata or styles don't need re-evaluation.\n   */\n  readonly requiresReevaluation: boolean;\n\n  /**\n   * Returns the exact mutation footprint for the last execute/undo pass.\n   */\n  getInvalidationFootprint?(\n    phase: \"execute\" | \"undo\"\n  ): MutationInvalidation;\n\n  /**\n   * Execute the command (forward operation).\n   */\n  execute(): void;\n\n  /**\n   * Undo the command (reverse operation).\n   */\n  undo(): void;\n\n  /**\n   * Convert the command to a serializable action for persistence/collaboration.\n   */\n  toAction(): EngineAction;\n}\n\n/**\n * Options for command execution.\n */\nexport interface ExecuteOptions {\n  /**\n   * Whether to validate schema constraints after execution.\n   * Only applies to commands that require re-evaluation.\n   */\n  validate?: boolean;\n\n  /**\n   * Whether to skip adding to undo stack (for internal use).\n   */\n  skipUndoStack?: boolean;\n\n  /**\n   * Whether to skip emitting update events.\n   */\n  skipEmitUpdate?: boolean;\n}\n\n/**\n * Result of schema validation.\n */\nexport interface SchemaValidationResult {\n  valid: boolean;\n  errors: SchemaValidationErrorInfo[];\n}\n\n/**\n * Information about a schema validation error.\n */\nexport interface SchemaValidationErrorInfo {\n  message: string;\n  cellAddress?: CellAddress;\n  schemaNamespace?: string;\n  columnName?: string;\n  originalError?: Error;\n}\n\n/**\n * Action types for all commands.\n * Used for serialization and deserialization.\n */\nexport const ActionTypes = {\n  // Content commands\n  SET_CELL_CONTENT: \"SET_CELL_CONTENT\",\n  SET_SHEET_CONTENT: \"SET_SHEET_CONTENT\",\n  CLEAR_RANGE: \"CLEAR_RANGE\",\n  PASTE_CELLS: \"PASTE_CELLS\",\n  FILL_AREAS: \"FILL_AREAS\",\n  MOVE_CELL: \"MOVE_CELL\",\n  MOVE_RANGE: \"MOVE_RANGE\",\n  AUTO_FILL: \"AUTO_FILL\",\n\n  // Structure commands - Workbook\n  ADD_WORKBOOK: \"ADD_WORKBOOK\",\n  REMOVE_WORKBOOK: \"REMOVE_WORKBOOK\",\n  RENAME_WORKBOOK: \"RENAME_WORKBOOK\",\n  CLONE_WORKBOOK: \"CLONE_WORKBOOK\",\n\n  // Structure commands - Sheet\n  ADD_SHEET: \"ADD_SHEET\",\n  REMOVE_SHEET: \"REMOVE_SHEET\",\n  RENAME_SHEET: \"RENAME_SHEET\",\n\n  // Table commands\n  ADD_TABLE: \"ADD_TABLE\",\n  REMOVE_TABLE: \"REMOVE_TABLE\",\n  RENAME_TABLE: \"RENAME_TABLE\",\n  UPDATE_TABLE: \"UPDATE_TABLE\",\n  RESET_TABLES: \"RESET_TABLES\",\n\n  // Named expression commands\n  ADD_NAMED_EXPRESSION: \"ADD_NAMED_EXPRESSION\",\n  REMOVE_NAMED_EXPRESSION: \"REMOVE_NAMED_EXPRESSION\",\n  UPDATE_NAMED_EXPRESSION: \"UPDATE_NAMED_EXPRESSION\",\n  RENAME_NAMED_EXPRESSION: \"RENAME_NAMED_EXPRESSION\",\n  SET_NAMED_EXPRESSIONS: \"SET_NAMED_EXPRESSIONS\",\n\n  // Metadata commands\n  SET_CELL_METADATA: \"SET_CELL_METADATA\",\n  SET_SHEET_METADATA: \"SET_SHEET_METADATA\",\n  SET_WORKBOOK_METADATA: \"SET_WORKBOOK_METADATA\",\n\n  // Style commands\n  ADD_CONDITIONAL_STYLE: \"ADD_CONDITIONAL_STYLE\",\n  REMOVE_CONDITIONAL_STYLE: \"REMOVE_CONDITIONAL_STYLE\",\n  ADD_CELL_STYLE: \"ADD_CELL_STYLE\",\n  REMOVE_CELL_STYLE: \"REMOVE_CELL_STYLE\",\n  CLEAR_CELL_STYLES: \"CLEAR_CELL_STYLES\",\n\n  // State commands\n  RESET_TO_SERIALIZED: \"RESET_TO_SERIALIZED\",\n} as const;\n\nexport type ActionType = (typeof ActionTypes)[keyof typeof ActionTypes];\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyFO,IAAM,cAAc;AAAA,EAEzB,kBAAkB;AAAA,EAClB,mBAAmB;AAAA,EACnB,aAAa;AAAA,EACb,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,WAAW;AAAA,EAGX,cAAc;AAAA,EACd,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,gBAAgB;AAAA,EAGhB,WAAW;AAAA,EACX,cAAc;AAAA,EACd,cAAc;AAAA,EAGd,WAAW;AAAA,EACX,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EAGd,sBAAsB;AAAA,EACtB,yBAAyB;AAAA,EACzB,yBAAyB;AAAA,EACzB,yBAAyB;AAAA,EACzB,uBAAuB;AAAA,EAGvB,mBAAmB;AAAA,EACnB,oBAAoB;AAAA,EACpB,uBAAuB;AAAA,EAGvB,uBAAuB;AAAA,EACvB,0BAA0B;AAAA,EAC1B,gBAAgB;AAAA,EAChB,mBAAmB;AAAA,EACnB,mBAAmB;AAAA,EAGnB,qBAAqB;AACvB;",
-  "debugId": "5FF5E5C922367E6D64756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBO,SAAS,0BAA0B,CACxC,OACiB;AAAA,EACjB,IACE,UAAU,aACT,OAAO,UAAU,YAAY,MAAM,WAAW,GAC/C;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EACA,IAAI,OAAO,UAAU,YAAY,MAAM,WAAW,GAAG,GAAG;AAAA,IACtD,OAAO;AAAA,EACT;AAAA,EACA,OAAO;AAAA;AAGF,SAAS,yBAAyB,GAAyB;AAAA,EAChE,OAAO;AAAA,IACL,cAAc,CAAC;AAAA,IACf,cAAc,CAAC;AAAA,EACjB;AAAA;AA0FK,IAAM,cAAc;AAAA,EAEzB,kBAAkB;AAAA,EAClB,mBAAmB;AAAA,EACnB,aAAa;AAAA,EACb,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,WAAW;AAAA,EAGX,cAAc;AAAA,EACd,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,gBAAgB;AAAA,EAGhB,WAAW;AAAA,EACX,cAAc;AAAA,EACd,cAAc;AAAA,EAGd,WAAW;AAAA,EACX,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EAGd,sBAAsB;AAAA,EACtB,yBAAyB;AAAA,EACzB,yBAAyB;AAAA,EACzB,yBAAyB;AAAA,EACzB,uBAAuB;AAAA,EAGvB,mBAAmB;AAAA,EACnB,oBAAoB;AAAA,EACpB,uBAAuB;AAAA,EAGvB,uBAAuB;AAAA,EACvB,0BAA0B;AAAA,EAC1B,gBAAgB;AAAA,EAChB,mBAAmB;AAAA,EACnB,mBAAmB;AAAA,EAGnB,qBAAqB;AACvB;",
+  "debugId": "65098011DD3A30FD64756E2164756E21",
   "names": []
 }

package/dist/cjs/core/engine-snapshot.cjs

@@ -0,0 +1,51 @@
+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/engine-snapshot.ts
+var exports_engine_snapshot = {};
+__export(exports_engine_snapshot, {
+  getAstNodeSnapshotId: () => getAstNodeSnapshotId,
+  ENGINE_SNAPSHOT_VERSION: () => ENGINE_SNAPSHOT_VERSION
+});
+module.exports = __toCommonJS(exports_engine_snapshot);
+var ENGINE_SNAPSHOT_VERSION = 3;
+function getAstNodeSnapshotId(node) {
+  return `${node.key}::${JSON.stringify(node.getContextDependency())}`;
+}
+
+//# debugId=0BB80B305F337ACF64756E2164756E21

package/dist/cjs/core/engine-snapshot.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/engine-snapshot.ts"],
+  "sourcesContent": [
+    "import type { ContextDependency } from \"../evaluator/evaluation-context.cjs\";\nimport type { DependencyNode } from \"./managers/dependency-node.cjs\";\nimport type {\n  CellAddress,\n  CellInRangeResult,\n  CellValue,\n  ConditionalStyle,\n  DirectCellStyle,\n  FormulaError,\n  NamedExpression,\n  RangeAddress,\n  RelativeRange,\n  SpreadsheetRange,\n  TableDefinition,\n  TrackedReference,\n  Workbook,\n} from \"./types.cjs\";\n\nexport const ENGINE_SNAPSHOT_VERSION = 3 as const;\n\nexport type NodeSnapshotId = string;\n\nexport type NamedExpressionManagerSnapshot = {\n  sheetExpressions: Map<string, Map<string, Map<string, NamedExpression>>>;\n  workbookExpressions: Map<string, Map<string, NamedExpression>>;\n  globalExpressions: Map<string, NamedExpression>;\n};\n\nexport type WorkbookManagerSnapshot = Map<string, Workbook>;\n\nexport type TableManagerSnapshot = Map<string, Map<string, TableDefinition>>;\n\nexport type StyleManagerSnapshot = {\n  conditionalStyles: ConditionalStyle[];\n  cellStyles: DirectCellStyle[];\n};\n\nexport type ReferenceManagerSnapshot = Map<string, TrackedReference>;\n\nexport type SerializedValueEvaluationResultSnapshot = {\n  type: \"value\";\n  result: CellValue;\n  sourceCell?: CellAddress;\n};\n\nexport type SerializedErrorEvaluationResultSnapshot = {\n  type: \"error\";\n  err: FormulaError;\n  message: string;\n  errAddressId: NodeSnapshotId;\n  sourceCell?: CellAddress;\n};\n\nexport type SerializedSingleEvaluationResultSnapshot =\n  | SerializedValueEvaluationResultSnapshot\n  | SerializedErrorEvaluationResultSnapshot;\n\nexport type SerializedCellInRangeResultSnapshot = {\n  relativePos: CellInRangeResult[\"relativePos\"];\n  result: SerializedSingleEvaluationResultSnapshot;\n};\n\nexport type SerializedEvaluateAllCellsResultSnapshot =\n  | SerializedErrorEvaluationResultSnapshot\n  | {\n      type: \"values\";\n      values: SerializedCellInRangeResultSnapshot[];\n    };\n\nexport type SerializedMaterializedSpillSnapshot = {\n  kind: \"materialized\";\n  relativeSpillArea: RelativeRange;\n  source: string;\n  sourceCell?: CellAddress;\n  sourceRange?: RangeAddress;\n  values: SerializedCellInRangeResultSnapshot[];\n};\n\nexport type SerializedSourceRangeSpillSnapshot = {\n  kind: \"source-range\";\n  relativeSpillArea: RelativeRange;\n  source: string;\n  sourceCell?: CellAddress;\n  sourceRange: RangeAddress;\n};\n\nexport type SerializedSpillResultSnapshot =\n  | SerializedMaterializedSpillSnapshot\n  | SerializedSourceRangeSpillSnapshot;\n\nexport type SerializedSpilledValuesEvaluationResultSnapshot = {\n  type: \"spilled-values\";\n  spill: SerializedSpillResultSnapshot;\n};\n\nexport type SerializedFunctionEvaluationResultSnapshot =\n  | SerializedSingleEvaluationResultSnapshot\n  | SerializedSpilledValuesEvaluationResultSnapshot;\n\nexport type SerializedSpillMetaEvaluationResultSnapshot =\n  | SerializedErrorEvaluationResultSnapshot\n  | SerializedSpilledValuesEvaluationResultSnapshot\n  | {\n      type: \"does-not-spill\";\n    };\n\ntype SerializedBaseNodeSnapshot = {\n  snapshotId: NodeSnapshotId;\n  key: string;\n  dependencies: NodeSnapshotId[];\n};\n\nexport type SerializedCellValueNodeSnapshot = SerializedBaseNodeSnapshot & {\n  kind: \"cell-value\";\n  evaluationResult: SerializedSingleEvaluationResultSnapshot;\n  spillMetaSnapshotId?: NodeSnapshotId;\n};\n\nexport type SerializedSpillMetaNodeSnapshot = SerializedBaseNodeSnapshot & {\n  kind: \"spill-meta\";\n  evaluationResult: SerializedSpillMetaEvaluationResultSnapshot;\n};\n\nexport type SerializedEmptyCellNodeSnapshot = SerializedBaseNodeSnapshot & {\n  kind: \"empty\";\n  evaluationResult: SerializedSingleEvaluationResultSnapshot;\n};\n\nexport type SerializedRangeNodeSnapshot = SerializedBaseNodeSnapshot & {\n  kind: \"range\";\n  result: SerializedEvaluateAllCellsResultSnapshot;\n};\n\nexport type SerializedAstNodeSnapshot = SerializedBaseNodeSnapshot & {\n  kind: \"ast\";\n  contextDependency: ContextDependency;\n  evaluationResult: SerializedFunctionEvaluationResultSnapshot;\n};\n\nexport type SerializedResourceNodeSnapshot = SerializedBaseNodeSnapshot & {\n  kind: \"resource\";\n};\n\nexport type SerializedDependencyNodeSnapshot =\n  | SerializedCellValueNodeSnapshot\n  | SerializedSpillMetaNodeSnapshot\n  | SerializedEmptyCellNodeSnapshot\n  | SerializedRangeNodeSnapshot\n  | SerializedAstNodeSnapshot\n  | SerializedResourceNodeSnapshot;\n\nexport type DependencyManagerSnapshot = {\n  nodes: SerializedDependencyNodeSnapshot[];\n  spilledValues: Array<[string, { origin: CellAddress; spillOnto: SpreadsheetRange }]>;\n};\n\nexport type SerializedSCCSnapshot = {\n  id: number;\n  nodes: NodeSnapshotId[];\n  evaluationOrder: NodeSnapshotId[];\n  resolved: boolean;\n  hardEdgeSCCs: NodeSnapshotId[][];\n};\n\nexport type SerializedEvaluationOrderSnapshot = {\n  nodeKey: string;\n  evaluationOrder: NodeSnapshotId[];\n  hasCycle: boolean;\n  cycleNodes?: NodeSnapshotId[];\n  hash: string;\n};\n\nexport type CacheManagerSnapshot = {\n  evaluationOrders: SerializedEvaluationOrderSnapshot[];\n  sccs: Array<{\n    hash: string;\n    scc: SerializedSCCSnapshot;\n  }>;\n};\n\nexport type EngineSnapshotV3 = {\n  version: typeof ENGINE_SNAPSHOT_VERSION;\n  managers: {\n    workbook: WorkbookManagerSnapshot;\n    namedExpression: NamedExpressionManagerSnapshot;\n    table: TableManagerSnapshot;\n    style: StyleManagerSnapshot;\n    reference: ReferenceManagerSnapshot;\n    dependency: DependencyManagerSnapshot;\n    cache: CacheManagerSnapshot;\n  };\n};\n\nexport type EngineSnapshotV2 = EngineSnapshotV3;\n\nexport function getAstNodeSnapshotId(\n  node: DependencyNode & { getContextDependency(): ContextDependency }\n): NodeSnapshotId {\n  return `${node.key}::${JSON.stringify(node.getContextDependency())}`;\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBO,IAAM,0BAA0B;AAiLhC,SAAS,oBAAoB,CAClC,MACgB;AAAA,EAChB,OAAO,GAAG,KAAK,QAAQ,KAAK,UAAU,KAAK,qBAAqB,CAAC;AAAA;",
+  "debugId": "0BB80B305F337ACF64756E2164756E21",
+  "names": []
+}

package/dist/cjs/core/engine.cjs

@@ -2,27 +2,37 @@ var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
+function __accessProp(key) {
+  return this[key];
+}
 var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
+  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")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
+  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: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 
@@ -53,6 +63,8 @@ var import_schema_manager = require("./managers/schema-manager.cjs");
 var import_schema_builder = require("./schema/schema-builder.cjs");
 var import_table_orm = require("./schema/table-orm.cjs");
 var import_cell_orm = require("./schema/cell-orm.cjs");
+var import_grid_orm = require("./schema/grid-orm.cjs");
+var import_engine_snapshot = require("./engine-snapshot.cjs");
 var import_command_executor = require("./commands/command-executor.cjs");
 var import_content_commands = require("./commands/content-commands.cjs");
 var import_structure_commands = require("./commands/structure-commands.cjs");
@@ -129,6 +141,12 @@ class FormulaEngine {
     this.schema[namespace] = orm;
     return orm;
   }
+  addGridSchema(namespace, address, range, parse, write = (value) => ({ value })) {
+    this.schemaManager.registerGridSchema(namespace, address.workbookName, address.sheetName, range, parse);
+    const orm = new import_grid_orm.GridOrm(this, address.workbookName, address.sheetName, range, parse, write, namespace);
+    this.schema[namespace] = orm;
+    return orm;
+  }
   getCellEvaluationResult(cellAddress) {
     return this.evaluationManager.getCellEvaluationResult(cellAddress);
   }
@@ -456,15 +474,32 @@ class FormulaEngine {
   onUpdate(listener) {
     return this.eventManager.onUpdate(listener);
   }
+  buildSerializedSnapshot() {
+    const evaluationSnapshots = this.dependencyManager.toSnapshot(this.evaluationManager);
+    return {
+      version: import_engine_snapshot.ENGINE_SNAPSHOT_VERSION,
+      managers: {
+        workbook: this.workbookManager.toSnapshot(),
+        namedExpression: this.namedExpressionManager.toSnapshot(),
+        table: this.tableManager.toSnapshot(),
+        style: this.styleManager.toSnapshot(),
+        reference: this.referenceManager.toSnapshot(),
+        dependency: evaluationSnapshots.dependency,
+        cache: evaluationSnapshots.cache
+      }
+    };
+  }
   serializeEngine() {
-    return import_map_serializer.serialize(this.getState());
+    return import_map_serializer.serialize(this.buildSerializedSnapshot());
   }
   resetToSerializedEngine(data) {
     const deserialized = import_map_serializer.deserialize(data);
-    this.workbookManager.resetWorkbooks(deserialized.workbooks);
-    deserialized.workbooks.forEach((workbook) => {
+    if (!deserialized || typeof deserialized !== "object" || deserialized.version !== import_engine_snapshot.ENGINE_SNAPSHOT_VERSION || !deserialized.managers) {
+      throw new Error("Unsupported serialized engine format. Expected EngineSnapshot version 3.");
+    }
+    this.workbookManager.restoreFromSnapshot(deserialized.managers.workbook);
+    deserialized.managers.workbook.forEach((workbook) => {
       this.namedExpressionManager.addWorkbook(workbook.name);
-      this.tableManager.addWorkbook(workbook.name);
       workbook.sheets.forEach((sheet) => {
         this.namedExpressionManager.addSheet({
           workbookName: workbook.name,
@@ -472,27 +507,16 @@ class FormulaEngine {
         });
       });
     });
-    this.namedExpressionManager.resetNamedExpressions(deserialized.namedExpressions);
-    this.tableManager.resetTables(deserialized.tables);
-    let conditionalStylesArray;
-    let cellStylesArray;
-    if (deserialized.conditionalStyles) {
-      if (deserialized.conditionalStyles instanceof Map) {
-        conditionalStylesArray = Array.from(deserialized.conditionalStyles.values()).flat();
-      } else if (Array.isArray(deserialized.conditionalStyles)) {
-        conditionalStylesArray = deserialized.conditionalStyles;
-      }
-    }
-    if (deserialized.cellStyles) {
-      if (Array.isArray(deserialized.cellStyles)) {
-        cellStylesArray = deserialized.cellStyles;
-      }
-    }
-    this.styleManager.resetStyles(conditionalStylesArray, cellStylesArray);
-    if (deserialized.references) {
-      this.referenceManager.resetReferences(deserialized.references);
-    }
-    this.evaluationManager.clearEvaluationCache();
+    this.namedExpressionManager.restoreFromSnapshot(deserialized.managers.namedExpression);
+    this.tableManager.restoreFromSnapshot(deserialized.managers.table);
+    this.styleManager.restoreFromSnapshot(deserialized.managers.style);
+    this.referenceManager.restoreFromSnapshot(deserialized.managers.reference);
+    this.dependencyManager.restoreFromSnapshot({
+      dependency: deserialized.managers.dependency,
+      cache: deserialized.managers.cache
+    }, this.evaluationManager);
+    this.commandExecutor.clearHistory();
+    this.commandExecutor.clearActionLog();
     this.eventManager.emitUpdate();
   }
   undo() {
@@ -547,4 +571,4 @@ class FormulaEngine {
   }
 }
 
-//# debugId=5C4DC5727914026164756E2164756E21
+//# debugId=F08768C7E955A82964756E2164756E21