@a3s-lab/office 0.34.0 → 0.36.0

package/dist/0~spreadsheet-editor.js

@@ -6,7 +6,7 @@ import { Fragment as external_react_Fragment, cloneElement, memo, useCallback, u
 import { convertSpanToShareString, genarate, indexToColumnChar, update as core_update } from "@fortune-sheet/core";
 import { freezeImportedSpreadsheetCell, normalizeXlsxSemanticColorOrigin, spreadsheetMatrixProfile, withXlsxPatternFill, withoutEditableRange, normalizeSpreadsheetConditionalVisualOptions, xlsxSemanticColorMatchesValue, withXlsxGradientFill, effectiveSpreadsheetPageSetup, attachSpreadsheetShownCommentCells, normalizeXlsxPatternFill, withEditableRange, sameSpreadsheetHistoryValue, isSpreadsheetConditionalComparisonOperator, spreadsheetConditionalIconForValue, defaultSpreadsheetConditionalIconThresholds, xlsxPatternFillTypes, sheetProtectionAuthority, normalizeXlsxGradientFill, xlsxGradientFillFallbackColor, editableRangeCellCount, unlockedCellCount, registerDerivedSpreadsheetMatrix, editableRangeRequiresCredentials, SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS, normalizeSpreadsheetConditionalIconSetFormat, defaultSpreadsheetDataBarOptions, spreadsheetConditionalThresholdValue, normalizeSheetProtectionAuthority, withSheetProtection, spreadsheetProtectionKey, defaultSpreadsheetColorScaleThresholds, protectedSheetCount, SPREADSHEET_CONDITIONAL_ICON_SETS, withSheetSelectionPermissions, spreadsheetConditionalComparisonNeedsUpperValue, drawSpreadsheetConditionalIcon, spreadsheetConditionalThresholdsEqual } from "./9333.js";
 import { workSpreadsheetChartSupportsGrouping, spreadsheetFormulaRangesForSelection, createSpreadsheetChartFromSelection, normalizeWorkSpreadsheetDataLabelPosition, normalizeSpreadsheetPrintTitleColumns, normalizeSpreadsheetPrintTitleRows, formulaHasStructuredReference, normalizeWorkSpreadsheetErrorBars, defaultPivotValueCaption, workSpreadsheetChartSupportsBarSpacing, normalizeWorkSpreadsheetChartGrouping, spreadsheetGridSize, normalizeWorkSpreadsheetChartAxisGroup, normalizeWorkSpreadsheetScatterStyle, cloneSparseMatrix, spreadsheetPivotAggregationLabel, workSpreadsheetChartAxisIsCategoryAxis, reconcileSpreadsheetChartPreviews, normalizeWorkSpreadsheetChartAxes, normalizeWorkSpreadsheetDoughnutHoleSize, normalizeWorkSpreadsheetChartLegendPosition, spreadsheetChartCount, workSpreadsheetChartTypeLabel, sparseArrayEntries, normalizeWorkSpreadsheetTrendline, effectiveSpreadsheetCalculationSettings, spreadsheetPivotIntersects, normalizeWorkSpreadsheetDataLabels, spreadsheetPivotOutputContains, normalizeSpreadsheetPrintArea, spreadsheetCellAddress, formatSpreadsheetCellRanges, normalizeWorkSpreadsheetChartLayout, spreadsheetFormulaRangeForCell, workSpreadsheetChartAxisIsValueAxis, normalizeWorkSpreadsheetChartSmoothLines, spreadsheetPivotFilterValueKey, normalizeWorkSpreadsheetBubbleScale, normalizeWorkSpreadsheetChartSeriesStyle, volatileSpreadsheetFormulaFunctions, sparseArrayIndexes, normalizeWorkSpreadsheetBubbleSizeRepresents, workSpreadsheetChartSupportsTrendlines, normalizeWorkSpreadsheetChartLegendOverlay, parseSpreadsheetChartReference, workSpreadsheetChartGroupingIsStacked, normalizeWorkSpreadsheetChartGapWidth, workSpreadsheetChartSupportsSmoothLines, refreshSpreadsheetPivotTables, createSpreadsheetPivotFromSelection, reconcileSpreadsheetPivots, spreadsheetPivotCount, sparseMatrixColumnCount, workSpreadsheetChartSupportsErrorBars, formulaHasExternalReference, isValidSpreadsheetDefinedName, spreadsheetPivotValidation, deleteSpreadsheetPivotTable, workSpreadsheetChartAxisDefaultLabelPosition, workSpreadsheetChartSupportsSeriesAnalysis, parseSpreadsheetCellRanges, spreadsheetPivotFilterItems, spreadsheetPivotFields, normalizeWorkSpreadsheetChartOverlap, spreadsheetFormulaRangeConflict, spreadsheetSheetsWithChartPreviews, workSpreadsheetChartUsesNumericXAxis, workSpreadsheetChartAxisShowsMajorGridlinesByDefault, workSpreadsheetChartSupportsAxes, normalizeWorkSpreadsheetCombinationSeriesType, normalizeWorkSpreadsheetRadarStyle } from "./8715.js";
-import { spreadsheetTextOrientationFromChoice, isSpreadsheetTextOrientationId, xlsxRichTextCellText, spreadsheetTextOrientationFromAngle, spreadsheetCellValueWithDiagonalBorder, spreadsheetUnderlineCellValue, normalizeSpreadsheetDataValidationErrorStyle, normalizeXlsxRichTextEditSource, normalizeXlsxRichTextColor, isHighSurrogate, xlsxNativeFillCellKeys, createOfficeSpreadsheetCollaborationBinding as createWorkOfficeSpreadsheetCollaborationBinding, boundedSpreadsheetDataValidationText, normalizeSpreadsheetDateValidationBoundary, normalizeXlsxRichTextCell, activeXlsxNativeFill, spreadsheetUnderlineStyle, deleteXlsxNativeFills, spreadsheetTextOrientationCellStyle, spreadsheetTextOrientationChoiceFromCell, normalizeXlsxRichTextRun, spreadsheetDiagonalBorderFromCellValue, sameXlsxRichTextRunStyle, isLowSurrogate, spreadsheetTextOrientationFromCell, coalesceXlsxRichTextRuns, patchSpreadsheetRichTextFontRuns, replaceOfficeSpreadsheetCollaboration as replaceWorkOfficeSpreadsheetCollaboration, validXlsxRichText, readOfficeSpreadsheetCollaboration as readWorkOfficeSpreadsheetCollaboration, isSpreadsheetUnderlineStyle, spreadsheetVisibleTextRotationFromCell } from "./3266.js";
+import { reconcileSpreadsheetTableCalculatedColumns, spreadsheetTextOrientationFromChoice, xlsxRichTextCellText, isSpreadsheetTextOrientationId, spreadsheetTextOrientationFromAngle, readOfficeSpreadsheetCollaboration as readWorkOfficeSpreadsheetCollaboration, spreadsheetCellValueWithDiagonalBorder, spreadsheetUnderlineCellValue, normalizeSpreadsheetDataValidationErrorStyle, normalizeXlsxRichTextEditSource, normalizeXlsxRichTextColor, isHighSurrogate, xlsxNativeFillCellKeys, createOfficeSpreadsheetCollaborationBinding as createWorkOfficeSpreadsheetCollaborationBinding, boundedSpreadsheetDataValidationText, normalizeXlsxRichTextCell, activeXlsxNativeFill, spreadsheetUnderlineStyle, normalizeSpreadsheetDateValidationBoundary, deleteXlsxNativeFills, spreadsheetTextOrientationCellStyle, spreadsheetTextOrientationChoiceFromCell, normalizeXlsxRichTextRun, spreadsheetDiagonalBorderFromCellValue, sameXlsxRichTextRunStyle, isLowSurrogate, spreadsheetTextOrientationFromCell, coalesceXlsxRichTextRuns, patchSpreadsheetRichTextFontRuns, fillSpreadsheetTableCalculatedColumns, validXlsxRichText, replaceOfficeSpreadsheetCollaboration as replaceWorkOfficeSpreadsheetCollaboration, isSpreadsheetUnderlineStyle, spreadsheetVisibleTextRotationFromCell } from "./3266.js";
 import { moveOfficeMenuFocus, stepOfficeZoom, useOfficeRemoteParticipants, Popover, Dialog, officePresenceColor, useOfficePublishPresenceLocation, button_Button, icon_button_IconButton, moveOfficeGridMenuFocus, office_text_field_OfficeTextField, useDialogFocusScope, useOfficeEditorWheelZoom } from "./0~8136.js";
 import { isOfficeKernelSpreadsheetError, normalizeCssColor, OFFICE_KERNEL_SPREADSHEET_MAX_ROWS, createOfficeId as createWorkId } from "./4121.js";
 import { useOfficeTaskPaneEscape, OfficeCheckbox, CommittedOfficeNumberField, useOfficeDialog, useOfficeTaskPaneModal, createOfficeKernelClient, officeFontFamilies, CollectionState, OfficeNumberField, handleOfficeTaskPaneKeyDown } from "./0~7048.js";
@@ -3769,12 +3769,22 @@ function reconcileSpreadsheetTablesAfterFortune(sheets, sourceSheets, operations
         const sheetOperations = operations.filter((operation)=>operation.id === source.id);
         let tables = source.tables;
         const reconcileColumns = new Set();
+        const calculatedColumnRows = new Map();
         if (!operations.length) for (const table of tables)reconcileColumns.add(table.id);
         for (const operation of sheetOperations){
             const structure = spreadsheetTableStructureChangeFromOperation(operation);
             if (structure) {
+                transformCalculatedColumnRows(calculatedColumnRows, structure);
                 const transformed = [];
                 for (const table of tables){
+                    if ('row' === structure.axis && 'insert' === structure.kind) {
+                        const insertedRows = rowsInsertedIntoSpreadsheetTableBody(table, structure);
+                        if (insertedRows.length) {
+                            const rows = calculatedColumnRows.get(table.id) ?? new Set();
+                            for (const row of insertedRows)rows.add(row);
+                            calculatedColumnRows.set(table.id, rows);
+                        }
+                    }
                     const next = transformSpreadsheetTableStructure(table, structure);
                     if (next) {
                         transformed.push(next);
@@ -3786,7 +3796,7 @@ function reconcileSpreadsheetTablesAfterFortune(sheets, sourceSheets, operations
             }
             const coordinate = spreadsheetCellCoordinateFromOperation(operation);
             if (!coordinate) continue;
-            const table = tables.find((candidate)=>candidate.headerRow && candidate.range.row[0] === coordinate.row && coordinate.column >= candidate.range.column[0] && coordinate.column <= candidate.range.column[1]);
+            const table = tables.find((candidate)=>spreadsheetTableContainsCell(candidate, coordinate.row, coordinate.column));
             if (table) reconcileColumns.add(table.id);
         }
         const updates = [];
@@ -3794,7 +3804,11 @@ function reconcileSpreadsheetTablesAfterFortune(sheets, sourceSheets, operations
         tables = tables.map((table)=>{
             if (!reconcileColumns.has(table.id)) return table;
             const columns = canonicalSpreadsheetTableColumns(table, readCell);
-            if (table.headerRow) for (const [offset, column] of columns.entries()){
+            const calculatedColumns = reconcileSpreadsheetTableCalculatedColumns(sheet, {
+                ...table,
+                columns
+            });
+            if (table.headerRow) for (const [offset, column] of calculatedColumns.entries()){
                 const cellColumn = table.range.column[0] + offset;
                 if (spreadsheetCellText(readCell(table.range.row[0], cellColumn)) !== column.name) updates.push({
                     column: cellColumn,
@@ -3802,12 +3816,19 @@ function reconcileSpreadsheetTablesAfterFortune(sheets, sourceSheets, operations
                     row: table.range.row[0]
                 });
             }
-            return sameSpreadsheetTableColumns(table.columns, columns) ? table : {
+            return sameSpreadsheetTableColumns(table.columns, calculatedColumns) ? table : {
                 ...table,
-                columns
+                columns: calculatedColumns
             };
         });
-        const withHeaders = stampSpreadsheetTableHeaderCells(sheet, updates);
+        let withCalculatedColumns = sheet;
+        for (const table of tables){
+            const rows = calculatedColumnRows.get(table.id);
+            if (rows?.size) withCalculatedColumns = fillSpreadsheetTableCalculatedColumns(withCalculatedColumns, table, [
+                ...rows
+            ]);
+        }
+        const withHeaders = stampSpreadsheetTableHeaderCells(withCalculatedColumns, updates);
         return {
             ...withHeaders,
             tables: tables.length ? tables : void 0
@@ -3870,6 +3891,39 @@ function transformSpreadsheetTableStructure(table, change) {
         filters: filtersAfterSpreadsheetTableColumnDeletion(table.filters, transformed.offset, removed)
     };
 }
+function spreadsheetTableContainsCell(table, row, column) {
+    return row >= table.range.row[0] && row <= table.range.row[1] && column >= table.range.column[0] && column <= table.range.column[1];
+}
+function rowsInsertedIntoSpreadsheetTableBody(table, change) {
+    if ('row' !== change.axis) return [];
+    const transformed = transformSpreadsheetTableAxisForInsertion(table.range.row, change);
+    if (!transformed.inside) return [];
+    const insertion = change.index + ('rightbottom' === change.direction ? 1 : 0);
+    const bodyStart = table.range.row[0] + Number(table.headerRow);
+    if (insertion < bodyStart) return [];
+    return Array.from({
+        length: change.count
+    }, (_, offset)=>insertion + offset);
+}
+function transformCalculatedColumnRows(rowsByTable, change) {
+    if ('row' !== change.axis || !rowsByTable.size) return;
+    if ('insert' === change.kind) {
+        const insertion = change.index + ('rightbottom' === change.direction ? 1 : 0);
+        for (const [tableId, rows] of rowsByTable){
+            const next = new Set();
+            for (const row of rows)next.add(row >= insertion ? row + change.count : row);
+            rowsByTable.set(tableId, next);
+        }
+        return;
+    }
+    const count = change.end - change.start + 1;
+    for (const [tableId, rows] of rowsByTable){
+        const next = new Set();
+        for (const row of rows)if (row < change.start) next.add(row);
+        else if (row > change.end) next.add(row - count);
+        rowsByTable.set(tableId, next);
+    }
+}
 function transformSpreadsheetTableAxisForInsertion(axis, change) {
     const start = axis[0] ?? 0;
     const end = axis[1] ?? start;
@@ -4092,7 +4146,7 @@ function truncateSpreadsheetTableColumnName(value, maximum) {
     return Array.from(value).slice(0, maximum).join('');
 }
 function sameSpreadsheetTableColumns(left, right) {
-    return left.length === right.length && left.every((column, index)=>column.name === right[index]?.name);
+    return left.length === right.length && left.every((column, index)=>column.name === right[index]?.name && column.calculatedFormula === right[index]?.calculatedFormula);
 }
 function spreadsheet_table_reconciliation_isRecord(value) {
     return Boolean(value && 'object' == typeof value && !Array.isArray(value));
@@ -5315,6 +5369,70 @@ function spreadsheetCellFillRangeIsSafe(range) {
 function sameSpreadsheetCellRange(left, right) {
     return left.row[0] === right.row[0] && left.row[1] === right.row[1] && left.column[0] === right.column[0] && left.column[1] === right.column[1];
 }
+function canEditSpreadsheetSelection(context) {
+    return Boolean(context.editable && context.workbook && context.targetSheetId);
+}
+function spreadsheetLiveCommandRange(context) {
+    const selection = spreadsheetLiveCommandSelection(context);
+    return spreadsheetSingleRange(selection ?? context.fallbackRange);
+}
+function spreadsheetLiveCommandSelection(context) {
+    return spreadsheetLiveCommandSelections(context)?.at(-1);
+}
+function spreadsheetLiveCommandSelections(context) {
+    const shadow = context.selectionRef?.current;
+    if (shadow?.sheetId === context.targetSheetId) return [
+        shadow.selection
+    ];
+    return context.workbook?.getSelection();
+}
+function acceptSpreadsheetSelectionChange(selectionRef, sheetId, selection) {
+    const nextSelection = finiteSpreadsheetSelection(selection);
+    const requested = selectionRef.requested;
+    if (requested && (requested.sheetId !== sheetId || !sameSpreadsheetSelectionValue(requested.selection, nextSelection))) return null;
+    const next = {
+        sheetId,
+        selection: nextSelection
+    };
+    selectionRef.current = next;
+    return next;
+}
+function rememberSpreadsheetCommandSelection(context, selection) {
+    if (!context.selectionRef || !context.targetSheetId) return;
+    const next = {
+        ...selection,
+        row: [
+            ...selection.row
+        ],
+        column: [
+            ...selection.column
+        ]
+    };
+    context.selectionRef.current = {
+        sheetId: context.targetSheetId,
+        selection: next
+    };
+    context.selectionRef.requested = {
+        sheetId: context.targetSheetId,
+        selection: {
+            ...next,
+            row: [
+                ...next.row
+            ],
+            column: [
+                ...next.column
+            ]
+        }
+    };
+}
+function releaseSpreadsheetSelectionRequest(selectionRef) {
+    selectionRef.requested = null;
+}
+function sameSpreadsheetSelectionValue(left, right) {
+    const normalizedLeft = finiteSpreadsheetSelection(left);
+    const normalizedRight = finiteSpreadsheetSelection(right);
+    return normalizedLeft.row[0] === normalizedRight.row[0] && normalizedLeft.row[1] === normalizedRight.row[1] && normalizedLeft.column[0] === normalizedRight.column[0] && normalizedLeft.column[1] === normalizedRight.column[1] && normalizedLeft.row_focus === normalizedRight.row_focus && normalizedLeft.column_focus === normalizedRight.column_focus;
+}
 function createSpreadsheetCellFillExtension() {
     return createOfficeEditorExtension({
         name: 'spreadsheetCellFill',
@@ -5365,9 +5483,11 @@ function materializeSpreadsheetCellFillRows(sheet, plan) {
 }
 function spreadsheetSelectedCellFillPlan(context, direction) {
     if (!context.editable || !context.workbook || !context.targetSheetId || context.targetSheetId !== context.activeSheetId) return null;
-    const selections = context.workbook.getSelection();
+    const selections = spreadsheetLiveCommandSelections(context);
     if (selections?.length !== 1) return null;
-    const plan = planSpreadsheetCellFill(selections[0], direction);
+    const selection = selections[0];
+    if (!selection) return null;
+    const plan = planSpreadsheetCellFill(selection, direction);
     if (!plan) return null;
     const sheet = context.content.sheets.find((candidate)=>candidate.id === context.targetSheetId);
     return canApplySpreadsheetCellFill(sheet, plan) ? plan : null;
@@ -6323,13 +6443,6 @@ function applySelectedCellStyle(context, preset) {
 function liveSpreadsheetCellStyleRange(context) {
     return spreadsheetSingleRange(context.workbook?.getSelection()?.at(-1) ?? context.fallbackRange);
 }
-function canEditSpreadsheetSelection(context) {
-    return Boolean(context.editable && context.workbook && context.targetSheetId);
-}
-function spreadsheetLiveCommandRange(context) {
-    const selection = context.workbook?.getSelection()?.at(-1);
-    return spreadsheetSingleRange(selection ?? context.fallbackRange);
-}
 const MAX_SPREADSHEET_ROWS = 1048576;
 const spreadsheetPasteContentOptions = [
     {
@@ -8493,7 +8606,7 @@ function updateSpreadsheetSelection(context, storage, update) {
     if (!context.workbook || !context.targetSheetId) return false;
     const sheet = context.content.sheets.find((candidate)=>candidate.id === context.targetSheetId);
     if (!sheet) return false;
-    const liveSelection = context.workbook.getSelection()?.at(-1) ?? context.fallbackRange;
+    const liveSelection = spreadsheetLiveCommandSelection(context) ?? context.fallbackRange;
     const rememberedFocus = storage.focus;
     const selection = rememberedFocus && spreadsheetSelectionContainsFocus(liveSelection, rememberedFocus) ? {
         ...liveSelection,
@@ -8507,6 +8620,7 @@ function updateSpreadsheetSelection(context, storage, update) {
         ], {
             id: context.targetSheetId
         });
+        rememberSpreadsheetCommandSelection(context, next);
         storage.focus = {
             row: next.row_focus ?? next.row[1] ?? next.row[0] ?? 0,
             column: next.column_focus ?? next.column[1] ?? next.column[0] ?? 0
@@ -9318,7 +9432,7 @@ function applySpreadsheetTable(content, request) {
         family: 'medium',
         number: 2
     };
-    const table = {
+    const tableWithoutCalculatedColumns = {
         id: createWorkId('spreadsheet-table'),
         name: validation.name,
         range: cloneRange(validation.range),
@@ -9334,6 +9448,10 @@ function applySpreadsheetTable(content, request) {
         showRowStripes: 'none' !== style.family,
         showColumnStripes: false
     };
+    const table = {
+        ...tableWithoutCalculatedColumns,
+        columns: reconcileSpreadsheetTableCalculatedColumns(validation.sheet, tableWithoutCalculatedColumns)
+    };
     const nextSheet = request.headerRow ? stampSpreadsheetTableHeaders(validation.sheet, validation.range, validation.columns) : validation.sheet;
     return replaceSpreadsheetTableSheet(content, {
         ...nextSheet,
@@ -10010,6 +10128,16 @@ function pasteCells(context, values) {
         ], {
             id: context.targetSheetId
         });
+        rememberSpreadsheetCommandSelection(context, {
+            row: [
+                ...range.row
+            ],
+            column: [
+                ...range.column
+            ],
+            row_focus: range.row[0],
+            column_focus: range.column[0]
+        });
     } catch  {}
     syncSpreadsheetFormulaBar(context, data[0][0]);
     return true;
@@ -10374,9 +10502,9 @@ function createSpreadsheetFormulaDiagnostics(content, { summary, locations }) {
     });
     if (summary.structuredReferenceCells) diagnostics.push({
         code: 'formula.structured-references',
-        severity: 'warning',
+        severity: 'info',
         title: '结构化引用',
-        message: `${summary.structuredReferenceCells} 个公式使用表格结构化引用；公式会原样保存，但当前计算引擎不解析 Excel 表对象。`,
+        message: `${summary.structuredReferenceCells} 个公式使用表格结构化引用；浏览器内核支持有界表名、显示名称、连续列范围以及常见标题、数据、汇总和当前行选择。不连续、外部或高级形式会保留公式与缓存值，交由兼容应用重算。`,
         locations: locations.structured
     });
     if (summary.unsupportedFunctions.length) diagnostics.push({
@@ -21838,10 +21966,15 @@ function compileSpreadsheetKernelWorkbook(sheets, fallbackCells = []) {
         cellCount += cells.length;
         sheetIds.add(id);
         sheetNames.add(normalizedName);
+        const tables = spreadsheetKernelTables(sheet.tables);
+        if (null === tables) return null;
         sourceSheets.push({
             id,
             name,
-            cells
+            cells,
+            ...tables.length ? {
+                tables
+            } : {}
         });
     }
     const compiled = sourceSheets.map((sheet)=>({
@@ -21884,7 +22017,8 @@ function spreadsheetKernelSourceState(sheets) {
         sourceCells,
         structureKey: JSON.stringify(sheets.map((sheet)=>({
                 id: sheet.id,
-                name: sheet.name
+                name: sheet.name,
+                tables: sheet.tables ?? []
             })))
     };
 }
@@ -21902,7 +22036,18 @@ function spreadsheetStructureKey(sheets) {
         names.add(normalizedName);
         structure.push({
             id,
-            name
+            name,
+            tables: (sheet.tables ?? []).map((table)=>({
+                    name: table.name,
+                    displayName: table.displayName,
+                    startRow: table.range.row[0],
+                    endRow: table.range.row[1],
+                    startColumn: table.range.column[0],
+                    endColumn: table.range.column[1],
+                    columns: table.columns.map((column)=>column.name),
+                    headerRow: table.headerRow,
+                    totalsRow: table.totalsRow
+                }))
         });
     }
     return JSON.stringify(structure);
@@ -21985,6 +22130,49 @@ function spreadsheetKernelInputCell(cell, fallback) {
     const { formula: _formula, ...cachedCell } = cell;
     return cachedCell;
 }
+function spreadsheetKernelTables(tables) {
+    if (!tables?.length) return [];
+    const names = new Map();
+    const ranges = [];
+    for (const [tableIndex, table] of tables.entries()){
+        const [startRow, endRow] = table.range.row;
+        const [startColumn, endColumn] = table.range.column;
+        if (!table.name?.trim() || utf8ByteLength(table.name) > SPREADSHEET_KERNEL_MAX_IDENTIFIER_BYTES || void 0 !== table.displayName && (!table.displayName.trim() || utf8ByteLength(table.displayName) > SPREADSHEET_KERNEL_MAX_IDENTIFIER_BYTES) || !isSpreadsheetCoordinateIndex(startRow, OFFICE_KERNEL_SPREADSHEET_MAX_ROWS) || !isSpreadsheetCoordinateIndex(endRow, OFFICE_KERNEL_SPREADSHEET_MAX_ROWS) || !isSpreadsheetCoordinateIndex(startColumn, 16384) || !isSpreadsheetCoordinateIndex(endColumn, 16384) || startRow > endRow || startColumn > endColumn || table.columns.length !== endColumn - startColumn + 1) return null;
+        for (const alias of [
+            table.name,
+            table.displayName
+        ]){
+            if (!alias) continue;
+            const normalized = alias.toLocaleLowerCase();
+            const previous = names.get(normalized);
+            if (void 0 !== previous && previous !== tableIndex) return null;
+            names.set(normalized, tableIndex);
+        }
+        const columnNames = new Set();
+        for (const column of table.columns){
+            if (!column.name?.trim() || utf8ByteLength(column.name) > SPREADSHEET_KERNEL_MAX_IDENTIFIER_BYTES) return null;
+            const normalized = column.name.toLocaleLowerCase();
+            if (columnNames.has(normalized)) return null;
+            columnNames.add(normalized);
+        }
+        const next = {
+            name: table.name,
+            ...table.displayName ? {
+                displayName: table.displayName
+            } : {},
+            startRow,
+            endRow,
+            startColumn,
+            endColumn,
+            columns: table.columns.map((column)=>column.name),
+            headerRow: Boolean(table.headerRow),
+            totalsRow: Boolean(table.totalsRow)
+        };
+        if (ranges.some((previous)=>next.startRow <= previous.endRow && next.endRow >= previous.startRow && next.startColumn <= previous.endColumn && next.endColumn >= previous.startColumn)) return null;
+        ranges.push(next);
+    }
+    return ranges;
+}
 function spreadsheetSheetsWithKernelChanges(sheets, changes) {
     const changesBySheet = new Map();
     for (const change of changes.values()){
@@ -22243,7 +22431,7 @@ function spreadsheetCalculationOps(sheets, calculatedCells) {
     });
 }
 function sameSpreadsheetStructure(previous, current) {
-    return previous.length === current.length && previous.every((sheet, index)=>sheet.id === current[index]?.id && sheet.name === current[index]?.name);
+    return previous.length === current.length && previous.every((sheet, index)=>sheet.id === current[index]?.id && sheet.name === current[index]?.name && JSON.stringify(sheet.tables ?? []) === JSON.stringify(current[index]?.tables ?? []));
 }
 function cellWithCalculatedValue(cell, value) {
     const next = {
@@ -25395,6 +25583,60 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
     const editorFocusOrigin = useOfficeEditorFocusOrigin();
     const workbookRef = useRef(null);
     const projectedWorkbookSheetsRef = useRef([]);
+    useLayoutEffect(()=>{
+        const container = spreadsheetCanvasRef.current;
+        if (!container || preview) return;
+        let pendingEditor = null;
+        let pointerEnteredEditor = false;
+        const moveEditorCaretToEnd = (editor)=>{
+            if (document.activeElement !== editor || !editor.isConnected || !editor.textContent) return false;
+            const selection = document.getSelection();
+            if (!selection) return false;
+            const range = document.createRange();
+            range.selectNodeContents(editor);
+            range.collapse(false);
+            selection.removeAllRanges();
+            selection.addRange(range);
+            return true;
+        };
+        const handlePointerDown = (event)=>{
+            pointerEnteredEditor = event.target instanceof Element && Boolean(event.target.closest('.luckysheet-cell-input'));
+        };
+        const handleFocusIn = (event)=>{
+            const target = event.target;
+            const editor = target instanceof Element ? target.closest('.luckysheet-cell-input') : null;
+            if (!editor || pointerEnteredEditor) {
+                pendingEditor = null;
+                pointerEnteredEditor = false;
+                return;
+            }
+            pendingEditor = editor;
+            queueMicrotask(()=>{
+                if (pendingEditor === editor && moveEditorCaretToEnd(editor)) pendingEditor = null;
+            });
+        };
+        const observer = new MutationObserver(()=>{
+            const editor = pendingEditor;
+            if (!editor || document.activeElement !== editor) return;
+            if (!editor.textContent) return;
+            moveEditorCaretToEnd(editor);
+            pendingEditor = null;
+        });
+        container.addEventListener('pointerdown', handlePointerDown, true);
+        container.addEventListener('focusin', handleFocusIn, true);
+        observer.observe(container, {
+            characterData: true,
+            childList: true,
+            subtree: true
+        });
+        return ()=>{
+            container.removeEventListener('pointerdown', handlePointerDown, true);
+            container.removeEventListener('focusin', handleFocusIn, true);
+            observer.disconnect();
+        };
+    }, [
+        preview
+    ]);
     const spreadsheetZoomRef = useRef(100);
     const [workbookInstance, setWorkbookInstance] = useState(null);
     const bindWorkbookInstance = useCallback((instance)=>{
@@ -25413,6 +25655,10 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
     const [panel, setPanel] = useState(null);
     const panelTriggerRef = useRef(null);
     const [selectionState, setSelectionState] = useState(null);
+    const selectionStateRef = useRef({
+        current: null,
+        requested: null
+    });
     const formatPainterSelectionHandlerRef = useRef((_sheetId, _selection)=>void 0);
     const [contextMenu, setContextMenu] = useState(null);
     const [formatCellsDialog, setFormatCellsDialog] = useState(null);
@@ -25588,15 +25834,16 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
                 collaborationView?.activateSheet(id);
                 if (previewRef.current) setPreviewActiveSheetId(id);
                 else setNavigationActiveSheetId(id);
+                selectionStateRef.current.current = null;
+                releaseSpreadsheetSelectionRequest(selectionStateRef.current);
                 setSelectionState(null);
             },
             afterSelectionChange: (sheetId, selection)=>{
-                collaborationView?.select(sheetId, selection);
-                setSelectionState({
-                    sheetId,
-                    selection
-                });
-                formatPainterSelectionHandlerRef.current(sheetId, selection);
+                const next = acceptSpreadsheetSelectionChange(selectionStateRef.current, sheetId, selection);
+                if (!next) return;
+                collaborationView?.select(sheetId, next.selection);
+                setSelectionState(next);
+                formatPainterSelectionHandlerRef.current(sheetId, next.selection);
             },
             beforeUpdateCell: (row, column)=>{
                 const sheet = contentRef.current.sheets.find((candidate)=>candidate.id === activeSheetIdRef.current);
@@ -25876,6 +26123,8 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
         if (!sheet) return false;
         activeSheetIdRef.current = sheetId;
         if (collaborationView && !collaborationView.activateSheet(sheetId)) return false;
+        selectionStateRef.current.current = null;
+        releaseSpreadsheetSelectionRequest(selectionStateRef.current);
         setSelectionState(null);
         if (previewRef.current) setPreviewActiveSheetId(sheetId);
         try {
@@ -25910,7 +26159,7 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
                 targetRow: activeCell.row,
                 targetColumn: activeCell.column
             });
-            setSelectionState({
+            const nextSelection = {
                 sheetId,
                 selection: {
                     row: [
@@ -25922,7 +26171,21 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
                     row_focus: activeCell.row,
                     column_focus: activeCell.column
                 }
-            });
+            };
+            selectionStateRef.current.current = nextSelection;
+            selectionStateRef.current.requested = {
+                sheetId,
+                selection: {
+                    ...nextSelection.selection,
+                    row: [
+                        ...nextSelection.selection.row
+                    ],
+                    column: [
+                        ...nextSelection.selection.column
+                    ]
+                }
+            };
+            setSelectionState(nextSelection);
         } catch  {
             return false;
         }
@@ -26043,6 +26306,7 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
             toggle: (attribute)=>richTextSelectionRef.current?.toggle(contentRef.current, acceptSpreadsheetCommandChange, attribute) ?? false
         },
         selection: selectionState,
+        selectionRef: selectionStateRef.current,
         table: spreadsheetTable.commandPort,
         targetSheetGridSize,
         targetSheetId: toolbarSheetId,
@@ -26150,6 +26414,7 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
         if ('Escape' === event.key && isSpreadsheetCellEditingTarget(event.target)) requestAnimationFrame(()=>focusSpreadsheetGrid(spreadsheetCanvasRef.current));
     };
     const handleSpreadsheetKeyDownCapture = (event)=>{
+        releaseSpreadsheetSelectionRequest(selectionStateRef.current);
         if ('Alt' === event.key && !event.repeat && event.target instanceof Element && event.target.closest('.fortune-sheet-overlay') && reserveAutoFilterAltKey()) {
             event.preventDefault();
             event.stopPropagation();
@@ -26158,6 +26423,7 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
         handleSpreadsheetEditingEscape(event);
     };
     const handleSpreadsheetPointerDownCapture = (event)=>{
+        releaseSpreadsheetSelectionRequest(selectionStateRef.current);
         const controller = richTextSelectionRef.current;
         if (!controller) return;
         if (!isSpreadsheetRichTextFormatPointerTarget(event.target)) return void controller.clear();

package/dist/0~work-office-diagnostics.js

@@ -1950,7 +1950,7 @@ async function diagnoseXlsxFormulas(archive, importedFeatures, worksheetScans) {
     if (dataTables) issues.push(work_xlsx_formula_diagnostics_issue('xlsx.formulas.data-tables', `${dataTables} what-if data table(s), input references, and cached results are preserved, but Work does not recalculate scenario tables in the browser.`));
     if (cachedErrors) issues.push(work_xlsx_formula_diagnostics_issue('xlsx.formulas.cached-errors', `${cachedErrors} formula cell(s) contain cached Excel error values; the error type and displayed value are preserved in editing, preview, print, and export.`));
     if (externalReferences.length) issues.push(work_xlsx_formula_diagnostics_issue('xlsx.formulas.external-references', `${externalReferences.length} formula cell(s) reference external workbooks; formulas and cached values are preserved without refreshing external files.`));
-    if (structuredReferences.length) issues.push(work_xlsx_formula_diagnostics_issue('xlsx.formulas.structured-references', `${structuredReferences.length} formula cell(s) use structured table references; formulas round-trip unchanged, but the Work calculation engine does not resolve Excel table objects.`));
+    if (structuredReferences.length) issues.push(work_xlsx_formula_diagnostics_issue('xlsx.formulas.structured-references', `${structuredReferences.length} formula cell(s) use structured table references; the browser kernel resolves bounded table names, display names, contiguous column ranges, and common row selectors. Disjoint, external, and advanced forms keep their source formula and cached value for compatible recalculation.`, 'info'));
     if (unsupportedFunctions.size) issues.push(work_xlsx_formula_diagnostics_issue('xlsx.formulas.unsupported-functions', `The current browser calculation engine does not evaluate ${Array.from(unsupportedFunctions).sort().join(', ')}; source formulas and cached results are preserved for compatible desktop recalculation.`));
     if (volatileFormulas.length) issues.push(work_xlsx_formula_diagnostics_issue('xlsx.formulas.volatile', `${volatileFormulas.length} volatile formula cell(s) can change when the workbook is explicitly recalculated.`, 'info'));
     if (unsupportedFormulaAttributes.size) issues.push(work_xlsx_formula_diagnostics_issue('xlsx.formulas.attributes', `Advanced formula attributes are not represented by the editable model and normalize on export: ${Array.from(unsupportedFormulaAttributes).sort().join(', ')}.`));