@odoo/o-spreadsheet 19.1.2 → 19.2.0-alpha.2

package/dist/o-spreadsheet-engine.d.ts

@@ -143,12 +143,11 @@ type BarChartRuntime = {
 interface GenericCriterion {
     type: GenericCriterionType;
     values: string[];
+    isPercent?: boolean;
+    isBottom?: boolean;
 }
-type GenericCriterionType = "containsText" | "notContainsText" | "isEqualText" | "isEmail" | "isLink" | "dateIs" | "dateIsBefore" | "dateIsOnOrBefore" | "dateIsAfter" | "dateIsOnOrAfter" | "dateIsBetween" | "dateIsNotBetween" | "dateIsValid" | "isEqual" | "isNotEqual" | "isGreaterThan" | "isGreaterOrEqualTo" | "isLessThan" | "isLessOrEqualTo" | "isBetween" | "isNotBetween" | "isBoolean" | "isValueInList" | "isValueInRange" | "customFormula" | "beginsWithText" | "endsWithText" | "isNotEmpty" | "isEmpty";
+type GenericCriterionType = "containsText" | "notContainsText" | "isEqualText" | "isEmail" | "isLink" | "dateIs" | "dateIsBefore" | "dateIsOnOrBefore" | "dateIsAfter" | "dateIsOnOrAfter" | "dateIsBetween" | "dateIsNotBetween" | "dateIsValid" | "isEqual" | "isNotEqual" | "isGreaterThan" | "isGreaterOrEqualTo" | "isLessThan" | "isLessOrEqualTo" | "isBetween" | "isNotBetween" | "isBoolean" | "isValueInList" | "isValueInRange" | "customFormula" | "beginsWithText" | "endsWithText" | "isNotEmpty" | "isEmpty" | "top10";
 type DateCriterionValue = "today" | "tomorrow" | "yesterday" | "lastWeek" | "lastMonth" | "lastYear" | "exactDate";
-type EvaluatedCriterion<T extends GenericCriterion = GenericCriterion> = Omit<T, "values"> & {
-    values: CellValue[];
-};
 
 interface RangePart {
     readonly colFixed: boolean;
@@ -646,6 +645,8 @@ interface CellIsRule extends SingleColorRule {
     operator: ConditionalFormattingOperatorValues;
     values: string[];
     dateValue?: DateCriterionValue;
+    isPercent?: boolean;
+    isBottom?: boolean;
 }
 type ThresholdType = "value" | "number" | "percentage" | "percentile" | "formula";
 type ColorScaleThreshold = {
@@ -688,7 +689,7 @@ interface IconSetRule {
     upperInflectionPoint: IconThreshold;
     lowerInflectionPoint: IconThreshold;
 }
-declare const cfOperators: readonly ["containsText", "notContainsText", "isGreaterThan", "isGreaterOrEqualTo", "isLessThan", "isLessOrEqualTo", "isBetween", "isNotBetween", "beginsWithText", "endsWithText", "isNotEmpty", "isEmpty", "isNotEqual", "isEqual", "customFormula", "dateIs", "dateIsBefore", "dateIsAfter", "dateIsOnOrBefore", "dateIsOnOrAfter"];
+declare const cfOperators: readonly ["containsText", "notContainsText", "isGreaterThan", "isGreaterOrEqualTo", "isLessThan", "isLessOrEqualTo", "isBetween", "isNotBetween", "beginsWithText", "endsWithText", "isNotEmpty", "isEmpty", "isNotEqual", "isEqual", "customFormula", "dateIs", "dateIsBefore", "dateIsAfter", "dateIsOnOrBefore", "dateIsOnOrAfter", "top10"];
 type ConditionalFormattingOperatorValues = (typeof cfOperators)[number];
 
 interface ConditionalFormatState {
@@ -2756,6 +2757,9 @@ type SheetValidationResult = {
 declare class EvaluationDataValidationPlugin extends CoreViewPlugin {
     static getters: readonly ["getDataValidationInvalidCriterionValueMessage", "getInvalidDataValidationMessage", "getValidationResultForCellValue", "getDataValidationRangeValues", "isCellValidCheckbox", "getDataValidationCellStyle", "getDataValidationChipStyle", "isDataValidationInvalid"];
     validationResults: Record<UID, SheetValidationResult>;
+    criterionPreComputeResult: Record<UID, {
+        [dvRuleId: UID]: unknown;
+    }>;
     handle(cmd: CoreViewCommand): void;
     isDataValidationInvalid(cellPosition: CellPosition): boolean;
     getDataValidationCellStyle(position: CellPosition): Style | undefined;
@@ -2767,7 +2771,7 @@ declare class EvaluationDataValidationPlugin extends CoreViewPlugin {
      * The value must be canonicalized.
      */
     getDataValidationInvalidCriterionValueMessage(criterionType: DataValidationCriterionType, value: string): string | undefined;
-    getDataValidationRangeValues(sheetId: UID, criterion: EvaluatedCriterion): {
+    getDataValidationRangeValues(sheetId: UID, criterion: GenericCriterion): {
         value: string;
         label: string;
     }[];

package/dist/o-spreadsheet-engine.esm.js

@@ -3,8 +3,8 @@
  * This file is generated by o-spreadsheet build tools. Do not edit it.
  * @see https://github.com/odoo/o-spreadsheet
  * @version 19.1.0-alpha.3
- * @date 2026-01-07T16:20:59.139Z
- * @hash febc3e9
+ * @date 2026-01-07T16:20:57.293Z
+ * @hash ac2fa3e
  */
 
 class FunctionCodeBuilder {
@@ -14251,6 +14251,7 @@ const DVTerms = {
         dateValue: _t("The value must be a date"),
         validRange: _t("The value must be a valid range"),
         validFormula: _t("The formula must be valid"),
+        positiveNumber: _t("The value must be a positive number"),
     },
     Errors: {
         ["InvalidRange" /* CommandResult.InvalidRange */]: _t("The range is invalid."),
@@ -22402,6 +22403,7 @@ const CF_OPERATOR_TYPE_CONVERSION_MAP = {
     greaterThanOrEqual: "isGreaterOrEqualTo",
     lessThan: "isLessThan",
     lessThanOrEqual: "isLessOrEqualTo",
+    top10: "top10",
 };
 /** Conversion map CF types in XLSX <=> Cf types in o_spreadsheet */
 const CF_TYPE_CONVERSION_MAP = {
@@ -22942,6 +22944,7 @@ function convertConditionalFormats(xlsxCfs, dxfs, warningManager) {
         const rule = cf.cfRules[0];
         let operator;
         const values = [];
+        const cfAdditionalProperties = {};
         if (rule.dxfId === undefined &&
             !(rule.type === "colorScale" || rule.type === "iconSet" || rule.type === "dataBar"))
             continue;
@@ -22950,7 +22953,6 @@ function convertConditionalFormats(xlsxCfs, dxfs, warningManager) {
             case "containsErrors":
             case "notContainsErrors":
             case "duplicateValues":
-            case "top10":
             case "uniqueValues":
             case "timePeriod":
                 // Not supported
@@ -23001,6 +23003,18 @@ function convertConditionalFormats(xlsxCfs, dxfs, warningManager) {
                     values.push(prefixFormulaWithEqual(rule.formula[1]));
                 }
                 break;
+            case "top10":
+                if (rule.rank === undefined)
+                    continue;
+                operator = CF_OPERATOR_TYPE_CONVERSION_MAP[rule.type];
+                values.push(rule.rank.toString());
+                if (rule.percent) {
+                    cfAdditionalProperties.isPercent = true;
+                }
+                if (rule.bottom) {
+                    cfAdditionalProperties.isBottom = true;
+                }
+                break;
         }
         if (operator && rule.dxfId !== undefined) {
             cfs.push({
@@ -23011,6 +23025,7 @@ function convertConditionalFormats(xlsxCfs, dxfs, warningManager) {
                     type: "CellIsRule",
                     operator: operator,
                     values: values,
+                    ...cfAdditionalProperties,
                     style: convertStyle({ fontStyle: dxfs[rule.dxfId].font, fillStyle: dxfs[rule.dxfId].fill }, warningManager),
                 },
             });
@@ -23304,6 +23319,8 @@ function convertOperator(operator) {
             return "greaterThanOrEqual";
         case "dateIsOnOrBefore":
             return "lessThanOrEqual";
+        case "top10":
+            return "top10";
     }
 }
 // -------------------------------------
@@ -29364,15 +29381,20 @@ criterionEvaluatorRegistry.add("isValueInList", {
     getPreview: (criterion) => _t("Value one of: %s", criterion.values.join(", ")),
 });
 criterionEvaluatorRegistry.add("isValueInRange", {
-    type: "isValueInList",
-    isValueValid: (value, criterion, getters, sheetId) => {
+    type: "isValueInRange",
+    preComputeCriterion: (criterion, criterionRanges, getters) => {
+        if (criterionRanges.length === 0) {
+            return new Set();
+        }
+        const sheetId = criterionRanges[0].sheetId;
+        const criterionValues = getters.getDataValidationRangeValues(sheetId, criterion);
+        return new Set(criterionValues.map((value) => value.value.toString().toLowerCase()));
+    },
+    isValueValid: (value, criterion, valuesSet) => {
         if (!value) {
             return false;
         }
-        const criterionValues = getters.getDataValidationRangeValues(sheetId, criterion);
-        return criterionValues
-            .map((value) => value.value.toLowerCase())
-            .includes(value.toString().toLowerCase());
+        return valuesSet.has(value.toString().toLowerCase());
     },
     getErrorString: (criterion) => _t("The value must be a value in the range %s", String(criterion.values[0])),
     isCriterionValueValid: (value) => rangeReference.test(value),
@@ -29449,6 +29471,67 @@ criterionEvaluatorRegistry.add("isNotEmpty", {
     name: _t("Is not empty"),
     getPreview: () => _t("Is not empty"),
 });
+criterionEvaluatorRegistry.add("top10", {
+    type: "top10",
+    preComputeCriterion: (criterion, criterionRanges, getters) => {
+        let value = tryToNumber(criterion.values[0], DEFAULT_LOCALE);
+        if (value === undefined || value <= 0) {
+            return undefined;
+        }
+        const numberValues = [];
+        for (const range of criterionRanges) {
+            for (const value of getters.getRangeValues(range)) {
+                if (typeof value === "number") {
+                    numberValues.push(value);
+                }
+            }
+        }
+        const sortedValues = numberValues.sort((a, b) => a - b);
+        if (criterion.isPercent) {
+            value = clip(value, 1, 100);
+        }
+        let index = 0;
+        if (criterion.isBottom && !criterion.isPercent) {
+            index = value - 1;
+        }
+        else if (criterion.isBottom && criterion.isPercent) {
+            index = Math.floor((sortedValues.length * value) / 100) - 1;
+        }
+        else if (!criterion.isBottom && criterion.isPercent) {
+            index = sortedValues.length - Math.floor((sortedValues.length * value) / 100);
+        }
+        else {
+            index = sortedValues.length - value;
+        }
+        index = clip(index, 0, sortedValues.length - 1);
+        return sortedValues[index];
+    },
+    isValueValid: (value, criterion, threshold) => {
+        if (typeof value !== "number" || threshold === undefined) {
+            return false;
+        }
+        return criterion.isBottom ? value <= threshold : value >= threshold;
+    },
+    getErrorString: (criterion) => {
+        const args = {
+            value: String(criterion.values[0]),
+            percentSymbol: criterion.isPercent ? "%" : "",
+        };
+        return criterion.isBottom
+            ? _t("The value must be in bottom %(value)s%(percentSymbol)s", args)
+            : _t("The value must be in top %(value)s%(percentSymbol)s", args);
+    },
+    isCriterionValueValid: (value) => checkValueIsPositiveNumber(value),
+    criterionValueErrorString: DVTerms.CriterionError.positiveNumber,
+    numberOfValues: () => 1,
+    name: _t("Is in Top/Bottom ranking"),
+    getPreview: (criterion) => {
+        const args = { value: criterion.values[0], percentSymbol: criterion.isPercent ? "%" : "" };
+        return criterion.isBottom
+            ? _t("Value is in bottom %(value)s%(percentSymbol)s", args)
+            : _t("Value is in top %(value)s%(percentSymbol)s", args);
+    },
+});
 function getNumberCriterionlocalizedValues(criterion, locale) {
     return criterion.values.map((value) => {
         return value !== undefined
@@ -29470,6 +29553,10 @@ function checkValueIsNumber(value) {
     const valueAsNumber = tryToNumber(value, DEFAULT_LOCALE);
     return valueAsNumber !== undefined;
 }
+function checkValueIsPositiveNumber(value) {
+    const valueAsNumber = tryToNumber(value, DEFAULT_LOCALE);
+    return valueAsNumber !== undefined && valueAsNumber > 0;
+}
 
 // -----------------------------------------------------------------------------
 // Constants
@@ -39800,6 +39887,10 @@ class EvaluationConditionalFormatPlugin extends CoreViewPlugin {
                     break;
                 case "CellIsRule":
                     const formulas = cf.rule.values.map((value) => value.startsWith("=") ? compile(value) : undefined);
+                    const evaluator = criterionEvaluatorRegistry.get(cf.rule.operator);
+                    const criterion = { ...cf.rule, type: cf.rule.operator };
+                    const ranges = cf.ranges.map((xc) => this.getters.getRangeFromSheetXC(sheetId, xc));
+                    const preComputedCriterion = evaluator.preComputeCriterion?.(criterion, ranges, this.getters);
                     for (const ref of cf.ranges) {
                         const zone = this.getters.getRangeFromSheetXC(sheetId, ref).zone;
                         for (let row = zone.top; row <= zone.bottom; row++) {
@@ -39812,7 +39903,7 @@ class EvaluationConditionalFormatPlugin extends CoreViewPlugin {
                                     }
                                     return value;
                                 });
-                                if (this.getRuleResultForTarget(target, { ...cf.rule, values })) {
+                                if (this.getRuleResultForTarget(target, { ...cf.rule, values }, preComputedCriterion)) {
                                     if (!computedStyle[col])
                                         computedStyle[col] = [];
                                     // we must combine all the properties of all the CF rules applied to the given cell
@@ -39975,7 +40066,7 @@ class EvaluationConditionalFormatPlugin extends CoreViewPlugin {
             }
         }
     }
-    getRuleResultForTarget(target, rule) {
+    getRuleResultForTarget(target, rule, preComputedCriterion) {
         const cell = this.getters.getEvaluatedCell(target);
         if (cell.type === CellValueType.error) {
             return false;
@@ -39992,11 +40083,12 @@ class EvaluationConditionalFormatPlugin extends CoreViewPlugin {
             return false;
         }
         const evaluatedCriterion = {
+            ...rule,
             type: rule.operator,
             values: evaluatedCriterionValues.map(toScalar),
             dateValue: rule.dateValue || "exactDate",
         };
-        return evaluator.isValueValid(cell.value ?? "", evaluatedCriterion, this.getters, sheetId);
+        return evaluator.isValueValid(cell.value ?? "", evaluatedCriterion, preComputedCriterion);
     }
 }
 
@@ -40013,17 +40105,20 @@ class EvaluationDataValidationPlugin extends CoreViewPlugin {
         "isDataValidationInvalid",
     ];
     validationResults = {};
+    criterionPreComputeResult = {};
     handle(cmd) {
         if (invalidateEvaluationCommands.has(cmd.type) ||
             cmd.type === "EVALUATE_CELLS" ||
             (cmd.type === "UPDATE_CELL" && ("content" in cmd || "format" in cmd))) {
             this.validationResults = {};
+            this.criterionPreComputeResult = {};
             return;
         }
         switch (cmd.type) {
             case "ADD_DATA_VALIDATION_RULE":
             case "REMOVE_DATA_VALIDATION_RULE":
                 delete this.validationResults[cmd.sheetId];
+                delete this.criterionPreComputeResult[cmd.sheetId];
                 break;
         }
     }
@@ -40166,7 +40261,15 @@ class EvaluationDataValidationPlugin extends CoreViewPlugin {
             return undefined;
         }
         const evaluatedCriterion = { ...criterion, values: evaluatedCriterionValues.map(toScalar) };
-        if (evaluator.isValueValid(cellValue, evaluatedCriterion, this.getters, sheetId)) {
+        if (!this.criterionPreComputeResult[sheetId]) {
+            this.criterionPreComputeResult[sheetId] = {};
+        }
+        let preComputedCriterion = this.criterionPreComputeResult[sheetId][rule.id];
+        if (preComputedCriterion === undefined) {
+            preComputedCriterion = evaluator.preComputeCriterion?.(rule.criterion, rule.ranges, this.getters);
+            this.criterionPreComputeResult[sheetId][rule.id] = preComputedCriterion;
+        }
+        if (evaluator.isValueValid(cellValue, evaluatedCriterion, preComputedCriterion)) {
             return undefined;
         }
         return evaluator.getErrorString(evaluatedCriterion, this.getters, sheetId);
@@ -45498,6 +45601,7 @@ class FilterEvaluationPlugin extends UIPlugin {
                 if (filterValue.type === "none")
                     continue;
                 const evaluator = criterionEvaluatorRegistry.get(filterValue.type);
+                const preComputedCriterion = evaluator.preComputeCriterion?.(filterValue, [filter.filteredRange], this.getters);
                 const evaluatedCriterionValues = filterValue.values.map((value) => {
                     if (!value.startsWith("=")) {
                         return parseLiteral(value, DEFAULT_LOCALE);
@@ -45515,7 +45619,7 @@ class FilterEvaluationPlugin extends UIPlugin {
                 for (let row = filteredZone.top; row <= filteredZone.bottom; row++) {
                     const position = { sheetId, col: filter.col, row };
                     const value = this.getters.getEvaluatedCell(position).value ?? "";
-                    if (!evaluator.isValueValid(value, evaluatedCriterion, this.getters, sheetId)) {
+                    if (!evaluator.isValueValid(value, evaluatedCriterion, preComputedCriterion)) {
                         hiddenRows.add(row);
                     }
                 }
@@ -49656,6 +49760,8 @@ function cellRuleFormula(ranges, rule) {
                 case undefined:
                     throw new Error("dateValue should be defined");
             }
+        case "top10":
+            return [];
     }
 }
 function cellRuleTypeAttributes(rule) {
@@ -49688,6 +49794,14 @@ function cellRuleTypeAttributes(rule) {
         case "dateIs":
         case "customFormula":
             return [["type", "expression"]];
+        case "top10": {
+            return [
+                ["type", "top10"],
+                ["rank", rule.values[0]],
+                ["percent", rule.isPercent ? "1" : "0"],
+                ["bottom", rule.isBottom ? "1" : "0"],
+            ];
+        }
     }
 }
 function addDataBarRule(cf, rule) {
@@ -51560,5 +51674,5 @@ export { BadExpressionError, BasePlugin, CellErrorType, CircularDependencyError,
 
 
 __info__.version = "19.1.0-alpha.3";
-__info__.date = "2026-01-07T16:20:59.139Z";
-__info__.hash = "febc3e9";
+__info__.date = "2026-01-07T16:20:57.293Z";
+__info__.hash = "ac2fa3e";

package/dist/o-spreadsheet-engine.iife.js

@@ -3,8 +3,8 @@
  * This file is generated by o-spreadsheet build tools. Do not edit it.
  * @see https://github.com/odoo/o-spreadsheet
  * @version 19.1.0-alpha.3
- * @date 2026-01-07T16:20:59.139Z
- * @hash febc3e9
+ * @date 2026-01-07T16:20:57.293Z
+ * @hash ac2fa3e
  */
 
 (function (exports) {
@@ -14254,6 +14254,7 @@
           dateValue: _t("The value must be a date"),
           validRange: _t("The value must be a valid range"),
           validFormula: _t("The formula must be valid"),
+          positiveNumber: _t("The value must be a positive number"),
       },
       Errors: {
           ["InvalidRange" /* CommandResult.InvalidRange */]: _t("The range is invalid."),
@@ -22405,6 +22406,7 @@
       greaterThanOrEqual: "isGreaterOrEqualTo",
       lessThan: "isLessThan",
       lessThanOrEqual: "isLessOrEqualTo",
+      top10: "top10",
   };
   /** Conversion map CF types in XLSX <=> Cf types in o_spreadsheet */
   const CF_TYPE_CONVERSION_MAP = {
@@ -22945,6 +22947,7 @@
           const rule = cf.cfRules[0];
           let operator;
           const values = [];
+          const cfAdditionalProperties = {};
           if (rule.dxfId === undefined &&
               !(rule.type === "colorScale" || rule.type === "iconSet" || rule.type === "dataBar"))
               continue;
@@ -22953,7 +22956,6 @@
               case "containsErrors":
               case "notContainsErrors":
               case "duplicateValues":
-              case "top10":
               case "uniqueValues":
               case "timePeriod":
                   // Not supported
@@ -23004,6 +23006,18 @@
                       values.push(prefixFormulaWithEqual(rule.formula[1]));
                   }
                   break;
+              case "top10":
+                  if (rule.rank === undefined)
+                      continue;
+                  operator = CF_OPERATOR_TYPE_CONVERSION_MAP[rule.type];
+                  values.push(rule.rank.toString());
+                  if (rule.percent) {
+                      cfAdditionalProperties.isPercent = true;
+                  }
+                  if (rule.bottom) {
+                      cfAdditionalProperties.isBottom = true;
+                  }
+                  break;
           }
           if (operator && rule.dxfId !== undefined) {
               cfs.push({
@@ -23014,6 +23028,7 @@
                       type: "CellIsRule",
                       operator: operator,
                       values: values,
+                      ...cfAdditionalProperties,
                       style: convertStyle({ fontStyle: dxfs[rule.dxfId].font, fillStyle: dxfs[rule.dxfId].fill }, warningManager),
                   },
               });
@@ -23307,6 +23322,8 @@
               return "greaterThanOrEqual";
           case "dateIsOnOrBefore":
               return "lessThanOrEqual";
+          case "top10":
+              return "top10";
       }
   }
   // -------------------------------------
@@ -29367,15 +29384,20 @@
       getPreview: (criterion) => _t("Value one of: %s", criterion.values.join(", ")),
   });
   criterionEvaluatorRegistry.add("isValueInRange", {
-      type: "isValueInList",
-      isValueValid: (value, criterion, getters, sheetId) => {
+      type: "isValueInRange",
+      preComputeCriterion: (criterion, criterionRanges, getters) => {
+          if (criterionRanges.length === 0) {
+              return new Set();
+          }
+          const sheetId = criterionRanges[0].sheetId;
+          const criterionValues = getters.getDataValidationRangeValues(sheetId, criterion);
+          return new Set(criterionValues.map((value) => value.value.toString().toLowerCase()));
+      },
+      isValueValid: (value, criterion, valuesSet) => {
           if (!value) {
               return false;
           }
-          const criterionValues = getters.getDataValidationRangeValues(sheetId, criterion);
-          return criterionValues
-              .map((value) => value.value.toLowerCase())
-              .includes(value.toString().toLowerCase());
+          return valuesSet.has(value.toString().toLowerCase());
       },
       getErrorString: (criterion) => _t("The value must be a value in the range %s", String(criterion.values[0])),
       isCriterionValueValid: (value) => rangeReference.test(value),
@@ -29452,6 +29474,67 @@
       name: _t("Is not empty"),
       getPreview: () => _t("Is not empty"),
   });
+  criterionEvaluatorRegistry.add("top10", {
+      type: "top10",
+      preComputeCriterion: (criterion, criterionRanges, getters) => {
+          let value = tryToNumber(criterion.values[0], DEFAULT_LOCALE);
+          if (value === undefined || value <= 0) {
+              return undefined;
+          }
+          const numberValues = [];
+          for (const range of criterionRanges) {
+              for (const value of getters.getRangeValues(range)) {
+                  if (typeof value === "number") {
+                      numberValues.push(value);
+                  }
+              }
+          }
+          const sortedValues = numberValues.sort((a, b) => a - b);
+          if (criterion.isPercent) {
+              value = clip(value, 1, 100);
+          }
+          let index = 0;
+          if (criterion.isBottom && !criterion.isPercent) {
+              index = value - 1;
+          }
+          else if (criterion.isBottom && criterion.isPercent) {
+              index = Math.floor((sortedValues.length * value) / 100) - 1;
+          }
+          else if (!criterion.isBottom && criterion.isPercent) {
+              index = sortedValues.length - Math.floor((sortedValues.length * value) / 100);
+          }
+          else {
+              index = sortedValues.length - value;
+          }
+          index = clip(index, 0, sortedValues.length - 1);
+          return sortedValues[index];
+      },
+      isValueValid: (value, criterion, threshold) => {
+          if (typeof value !== "number" || threshold === undefined) {
+              return false;
+          }
+          return criterion.isBottom ? value <= threshold : value >= threshold;
+      },
+      getErrorString: (criterion) => {
+          const args = {
+              value: String(criterion.values[0]),
+              percentSymbol: criterion.isPercent ? "%" : "",
+          };
+          return criterion.isBottom
+              ? _t("The value must be in bottom %(value)s%(percentSymbol)s", args)
+              : _t("The value must be in top %(value)s%(percentSymbol)s", args);
+      },
+      isCriterionValueValid: (value) => checkValueIsPositiveNumber(value),
+      criterionValueErrorString: DVTerms.CriterionError.positiveNumber,
+      numberOfValues: () => 1,
+      name: _t("Is in Top/Bottom ranking"),
+      getPreview: (criterion) => {
+          const args = { value: criterion.values[0], percentSymbol: criterion.isPercent ? "%" : "" };
+          return criterion.isBottom
+              ? _t("Value is in bottom %(value)s%(percentSymbol)s", args)
+              : _t("Value is in top %(value)s%(percentSymbol)s", args);
+      },
+  });
   function getNumberCriterionlocalizedValues(criterion, locale) {
       return criterion.values.map((value) => {
           return value !== undefined
@@ -29473,6 +29556,10 @@
       const valueAsNumber = tryToNumber(value, DEFAULT_LOCALE);
       return valueAsNumber !== undefined;
   }
+  function checkValueIsPositiveNumber(value) {
+      const valueAsNumber = tryToNumber(value, DEFAULT_LOCALE);
+      return valueAsNumber !== undefined && valueAsNumber > 0;
+  }
 
   // -----------------------------------------------------------------------------
   // Constants
@@ -39803,6 +39890,10 @@
                       break;
                   case "CellIsRule":
                       const formulas = cf.rule.values.map((value) => value.startsWith("=") ? compile(value) : undefined);
+                      const evaluator = criterionEvaluatorRegistry.get(cf.rule.operator);
+                      const criterion = { ...cf.rule, type: cf.rule.operator };
+                      const ranges = cf.ranges.map((xc) => this.getters.getRangeFromSheetXC(sheetId, xc));
+                      const preComputedCriterion = evaluator.preComputeCriterion?.(criterion, ranges, this.getters);
                       for (const ref of cf.ranges) {
                           const zone = this.getters.getRangeFromSheetXC(sheetId, ref).zone;
                           for (let row = zone.top; row <= zone.bottom; row++) {
@@ -39815,7 +39906,7 @@
                                       }
                                       return value;
                                   });
-                                  if (this.getRuleResultForTarget(target, { ...cf.rule, values })) {
+                                  if (this.getRuleResultForTarget(target, { ...cf.rule, values }, preComputedCriterion)) {
                                       if (!computedStyle[col])
                                           computedStyle[col] = [];
                                       // we must combine all the properties of all the CF rules applied to the given cell
@@ -39978,7 +40069,7 @@
               }
           }
       }
-      getRuleResultForTarget(target, rule) {
+      getRuleResultForTarget(target, rule, preComputedCriterion) {
           const cell = this.getters.getEvaluatedCell(target);
           if (cell.type === CellValueType.error) {
               return false;
@@ -39995,11 +40086,12 @@
               return false;
           }
           const evaluatedCriterion = {
+              ...rule,
               type: rule.operator,
               values: evaluatedCriterionValues.map(toScalar),
               dateValue: rule.dateValue || "exactDate",
           };
-          return evaluator.isValueValid(cell.value ?? "", evaluatedCriterion, this.getters, sheetId);
+          return evaluator.isValueValid(cell.value ?? "", evaluatedCriterion, preComputedCriterion);
       }
   }
 
@@ -40016,17 +40108,20 @@
           "isDataValidationInvalid",
       ];
       validationResults = {};
+      criterionPreComputeResult = {};
       handle(cmd) {
           if (invalidateEvaluationCommands.has(cmd.type) ||
               cmd.type === "EVALUATE_CELLS" ||
               (cmd.type === "UPDATE_CELL" && ("content" in cmd || "format" in cmd))) {
               this.validationResults = {};
+              this.criterionPreComputeResult = {};
               return;
           }
           switch (cmd.type) {
               case "ADD_DATA_VALIDATION_RULE":
               case "REMOVE_DATA_VALIDATION_RULE":
                   delete this.validationResults[cmd.sheetId];
+                  delete this.criterionPreComputeResult[cmd.sheetId];
                   break;
           }
       }
@@ -40169,7 +40264,15 @@
               return undefined;
           }
           const evaluatedCriterion = { ...criterion, values: evaluatedCriterionValues.map(toScalar) };
-          if (evaluator.isValueValid(cellValue, evaluatedCriterion, this.getters, sheetId)) {
+          if (!this.criterionPreComputeResult[sheetId]) {
+              this.criterionPreComputeResult[sheetId] = {};
+          }
+          let preComputedCriterion = this.criterionPreComputeResult[sheetId][rule.id];
+          if (preComputedCriterion === undefined) {
+              preComputedCriterion = evaluator.preComputeCriterion?.(rule.criterion, rule.ranges, this.getters);
+              this.criterionPreComputeResult[sheetId][rule.id] = preComputedCriterion;
+          }
+          if (evaluator.isValueValid(cellValue, evaluatedCriterion, preComputedCriterion)) {
               return undefined;
           }
           return evaluator.getErrorString(evaluatedCriterion, this.getters, sheetId);
@@ -45501,6 +45604,7 @@
                   if (filterValue.type === "none")
                       continue;
                   const evaluator = criterionEvaluatorRegistry.get(filterValue.type);
+                  const preComputedCriterion = evaluator.preComputeCriterion?.(filterValue, [filter.filteredRange], this.getters);
                   const evaluatedCriterionValues = filterValue.values.map((value) => {
                       if (!value.startsWith("=")) {
                           return parseLiteral(value, DEFAULT_LOCALE);
@@ -45518,7 +45622,7 @@
                   for (let row = filteredZone.top; row <= filteredZone.bottom; row++) {
                       const position = { sheetId, col: filter.col, row };
                       const value = this.getters.getEvaluatedCell(position).value ?? "";
-                      if (!evaluator.isValueValid(value, evaluatedCriterion, this.getters, sheetId)) {
+                      if (!evaluator.isValueValid(value, evaluatedCriterion, preComputedCriterion)) {
                           hiddenRows.add(row);
                       }
                   }
@@ -49659,6 +49763,8 @@
                   case undefined:
                       throw new Error("dateValue should be defined");
               }
+          case "top10":
+              return [];
       }
   }
   function cellRuleTypeAttributes(rule) {
@@ -49691,6 +49797,14 @@
           case "dateIs":
           case "customFormula":
               return [["type", "expression"]];
+          case "top10": {
+              return [
+                  ["type", "top10"],
+                  ["rank", rule.values[0]],
+                  ["percent", rule.isPercent ? "1" : "0"],
+                  ["bottom", rule.isBottom ? "1" : "0"],
+              ];
+          }
       }
   }
   function addDataBarRule(cf, rule) {
@@ -51672,8 +51786,8 @@
 
 
   __info__.version = "19.1.0-alpha.3";
-  __info__.date = "2026-01-07T16:20:59.139Z";
-  __info__.hash = "febc3e9";
+  __info__.date = "2026-01-07T16:20:57.293Z";
+  __info__.hash = "ac2fa3e";
 
 
 })(this.o_spreadsheet_engine = this.o_spreadsheet_engine || {});