@ricsam/formula-engine 0.2.9 → 0.2.11

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

@@ -2,7 +2,7 @@
  * Main FormulaEngine class
  * Core API implementation for spreadsheet calculations
  */
-import { type CellAddress, type CellStyle, type ConditionalStyle, type CopyCellsOptions, type DirectCellStyle, type NamedExpression, type RangeAddress, type SerializedCellValue, type Sheet, type SingleEvaluationResult, type SpreadsheetRange, type SpreadsheetRangeEnd, type TableDefinition } from "./types";
+import { type CellAddress, type CellStyle, type ConditionalStyle, type CopyCellsOptions, type DirectCellStyle, type NamedExpression, type RangeAddress, type ReplaceChange, type ReplaceTarget, type SearchMatch, type SearchOptions, type SerializedCellValue, type Sheet, type SingleEvaluationResult, type SpreadsheetRange, type SpreadsheetRangeEnd, type TableDefinition } from "./types";
 import type { FillDirection } from "@ricsam/selection-manager";
 import { AutoFill } from "./autofill-utils";
 import { WorkbookManager } from "./managers/workbook-manager";
@@ -55,6 +55,7 @@ export declare class FormulaEngine<TMetadata extends Metadata = Metadata> {
     private getExistingSheetContent;
     private getWorkbookResourceKeys;
     private getSheetResourceKeys;
+    private assertNamedExpressionScopeExists;
     getCellEvaluationResult(cellAddress: CellAddress): SingleEvaluationResult | undefined;
     getCellValue(cellAddress: CellAddress, debug?: boolean): SerializedCellValue;
     /**
@@ -412,6 +413,20 @@ export declare class FormulaEngine<TMetadata extends Metadata = Metadata> {
         sheetName: string;
         workbookName: string;
     }): Map<string, SerializedCellValue>;
+    /**
+     * Search raw stored string content without evaluating cell values.
+     */
+    search(query: string, options?: SearchOptions): SearchMatch[];
+    /**
+     * Replace one specific search occurrence inside one addressed cell.
+     */
+    replace(query: string, replacement: string, target: ReplaceTarget, options?: {
+        caseSensitive?: boolean;
+    }): ReplaceChange;
+    /**
+     * Replace all matching raw string occurrences within the requested scope.
+     */
+    replaceAll(query: string, replacement: string, options?: SearchOptions): ReplaceChange[];
     addWorkbook(workbookName: string): void;
     removeWorkbook(workbookName: string): void;
     /**
@@ -476,6 +491,7 @@ export declare class FormulaEngine<TMetadata extends Metadata = Metadata> {
     };
     onUpdate(listener: () => void): () => void;
     private buildSerializedSnapshot;
+    private buildNamedExpressionSnapshot;
     serializeEngine(): string;
     resetToSerializedEngine(data: string): void;
 }

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

@@ -59,6 +59,10 @@ export declare class DependencyManager {
     private coverageWatchersBySheet;
     private frontierWatchersBySheet;
     constructor(cacheManager: CacheManager, workbookManager: WorkbookManager);
+    private getSnapshotEligibilityState;
+    private logSnapshotRestoreWarning;
+    private getLogicalNodeSnapshotId;
+    private resetRestoredNodeToColdState;
     private getSheetWatcherKey;
     private addReverseEdge;
     private removeReverseEdge;

package/dist/types/core/managers/named-expression-manager.d.ts

@@ -80,6 +80,7 @@ export declare class NamedExpressionManager {
     resetNamedExpressions(namedExpressions: ReturnType<typeof this.getNamedExpressions>): void;
     toSnapshot(): NamedExpressionManagerSnapshot;
     restoreFromSnapshot(snapshot: NamedExpressionManagerSnapshot): void;
+    clear(): void;
     /**
      * When adding a sheet, we need to initialize the new maps
      */

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

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

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

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

package/dist/types/parser/parser.d.ts

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

package/package.json

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