@fileverse-dev/dsheet 2.0.13 → 2.0.15

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

@@ -172,6 +172,7 @@ export type Context = {
         row: number[];
         column: number[];
     } | undefined;
+    viewerFilterVisible: boolean;
     filter: Record<string, {
         caljs: any;
         rowhidden: Record<string, number>;

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, 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, searchAll, searchNext, replace, replaceAll, 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, 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, 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, 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 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

@@ -259,6 +259,12 @@ declare const _default: {
         sortTitle: string;
         sortRangeTitle: string;
         sortRangeTitleTo: string;
+        sortSheet: string;
+        sortRange: string;
+        sortSheetByColumnAZ: string;
+        sortSheetByColumnZA: string;
+        sortRangeByColumnAZ: string;
+        sortRangeByColumnZA: string;
         noRangeError: string;
         mergeError: string;
     };

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

@@ -428,6 +428,12 @@ declare const _default: {
         sortTitle: string;
         sortRangeTitle: string;
         sortRangeTitleTo: string;
+        sortSheet: string;
+        sortRange: string;
+        sortSheetByColumnAZ: string;
+        sortSheetByColumnZA: string;
+        sortRangeByColumnAZ: string;
+        sortRangeByColumnZA: string;
         noRangeError: string;
         mergeError: string;
     };

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

@@ -298,6 +298,12 @@ declare const _default: {
         sortTitle: string;
         sortRangeTitle: string;
         sortRangeTitleTo: string;
+        sortSheet: string;
+        sortRange: string;
+        sortSheetByColumnAZ: string;
+        sortSheetByColumnZA: string;
+        sortRangeByColumnAZ: string;
+        sortRangeByColumnZA: string;
         noRangeError: string;
         mergeError: string;
     };

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

@@ -315,6 +315,12 @@ declare const _default: {
         sortTitle: string;
         sortRangeTitle: string;
         sortRangeTitleTo: string;
+        sortSheet: string;
+        sortRange: string;
+        sortSheetByColumnAZ: string;
+        sortSheetByColumnZA: string;
+        sortRangeByColumnAZ: string;
+        sortRangeByColumnZA: string;
         noRangeError: string;
         mergeError: string;
     };

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

@@ -461,6 +461,12 @@ declare const _default: {
         sortTitle: string;
         sortRangeTitle: string;
         sortRangeTitleTo: string;
+        sortSheet: string;
+        sortRange: string;
+        sortSheetByColumnAZ: string;
+        sortSheetByColumnZA: string;
+        sortRangeByColumnAZ: string;
+        sortRangeByColumnZA: string;
         noRangeError: string;
         mergeError: string;
     };

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

@@ -7,6 +7,8 @@ export declare function createFilterOptions(ctx: Context, luckysheet_filter_save
     column: number[];
 } | undefined, sheetId: string | undefined, filterObj?: any, saveData?: boolean): void;
 export declare function clearFilter(ctx: Context): void;
+export declare function toggleViewerFilter(ctx: Context): void;
+export declare function clearFilterForColumn(ctx: Context, cindex: number, startCol: number): void;
 export declare function createFilter(ctx: Context): void;
 export type FilterDate = {
     key: string;

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

@@ -9,6 +9,7 @@ export { initFreeze } from './freeze';
 export { isInlineStringCell, getInlineStringNoStyle, applyLinkToSelection, getHyperlinksFromInlineSegments, getUniformLinkFromWindowSelectionInEditor, getHyperlinkAtCaretInContentEditable, } from './inline-string';
 export { rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, } from './location';
 export { insertRowCol, deleteRowCol, hideSelected, showSelected, isShowHidenCR, hideCRCount, } from './rowcol';
+export { getFilterHiddenRowsUnionFromFilterMap, getFilterHiddenRowsUnion, ensureManualHiddenInitialized, rebuildRowHiddenUnion, } from './rowVisibility';
 export { scrollToHighlightCell, seletedHighlistByindex, selectTitlesMap, selectTitlesRange, normalizeSelection, syncPrimaryCellActiveFromSelection, selectionIsExactlyOneMergeBlock, setPrimaryCellActive, advancePrimaryCellInLastMultiSelection, snapSheetSelectionFocusToCellPreserveMultiRange, moveHighlightCell, deleteSelectedCellText, selectAll, fixRowStyleOverflowInFreeze, fixColumnStyleOverflowInFreeze, calcSelectionInfo, rangeValueToHtml, } from './selection';
 export { addSheet, deleteSheet, editSheetName, changeSheet, updateSheet, } from './sheet';
 export { updateFormat, autoSelectionFormula, handleBold, handleItalic, handleStrikeThrough, handleUnderline, handleHorizontalAlign, handleVerticalAlign, handleTextColor, handleTextBackground, handleBorder, handleMerge, handleSort, handleFreeze, handleTextSize, handleSum, handleLink, captureLinkEditorOpenSnapshot, isHyperlinkCreationBlocked, toolbarItemClickHandler, toolbarItemSelectedFunc, updateFormatCell, cancelPaintModel, } from './toolbar';
@@ -17,11 +18,11 @@ export { drawArrow, setEditingComment, removeEditingComment, newComment, editCom
 export { showImgChooser, insertImage, removeActiveImage, cancelActiveImgItem, onImageMoveStart, onImageResizeStart, onImageMove, onImageMoveEnd, onImageResize, onImageResizeEnd, } from './image';
 export { createDropCellRange, dropCellCache, getTypeItemHide, updateDropCell, } from './dropCell';
 export { mergeCells, mergeSelectionHasValues } from './merge';
-export { sortSelection, spillSortResult } from './sort';
+export { sortSelection, sortSheetBySelectedColumn, spillSortResult, } from './sort';
 export { searchAll, searchNext, replace, replaceAll, getSearchIndexArr, getSearchIndexArrAsync, getFindRangeOnCurrentSheet, getQuickSearchIndexArr, getQuickSearchHiddenConfig, expandCellRectForMerge, shouldQuickSearchUseAsync, runQuickSearchIndexArrAsync, QUICK_SEARCH_ASYNC_ROW_THRESHOLD, parseRangeText, } from './searchReplace';
 export type { CheckModes, HyperlinkMap, FindSearchScope, SearchHiddenConfig, SearchNextResult, ReplaceAllResult, } from './searchReplace';
 export { getCellRowColumn, getCellHyperlink, getCellHyperlinks, getHyperlinkDisplayTextInCell, getInlineLinkPlainRange, getUniformLinkCoveringPlainRange, getUniformLinkAtPlainOffset, saveHyperlink, removeHyperlink, removeHyperlinkForLink, updateHyperlinkForLink, syncLinkCardAfterHyperlinkChange, showLinkCard, goToLink, isLinkValid, } from './hyperlink';
-export { createFilterOptions, clearFilter, createFilter, getFilterColumnValues, getFilterColumnColors, orderbydatafiler, saveFilter, } from './filter';
+export { createFilterOptions, clearFilter, clearFilterForColumn, toggleViewerFilter, createFilter, getFilterColumnValues, getFilterColumnColors, orderbydatafiler, saveFilter, } from './filter';
 export type { FilterDate, FilterValue, FilterColor } from './filter';
 export { onCellsMoveStart, onCellsMove, onCellsMoveEnd } from './moveCells';
 export { cfSplitRange } from './conditionalFormat';

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

@@ -0,0 +1,12 @@
+import { Context } from '../context';
+
+export declare function getFilterHiddenRowsUnionFromFilterMap(filter: Context['filter'] | null | undefined): Record<string, number>;
+export declare function getFilterHiddenRowsUnion(ctx: Context): Record<string, number>;
+/**
+ * Migration/initialization helper:
+ * - If `rowhidden_manual` exists, keep it.
+ * - Otherwise, derive it from existing `rowhidden` by subtracting active filter-hidden rows
+ *   (if a filter is active), else treat all `rowhidden` as manual.
+ */
+export declare function ensureManualHiddenInitialized(ctx: Context): void;
+export declare function rebuildRowHiddenUnion(ctx: Context): void;

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

@@ -25,6 +25,8 @@ export declare function deleteRowCol(ctx: Context, op: {
     start: number;
     end: number;
     id?: string;
+    /** Internal: when true, do not re-split row ranges by visibility under filter. */
+    skipFilterVisibleOnly?: boolean;
 }): void;
 export declare function computeRowlenArr(ctx: Context, rowHeight: number, cfg: any): number[];
 export declare function hideSelected(ctx: Context, type: string): "" | "noMulti";

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

@@ -6,5 +6,6 @@ export declare function orderbydata(isAsc: boolean, index: number, data: (Cell |
 };
 export declare function sortDataRange(ctx: Context, sheetData: CellMatrix, dataRange: CellMatrix, index: number, isAsc: boolean, str: number, edr: number, stc: number, edc: number): void;
 export declare function sortSelection(ctx: Context, isAsc: boolean, colIndex?: number): void;
+export declare function sortSheetBySelectedColumn(ctx: Context, isAsc: boolean): void;
 export declare function spillSortResult(ctx: Context, startRow: number, startCol: number, formulaResult: any, // expects { f: string, v: any[][] }
 flowdata?: CellMatrix): boolean;

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

@@ -125,6 +125,14 @@ export type SheetConfig = {
     rowlen?: Record<string, number>;
     columnlen?: Record<string, number>;
     rowhidden?: Record<string, number>;
+    /**
+     * Manually hidden rows (provenance-safe). `rowhidden` remains the render-time union of
+     * manual + filter-hidden rows. This map stores only manual hides so filters can be
+     * cleared without losing manual state.
+     */
+    rowhidden_manual?: Record<string, number>;
+    /** Cached union of all filter-hidden rows on the sheet (derived from `ctx.filter[*].rowhidden`). */
+    rowhidden_filter?: Record<string, number>;
     colhidden?: Record<string, number>;
     customHeight?: Record<string, number>;
     customWidth?: Record<string, number>;

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

@@ -0,0 +1,18 @@
+import { default as React } from 'react';
+import { Context } from '../../../core';
+
+export type SortLocaleLabels = {
+    sortSheet: string;
+    sortRange: string;
+    sortSheetByColumnAZ: string;
+    sortSheetByColumnZA: string;
+    sortRangeByColumnAZ: string;
+    sortRangeByColumnZA: string;
+};
+declare const SortPopoverContent: React.FC<{
+    context: Context;
+    setContext: (updater: (draftCtx: Context) => void) => void;
+    sortLocale: SortLocaleLabels;
+    setOpen: React.Dispatch<React.SetStateAction<boolean>>;
+}>;
+export default SortPopoverContent;

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" | "MessageSquarePlus" | "Image" | "Sigma" | "ShieldCheck" | "DuneChart" | "Ellipsis";
+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 CurrencySelector: ({ cell, defaultTextFormat, toolTipText, }: {
     cell: Cell | null | undefined;
     defaultTextFormat: string;