@rowsncolumns/spreadsheet 10.6.0 → 10.6.4

package/dist/esm/hooks/use-conditional-formatting.js

@@ -1,14 +1,16 @@
 import { cellIdentifier } from "@rowsncolumns/grid";
-import { isConditionalFormatFormulaRule, iterateCellsInRange, } from "@rowsncolumns/utils";
+import { addressToCell, isConditionalFormatFormulaRule, iterateCellsInRange, } from "@rowsncolumns/utils";
 import isNil from "lodash/isNil";
 import { useCallback, useMemo, useRef } from "react";
-import { computeDataBarFill, ICON_SET_COLORS, ICON_SET_GLYPHS, pickIconBucket, resolveThreshold, } from "../api/cf-overlays";
+import { computeDataBarGeometry } from "../api/cf-data-bar";
 import { isEngineEvaluatedAggregateRule } from "../api/cf-engine";
+import { averageBound, averageBoundFromStats, buildCfRangeStats, ICON_SET_COLORS, ICON_SET_GLYPHS, pickIconBucket, resolveCfThreshold, } from "../api/cf-overlays";
+import { sortConditionalFormatRules } from "../api/cf-priority";
 import { windowConditionalFormatRules } from "../api/cf-window";
 import { getGradientColors } from "../api/heatmap";
 import { checkBooleanRule, shouldUsePreviousValue } from "../api/validation";
-import { getStringifiedColor } from "../themes";
 import { DEFAULT_COLUMN_COUNT, DEFAULT_ROW_COUNT } from "../config";
+import { getStringifiedColor } from "../themes";
 /**
  * Merge a lower-priority rule's format under an already-applied one, per
  * property (Excel's stacking): every property the higher-priority format
@@ -39,7 +41,26 @@ const definedEntries = (obj) => {
     }
     return out;
 };
-export const useConditionalFormatting = ({ sheetId, theme, conditionalFormats, locale, getValidationValue, isNumberValue, getSheetRowCount, getSheetColumnCount, window: evaluationWindow, getConditionalFormatResult, }) => {
+/** The k-th value a top/bottom-N rule ranks against, from full-range statistics. */
+const fullRangeRankValue = (stats, rule) => {
+    const top = rule.type === "TOP";
+    if (stats.sorted) {
+        const n = stats.sorted.length;
+        if (!n)
+            return undefined;
+        const k = Math.min(n, Math.max(1, rule.isPercent ? Math.ceil((rule.rank / 100) * n) : rule.rank));
+        return top ? stats.sorted[n - k] : stats.sorted[k - 1];
+    }
+    const value = stats.rankValue?.(rule.rank, top, !!rule.isPercent);
+    return value !== undefined && Number.isFinite(value) ? value : undefined;
+};
+export const useConditionalFormatting = ({ sheetId, theme, conditionalFormats, locale, getValidationValue, isNumberValue, getSheetRowCount, getSheetColumnCount, window: evaluationWindow, getConditionalFormatResult, getConditionalFormatRuleStats, }) => {
+    // Whole-range statistics of windowed rules, keyed by rule id. An entry is
+    // reused while the rule object and the data getters are unchanged —
+    // scrolling (a new window) re-runs the memo below without re-scanning the
+    // full range, and any edit (new getter identity) or rule change
+    // invalidates it.
+    const fullRangeStatsCache = useRef(new Map());
     const previousEffectiveValueMap = useRef(undefined);
     // Lazy initialization
     const getPreviousValueMap = useCallback(() => {
@@ -73,17 +94,8 @@ export const useConditionalFormatting = ({ sheetId, theme, conditionalFormats, l
         if (!conditionalFormats) {
             return formattingByCell;
         }
-        const sortedRules = conditionalFormats
-            .map((rule, index) => ({ rule, index }))
-            .sort((left, right) => {
-            const leftPriority = left.rule.priority ?? Number.POSITIVE_INFINITY;
-            const rightPriority = right.rule.priority ?? Number.POSITIVE_INFINITY;
-            if (leftPriority === rightPriority) {
-                return left.index - right.index;
-            }
-            return leftPriority - rightPriority;
-        })
-            .map(({ rule }) => rule);
+        // Excel precedence: the first rule (lowest `priority`) is evaluated first and wins conflicts.
+        const sortedRules = sortConditionalFormatRules(conditionalFormats);
         const rules = evaluationWindow
             ? windowConditionalFormatRules({
                 rules: sortedRules,
@@ -131,6 +143,66 @@ export const useConditionalFormatting = ({ sheetId, theme, conditionalFormats, l
                 }
             }
         };
+        // Every numeric covered cell of a rule on this sheet, across all of its
+        // (clamped) ranges — the population Excel resolves cfvo thresholds over.
+        const collectRuleNumbers = (rule) => {
+            const cells = [];
+            for (const range of rule.ranges) {
+                if (range?.sheetId !== sheetId)
+                    continue;
+                for (const [rowIndex, columnIndex] of iterateCellsInRange(clampRange(range))) {
+                    const v = getValidationValue(sheetId, rowIndex, columnIndex, rule);
+                    if (!isNil(v) &&
+                        typeof v !== "boolean" &&
+                        isNumberValue(sheetId, rowIndex, columnIndex) &&
+                        Number.isFinite(Number(v))) {
+                        cells.push({ rowIndex, columnIndex, value: Number(v) });
+                    }
+                }
+            }
+            return cells;
+        };
+        // FORMULA cfvo thresholds: a constant or a single same-sheet cell
+        // reference (`=$B$1`) — the forms Excel's rule dialog produces.
+        const resolveFormula = (formula) => {
+            const match = /^=?\s*\$?([A-Z]{1,3})\$?(\d+)\s*$/i.exec(formula);
+            if (!match)
+                return undefined;
+            const cell = addressToCell(`${match[1]}${match[2]}`);
+            if (!cell)
+                return undefined;
+            const value = getValidationValue(sheetId, cell.rowIndex, cell.columnIndex);
+            const num = typeof value === "boolean" ? NaN : Number(value);
+            return isNil(value) || value === "" || !Number.isFinite(num)
+                ? undefined
+                : num;
+        };
+        const originalRuleById = new Map(sortedRules.map((rule) => [rule.id, rule]));
+        // Statistics over the rule's FULL range when the window cut it (Excel
+        // resolves thresholds over every covered cell, not the visible slice);
+        // `undefined` for a rule evaluated whole, whose loaded values are exact.
+        const fullRangeStats = (rule) => {
+            const original = originalRuleById.get(rule.id);
+            if (!original || original === rule)
+                return undefined;
+            const cache = fullRangeStatsCache.current;
+            const hit = cache.get(rule.id);
+            if (hit &&
+                hit.rule === original &&
+                hit.getValidationValue === getValidationValue &&
+                hit.isNumberValue === isNumberValue) {
+                return hit.stats;
+            }
+            const stats = getConditionalFormatRuleStats?.(sheetId, original) ??
+                buildCfRangeStats(collectRuleNumbers(original).map((cell) => cell.value));
+            cache.set(rule.id, {
+                rule: original,
+                getValidationValue,
+                isNumberValue,
+                stats,
+            });
+            return stats;
+        };
         // There can be conditions applied
         // to the same range
         // So to get previous value, we have to save it
@@ -171,10 +243,13 @@ export const useConditionalFormatting = ({ sheetId, theme, conditionalFormats, l
                                 numericValues.push(Number(value));
                             }
                         }
-                        if (numericValues.length) {
-                            averageValue =
-                                numericValues.reduce((sum, entry) => sum + entry, 0) /
-                                    numericValues.length;
+                        const above = conditionType === "NUMBER_ABOVE_AVERAGE";
+                        const fullStats = fullRangeStats(rule);
+                        if (fullStats) {
+                            averageValue = averageBoundFromStats(fullStats, above, booleanRule.stdDev);
+                        }
+                        else if (numericValues.length) {
+                            averageValue = averageBound(numericValues, above, booleanRule.stdDev);
                         }
                     }
                     // Formula path vs sync path: see `isConditionalFormatFormulaRule`
@@ -195,10 +270,15 @@ export const useConditionalFormatting = ({ sheetId, theme, conditionalFormats, l
                                     isNumberValue(sheetId, rowIndex, columnIndex)) {
                                     const numericValue = Number(effectiveValue);
                                     if (Number.isFinite(numericValue)) {
+                                        const inclusive = booleanRule.equalAverage === true;
                                         satisfies =
                                             conditionType === "NUMBER_ABOVE_AVERAGE"
-                                                ? numericValue > averageValue
-                                                : numericValue < averageValue;
+                                                ? inclusive
+                                                    ? numericValue >= averageValue
+                                                    : numericValue > averageValue
+                                                : inclusive
+                                                    ? numericValue <= averageValue
+                                                    : numericValue < averageValue;
                                     }
                                 }
                             }
@@ -257,7 +337,7 @@ export const useConditionalFormatting = ({ sheetId, theme, conditionalFormats, l
                     }
                     values.push(rangeValues);
                 }
-                const colors = getGradientColors(values, gradientRule, theme);
+                const colors = getGradientColors(values, gradientRule, theme, fullRangeStats(rule));
                 let rangeIndex = 0;
                 // Apply colors
                 for (const range of ranges) {
@@ -322,7 +402,11 @@ export const useConditionalFormatting = ({ sheetId, theme, conditionalFormats, l
                     const sorted = [...numericCells].sort((a, b) => topBottomRule.type === "TOP"
                         ? b.value - a.value
                         : a.value - b.value);
-                    const thresholdValue = sorted[Math.min(desiredRank - 1, sorted.length - 1)]?.value;
+                    // A windowed rule ranks against its full range.
+                    const fullStats = fullRangeStats(rule);
+                    const thresholdValue = fullStats
+                        ? fullRangeRankValue(fullStats, topBottomRule)
+                        : sorted[Math.min(desiredRank - 1, sorted.length - 1)]?.value;
                     if (thresholdValue === undefined) {
                         continue;
                     }
@@ -391,127 +475,137 @@ export const useConditionalFormatting = ({ sheetId, theme, conditionalFormats, l
                 }
             }
             else if (iconSetRule) {
-                const glyphs = ICON_SET_GLYPHS[iconSetRule.iconSet];
-                if (!glyphs) {
+                const iconCount = ICON_SET_GLYPHS[iconSetRule.iconSet]?.length;
+                if (!iconCount) {
                     conditionIndex++;
                     continue;
                 }
-                const orderedGlyphs = iconSetRule.reverse
-                    ? [...glyphs].reverse()
-                    : glyphs;
-                const orderedColors = iconSetRule.reverse
-                    ? [...ICON_SET_COLORS[iconSetRule.iconSet]].reverse()
-                    : ICON_SET_COLORS[iconSetRule.iconSet];
-                for (const range of ranges) {
-                    if (range.sheetId !== sheetId)
-                        continue;
-                    const clampedRange = clampRange(range);
-                    // Aggregate range min/max for PERCENT/PERCENTILE threshold resolution.
-                    let rangeMin = Infinity;
-                    let rangeMax = -Infinity;
-                    const cellValues = [];
-                    for (const [rowIndex, columnIndex] of iterateCellsInRange(clampedRange)) {
-                        const v = getValidationValue(sheetId, rowIndex, columnIndex, rule);
-                        if (!isNil(v) &&
-                            isNumberValue(sheetId, rowIndex, columnIndex) &&
-                            Number.isFinite(Number(v))) {
-                            const num = Number(v);
-                            cellValues.push({ rowIndex, columnIndex, value: num });
-                            if (num < rangeMin)
-                                rangeMin = num;
-                            if (num > rangeMax)
-                                rangeMax = num;
-                        }
+                // Thresholds resolve over the rule's whole applies-to range.
+                const cellValues = collectRuleNumbers(rule);
+                if (cellValues.length === 0) {
+                    conditionIndex++;
+                    continue;
+                }
+                const stats = fullRangeStats(rule) ??
+                    buildCfRangeStats(cellValues.map((cell) => cell.value));
+                const thresholds = iconSetRule.thresholds
+                    .slice(0, iconCount - 1)
+                    .map((t) => resolveCfThreshold(t, stats, { resolveFormula }));
+                const strict = iconSetRule.thresholds
+                    .slice(0, iconCount - 1)
+                    .map((t) => t.gte === false);
+                const hideValue = iconSetRule.showValue === false;
+                // The icon a bucket shows: the custom mix when set, else the
+                // family's icon (reversed when asked).
+                const bucketIcon = (bucket) => {
+                    const custom = iconSetRule.icons?.[bucket];
+                    if (custom) {
+                        return custom.iconSet === "NoIcons"
+                            ? undefined
+                            : { iconSet: custom.iconSet, iconId: custom.iconId };
                     }
-                    if (cellValues.length === 0)
+                    return {
+                        iconSet: iconSetRule.iconSet,
+                        iconId: iconSetRule.reverse ? iconCount - 1 - bucket : bucket,
+                    };
+                };
+                for (const cell of cellValues) {
+                    const cellId = cellIdentifier(cell.rowIndex, cell.columnIndex);
+                    if (stopCells.has(cellId))
                         continue;
-                    const sortedThresholds = iconSetRule.thresholds
-                        .map((t) => resolveThreshold(t, rangeMin, rangeMax))
-                        .filter((n) => Number.isFinite(n))
-                        .sort((a, b) => a - b);
-                    for (const cell of cellValues) {
-                        const bucket = pickIconBucket(cell.value, sortedThresholds);
-                        const cellId = cellIdentifier(cell.rowIndex, cell.columnIndex);
-                        if (stopCells.has(cellId))
-                            continue;
-                        const glyphIndex = Math.min(bucket, orderedGlyphs.length - 1);
-                        const glyph = orderedGlyphs[glyphIndex];
-                        const color = orderedColors[Math.min(bucket, orderedColors.length - 1)];
+                    const icon = bucketIcon(pickIconBucket(cell.value, thresholds, strict));
+                    if (icon) {
                         layerFormat(cellId, {
-                            // iconSet + iconId are needed by the icon column filter to
-                            // match cells against a specific (iconSet, iconId) target.
-                            // They're harmless to renderers that only read `glyph`.
+                            // iconSet + iconId drive the painter and the icon column
+                            // filter; `glyph` / `color` are the text stand-ins.
                             conditionalIcon: {
-                                glyph,
-                                color,
-                                iconSet: iconSetRule.iconSet,
-                                iconId: glyphIndex,
+                                glyph: ICON_SET_GLYPHS[icon.iconSet]?.[icon.iconId] ?? "",
+                                color: ICON_SET_COLORS[icon.iconSet]?.[icon.iconId],
+                                iconSet: icon.iconSet,
+                                iconId: icon.iconId,
+                                ...(hideValue ? { hideValue } : {}),
                             },
                         });
-                        if (rule.stopIfTrue)
-                            stopCells.add(cellId);
                     }
+                    if (rule.stopIfTrue)
+                        stopCells.add(cellId);
                 }
             }
             else if (dataBarRule) {
+                // Excel resolves a data bar's bounds over the rule's whole applies-to
+                // range (every area of a multi-area rule together).
+                const cellValues = collectRuleNumbers(rule);
+                if (cellValues.length === 0) {
+                    conditionIndex++;
+                    continue;
+                }
+                const stats = fullRangeStats(rule) ??
+                    buildCfRangeStats(cellValues.map((cell) => cell.value));
+                const resolvedMin = resolveCfThreshold(dataBarRule.minpoint, stats, {
+                    role: "min",
+                    resolveFormula,
+                });
+                const resolvedMax = resolveCfThreshold(dataBarRule.maxpoint, stats, {
+                    role: "max",
+                    resolveFormula,
+                });
+                const min = Number.isFinite(resolvedMin) ? resolvedMin : stats.min;
+                const max = Number.isFinite(resolvedMax) ? resolvedMax : stats.max;
                 const barColor = getStringifiedColor(dataBarRule.color, theme);
                 const negativeColor = dataBarRule.negativeColor
                     ? getStringifiedColor(dataBarRule.negativeColor, theme)
-                    : undefined;
+                    : barColor;
                 const borderColor = dataBarRule.borderColor
                     ? getStringifiedColor(dataBarRule.borderColor, theme)
                     : undefined;
+                const negativeBorderColor = dataBarRule.negativeBorderColor
+                    ? getStringifiedColor(dataBarRule.negativeBorderColor, theme)
+                    : borderColor;
+                const axisColor = dataBarRule.axisColor
+                    ? getStringifiedColor(dataBarRule.axisColor, theme)
+                    : undefined;
                 const direction = dataBarRule.direction === "rightToLeft"
                     ? "rightToLeft"
                     : "leftToRight";
-                for (const range of ranges) {
-                    if (range.sheetId !== sheetId)
+                const hideValue = dataBarRule.showValue === false;
+                for (const cell of cellValues) {
+                    const cellId = cellIdentifier(cell.rowIndex, cell.columnIndex);
+                    if (stopCells.has(cellId))
                         continue;
-                    const clampedRange = clampRange(range);
-                    let rangeMin = Infinity;
-                    let rangeMax = -Infinity;
-                    const cellValues = [];
-                    for (const [rowIndex, columnIndex] of iterateCellsInRange(clampedRange)) {
-                        const v = getValidationValue(sheetId, rowIndex, columnIndex, rule);
-                        if (!isNil(v) &&
-                            isNumberValue(sheetId, rowIndex, columnIndex) &&
-                            Number.isFinite(Number(v))) {
-                            const num = Number(v);
-                            cellValues.push({ rowIndex, columnIndex, value: num });
-                            if (num < rangeMin)
-                                rangeMin = num;
-                            if (num > rangeMax)
-                                rangeMax = num;
-                        }
-                    }
-                    if (cellValues.length === 0)
+                    const geometry = computeDataBarGeometry({
+                        value: cell.value,
+                        min,
+                        max,
+                        axisPosition: dataBarRule.axisPosition,
+                        minLength: dataBarRule.minLength,
+                        maxLength: dataBarRule.maxLength,
+                        direction,
+                    });
+                    if (!geometry)
                         continue;
-                    const min = resolveThreshold(dataBarRule.minpoint, rangeMin, rangeMax);
-                    const max = resolveThreshold(dataBarRule.maxpoint, rangeMin, rangeMax);
-                    const resolvedMin = Number.isFinite(min) ? min : rangeMin;
-                    const resolvedMax = Number.isFinite(max) ? max : rangeMax;
-                    for (const cell of cellValues) {
-                        const cellId = cellIdentifier(cell.rowIndex, cell.columnIndex);
-                        if (stopCells.has(cellId))
-                            continue;
-                        const isNegative = cell.value < 0 && negativeColor !== undefined;
-                        const fill = computeDataBarFill(isNegative ? -cell.value : cell.value, isNegative ? 0 : Math.max(0, resolvedMin), isNegative
-                            ? Math.abs(resolvedMin)
-                            : Math.max(resolvedMin, resolvedMax));
-                        layerFormat(cellId, {
-                            conditionalDataBar: {
-                                color: isNegative
-                                    ? negativeColor
-                                    : barColor,
-                                fillFraction: fill,
-                                negative: isNegative,
-                                borderColor,
-                                direction,
-                            },
-                        });
-                        if (rule.stopIfTrue)
-                            stopCells.add(cellId);
-                    }
+                    layerFormat(cellId, {
+                        conditionalDataBar: {
+                            color: geometry.negative ? negativeColor : barColor,
+                            fillFraction: geometry.barEnd - geometry.barStart,
+                            negative: geometry.negative,
+                            borderColor: geometry.negative
+                                ? negativeBorderColor
+                                : borderColor,
+                            direction,
+                            barStart: geometry.barStart,
+                            barEnd: geometry.barEnd,
+                            gradient: dataBarRule.gradient !== false,
+                            ...(geometry.axisPosition !== undefined
+                                ? {
+                                    axisPosition: geometry.axisPosition,
+                                    axisColor: axisColor ?? "#000000",
+                                }
+                                : {}),
+                            ...(hideValue ? { hideValue } : {}),
+                        },
+                    });
+                    if (rule.stopIfTrue)
+                        stopCells.add(cellId);
                 }
             }
             conditionIndex++;
@@ -530,5 +624,6 @@ export const useConditionalFormatting = ({ sheetId, theme, conditionalFormats, l
         getSheetColumnCount,
         evaluationWindow,
         getConditionalFormatResult,
+        getConditionalFormatRuleStats,
     ]);
 };

package/dist/esm/index.d.ts

@@ -1,6 +1,8 @@
 export * from "./components/canvas-grid";
 export * from "./components/canvas-grid/typings";
 export * from "./components/canvas-grid/helpers";
+export * from "./components/canvas-grid/page-breaks";
+export * from "./components/cf-icon-preview";
 export * from "./providers/spreadsheet-provider";
 export * from "./components/sheet-switcher";
 export * from "./components/sheet-switcher/new-sheet-button";
@@ -20,6 +22,7 @@ export * from "./api/move-overwrite";
 export * from "./components/evaluate-formula-dialog";
 export * from "./components/watch-window";
 export * from "./components/calculation-options-dialog";
+export * from "./components/protect-sheet-dialog";
 export { resolveGoToReference, type GoToResolverContext } from "./api/go-to";
 export * from "./api/go-to-special";
 export * from "./api/excel-validation-kinds";
@@ -67,7 +70,9 @@ export * from "./api/table";
 export * from "./api/heatmap";
 export * from "./api/banded-ranges";
 export * from "./api/cf-overlays";
+export * from "./api/cf-icons";
 export * from "./api/cf-engine";
+export * from "./api/cf-priority";
 export * from "./api/fill-patterns";
 export type { AvailableIcon } from "./components/filter-box";
 export * from "./hooks";

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.tsx"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AAEjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,0CAA0C,CAAC;AACzD,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,qCAAqC,CAAC;AACpD,cAAc,sBAAsB,CAAC;AACrC,cAAc,sCAAsC,CAAC;AACrD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC7E,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,0CAA0C,CAAC;AACzD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AAEnD,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,cAAc,SAAS,CAAC;AACxB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,mDAAmD,CAAC;AAClE,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,4BAA4B,EAC5B,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,oBAAoB,GACrB,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,6BAA6B,CAAC;AAC5C,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,KAAK,sBAAsB,EAC3B,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AACrC,cAAc,mCAAmC,CAAC;AAClD,cAAc,iBAAiB,CAAC;AAChC,cAAc,mCAAmC,CAAC;AAGlD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AAGnD,cAAc,8BAA8B,CAAC;AAG7C,cAAc,mCAAmC,CAAC;AAGlD,cAAc,mCAAmC,CAAC;AAGlD,cAAc,mCAAmC,CAAC;AAGlD,cAAc,0CAA0C,CAAC;AAGzD,cAAc,6BAA6B,CAAC;AAG5C,cAAc,8BAA8B,CAAC;AAG7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sCAAsC,CAAC;AAGrD,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.tsx"],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -1,6 +1,8 @@
 export * from "./components/canvas-grid";
 export * from "./components/canvas-grid/typings";
 export * from "./components/canvas-grid/helpers";
+export * from "./components/canvas-grid/page-breaks";
+export * from "./components/cf-icon-preview";
 export * from "./providers/spreadsheet-provider";
 export * from "./components/sheet-switcher";
 export * from "./components/sheet-switcher/new-sheet-button";
@@ -19,6 +21,7 @@ export * from "./api/move-overwrite";
 export * from "./components/evaluate-formula-dialog";
 export * from "./components/watch-window";
 export * from "./components/calculation-options-dialog";
+export * from "./components/protect-sheet-dialog";
 export { resolveGoToReference } from "./api/go-to";
 export * from "./api/go-to-special";
 export * from "./api/excel-validation-kinds";
@@ -66,7 +69,9 @@ export * from "./api/table";
 export * from "./api/heatmap";
 export * from "./api/banded-ranges";
 export * from "./api/cf-overlays";
+export * from "./api/cf-icons";
 export * from "./api/cf-engine";
+export * from "./api/cf-priority";
 export * from "./api/fill-patterns";
 export * from "./hooks";
 export * from "./components/cell/typings";

package/dist/esm/release-date.js

@@ -1,3 +1,3 @@
 export const releaseDate = 
 // @ts-ignore
-new Date("2026-10-30") ?? new Date("2025-06-18");
+new Date("2026-11-02") ?? new Date("2025-06-18");

package/dist/esm/themes.d.ts

@@ -5,6 +5,14 @@ export declare const STANDARD_COLORS: string[];
 export declare const colorKeys: Map<ColorIndex, ThemeColors>;
 export type ColorIndex = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
 export declare const getThemeColorFromIndex: (theme: SpreadsheetTheme, index: ColorIndex, tint?: number | null) => string | undefined;
+/**
+ * A DrawingML theme-font token (`+mn-lt`, `+mj-ea`, …: ECMA-376 Part 1, §20.1.4.1.16 `latin`
+ * typeface) as the family it names in `theme`: `+mn-*` is the minor (body) font,
+ * `+mj-*` the major (heading) font, which falls back to the body font when the theme has none.
+ * Any other family is returned as it is. Shapes, text boxes and rich runs keep the token (so it
+ * round-trips); this is what they paint with.
+ */
+export declare const resolveThemeFontFamily: <T extends string | null | undefined>(family: T, theme: Pick<SpreadsheetTheme, "primaryFontFamily" | "headingFontFamily"> | undefined) => T | string;
 type StringifiedColorValue<T extends Color | string | undefined | null> = T extends undefined ? undefined : string;
 export declare const getStringifiedColor: <T extends Color | undefined | null>(color: T, theme: SpreadsheetTheme) => StringifiedColorValue<T>;
 export declare const createColorShades: (color: string, tints: number[]) => string[];

package/dist/esm/themes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../../themes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACZ,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAQrC,eAAO,MAAM,eAAe,EAAE,gBAAgB,EAyM7C,CAAC;AAEF,eAAO,MAAM,eAAe,UAW3B,CAAC;AAEF,eAAO,MAAM,SAAS,8BAYpB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;AAGpE,eAAO,MAAM,sBAAsB,GACjC,OAAO,gBAAgB,EACvB,OAAO,UAAU,EACjB,OAAO,MAAM,GAAG,IAAI,uBAQrB,CAAC;AAEF,KAAK,qBAAqB,CAAC,CAAC,SAAS,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,IACpE,CAAC,SAAS,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAC3C,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,KAAK,GAAG,SAAS,GAAG,IAAI,EACpE,OAAO,CAAC,EACR,OAAO,gBAAgB,KACtB,qBAAqB,CAAC,CAAC,CASzB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,EAAE,KACL,MAAM,EAChE,CAAC;AAEF,eAAO,MAAM,mBAAmB,YAY/B,CAAC"}
+{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../../themes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACZ,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAQrC,eAAO,MAAM,eAAe,EAAE,gBAAgB,EAyM7C,CAAC;AAEF,eAAO,MAAM,eAAe,UAW3B,CAAC;AAEF,eAAO,MAAM,SAAS,8BAYpB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;AAGpE,eAAO,MAAM,sBAAsB,GACjC,OAAO,gBAAgB,EACvB,OAAO,UAAU,EACjB,OAAO,MAAM,GAAG,IAAI,uBAQrB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,SAAS,EACxE,QAAQ,CAAC,EACT,OAAO,IAAI,CAAC,gBAAgB,EAAE,mBAAmB,GAAG,mBAAmB,CAAC,GAAG,SAAS,KACnF,CAAC,GAAG,MAON,CAAC;AAEF,KAAK,qBAAqB,CAAC,CAAC,SAAS,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,IACpE,CAAC,SAAS,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAC3C,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,KAAK,GAAG,SAAS,GAAG,IAAI,EACpE,OAAO,CAAC,EACR,OAAO,gBAAgB,KACtB,qBAAqB,CAAC,CAAC,CASzB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,EAAE,KACR,MAAM,EAC7D,CAAC;AAEF,eAAO,MAAM,mBAAmB,YAY/B,CAAC"}

package/dist/esm/themes.js

@@ -1,4 +1,4 @@
-import { isNil, lightenColor } from "@rowsncolumns/utils";
+import { applyTint, isNil } from "@rowsncolumns/utils";
 const commonDarkColors = {
     background1: "rgb(17, 17, 17)",
     text1: "#FFFFFF",
@@ -238,9 +238,26 @@ export const getThemeColorFromIndex = (theme, index, tint) => {
         return color;
     }
     else {
-        return lightenColor(tint, color);
+        return applyTint(tint, color);
     }
 };
+/**
+ * A DrawingML theme-font token (`+mn-lt`, `+mj-ea`, …: ECMA-376 Part 1, §20.1.4.1.16 `latin`
+ * typeface) as the family it names in `theme`: `+mn-*` is the minor (body) font,
+ * `+mj-*` the major (heading) font, which falls back to the body font when the theme has none.
+ * Any other family is returned as it is. Shapes, text boxes and rich runs keep the token (so it
+ * round-trips); this is what they paint with.
+ */
+export const resolveThemeFontFamily = (family, theme) => {
+    if (!family || !theme || family.charAt(0) !== "+")
+        return family;
+    const match = /^\+(mn|mj)-(lt|ea|cs)$/i.exec(family.trim());
+    if (!match)
+        return family;
+    return match[1].toLowerCase() === "mj"
+        ? theme.headingFontFamily || theme.primaryFontFamily
+        : theme.primaryFontFamily;
+};
 export const getStringifiedColor = (color, theme) => {
     if (isNil(color) || typeof color === "string") {
         return color;
@@ -248,7 +265,7 @@ export const getStringifiedColor = (color, theme) => {
     return getThemeColorFromIndex(theme, color.theme, color.tint);
 };
 export const createColorShades = (color, tints) => {
-    return tints.map((tint) => lightenColor(tint, color));
+    return tints.map((tint) => applyTint(tint, color));
 };
 export const colorTintsToDisplay = [
     [-0.05, -0.15, -0.25, -0.35, -0.5],