@fileverse-dev/dsheet 2.0.0 → 2.0.2-hyperlink

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

@@ -56,10 +56,7 @@ export declare function getSheetWithLatestCelldata(ctx: Context, options?: Commo
     luckysheet_alternateformat_save?: any[];
     dataVerification?: any;
     conditionRules?: import('../types').ConditionRulesProps;
-    hyperlink?: Record<string, {
-        linkType: string;
-        linkAddress: string;
-    }>;
+    hyperlink?: Record<string, import('..').HyperlinkEntry | import('..').HyperlinkEntry[]>;
     dynamicArray_compute?: any;
     dynamicArray?: any[];
     frozen?: {

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

@@ -192,6 +192,11 @@ export type Context = {
     luckysheetPaintSingle: boolean;
     defaultCell: Cell;
     groupValuesRefreshData: any[];
+    /**
+     * Incremented when formula `func_selectedrange` moves via keyboard (`rangeOfFormula`)
+     * so React re-renders — `FormulaCache` is a class and Immer does not track it.
+     */
+    formulaRangeNavRevision: number;
     formulaCache: FormulaCache;
     hooks: Hooks;
     showSheetList?: boolean;

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

@@ -7,9 +7,9 @@ export { defaultSettings } from './settings';
 export type { Settings, Hooks } 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, getStyleByCell, clearSelectedCellFormat, clearRowsCellsFormat, clearColumnsCellsFormat, clipboard, moveToEnd, getRangeRectsByCharacterOffset, update, is_date, valueShowEs, FormulaCache, groupValuesRefresh, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, maybeRecoverDirtyRangeSelection, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, setFormulaEditorOwner, functionHTMLGenerate, suppressFormulaRangeSelectionForInitialEdit, rangeSetValue, getFormulaRangeIndexForKeyboardSync, createFormulaRangeSelect, isFormulaReferenceInputMode, initFreeze, isInlineStringCell, getInlineStringNoStyle, rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, insertRowCol, deleteRowCol, hideSelected, showSelected, isShowHidenCR, scrollToHighlightCell, selectTitlesMap, selectTitlesRange, normalizeSelection, syncPrimaryCellActiveFromSelection, setPrimaryCellActive, advancePrimaryCellInLastMultiSelection, moveHighlightCell, deleteSelectedCellText, selectAll, fixRowStyleOverflowInFreeze, fixColumnStyleOverflowInFreeze, calcSelectionInfo, addSheet, deleteSheet, editSheetName, changeSheet, updateFormat, autoSelectionFormula, handleBold, handleItalic, handleStrikeThrough, handleUnderline, handleHorizontalAlign, handleVerticalAlign, handleTextColor, handleTextBackground, handleBorder, handleMerge, handleSort, handleFreeze, handleTextSize, handleSum, handleLink, 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, 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, isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, 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, getStyleByCell, clearSelectedCellFormat, clearRowsCellsFormat, clearColumnsCellsFormat, clipboard, moveToEnd, getRangeRectsByCharacterOffset, update, is_date, valueShowEs, FormulaCache, groupValuesRefresh, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, maybeRecoverDirtyRangeSelection, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, setFormulaEditorOwner, functionHTMLGenerate, suppressFormulaRangeSelectionForInitialEdit, rangeSetValue, getFormulaRangeIndexForKeyboardSync, createFormulaRangeSelect, isFormulaReferenceInputMode, seedFormulaFuncSelectedRangeFromLastSelection, initFreeze, isInlineStringCell, getInlineStringNoStyle, applyLinkToSelection, getHyperlinksFromInlineSegments, getUniformLinkFromWindowSelectionInEditor, getHyperlinkAtCaretInContentEditable, rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, insertRowCol, deleteRowCol, hideSelected, showSelected, isShowHidenCR, scrollToHighlightCell, selectTitlesMap, selectTitlesRange, normalizeSelection, syncPrimaryCellActiveFromSelection, 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, handleSort, handleFreeze, handleTextSize, handleSum, handleLink, captureLinkEditorOpenSnapshot, 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, getCellRowColumn, getCellHyperlink, getCellHyperlinks, getHyperlinkDisplayTextInCell, getInlineLinkPlainRange, getUniformLinkCoveringPlainRange, getUniformLinkAtPlainOffset, saveHyperlink, removeHyperlink, removeHyperlinkForLink, updateHyperlinkForLink, syncLinkCardAfterHyperlinkChange, 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, isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, isNumericCellType, iscelldata, getcellrange, cancelFunctionrangeSelected, seletedHighlistByindex, spillSortResult, execfunction, execFunctionGroup, 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';
-export type { Op, Cell, CellWithRowAndCol, CellMatrix, Selection, Presence, Sheet, GlobalCache, SingleRange, Range, SearchResult, LinkCardProps, LiveQueryData, Freezen, } from './types';
+export type { Op, Cell, CellWithRowAndCol, CellMatrix, HyperlinkEntry, Selection, Presence, Sheet, GlobalCache, SingleRange, Range, SearchResult, LinkCardProps, LiveQueryData, Freezen, } from './types';
 export { cellFadeAnimator, markCellChanged } from './animate';

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

@@ -379,6 +379,14 @@ declare const _default: {
         cannotDeleteColumnReadOnly: string;
         cannotInsertOnRowReadOnly: string;
         cannotInsertOnColumnReadOnly: string;
+        insertRowAboveOne: string;
+        insertRowsAboveN: string;
+        insertRowBelowOne: string;
+        insertRowsBelowN: string;
+        insertColumnLeftOne: string;
+        insertColumnsLeftN: string;
+        insertColumnRightOne: string;
+        insertColumnsRightN: string;
         rowOverLimit: string;
         columnOverLimit: string;
         conditionFormat: string;

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

@@ -548,6 +548,14 @@ declare const _default: {
         cannotDeleteColumnReadOnly: string;
         cannotInsertOnRowReadOnly: string;
         cannotInsertOnColumnReadOnly: string;
+        insertRowAboveOne: string;
+        insertRowsAboveN: string;
+        insertRowBelowOne: string;
+        insertRowsBelowN: string;
+        insertColumnLeftOne: string;
+        insertColumnsLeftN: string;
+        insertColumnRightOne: string;
+        insertColumnsRightN: string;
         rowOverLimit: string;
         columnOverLimit: string;
     };

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

@@ -418,6 +418,14 @@ declare const _default: {
         cannotDeleteColumnReadOnly: string;
         cannotInsertOnRowReadOnly: string;
         cannotInsertOnColumnReadOnly: string;
+        insertRowAboveOne: string;
+        insertRowsAboveN: string;
+        insertRowBelowOne: string;
+        insertRowsBelowN: string;
+        insertColumnLeftOne: string;
+        insertColumnsLeftN: string;
+        insertColumnRightOne: string;
+        insertColumnsRightN: string;
         rowOverLimit: string;
         columnOverLimit: string;
     };

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

@@ -435,6 +435,14 @@ declare const _default: {
         cannotDeleteColumnReadOnly: string;
         cannotInsertOnRowReadOnly: string;
         cannotInsertOnColumnReadOnly: string;
+        insertRowAboveOne: string;
+        insertRowsAboveN: string;
+        insertRowBelowOne: string;
+        insertRowsBelowN: string;
+        insertColumnLeftOne: string;
+        insertColumnsLeftN: string;
+        insertColumnRightOne: string;
+        insertColumnsRightN: string;
         rowOverLimit: string;
         columnOverLimit: string;
         conditionFormat: string;

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

@@ -581,6 +581,14 @@ declare const _default: {
         cannotDeleteColumnReadOnly: string;
         cannotInsertOnRowReadOnly: string;
         cannotInsertOnColumnReadOnly: string;
+        insertRowAboveOne: string;
+        insertRowsAboveN: string;
+        insertRowBelowOne: string;
+        insertRowsBelowN: string;
+        insertColumnLeftOne: string;
+        insertColumnsLeftN: string;
+        insertColumnRightOne: string;
+        insertColumnsRightN: string;
         rowOverLimit: string;
         columnOverLimit: string;
     };

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

@@ -1,6 +1,11 @@
 import { Context } from '../context';
 import { Cell, CellMatrix, Range, Selection, SingleRange } from '../types';
 
+/**
+ * Recompute auto row height for one row from wrap/inline cells; updates cfg.rowlen and ctx.config.
+ * Used from updateCell and deleteSelectedCellText (bulk clear).
+ */
+export declare function recalcAutoRowHeightForRow(ctx: Context, r: number, d: CellMatrix, canvas: CanvasRenderingContext2D | null | undefined): void;
 export declare function normalizedCellAttr(cell: Cell, attr: keyof Cell, defaultFontSize?: number): any;
 export declare function normalizedAttr(data: CellMatrix, r: number, c: number, attr: keyof Cell): any;
 export declare function getCellValue(r: number, c: number, data: CellMatrix, attr?: keyof Cell): any;

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

@@ -1,6 +1,11 @@
 export declare function moveToEnd(obj: HTMLDivElement): void;
 export declare function selectTextContent(ele: HTMLElement): void;
 export declare function selectTextContentCross(sEle: HTMLElement, eEle: HTMLElement): void;
+/**
+ * Flat character offset (normalized newlines) of the selection **focus** within `element`.
+ * Use for insert position when opening link UI so appended text goes where the caret was.
+ */
+export declare function getFocusCharacterOffset(element: HTMLElement): number | null;
 /** Returns character offsets of the current selection within the element, or null if collapsed/outside. */
 export declare function getSelectionCharacterOffsets(element: Node): {
     start: number;

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

@@ -23,6 +23,8 @@ export declare class FormulaCache {
     rangedrag_row_start?: boolean;
     rangeSelectionActive?: boolean | null;
     keyboardRangeSelectionLock?: boolean;
+    /** True after arrow/Shift+arrow moved `func_selectedrange` without updating yellow selection. */
+    formulaKeyboardRefSync?: boolean;
     formulaEditorOwner?: "cell" | "fx" | null;
     functionRangeIndex?: number[];
     functionlistMap: any;
@@ -39,6 +41,13 @@ export declare function insertUpdateFunctionGroup(ctx: Context, r: number, c: nu
 export declare function execfunction(ctx: Context, txt: string, r: number, c: number, id?: string, calcChainSet?: Set<string>, isrefresh?: boolean, notInsertFunc?: boolean): any[];
 export declare function groupValuesRefresh(ctx: Context): void;
 export declare function execFunctionGroup(ctx: Context, origin_r: number, origin_c: number, value: any, id?: string, data?: any, isForce?: boolean): void;
+/**
+ * Before the first `moveHighlightCell/Range(..., "rangeOfFormula")` while editing
+ * a formula, copy the current yellow selection into `func_selectedrange` so
+ * keyboard navigation updates only the blue formula overlay (like mouse drag),
+ * without resizing `luckysheet_select_save`.
+ */
+export declare function seedFormulaFuncSelectedRangeFromLastSelection(ctx: Context): boolean;
 export declare function createFormulaRangeSelect(ctx: Context, select: {
     rangeIndex: number;
 } & Rect): void;

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

@@ -1,19 +1,39 @@
 import { Context } from '../context';
-import { GlobalCache } from '../types';
+import { Cell, GlobalCache, HyperlinkEntry } from '../types';
 
 export declare function getCellRowColumn(ctx: Context, e: MouseEvent, container: HTMLDivElement, scrollX: HTMLDivElement, scrollY: HTMLDivElement): {
     r: number;
     c: number;
 } | undefined;
-export declare function getCellHyperlink(ctx: Context, r: number, c: number): {
-    linkType: string;
-    linkAddress: string;
+export declare function getCellHyperlinks(ctx: Context, r: number, c: number): HyperlinkEntry[];
+export declare function getCellHyperlink(ctx: Context, r: number, c: number): HyperlinkEntry;
+/** Join display text for all inline segments that use this link. */
+export declare function getHyperlinkDisplayTextInCell(cell: Cell | null | undefined, link: HyperlinkEntry): string;
+/** Plain-text [start, end) of consecutive inline segments that carry `target`. */
+export declare function getInlineLinkPlainRange(cell: Cell | null | undefined, target: HyperlinkEntry): {
+    start: number;
+    end: number;
 } | undefined;
+/**
+ * If every plain character in [start, end) lies in inline segments that share the same
+ * `link`, returns that link; otherwise undefined (mixed/unlinked text in range).
+ */
+export declare function getUniformLinkCoveringPlainRange(cell: Cell | null | undefined, start: number, end: number): HyperlinkEntry | undefined;
+/** Plain caret offset `pos` lies strictly inside a linked segment (before that segment's end). */
+export declare function getUniformLinkAtPlainOffset(cell: Cell | null | undefined, pos: number): HyperlinkEntry | undefined;
+/** After changing hyperlinks on (r,c), update or close `ctx.linkCard` if it matches. */
+export declare function syncLinkCardAfterHyperlinkChange(ctx: Context, r: number, c: number): void;
 export declare function saveHyperlink(ctx: Context, r: number, c: number, linkText: string, linkType: string, linkAddress: string, options?: {
     applyToSelection?: boolean;
     cellInput?: HTMLDivElement | null;
+    /** When true, apply range from ctx.linkCard using cell data only (no active editor). */
+    applySelectionFromModel?: boolean;
 }): void;
 export declare function removeHyperlink(ctx: Context, r: number, c: number): void;
+/** Remove one distinct hyperlink (inline segment link or sheet map entry). */
+export declare function removeHyperlinkForLink(ctx: Context, r: number, c: number, target: HyperlinkEntry): void;
+/** Update URL/type (and display text when a single segment carries this link). */
+export declare function updateHyperlinkForLink(ctx: Context, r: number, c: number, target: HyperlinkEntry, linkText: string, linkType: string, linkAddress: string): void;
 export declare function showLinkCard(ctx: Context, r: number, c: number, options?: {
     applyToSelection?: boolean;
     originText?: string;
@@ -21,6 +41,14 @@ export declare function showLinkCard(ctx: Context, r: number, c: number, options
         start: number;
         end: number;
     };
+    linkInsertOffset?: number;
+    /** URL/type defaults when inserting but selection (or cell) already maps to one link */
+    prefillLink?: HyperlinkEntry;
+    /**
+     * In-cell edit: show view-only card for this hyperlink (caret / selection inside that
+     * linked run in the contenteditable). Suppresses whole-cell hover list.
+     */
+    caretViewLink?: HyperlinkEntry;
 }, isEditing?: boolean, isMouseDown?: boolean): void;
 export declare function goToLink(ctx: Context, r: number, c: number, linkType: string, linkAddress: string, scrollbarX: HTMLDivElement, scrollbarY: HTMLDivElement): void;
 export declare function isLinkValid(ctx: Context, linkType: string, linkAddress: string): {

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

@@ -3,14 +3,14 @@ export { normalizedCellAttr, normalizedAttr, getCellValue, setCellValue, getReal
 export { default as clipboard } from './clipboard';
 export { moveToEnd, getRangeRectsByCharacterOffset } from './cursor';
 export { update, is_date, valueShowEs } from './format';
-export { FormulaCache, groupValuesRefresh, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, createFormulaRangeSelect, maybeRecoverDirtyRangeSelection, delFunctionGroup, functionHTMLGenerate, onFormulaRangeDragEnd, rangeDrag, rangeSetValue, remapFormulaReferencesByMap, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, getFormulaRangeIndexForKeyboardSync, isFormulaReferenceInputMode, functionStrChange, setFormulaEditorOwner, getAllFunctionGroup, suppressFormulaRangeSelectionForInitialEdit, } from './formula';
+export { FormulaCache, groupValuesRefresh, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, createFormulaRangeSelect, maybeRecoverDirtyRangeSelection, delFunctionGroup, functionHTMLGenerate, onFormulaRangeDragEnd, rangeDrag, rangeSetValue, remapFormulaReferencesByMap, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, getFormulaRangeIndexForKeyboardSync, isFormulaReferenceInputMode, seedFormulaFuncSelectedRangeFromLastSelection, functionStrChange, setFormulaEditorOwner, getAllFunctionGroup, suppressFormulaRangeSelectionForInitialEdit, } from './formula';
 export { initFreeze } from './freeze';
-export { isInlineStringCell, getInlineStringNoStyle } from './inline-string';
+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 { scrollToHighlightCell, seletedHighlistByindex, selectTitlesMap, selectTitlesRange, normalizeSelection, syncPrimaryCellActiveFromSelection, setPrimaryCellActive, advancePrimaryCellInLastMultiSelection, moveHighlightCell, deleteSelectedCellText, selectAll, fixRowStyleOverflowInFreeze, fixColumnStyleOverflowInFreeze, calcSelectionInfo, rangeValueToHtml, } from './selection';
+export { scrollToHighlightCell, seletedHighlistByindex, selectTitlesMap, selectTitlesRange, normalizeSelection, syncPrimaryCellActiveFromSelection, 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, toolbarItemClickHandler, toolbarItemSelectedFunc, updateFormatCell, cancelPaintModel, } from './toolbar';
+export { updateFormat, autoSelectionFormula, handleBold, handleItalic, handleStrikeThrough, handleUnderline, handleHorizontalAlign, handleVerticalAlign, handleTextColor, handleTextBackground, handleBorder, handleMerge, handleSort, handleFreeze, handleTextSize, handleSum, handleLink, captureLinkEditorOpenSnapshot, toolbarItemClickHandler, toolbarItemSelectedFunc, updateFormatCell, cancelPaintModel, } from './toolbar';
 export { handleScreenShot } from './screenshot';
 export { drawArrow, setEditingComment, removeEditingComment, newComment, editComment, deleteComment, showComments, showHideComment, showHideAllComments, onCommentBoxMoveStart, onCommentBoxMove, onCommentBoxMoveEnd, onCommentBoxResize, onCommentBoxResizeEnd, removeOverShowComment, } from './comment';
 export { showImgChooser, insertImage, removeActiveImage, cancelActiveImgItem, onImageMoveStart, onImageResizeStart, onImageMove, onImageMoveEnd, onImageResize, onImageResizeEnd, } from './image';
@@ -18,7 +18,7 @@ export { createDropCellRange, dropCellCache, getTypeItemHide, updateDropCell, }
 export { mergeCells } from './merge';
 export { sortSelection, spillSortResult } from './sort';
 export { searchAll, searchNext, replace, replaceAll } from './searchReplace';
-export { getCellRowColumn, getCellHyperlink, saveHyperlink, removeHyperlink, showLinkCard, goToLink, isLinkValid, } from './hyperlink';
+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 type { FilterDate, FilterValue, FilterColor } from './filter';
 export { onCellsMoveStart, onCellsMove, onCellsMoveEnd } from './moveCells';
@@ -34,7 +34,7 @@ export { jfrefreshgrid } from './refresh';
 export { sanitizeDuneUrl, insertDuneChart, onIframeMoveStart, onIframeResizeStart, onIframeMove, onIframeMoveEnd, onIframeResize, onIframeResizeEnd, } from './iframe';
 export { setCellError, clearCellError, overShowError, } from './error-state-helpers';
 export { checkCellIsLocked } from './protection';
-export { isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, } from './validation';
-export { iscelldata, getcellrange, execfunction, insertUpdateFunctionGroup, functionCopy, } from './formula';
+export { isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, isNumericCellType, } from './validation';
+export { iscelldata, getcellrange, execfunction, execFunctionGroup, insertUpdateFunctionGroup, functionCopy, } from './formula';
 export { checkCF, getComputeMap } from './ConditionFormat';
 export { getdatabyselection, getQKBorder } from './cell';

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

@@ -1,5 +1,5 @@
 import { Context } from '../context';
-import { Cell, CellMatrix, CellStyle } from '../types';
+import { Cell, CellMatrix, CellStyle, HyperlinkEntry } from '../types';
 
 export declare const attrToCssName: {
     bl: string;
@@ -36,6 +36,14 @@ export type InlineSegmentLink = {
     linkType: string;
     linkAddress: string;
 };
+export declare function getHyperlinksFromInlineSegments(cell: Cell | null | undefined): InlineSegmentLink[];
+/** Matches `getLinkStyleCssText` / apply-hyperlink blue foreground in the editor. */
+export declare function isDefaultHyperlinkForeground(fc: string): boolean;
+/**
+ * Drop fc/un that hyperlink insertion adds to inline runs (link metadata is removed separately).
+ * Preserves user bold/italic/etc. on the same segment.
+ */
+export declare function stripInlineSegmentHyperlinkDecoration(seg: CellStyle): void;
 export declare function convertSpanToShareString($dom: NodeListOf<HTMLSpanElement>, originCell: Cell): (CellStyle & {
     v?: string;
     link?: InlineSegmentLink;
@@ -44,3 +52,14 @@ export declare function updateInlineStringFormatOutside(cell: Cell, key: string,
 export declare function updateInlineStringFormat(ctx: Context, attr: keyof Cell, value: any, cellInput: HTMLDivElement): void;
 /** Applies link style (blue + underline) and data-link-* to the current selection in cellInput. Persisted on blur via convertSpanToShareString. */
 export declare function applyLinkToSelection(cellInput: HTMLDivElement, linkType: string, linkAddress: string): void;
+/**
+ * When the window selection is still inside the cell editor, read hyperlink from the
+ * linked span(s) at both range endpoints (same link required).
+ */
+export declare function getUniformLinkFromWindowSelectionInEditor(root: HTMLElement): HyperlinkEntry | undefined;
+/**
+ * Caret or range inside `root`: returns the hyperlink on the collapsed caret, or the
+ * uniform link when a non-collapsed selection stays within one link (same as
+ * {@link getUniformLinkFromWindowSelectionInEditor}).
+ */
+export declare function getHyperlinkAtCaretInContentEditable(root: HTMLElement): HyperlinkEntry | undefined;

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

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

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

@@ -32,6 +32,12 @@ export declare function advancePrimaryCellInLastMultiSelection(ctx: Context, for
  * selection that runs `normalizeSelection` will re-sync from the new range.
  */
 export declare function setPrimaryCellActive(ctx: Context, r: number, c: number): void;
+/**
+ * After formula segment / delete handling, move selection focus to the edited cell
+ * (r,c). If the sheet already has a multi-cell range and (r,c) is inside it, keep
+ * 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"]): import('..').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[][];

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

@@ -27,7 +27,12 @@ export declare function handleSort(ctx: Context, isAsc: boolean): void;
 export declare function handleFreeze(ctx: Context, type: string): void;
 export declare function handleTextSize(ctx: Context, cellInput: HTMLDivElement, size: number, canvas?: CanvasRenderingContext2D): void;
 export declare function handleSum(ctx: Context, cellInput: HTMLDivElement, fxInput: HTMLDivElement | null | undefined, cache?: GlobalCache): void;
-export declare function handleLink(ctx: Context, cellInput: HTMLDivElement | null | undefined): void;
+/**
+ * Records caret and selection offsets for the active cell editor into `cache`.
+ * Call on toolbar link mousedown (before focus leaves the editor) and from selectionchange while editing.
+ */
+export declare function captureLinkEditorOpenSnapshot(ctx: Context, cellInput: HTMLDivElement | null | undefined, cache: GlobalCache | undefined): void;
+export declare function handleLink(ctx: Context, cellInput: HTMLDivElement | null | undefined, cache?: GlobalCache): void;
 export declare function toolbarItemClickHandler(name: string): ToolbarItemClickHandler;
 export declare function toolbarItemSelectedFunc(name: string): ToolbarItemSelectedFunc;
 export {};

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

@@ -16,6 +16,17 @@ export declare function valueIsError(value: string): boolean;
 export declare function isRealNull(val: any): boolean;
 export declare function isHexValue(str: string): boolean;
 export declare function isRealNum(val: any): boolean;
+/**
+ * Explicit number format (`t === 'n'`) or General/Automatic with a numeric stored value (`t === 'g'`).
+ * Use wherever logic previously required `ct.t === 'n'` so Automatic numeric cells behave the same.
+ */
+export declare function isNumericCellType(cell: {
+    ct?: {
+        t?: string;
+        fa?: string;
+    };
+    v?: unknown;
+} | null | undefined): boolean;
 export type DateFormatInfo = {
     year: number;
     month: number;

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

@@ -46,6 +46,7 @@ export type Cell = {
     ct?: {
         fa?: string;
         t?: string;
+        tb?: string;
         s?: any;
     };
     qp?: number;
@@ -78,6 +79,10 @@ export type CellWithRowAndCol = {
     v: Cell | null;
 };
 export type CellMatrix = (Cell | null)[][];
+export type HyperlinkEntry = {
+    linkType: string;
+    linkAddress: string;
+};
 export type Selection = {
     left?: number;
     width?: number;
@@ -220,10 +225,7 @@ export type Sheet = {
     luckysheet_alternateformat_save?: any[];
     dataVerification?: any;
     conditionRules?: ConditionRulesProps;
-    hyperlink?: Record<string, {
-        linkType: string;
-        linkAddress: string;
-    }>;
+    hyperlink?: Record<string, HyperlinkEntry | HyperlinkEntry[]>;
     dynamicArray_compute?: any;
     dynamicArray?: any[];
     frozen?: {
@@ -264,6 +266,10 @@ export type LinkCardProps = {
     originText: string;
     originType: string;
     originAddress: string;
+    /** Distinct links in this cell (rich text); view lists each with its own actions */
+    links?: HyperlinkEntry[];
+    /** When editing, index into `links` for multi-link cells (which URL is being edited) */
+    editingLinkIndex?: number | null;
     position: {
         cellLeft: number;
         cellBottom: number;
@@ -277,6 +283,11 @@ export type LinkCardProps = {
         start: number;
         end: number;
     };
+    /**
+     * Normalized flat offset where typed / appended link text should go (selection focus),
+     * especially when display text is edited and inserted. Falls back to selection end if unset.
+     */
+    linkInsertOffset?: number;
 };
 export type RangeDialogProps = {
     show: boolean;
@@ -398,6 +409,21 @@ export type GlobalCache = {
             } | undefined;
         };
     };
+    /**
+     * Last caret/selection in the cell editor while editing, captured on selectionchange
+     * and on toolbar link mousedown so handleLink still knows insert offsets after focus moves.
+     */
+    linkEditorOpenSnapshot?: {
+        sheetId: string;
+        r: number;
+        c: number;
+        focusOffset: number;
+        range: {
+            start: number;
+            end: number;
+        } | null;
+        selectedPlain: string;
+    };
     dragCellStartPos?: {
         x: number;
         y: number;

package/dist/sheet-engine/core/utils/patch.d.ts

@@ -15,6 +15,8 @@ export type PatchOptions = {
         count: number;
         direction: 'lefttop' | 'rightbottom';
         id: string;
+        templateSourceRows?: number[];
+        templateSourceColumns?: number[];
     };
     deleteRowColOp?: {
         type: 'row' | 'column';

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

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+
+export declare const ResetRowHeight: React.FC;

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

@@ -4,6 +4,7 @@ type Props = {
     tooltip: string;
     iconId: string;
     onClick?: (e: React.MouseEvent<HTMLDivElement, MouseEvent>) => void;
+    onMouseDown?: (e: React.MouseEvent<HTMLDivElement, MouseEvent>) => void;
     disabled?: boolean;
     selected?: boolean;
     children?: React.ReactNode;

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

@@ -6,6 +6,8 @@ import { useDialog } from '../../hooks/useDialog';
 export declare function generateAPIs(context: Context, setContext: (recipe: (ctx: Context) => void, options?: SetContextOptions) => void, handleUndo: () => void, handleRedo: () => void, settings: Required<Settings>, cellInput: HTMLDivElement | null, scrollbarX: HTMLDivElement | null, scrollbarY: HTMLDivElement | null, globalCache: GlobalCache | null, refs: any): {
     applyOp: (ops: Op[]) => void;
     getCryptoPrice: typeof getCryptoPrice;
+    /** Runs the formula engine on every cell in calcChain (all sheets). Use after XLSX import so values are computed, not cached from the file. */
+    recalculateAllFormulas: () => void;
     getCellValue: (row: number, column: number, options?: api.CommonOptions & {
         type?: keyof Cell;
     }) => any;
@@ -105,10 +107,7 @@ export declare function generateAPIs(context: Context, setContext: (recipe: (ctx
         luckysheet_alternateformat_save?: any[];
         dataVerification?: any;
         conditionRules?: import('../../../core/types').ConditionRulesProps;
-        hyperlink?: Record<string, {
-            linkType: string;
-            linkAddress: string;
-        }>;
+        hyperlink?: Record<string, import('../../../core').HyperlinkEntry | import('../../../core').HyperlinkEntry[]>;
         dynamicArray_compute?: any;
         dynamicArray?: any[];
         frozen?: {

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

@@ -12,6 +12,7 @@ type AdditionalProps = {
 declare const Workbook: React.ForwardRefExoticComponent<Settings & AdditionalProps & React.RefAttributes<{
     applyOp: (ops: Op[]) => void;
     getCryptoPrice: typeof getCryptoPrice;
+    recalculateAllFormulas: () => void;
     getCellValue: (row: number, column: number, options?: api.CommonOptions & {
         type?: keyof import('../../../core').Cell;
     }) => any;
@@ -111,10 +112,7 @@ declare const Workbook: React.ForwardRefExoticComponent<Settings & AdditionalPro
         luckysheet_alternateformat_save?: any[];
         dataVerification?: any;
         conditionRules?: import('../../../core/types').ConditionRulesProps;
-        hyperlink?: Record<string, {
-            linkType: string;
-            linkAddress: string;
-        }>;
+        hyperlink?: Record<string, import('../../../core').HyperlinkEntry | import('../../../core').HyperlinkEntry[]>;
         dynamicArray_compute?: any;
         dynamicArray?: any[];
         frozen?: {