@ricsam/formula-engine 0.0.12 → 0.0.14

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

@@ -152,9 +152,75 @@ export declare class FormulaEngine {
      */
     clearCellStyles(range: RangeAddress): void;
     /**
-     * Copy cells from source to target
+     * Paste cells from source to target
      */
-    copyCells(source: CellAddress[], target: CellAddress, options: CopyCellsOptions): void;
+    pasteCells(source: CellAddress[], target: CellAddress, options: CopyCellsOptions): void;
+    /**
+     * Fill one or more areas with a seed range's content/style
+     * Uses column-first strategy: fills down, then replicates right
+     * Formulas are adjusted based on each target cell's offset from the seed
+     *
+     * @param seedRange - The range to use as a template/pattern
+     * @param targetRanges - One or more range addresses to fill
+     * @param options - Copy options (target: 'all'|'content'|'style', type: 'value'|'formula', cut: boolean)
+     *
+     * @example
+     * // Fill F6:J10 with A1:B2 seed (2x2 pattern fills 5x5 area)
+     * engine.fillAreas(
+     *   {
+     *     workbookName,
+     *     sheetName,
+     *     range: {
+     *       start: { col: 0, row: 0 },
+     *       end: { col: { type: "number", value: 1 }, row: { type: "number", value: 1 } }
+     *     }
+     *   },
+     *   [{
+     *     workbookName,
+     *     sheetName,
+     *     range: {
+     *       start: { col: 5, row: 5 },
+     *       end: { col: { type: "number", value: 9 }, row: { type: "number", value: 9 } }
+     *     }
+     *   }],
+     *   { cut: false, type: "formula", target: "all" }
+     * );
+     */
+    fillAreas(seedRange: RangeAddress, targetRanges: RangeAddress[], options: CopyCellsOptions): void;
+    /**
+     * Smart paste that automatically determines whether to paste or fill
+     * Handles multiple selection areas - each area is independently pasted or filled
+     * - If area is larger than source, uses fillAreas() to fill the area
+     * - If area is same size or smaller, uses pasteCells() for normal paste
+     *
+     * @param sourceCells - The copied cells
+     * @param pasteSelection - One or more selection areas where user is pasting
+     * @param options - Copy options
+     *
+     * @example
+     * // Copy A1, paste into two areas B1:C2 and E5:F6 - both get filled
+     * engine.smartPaste(
+     *   [{ workbookName, sheetName, colIndex: 0, rowIndex: 0 }],
+     *   {
+     *     workbookName,
+     *     sheetName,
+     *     areas: [
+     *       { start: { col: 1, row: 0 }, end: { col: { type: "number", value: 2 }, row: { type: "number", value: 1 } } },
+     *       { start: { col: 4, row: 4 }, end: { col: { type: "number", value: 5 }, row: { type: "number", value: 5 } } }
+     *     ]
+     *   },
+     *   { cut: false, type: "formula", target: "all" }
+     * );
+     */
+    smartPaste(sourceCells: CellAddress[], pasteSelection: {
+        workbookName: string;
+        sheetName: string;
+        areas: SpreadsheetRange[];
+    }, options: CopyCellsOptions): void;
+    /**
+     * Get bounds (min/max row/col) from an array of cell addresses
+     */
+    private getBoundsFromCells;
     addSheet(opts: {
         workbookName: string;
         sheetName: string;
@@ -203,7 +269,8 @@ export declare class FormulaEngine {
      */
     reevaluate(): void;
     /**
-     * Auto-fills the fillRange based on the seedRange and the direction.
+     * Auto-fills one or more ranges based on the seedRange and the direction.
+     * Supports pattern detection and style copying.
      */
     autoFill(opts: {
         sheetName: string;
@@ -214,9 +281,9 @@ export declare class FormulaEngine {
      */
     seedRange: SpreadsheetRange, 
     /**
-     * the new cells populated by the drag, excluding the seed
+     * One or more ranges to fill (the new cells populated by the drag, excluding the seed)
      */
-    fillRange: SpreadsheetRange, 
+    fillRanges: SpreadsheetRange[], 
     /**
      * The direction of the fill.
      */

package/dist/types/core/managers/copy-manager.d.ts

@@ -1,7 +1,7 @@
 /**
  * CopyManager - Manages cell copy/paste operations
  */
-import type { CellAddress, CopyCellsOptions } from "../types";
+import type { CellAddress, CopyCellsOptions, RangeAddress } from "../types";
 import type { WorkbookManager } from "./workbook-manager";
 import type { EvaluationManager } from "./evaluation-manager";
 import type { StyleManager } from "./style-manager";
@@ -11,7 +11,7 @@ export declare class CopyManager {
     private styleManager;
     constructor(workbookManager: WorkbookManager, evaluationManager: EvaluationManager, styleManager: StyleManager);
     /**
-     * Copy cells from source to target
+     * Paste cells from source to target
      */
     copyCells(source: CellAddress[], target: CellAddress, options: CopyCellsOptions): void;
     /**
@@ -43,4 +43,41 @@ export declare class CopyManager {
      * Clear source cells (for cut operation)
      */
     private clearSourceCells;
+    /**
+     * Fill one or more areas with a seed range's content/style
+     * Uses column-first strategy: fills down, then replicates right
+     * Formulas are adjusted based on each target cell's offset from the seed
+     */
+    fillAreas(seedRange: RangeAddress, targetRanges: RangeAddress[], options: CopyCellsOptions): void;
+    /**
+     * Fill a target range with a seed range using column-first strategy
+     * Step 1: Fill down - extend seed pattern vertically to match target height
+     * Step 2: Replicate right - copy filled columns horizontally
+     */
+    private fillRangeWithSeed;
+    /**
+     * Get the width of a range (number of columns)
+     */
+    private getRangeWidth;
+    /**
+     * Get the height of a range (number of rows)
+     */
+    private getRangeHeight;
+    /**
+     * Expand a RangeAddress into an array of CellAddress
+     * Handles finite ranges, row-bounded, and column-bounded ranges
+     */
+    private expandRangeToCells;
+    /**
+     * Copy cell content with explicit row/column offset for fill operations
+     */
+    private copyCellContentWithOffset;
+    /**
+     * Adjust formula references by a specific row/column offset
+     */
+    private adjustFormulaWithOffset;
+    /**
+     * Copy formatting from one cell to another
+     */
+    private copyCellFormatting;
 }

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

@@ -318,6 +318,18 @@ export interface CellStyle {
 }
 export interface CopyCellsOptions {
     cut: boolean;
+    /**
+     * all: Copy everything from the source to the target
+     * content: Copy only the content from the source to the target
+     * style: Copy only the style from the source to the target
+     */
+    target: 'all' | 'content' | 'style';
+    /**
+     * The type of the content to copy
+     * value: Copy the value from the source to the target,
+     * e.g. if the cell has the formula =123 + 123 then the value is 246
+     * formula: Copy the formula from the source to the target,
+     * e.g. if the cell has the formula =123 + 123 then the formula is =123 + 123 is copied
+     */
     type: "value" | "formula";
-    formatting: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/formula-engine",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "module": "./dist/mjs/lib.mjs",
   "scripts": {
     "test": "bun test",