@ricsam/formula-engine 0.2.8 → 0.2.9

package/dist/cjs/core/schema/table-orm.cjs

@@ -1,189 +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/schema/table-orm.ts
-var exports_table_orm = {};
-__export(exports_table_orm, {
-  TableOrm: () => TableOrm
-});
-module.exports = __toCommonJS(exports_table_orm);
-var import_schema_helpers = require("./schema-helpers.cjs");
-
-class TableOrm {
-  engine;
-  workbookName;
-  tableName;
-  headers;
-  namespace;
-  constructor(engine, workbookName, tableName, headers, namespace) {
-    this.engine = engine;
-    this.workbookName = workbookName;
-    this.tableName = tableName;
-    this.headers = headers;
-    this.namespace = namespace;
-  }
-  getTable() {
-    const table = this.engine._tableManager.getTable({
-      workbookName: this.workbookName,
-      name: this.tableName
-    });
-    if (!table) {
-      throw new Error(`Table "${this.tableName}" not found in workbook "${this.workbookName}"`);
-    }
-    return table;
-  }
-  findWhere(filter) {
-    const table = this.getTable();
-    for (const { rowIndex, isEmpty } of import_schema_helpers.iterateTableRows(this.engine, table)) {
-      if (isEmpty)
-        continue;
-      try {
-        const item = import_schema_helpers.rowToObject(this.engine, table, rowIndex, this.headers, (cell) => this.engine.getCellMetadata(cell));
-        if (import_schema_helpers.matchesFilter(item, filter)) {
-          return item;
-        }
-      } catch {
-        continue;
-      }
-    }
-    return;
-  }
-  findAllWhere(filter) {
-    const table = this.getTable();
-    const results = [];
-    for (const { rowIndex, isEmpty } of import_schema_helpers.iterateTableRows(this.engine, table)) {
-      if (isEmpty)
-        continue;
-      try {
-        const item = import_schema_helpers.rowToObject(this.engine, table, rowIndex, this.headers, (cell) => this.engine.getCellMetadata(cell));
-        if (import_schema_helpers.matchesFilter(item, filter)) {
-          results.push(item);
-        }
-      } catch {
-        continue;
-      }
-    }
-    return results;
-  }
-  append(item) {
-    const table = this.getTable();
-    const nextRow = import_schema_helpers.getNextEmptyRow(this.engine, table);
-    const { values, metadata } = import_schema_helpers.objectToRowValues(item, this.headers);
-    for (const [colOffset, value] of values) {
-      const cellAddress = {
-        workbookName: table.workbookName,
-        sheetName: table.sheetName,
-        colIndex: table.start.colIndex + colOffset,
-        rowIndex: nextRow
-      };
-      this.engine.setCellContent(cellAddress, value);
-      const cellMetadata = metadata.get(colOffset);
-      if (cellMetadata !== undefined) {
-        this.engine.setCellMetadata(cellAddress, cellMetadata);
-      }
-    }
-    return item;
-  }
-  updateWhere(filter, update) {
-    const table = this.getTable();
-    let updatedCount = 0;
-    for (const { rowIndex, isEmpty } of import_schema_helpers.iterateTableRows(this.engine, table)) {
-      if (isEmpty)
-        continue;
-      try {
-        const item = import_schema_helpers.rowToObject(this.engine, table, rowIndex, this.headers, (cell) => this.engine.getCellMetadata(cell));
-        if (import_schema_helpers.matchesFilter(item, filter)) {
-          const { values, metadata } = import_schema_helpers.objectToRowValues(update, this.headers);
-          for (const [colOffset, value] of values) {
-            const cellAddress = {
-              workbookName: table.workbookName,
-              sheetName: table.sheetName,
-              colIndex: table.start.colIndex + colOffset,
-              rowIndex
-            };
-            this.engine.setCellContent(cellAddress, value);
-            const cellMetadata = metadata.get(colOffset);
-            if (cellMetadata !== undefined) {
-              this.engine.setCellMetadata(cellAddress, cellMetadata);
-            }
-          }
-          updatedCount++;
-        }
-      } catch {
-        continue;
-      }
-    }
-    return updatedCount;
-  }
-  removeWhere(filter) {
-    const table = this.getTable();
-    let removedCount = 0;
-    const rowsToRemove = [];
-    for (const { rowIndex, isEmpty } of import_schema_helpers.iterateTableRows(this.engine, table)) {
-      if (isEmpty)
-        continue;
-      try {
-        const item = import_schema_helpers.rowToObject(this.engine, table, rowIndex, this.headers, (cell) => this.engine.getCellMetadata(cell));
-        if (import_schema_helpers.matchesFilter(item, filter)) {
-          rowsToRemove.push(rowIndex);
-        }
-      } catch {
-        continue;
-      }
-    }
-    for (const rowIndex of rowsToRemove.reverse()) {
-      for (const header of Object.values(this.headers)) {
-        const cellAddress = {
-          workbookName: table.workbookName,
-          sheetName: table.sheetName,
-          colIndex: table.start.colIndex + header.index,
-          rowIndex
-        };
-        this.engine.setCellContent(cellAddress, undefined);
-      }
-      removedCount++;
-    }
-    return removedCount;
-  }
-  count() {
-    const table = this.getTable();
-    return import_schema_helpers.getTableRowCount(this.engine, table);
-  }
-}
-
-//# debugId=03DA24A03255D08564756E2164756E21

package/dist/cjs/core/schema/table-orm.cjs.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/core/schema/table-orm.ts"],
-  "sourcesContent": [
-    "/**\n * TableOrm - Object-Relational Mapping for table data\n *\n * Provides CRUD operations for table data with type-safe access.\n * Used as the `this` context for custom table API methods.\n */\n\nimport type { CellAddress, SerializedCellValue, TableDefinition } from \"../types.cjs\";\nimport type { FormulaEngine } from \"../engine.cjs\";\nimport {\n  rowToObject,\n  objectToRowValues,\n  matchesFilter,\n  getTableRowCount,\n  getNextEmptyRow,\n  iterateTableRows,\n  type TableSchemaHeaders,\n} from \"./schema-helpers.cjs\";\n\nexport class TableOrm<TItem extends Record<string, unknown>> {\n  constructor(\n    private engine: FormulaEngine<any, any>,\n    private workbookName: string,\n    private tableName: string,\n    private headers: TableSchemaHeaders,\n    private namespace: string\n  ) {}\n\n  /**\n   * Get the table definition from the engine\n   */\n  private getTable(): TableDefinition {\n    const table = this.engine._tableManager.getTable({\n      workbookName: this.workbookName,\n      name: this.tableName,\n    });\n\n    if (!table) {\n      throw new Error(\n        `Table \"${this.tableName}\" not found in workbook \"${this.workbookName}\"`\n      );\n    }\n\n    return table;\n  }\n\n  /**\n   * Find the first row matching the filter\n   */\n  findWhere(filter: Partial<TItem>): TItem | undefined {\n    const table = this.getTable();\n\n    for (const { rowIndex, isEmpty } of iterateTableRows(this.engine, table)) {\n      if (isEmpty) continue;\n\n      try {\n        const item = rowToObject<TItem>(\n          this.engine,\n          table,\n          rowIndex,\n          this.headers,\n          (cell) => this.engine.getCellMetadata(cell)\n        );\n\n        if (matchesFilter(item, filter)) {\n          return item;\n        }\n      } catch {\n        // Skip rows that fail parsing\n        continue;\n      }\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Find all rows matching the filter\n   */\n  findAllWhere(filter: Partial<TItem>): TItem[] {\n    const table = this.getTable();\n    const results: TItem[] = [];\n\n    for (const { rowIndex, isEmpty } of iterateTableRows(this.engine, table)) {\n      if (isEmpty) continue;\n\n      try {\n        const item = rowToObject<TItem>(\n          this.engine,\n          table,\n          rowIndex,\n          this.headers,\n          (cell) => this.engine.getCellMetadata(cell)\n        );\n\n        if (matchesFilter(item, filter)) {\n          results.push(item);\n        }\n      } catch {\n        // Skip rows that fail parsing\n        continue;\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Append a new row to the table\n   */\n  append(item: TItem): TItem {\n    const table = this.getTable();\n    const nextRow = getNextEmptyRow(this.engine, table);\n    const { values, metadata } = objectToRowValues(item, this.headers);\n\n    // Write each cell value and metadata\n    for (const [colOffset, value] of values) {\n      const cellAddress: CellAddress = {\n        workbookName: table.workbookName,\n        sheetName: table.sheetName,\n        colIndex: table.start.colIndex + colOffset,\n        rowIndex: nextRow,\n      };\n\n      this.engine.setCellContent(cellAddress, value);\n      const cellMetadata = metadata.get(colOffset);\n      if (cellMetadata !== undefined) {\n        this.engine.setCellMetadata(cellAddress, cellMetadata);\n      }\n    }\n\n    return item;\n  }\n\n  /**\n   * Update all rows matching the filter\n   * Returns the number of rows updated\n   */\n  updateWhere(filter: Partial<TItem>, update: Partial<TItem>): number {\n    const table = this.getTable();\n    let updatedCount = 0;\n\n    for (const { rowIndex, isEmpty } of iterateTableRows(this.engine, table)) {\n      if (isEmpty) continue;\n\n      try {\n        const item = rowToObject<TItem>(\n          this.engine,\n          table,\n          rowIndex,\n          this.headers,\n          (cell) => this.engine.getCellMetadata(cell)\n        );\n\n        if (matchesFilter(item, filter)) {\n          // Apply updates\n          const { values, metadata } = objectToRowValues(update as TItem, this.headers);\n\n          for (const [colOffset, value] of values) {\n            const cellAddress: CellAddress = {\n              workbookName: table.workbookName,\n              sheetName: table.sheetName,\n              colIndex: table.start.colIndex + colOffset,\n              rowIndex,\n            };\n\n            this.engine.setCellContent(cellAddress, value);\n            const cellMetadata = metadata.get(colOffset);\n            if (cellMetadata !== undefined) {\n              this.engine.setCellMetadata(cellAddress, cellMetadata);\n            }\n          }\n\n          updatedCount++;\n        }\n      } catch {\n        // Skip rows that fail parsing\n        continue;\n      }\n    }\n\n    return updatedCount;\n  }\n\n  /**\n   * Remove all rows matching the filter\n   * Returns the number of rows removed\n   */\n  removeWhere(filter: Partial<TItem>): number {\n    const table = this.getTable();\n    let removedCount = 0;\n\n    // Collect rows to remove (in reverse order to avoid index shifting issues)\n    const rowsToRemove: number[] = [];\n\n    for (const { rowIndex, isEmpty } of iterateTableRows(this.engine, table)) {\n      if (isEmpty) continue;\n\n      try {\n        const item = rowToObject<TItem>(\n          this.engine,\n          table,\n          rowIndex,\n          this.headers,\n          (cell) => this.engine.getCellMetadata(cell)\n        );\n\n        if (matchesFilter(item, filter)) {\n          rowsToRemove.push(rowIndex);\n        }\n      } catch {\n        // Skip rows that fail parsing\n        continue;\n      }\n    }\n\n    // Remove rows in reverse order\n    for (const rowIndex of rowsToRemove.reverse()) {\n      // Clear all cells in the row\n      for (const header of Object.values(this.headers)) {\n        const cellAddress: CellAddress = {\n          workbookName: table.workbookName,\n          sheetName: table.sheetName,\n          colIndex: table.start.colIndex + header.index,\n          rowIndex,\n        };\n\n        this.engine.setCellContent(cellAddress, undefined);\n      }\n\n      removedCount++;\n    }\n\n    return removedCount;\n  }\n\n  /**\n   * Get the count of data rows in the table\n   */\n  count(): number {\n    const table = this.getTable();\n    return getTableRowCount(this.engine, table);\n  }\n}\n"
-  ],
-  "mappings": "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",
-  "debugId": "03DA24A03255D08564756E2164756E21",
-  "names": []
-}

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

@@ -1,109 +0,0 @@
-// src/core/commands/command-executor.ts
-import { emptyMutationInvalidation } from "./types.mjs";
-
-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") ?? emptyMutationInvalidation());
-      if (validate) {
-        const validation = this.validateAllSchemas();
-        if (!validation.valid) {
-          command.undo();
-          this.evaluationManager.invalidateFromMutation(command.getInvalidationFootprint?.("undo") ?? 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") ?? 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") ?? 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;
-  }
-}
-export {
-  SchemaIntegrityError,
-  CommandExecutor
-};
-
-//# debugId=B70925EB1761ED8F64756E2164756E21

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