@particle-academy/fancy-sheets 0.7.1 → 0.7.3

package/README.md

@@ -66,6 +66,19 @@ pnpm --filter @particle-academy/fancy-sheets clean    # Remove dist/
 - **Features** — editing, navigation, selection (single, range, multi-range), formatting (bold/italic/align), clipboard (copy/cut/paste with TSV), column resize, freeze rows/cols, undo/redo (50 steps), drag-to-select
 - **Zero third-party dependencies** — custom lexer, parser, evaluator, and dependency graph
 
+## Inertia.js integration
+
+Spreadsheet uses canvas grid measurement and is **not SSR-safe**. In an Inertia app, wrap with [`<FancyClientOnly>`](https://github.com/Particle-Academy/fancy-inertia/blob/main/docs/USAGE.md#fancyclientonly) from `@particle-academy/fancy-inertia`:
+
+```tsx
+import { FancyClientOnly } from "@particle-academy/fancy-inertia";
+import { Spreadsheet } from "@particle-academy/fancy-sheets";
+
+<FancyClientOnly fallback={<div className="h-96 animate-pulse rounded bg-zinc-100" />}>
+  <Spreadsheet rows={100} cols={26} />
+</FancyClientOnly>
+```
+
 ## License
 
 MIT

package/dist/index.cjs

@@ -214,6 +214,7 @@ function lexFormula(input) {
 }
 
 // src/engine/formula/parser.ts
+var MAX_DEPTH = 64;
 function parseFormula(tokens) {
   let pos = 0;
   function peek() {
@@ -229,63 +230,75 @@ function parseFormula(tokens) {
     }
     return t;
   }
-  function parseExpression() {
-    return parseComparison();
+  function checkDepth(depth) {
+    if (depth > MAX_DEPTH) {
+      throw new Error(`Formula nested too deep (max ${MAX_DEPTH} levels)`);
+    }
+  }
+  function parseExpression(depth = 0) {
+    checkDepth(depth);
+    return parseComparison(depth + 1);
   }
-  function parseComparison() {
-    let left = parseConcatenation();
+  function parseComparison(depth) {
+    let left = parseConcatenation(depth + 1);
     while (peek() && peek().type === "operator" && ["=", "<>", "<", ">", "<=", ">="].includes(peek().value)) {
       const op = advance().value;
-      const right = parseConcatenation();
+      const right = parseConcatenation(depth + 1);
       left = { type: "binaryOp", operator: op, left, right };
     }
     return left;
   }
-  function parseConcatenation() {
-    let left = parseAddition();
+  function parseConcatenation(depth) {
+    checkDepth(depth);
+    let left = parseAddition(depth + 1);
     while (peek() && peek().type === "operator" && peek().value === "&") {
       advance();
-      const right = parseAddition();
+      const right = parseAddition(depth + 1);
       left = { type: "binaryOp", operator: "&", left, right };
     }
     return left;
   }
-  function parseAddition() {
-    let left = parseMultiplication();
+  function parseAddition(depth) {
+    checkDepth(depth);
+    let left = parseMultiplication(depth + 1);
     while (peek() && peek().type === "operator" && (peek().value === "+" || peek().value === "-")) {
       const op = advance().value;
-      const right = parseMultiplication();
+      const right = parseMultiplication(depth + 1);
       left = { type: "binaryOp", operator: op, left, right };
     }
     return left;
   }
-  function parseMultiplication() {
-    let left = parseExponentiation();
+  function parseMultiplication(depth) {
+    checkDepth(depth);
+    let left = parseExponentiation(depth + 1);
     while (peek() && peek().type === "operator" && (peek().value === "*" || peek().value === "/")) {
       const op = advance().value;
-      const right = parseExponentiation();
+      const right = parseExponentiation(depth + 1);
       left = { type: "binaryOp", operator: op, left, right };
     }
     return left;
   }
-  function parseExponentiation() {
-    let left = parseUnary();
+  function parseExponentiation(depth) {
+    checkDepth(depth);
+    let left = parseUnary(depth + 1);
     while (peek() && peek().type === "operator" && peek().value === "^") {
       advance();
-      const right = parseUnary();
+      const right = parseUnary(depth + 1);
       left = { type: "binaryOp", operator: "^", left, right };
     }
     return left;
   }
-  function parseUnary() {
+  function parseUnary(depth) {
+    checkDepth(depth);
     if (peek() && peek().type === "operator" && (peek().value === "-" || peek().value === "+")) {
       const op = advance().value;
-      const operand = parseUnary();
+      const operand = parseUnary(depth + 1);
       return { type: "unaryOp", operator: op, operand };
     }
-    return parseAtom();
+    return parseAtom(depth + 1);
   }
-  function parseAtom() {
+  function parseAtom(depth) {
+    checkDepth(depth);
     const t = peek();
     if (!t) throw new Error("Unexpected end of formula");
     if (t.type === "number") {
@@ -323,10 +336,10 @@ function parseFormula(tokens) {
       expect("paren", "(");
       const args = [];
       if (peek() && !(peek().type === "paren" && peek().value === ")")) {
-        args.push(parseExpression());
+        args.push(parseExpression(depth + 1));
         while (peek() && peek().type === "comma") {
           advance();
-          args.push(parseExpression());
+          args.push(parseExpression(depth + 1));
         }
       }
       expect("paren", ")");
@@ -338,13 +351,13 @@ function parseFormula(tokens) {
     }
     if (t.type === "paren" && t.value === "(") {
       advance();
-      const expr = parseExpression();
+      const expr = parseExpression(depth + 1);
       expect("paren", ")");
       return expr;
     }
     throw new Error(`Unexpected token '${t.value}' at position ${t.position}`);
   }
-  const ast = parseExpression();
+  const ast = parseExpression(0);
   return ast;
 }
 
@@ -866,8 +879,9 @@ registerFunction("VLOOKUP", (args) => {
   const colIdx = Number(flat[2] ?? flat[args[1]?.length ?? 0]);
   if (key === null || isNaN(colIdx)) return "#VALUE!";
   for (let i = 0; i < range.length; i++) {
-    if (range[i] === key || typeof range[i] === "string" && typeof key === "string" && range[i].toLowerCase() === key.toLowerCase()) {
-      return range[i] ?? "#N/A";
+    const v = range[i];
+    if (v === key || typeof v === "string" && typeof key === "string" && v.toLowerCase() === key.toLowerCase()) {
+      return v ?? "#N/A";
     }
   }
   return "#N/A";
@@ -877,8 +891,9 @@ registerFunction("HLOOKUP", (args) => {
   const key = flat[0];
   const range = args[1] ?? [];
   for (let i = 0; i < range.length; i++) {
-    if (range[i] === key || typeof range[i] === "string" && typeof key === "string" && range[i].toLowerCase() === key.toLowerCase()) {
-      return range[i] ?? "#N/A";
+    const v = range[i];
+    if (v === key || typeof v === "string" && typeof key === "string" && v.toLowerCase() === key.toLowerCase()) {
+      return v ?? "#N/A";
     }
   }
   return "#N/A";
@@ -895,10 +910,11 @@ registerFunction("MATCH", (args) => {
   const key = flat[0];
   const range = args[1] ?? [];
   for (let i = 0; i < range.length; i++) {
-    if (range[i] === key || typeof range[i] === "number" && typeof key === "number" && range[i] === key) {
+    const v = range[i];
+    if (v === key || typeof v === "number" && typeof key === "number" && v === key) {
       return i + 1;
     }
-    if (typeof range[i] === "string" && typeof key === "string" && range[i].toLowerCase() === key.toLowerCase()) {
+    if (typeof v === "string" && typeof key === "string" && v.toLowerCase() === key.toLowerCase()) {
       return i + 1;
     }
   }