@fileverse-dev/dsheet 2.0.17 → 2.0.18

package/dist/sheet-engine/core/context.d.ts

@@ -154,6 +154,19 @@ export type Context = {
     formulaRangeSelect: ({
         rangeIndex: number;
     } & Rect) | undefined;
+    /**
+     * Apply-to ranges (0-based inclusive row/column) for transient sheet overlay when
+     * hovering a conditional-formatting rule in the list. Null when inactive.
+     */
+    conditionalFormatRuleHoverRanges: {
+        row: number[];
+        column: number[];
+    }[] | null;
+    /**
+     * True while the CF create/edit form is open — drives live sheet preview of the draft
+     * rule in `getComputeMap` (must be false on list or after close).
+     */
+    conditionFormatDraftActive: boolean;
     functionCandidates: any[];
     defaultCandidates: any[];
     functionHint: string | null | undefined;

package/dist/sheet-engine/core/index.d.ts

@@ -7,7 +7,7 @@ export { defaultSettings } from './settings';
 export type { Settings, Hooks, DateBaseLocale } from './settings';
 export { handleCopy, handleGlobalKeyDown, handlePaste, handlePasteByClick, fixPositionOnFrozenCells, handleCellAreaMouseDown, handleCellAreaDoubleClick, handleContextMenu, mouseRender, handleOverlayMouseMove, handleOverlayMouseUp, handleRowHeaderMouseDown, handleColumnHeaderMouseDown, handleColSizeHandleMouseDown, handleColSizeHandleDoubleClick, handleRowSizeHandleMouseDown, handleColFreezeHandleMouseDown, handleRowFreezeHandleMouseDown, } from './events';
 export * from './locale';
-export { getBorderInfoComputeRange, getBorderInfoCompute, normalizedCellAttr, normalizedAttr, getCellValue, setCellValue, getRealCellValue, mergeBorder, cancelNormalSelected, updateCell, getRangetxt, getRangeByTxt, getInlineStringHTML, applyLinkToSelection, getHyperlinksFromInlineSegments, getUniformLinkFromWindowSelectionInEditor, getHyperlinkAtCaretInContentEditable, getStyleByCell, clearSelectedCellFormat, clearRowsCellsFormat, clearColumnsCellsFormat, clipboard, moveToEnd, getRangeRectsByCharacterOffset, getDateBaseLocale, getCanonicalDateEditFormat, getDateEditFormatForCell, isUsDateBaseLocale, normalizeDateBaseLocale, shouldPreserveDateFormatForEdit, setDateBaseLocale, update, is_date, valueShowEs, isTypedCurrencyDisplayFormat, isCurrencyLikeNumberFormat, FormulaCache, groupValuesRefresh, execFunctionGroup, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, maybeRecoverDirtyRangeSelection, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, setFormulaEditorOwner, functionHTMLGenerate, suppressFormulaRangeSelectionForInitialEdit, rangeSetValue, getFormulaRangeIndexForKeyboardSync, createFormulaRangeSelect, isFormulaReferenceInputMode, seedFormulaFuncSelectedRangeFromLastSelection, initFreeze, isInlineStringCell, getInlineStringNoStyle, rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, insertRowCol, deleteRowCol, hideSelected, showSelected, isShowHidenCR, getFilterHiddenRowsUnionFromFilterMap, getFilterHiddenRowsUnion, ensureManualHiddenInitialized, rebuildRowHiddenUnion, scrollToHighlightCell, selectTitlesMap, selectTitlesRange, normalizeSelection, syncPrimaryCellActiveFromSelection, selectionIsExactlyOneMergeBlock, setPrimaryCellActive, advancePrimaryCellInLastMultiSelection, snapSheetSelectionFocusToCellPreserveMultiRange, moveHighlightCell, deleteSelectedCellText, selectAll, fixRowStyleOverflowInFreeze, fixColumnStyleOverflowInFreeze, calcSelectionInfo, addSheet, deleteSheet, editSheetName, changeSheet, updateFormat, autoSelectionFormula, handleBold, handleItalic, handleStrikeThrough, handleUnderline, handleHorizontalAlign, handleVerticalAlign, handleTextColor, handleTextBackground, handleBorder, handleMerge, mergeSelectionHasValues, handleSort, handleFreeze, handleTextSize, handleSum, handleLink, captureLinkEditorOpenSnapshot, isHyperlinkCreationBlocked, toolbarItemClickHandler, toolbarItemSelectedFunc, handleScreenShot, insertImage, showImgChooser, drawArrow, setEditingComment, removeEditingComment, newComment, editComment, deleteComment, showComments, showHideComment, showHideAllComments, onCommentBoxMoveStart, removeActiveImage, cancelActiveImgItem, onImageMoveStart, onImageResizeStart, createDropCellRange, sortSelection, sortSheetBySelectedColumn, searchAll, searchNext, replace, replaceAll, replaceAllScoped, getSearchIndexArr, getSearchIndexArrAsync, getFindRangeOnCurrentSheet, getQuickSearchIndexArr, getQuickSearchHiddenConfig, getCellHyperlinks, getHyperlinkDisplayTextInCell, getInlineLinkPlainRange, getUniformLinkCoveringPlainRange, getUniformLinkAtPlainOffset, removeHyperlinkForLink, updateHyperlinkForLink, syncLinkCardAfterHyperlinkChange, expandCellRectForMerge, shouldQuickSearchUseAsync, runQuickSearchIndexArrAsync, QUICK_SEARCH_ASYNC_ROW_THRESHOLD, parseRangeText, getCellRowColumn, getCellHyperlink, saveHyperlink, removeHyperlink, showLinkCard, goToLink, isLinkValid, createFilterOptions, clearFilter, clearFilterForColumn, toggleViewerFilter, createFilter, getFilterColumnValues, getFilterColumnColors, orderbydatafiler, saveFilter, onCellsMoveStart, cfSplitRange, updateMoreCell, getRegStr, getDataArr, applyLocation, getOptionValue, getSelectRange, getDropdownList, setDropdownValue, confirmMessage, setConditionRules, handleOverlayTouchStart, handleOverlayTouchEnd, MAX_ZOOM_RATIO, MIN_ZOOM_RATIO, handleKeydownForZoom, jfrefreshgrid, sanitizeDuneUrl, insertDuneChart, onIframeMoveStart, onIframeResizeStart, onIframeMove, onIframeMoveEnd, onIframeResize, onIframeResizeEnd, setCellError, clearCellError, detectDateFormat, isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, isNumericCellType, iscelldata, getcellrange, cancelFunctionrangeSelected, seletedHighlistByindex, spillSortResult, execfunction, insertUpdateFunctionGroup, remapFormulaReferencesByMap, checkCF, getComputeMap, cancelPaintModel, hideCRCount, getdatabyselection, } from './modules';
+export { getBorderInfoComputeRange, getBorderInfoCompute, normalizedCellAttr, normalizedAttr, getCellValue, setCellValue, getRealCellValue, mergeBorder, cancelNormalSelected, updateCell, getRangetxt, getRangeByTxt, isValidRangeText, getInlineStringHTML, applyLinkToSelection, getHyperlinksFromInlineSegments, getUniformLinkFromWindowSelectionInEditor, getHyperlinkAtCaretInContentEditable, getStyleByCell, clearSelectedCellFormat, clearRowsCellsFormat, clearColumnsCellsFormat, clipboard, moveToEnd, getRangeRectsByCharacterOffset, getDateBaseLocale, getCanonicalDateEditFormat, getDateEditFormatForCell, isUsDateBaseLocale, normalizeDateBaseLocale, shouldPreserveDateFormatForEdit, setDateBaseLocale, update, is_date, valueShowEs, isTypedCurrencyDisplayFormat, isCurrencyLikeNumberFormat, FormulaCache, groupValuesRefresh, execFunctionGroup, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, maybeRecoverDirtyRangeSelection, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, setFormulaEditorOwner, functionHTMLGenerate, suppressFormulaRangeSelectionForInitialEdit, rangeSetValue, getFormulaRangeIndexForKeyboardSync, createFormulaRangeSelect, isFormulaReferenceInputMode, seedFormulaFuncSelectedRangeFromLastSelection, initFreeze, isInlineStringCell, getInlineStringNoStyle, rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, insertRowCol, deleteRowCol, hideSelected, showSelected, isShowHidenCR, getFilterHiddenRowsUnionFromFilterMap, getFilterHiddenRowsUnion, ensureManualHiddenInitialized, rebuildRowHiddenUnion, scrollToHighlightCell, selectTitlesMap, selectTitlesRange, normalizeSelection, syncPrimaryCellActiveFromSelection, selectionIsExactlyOneMergeBlock, setPrimaryCellActive, advancePrimaryCellInLastMultiSelection, snapSheetSelectionFocusToCellPreserveMultiRange, moveHighlightCell, deleteSelectedCellText, selectAll, fixRowStyleOverflowInFreeze, fixColumnStyleOverflowInFreeze, calcSelectionInfo, addSheet, deleteSheet, editSheetName, changeSheet, updateFormat, autoSelectionFormula, handleBold, handleItalic, handleStrikeThrough, handleUnderline, handleHorizontalAlign, handleVerticalAlign, handleTextColor, handleTextBackground, handleBorder, handleMerge, mergeSelectionHasValues, handleSort, handleFreeze, handleTextSize, handleSum, handleLink, captureLinkEditorOpenSnapshot, isHyperlinkCreationBlocked, toolbarItemClickHandler, toolbarItemSelectedFunc, handleScreenShot, insertImage, showImgChooser, drawArrow, setEditingComment, removeEditingComment, newComment, editComment, deleteComment, showComments, showHideComment, showHideAllComments, onCommentBoxMoveStart, removeActiveImage, cancelActiveImgItem, onImageMoveStart, onImageResizeStart, createDropCellRange, sortSelection, sortSheetBySelectedColumn, searchAll, searchNext, replace, replaceAll, replaceAllScoped, getSearchIndexArr, getSearchIndexArrAsync, getFindRangeOnCurrentSheet, getQuickSearchIndexArr, getQuickSearchHiddenConfig, getCellHyperlinks, getHyperlinkDisplayTextInCell, getInlineLinkPlainRange, getUniformLinkCoveringPlainRange, getUniformLinkAtPlainOffset, removeHyperlinkForLink, updateHyperlinkForLink, syncLinkCardAfterHyperlinkChange, expandCellRectForMerge, shouldQuickSearchUseAsync, runQuickSearchIndexArrAsync, QUICK_SEARCH_ASYNC_ROW_THRESHOLD, parseRangeText, getCellRowColumn, getCellHyperlink, saveHyperlink, removeHyperlink, showLinkCard, goToLink, isLinkValid, createFilterOptions, clearFilter, clearFilterForColumn, toggleViewerFilter, createFilter, getFilterColumnValues, getFilterColumnColors, orderbydatafiler, saveFilter, onCellsMoveStart, cfSplitRange, updateMoreCell, getRegStr, getDataArr, applyLocation, getOptionValue, getSelectRange, getDropdownList, setDropdownValue, confirmMessage, setConditionRules, CF_DATE_DEFAULT_FORMAT, parseCfDateConditionForUi, formatCfDatePresetSnapshot, parseDdMmYyyyToSerial, handleOverlayTouchStart, handleOverlayTouchEnd, MAX_ZOOM_RATIO, MIN_ZOOM_RATIO, handleKeydownForZoom, jfrefreshgrid, sanitizeDuneUrl, insertDuneChart, onIframeMoveStart, onIframeResizeStart, onIframeMove, onIframeMoveEnd, onIframeResize, onIframeResizeEnd, setCellError, clearCellError, detectDateFormat, isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, isNumericCellType, iscelldata, getcellrange, cancelFunctionrangeSelected, seletedHighlistByindex, spillSortResult, execfunction, insertUpdateFunctionGroup, remapFormulaReferencesByMap, checkCF, getComputeMap, cancelPaintModel, hideCRCount, getdatabyselection, } from './modules';
 export type { FilterDate, FilterValue, FilterColor } from './modules';
 export { getFreezeState, toggleFreeze, indexToColumnChar, escapeScriptTag, escapeHTMLTag, getSheetIndex, replaceHtml, isAllowEdit, isAllowEditReadOnly, filterPatch, patchToOp, opToPatch, inverseRowColOptions, } from './utils';
 export type { PatchOptions, ChangedSheet } from './utils';

package/dist/sheet-engine/core/locale/en.d.ts

@@ -604,6 +604,7 @@ declare const _default: {
         setAs: string;
         setAsByArea: string;
         applyRange: string;
+        invalidRangeText: string;
         selectRange: string;
         selectRange_percent: string;
         selectRange_average: string;
@@ -613,6 +614,7 @@ declare const _default: {
         selectCell: string;
         pleaseSelectCell: string;
         pleaseSelectADate: string;
+        pleaseEnterDateDdMmYyyy: string;
         pleaseEnterInteger: string;
         onlySingleCell: string;
         conditionValueCanOnly: string;
@@ -672,12 +674,29 @@ declare const _default: {
         lessThan: string;
         lessThanOrEqual: string;
         between: string;
+        notBetween: string;
         equal: string;
+        notEqual: string;
         in: string;
         between2: string;
         contain: string;
         textContains: string;
+        textDoesNotContain: string;
+        textStartsWith: string;
+        textEndsWith: string;
+        textExactly: string;
         empty: string;
+        notEmpty: string;
+        dateIs: string;
+        dateBefore: string;
+        dateAfter: string;
+        cfDatePreset_today: string;
+        cfDatePreset_tomorrow: string;
+        cfDatePreset_yesterday: string;
+        cfDatePreset_pastWeek: string;
+        cfDatePreset_pastMonth: string;
+        cfDatePreset_pastYear: string;
+        cfDatePreset_exact: string;
         duplicateValue: string;
         uniqueValue: string;
         top: string;
@@ -693,6 +712,9 @@ declare const _default: {
         belowAverage: string;
         all: string;
         yesterday: string;
+        formatCellsIfRulesGroup_presenceText: string;
+        formatCellsIfRulesGroup_dates: string;
+        formatCellsIfRulesGroup_numbers: string;
         today: string;
         tomorrow: string;
         lastWeek: string;
@@ -771,6 +793,7 @@ declare const _default: {
         cellRange: string;
         selectCellRange: string;
         selectCellRange2: string;
+        invalidRangeText: string;
         verificationCondition: string;
         allowMultiSelect: string;
         dropdown: string;

package/dist/sheet-engine/core/modules/ConditionFormat.d.ts

@@ -1,6 +1,17 @@
 import { Context } from '../context';
 import { CellMatrix, Sheet } from '../types';
 
+/** Default text format recorded alongside preset / value for CF date rules. */
+export declare const CF_DATE_DEFAULT_FORMAT = "DD/MM/YYYY";
+/** Parse strict DD/MM/YYYY to Excel serial (local calendar day). */
+export declare function parseDdMmYyyyToSerial(s: string): number | null;
+/** Human-readable snapshot for the given preset (evaluation still uses preset id at compute time). */
+export declare function formatCfDatePresetSnapshot(preset: string): string;
+export declare function parseCfDateConditionForUi(cv: any[] | undefined): {
+    preset: string;
+    snapshotOrExact: string;
+    format: string;
+};
 export declare function getHistoryRules(fileH: Sheet[]): {
     sheetIndex: number;
     luckysheet_conditionformat_save: any[] | undefined;

package/dist/sheet-engine/core/modules/cell.d.ts

@@ -28,6 +28,12 @@ export declare function getFlattenedRange(ctx: Context, range?: Range): {
 }[];
 export declare function getRangetxt(ctx: Context, sheetId: string, range: SingleRange, currentId?: string): string;
 export declare function getRangeByTxt(ctx: Context, txt: string): any[];
+/**
+ * True if the string is empty/whitespace (allowed while editing) or parses to at least
+ * one range with {@link getRangeByTxt} (same rules as sheet range entry elsewhere), plus
+ * stricter form checks for the conditional-format and range-dialog inputs.
+ */
+export declare function isValidRangeText(ctx: Context, txt: string): boolean;
 export declare function isAllSelectedCellsInStatus(ctx: Context, attr: keyof Cell, status: any): boolean;
 export declare function getFontStyleByCell(cell: Cell | null | undefined, checksAF?: any[], checksCF?: any, isCheck?: boolean): any;
 export declare function getStyleByCell(ctx: Context, d: CellMatrix, r: number, c: number): any;

package/dist/sheet-engine/core/modules/formula.d.ts

@@ -29,6 +29,7 @@ export declare class FormulaCache {
     formulaKeyboardRefSync?: boolean;
     formulaEditorOwner?: "cell" | "fx" | null;
     functionRangeIndex?: number[];
+    functionRangeGlobalOffset?: number | null;
     functionlistMap: any;
     execFunctionExist?: any[];
     execFunctionGlobalData: any;
@@ -104,6 +105,7 @@ export declare function markRangeSelectionDirty(ctx: Context): void;
  */
 export declare function getFormulaRangeIndexForKeyboardSync($editor: HTMLDivElement): number | null;
 export declare function handleFormulaInput(ctx: Context, $copyTo: HTMLDivElement | null | undefined, $editor: HTMLDivElement, kcode: number, preText?: string, refreshRangeSelect?: boolean): void;
+export declare function toggleFormulaAbsoluteReferenceAtCaret(ctx: Context, $copyTo: HTMLDivElement | null | undefined, $editor: HTMLDivElement | null | undefined): boolean;
 /** True while picking a range for a formula (sheet selection drives references). */
 export declare function isLegacyFormulaRangeMode(ctx: Context): boolean;
 export declare function israngeseleciton(ctx: Context, istooltip?: boolean): boolean;

package/dist/sheet-engine/core/modules/index.d.ts

@@ -1,5 +1,5 @@
 export { getBorderInfoComputeRange, getBorderInfoCompute } from './border';
-export { normalizedCellAttr, normalizedAttr, getCellValue, setCellValue, getRealCellValue, mergeBorder, cancelNormalSelected, updateCell, getRangetxt, getRangeByTxt, getInlineStringHTML, getStyleByCell, clearSelectedCellFormat, clearRowsCellsFormat, clearColumnsCellsFormat, cancelFunctionrangeSelected, } from './cell';
+export { normalizedCellAttr, normalizedAttr, getCellValue, setCellValue, getRealCellValue, mergeBorder, cancelNormalSelected, updateCell, getRangetxt, getRangeByTxt, isValidRangeText, getInlineStringHTML, getStyleByCell, clearSelectedCellFormat, clearRowsCellsFormat, clearColumnsCellsFormat, cancelFunctionrangeSelected, } from './cell';
 export { default as clipboard } from './clipboard';
 export { moveToEnd, getRangeRectsByCharacterOffset } from './cursor';
 export { getDateBaseLocale, getCanonicalDateEditFormat, getDateEditFormatForCell, isUsDateBaseLocale, normalizeDateBaseLocale, shouldPreserveDateFormatForEdit, setDateBaseLocale, } from './date-base-locale';
@@ -30,7 +30,7 @@ export { CFSplitRange } from './ConditionFormat';
 export { updateMoreCell, getRegStr, getDataArr } from './splitColumn';
 export { applyLocation, getOptionValue, getSelectRange, } from './locationCondition';
 export { getDropdownList, setDropdownValue, confirmMessage, cellFocus, validateCellData, } from './dataVerification';
-export { setConditionRules } from './ConditionFormat';
+export { setConditionRules, CF_DATE_DEFAULT_FORMAT, parseCfDateConditionForUi, formatCfDatePresetSnapshot, parseDdMmYyyyToSerial, } from './ConditionFormat';
 export { handleOverlayTouchStart, handleOverlayTouchEnd } from './mobile';
 export { MAX_ZOOM_RATIO, MIN_ZOOM_RATIO, handleKeydownForZoom } from './zoom';
 export { jfrefreshgrid } from './refresh';

package/dist/sheet-engine/core/types.d.ts

@@ -43,6 +43,8 @@ export type Cell = {
         cs?: number;
     };
     f?: string;
+    /** Editor-only HTML snapshot for reopening multiline formulas as typed. */
+    _formulaEditHtml?: string;
     /** `dp`: fixed decimal places for display when `fa` is General (Auto); does not change `fa`/`t`. */
     ct?: {
         fa?: string;
@@ -171,6 +173,10 @@ export type ConditionRulesProps = {
         value1: string;
         value2: string;
     };
+    /** Preset for dateIs / dateBefore / dateAfter (allowed values depend on rule type). */
+    datePreset: string;
+    /** Declared format for stored date text (e.g. DD/MM/YYYY). */
+    dateFormat: string;
     dateValue: string;
     repeatValue: string;
     projectValue: string;

package/dist/sheet-engine/react/components/Toolbar/index.d.ts

@@ -1,7 +1,7 @@
 import { default as React } from 'react';
 import { Cell } from '../../../core';
 
-export declare const getLucideIcon: (title: string) => "Undo" | "Redo" | "Underline" | "Border" | "Filter" | "Link" | "Search" | "" | "Percent" | "Ethereum" | "ChevronDown" | "Bold" | "Italic" | "Strikethrough" | "PaintBucket" | "PaintRoller" | "AlignLeft" | "AlignCenter" | "AlignRight" | "ArrowUpFromLine" | "AlignVerticalMiddle" | "ArrowDownToLine" | "TextOverflow" | "WrapText" | "TextClip" | "Baseline" | "MergeHorizontal" | "DollarSign" | "DecimalsArrowLeft" | "DecimalsArrowRight" | "PaintbrushVertical" | "ArrowDownUp" | "MessageSquarePlus" | "Image" | "Sigma" | "ShieldCheck" | "DuneChart" | "Ellipsis";
+export declare const getLucideIcon: (title: string) => "Undo" | "Redo" | "Underline" | "Border" | "Filter" | "Link" | "Search" | "" | "Percent" | "Ethereum" | "ChevronDown" | "PaintRoller" | "Bold" | "Italic" | "Strikethrough" | "AlignLeft" | "AlignCenter" | "AlignRight" | "ArrowUpFromLine" | "AlignVerticalMiddle" | "ArrowDownToLine" | "TextOverflow" | "WrapText" | "TextClip" | "Baseline" | "PaintBucket" | "MergeHorizontal" | "DollarSign" | "DecimalsArrowLeft" | "DecimalsArrowRight" | "PaintbrushVertical" | "ArrowDownUp" | "MessageSquarePlus" | "Image" | "Sigma" | "ShieldCheck" | "DuneChart" | "Ellipsis";
 export declare const CurrencySelector: ({ cell, defaultTextFormat, toolTipText, }: {
     cell: Cell | null | undefined;
     defaultTextFormat: string;