@ricsam/formula-engine 0.0.16 → 0.0.18

package/dist/types/core/commands/style-commands.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Style Commands - Commands that modify conditional and direct cell styles
+ *
+ * These commands do NOT require re-evaluation after execution.
+ * They only affect styling, not cell values or formulas.
+ */
+import type { StyleManager } from "../managers/style-manager";
+import type { ConditionalStyle, DirectCellStyle, RangeAddress } from "../types";
+import type { EngineCommand, EngineAction } from "./types";
+/**
+ * Command to add a conditional style.
+ */
+export declare class AddConditionalStyleCommand implements EngineCommand {
+    private styleManager;
+    private style;
+    readonly requiresReevaluation = false;
+    private addedIndex;
+    constructor(styleManager: StyleManager, style: ConditionalStyle);
+    execute(): void;
+    undo(): void;
+    toAction(): EngineAction;
+}
+/**
+ * Command to remove a conditional style.
+ */
+export declare class RemoveConditionalStyleCommand implements EngineCommand {
+    private styleManager;
+    private workbookName;
+    private index;
+    readonly requiresReevaluation = false;
+    private removedStyle;
+    constructor(styleManager: StyleManager, workbookName: string, index: number);
+    execute(): void;
+    undo(): void;
+    toAction(): EngineAction;
+}
+/**
+ * Command to add a direct cell style.
+ */
+export declare class AddCellStyleCommand implements EngineCommand {
+    private styleManager;
+    private style;
+    readonly requiresReevaluation = false;
+    private addedIndex;
+    constructor(styleManager: StyleManager, style: DirectCellStyle);
+    execute(): void;
+    undo(): void;
+    toAction(): EngineAction;
+}
+/**
+ * Command to remove a direct cell style.
+ */
+export declare class RemoveCellStyleCommand implements EngineCommand {
+    private styleManager;
+    private workbookName;
+    private index;
+    readonly requiresReevaluation = false;
+    private removedStyle;
+    constructor(styleManager: StyleManager, workbookName: string, index: number);
+    execute(): void;
+    undo(): void;
+    toAction(): EngineAction;
+}
+/**
+ * Command to clear cell styles in a range.
+ */
+export declare class ClearCellStylesCommand implements EngineCommand {
+    private styleManager;
+    private range;
+    readonly requiresReevaluation = false;
+    private snapshot;
+    constructor(styleManager: StyleManager, range: RangeAddress);
+    execute(): void;
+    undo(): void;
+    toAction(): EngineAction;
+}

package/dist/types/core/commands/table-commands.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Table Commands - Commands that modify table definitions
+ *
+ * These commands all require re-evaluation after execution.
+ */
+import type { TableManager } from "../managers/table-manager";
+import type { NamedExpressionManager } from "../managers/named-expression-manager";
+import type { WorkbookManager } from "../managers/workbook-manager";
+import type { ApiSchemaManager } from "../managers/api-schema-manager";
+import type { CellAddress, SerializedCellValue, SpreadsheetRangeEnd, TableDefinition } from "../types";
+import type { EngineCommand, EngineAction } from "./types";
+/**
+ * Dependencies needed for table commands.
+ */
+export interface TableCommandDeps {
+    tableManager: TableManager;
+    namedExpressionManager: NamedExpressionManager;
+    workbookManager: WorkbookManager;
+    apiSchemaManager: ApiSchemaManager;
+    getCellValue: (cellAddress: CellAddress) => SerializedCellValue;
+    renameTableInFormula: (formula: string, oldName: string, newName: string) => string;
+}
+/**
+ * Command to add a table.
+ */
+export declare class AddTableCommand implements EngineCommand {
+    private deps;
+    private props;
+    readonly requiresReevaluation = true;
+    constructor(deps: TableCommandDeps, props: {
+        tableName: string;
+        sheetName: string;
+        workbookName: string;
+        start: string;
+        numRows: SpreadsheetRangeEnd;
+        numCols: number;
+    });
+    execute(): void;
+    undo(): void;
+    toAction(): EngineAction;
+}
+/**
+ * Command to remove a table.
+ */
+export declare class RemoveTableCommand implements EngineCommand {
+    private deps;
+    private opts;
+    readonly requiresReevaluation = true;
+    private removedTable;
+    constructor(deps: TableCommandDeps, opts: {
+        tableName: string;
+        workbookName: string;
+    });
+    execute(): void;
+    undo(): void;
+    toAction(): EngineAction;
+}
+/**
+ * Command to rename a table.
+ */
+export declare class RenameTableCommand implements EngineCommand {
+    private deps;
+    private workbookName;
+    private oldName;
+    private newName;
+    readonly requiresReevaluation = true;
+    constructor(deps: TableCommandDeps, workbookName: string, oldName: string, newName: string);
+    execute(): void;
+    undo(): void;
+    toAction(): EngineAction;
+}
+/**
+ * Command to update a table.
+ */
+export declare class UpdateTableCommand implements EngineCommand {
+    private deps;
+    private opts;
+    readonly requiresReevaluation = true;
+    private previousTable;
+    constructor(deps: TableCommandDeps, opts: {
+        tableName: string;
+        sheetName?: string;
+        start?: string;
+        numRows?: SpreadsheetRangeEnd;
+        numCols?: number;
+        workbookName: string;
+    });
+    execute(): void;
+    undo(): void;
+    toAction(): EngineAction;
+}
+/**
+ * Command to reset all tables.
+ */
+export declare class ResetTablesCommand implements EngineCommand {
+    private deps;
+    private newTables;
+    readonly requiresReevaluation = true;
+    private previousTables;
+    constructor(deps: TableCommandDeps, newTables: Map<string, Map<string, TableDefinition>>);
+    execute(): void;
+    undo(): void;
+    toAction(): EngineAction;
+}

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

@@ -0,0 +1,114 @@
+/**
+ * Command Pattern Types for FormulaEngine
+ *
+ * Commands encapsulate all mutating operations on the engine,
+ * enabling undo/redo, schema validation with rollback, and action serialization.
+ */
+import type { CellAddress } from "../types";
+/**
+ * Serializable action representation of a command.
+ * Used for persistence, collaboration, and changelog functionality.
+ */
+export interface EngineAction {
+    type: string;
+    payload: unknown;
+    timestamp?: number;
+}
+/**
+ * Base interface for all engine commands.
+ */
+export interface EngineCommand {
+    /**
+     * Whether this command affects cell values/formulas and requires re-evaluation.
+     * Commands that only affect metadata or styles don't need re-evaluation.
+     */
+    readonly requiresReevaluation: boolean;
+    /**
+     * Execute the command (forward operation).
+     */
+    execute(): void;
+    /**
+     * Undo the command (reverse operation).
+     */
+    undo(): void;
+    /**
+     * Convert the command to a serializable action for persistence/collaboration.
+     */
+    toAction(): EngineAction;
+}
+/**
+ * Options for command execution.
+ */
+export interface ExecuteOptions {
+    /**
+     * Whether to validate schema constraints after execution.
+     * Only applies to commands that require re-evaluation.
+     */
+    validate?: boolean;
+    /**
+     * Whether to skip adding to undo stack (for internal use).
+     */
+    skipUndoStack?: boolean;
+    /**
+     * Whether to skip emitting update events.
+     */
+    skipEmitUpdate?: boolean;
+}
+/**
+ * Result of schema validation.
+ */
+export interface SchemaValidationResult {
+    valid: boolean;
+    errors: SchemaValidationErrorInfo[];
+}
+/**
+ * Information about a schema validation error.
+ */
+export interface SchemaValidationErrorInfo {
+    message: string;
+    cellAddress?: CellAddress;
+    schemaNamespace?: string;
+    columnName?: string;
+    originalError?: Error;
+}
+/**
+ * Action types for all commands.
+ * Used for serialization and deserialization.
+ */
+export declare const ActionTypes: {
+    readonly SET_CELL_CONTENT: "SET_CELL_CONTENT";
+    readonly SET_SHEET_CONTENT: "SET_SHEET_CONTENT";
+    readonly CLEAR_RANGE: "CLEAR_RANGE";
+    readonly PASTE_CELLS: "PASTE_CELLS";
+    readonly FILL_AREAS: "FILL_AREAS";
+    readonly MOVE_CELL: "MOVE_CELL";
+    readonly MOVE_RANGE: "MOVE_RANGE";
+    readonly AUTO_FILL: "AUTO_FILL";
+    readonly ADD_WORKBOOK: "ADD_WORKBOOK";
+    readonly REMOVE_WORKBOOK: "REMOVE_WORKBOOK";
+    readonly RENAME_WORKBOOK: "RENAME_WORKBOOK";
+    readonly CLONE_WORKBOOK: "CLONE_WORKBOOK";
+    readonly ADD_SHEET: "ADD_SHEET";
+    readonly REMOVE_SHEET: "REMOVE_SHEET";
+    readonly RENAME_SHEET: "RENAME_SHEET";
+    readonly ADD_TABLE: "ADD_TABLE";
+    readonly REMOVE_TABLE: "REMOVE_TABLE";
+    readonly RENAME_TABLE: "RENAME_TABLE";
+    readonly UPDATE_TABLE: "UPDATE_TABLE";
+    readonly RESET_TABLES: "RESET_TABLES";
+    readonly ADD_NAMED_EXPRESSION: "ADD_NAMED_EXPRESSION";
+    readonly REMOVE_NAMED_EXPRESSION: "REMOVE_NAMED_EXPRESSION";
+    readonly UPDATE_NAMED_EXPRESSION: "UPDATE_NAMED_EXPRESSION";
+    readonly RENAME_NAMED_EXPRESSION: "RENAME_NAMED_EXPRESSION";
+    readonly SET_NAMED_EXPRESSIONS: "SET_NAMED_EXPRESSIONS";
+    readonly SET_CELL_METADATA: "SET_CELL_METADATA";
+    readonly SET_SHEET_METADATA: "SET_SHEET_METADATA";
+    readonly SET_WORKBOOK_METADATA: "SET_WORKBOOK_METADATA";
+    readonly ADD_CONDITIONAL_STYLE: "ADD_CONDITIONAL_STYLE";
+    readonly REMOVE_CONDITIONAL_STYLE: "REMOVE_CONDITIONAL_STYLE";
+    readonly ADD_CELL_STYLE: "ADD_CELL_STYLE";
+    readonly REMOVE_CELL_STYLE: "REMOVE_CELL_STYLE";
+    readonly CLEAR_CELL_STYLES: "CLEAR_CELL_STYLES";
+    readonly RESET_TO_SERIALIZED: "RESET_TO_SERIALIZED";
+};
+export type ActionType = (typeof ActionTypes)[keyof typeof ActionTypes];