@ricsam/formula-engine 0.2.8 → 0.2.10

package/README.md

@@ -9,7 +9,6 @@ A TypeScript-based spreadsheet formula evaluation library designed for high-perf
 - **Excel-compatible** addressing (A1 notation)
 - **Multi-sheet support** with sheet management
 - **Named expressions** with global and sheet-level scoping
-- **Undo/redo system** with command pattern
 - **Copy/paste operations** with clipboard support
 - **TypeScript-first** design with comprehensive type safety
 
@@ -56,6 +55,46 @@ const range = {
 const values = engine.getRangeValues(range); // [[1,2,3],[4,5,6],[7,8,9]]
 ```
 
+## Search And Replace Raw Strings
+
+```typescript
+engine.addWorkbook("Workbook1");
+engine.addSheet({ workbookName: "Workbook1", sheetName: "Sheet1" });
+engine.setSheetContent(
+  { workbookName: "Workbook1", sheetName: "Sheet1" },
+  new Map([
+    ["A1", "=SUM(B1:B10)"],
+    ["A2", "draft summary"],
+  ])
+);
+
+const matches = engine.search("sum", { workbookName: "Workbook1" });
+const oneChange = engine.replace("sum", "avg", {
+  workbookName: "Workbook1",
+  sheetName: "Sheet1",
+  cellReference: "A1",
+  occurrenceIndex: 0,
+});
+const allChanges = engine.replaceAll("draft", "published", {
+  workbookName: "Workbook1",
+});
+
+// Works on any stored string cell, including formulas and plain text
+// [
+//   {
+//     workbookName: "Workbook1",
+//     sheetName: "Sheet1",
+//     cellReference: "A1",
+//     cellContent: "=SUM(B1:B10)",
+//     contentKind: "formula",
+//     occurrenceIndex: 0,
+//     startIndex: 1,
+//     endIndexExclusive: 4,
+//     matchedText: "SUM"
+//   }
+// ]
+```
+
 ## Development Status
 
 ### ✅ Completed
@@ -65,7 +104,6 @@ const values = engine.getRangeValues(range); // [[1,2,3],[4,5,6],[7,8,9]]
 - Sparse data storage with Map-based implementation
 - Copy/paste operations
 - Named expressions (storage only)
-- Undo/redo infrastructure
 
 ### 🚧 In Progress
 - Formula parser and lexer
@@ -97,4 +135,4 @@ FormulaEngine uses a sparse-aware architecture optimized for spreadsheets where
 
 ## License
 
-MIT
+MIT