@ricsam/formula-engine 0.0.1

package/dist/cjs/core/utils/spreadsheet-visualizer.cjs

@@ -0,0 +1,142 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// src/core/utils/spreadsheet-visualizer.ts
+var exports_spreadsheet_visualizer = {};
+__export(exports_spreadsheet_visualizer, {
+  visualizeSpreadsheet: () => visualizeSpreadsheet
+});
+module.exports = __toCommonJS(exports_spreadsheet_visualizer);
+function visualizeSpreadsheet(engine, options) {
+  const {
+    workbookName,
+    numRows,
+    numCols,
+    startRow = 1,
+    startCol = 0,
+    sheetName,
+    emptyCellChar = ".",
+    minColWidth = 3,
+    maxColWidth = 20,
+    showColumnHeaders = true,
+    showRowNumbers = true,
+    snapshot = false
+  } = options;
+  const targetSheetName = sheetName || (() => {
+    const sheets = engine.getSheets(workbookName);
+    const sheetNames = Array.from(sheets.keys());
+    return sheetNames.length > 0 ? sheetNames[0] : null;
+  })();
+  const cellValues = [];
+  const columnWidths = new Array(numCols).fill(minColWidth);
+  if (showColumnHeaders) {
+    const headerRow = [];
+    for (let col = 0;col < numCols; col++) {
+      const colLetter = String.fromCharCode(65 + startCol + col);
+      headerRow.push(colLetter);
+      columnWidths[col] = Math.max(columnWidths[col], colLetter.length);
+    }
+    cellValues.push(headerRow);
+  }
+  for (let row = startRow;row < startRow + numRows; row++) {
+    const rowValues = [];
+    for (let col = 0;col < numCols; col++) {
+      let value;
+      if (targetSheetName) {
+        const cellValue = engine.getCellValue({
+          sheetName: targetSheetName,
+          workbookName,
+          rowIndex: row - 1,
+          colIndex: startCol + col
+        });
+        value = cellValue === "" || cellValue == null ? emptyCellChar : String(cellValue);
+      } else {
+        value = emptyCellChar;
+      }
+      rowValues.push(value);
+      columnWidths[col] = Math.max(columnWidths[col], Math.min(value.length, maxColWidth));
+    }
+    cellValues.push(rowValues);
+  }
+  let totalRowWidth = 0;
+  if (showRowNumbers) {
+    totalRowWidth += 3;
+  }
+  for (let col = 0;col < numCols; col++) {
+    totalRowWidth += columnWidths[col];
+  }
+  if (numCols > 0) {
+    totalRowWidth += (numCols - 1) * 3;
+    if (showRowNumbers) {
+      totalRowWidth += 3;
+    }
+  }
+  let result = "";
+  for (let i = 0;i < cellValues.length; i++) {
+    const rowValues = cellValues[i];
+    const formattedCells = [];
+    if (showRowNumbers) {
+      if (i === 0 && showColumnHeaders) {
+        formattedCells.push("   ");
+      } else {
+        const rowNum = showColumnHeaders ? startRow + i - 1 : startRow + i;
+        formattedCells.push(rowNum.toString().padStart(3));
+      }
+    }
+    for (let col = 0;col < rowValues.length; col++) {
+      let cellValue = rowValues[col];
+      if (cellValue.length > maxColWidth) {
+        cellValue = cellValue.substring(0, maxColWidth - 3) + "...";
+      }
+      formattedCells.push(cellValue.padEnd(columnWidths[col]));
+    }
+    let rowContent = formattedCells.join(" | ");
+    rowContent = rowContent.padEnd(totalRowWidth);
+    if (snapshot && i > 0) {
+      rowContent = " " + rowContent;
+    }
+    result += rowContent + `
+`;
+    if (i === 0 && showColumnHeaders) {
+      const separatorParts = [];
+      if (showRowNumbers) {
+        separatorParts.push(snapshot ? "----" : "---");
+      }
+      for (let col = 0;col < numCols; col++) {
+        separatorParts.push("-".repeat(columnWidths[col]));
+      }
+      let separatorLine = separatorParts.join("-+-");
+      separatorLine = separatorLine.padEnd(totalRowWidth);
+      result += separatorLine + `
+`;
+    }
+  }
+  return result;
+}
+
+//# debugId=27D38F207B18230864756E2164756E21

package/dist/cjs/core/utils/spreadsheet-visualizer.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/utils/spreadsheet-visualizer.ts"],
+  "sourcesContent": [
+    "import { FormulaEngine } from \"../engine.cjs\";\n\nexport interface SpreadsheetVisualizerOptions {\n  workbookName: string;\n  /** Number of rows to display (1-based) */\n  numRows: number;\n  /** Number of columns to display (0-based, so 11 = A-K) */\n  numCols: number;\n  /** Starting row (1-based, default: 1) */\n  startRow?: number;\n  /** Starting column (0-based, default: 0 = A) */\n  startCol?: number;\n  /** Sheet name to visualize (default: uses engine's current sheet) */\n  sheetName?: string;\n  /** Character to use for empty cells (default: \".\") */\n  emptyCellChar?: string;\n  /** Minimum column width (default: 3) */\n  minColWidth?: number;\n  /** Maximum column width (default: 20) */\n  maxColWidth?: number;\n  /** Whether to show column headers (A, B, C...) */\n  showColumnHeaders?: boolean;\n  /** Whether to show row numbers */\n  showRowNumbers?: boolean;\n  /** If output is used for snapshotting */\n  snapshot?: boolean;\n}\n\n/**\n * Generates a visual ASCII representation of a spreadsheet region\n */\nexport function visualizeSpreadsheet(\n  engine: FormulaEngine,\n  options: SpreadsheetVisualizerOptions\n): string {\n  const {\n    workbookName,\n    numRows,\n    numCols,\n    startRow = 1,\n    startCol = 0,\n    sheetName,\n    emptyCellChar = \".\",\n    minColWidth = 3,\n    maxColWidth = 20,\n    showColumnHeaders = true,\n    showRowNumbers = true,\n    snapshot = false,\n  } = options;\n\n  // Determine the sheet name to use upfront\n  const targetSheetName =\n    sheetName ||\n    (() => {\n      const sheets = engine.getSheets(workbookName);\n      const sheetNames = Array.from(sheets.keys());\n      return sheetNames.length > 0 ? sheetNames[0]! : null;\n    })();\n\n  // First pass: collect all cell values and calculate column widths\n  const cellValues: string[][] = [];\n  const columnWidths: number[] = new Array(numCols).fill(minColWidth);\n\n  // Collect column headers if needed\n  if (showColumnHeaders) {\n    const headerRow: string[] = [];\n    for (let col = 0; col < numCols; col++) {\n      const colLetter = String.fromCharCode(65 + startCol + col);\n      headerRow.push(colLetter);\n      columnWidths[col] = Math.max(columnWidths[col]!, colLetter.length);\n    }\n    cellValues.push(headerRow);\n  }\n\n  // Collect all cell data\n  for (let row = startRow; row < startRow + numRows; row++) {\n    const rowValues: string[] = [];\n    for (let col = 0; col < numCols; col++) {\n      let value: string;\n      if (targetSheetName) {\n        const cellValue = engine.getCellValue({\n          sheetName: targetSheetName,\n          workbookName,\n          rowIndex: row - 1,\n          colIndex: startCol + col,\n        });\n        value =\n          cellValue === \"\" || cellValue == null\n            ? emptyCellChar\n            : String(cellValue);\n      } else {\n        // No sheets available\n        value = emptyCellChar;\n      }\n\n      rowValues.push(value);\n      // Update column width, respecting max width\n      columnWidths[col] = Math.max(\n        columnWidths[col]!,\n        Math.min(value.length, maxColWidth)\n      );\n    }\n    cellValues.push(rowValues);\n  }\n\n  // Calculate total row width for consistent formatting\n  let totalRowWidth = 0;\n  if (showRowNumbers) {\n    totalRowWidth += 3; // Row number width\n  }\n  for (let col = 0; col < numCols; col++) {\n    totalRowWidth += columnWidths[col]!;\n  }\n  // Add separator characters: \" | \" between columns (3 chars each, but last column doesn't have trailing separator)\n  if (numCols > 0) {\n    totalRowWidth += (numCols - 1) * 3; // \" | \" between columns\n    if (showRowNumbers) {\n      totalRowWidth += 3; // \" | \" after row number\n    }\n  }\n\n  // Second pass: format the output with proper column widths\n  let result = \"\";\n\n  for (let i = 0; i < cellValues.length; i++) {\n    const rowValues = cellValues[i]!;\n    const formattedCells: string[] = [];\n\n    // Add row number if requested\n    if (showRowNumbers) {\n      if (i === 0 && showColumnHeaders) {\n        formattedCells.push(\"   \"); // Empty space for header row\n      } else {\n        const rowNum = showColumnHeaders ? startRow + i - 1 : startRow + i;\n        formattedCells.push(rowNum.toString().padStart(3));\n      }\n    }\n\n    // Format each cell with proper width\n    for (let col = 0; col < rowValues.length; col++) {\n      let cellValue = rowValues[col]!;\n\n      // Truncate if too long\n      if (cellValue.length > maxColWidth) {\n        cellValue = cellValue.substring(0, maxColWidth - 3) + \"...\";\n      }\n\n      // Pad to column width\n      formattedCells.push(cellValue.padEnd(columnWidths[col]!));\n    }\n\n    // Join with consistent separators and ensure exact row width\n    let rowContent = formattedCells.join(\" | \");\n    // Pad the entire row to ensure consistent width\n    rowContent = rowContent.padEnd(totalRowWidth);\n    if (snapshot && i > 0) {\n      rowContent = \" \" + rowContent;\n    }\n    result += rowContent + \"\\n\";\n\n    // Add separator line after header\n    if (i === 0 && showColumnHeaders) {\n      const separatorParts: string[] = [];\n\n      if (showRowNumbers) {\n        separatorParts.push(snapshot ? \"----\" : \"---\");\n      }\n\n      for (let col = 0; col < numCols; col++) {\n        separatorParts.push(\"-\".repeat(columnWidths[col]!));\n      }\n\n      // Create separator line with same width as data rows\n      let separatorLine = separatorParts.join(\"-+-\");\n      separatorLine = separatorLine.padEnd(totalRowWidth);\n      result += separatorLine + \"\\n\";\n    }\n  }\n\n  return result;\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "27D38F207B18230864756E2164756E21",
+  "names": []
+}

package/dist/cjs/core/utils.cjs

@@ -0,0 +1,434 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// src/core/utils.ts
+var exports_utils = {};
+__export(exports_utils, {
+  rowToLetter: () => rowToLetter,
+  rangeAddressToKey: () => rangeAddressToKey,
+  parseCellReference: () => parseCellReference,
+  letterToRow: () => letterToRow,
+  keyToRangeAddress: () => keyToRangeAddress,
+  keyToCellAddress: () => keyToCellAddress,
+  isRangeOneCell: () => isRangeOneCell,
+  isRangeAddress: () => isRangeAddress,
+  isCellInRange: () => isCellInRange,
+  isCellAddress: () => isCellAddress,
+  indexToColumn: () => indexToColumn,
+  getRowNumber: () => getRowNumber,
+  getRelativeRangeKey: () => getRelativeRangeKey,
+  getRelativeRange: () => getRelativeRange,
+  getRangeKey: () => getRangeKey,
+  getRangeIntersection: () => getRangeIntersection,
+  getCellReference: () => getCellReference,
+  getAbsoluteRange: () => getAbsoluteRange,
+  columnToIndex: () => columnToIndex,
+  checkRangeIntersection: () => checkRangeIntersection,
+  cellAddressToKey: () => cellAddressToKey,
+  captureEvaluationErrors: () => captureEvaluationErrors
+});
+module.exports = __toCommonJS(exports_utils);
+var import_evaluation_error = require("src/evaluator/evaluation-error");
+var import_types = require("./types.cjs");
+function isCellAddress(obj) {
+  return obj && typeof obj === "object" && "rowIndex" in obj && "colIndex" in obj && "sheetName" in obj && "workbookName" in obj && !("range" in obj);
+}
+function isRangeAddress(obj) {
+  return obj && typeof obj === "object" && "range" in obj && "sheetName" in obj && "workbookName" in obj;
+}
+var columnToIndex = (col) => {
+  let result = 0;
+  for (let i = 0;i < col.length; i++) {
+    result = result * 26 + (col.charCodeAt(i) - 64);
+  }
+  return result - 1;
+};
+var indexToColumn = (index) => {
+  let result = "";
+  let num = index + 1;
+  while (num > 0) {
+    const remainder = (num - 1) % 26;
+    result = String.fromCharCode(65 + remainder) + result;
+    num = Math.floor((num - 1) / 26);
+  }
+  return result;
+};
+function getRowNumber(index) {
+  return index + 1;
+}
+function getCellReference({
+  rowIndex,
+  colIndex
+}) {
+  return `${indexToColumn(colIndex)}${getRowNumber(rowIndex)}`;
+}
+function rowToLetter(row) {
+  let result = "";
+  let num = row - 1;
+  do {
+    result = String.fromCharCode(65 + num % 26) + result;
+    num = Math.floor(num / 26) - 1;
+  } while (num >= 0);
+  return result;
+}
+function letterToRow(letter) {
+  let result = 0;
+  for (let i = 0;i < letter.length; i++) {
+    result = result * 26 + (letter.charCodeAt(i) - 64);
+  }
+  return result;
+}
+var parseCellReference = (cellReference) => {
+  const match = cellReference.match(/^([A-Z]+)(\d+)$/);
+  if (!match) {
+    throw new Error(`Invalid cell reference: ${cellReference}`);
+  }
+  const column = match[1];
+  if (match[2] === undefined || column === undefined) {
+    throw new Error(`Invalid cell reference: ${cellReference}`);
+  }
+  const row = parseInt(match[2], 10);
+  const colIndex = columnToIndex(column);
+  const rowIndex = row - 1;
+  return {
+    colIndex,
+    rowIndex
+  };
+};
+function isRangeOneCell(range) {
+  if (range.end.col.type === "infinity" || range.end.row.type === "infinity") {
+    return false;
+  }
+  return range.start.col === range.end.col.value && range.start.row === range.end.row.value;
+}
+function isCellInRange(cellAddress, range) {
+  const endCol = range.end.col;
+  const endRow = range.end.row;
+  if (endCol.type === "number" && endRow.type === "number") {
+    return cellAddress.colIndex >= range.start.col && cellAddress.colIndex <= endCol.value && cellAddress.rowIndex >= range.start.row && cellAddress.rowIndex <= endRow.value;
+  } else if (endCol.type === "infinity" && endRow.type === "number") {
+    return cellAddress.colIndex >= range.start.col && cellAddress.rowIndex >= range.start.row && cellAddress.rowIndex <= endRow.value;
+  } else if (endCol.type === "number" && endRow.type === "infinity") {
+    return cellAddress.rowIndex >= range.start.row && cellAddress.colIndex >= range.start.col && cellAddress.colIndex <= endCol.value;
+  } else if (endCol.type === "infinity" && endRow.type === "infinity") {
+    return cellAddress.colIndex >= range.start.col && cellAddress.rowIndex >= range.start.row;
+  }
+  return false;
+}
+function getRangeKey(range) {
+  let rangeKey = "";
+  rangeKey += getCellReference({
+    rowIndex: range.start.row,
+    colIndex: range.start.col
+  });
+  rangeKey += ":";
+  if (range.end.col.type === "number" && range.end.row.type === "number") {
+    rangeKey += getCellReference({
+      rowIndex: range.end.row.value,
+      colIndex: range.end.col.value
+    });
+  } else if (range.end.col.type === "infinity" && range.end.row.type === "number") {
+    rangeKey += `${getRowNumber(range.end.row.value)}`;
+  } else if (range.end.col.type === "number" && range.end.row.type === "infinity") {
+    rangeKey += indexToColumn(range.end.col.value);
+  } else if (range.end.col.type === "infinity" && range.end.row.type === "infinity") {
+    rangeKey += "INFINITY";
+  }
+  return rangeKey;
+}
+function getRelativeRangeKey(range) {
+  let rangeKey = "";
+  rangeKey += getCellReference({
+    rowIndex: range.start.row,
+    colIndex: range.start.col
+  });
+  rangeKey += ":";
+  if (range.width.type === "number") {
+    rangeKey += range.width.value;
+  } else {
+    rangeKey += "INFINITY";
+  }
+  rangeKey += "x";
+  if (range.height.type === "number") {
+    rangeKey += range.height.value;
+  } else {
+    rangeKey += "INFINITY";
+  }
+  return rangeKey;
+}
+function getRelativeRange(range, relativeTo) {
+  const dx = range.start.col - relativeTo.colIndex;
+  const dy = range.start.row - relativeTo.rowIndex;
+  const relativeRange = {
+    start: {
+      col: dx,
+      row: dy
+    },
+    width: range.end.col.type === "number" ? {
+      type: "number",
+      value: range.end.col.value - range.start.col + 1
+    } : range.end.col,
+    height: range.end.row.type === "number" ? {
+      type: "number",
+      value: range.end.row.value - range.start.row + 1
+    } : range.end.row
+  };
+  return relativeRange;
+}
+function getAbsoluteRange(range, relativeTo) {
+  return {
+    start: {
+      col: range.start.col + relativeTo.colIndex,
+      row: range.start.row + relativeTo.rowIndex
+    },
+    end: {
+      col: range.width.type === "number" ? {
+        type: "number",
+        value: range.start.col + range.width.value - 1 + relativeTo.colIndex
+      } : range.width,
+      row: range.height.type === "number" ? {
+        type: "number",
+        value: range.start.row + range.height.value - 1 + relativeTo.rowIndex
+      } : range.height
+    }
+  };
+}
+function keyToCellAddress(key) {
+  const parts = key.split(":");
+  if (parts.length < 2) {
+    throw new Error(`Invalid dependency key format: ${key}`);
+  }
+  if (parts.length !== 4) {
+    throw new Error(`Invalid cell key format: ${key}`);
+  }
+  const workbookName = parts[1];
+  const sheetName = parts[2];
+  const cellRef = parts[3];
+  if (workbookName === undefined || sheetName === undefined || cellRef === undefined) {
+    throw new Error(`Invalid cell key format: ${key}`);
+  }
+  const { rowIndex, colIndex } = parseCellReference(cellRef);
+  if (rowIndex === undefined || colIndex === undefined || Number.isNaN(rowIndex) || Number.isNaN(colIndex)) {
+    throw new Error(`Invalid cell reference: ${cellRef}`);
+  }
+  return {
+    workbookName,
+    sheetName,
+    colIndex,
+    rowIndex
+  };
+}
+function cellAddressToKey(cellAddress) {
+  if (cellAddress.rowIndex === undefined || cellAddress.colIndex === undefined) {
+    throw new Error(`Invalid cell address: rowIndex and colIndex must be defined (got rowIndex=${cellAddress.rowIndex}, colIndex=${cellAddress.colIndex})`);
+  }
+  const cellRef = getCellReference(cellAddress);
+  return `cell-value:${cellAddress.workbookName}:${cellAddress.sheetName}:${cellRef}`;
+}
+function rangeAddressToKey(rangeAddress) {
+  return `range:${rangeAddress.workbookName}:${rangeAddress.sheetName}:${getRangeKey(rangeAddress.range)}`;
+}
+function keyToRangeAddress(key) {
+  const parts = key.split(":");
+  if (parts.length !== 5) {
+    throw new Error(`Invalid range key format: ${key}`);
+  }
+  const workbookName = parts[1];
+  const sheetName = parts[2];
+  const rangeKey = parts[3] + ":" + parts[4];
+  return {
+    workbookName,
+    sheetName,
+    range: parseRangeKey(rangeKey)
+  };
+}
+function parseRangeKey(key) {
+  const parts = key.split(":");
+  if (parts.length !== 2) {
+    throw new Error(`Invalid range key format: ${key}`);
+  }
+  const start = parseCellReference(parts[0]);
+  const end = parts[1];
+  let endRow;
+  let endCol;
+  if (end === "INFINITY") {
+    endRow = {
+      type: "infinity",
+      sign: "positive"
+    };
+    endCol = {
+      type: "infinity",
+      sign: "positive"
+    };
+  } else if (!end?.match(/\d/)) {
+    endRow = {
+      type: "infinity",
+      sign: "positive"
+    };
+    endCol = {
+      type: "number",
+      value: columnToIndex(end)
+    };
+  } else if (!end?.match(/[A-Z]/)) {
+    endRow = {
+      type: "number",
+      value: parseInt(end, 10) - 1
+    };
+    endCol = {
+      type: "infinity",
+      sign: "positive"
+    };
+  } else {
+    const { rowIndex, colIndex } = parseCellReference(end);
+    endRow = {
+      type: "number",
+      value: rowIndex
+    };
+    endCol = {
+      type: "number",
+      value: colIndex
+    };
+  }
+  return {
+    start: {
+      col: start.colIndex,
+      row: start.rowIndex
+    },
+    end: {
+      row: endRow,
+      col: endCol
+    }
+  };
+}
+function checkRangeIntersection(range1, range2) {
+  if (range1.end.col.type === "number" && range2.start.col > range1.end.col.value)
+    return false;
+  if (range2.end.col.type === "number" && range1.start.col > range2.end.col.value)
+    return false;
+  if (range1.end.row.type === "number" && range2.start.row > range1.end.row.value)
+    return false;
+  if (range2.end.row.type === "number" && range1.start.row > range2.end.row.value)
+    return false;
+  return true;
+}
+function getRangeIntersection(range1, range2) {
+  if (!checkRangeIntersection(range1, range2)) {
+    return null;
+  }
+  const startRow = Math.max(range1.start.row, range2.start.row);
+  const startCol = Math.max(range1.start.col, range2.start.col);
+  let endRow, endCol;
+  if (range1.end.row.type === "infinity" && range2.end.row.type === "infinity") {
+    endRow = { type: "infinity", sign: "positive" };
+  } else if (range1.end.row.type === "number" && range2.end.row.type === "number") {
+    endRow = {
+      type: "number",
+      value: Math.min(range1.end.row.value, range2.end.row.value)
+    };
+  } else {
+    endRow = range1.end.row.type === "number" ? range1.end.row : range2.end.row;
+  }
+  if (range1.end.col.type === "infinity" && range2.end.col.type === "infinity") {
+    endCol = { type: "infinity", sign: "positive" };
+  } else if (range1.end.col.type === "number" && range2.end.col.type === "number") {
+    endCol = {
+      type: "number",
+      value: Math.min(range1.end.col.value, range2.end.col.value)
+    };
+  } else {
+    endCol = range1.end.col.type === "number" ? range1.end.col : range2.end.col;
+  }
+  return {
+    start: { row: startRow, col: startCol },
+    end: { row: endRow, col: endCol }
+  };
+}
+function captureEvaluationErrors(errAddress, fn) {
+  try {
+    return fn();
+  } catch (error) {
+    if (error instanceof import_evaluation_error.EvaluationError) {
+      return {
+        type: "error",
+        err: error.type,
+        message: error.message,
+        errAddress: error.errAddress ?? errAddress
+      };
+    }
+    if (error instanceof import_evaluation_error.AwaitingEvaluationError) {
+      return {
+        type: "awaiting-evaluation",
+        waitingFor: error.waitingFor,
+        errAddress: error.errAddress
+      };
+    }
+    const formulaError = error instanceof Error ? mapJSErrorToFormulaError(error) : import_types.FormulaError.ERROR;
+    return {
+      type: "error",
+      err: formulaError,
+      message: error?.stack || "An error was thrown",
+      errAddress
+    };
+  }
+}
+function isFormulaError(value) {
+  if (typeof value !== "string")
+    return false;
+  const errors = Object.values(import_types.FormulaError);
+  return errors.includes(value);
+}
+function mapJSErrorToFormulaError(error) {
+  const message = error.message.toLowerCase();
+  if (isFormulaError(error.message)) {
+    return error.message;
+  }
+  if (message.includes("division by zero") || message.includes("divide by zero")) {
+    return import_types.FormulaError.DIV0;
+  }
+  if (message.includes("circular") || message.includes("cycle")) {
+    return import_types.FormulaError.CYCLE;
+  }
+  if (message.includes("invalid reference") || message.includes("reference") && !message.includes("circular")) {
+    return import_types.FormulaError.REF;
+  }
+  if (message.includes("invalid name") || message.includes("unknown function")) {
+    return import_types.FormulaError.NAME;
+  }
+  if (message.includes("invalid number") || message.includes("nan") || message.includes("infinity")) {
+    return import_types.FormulaError.NUM;
+  }
+  if (message.includes("type") || message.includes("invalid argument")) {
+    return import_types.FormulaError.VALUE;
+  }
+  if (message.includes("not available") || message.includes("n/a")) {
+    return import_types.FormulaError.NA;
+  }
+  return import_types.FormulaError.ERROR;
+}
+
+//# debugId=3945B941ABD946D964756E2164756E21

package/dist/cjs/core/utils.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/utils.ts"],
+  "sourcesContent": [
+    "import {\n  AwaitingEvaluationError,\n  EvaluationError,\n} from \"src/evaluator/evaluation-error\";\nimport {\n  FormulaError,\n  type CellAddress,\n  type ErrorEvaluationResult,\n  type LocalCellAddress,\n  type RangeAddress,\n  type RelativeRange,\n  type SpreadsheetRange,\n  type SpreadsheetRangeEnd,\n} from \"./types.cjs\";\nimport type { DependencyNode } from \"./managers/dependency-node.cjs\";\n\n// Type narrowing utilities\nexport function isCellAddress(\n  obj: RangeAddress | CellAddress\n): obj is CellAddress {\n  return (\n    obj &&\n    typeof obj === \"object\" &&\n    \"rowIndex\" in obj &&\n    \"colIndex\" in obj &&\n    \"sheetName\" in obj &&\n    \"workbookName\" in obj &&\n    !(\"range\" in obj)\n  );\n}\n\nexport function isRangeAddress(\n  obj: RangeAddress | CellAddress\n): obj is RangeAddress {\n  return (\n    obj &&\n    typeof obj === \"object\" &&\n    \"range\" in obj &&\n    \"sheetName\" in obj &&\n    \"workbookName\" in obj\n  );\n}\n\n// Column utilities\nexport const columnToIndex = (col: string): number => {\n  let result = 0;\n  for (let i = 0; i < col.length; i++) {\n    result = result * 26 + (col.charCodeAt(i) - 64); // A=1, B=2, etc.\n  }\n  return result - 1; // Convert to 0-based index\n};\n\nexport const indexToColumn = (index: number): string => {\n  let result = \"\";\n  let num = index + 1; // Convert to 1-based\n\n  while (num > 0) {\n    const remainder = (num - 1) % 26;\n    result = String.fromCharCode(65 + remainder) + result;\n    num = Math.floor((num - 1) / 26);\n  }\n\n  return result;\n};\n\nexport function getRowNumber(index: number): number {\n  return index + 1;\n}\n\nexport function getCellReference({\n  rowIndex,\n  colIndex,\n}: {\n  rowIndex: number;\n  colIndex: number;\n}) {\n  return `${indexToColumn(colIndex)}${getRowNumber(rowIndex)}`;\n}\n\n// Convert row number to letter(s) for reversed headers (1 -> A, 2 -> B, etc.)\nexport function rowToLetter(row: number): string {\n  let result = \"\";\n  let num = row - 1; // Convert to 0-based\n\n  do {\n    result = String.fromCharCode(65 + (num % 26)) + result;\n    num = Math.floor(num / 26) - 1;\n  } while (num >= 0);\n\n  return result;\n}\n\n// Convert letter(s) to row number for reversed headers (A -> 1, B -> 2, etc.)\nexport function letterToRow(letter: string): number {\n  let result = 0;\n  for (let i = 0; i < letter.length; i++) {\n    result = result * 26 + (letter.charCodeAt(i) - 64);\n  }\n  return result;\n}\n\nexport const parseCellReference = (\n  cellReference: string\n): {\n  colIndex: number;\n  rowIndex: number;\n} => {\n  const match = cellReference.match(/^([A-Z]+)(\\d+)$/);\n  if (!match) {\n    throw new Error(`Invalid cell reference: ${cellReference}`);\n  }\n\n  const column = match[1];\n  if (match[2] === undefined || column === undefined) {\n    throw new Error(`Invalid cell reference: ${cellReference}`);\n  }\n  const row = parseInt(match[2], 10);\n  const colIndex = columnToIndex(column);\n  const rowIndex = row - 1; // Convert to 0-based index\n\n  return {\n    colIndex,\n    rowIndex,\n  };\n};\n\n/**\n * Returns true if the range is a single cell, false otherwise\n */\nexport function isRangeOneCell(range: SpreadsheetRange) {\n  if (range.end.col.type === \"infinity\" || range.end.row.type === \"infinity\") {\n    return false;\n  }\n  return (\n    range.start.col === range.end.col.value &&\n    range.start.row === range.end.row.value\n  );\n}\n\nexport function isCellInRange(\n  cellAddress: LocalCellAddress,\n  range: SpreadsheetRange\n) {\n  const endCol = range.end.col;\n  const endRow = range.end.row;\n  if (endCol.type === \"number\" && endRow.type === \"number\") {\n    return (\n      cellAddress.colIndex >= range.start.col &&\n      cellAddress.colIndex <= endCol.value &&\n      cellAddress.rowIndex >= range.start.row &&\n      cellAddress.rowIndex <= endRow.value\n    );\n  } else if (endCol.type === \"infinity\" && endRow.type === \"number\") {\n    return (\n      cellAddress.colIndex >= range.start.col &&\n      cellAddress.rowIndex >= range.start.row &&\n      cellAddress.rowIndex <= endRow.value\n    );\n  } else if (endCol.type === \"number\" && endRow.type === \"infinity\") {\n    return (\n      cellAddress.rowIndex >= range.start.row &&\n      cellAddress.colIndex >= range.start.col &&\n      cellAddress.colIndex <= endCol.value\n    );\n  } else if (endCol.type === \"infinity\" && endRow.type === \"infinity\") {\n    return (\n      cellAddress.colIndex >= range.start.col &&\n      cellAddress.rowIndex >= range.start.row\n    );\n  }\n  return false;\n}\n\nexport function getRangeKey(range: SpreadsheetRange) {\n  let rangeKey = \"\";\n  rangeKey += getCellReference({\n    rowIndex: range.start.row,\n    colIndex: range.start.col,\n  });\n  rangeKey += \":\";\n  if (range.end.col.type === \"number\" && range.end.row.type === \"number\") {\n    rangeKey += getCellReference({\n      rowIndex: range.end.row.value,\n      colIndex: range.end.col.value,\n    });\n  } else if (\n    range.end.col.type === \"infinity\" &&\n    range.end.row.type === \"number\"\n  ) {\n    rangeKey += `${getRowNumber(range.end.row.value)}`;\n  } else if (\n    range.end.col.type === \"number\" &&\n    range.end.row.type === \"infinity\"\n  ) {\n    rangeKey += indexToColumn(range.end.col.value);\n  } else if (\n    range.end.col.type === \"infinity\" &&\n    range.end.row.type === \"infinity\"\n  ) {\n    rangeKey += \"INFINITY\";\n  }\n  return rangeKey;\n}\n\nexport function getRelativeRangeKey(range: RelativeRange): string {\n  let rangeKey = \"\";\n  rangeKey += getCellReference({\n    rowIndex: range.start.row,\n    colIndex: range.start.col,\n  });\n  rangeKey += \":\";\n\n  if (range.width.type === \"number\") {\n    rangeKey += range.width.value;\n  } else {\n    rangeKey += \"INFINITY\";\n  }\n\n  rangeKey += \"x\";\n\n  if (range.height.type === \"number\") {\n    rangeKey += range.height.value;\n  } else {\n    rangeKey += \"INFINITY\";\n  }\n\n  return rangeKey;\n}\n\nexport function getRelativeRange(\n  range: SpreadsheetRange,\n  relativeTo: LocalCellAddress\n): RelativeRange {\n  const dx = range.start.col - relativeTo.colIndex;\n  const dy = range.start.row - relativeTo.rowIndex;\n  const relativeRange: RelativeRange = {\n    start: {\n      col: dx,\n      row: dy,\n    },\n    width:\n      range.end.col.type === \"number\"\n        ? {\n            type: \"number\",\n            value: range.end.col.value - range.start.col + 1,\n          }\n        : range.end.col,\n    height:\n      range.end.row.type === \"number\"\n        ? {\n            type: \"number\",\n            value: range.end.row.value - range.start.row + 1,\n          }\n        : range.end.row,\n  };\n\n  return relativeRange;\n}\n\nexport function getAbsoluteRange(\n  range: RelativeRange,\n  relativeTo: LocalCellAddress\n): SpreadsheetRange {\n  return {\n    start: {\n      col: range.start.col + relativeTo.colIndex,\n      row: range.start.row + relativeTo.rowIndex,\n    },\n    end: {\n      col:\n        range.width.type === \"number\"\n          ? {\n              type: \"number\",\n              value:\n                range.start.col + range.width.value - 1 + relativeTo.colIndex,\n            }\n          : range.width,\n      row:\n        range.height.type === \"number\"\n          ? {\n              type: \"number\",\n              value:\n                range.start.row + range.height.value - 1 + relativeTo.rowIndex,\n            }\n          : range.height,\n    },\n  };\n}\n\nexport function keyToCellAddress(key: string): CellAddress {\n  const parts = key.split(\":\");\n\n  if (parts.length < 2) {\n    throw new Error(`Invalid dependency key format: ${key}`);\n  }\n\n  if (parts.length !== 4) {\n    throw new Error(`Invalid cell key format: ${key}`);\n  }\n  const workbookName = parts[1];\n  const sheetName = parts[2];\n  const cellRef = parts[3];\n\n  if (\n    workbookName === undefined ||\n    sheetName === undefined ||\n    cellRef === undefined\n  ) {\n    throw new Error(`Invalid cell key format: ${key}`);\n  }\n\n  const { rowIndex, colIndex } = parseCellReference(cellRef);\n\n  if (\n    rowIndex === undefined ||\n    colIndex === undefined ||\n    Number.isNaN(rowIndex) ||\n    Number.isNaN(colIndex)\n  ) {\n    throw new Error(`Invalid cell reference: ${cellRef}`);\n  }\n\n  return {\n    workbookName,\n    sheetName,\n    colIndex,\n    rowIndex,\n  };\n}\n\n/**\n * For cache lookups, use dependencyManager.getCellNode(cellAddressToKey(cellAddress)).key\n * because it may be an empty cell node key\n */\nexport function cellAddressToKey(cellAddress: CellAddress): string {\n  if (\n    cellAddress.rowIndex === undefined ||\n    cellAddress.colIndex === undefined\n  ) {\n    throw new Error(\n      `Invalid cell address: rowIndex and colIndex must be defined (got rowIndex=${cellAddress.rowIndex}, colIndex=${cellAddress.colIndex})`\n    );\n  }\n  const cellRef = getCellReference(cellAddress);\n  return `cell-value:${cellAddress.workbookName}:${cellAddress.sheetName}:${cellRef}`;\n}\n\nexport function rangeAddressToKey(rangeAddress: RangeAddress): string {\n  return `range:${rangeAddress.workbookName}:${rangeAddress.sheetName}:${getRangeKey(rangeAddress.range)}`;\n}\n\n/**\n *\n * @param key - the range key to parse e.g. range:workbook:sheet:A3:A5\n * @returns\n */\nexport function keyToRangeAddress(key: string): RangeAddress {\n  const parts = key.split(\":\");\n  if (parts.length !== 5) {\n    throw new Error(`Invalid range key format: ${key}`);\n  }\n  const workbookName = parts[1];\n  const sheetName = parts[2];\n  const rangeKey = parts[3] + \":\" + parts[4];\n  return {\n    workbookName: workbookName!,\n    sheetName: sheetName!,\n    range: parseRangeKey(rangeKey!),\n  };\n}\n\n/**\n *\n * @param key - the range key to parse e.g. A3:A5 or A4:INFINITY\n * @returns\n */\nfunction parseRangeKey(key: string): SpreadsheetRange {\n  const parts = key.split(\":\");\n  if (parts.length !== 2) {\n    throw new Error(`Invalid range key format: ${key}`);\n  }\n\n  const start = parseCellReference(parts[0]!);\n  const end = parts[1]!;\n\n  let endRow: SpreadsheetRangeEnd;\n  let endCol: SpreadsheetRangeEnd;\n\n  if (end === \"INFINITY\") {\n    endRow = {\n      type: \"infinity\",\n      sign: \"positive\",\n    };\n    endCol = {\n      type: \"infinity\",\n      sign: \"positive\",\n    };\n  } else if (!end?.match(/\\d/)) {\n    endRow = {\n      type: \"infinity\",\n      sign: \"positive\",\n    };\n    endCol = {\n      type: \"number\",\n      value: columnToIndex(end!),\n    };\n  } else if (!end?.match(/[A-Z]/)) {\n    endRow = {\n      type: \"number\",\n      value: parseInt(end!, 10) - 1,\n    };\n    endCol = {\n      type: \"infinity\",\n      sign: \"positive\",\n    };\n  } else {\n    const { rowIndex, colIndex } = parseCellReference(end!);\n    endRow = {\n      type: \"number\",\n      value: rowIndex,\n    };\n    endCol = {\n      type: \"number\",\n      value: colIndex,\n    };\n  }\n\n  return {\n    start: {\n      col: start.colIndex,\n      row: start.rowIndex,\n    },\n    end: {\n      row: endRow,\n      col: endCol,\n    },\n  };\n}\n\n/**\n * Check if two ranges intersect\n */\nexport function checkRangeIntersection(\n  range1: SpreadsheetRange,\n  range2: SpreadsheetRange\n): boolean {\n  // Check if ranges don't intersect\n  if (\n    range1.end.col.type === \"number\" &&\n    range2.start.col > range1.end.col.value\n  )\n    return false;\n  if (\n    range2.end.col.type === \"number\" &&\n    range1.start.col > range2.end.col.value\n  )\n    return false;\n  if (\n    range1.end.row.type === \"number\" &&\n    range2.start.row > range1.end.row.value\n  )\n    return false;\n  if (\n    range2.end.row.type === \"number\" &&\n    range1.start.row > range2.end.row.value\n  )\n    return false;\n\n  return true;\n}\n\n/**\n * Get the intersection of two ranges\n */\nexport function getRangeIntersection(\n  range1: SpreadsheetRange,\n  range2: SpreadsheetRange\n): SpreadsheetRange | null {\n  if (!checkRangeIntersection(range1, range2)) {\n    return null;\n  }\n\n  const startRow = Math.max(range1.start.row, range2.start.row);\n  const startCol = Math.max(range1.start.col, range2.start.col);\n\n  let endRow, endCol;\n\n  // Handle end row\n  if (\n    range1.end.row.type === \"infinity\" &&\n    range2.end.row.type === \"infinity\"\n  ) {\n    endRow = { type: \"infinity\" as const, sign: \"positive\" as const };\n  } else if (\n    range1.end.row.type === \"number\" &&\n    range2.end.row.type === \"number\"\n  ) {\n    endRow = {\n      type: \"number\" as const,\n      value: Math.min(range1.end.row.value, range2.end.row.value),\n    };\n  } else {\n    // One is finite, one is infinite\n    endRow = range1.end.row.type === \"number\" ? range1.end.row : range2.end.row;\n  }\n\n  // Handle end col\n  if (\n    range1.end.col.type === \"infinity\" &&\n    range2.end.col.type === \"infinity\"\n  ) {\n    endCol = { type: \"infinity\" as const, sign: \"positive\" as const };\n  } else if (\n    range1.end.col.type === \"number\" &&\n    range2.end.col.type === \"number\"\n  ) {\n    endCol = {\n      type: \"number\" as const,\n      value: Math.min(range1.end.col.value, range2.end.col.value),\n    };\n  } else {\n    // One is finite, one is infinite\n    endCol = range1.end.col.type === \"number\" ? range1.end.col : range2.end.col;\n  }\n\n  return {\n    start: { row: startRow, col: startCol },\n    end: { row: endRow, col: endCol },\n  };\n}\n\nexport function captureEvaluationErrors<T>(\n  errAddress: DependencyNode,\n  fn: () => T\n): T | ErrorEvaluationResult {\n  try {\n    return fn();\n  } catch (error) {\n    if (error instanceof EvaluationError) {\n      return {\n        type: \"error\",\n        err: error.type,\n        message: error.message,\n        errAddress: error.errAddress ?? errAddress,\n      };\n    }\n    if (error instanceof AwaitingEvaluationError) {\n      return {\n        type: \"awaiting-evaluation\",\n        waitingFor: error.waitingFor,\n        errAddress: error.errAddress,\n      };\n    }\n\n    // Convert JavaScript errors to formula errors\n    const formulaError =\n      error instanceof Error\n        ? mapJSErrorToFormulaError(error)\n        : FormulaError.ERROR;\n\n    return {\n      type: \"error\",\n      err: formulaError,\n      message: (error as any)?.stack || \"An error was thrown\",\n      errAddress,\n    };\n  }\n}\n\nfunction isFormulaError(value: string): value is FormulaError {\n  if (typeof value !== \"string\") return false;\n\n  // Check for all known formula errors\n  const errors: FormulaError[] = Object.values(FormulaError);\n\n  return errors.includes(value as FormulaError);\n}\n\n/**\n * Maps JavaScript errors to formula errors\n */\nfunction mapJSErrorToFormulaError(error: Error): FormulaError {\n  const message = error.message.toLowerCase();\n\n  if (isFormulaError(error.message)) {\n    return error.message;\n  }\n\n  if (\n    message.includes(\"division by zero\") ||\n    message.includes(\"divide by zero\")\n  ) {\n    return FormulaError.DIV0;\n  }\n  if (message.includes(\"circular\") || message.includes(\"cycle\")) {\n    return FormulaError.CYCLE;\n  }\n  if (\n    message.includes(\"invalid reference\") ||\n    (message.includes(\"reference\") && !message.includes(\"circular\"))\n  ) {\n    return FormulaError.REF;\n  }\n  if (\n    message.includes(\"invalid name\") ||\n    message.includes(\"unknown function\")\n  ) {\n    return FormulaError.NAME;\n  }\n  if (\n    message.includes(\"invalid number\") ||\n    message.includes(\"nan\") ||\n    message.includes(\"infinity\")\n  ) {\n    return FormulaError.NUM;\n  }\n  if (message.includes(\"type\") || message.includes(\"invalid argument\")) {\n    return FormulaError.VALUE;\n  }\n  if (message.includes(\"not available\") || message.includes(\"n/a\")) {\n    return FormulaError.NA;\n  }\n\n  return FormulaError.ERROR;\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGO,IAHP;AAaO,IATP;AAaO,SAAS,aAAa,CAC3B,KACoB;AAAA,EACpB,OACE,OACA,OAAO,QAAQ,YACf,cAAc,OACd,cAAc,OACd,eAAe,OACf,kBAAkB,OAClB,EAAE,WAAW;AAAA;AAIV,SAAS,cAAc,CAC5B,KACqB;AAAA,EACrB,OACE,OACA,OAAO,QAAQ,YACf,WAAW,OACX,eAAe,OACf,kBAAkB;AAAA;AAKf,IAAM,gBAAgB,CAAC,QAAwB;AAAA,EACpD,IAAI,SAAS;AAAA,EACb,SAAS,IAAI,EAAG,IAAI,IAAI,QAAQ,KAAK;AAAA,IACnC,SAAS,SAAS,MAAM,IAAI,WAAW,CAAC,IAAI;AAAA,EAC9C;AAAA,EACA,OAAO,SAAS;AAAA;AAGX,IAAM,gBAAgB,CAAC,UAA0B;AAAA,EACtD,IAAI,SAAS;AAAA,EACb,IAAI,MAAM,QAAQ;AAAA,EAElB,OAAO,MAAM,GAAG;AAAA,IACd,MAAM,aAAa,MAAM,KAAK;AAAA,IAC9B,SAAS,OAAO,aAAa,KAAK,SAAS,IAAI;AAAA,IAC/C,MAAM,KAAK,OAAO,MAAM,KAAK,EAAE;AAAA,EACjC;AAAA,EAEA,OAAO;AAAA;AAGF,SAAS,YAAY,CAAC,OAAuB;AAAA,EAClD,OAAO,QAAQ;AAAA;AAGV,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,GAIC;AAAA,EACD,OAAO,GAAG,cAAc,QAAQ,IAAI,aAAa,QAAQ;AAAA;AAIpD,SAAS,WAAW,CAAC,KAAqB;AAAA,EAC/C,IAAI,SAAS;AAAA,EACb,IAAI,MAAM,MAAM;AAAA,EAEhB,GAAG;AAAA,IACD,SAAS,OAAO,aAAa,KAAM,MAAM,EAAG,IAAI;AAAA,IAChD,MAAM,KAAK,MAAM,MAAM,EAAE,IAAI;AAAA,EAC/B,SAAS,OAAO;AAAA,EAEhB,OAAO;AAAA;AAIF,SAAS,WAAW,CAAC,QAAwB;AAAA,EAClD,IAAI,SAAS;AAAA,EACb,SAAS,IAAI,EAAG,IAAI,OAAO,QAAQ,KAAK;AAAA,IACtC,SAAS,SAAS,MAAM,OAAO,WAAW,CAAC,IAAI;AAAA,EACjD;AAAA,EACA,OAAO;AAAA;AAGF,IAAM,qBAAqB,CAChC,kBAIG;AAAA,EACH,MAAM,QAAQ,cAAc,MAAM,iBAAiB;AAAA,EACnD,IAAI,CAAC,OAAO;AAAA,IACV,MAAM,IAAI,MAAM,2BAA2B,eAAe;AAAA,EAC5D;AAAA,EAEA,MAAM,SAAS,MAAM;AAAA,EACrB,IAAI,MAAM,OAAO,aAAa,WAAW,WAAW;AAAA,IAClD,MAAM,IAAI,MAAM,2BAA2B,eAAe;AAAA,EAC5D;AAAA,EACA,MAAM,MAAM,SAAS,MAAM,IAAI,EAAE;AAAA,EACjC,MAAM,WAAW,cAAc,MAAM;AAAA,EACrC,MAAM,WAAW,MAAM;AAAA,EAEvB,OAAO;AAAA,IACL;AAAA,IACA;AAAA,EACF;AAAA;AAMK,SAAS,cAAc,CAAC,OAAyB;AAAA,EACtD,IAAI,MAAM,IAAI,IAAI,SAAS,cAAc,MAAM,IAAI,IAAI,SAAS,YAAY;AAAA,IAC1E,OAAO;AAAA,EACT;AAAA,EACA,OACE,MAAM,MAAM,QAAQ,MAAM,IAAI,IAAI,SAClC,MAAM,MAAM,QAAQ,MAAM,IAAI,IAAI;AAAA;AAI/B,SAAS,aAAa,CAC3B,aACA,OACA;AAAA,EACA,MAAM,SAAS,MAAM,IAAI;AAAA,EACzB,MAAM,SAAS,MAAM,IAAI;AAAA,EACzB,IAAI,OAAO,SAAS,YAAY,OAAO,SAAS,UAAU;AAAA,IACxD,OACE,YAAY,YAAY,MAAM,MAAM,OACpC,YAAY,YAAY,OAAO,SAC/B,YAAY,YAAY,MAAM,MAAM,OACpC,YAAY,YAAY,OAAO;AAAA,EAEnC,EAAO,SAAI,OAAO,SAAS,cAAc,OAAO,SAAS,UAAU;AAAA,IACjE,OACE,YAAY,YAAY,MAAM,MAAM,OACpC,YAAY,YAAY,MAAM,MAAM,OACpC,YAAY,YAAY,OAAO;AAAA,EAEnC,EAAO,SAAI,OAAO,SAAS,YAAY,OAAO,SAAS,YAAY;AAAA,IACjE,OACE,YAAY,YAAY,MAAM,MAAM,OACpC,YAAY,YAAY,MAAM,MAAM,OACpC,YAAY,YAAY,OAAO;AAAA,EAEnC,EAAO,SAAI,OAAO,SAAS,cAAc,OAAO,SAAS,YAAY;AAAA,IACnE,OACE,YAAY,YAAY,MAAM,MAAM,OACpC,YAAY,YAAY,MAAM,MAAM;AAAA,EAExC;AAAA,EACA,OAAO;AAAA;AAGF,SAAS,WAAW,CAAC,OAAyB;AAAA,EACnD,IAAI,WAAW;AAAA,EACf,YAAY,iBAAiB;AAAA,IAC3B,UAAU,MAAM,MAAM;AAAA,IACtB,UAAU,MAAM,MAAM;AAAA,EACxB,CAAC;AAAA,EACD,YAAY;AAAA,EACZ,IAAI,MAAM,IAAI,IAAI,SAAS,YAAY,MAAM,IAAI,IAAI,SAAS,UAAU;AAAA,IACtE,YAAY,iBAAiB;AAAA,MAC3B,UAAU,MAAM,IAAI,IAAI;AAAA,MACxB,UAAU,MAAM,IAAI,IAAI;AAAA,IAC1B,CAAC;AAAA,EACH,EAAO,SACL,MAAM,IAAI,IAAI,SAAS,cACvB,MAAM,IAAI,IAAI,SAAS,UACvB;AAAA,IACA,YAAY,GAAG,aAAa,MAAM,IAAI,IAAI,KAAK;AAAA,EACjD,EAAO,SACL,MAAM,IAAI,IAAI,SAAS,YACvB,MAAM,IAAI,IAAI,SAAS,YACvB;AAAA,IACA,YAAY,cAAc,MAAM,IAAI,IAAI,KAAK;AAAA,EAC/C,EAAO,SACL,MAAM,IAAI,IAAI,SAAS,cACvB,MAAM,IAAI,IAAI,SAAS,YACvB;AAAA,IACA,YAAY;AAAA,EACd;AAAA,EACA,OAAO;AAAA;AAGF,SAAS,mBAAmB,CAAC,OAA8B;AAAA,EAChE,IAAI,WAAW;AAAA,EACf,YAAY,iBAAiB;AAAA,IAC3B,UAAU,MAAM,MAAM;AAAA,IACtB,UAAU,MAAM,MAAM;AAAA,EACxB,CAAC;AAAA,EACD,YAAY;AAAA,EAEZ,IAAI,MAAM,MAAM,SAAS,UAAU;AAAA,IACjC,YAAY,MAAM,MAAM;AAAA,EAC1B,EAAO;AAAA,IACL,YAAY;AAAA;AAAA,EAGd,YAAY;AAAA,EAEZ,IAAI,MAAM,OAAO,SAAS,UAAU;AAAA,IAClC,YAAY,MAAM,OAAO;AAAA,EAC3B,EAAO;AAAA,IACL,YAAY;AAAA;AAAA,EAGd,OAAO;AAAA;AAGF,SAAS,gBAAgB,CAC9B,OACA,YACe;AAAA,EACf,MAAM,KAAK,MAAM,MAAM,MAAM,WAAW;AAAA,EACxC,MAAM,KAAK,MAAM,MAAM,MAAM,WAAW;AAAA,EACxC,MAAM,gBAA+B;AAAA,IACnC,OAAO;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,IACP;AAAA,IACA,OACE,MAAM,IAAI,IAAI,SAAS,WACnB;AAAA,MACE,MAAM;AAAA,MACN,OAAO,MAAM,IAAI,IAAI,QAAQ,MAAM,MAAM,MAAM;AAAA,IACjD,IACA,MAAM,IAAI;AAAA,IAChB,QACE,MAAM,IAAI,IAAI,SAAS,WACnB;AAAA,MACE,MAAM;AAAA,MACN,OAAO,MAAM,IAAI,IAAI,QAAQ,MAAM,MAAM,MAAM;AAAA,IACjD,IACA,MAAM,IAAI;AAAA,EAClB;AAAA,EAEA,OAAO;AAAA;AAGF,SAAS,gBAAgB,CAC9B,OACA,YACkB;AAAA,EAClB,OAAO;AAAA,IACL,OAAO;AAAA,MACL,KAAK,MAAM,MAAM,MAAM,WAAW;AAAA,MAClC,KAAK,MAAM,MAAM,MAAM,WAAW;AAAA,IACpC;AAAA,IACA,KAAK;AAAA,MACH,KACE,MAAM,MAAM,SAAS,WACjB;AAAA,QACE,MAAM;AAAA,QACN,OACE,MAAM,MAAM,MAAM,MAAM,MAAM,QAAQ,IAAI,WAAW;AAAA,MACzD,IACA,MAAM;AAAA,MACZ,KACE,MAAM,OAAO,SAAS,WAClB;AAAA,QACE,MAAM;AAAA,QACN,OACE,MAAM,MAAM,MAAM,MAAM,OAAO,QAAQ,IAAI,WAAW;AAAA,MAC1D,IACA,MAAM;AAAA,IACd;AAAA,EACF;AAAA;AAGK,SAAS,gBAAgB,CAAC,KAA0B;AAAA,EACzD,MAAM,QAAQ,IAAI,MAAM,GAAG;AAAA,EAE3B,IAAI,MAAM,SAAS,GAAG;AAAA,IACpB,MAAM,IAAI,MAAM,kCAAkC,KAAK;AAAA,EACzD;AAAA,EAEA,IAAI,MAAM,WAAW,GAAG;AAAA,IACtB,MAAM,IAAI,MAAM,4BAA4B,KAAK;AAAA,EACnD;AAAA,EACA,MAAM,eAAe,MAAM;AAAA,EAC3B,MAAM,YAAY,MAAM;AAAA,EACxB,MAAM,UAAU,MAAM;AAAA,EAEtB,IACE,iBAAiB,aACjB,cAAc,aACd,YAAY,WACZ;AAAA,IACA,MAAM,IAAI,MAAM,4BAA4B,KAAK;AAAA,EACnD;AAAA,EAEA,QAAQ,UAAU,aAAa,mBAAmB,OAAO;AAAA,EAEzD,IACE,aAAa,aACb,aAAa,aACb,OAAO,MAAM,QAAQ,KACrB,OAAO,MAAM,QAAQ,GACrB;AAAA,IACA,MAAM,IAAI,MAAM,2BAA2B,SAAS;AAAA,EACtD;AAAA,EAEA,OAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA;AAOK,SAAS,gBAAgB,CAAC,aAAkC;AAAA,EACjE,IACE,YAAY,aAAa,aACzB,YAAY,aAAa,WACzB;AAAA,IACA,MAAM,IAAI,MACR,6EAA6E,YAAY,sBAAsB,YAAY,WAC7H;AAAA,EACF;AAAA,EACA,MAAM,UAAU,iBAAiB,WAAW;AAAA,EAC5C,OAAO,cAAc,YAAY,gBAAgB,YAAY,aAAa;AAAA;AAGrE,SAAS,iBAAiB,CAAC,cAAoC;AAAA,EACpE,OAAO,SAAS,aAAa,gBAAgB,aAAa,aAAa,YAAY,aAAa,KAAK;AAAA;AAQhG,SAAS,iBAAiB,CAAC,KAA2B;AAAA,EAC3D,MAAM,QAAQ,IAAI,MAAM,GAAG;AAAA,EAC3B,IAAI,MAAM,WAAW,GAAG;AAAA,IACtB,MAAM,IAAI,MAAM,6BAA6B,KAAK;AAAA,EACpD;AAAA,EACA,MAAM,eAAe,MAAM;AAAA,EAC3B,MAAM,YAAY,MAAM;AAAA,EACxB,MAAM,WAAW,MAAM,KAAK,MAAM,MAAM;AAAA,EACxC,OAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,OAAO,cAAc,QAAS;AAAA,EAChC;AAAA;AAQF,SAAS,aAAa,CAAC,KAA+B;AAAA,EACpD,MAAM,QAAQ,IAAI,MAAM,GAAG;AAAA,EAC3B,IAAI,MAAM,WAAW,GAAG;AAAA,IACtB,MAAM,IAAI,MAAM,6BAA6B,KAAK;AAAA,EACpD;AAAA,EAEA,MAAM,QAAQ,mBAAmB,MAAM,EAAG;AAAA,EAC1C,MAAM,MAAM,MAAM;AAAA,EAElB,IAAI;AAAA,EACJ,IAAI;AAAA,EAEJ,IAAI,QAAQ,YAAY;AAAA,IACtB,SAAS;AAAA,MACP,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA,SAAS;AAAA,MACP,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,EACF,EAAO,SAAI,CAAC,KAAK,MAAM,IAAI,GAAG;AAAA,IAC5B,SAAS;AAAA,MACP,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA,SAAS;AAAA,MACP,MAAM;AAAA,MACN,OAAO,cAAc,GAAI;AAAA,IAC3B;AAAA,EACF,EAAO,SAAI,CAAC,KAAK,MAAM,OAAO,GAAG;AAAA,IAC/B,SAAS;AAAA,MACP,MAAM;AAAA,MACN,OAAO,SAAS,KAAM,EAAE,IAAI;AAAA,IAC9B;AAAA,IACA,SAAS;AAAA,MACP,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,EACF,EAAO;AAAA,IACL,QAAQ,UAAU,aAAa,mBAAmB,GAAI;AAAA,IACtD,SAAS;AAAA,MACP,MAAM;AAAA,MACN,OAAO;AAAA,IACT;AAAA,IACA,SAAS;AAAA,MACP,MAAM;AAAA,MACN,OAAO;AAAA,IACT;AAAA;AAAA,EAGF,OAAO;AAAA,IACL,OAAO;AAAA,MACL,KAAK,MAAM;AAAA,MACX,KAAK,MAAM;AAAA,IACb;AAAA,IACA,KAAK;AAAA,MACH,KAAK;AAAA,MACL,KAAK;AAAA,IACP;AAAA,EACF;AAAA;AAMK,SAAS,sBAAsB,CACpC,QACA,QACS;AAAA,EAET,IACE,OAAO,IAAI,IAAI,SAAS,YACxB,OAAO,MAAM,MAAM,OAAO,IAAI,IAAI;AAAA,IAElC,OAAO;AAAA,EACT,IACE,OAAO,IAAI,IAAI,SAAS,YACxB,OAAO,MAAM,MAAM,OAAO,IAAI,IAAI;AAAA,IAElC,OAAO;AAAA,EACT,IACE,OAAO,IAAI,IAAI,SAAS,YACxB,OAAO,MAAM,MAAM,OAAO,IAAI,IAAI;AAAA,IAElC,OAAO;AAAA,EACT,IACE,OAAO,IAAI,IAAI,SAAS,YACxB,OAAO,MAAM,MAAM,OAAO,IAAI,IAAI;AAAA,IAElC,OAAO;AAAA,EAET,OAAO;AAAA;AAMF,SAAS,oBAAoB,CAClC,QACA,QACyB;AAAA,EACzB,IAAI,CAAC,uBAAuB,QAAQ,MAAM,GAAG;AAAA,IAC3C,OAAO;AAAA,EACT;AAAA,EAEA,MAAM,WAAW,KAAK,IAAI,OAAO,MAAM,KAAK,OAAO,MAAM,GAAG;AAAA,EAC5D,MAAM,WAAW,KAAK,IAAI,OAAO,MAAM,KAAK,OAAO,MAAM,GAAG;AAAA,EAE5D,IAAI,QAAQ;AAAA,EAGZ,IACE,OAAO,IAAI,IAAI,SAAS,cACxB,OAAO,IAAI,IAAI,SAAS,YACxB;AAAA,IACA,SAAS,EAAE,MAAM,YAAqB,MAAM,WAAoB;AAAA,EAClE,EAAO,SACL,OAAO,IAAI,IAAI,SAAS,YACxB,OAAO,IAAI,IAAI,SAAS,UACxB;AAAA,IACA,SAAS;AAAA,MACP,MAAM;AAAA,MACN,OAAO,KAAK,IAAI,OAAO,IAAI,IAAI,OAAO,OAAO,IAAI,IAAI,KAAK;AAAA,IAC5D;AAAA,EACF,EAAO;AAAA,IAEL,SAAS,OAAO,IAAI,IAAI,SAAS,WAAW,OAAO,IAAI,MAAM,OAAO,IAAI;AAAA;AAAA,EAI1E,IACE,OAAO,IAAI,IAAI,SAAS,cACxB,OAAO,IAAI,IAAI,SAAS,YACxB;AAAA,IACA,SAAS,EAAE,MAAM,YAAqB,MAAM,WAAoB;AAAA,EAClE,EAAO,SACL,OAAO,IAAI,IAAI,SAAS,YACxB,OAAO,IAAI,IAAI,SAAS,UACxB;AAAA,IACA,SAAS;AAAA,MACP,MAAM;AAAA,MACN,OAAO,KAAK,IAAI,OAAO,IAAI,IAAI,OAAO,OAAO,IAAI,IAAI,KAAK;AAAA,IAC5D;AAAA,EACF,EAAO;AAAA,IAEL,SAAS,OAAO,IAAI,IAAI,SAAS,WAAW,OAAO,IAAI,MAAM,OAAO,IAAI;AAAA;AAAA,EAG1E,OAAO;AAAA,IACL,OAAO,EAAE,KAAK,UAAU,KAAK,SAAS;AAAA,IACtC,KAAK,EAAE,KAAK,QAAQ,KAAK,OAAO;AAAA,EAClC;AAAA;AAGK,SAAS,uBAA0B,CACxC,YACA,IAC2B;AAAA,EAC3B,IAAI;AAAA,IACF,OAAO,GAAG;AAAA,IACV,OAAO,OAAO;AAAA,IACd,IAAI,iBAAiB,yCAAiB;AAAA,MACpC,OAAO;AAAA,QACL,MAAM;AAAA,QACN,KAAK,MAAM;AAAA,QACX,SAAS,MAAM;AAAA,QACf,YAAY,MAAM,cAAc;AAAA,MAClC;AAAA,IACF;AAAA,IACA,IAAI,iBAAiB,iDAAyB;AAAA,MAC5C,OAAO;AAAA,QACL,MAAM;AAAA,QACN,YAAY,MAAM;AAAA,QAClB,YAAY,MAAM;AAAA,MACpB;AAAA,IACF;AAAA,IAGA,MAAM,eACJ,iBAAiB,QACb,yBAAyB,KAAK,IAC9B,0BAAa;AAAA,IAEnB,OAAO;AAAA,MACL,MAAM;AAAA,MACN,KAAK;AAAA,MACL,SAAU,OAAe,SAAS;AAAA,MAClC;AAAA,IACF;AAAA;AAAA;AAIJ,SAAS,cAAc,CAAC,OAAsC;AAAA,EAC5D,IAAI,OAAO,UAAU;AAAA,IAAU,OAAO;AAAA,EAGtC,MAAM,SAAyB,OAAO,OAAO,yBAAY;AAAA,EAEzD,OAAO,OAAO,SAAS,KAAqB;AAAA;AAM9C,SAAS,wBAAwB,CAAC,OAA4B;AAAA,EAC5D,MAAM,UAAU,MAAM,QAAQ,YAAY;AAAA,EAE1C,IAAI,eAAe,MAAM,OAAO,GAAG;AAAA,IACjC,OAAO,MAAM;AAAA,EACf;AAAA,EAEA,IACE,QAAQ,SAAS,kBAAkB,KACnC,QAAQ,SAAS,gBAAgB,GACjC;AAAA,IACA,OAAO,0BAAa;AAAA,EACtB;AAAA,EACA,IAAI,QAAQ,SAAS,UAAU,KAAK,QAAQ,SAAS,OAAO,GAAG;AAAA,IAC7D,OAAO,0BAAa;AAAA,EACtB;AAAA,EACA,IACE,QAAQ,SAAS,mBAAmB,KACnC,QAAQ,SAAS,WAAW,KAAK,CAAC,QAAQ,SAAS,UAAU,GAC9D;AAAA,IACA,OAAO,0BAAa;AAAA,EACtB;AAAA,EACA,IACE,QAAQ,SAAS,cAAc,KAC/B,QAAQ,SAAS,kBAAkB,GACnC;AAAA,IACA,OAAO,0BAAa;AAAA,EACtB;AAAA,EACA,IACE,QAAQ,SAAS,gBAAgB,KACjC,QAAQ,SAAS,KAAK,KACtB,QAAQ,SAAS,UAAU,GAC3B;AAAA,IACA,OAAO,0BAAa;AAAA,EACtB;AAAA,EACA,IAAI,QAAQ,SAAS,MAAM,KAAK,QAAQ,SAAS,kBAAkB,GAAG;AAAA,IACpE,OAAO,0BAAa;AAAA,EACtB;AAAA,EACA,IAAI,QAAQ,SAAS,eAAe,KAAK,QAAQ,SAAS,KAAK,GAAG;AAAA,IAChE,OAAO,0BAAa;AAAA,EACtB;AAAA,EAEA,OAAO,0BAAa;AAAA;",
+  "debugId": "3945B941ABD946D964756E2164756E21",
+  "names": []
+}