@fileverse-dev/dsheet 2.0.27 → 2.0.28-comment-ux-2

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

@@ -7,6 +7,7 @@ declare class CellFadeAnimator {
     markChanged(sheetId: string, r: number, c: number): void;
     getOpacity(sheetId: string, r: number, c: number): number;
     setOnTick(repaintFn: (() => void) | null): void;
+    private sweepExpired;
     private ensureTicking;
 }
 export declare const cellFadeAnimator: CellFadeAnimator;

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

@@ -8,4 +8,4 @@ export declare function getCellValue(ctx: Context, row: number, column: number,
 export declare function setCellValue(ctx: Context, row: number, column: number, value: any, cellInput: HTMLDivElement | null, options?: CommonOptions, callAfterUpdate?: boolean): void;
 export declare function clearCell(ctx: Context, row: number, column: number, options?: CommonOptions): void;
 export declare function setCellFormat(ctx: Context, row: number, column: number, attr: keyof Cell, value: any, options?: CommonOptions): void;
-export declare function autoFillCell(ctx: Context, copyRange: SingleRange, applyRange: SingleRange, direction: "up" | "down" | "left" | "right"): void;
+export declare function autoFillCell(ctx: Context, copyRange: SingleRange, applyRange: SingleRange, direction: 'up' | 'down' | 'left' | 'right'): void;

package/dist/sheet-engine/core/events/mouse.d.ts

@@ -12,7 +12,7 @@ export declare function fixPositionOnFrozenCells(freeze: Freezen | undefined, x:
 };
 export declare function handleCellAreaMouseDown(ctx: Context, globalCache: GlobalCache, e: MouseEvent, cellInput: HTMLDivElement, container: HTMLDivElement, fxInput?: HTMLDivElement | null, canvas?: CanvasRenderingContext2D): void;
 export declare function handleCellAreaDoubleClick(ctx: Context, globalCache: GlobalCache, settings: Settings, e: MouseEvent, container: HTMLElement): void;
-export declare function handleContextMenu(ctx: Context, settings: Settings, e: MouseEvent, workbookContainer: HTMLDivElement, container: HTMLDivElement, area: "cell" | "rowHeader" | "columnHeader"): void;
+export declare function handleContextMenu(ctx: Context, settings: Settings, e: MouseEvent, workbookContainer: HTMLDivElement, container: HTMLDivElement, area: 'cell' | 'rowHeader' | 'columnHeader'): void;
 export declare function mouseRender(ctx: Context, globalCache: GlobalCache, e: MouseEvent, cellInput: HTMLDivElement, scrollX: HTMLDivElement, scrollY: HTMLDivElement, container: HTMLDivElement, fxInput?: HTMLDivElement | null): void;
 export declare function handleOverlayMouseMove(ctx: Context, globalCache: GlobalCache, e: MouseEvent, cellInput: HTMLDivElement, scrollX: HTMLDivElement, scrollY: HTMLDivElement, container: HTMLDivElement, fxInput?: HTMLDivElement | null): void;
 export declare function handleOverlayMouseUp(ctx: Context, globalCache: GlobalCache, settings: Settings, e: MouseEvent, scrollbarX: HTMLDivElement, scrollbarY: HTMLDivElement, container: HTMLDivElement, cellInput: HTMLDivElement | null, fxInput: HTMLDivElement | null): void;

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

@@ -27,7 +27,7 @@ export declare class FormulaCache {
     keyboardRangeSelectionLock?: boolean;
     /** True after arrow/Shift+arrow moved `func_selectedrange` without updating yellow selection. */
     formulaKeyboardRefSync?: boolean;
-    formulaEditorOwner?: "cell" | "fx" | null;
+    formulaEditorOwner?: 'cell' | 'fx' | null;
     functionRangeIndex?: number[];
     functionRangeGlobalOffset?: number | null;
     functionlistMap: any;
@@ -75,8 +75,8 @@ export declare function functionHTMLGenerate(txt: string): string;
 export declare function getLastFormulaRangeIndex($editor: HTMLDivElement): number | null;
 /** Range cell that contains the caret, if any (inside #luckysheet-rich-text-editor tree). */
 export declare function getFormulaRangeIndexAtCaret($editor: HTMLDivElement): number | null;
-export declare function setFormulaEditorOwner(ctx: Context, owner: "cell" | "fx" | null): void;
-export declare function getFormulaEditorOwner(ctx: Context): "cell" | "fx" | null;
+export declare function setFormulaEditorOwner(ctx: Context, owner: 'cell' | 'fx' | null): void;
+export declare function getFormulaEditorOwner(ctx: Context): 'cell' | 'fx' | null;
 /**
  * True when the formula text looks like a truncated A1-style range: LHS has a row
  * number but RHS after ":" is only column letters (e.g. =A1:A after deleting the
@@ -111,7 +111,7 @@ export declare function isLegacyFormulaRangeMode(ctx: Context): boolean;
 export declare function israngeseleciton(ctx: Context, istooltip?: boolean): boolean;
 export declare function isFormulaReferenceInputMode(ctx: Context): boolean;
 export declare function maybeRecoverDirtyRangeSelection(ctx: Context): boolean;
-export declare function functionStrChange(txt: string, type: string, rc: "row" | "col", orient: string | null, stindex: number, step: number): string;
+export declare function functionStrChange(txt: string, type: string, rc: 'row' | 'col', orient: string | null, stindex: number, step: number): string;
 export declare function rangeSetValue(ctx: Context, cellInput: HTMLDivElement, selected: any, fxInput?: HTMLDivElement | null): void;
 export declare function onFormulaRangeDragEnd(ctx: Context): void;
 export declare function rangeDrag(ctx: Context, e: MouseEvent, cellInput: HTMLDivElement, scrollLeft: number, scrollTop: number, container: HTMLDivElement, fxInput?: HTMLDivElement | null): void;

package/dist/sheet-engine/core/modules/inline-string.d.ts

@@ -20,12 +20,12 @@ export declare const inlineStyleAffectAttribute: {
     fc: number;
 };
 export declare const inlineStyleAffectCssName: {
-    "font-weight": number;
-    "font-style": number;
-    "font-family": number;
-    "text-decoration": number;
-    "border-bottom": number;
-    "font-size": number;
+    'font-weight': number;
+    'font-style': number;
+    'font-family': number;
+    'text-decoration': number;
+    'border-bottom': number;
+    'font-size': number;
     color: number;
 };
 export declare function isInlineStringCell(cell: any): boolean;

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

@@ -10,10 +10,10 @@ import { Context } from '../context';
  * @returns
  */
 export declare function insertRowCol(ctx: Context, op: {
-    type: "row" | "column";
+    type: 'row' | 'column';
     index: number;
     count: number;
-    direction: "lefttop" | "rightbottom";
+    direction: 'lefttop' | 'rightbottom';
     id: string;
     /** Pre-insert row index for each inserted row (length must equal count). */
     templateSourceRows?: number[];
@@ -21,7 +21,7 @@ export declare function insertRowCol(ctx: Context, op: {
     templateSourceColumns?: number[];
 }, changeSelection?: boolean): void;
 export declare function deleteRowCol(ctx: Context, op: {
-    type: "row" | "column";
+    type: 'row' | 'column';
     start: number;
     end: number;
     id?: string;

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

@@ -27,7 +27,7 @@ export declare function selectionIsExactlyOneMergeBlock(ctx: Context, selection:
  * else null). Pass `selection` explicitly when normalizing a **new** array that is not
  * yet assigned to `ctx.luckysheet_select_save`.
  */
-export declare function syncPrimaryCellActiveFromSelection(ctx: Context, selection?: SheetType["luckysheet_select_save"] | null): void;
+export declare function syncPrimaryCellActiveFromSelection(ctx: Context, selection?: SheetType['luckysheet_select_save'] | null): void;
 /**
  * Multi-cell range only: move `row_focus` / `column_focus` (and primary) in
  * column-major order — forward: down then next column right, wrapping top-left;
@@ -48,24 +48,24 @@ export declare function setPrimaryCellActive(ctx: Context, r: number, c: number)
  * that range so Enter-primary navigation + typing do not collapse the yellow box.
  */
 export declare function snapSheetSelectionFocusToCellPreserveMultiRange(ctx: Context, r: number, c: number): void;
-export declare function normalizeSelection(ctx: Context, selection: SheetType["luckysheet_select_save"]): Selection[] | undefined;
+export declare function normalizeSelection(ctx: Context, selection: SheetType['luckysheet_select_save']): Selection[] | undefined;
 export declare function selectTitlesMap(rangeMap: Record<string, number>, range1: number, range2: number): Record<string, number>;
 export declare function selectTitlesRange(map: Record<string, number>): number[][];
-export declare function pasteHandlerOfPaintModel(ctx: Context, copyRange: Context["luckysheet_copy_save"]): void;
+export declare function pasteHandlerOfPaintModel(ctx: Context, copyRange: Context['luckysheet_copy_save']): void;
 export declare function selectionCopyShow(range: any, ctx: Context): void;
 export declare function rowHasMerged(ctx: Context, r: number, c1: number, c2: number): boolean;
 export declare function colHasMerged(ctx: Context, c: number, r1: number, r2: number): boolean;
 export declare function getRowMerge(ctx: Context, rIndex: number, c1: number, c2: number): (number | null)[];
 export declare function getColMerge(ctx: Context, cIndex: number, r1: number, r2: number): (number | null)[];
-export declare function moveHighlightCell(ctx: Context, postion: "down" | "right", index: number, type: "rangeOfSelect" | "rangeOfFormula"): void;
-export declare function moveHighlightRange(ctx: Context, postion: "down" | "right", index: number, type: "rangeOfSelect" | "rangeOfFormula"): void;
+export declare function moveHighlightCell(ctx: Context, postion: 'down' | 'right', index: number, type: 'rangeOfSelect' | 'rangeOfFormula'): void;
+export declare function moveHighlightRange(ctx: Context, postion: 'down' | 'right', index: number, type: 'rangeOfSelect' | 'rangeOfFormula'): void;
 export declare function rangeValueToHtml(ctx: Context, sheetId: string, ranges?: Range, options?: RangeValueToHtmlOptions): string | null;
 export declare function copy(ctx: Context): void;
 export declare function deleteSelectedCellText(ctx: Context): string;
 export declare function deleteSelectedCellFormat(ctx: Context): string;
 export declare function fillRightData(ctx: Context): string;
 export declare function fillDownData(ctx: Context): string;
-export declare function textFormat(ctx: Context, type: "left" | "center" | "right"): string;
+export declare function textFormat(ctx: Context, type: 'left' | 'center' | 'right'): string;
 export declare function fillDate(ctx: Context): string;
 export declare function fillTime(ctx: Context): string;
 export declare function selectIsOverlap(ctx: Context, range?: any): boolean;

package/dist/sheet-engine/core/paste/paste-internals.d.ts

@@ -1,8 +1,8 @@
 import { Context } from '../context';
 
 export declare function pasteHandler(ctx: Context, data: any, borderInfo?: any): void;
-export declare function pasteHandlerOfCutPaste(ctx: Context, copyRange: Context["luckysheet_copy_save"]): void;
-export declare function pasteHandlerOfCopyPaste(ctx: Context, copyRange: Context["luckysheet_copy_save"], valuesOnly?: boolean): void;
+export declare function pasteHandlerOfCutPaste(ctx: Context, copyRange: Context['luckysheet_copy_save']): void;
+export declare function pasteHandlerOfCopyPaste(ctx: Context, copyRange: Context['luckysheet_copy_save'], valuesOnly?: boolean): void;
 export declare function handleFormulaStringPaste(ctx: Context, formulaStr: string): void;
 export declare function parseAsLinkIfUrl(txtdata: string, ctx: Context): void;
 export declare function resizePastedCellsToContent(ctx: Context): void;

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

@@ -2,7 +2,7 @@ import { Patch as ImmerPatch } from 'immer';
 import { PatchOptions } from './utils';
 
 export type Op = {
-    op: "replace" | "remove" | "add" | "insertRowCol" | "deleteRowCol" | "addSheet" | "deleteSheet";
+    op: 'replace' | 'remove' | 'add' | 'insertRowCol' | 'deleteRowCol' | 'addSheet' | 'deleteSheet';
     id?: string;
     path: (string | number)[];
     value?: any;
@@ -245,7 +245,7 @@ export type Sheet = {
     dynamicArray_compute?: any;
     dynamicArray?: any[];
     frozen?: {
-        type: "row" | "column" | "both" | "rangeRow" | "rangeColumn" | "rangeBoth";
+        type: 'row' | 'column' | 'both' | 'rangeRow' | 'rangeColumn' | 'rangeBoth';
         range?: {
             row_focus: number;
             column_focus: number;

package/dist/sheet-engine/react/components/Workbook/api.d.ts

@@ -13,6 +13,7 @@ export declare function generateAPIs(context: Context, setContext: (recipe: (ctx
     }) => any;
     onboardingActiveCell: (functionName: string) => void;
     initializeComment: (row: number, column: number) => void;
+    openCommentUI: (row: number, column: number) => void;
     updateSheetLiveQueryList: (subsheetIndex: number, _data: LiveQueryData) => void;
     removeFromLiveQueryList: (subSheetIndex: number, id: string) => void;
     setCellValue: (row: number, column: number, value: any, options?: api.CommonOptions & {

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

@@ -17,6 +17,7 @@ declare const Workbook: React.ForwardRefExoticComponent<Settings & AdditionalPro
     }) => any;
     onboardingActiveCell: (functionName: string) => void;
     initializeComment: (row: number, column: number) => void;
+    openCommentUI: (row: number, column: number) => void;
     updateSheetLiveQueryList: (subsheetIndex: number, _data: import('../../../core').LiveQueryData) => void;
     removeFromLiveQueryList: (subSheetIndex: number, id: string) => void;
     setCellValue: (row: number, column: number, value: any, options?: api.CommonOptions & {

package/dist/sheet-engine/react/hooks/useFormulaEditorHistory.d.ts

@@ -7,7 +7,7 @@ export type FormulaHistoryEntry = {
     caret: number;
 };
 /** Which editor receives caret placement and drives history snapshots. */
-export type FormulaEditorHistoryPrimary = "cell" | "fx";
+export type FormulaEditorHistoryPrimary = 'cell' | 'fx';
 type SetContext = (recipe: (ctx: Context) => void, options?: SetContextOptions) => void;
 /**
  * Custom undo/redo for the cell overlay and Fx bar — **one code path** for