@ricsam/formula-engine 0.0.5 → 0.0.7

package/dist/cjs/core/managers/style-manager.cjs

@@ -0,0 +1,341 @@
+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/managers/style-manager.ts
+var exports_style_manager = {};
+__export(exports_style_manager, {
+  StyleManager: () => StyleManager
+});
+module.exports = __toCommonJS(exports_style_manager);
+var import_utils = require("../utils.cjs");
+var import_color_utils = require("../utils/color-utils.cjs");
+
+class StyleManager {
+  workbookManager;
+  evaluationManager;
+  conditionalStyles = [];
+  cellStyles = [];
+  constructor(workbookManager, evaluationManager) {
+    this.workbookManager = workbookManager;
+    this.evaluationManager = evaluationManager;
+  }
+  addConditionalStyle(style) {
+    this.conditionalStyles.push(style);
+  }
+  removeConditionalStyle(workbookName, index) {
+    const workbookStyles = this.conditionalStyles.filter((style) => style.area.workbookName === workbookName);
+    if (index < 0 || index >= workbookStyles.length) {
+      return false;
+    }
+    let currentIndex = 0;
+    for (let i = 0;i < this.conditionalStyles.length; i++) {
+      const style = this.conditionalStyles[i];
+      if (style && style.area.workbookName === workbookName) {
+        if (currentIndex === index) {
+          this.conditionalStyles.splice(i, 1);
+          return true;
+        }
+        currentIndex++;
+      }
+    }
+    return false;
+  }
+  getConditionalStyles(workbookName) {
+    return this.conditionalStyles.filter((style) => style && style.area && style.area.workbookName === workbookName);
+  }
+  addCellStyle(style) {
+    this.cellStyles.push(style);
+  }
+  removeCellStyle(workbookName, index) {
+    const workbookStyles = this.cellStyles.filter((style) => style && style.area && style.area.workbookName === workbookName);
+    if (index < 0 || index >= workbookStyles.length) {
+      return false;
+    }
+    let currentIndex = 0;
+    for (let i = 0;i < this.cellStyles.length; i++) {
+      const style = this.cellStyles[i];
+      if (style && style.area && style.area.workbookName === workbookName) {
+        if (currentIndex === index) {
+          this.cellStyles.splice(i, 1);
+          return true;
+        }
+        currentIndex++;
+      }
+    }
+    return false;
+  }
+  getCellStyles(workbookName) {
+    return this.cellStyles.filter((style) => style && style.area && style.area.workbookName === workbookName);
+  }
+  getAllConditionalStyles() {
+    return [...this.conditionalStyles];
+  }
+  getAllCellStyles() {
+    return [...this.cellStyles];
+  }
+  resetStyles(conditionalStyles, cellStyles) {
+    this.conditionalStyles = conditionalStyles ? [...conditionalStyles] : [];
+    this.cellStyles = cellStyles ? [...cellStyles] : [];
+  }
+  removeWorkbookStyles(workbookName) {
+    this.conditionalStyles = this.conditionalStyles.filter((style) => style.area.workbookName !== workbookName);
+    this.cellStyles = this.cellStyles.filter((style) => style.area.workbookName !== workbookName);
+  }
+  updateWorkbookName(oldName, newName) {
+    this.conditionalStyles = this.conditionalStyles.map((style) => {
+      if (style.area.workbookName === oldName) {
+        return {
+          ...style,
+          area: {
+            ...style.area,
+            workbookName: newName
+          }
+        };
+      }
+      return style;
+    });
+    this.cellStyles = this.cellStyles.map((style) => {
+      if (style.area.workbookName === oldName) {
+        return {
+          ...style,
+          area: {
+            ...style.area,
+            workbookName: newName
+          }
+        };
+      }
+      return style;
+    });
+  }
+  updateSheetName(workbookName, oldSheetName, newSheetName) {
+    this.conditionalStyles = this.conditionalStyles.map((style) => {
+      if (style.area.workbookName === workbookName && style.area.sheetName === oldSheetName) {
+        return {
+          ...style,
+          area: {
+            ...style.area,
+            sheetName: newSheetName
+          }
+        };
+      }
+      return style;
+    });
+    this.cellStyles = this.cellStyles.map((style) => {
+      if (style.area.workbookName === workbookName && style.area.sheetName === oldSheetName) {
+        return {
+          ...style,
+          area: {
+            ...style.area,
+            sheetName: newSheetName
+          }
+        };
+      }
+      return style;
+    });
+  }
+  removeSheetStyles(workbookName, sheetName) {
+    this.conditionalStyles = this.conditionalStyles.filter((style) => !(style.area.workbookName === workbookName && style.area.sheetName === sheetName));
+    this.cellStyles = this.cellStyles.filter((style) => !(style.area.workbookName === workbookName && style.area.sheetName === sheetName));
+  }
+  getCellStyle(cellAddress) {
+    for (const cellStyle of this.cellStyles) {
+      if (!cellStyle || !cellStyle.area) {
+        continue;
+      }
+      if (cellStyle.area.workbookName === cellAddress.workbookName && cellStyle.area.sheetName === cellAddress.sheetName && import_utils.isCellInRange(cellAddress, cellStyle.area.range)) {
+        return {
+          backgroundColor: cellStyle.style.backgroundColor,
+          color: cellStyle.style.color
+        };
+      }
+    }
+    for (const style of this.conditionalStyles) {
+      if (!style || !style.area) {
+        continue;
+      }
+      if (style.area.sheetName !== cellAddress.sheetName || style.area.workbookName !== cellAddress.workbookName) {
+        continue;
+      }
+      if (!import_utils.isCellInRange(cellAddress, style.area.range)) {
+        continue;
+      }
+      if (style.condition.type === "formula") {
+        const result = this.evaluateFormulaCondition(cellAddress, style);
+        if (result)
+          return result;
+      } else {
+        const result = this.evaluateGradientCondition(cellAddress, style);
+        if (result)
+          return result;
+      }
+    }
+    return;
+  }
+  evaluateFormulaCondition(cellAddress, style) {
+    if (style.condition.type !== "formula") {
+      return;
+    }
+    try {
+      const formula = style.condition.formula.startsWith("=") ? style.condition.formula : `=${style.condition.formula}`;
+      const result = this.evaluationManager.evaluateFormula(formula, cellAddress);
+      const isTruthy = result === true || result === "TRUE" || typeof result === "number" && result !== 0;
+      if (isTruthy) {
+        return {
+          backgroundColor: import_color_utils.lchToHex(style.condition.color)
+        };
+      }
+    } catch (error) {
+      console.warn("Failed to evaluate formula condition:", error);
+    }
+    return;
+  }
+  evaluateGradientCondition(cellAddress, style) {
+    if (style.condition.type !== "gradient") {
+      return;
+    }
+    try {
+      const evalResult = this.evaluationManager.getCellEvaluationResult(cellAddress);
+      if (!evalResult || evalResult.type !== "value") {
+        return;
+      }
+      if (evalResult.result.type !== "number") {
+        return;
+      }
+      const cellValue = evalResult.result.value;
+      const { min: minValue, max: maxValue } = this.calculateGradientBounds(style, cellAddress);
+      if (minValue === null || maxValue === null) {
+        return;
+      }
+      const factor = import_color_utils.calculateGradientFactor(cellValue, minValue, maxValue);
+      const minColor = style.condition.min.color;
+      const maxColor = style.condition.max.color;
+      const interpolatedColor = import_color_utils.interpolateLCH(minColor, maxColor, factor);
+      return {
+        backgroundColor: import_color_utils.lchToHex(interpolatedColor)
+      };
+    } catch (error) {
+      console.warn("Failed to evaluate gradient condition:", error);
+      return;
+    }
+  }
+  calculateGradientBounds(style, cellAddress) {
+    if (style.condition.type !== "gradient") {
+      return { min: null, max: null };
+    }
+    const { min: minConfig, max: maxConfig } = style.condition;
+    const topLeftCell = {
+      workbookName: style.area.workbookName,
+      sheetName: style.area.sheetName,
+      colIndex: style.area.range.start.col,
+      rowIndex: style.area.range.start.row
+    };
+    let minValue = null;
+    if (minConfig.type === "lowest_value") {
+      try {
+        const rangeRef = this.getRangeReference(style.area);
+        const result = this.evaluationManager.evaluateFormula(`=MIN(${rangeRef})`, topLeftCell);
+        if (typeof result === "number") {
+          minValue = result;
+        }
+      } catch (error) {
+        console.warn("Failed to calculate MIN:", error);
+      }
+    } else {
+      const formula = minConfig.valueFormula.startsWith("=") ? minConfig.valueFormula : `=${minConfig.valueFormula}`;
+      const result = this.evaluationManager.evaluateFormula(formula, topLeftCell);
+      if (typeof result === "number") {
+        minValue = result;
+      }
+    }
+    let maxValue = null;
+    if (maxConfig.type === "highest_value") {
+      try {
+        const rangeRef = this.getRangeReference(style.area);
+        const result = this.evaluationManager.evaluateFormula(`=MAX(${rangeRef})`, topLeftCell);
+        if (typeof result === "number") {
+          maxValue = result;
+        }
+      } catch (error) {
+        console.warn("Failed to calculate MAX:", error);
+      }
+    } else {
+      const formula = maxConfig.valueFormula.startsWith("=") ? maxConfig.valueFormula : `=${maxConfig.valueFormula}`;
+      const result = this.evaluationManager.evaluateFormula(formula, topLeftCell);
+      if (typeof result === "number") {
+        maxValue = result;
+      }
+    }
+    return { min: minValue, max: maxValue };
+  }
+  getRangeReference(area) {
+    const colToLetter = (col) => {
+      let result = "";
+      let c = col;
+      while (c >= 0) {
+        result = String.fromCharCode(65 + c % 26) + result;
+        c = Math.floor(c / 26) - 1;
+      }
+      return result;
+    };
+    const startCol = colToLetter(area.range.start.col);
+    const startRow = area.range.start.row + 1;
+    const isColInfinity = area.range.end.col.type === "infinity";
+    const isRowInfinity = area.range.end.row.type === "infinity";
+    let rangeStr;
+    if (isColInfinity && isRowInfinity) {
+      rangeStr = `${startCol}${startRow}:INFINITY`;
+    } else if (isColInfinity) {
+      if (area.range.end.row.type === "number") {
+        const endRow = area.range.end.row.value + 1;
+        rangeStr = `${startCol}${startRow}:${endRow}`;
+      } else {
+        rangeStr = `${startCol}${startRow}:INFINITY`;
+      }
+    } else if (isRowInfinity) {
+      if (area.range.end.col.type === "number") {
+        const endCol = colToLetter(area.range.end.col.value);
+        rangeStr = `${startCol}${startRow}:${endCol}`;
+      } else {
+        rangeStr = `${startCol}${startRow}:INFINITY`;
+      }
+    } else {
+      if (area.range.end.col.type === "number" && area.range.end.row.type === "number") {
+        const endCol = colToLetter(area.range.end.col.value);
+        const endRow = area.range.end.row.value + 1;
+        rangeStr = `${startCol}${startRow}:${endCol}${endRow}`;
+      } else {
+        rangeStr = `${startCol}${startRow}:INFINITY`;
+      }
+    }
+    const needsQuotes = /[ '!]/.test(area.sheetName);
+    const sheetRef = needsQuotes ? `'${area.sheetName.replace(/'/g, "''")}'` : area.sheetName;
+    return `[${area.workbookName}]${sheetRef}!${rangeStr}`;
+  }
+}
+
+//# debugId=2984643D5EF61FCB64756E2164756E21

package/dist/cjs/core/managers/style-manager.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/managers/style-manager.ts"],
+  "sourcesContent": [
+    "/**\n * StyleManager - Manages conditional styling for cells\n */\n\nimport type {\n  CellAddress,\n  CellStyle,\n  ConditionalStyle,\n  DirectCellStyle,\n  RangeAddress,\n  SerializedCellValue,\n} from \"../types.cjs\";\nimport type { WorkbookManager } from \"./workbook-manager.cjs\";\nimport type { EvaluationManager } from \"./evaluation-manager.cjs\";\nimport { isCellInRange } from \"../utils.cjs\";\nimport {\n  calculateGradientFactor,\n  interpolateLCH,\n  lchToHex,\n} from \"../utils/color-utils.cjs\";\n\nexport class StyleManager {\n  private conditionalStyles: ConditionalStyle[] = [];\n  private cellStyles: DirectCellStyle[] = [];\n\n  constructor(\n    private workbookManager: WorkbookManager,\n    private evaluationManager: EvaluationManager\n  ) {}\n\n  /**\n   * Add a conditional style rule\n   */\n  addConditionalStyle(style: ConditionalStyle): void {\n    this.conditionalStyles.push(style);\n  }\n\n  /**\n   * Remove a conditional style rule by index for a specific workbook\n   */\n  removeConditionalStyle(workbookName: string, index: number): boolean {\n    const workbookStyles = this.conditionalStyles.filter(\n      (style) => style.area.workbookName === workbookName\n    );\n    if (index < 0 || index >= workbookStyles.length) {\n      return false;\n    }\n    // Find the actual index in the full array\n    let currentIndex = 0;\n    for (let i = 0; i < this.conditionalStyles.length; i++) {\n      const style = this.conditionalStyles[i];\n      if (style && style.area.workbookName === workbookName) {\n        if (currentIndex === index) {\n          this.conditionalStyles.splice(i, 1);\n          return true;\n        }\n        currentIndex++;\n      }\n    }\n    return false;\n  }\n\n  /**\n   * Get all conditional styles for a workbook\n   */\n  getConditionalStyles(workbookName: string): ConditionalStyle[] {\n    return this.conditionalStyles.filter(\n      (style) => style && style.area && style.area.workbookName === workbookName\n    );\n  }\n\n  /**\n   * Add a direct cell style rule\n   */\n  addCellStyle(style: DirectCellStyle): void {\n    this.cellStyles.push(style);\n  }\n\n  /**\n   * Remove a direct cell style rule by index for a specific workbook\n   */\n  removeCellStyle(workbookName: string, index: number): boolean {\n    const workbookStyles = this.cellStyles.filter(\n      (style) => style && style.area && style.area.workbookName === workbookName\n    );\n    if (index < 0 || index >= workbookStyles.length) {\n      return false;\n    }\n    // Find the actual index in the full array\n    let currentIndex = 0;\n    for (let i = 0; i < this.cellStyles.length; i++) {\n      const style = this.cellStyles[i];\n      if (style && style.area && style.area.workbookName === workbookName) {\n        if (currentIndex === index) {\n          this.cellStyles.splice(i, 1);\n          return true;\n        }\n        currentIndex++;\n      }\n    }\n    return false;\n  }\n\n  /**\n   * Get all direct cell styles for a workbook\n   */\n  getCellStyles(workbookName: string): DirectCellStyle[] {\n    return this.cellStyles.filter(\n      (style) => style && style.area && style.area.workbookName === workbookName\n    );\n  }\n\n  /**\n   * Get all conditional styles across all workbooks (for serialization)\n   */\n  getAllConditionalStyles(): ConditionalStyle[] {\n    return [...this.conditionalStyles];\n  }\n\n  /**\n   * Get all cell styles (for serialization)\n   */\n  getAllCellStyles(): DirectCellStyle[] {\n    return [...this.cellStyles];\n  }\n\n  /**\n   * Reset all styles (for deserialization)\n   */\n  resetStyles(conditionalStyles?: ConditionalStyle[], cellStyles?: DirectCellStyle[]): void {\n    this.conditionalStyles = conditionalStyles ? [...conditionalStyles] : [];\n    this.cellStyles = cellStyles ? [...cellStyles] : [];\n  }\n\n  /**\n   * Remove all styles for a workbook\n   */\n  removeWorkbookStyles(workbookName: string): void {\n    this.conditionalStyles = this.conditionalStyles.filter(\n      (style) => style.area.workbookName !== workbookName\n    );\n    this.cellStyles = this.cellStyles.filter(\n      (style) => style.area.workbookName !== workbookName\n    );\n  }\n\n  /**\n   * Update workbook name in all style references\n   */\n  updateWorkbookName(oldName: string, newName: string): void {\n    // Update conditional styles\n    this.conditionalStyles = this.conditionalStyles.map((style) => {\n      if (style.area.workbookName === oldName) {\n        return {\n          ...style,\n          area: {\n            ...style.area,\n            workbookName: newName,\n          },\n        };\n      }\n      return style;\n    });\n    // Update cell styles\n    this.cellStyles = this.cellStyles.map((style) => {\n      if (style.area.workbookName === oldName) {\n        return {\n          ...style,\n          area: {\n            ...style.area,\n            workbookName: newName,\n          },\n        };\n      }\n      return style;\n    });\n  }\n\n  /**\n   * Update sheet name in style references\n   */\n  updateSheetName(\n    workbookName: string,\n    oldSheetName: string,\n    newSheetName: string\n  ): void {\n    // Update conditional styles\n    this.conditionalStyles = this.conditionalStyles.map((style) => {\n      if (\n        style.area.workbookName === workbookName &&\n        style.area.sheetName === oldSheetName\n      ) {\n        return {\n          ...style,\n          area: {\n            ...style.area,\n            sheetName: newSheetName,\n          },\n        };\n      }\n      return style;\n    });\n    // Update cell styles\n    this.cellStyles = this.cellStyles.map((style) => {\n      if (\n        style.area.workbookName === workbookName &&\n        style.area.sheetName === oldSheetName\n      ) {\n        return {\n          ...style,\n          area: {\n            ...style.area,\n            sheetName: newSheetName,\n          },\n        };\n      }\n      return style;\n    });\n  }\n\n  /**\n   * Remove styles that reference a deleted sheet\n   */\n  removeSheetStyles(workbookName: string, sheetName: string): void {\n    this.conditionalStyles = this.conditionalStyles.filter(\n      (style) =>\n        !(\n          style.area.workbookName === workbookName &&\n          style.area.sheetName === sheetName\n        )\n    );\n    this.cellStyles = this.cellStyles.filter(\n      (style) =>\n        !(\n          style.area.workbookName === workbookName &&\n          style.area.sheetName === sheetName\n        )\n    );\n  }\n\n  /**\n   * Get the style for a specific cell\n   * Returns the first matching style (first match wins)\n   * Checks cellStyles first, then conditionalStyles\n   */\n  getCellStyle(cellAddress: CellAddress): CellStyle | undefined {\n    // First check direct cell styles\n    for (const cellStyle of this.cellStyles) {\n      if (!cellStyle || !cellStyle.area) {\n        continue;\n      }\n      if (\n        cellStyle.area.workbookName === cellAddress.workbookName &&\n        cellStyle.area.sheetName === cellAddress.sheetName &&\n        isCellInRange(cellAddress, cellStyle.area.range)\n      ) {\n        return {\n          backgroundColor: cellStyle.style.backgroundColor,\n          color: cellStyle.style.color,\n        };\n      }\n    }\n\n    // Then check conditional styles\n    for (const style of this.conditionalStyles) {\n      if (!style || !style.area) {\n        continue;\n      }\n      // Check if cell is in the style's area\n      if (\n        style.area.sheetName !== cellAddress.sheetName ||\n        style.area.workbookName !== cellAddress.workbookName\n      ) {\n        continue;\n      }\n\n      if (!isCellInRange(cellAddress, style.area.range)) {\n        continue;\n      }\n\n      // Cell is in area, evaluate condition\n      if (style.condition.type === \"formula\") {\n        const result = this.evaluateFormulaCondition(cellAddress, style);\n        if (result) return result;\n      } else {\n        const result = this.evaluateGradientCondition(cellAddress, style);\n        if (result) return result;\n      }\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Evaluate a formula-based style condition\n   */\n  private evaluateFormulaCondition(\n    cellAddress: CellAddress,\n    style: ConditionalStyle\n  ): CellStyle | undefined {\n    if (style.condition.type !== \"formula\") {\n      return undefined;\n    }\n\n    try {\n      // Evaluate formula in context of the cell\n      // evaluateFormula expects a full cell value (with = prefix for formulas)\n      const formula = style.condition.formula.startsWith(\"=\")\n        ? style.condition.formula\n        : `=${style.condition.formula}`;\n      \n      const result = this.evaluationManager.evaluateFormula(\n        formula,\n        cellAddress\n      );\n\n      // Check if result is truthy\n      const isTruthy =\n        result === true ||\n        result === \"TRUE\" ||\n        (typeof result === \"number\" && result !== 0);\n\n      if (isTruthy) {\n        return {\n          backgroundColor: lchToHex(style.condition.color),\n        };\n      }\n    } catch (error) {\n      // If formula evaluation fails, don't apply style\n      console.warn(\"Failed to evaluate formula condition:\", error);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Evaluate a gradient-based style condition\n   */\n  private evaluateGradientCondition(\n    cellAddress: CellAddress,\n    style: ConditionalStyle\n  ): CellStyle | undefined {\n    if (style.condition.type !== \"gradient\") {\n      return undefined;\n    }\n\n    try {\n      // Get the cell's evaluation result\n      const evalResult = this.evaluationManager.getCellEvaluationResult(cellAddress);\n      if (!evalResult || evalResult.type !== \"value\") {\n        return undefined;\n      }\n      if (evalResult.result.type !== \"number\") {\n        return undefined;\n      }\n      const cellValue = evalResult.result.value;\n\n      // Calculate min and max values for the gradient\n      const { min: minValue, max: maxValue } = this.calculateGradientBounds(\n        style,\n        cellAddress\n      );\n\n      if (minValue === null || maxValue === null) {\n        return undefined;\n      }\n\n      // Calculate interpolation factor\n      const factor = calculateGradientFactor(cellValue, minValue, maxValue);\n\n      // Interpolate between min and max colors\n      const minColor = style.condition.min.color;\n      const maxColor = style.condition.max.color;\n      const interpolatedColor = interpolateLCH(minColor, maxColor, factor);\n\n      return {\n        backgroundColor: lchToHex(interpolatedColor),\n      };\n    } catch (error) {\n      console.warn(\"Failed to evaluate gradient condition:\", error);\n      return undefined;\n    }\n  }\n\n  /**\n   * Calculate min and max bounds for a gradient\n   */\n  private calculateGradientBounds(\n    style: ConditionalStyle,\n    cellAddress: CellAddress\n  ): { min: number | null; max: number | null } {\n    if (style.condition.type !== \"gradient\") {\n      return { min: null, max: null };\n    }\n\n    const { min: minConfig, max: maxConfig } = style.condition;\n    const topLeftCell: CellAddress = {\n      workbookName: style.area.workbookName,\n      sheetName: style.area.sheetName,\n      colIndex: style.area.range.start.col,\n      rowIndex: style.area.range.start.row,\n    };\n\n    // Calculate min value\n    let minValue: number | null = null;\n    if (minConfig.type === \"lowest_value\") {\n      // Evaluate MIN(range) formula directly\n      try {\n        const rangeRef = this.getRangeReference(style.area);\n        const result = this.evaluationManager.evaluateFormula(\n          `=MIN(${rangeRef})`,\n          topLeftCell\n        );\n        if (typeof result === \"number\") {\n          minValue = result;\n        }\n      } catch (error) {\n        console.warn(\"Failed to calculate MIN:\", error);\n      }\n    } else {\n      // Evaluate valueFormula in context of area's top-left cell\n      const formula = minConfig.valueFormula.startsWith(\"=\")\n        ? minConfig.valueFormula\n        : `=${minConfig.valueFormula}`;\n      const result = this.evaluationManager.evaluateFormula(\n        formula,\n        topLeftCell\n      );\n      if (typeof result === \"number\") {\n        minValue = result;\n      }\n    }\n\n    // Calculate max value\n    let maxValue: number | null = null;\n    if (maxConfig.type === \"highest_value\") {\n      // Evaluate MAX(range) formula directly\n      try {\n        const rangeRef = this.getRangeReference(style.area);\n        const result = this.evaluationManager.evaluateFormula(\n          `=MAX(${rangeRef})`,\n          topLeftCell\n        );\n        if (typeof result === \"number\") {\n          maxValue = result;\n        }\n      } catch (error) {\n        console.warn(\"Failed to calculate MAX:\", error);\n      }\n    } else {\n      // Evaluate valueFormula in context of area's top-left cell\n      const formula = maxConfig.valueFormula.startsWith(\"=\")\n        ? maxConfig.valueFormula\n        : `=${maxConfig.valueFormula}`;\n      const result = this.evaluationManager.evaluateFormula(\n        formula,\n        topLeftCell\n      );\n      if (typeof result === \"number\") {\n        maxValue = result;\n      }\n    }\n\n    return { min: minValue, max: maxValue };\n  }\n\n  /**\n   * Get a range reference string from a RangeAddress\n   * Follows CANONICAL_RANGES.md format:\n   * - Closed: A5:D10\n   * - Row-bounded (col-open): A5:10\n   * - Col-bounded (row-open): A5:D\n   * - Open both: A5:INFINITY\n   */\n  private getRangeReference(area: RangeAddress): string {\n    const colToLetter = (col: number): string => {\n      let result = \"\";\n      let c = col;\n      while (c >= 0) {\n        result = String.fromCharCode(65 + (c % 26)) + result;\n        c = Math.floor(c / 26) - 1;\n      }\n      return result;\n    };\n\n    const startCol = colToLetter(area.range.start.col);\n    const startRow = area.range.start.row + 1; // Convert to 1-based\n\n    const isColInfinity = area.range.end.col.type === \"infinity\";\n    const isRowInfinity = area.range.end.row.type === \"infinity\";\n\n    let rangeStr: string;\n\n    if (isColInfinity && isRowInfinity) {\n      // Open both: A5:INFINITY\n      rangeStr = `${startCol}${startRow}:INFINITY`;\n    } else if (isColInfinity) {\n      // Row-bounded (col-open): A5:10\n      if (area.range.end.row.type === \"number\") {\n        const endRow = area.range.end.row.value + 1; // Convert to 1-based\n        rangeStr = `${startCol}${startRow}:${endRow}`;\n      } else {\n        rangeStr = `${startCol}${startRow}:INFINITY`;\n      }\n    } else if (isRowInfinity) {\n      // Col-bounded (row-open): A5:D\n      if (area.range.end.col.type === \"number\") {\n        const endCol = colToLetter(area.range.end.col.value);\n        rangeStr = `${startCol}${startRow}:${endCol}`;\n      } else {\n        rangeStr = `${startCol}${startRow}:INFINITY`;\n      }\n    } else {\n      // Closed rectangle: A5:D10\n      if (area.range.end.col.type === \"number\" && area.range.end.row.type === \"number\") {\n        const endCol = colToLetter(area.range.end.col.value);\n        const endRow = area.range.end.row.value + 1; // Convert to 1-based\n        rangeStr = `${startCol}${startRow}:${endCol}${endRow}`;\n      } else {\n        // Fallback to INFINITY if types don't match\n        rangeStr = `${startCol}${startRow}:INFINITY`;\n      }\n    }\n\n    // Quote sheet name if it contains spaces or special characters\n    const needsQuotes = /[ '!]/.test(area.sheetName);\n    const sheetRef = needsQuotes ? `'${area.sheetName.replace(/'/g, \"''\")}'` : area.sheetName;\n\n    // Construct the full reference: [workbook]'sheet'!range\n    return `[${area.workbookName}]${sheetRef}!${rangeStr}`;\n  }\n}\n\n"
+  ],
+  "mappings": "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",
+  "debugId": "2984643D5EF61FCB64756E2164756E21",
+  "names": []
+}

package/dist/cjs/core/types.cjs.map

@@ -2,7 +2,7 @@
   "version": 3,
   "sources": ["../../../src/core/types.ts"],
   "sourcesContent": [
-    "/**\n * Core type definitions for FormulaEngine\n * This file contains all fundamental types used throughout the engine\n */\n\nimport type { EvaluationContext } from \"../evaluator/evaluation-context.cjs\";\nimport type { FormulaEvaluator } from \"../evaluator/formula-evaluator.cjs\";\nimport type { FunctionNode } from \"../parser/ast.cjs\";\nimport type { DependencyNode } from \"./managers/dependency-node.cjs\";\nimport type { LookupOrder } from \"./managers/range-eval-order-builder.cjs\";\n\n// Cell addressing types\nexport interface CellAddress {\n  sheetName: string;\n  workbookName: string;\n  colIndex: number;\n  rowIndex: number;\n}\n\nexport interface RangeAddress {\n  sheetName: string;\n  workbookName: string;\n  range: SpreadsheetRange;\n}\n\nexport interface LocalCellAddress {\n  colIndex: number;\n  rowIndex: number;\n}\n\nexport type ArethmeticEvaluator = (\n  left: CellValue,\n  right: CellValue,\n  context: EvaluationContext\n) => CellValue | ErrorEvaluationResult;\n\nexport type PositiveInfinity = {\n  type: \"infinity\";\n  sign: \"positive\";\n};\n\nexport type CellInfinity = {\n  type: \"infinity\";\n  sign: \"positive\" | \"negative\";\n};\n\nexport type CellNumber = {\n  type: \"number\";\n  value: number;\n};\n\nexport type SpreadsheetRangeEnd = CellNumber | PositiveInfinity;\n\nexport type SpreadsheetRange = {\n  start: {\n    col: number;\n    row: number;\n  };\n  end: {\n    col: SpreadsheetRangeEnd;\n    row: SpreadsheetRangeEnd;\n  };\n};\n\nexport type RelativeRange = {\n  start: {\n    col: number;\n    row: number;\n  };\n  width: SpreadsheetRangeEnd;\n  height: SpreadsheetRangeEnd;\n};\n\nexport type FiniteSpreadsheetRange = {\n  start: {\n    col: number;\n    row: number;\n  };\n  end: {\n    col: number;\n    row: number;\n  };\n};\n\nexport type CellString = {\n  type: \"string\";\n  value: string;\n};\n\nexport type CellBoolean = {\n  type: \"boolean\";\n  value: boolean;\n};\n\n// Cell value types\nexport type CellValue = CellNumber | CellString | CellBoolean | CellInfinity;\n/**\n * undefined and \"\" are considered empty values\n * undefineds are converted to \"\" in the engine\n *\n * any empty values are deleted from the sheet content\n */\nexport type SerializedCellValue = string | number | boolean | undefined;\n\n// Named expressions\nexport interface NamedExpression {\n  name: string;\n  expression: string;\n}\n\nexport interface TableDefinition {\n  name: string;\n  start: {\n    rowIndex: number;\n    colIndex: number;\n  };\n  headers: Map<string, { name: string; index: number }>;\n  endRow: SpreadsheetRangeEnd;\n  sheetName: string;\n  workbookName: string;\n}\n\n// Formula errors\nexport enum FormulaError {\n  DIV0 = \"#DIV/0!\",\n  NA = \"#N/A\",\n  NAME = \"#NAME?\",\n  NUM = \"#NUM!\",\n  REF = \"#REF!\",\n  VALUE = \"#VALUE!\",\n  CYCLE = \"#CYCLE!\",\n  ERROR = \"#ERROR!\",\n  SPILL = \"#SPILL!\",\n}\n\n// Sheet structure\nexport interface Sheet {\n  name: string;\n  index: number; // 0-based index of the sheet\n  content: Map<string, SerializedCellValue>;\n}\n\nexport interface Workbook {\n  name: string;\n  sheets: Map<string, Sheet>;\n}\n\nexport type ValueEvaluationResult = {\n  type: \"value\";\n  result: CellValue;\n  /**\n   * If the terminating evaluation result is a reference (see evaluateReference)\n   * then we store information about the source cell for context dependent functions like CELL\n   */\n  sourceCell?: CellAddress;\n};\n\nexport type AwaitingEvaluationResult = {\n  type: \"awaiting-evaluation\";\n  waitingFor: DependencyNode;\n  errAddress: DependencyNode;\n  /**\n   * If the terminating evaluation result is a reference (see evaluateReference)\n   * then we store information about the source cell for context dependent functions like CELL\n   */\n  sourceCell?: CellAddress;\n};\n\nexport type DoesNotSpillResult = {\n  type: \"does-not-spill\";\n};\n\nexport type ErrorEvaluationResult =\n  | {\n      type: \"error\";\n      err: FormulaError;\n      errAddress: DependencyNode;\n      message: string;\n      /**\n       * If the terminating evaluation result is a reference (see evaluateReference)\n       * then we store information about the source cell for context dependent functions like CELL\n       */\n      sourceCell?: CellAddress;\n    }\n  | AwaitingEvaluationResult;\n\nexport type SingleEvaluationResult =\n  | ValueEvaluationResult\n  | ErrorEvaluationResult;\n\nexport type SpilledValuesEvaluator = (\n  spillOffset: { x: number; y: number },\n  context: EvaluationContext\n) => SingleEvaluationResult;\n\nexport type SpilledValuesEvaluationResult = {\n  type: \"spilled-values\";\n\n  /**\n   * When a raw range is evaluated, we will add it to the sourceRange so it can be used e.g. for context dependent functions\n   */\n  sourceRange?: RangeAddress;\n\n  /**\n   * If the terminating evaluation result is a reference (see evaluateReference)\n   * then we store information about the source cell for context dependent functions like CELL\n   * sourceCell will only be defined on a spilledValue when a single value is looked up,\n   */\n  sourceCell?: CellAddress;\n\n  spillArea: (origin: CellAddress) => SpreadsheetRange;\n  /**\n   * for debugging we add a source string to denote where the spilled values were created\n   */\n  source: string;\n  evaluate: SpilledValuesEvaluator;\n  /**\n   * evaluateAllCells evaluates all non-empty cells in the spilled range.\n   * Because a spilled range can be open-ended, we need to have logic for which cells we should evaluate.\n   * e.g. when evaluating a range such as D:D only the cells in the current sheet residing in\n   * column D should be evaluated and cells producing spilled values that spill onto D:D.\n   *\n   * In order to evaluate spilled cells in D:D the range evaluateAllCells need to get all cells in the\n   * the intersection of the spilled range and D:D, for that reason evaluateAllCells gets an intersection parameter,\n   * where the intersection is relative to the origin.\n   *\n   * #### Producers:\n   * In e.g. SEQUENCE and evaluateRange we have logic for which cells in a spilled range we should evaluate,\n   *\n   * #### Nesting:\n   * e.g. evaluation of scalar operators where we want to nest e.g. `5 * right.evaluate()`\n   * can be implemented by calling\n   * ```ts\n   * const vals = child.evaluateAllCells.call(this, options);\n   * return vals.map(val => ({ ...val, result: 5 * val.result }));\n   * ```\n   *\n   * #### Consumers:\n   * Only functions that need access to all spilled values in a range end up calling evaluateAllCells, e.g.\n   * SUM, MIN, MAX, MATCH. Other types of functions like INDEX doesn't need to evaluate all cells in a range,\n   * but does a lookup into a spilled range using the evaluate method.\n   *\n   */\n  evaluateAllCells: (\n    this: FormulaEvaluator,\n    options: {\n      /**\n       * an intersection relative to the origin\n       */\n      intersection?: SpreadsheetRange;\n      evaluate: SpilledValuesEvaluator;\n      context: EvaluationContext;\n      /**\n       * origin is the cell address that the spilled range is spilled from\n       * e.g. in A3=B2:B4 the origin is A3\n       */\n      origin: CellAddress;\n\n      lookupOrder: LookupOrder;\n    }\n  ) => EvaluateAllCellsResult;\n};\n\nexport type EvaluateAllCellsResult =\n  | ErrorEvaluationResult\n  | {\n      type: \"values\";\n      values: CellInRangeResult[];\n    };\n\nexport type CellInRangeResult = {\n  result: SingleEvaluationResult;\n  relativePos: { x: number; y: number };\n};\n\nexport type FunctionEvaluationResult =\n  | SingleEvaluationResult\n  | SpilledValuesEvaluationResult;\n\nexport type SpilledValue = {\n  /**\n   * spillOnto is the range that the spilled value is spilled onto\n   */\n  spillOnto: SpreadsheetRange;\n  /**\n   * origin is the cell address that the spilled value is spilled from\n   */\n  origin: CellAddress;\n};\n\n/**\n * Function definition\n */\nexport interface FunctionDefinition {\n  name: string;\n  evaluate: (\n    this: FormulaEvaluator,\n    node: FunctionNode,\n    context: EvaluationContext\n  ) => FunctionEvaluationResult;\n  aliases?: string[];\n}\n\n/**\n * Evaluation result\n */\nexport type EvaluationResult = {\n  dependencies: Set<string>;\n} & FunctionEvaluationResult;\n\nexport type SCC = {\n  id: number;\n  nodes: Set<DependencyNode>; // All nodes considering soft + hard edges\n  evaluationOrder: DependencyNode[]; // Flat topologically ordered list\n  resolved: boolean;\n  hardEdgeSCCs: Set<DependencyNode>[]; // SCCs formed by only hard edges (regular dependencies)\n};\n\nexport type SCCDAG = {\n  sccList: SCC[];\n  sccGraph: Map<number, Set<number>>; // Adjacency list of SCC dependencies\n};\n\nexport type EvaluationOrder = {\n  evaluationOrder: Set<DependencyNode>;\n  hasCycle: boolean;\n  cycleNodes?: Set<DependencyNode>;\n  hash: string;\n  sccDAG?: SCCDAG;\n};\n"
+    "/**\n * Core type definitions for FormulaEngine\n * This file contains all fundamental types used throughout the engine\n */\n\nimport type { EvaluationContext } from \"../evaluator/evaluation-context.cjs\";\nimport type { FormulaEvaluator } from \"../evaluator/formula-evaluator.cjs\";\nimport type { FunctionNode } from \"../parser/ast.cjs\";\nimport type { DependencyNode } from \"./managers/dependency-node.cjs\";\nimport type { LookupOrder } from \"./managers/range-eval-order-builder.cjs\";\n\n// Cell addressing types\nexport interface CellAddress {\n  sheetName: string;\n  workbookName: string;\n  colIndex: number;\n  rowIndex: number;\n}\n\nexport interface RangeAddress {\n  sheetName: string;\n  workbookName: string;\n  range: SpreadsheetRange;\n}\n\nexport interface LocalCellAddress {\n  colIndex: number;\n  rowIndex: number;\n}\n\nexport type ArethmeticEvaluator = (\n  left: CellValue,\n  right: CellValue,\n  context: EvaluationContext\n) => CellValue | ErrorEvaluationResult;\n\nexport type PositiveInfinity = {\n  type: \"infinity\";\n  sign: \"positive\";\n};\n\nexport type CellInfinity = {\n  type: \"infinity\";\n  sign: \"positive\" | \"negative\";\n};\n\nexport type CellNumber = {\n  type: \"number\";\n  value: number;\n};\n\nexport type SpreadsheetRangeEnd = CellNumber | PositiveInfinity;\n\nexport type SpreadsheetRange = {\n  start: {\n    col: number;\n    row: number;\n  };\n  end: {\n    col: SpreadsheetRangeEnd;\n    row: SpreadsheetRangeEnd;\n  };\n};\n\nexport type RelativeRange = {\n  start: {\n    col: number;\n    row: number;\n  };\n  width: SpreadsheetRangeEnd;\n  height: SpreadsheetRangeEnd;\n};\n\nexport type FiniteSpreadsheetRange = {\n  start: {\n    col: number;\n    row: number;\n  };\n  end: {\n    col: number;\n    row: number;\n  };\n};\n\nexport type CellString = {\n  type: \"string\";\n  value: string;\n};\n\nexport type CellBoolean = {\n  type: \"boolean\";\n  value: boolean;\n};\n\n// Cell value types\nexport type CellValue = CellNumber | CellString | CellBoolean | CellInfinity;\n/**\n * undefined and \"\" are considered empty values\n * undefineds are converted to \"\" in the engine\n *\n * any empty values are deleted from the sheet content\n */\nexport type SerializedCellValue = string | number | boolean | undefined;\n\n// Named expressions\nexport interface NamedExpression {\n  name: string;\n  expression: string;\n}\n\nexport interface TableDefinition {\n  name: string;\n  start: {\n    rowIndex: number;\n    colIndex: number;\n  };\n  headers: Map<string, { name: string; index: number }>;\n  endRow: SpreadsheetRangeEnd;\n  sheetName: string;\n  workbookName: string;\n}\n\n// Formula errors\nexport enum FormulaError {\n  DIV0 = \"#DIV/0!\",\n  NA = \"#N/A\",\n  NAME = \"#NAME?\",\n  NUM = \"#NUM!\",\n  REF = \"#REF!\",\n  VALUE = \"#VALUE!\",\n  CYCLE = \"#CYCLE!\",\n  ERROR = \"#ERROR!\",\n  SPILL = \"#SPILL!\",\n}\n\n// Sheet structure\nexport interface Sheet {\n  name: string;\n  index: number; // 0-based index of the sheet\n  content: Map<string, SerializedCellValue>;\n}\n\nexport interface Workbook {\n  name: string;\n  sheets: Map<string, Sheet>;\n}\n\nexport type ValueEvaluationResult = {\n  type: \"value\";\n  result: CellValue;\n  /**\n   * If the terminating evaluation result is a reference (see evaluateReference)\n   * then we store information about the source cell for context dependent functions like CELL\n   */\n  sourceCell?: CellAddress;\n};\n\nexport type AwaitingEvaluationResult = {\n  type: \"awaiting-evaluation\";\n  waitingFor: DependencyNode;\n  errAddress: DependencyNode;\n  /**\n   * If the terminating evaluation result is a reference (see evaluateReference)\n   * then we store information about the source cell for context dependent functions like CELL\n   */\n  sourceCell?: CellAddress;\n};\n\nexport type DoesNotSpillResult = {\n  type: \"does-not-spill\";\n};\n\nexport type ErrorEvaluationResult =\n  | {\n      type: \"error\";\n      err: FormulaError;\n      errAddress: DependencyNode;\n      message: string;\n      /**\n       * If the terminating evaluation result is a reference (see evaluateReference)\n       * then we store information about the source cell for context dependent functions like CELL\n       */\n      sourceCell?: CellAddress;\n    }\n  | AwaitingEvaluationResult;\n\nexport type SingleEvaluationResult =\n  | ValueEvaluationResult\n  | ErrorEvaluationResult;\n\nexport type SpilledValuesEvaluator = (\n  spillOffset: { x: number; y: number },\n  context: EvaluationContext\n) => SingleEvaluationResult;\n\nexport type SpilledValuesEvaluationResult = {\n  type: \"spilled-values\";\n\n  /**\n   * When a raw range is evaluated, we will add it to the sourceRange so it can be used e.g. for context dependent functions\n   */\n  sourceRange?: RangeAddress;\n\n  /**\n   * If the terminating evaluation result is a reference (see evaluateReference)\n   * then we store information about the source cell for context dependent functions like CELL\n   * sourceCell will only be defined on a spilledValue when a single value is looked up,\n   */\n  sourceCell?: CellAddress;\n\n  spillArea: (origin: CellAddress) => SpreadsheetRange;\n  /**\n   * for debugging we add a source string to denote where the spilled values were created\n   */\n  source: string;\n  evaluate: SpilledValuesEvaluator;\n  /**\n   * evaluateAllCells evaluates all non-empty cells in the spilled range.\n   * Because a spilled range can be open-ended, we need to have logic for which cells we should evaluate.\n   * e.g. when evaluating a range such as D:D only the cells in the current sheet residing in\n   * column D should be evaluated and cells producing spilled values that spill onto D:D.\n   *\n   * In order to evaluate spilled cells in D:D the range evaluateAllCells need to get all cells in the\n   * the intersection of the spilled range and D:D, for that reason evaluateAllCells gets an intersection parameter,\n   * where the intersection is relative to the origin.\n   *\n   * #### Producers:\n   * In e.g. SEQUENCE and evaluateRange we have logic for which cells in a spilled range we should evaluate,\n   *\n   * #### Nesting:\n   * e.g. evaluation of scalar operators where we want to nest e.g. `5 * right.evaluate()`\n   * can be implemented by calling\n   * ```ts\n   * const vals = child.evaluateAllCells.call(this, options);\n   * return vals.map(val => ({ ...val, result: 5 * val.result }));\n   * ```\n   *\n   * #### Consumers:\n   * Only functions that need access to all spilled values in a range end up calling evaluateAllCells, e.g.\n   * SUM, MIN, MAX, MATCH. Other types of functions like INDEX doesn't need to evaluate all cells in a range,\n   * but does a lookup into a spilled range using the evaluate method.\n   *\n   */\n  evaluateAllCells: (\n    this: FormulaEvaluator,\n    options: {\n      /**\n       * an intersection relative to the origin\n       */\n      intersection?: SpreadsheetRange;\n      evaluate: SpilledValuesEvaluator;\n      context: EvaluationContext;\n      /**\n       * origin is the cell address that the spilled range is spilled from\n       * e.g. in A3=B2:B4 the origin is A3\n       */\n      origin: CellAddress;\n\n      lookupOrder: LookupOrder;\n    }\n  ) => EvaluateAllCellsResult;\n};\n\nexport type EvaluateAllCellsResult =\n  | ErrorEvaluationResult\n  | {\n      type: \"values\";\n      values: CellInRangeResult[];\n    };\n\nexport type CellInRangeResult = {\n  result: SingleEvaluationResult;\n  relativePos: { x: number; y: number };\n};\n\nexport type FunctionEvaluationResult =\n  | SingleEvaluationResult\n  | SpilledValuesEvaluationResult;\n\nexport type SpilledValue = {\n  /**\n   * spillOnto is the range that the spilled value is spilled onto\n   */\n  spillOnto: SpreadsheetRange;\n  /**\n   * origin is the cell address that the spilled value is spilled from\n   */\n  origin: CellAddress;\n};\n\n/**\n * Function definition\n */\nexport interface FunctionDefinition {\n  name: string;\n  evaluate: (\n    this: FormulaEvaluator,\n    node: FunctionNode,\n    context: EvaluationContext\n  ) => FunctionEvaluationResult;\n  aliases?: string[];\n}\n\n/**\n * Evaluation result\n */\nexport type EvaluationResult = {\n  dependencies: Set<string>;\n} & FunctionEvaluationResult;\n\nexport type SCC = {\n  id: number;\n  nodes: Set<DependencyNode>; // All nodes considering soft + hard edges\n  evaluationOrder: DependencyNode[]; // Flat topologically ordered list\n  resolved: boolean;\n  hardEdgeSCCs: Set<DependencyNode>[]; // SCCs formed by only hard edges (regular dependencies)\n};\n\nexport type SCCDAG = {\n  sccList: SCC[];\n  sccGraph: Map<number, Set<number>>; // Adjacency list of SCC dependencies\n};\n\nexport type EvaluationOrder = {\n  evaluationOrder: Set<DependencyNode>;\n  hasCycle: boolean;\n  cycleNodes?: Set<DependencyNode>;\n  hash: string;\n  sccDAG?: SCCDAG;\n};\n\n// Conditional Styling types\nexport interface LCHColor {\n  l: number; // Lightness: 0-100\n  c: number; // Chroma: 0-150+\n  h: number; // Hue: 0-360\n}\n\nexport interface FormulaStyleCondition {\n  type: \"formula\";\n  formula: string;\n  color: LCHColor;\n}\n\nexport interface GradientStyleCondition {\n  type: \"gradient\";\n  min:\n    | { type: \"lowest_value\"; color: LCHColor }\n    | { type: \"number\"; color: LCHColor; valueFormula: string };\n  max:\n    | { type: \"highest_value\"; color: LCHColor }\n    | { type: \"number\"; color: LCHColor; valueFormula: string };\n}\n\nexport type StyleCondition = FormulaStyleCondition | GradientStyleCondition;\n\nexport interface ConditionalStyle {\n  area: RangeAddress;\n  condition: StyleCondition;\n}\n\nexport interface DirectCellStyle {\n  area: RangeAddress;\n  style: CellStyle\n}\n\nexport interface CellStyle {\n  backgroundColor?: string; // Hex color format\n  color?: string; // Text color in hex format\n}\n"
   ],
   "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2HO,IAAK;AAAA,CAAL,CAAK,kBAAL;AAAA,EACL,wBAAO;AAAA,EACP,sBAAK;AAAA,EACL,wBAAO;AAAA,EACP,uBAAM;AAAA,EACN,uBAAM;AAAA,EACN,yBAAQ;AAAA,EACR,yBAAQ;AAAA,EACR,yBAAQ;AAAA,EACR,yBAAQ;AAAA,GATE;",
   "debugId": "F54C7C141D21E24164756E2164756E21",

package/dist/cjs/core/utils/color-utils.cjs

@@ -0,0 +1,137 @@
+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/color-utils.ts
+var exports_color_utils = {};
+__export(exports_color_utils, {
+  lchToHex: () => lchToHex,
+  interpolateLCH: () => interpolateLCH,
+  hexToLch: () => hexToLch,
+  calculateGradientFactor: () => calculateGradientFactor
+});
+module.exports = __toCommonJS(exports_color_utils);
+function lchToHex(color) {
+  const { l, c, h } = color;
+  const hRad = h * Math.PI / 180;
+  const a = c * Math.cos(hRad);
+  const b = c * Math.sin(hRad);
+  let y = (l + 16) / 116;
+  let x = a / 500 + y;
+  let z = y - b / 200;
+  const delta = 6 / 29;
+  const deltaCubed = delta * delta * delta;
+  x = x > delta ? x * x * x : 3 * delta * delta * (x - 4 / 29);
+  y = y > delta ? y * y * y : 3 * delta * delta * (y - 4 / 29);
+  z = z > delta ? z * z * z : 3 * delta * delta * (z - 4 / 29);
+  x *= 0.95047;
+  y *= 1;
+  z *= 1.08883;
+  let r = x * 3.2406 + y * -1.5372 + z * -0.4986;
+  let g = x * -0.9689 + y * 1.8758 + z * 0.0415;
+  let bVal = x * 0.0557 + y * -0.204 + z * 1.057;
+  const gammaCorrect = (val) => {
+    return val > 0.0031308 ? 1.055 * Math.pow(val, 1 / 2.4) - 0.055 : 12.92 * val;
+  };
+  r = gammaCorrect(r);
+  g = gammaCorrect(g);
+  bVal = gammaCorrect(bVal);
+  r = Math.max(0, Math.min(1, r)) * 255;
+  g = Math.max(0, Math.min(1, g)) * 255;
+  bVal = Math.max(0, Math.min(1, bVal)) * 255;
+  const toHex = (n) => {
+    const hex = Math.round(n).toString(16);
+    return hex.length === 1 ? "0" + hex : hex;
+  };
+  return `#${toHex(r)}${toHex(g)}${toHex(bVal)}`;
+}
+function hexToLch(hex) {
+  const normalizedHex = hex.startsWith("#") ? hex.slice(1) : hex;
+  const r = parseInt(normalizedHex.slice(0, 2), 16) / 255;
+  const g = parseInt(normalizedHex.slice(2, 4), 16) / 255;
+  const b = parseInt(normalizedHex.slice(4, 6), 16) / 255;
+  const inverseGamma = (val) => {
+    return val > 0.04045 ? Math.pow((val + 0.055) / 1.055, 2.4) : val / 12.92;
+  };
+  let rLinear = inverseGamma(r);
+  let gLinear = inverseGamma(g);
+  let bLinear = inverseGamma(b);
+  let x = rLinear * 0.4124564 + gLinear * 0.3575761 + bLinear * 0.1804375;
+  let y = rLinear * 0.2126729 + gLinear * 0.7151522 + bLinear * 0.072175;
+  let z = rLinear * 0.0193339 + gLinear * 0.119192 + bLinear * 0.9503041;
+  x /= 0.95047;
+  y /= 1;
+  z /= 1.08883;
+  const f = (t) => {
+    const delta = 6 / 29;
+    if (t > delta * delta * delta) {
+      return Math.cbrt(t);
+    }
+    return t / (3 * delta * delta) + 4 / 29;
+  };
+  const fx = f(x);
+  const fy = f(y);
+  const fz = f(z);
+  const l = 116 * fy - 16;
+  const a = 500 * (fx - fy);
+  const bLab = 200 * (fy - fz);
+  const c = Math.sqrt(a * a + bLab * bLab);
+  let h = Math.atan2(bLab, a) * (180 / Math.PI);
+  if (h < 0) {
+    h += 360;
+  }
+  return {
+    l: Math.max(0, Math.min(100, l)),
+    c: Math.max(0, c),
+    h
+  };
+}
+function interpolateLCH(color1, color2, t) {
+  t = Math.max(0, Math.min(1, t));
+  const l = color1.l + (color2.l - color1.l) * t;
+  const c = color1.c + (color2.c - color1.c) * t;
+  let h1 = color1.h;
+  let h2 = color2.h;
+  const diff = h2 - h1;
+  if (diff > 180) {
+    h1 += 360;
+  } else if (diff < -180) {
+    h2 += 360;
+  }
+  let h = h1 + (h2 - h1) * t;
+  h = (h % 360 + 360) % 360;
+  return { l, c, h };
+}
+function calculateGradientFactor(value, min, max) {
+  if (max === min) {
+    return 0.5;
+  }
+  const factor = (value - min) / (max - min);
+  return Math.max(0, Math.min(1, factor));
+}
+
+//# debugId=D8283E7787ACB0EE64756E2164756E21

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/utils/color-utils.ts"],
+  "sourcesContent": [
+    "/**\n * Color utilities for conditional styling\n * Handles LCH color space conversions and interpolation\n */\n\nimport type { LCHColor } from \"../types.cjs\";\n\n/**\n * Convert LCH color to hex string\n * LCH uses the CIELCH color space which provides perceptually uniform colors\n */\nexport function lchToHex(color: LCHColor): string {\n  // First convert LCH to LAB\n  const { l, c, h } = color;\n  const hRad = (h * Math.PI) / 180;\n  const a = c * Math.cos(hRad);\n  const b = c * Math.sin(hRad);\n\n  // Then convert LAB to XYZ (using D65 illuminant)\n  let y = (l + 16) / 116;\n  let x = a / 500 + y;\n  let z = y - b / 200;\n\n  // Apply inverse f function\n  const delta = 6 / 29;\n  const deltaCubed = delta * delta * delta;\n  \n  x = x > delta ? x * x * x : 3 * delta * delta * (x - 4 / 29);\n  y = y > delta ? y * y * y : 3 * delta * delta * (y - 4 / 29);\n  z = z > delta ? z * z * z : 3 * delta * delta * (z - 4 / 29);\n\n  // Scale by D65 white point\n  x *= 0.95047;\n  y *= 1.0;\n  z *= 1.08883;\n\n  // Convert XYZ to RGB\n  let r = x * 3.2406 + y * -1.5372 + z * -0.4986;\n  let g = x * -0.9689 + y * 1.8758 + z * 0.0415;\n  let bVal = x * 0.0557 + y * -0.204 + z * 1.057;\n\n  // Apply gamma correction\n  const gammaCorrect = (val: number) => {\n    return val > 0.0031308\n      ? 1.055 * Math.pow(val, 1 / 2.4) - 0.055\n      : 12.92 * val;\n  };\n\n  r = gammaCorrect(r);\n  g = gammaCorrect(g);\n  bVal = gammaCorrect(bVal);\n\n  // Clamp to [0, 1] and convert to 0-255\n  r = Math.max(0, Math.min(1, r)) * 255;\n  g = Math.max(0, Math.min(1, g)) * 255;\n  bVal = Math.max(0, Math.min(1, bVal)) * 255;\n\n  // Convert to hex\n  const toHex = (n: number) => {\n    const hex = Math.round(n).toString(16);\n    return hex.length === 1 ? \"0\" + hex : hex;\n  };\n\n  return `#${toHex(r)}${toHex(g)}${toHex(bVal)}`;\n}\n\n/**\n * Convert hex color string to LCH color\n * @param hex Hex color string (e.g., \"#FF0000\" or \"FF0000\")\n * @returns LCH color\n */\nexport function hexToLch(hex: string): LCHColor {\n  // Remove # if present and normalize\n  const normalizedHex = hex.startsWith(\"#\") ? hex.slice(1) : hex;\n  \n  // Parse RGB values\n  const r = parseInt(normalizedHex.slice(0, 2), 16) / 255;\n  const g = parseInt(normalizedHex.slice(2, 4), 16) / 255;\n  const b = parseInt(normalizedHex.slice(4, 6), 16) / 255;\n\n  // Apply inverse gamma correction\n  const inverseGamma = (val: number) => {\n    return val > 0.04045\n      ? Math.pow((val + 0.055) / 1.055, 2.4)\n      : val / 12.92;\n  };\n\n  let rLinear = inverseGamma(r);\n  let gLinear = inverseGamma(g);\n  let bLinear = inverseGamma(b);\n\n  // Convert RGB to XYZ (using sRGB matrix)\n  let x = rLinear * 0.4124564 + gLinear * 0.3575761 + bLinear * 0.1804375;\n  let y = rLinear * 0.2126729 + gLinear * 0.7151522 + bLinear * 0.0721750;\n  let z = rLinear * 0.0193339 + gLinear * 0.1191920 + bLinear * 0.9503041;\n\n  // Normalize by D65 white point\n  x /= 0.95047;\n  y /= 1.0;\n  z /= 1.08883;\n\n  // Convert XYZ to LAB\n  const f = (t: number) => {\n    const delta = 6 / 29;\n    if (t > delta * delta * delta) {\n      return Math.cbrt(t);\n    }\n    return t / (3 * delta * delta) + 4 / 29;\n  };\n\n  const fx = f(x);\n  const fy = f(y);\n  const fz = f(z);\n\n  const l = 116 * fy - 16;\n  const a = 500 * (fx - fy);\n  const bLab = 200 * (fy - fz);\n\n  // Convert LAB to LCH\n  const c = Math.sqrt(a * a + bLab * bLab);\n  let h = Math.atan2(bLab, a) * (180 / Math.PI);\n  \n  // Normalize hue to [0, 360)\n  if (h < 0) {\n    h += 360;\n  }\n\n  return {\n    l: Math.max(0, Math.min(100, l)),\n    c: Math.max(0, c),\n    h: h,\n  };\n}\n\n/**\n * Interpolate between two LCH colors\n * @param color1 Starting color\n * @param color2 Ending color\n * @param t Interpolation factor (0-1)\n * @returns Interpolated LCH color\n */\nexport function interpolateLCH(\n  color1: LCHColor,\n  color2: LCHColor,\n  t: number\n): LCHColor {\n  // Clamp t to [0, 1]\n  t = Math.max(0, Math.min(1, t));\n\n  // Interpolate lightness and chroma linearly\n  const l = color1.l + (color2.l - color1.l) * t;\n  const c = color1.c + (color2.c - color1.c) * t;\n\n  // Interpolate hue taking the shortest path around the circle\n  let h1 = color1.h;\n  let h2 = color2.h;\n\n  // Find shortest path\n  const diff = h2 - h1;\n  if (diff > 180) {\n    h1 += 360;\n  } else if (diff < -180) {\n    h2 += 360;\n  }\n\n  let h = h1 + (h2 - h1) * t;\n\n  // Normalize hue to [0, 360)\n  h = ((h % 360) + 360) % 360;\n\n  return { l, c, h };\n}\n\n/**\n * Calculate interpolation factor for a value within a range\n * @param value Current value\n * @param min Minimum value\n * @param max Maximum value\n * @returns Factor between 0 and 1\n */\nexport function calculateGradientFactor(\n  value: number,\n  min: number,\n  max: number\n): number {\n  // Handle edge cases\n  if (max === min) {\n    return 0.5; // If min equals max, return middle value\n  }\n\n  // Calculate factor and clamp to [0, 1]\n  const factor = (value - min) / (max - min);\n  return Math.max(0, Math.min(1, factor));\n}\n\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWO,SAAS,QAAQ,CAAC,OAAyB;AAAA,EAEhD,QAAQ,GAAG,GAAG,MAAM;AAAA,EACpB,MAAM,OAAQ,IAAI,KAAK,KAAM;AAAA,EAC7B,MAAM,IAAI,IAAI,KAAK,IAAI,IAAI;AAAA,EAC3B,MAAM,IAAI,IAAI,KAAK,IAAI,IAAI;AAAA,EAG3B,IAAI,KAAK,IAAI,MAAM;AAAA,EACnB,IAAI,IAAI,IAAI,MAAM;AAAA,EAClB,IAAI,IAAI,IAAI,IAAI;AAAA,EAGhB,MAAM,QAAQ,IAAI;AAAA,EAClB,MAAM,aAAa,QAAQ,QAAQ;AAAA,EAEnC,IAAI,IAAI,QAAQ,IAAI,IAAI,IAAI,IAAI,QAAQ,SAAS,IAAI,IAAI;AAAA,EACzD,IAAI,IAAI,QAAQ,IAAI,IAAI,IAAI,IAAI,QAAQ,SAAS,IAAI,IAAI;AAAA,EACzD,IAAI,IAAI,QAAQ,IAAI,IAAI,IAAI,IAAI,QAAQ,SAAS,IAAI,IAAI;AAAA,EAGzD,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EAGL,IAAI,IAAI,IAAI,SAAS,IAAI,UAAU,IAAI;AAAA,EACvC,IAAI,IAAI,IAAI,UAAU,IAAI,SAAS,IAAI;AAAA,EACvC,IAAI,OAAO,IAAI,SAAS,IAAI,SAAS,IAAI;AAAA,EAGzC,MAAM,eAAe,CAAC,QAAgB;AAAA,IACpC,OAAO,MAAM,YACT,QAAQ,KAAK,IAAI,KAAK,IAAI,GAAG,IAAI,QACjC,QAAQ;AAAA;AAAA,EAGd,IAAI,aAAa,CAAC;AAAA,EAClB,IAAI,aAAa,CAAC;AAAA,EAClB,OAAO,aAAa,IAAI;AAAA,EAGxB,IAAI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC,IAAI;AAAA,EAClC,IAAI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC,IAAI;AAAA,EAClC,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC,IAAI;AAAA,EAGxC,MAAM,QAAQ,CAAC,MAAc;AAAA,IAC3B,MAAM,MAAM,KAAK,MAAM,CAAC,EAAE,SAAS,EAAE;AAAA,IACrC,OAAO,IAAI,WAAW,IAAI,MAAM,MAAM;AAAA;AAAA,EAGxC,OAAO,IAAI,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,MAAM,IAAI;AAAA;AAQtC,SAAS,QAAQ,CAAC,KAAuB;AAAA,EAE9C,MAAM,gBAAgB,IAAI,WAAW,GAAG,IAAI,IAAI,MAAM,CAAC,IAAI;AAAA,EAG3D,MAAM,IAAI,SAAS,cAAc,MAAM,GAAG,CAAC,GAAG,EAAE,IAAI;AAAA,EACpD,MAAM,IAAI,SAAS,cAAc,MAAM,GAAG,CAAC,GAAG,EAAE,IAAI;AAAA,EACpD,MAAM,IAAI,SAAS,cAAc,MAAM,GAAG,CAAC,GAAG,EAAE,IAAI;AAAA,EAGpD,MAAM,eAAe,CAAC,QAAgB;AAAA,IACpC,OAAO,MAAM,UACT,KAAK,KAAK,MAAM,SAAS,OAAO,GAAG,IACnC,MAAM;AAAA;AAAA,EAGZ,IAAI,UAAU,aAAa,CAAC;AAAA,EAC5B,IAAI,UAAU,aAAa,CAAC;AAAA,EAC5B,IAAI,UAAU,aAAa,CAAC;AAAA,EAG5B,IAAI,IAAI,UAAU,YAAY,UAAU,YAAY,UAAU;AAAA,EAC9D,IAAI,IAAI,UAAU,YAAY,UAAU,YAAY,UAAU;AAAA,EAC9D,IAAI,IAAI,UAAU,YAAY,UAAU,WAAY,UAAU;AAAA,EAG9D,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EAGL,MAAM,IAAI,CAAC,MAAc;AAAA,IACvB,MAAM,QAAQ,IAAI;AAAA,IAClB,IAAI,IAAI,QAAQ,QAAQ,OAAO;AAAA,MAC7B,OAAO,KAAK,KAAK,CAAC;AAAA,IACpB;AAAA,IACA,OAAO,KAAK,IAAI,QAAQ,SAAS,IAAI;AAAA;AAAA,EAGvC,MAAM,KAAK,EAAE,CAAC;AAAA,EACd,MAAM,KAAK,EAAE,CAAC;AAAA,EACd,MAAM,KAAK,EAAE,CAAC;AAAA,EAEd,MAAM,IAAI,MAAM,KAAK;AAAA,EACrB,MAAM,IAAI,OAAO,KAAK;AAAA,EACtB,MAAM,OAAO,OAAO,KAAK;AAAA,EAGzB,MAAM,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI;AAAA,EACvC,IAAI,IAAI,KAAK,MAAM,MAAM,CAAC,KAAK,MAAM,KAAK;AAAA,EAG1C,IAAI,IAAI,GAAG;AAAA,IACT,KAAK;AAAA,EACP;AAAA,EAEA,OAAO;AAAA,IACL,GAAG,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,CAAC,CAAC;AAAA,IAC/B,GAAG,KAAK,IAAI,GAAG,CAAC;AAAA,IAChB;AAAA,EACF;AAAA;AAUK,SAAS,cAAc,CAC5B,QACA,QACA,GACU;AAAA,EAEV,IAAI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC;AAAA,EAG9B,MAAM,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK;AAAA,EAC7C,MAAM,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK;AAAA,EAG7C,IAAI,KAAK,OAAO;AAAA,EAChB,IAAI,KAAK,OAAO;AAAA,EAGhB,MAAM,OAAO,KAAK;AAAA,EAClB,IAAI,OAAO,KAAK;AAAA,IACd,MAAM;AAAA,EACR,EAAO,SAAI,OAAO,MAAM;AAAA,IACtB,MAAM;AAAA,EACR;AAAA,EAEA,IAAI,IAAI,MAAM,KAAK,MAAM;AAAA,EAGzB,KAAM,IAAI,MAAO,OAAO;AAAA,EAExB,OAAO,EAAE,GAAG,GAAG,EAAE;AAAA;AAUZ,SAAS,uBAAuB,CACrC,OACA,KACA,KACQ;AAAA,EAER,IAAI,QAAQ,KAAK;AAAA,IACf,OAAO;AAAA,EACT;AAAA,EAGA,MAAM,UAAU,QAAQ,QAAQ,MAAM;AAAA,EACtC,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,CAAC;AAAA;",
+  "debugId": "D8283E7787ACB0EE64756E2164756E21",
+  "names": []
+}