@a3s-lab/office 0.22.0 → 0.24.0

package/README.md

@@ -123,9 +123,9 @@ baseline rather than one specific release.
 
 | Capability | A3S Office today | Traditional Office baseline |
 | --- | --- | --- |
-| Cells, sheets, navigation, and history | **Supported** — multiple sheets, sparse editing, search, clipboard, fill, and undo/redo | Mature grid workflows across desktop and web |
-| Formatting and style rendering | **Partial** — native fonts, colors, borders, alignment, number formats, cell styles, and static date/time entry | Broader themes, locale formats, rich text, and advanced style effects |
-| Ribbon and shortcuts | **Partial** — common Office-style Home/Data/View commands and grid-scoped shortcuts | Larger command catalog and platform-specific accelerators |
+| Cells, sheets, navigation, and history | **Supported** — multiple sheets, sparse editing, search, clipboard, four-direction fill, exact formula/value copy from above, and undo/redo | Mature grid workflows across desktop and web |
+| Formatting and style rendering | **Partial** — native fonts, colors, borders, alignment, number formats, cell styles, static date/time entry, and contrast-safe font preview | Broader themes, locale formats, rich text, and advanced style effects |
+| Ribbon and shortcuts | **Partial** — common Office-style Home/Data/View commands, grid-scoped shortcuts, and focused Font-dialog aliases | Larger command catalog and platform-specific accelerators |
 | Formulas and recalculation | **Partial** — dependency-aware calculation and common formula paths | Wider functions, arrays, volatile semantics, and calculation parity |
 | Tables, pivots, charts, and rules | **Partial** — native tables, pivots, charts, conditional formatting, and validation | Calculated columns, slicers, pivot charts, advanced rules, and analysis |
 | Large worksheets | **Supported with boundaries** — maximum-dimension sparse import/editing and viewport-bounded Canvas painting | Highly optimized native grid with hardware-dependent limits |
@@ -1347,6 +1347,8 @@ without hard-coded return URLs.
 
 - [Live Playground](https://a3s-lab.github.io/Office/)
 - [Documentation center](https://a3s-lab.github.io/Office/docs/)
+- [A3S Office 0.24.0 documentation](https://a3s-lab.github.io/Office/docs/0.24.0/)
+- [A3S Office 0.23.0 documentation](https://a3s-lab.github.io/Office/docs/0.23.0/)
 - [A3S Office 0.22.0 documentation](https://a3s-lab.github.io/Office/docs/0.22.0/)
 - [A3S Office 0.21.0 documentation](https://a3s-lab.github.io/Office/docs/0.21.0/)
 - [A3S Office 0.20.0 documentation](https://a3s-lab.github.io/Office/docs/0.20.0/)

package/dist/0~4595.js

@@ -343,7 +343,7 @@ function Dialog({ title, description, children, footer, onClose, closeDisabled =
     });
     return "u" > typeof document && portalRootRef.current ? /*#__PURE__*/ createPortal(dialog, portalRootRef.current) : dialog;
 }
-function OfficeSelect({ ariaLabel, value, options, onValueChange, disabled = false, placeholder = '请选择', className = '' }) {
+function OfficeSelect({ ariaLabel, value, options, onValueChange, disabled = false, placeholder = '请选择', className = '', ariaKeyShortcuts, initialFocus = false }) {
     const reactId = useId().replaceAll(':', '');
     const [open, setOpen] = useState(false);
     const selectedIndex = useMemo(()=>options.findIndex((option)=>option.value === value), [
@@ -384,6 +384,8 @@ function OfficeSelect({ ariaLabel, value, options, onValueChange, disabled = fal
                 ...triggerProps,
                 role: "combobox",
                 "aria-expanded": popoverOpen,
+                "aria-keyshortcuts": ariaKeyShortcuts,
+                "data-autofocus": initialFocus ? 'true' : void 0,
                 onClick: (event)=>{
                     if (!popoverOpen) {
                         const next = nearestEnabledOption(options, selectedIndex >= 0 ? selectedIndex : 0, 1);

package/dist/0~6090.js

@@ -258,6 +258,7 @@ function shortcutCodeKey(code) {
     if ('Equal' === code) return 'equal';
     if ('Minus' === code) return 'minus';
     if ('Semicolon' === code) return ';';
+    if ('Quote' === code) return "'";
     if ('Comma' === code) return ',';
     if ('Period' === code) return '.';
     return null;

package/dist/0~spreadsheet-editor.js

@@ -5,7 +5,7 @@ import { AArrowDown, AArrowUp, AlignCenter, AlignLeft, AlignRight, AlignVertical
 import { Fragment as external_react_Fragment, cloneElement, memo, useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { genarate, indexToColumnChar, update as core_update } from "@fortune-sheet/core";
 import { freezeImportedSpreadsheetCell, spreadsheetTextOrientationFromChoice, spreadsheetMatrixProfile, withoutEditableRange, spreadsheetTextOrientationFromAngle, isSpreadsheetTextOrientationId, normalizeSpreadsheetConditionalVisualOptions, spreadsheetCellValueWithDiagonalBorder, spreadsheetUnderlineCellValue, effectiveSpreadsheetPageSetup, attachSpreadsheetShownCommentCells, withEditableRange, sameSpreadsheetHistoryValue, createOfficeSpreadsheetCollaborationBinding as createWorkOfficeSpreadsheetCollaborationBinding, isSpreadsheetConditionalComparisonOperator, spreadsheetConditionalIconForValue, defaultSpreadsheetConditionalIconThresholds, spreadsheetUnderlineStyle, normalizeSpreadsheetDateValidationBoundary, sheetProtectionAuthority, editableRangeCellCount, unlockedCellCount, registerDerivedSpreadsheetMatrix, editableRangeRequiresCredentials, spreadsheetTextOrientationCellStyle, normalizeSpreadsheetConditionalIconSetFormat, defaultSpreadsheetDataBarOptions, spreadsheetConditionalThresholdValue, spreadsheetTextOrientationChoiceFromCell, normalizeSheetProtectionAuthority, withSheetProtection, defaultSpreadsheetColorScaleThresholds, spreadsheetProtectionKey, spreadsheetDiagonalBorderFromCellValue, SPREADSHEET_CONDITIONAL_ICON_SETS, protectedSheetCount, withSheetSelectionPermissions, SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS, spreadsheetConditionalComparisonNeedsUpperValue, drawSpreadsheetConditionalIcon, spreadsheetTextOrientationFromCell, replaceOfficeSpreadsheetCollaboration as replaceWorkOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration as readWorkOfficeSpreadsheetCollaboration, spreadsheetConditionalThresholdsEqual, isSpreadsheetUnderlineStyle, spreadsheetVisibleTextRotationFromCell } from "./5045.js";
-import { workSpreadsheetChartSupportsGrouping, 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 { 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 { moveOfficeMenuFocus, stepOfficeZoom, useOfficeRemoteParticipants, Popover, officePresenceColor, useOfficePublishPresenceLocation, button_Button, icon_button_IconButton, moveOfficeGridMenuFocus, office_text_field_OfficeTextField, useDialogFocusScope, useOfficeEditorWheelZoom } from "./0~6090.js";
 import { useOfficeTaskPaneEscape, OfficeCheckbox, CommittedOfficeNumberField, useOfficeDialog, useOfficeTaskPaneModal, createOfficeKernelClient, officeFontFamilies, CollectionState, OfficeNumberField, handleOfficeTaskPaneKeyDown } from "./0~7048.js";
 import { isOfficeShortcutBlocked, OfficeColorPicker } from "./0~3635.js";
@@ -3284,6 +3284,38 @@ const spreadsheetCommandCatalog = {
             ]
         }
     },
+    formatCellsFont: {
+        id: 'font.formatCellsFont',
+        label: '设置字体格式',
+        location: {
+            area: 'ribbon',
+            tab: 'home',
+            group: 'font'
+        },
+        shortcut: {
+            label: 'Cmd/Ctrl+Shift+F',
+            aria: 'Control+Shift+F Meta+Shift+F',
+            editor: [
+                'Mod-Shift-f'
+            ]
+        }
+    },
+    formatCellsFontSize: {
+        id: 'font.formatCellsFontSize',
+        label: '设置字号格式',
+        location: {
+            area: 'ribbon',
+            tab: 'home',
+            group: 'font'
+        },
+        shortcut: {
+            label: 'Cmd/Ctrl+Shift+P',
+            aria: 'Control+Shift+P Meta+Shift+P',
+            editor: [
+                'Mod-Shift-p'
+            ]
+        }
+    },
     borderTop: {
         id: 'font.borderTop',
         label: '上框线',
@@ -3752,6 +3784,38 @@ const spreadsheetCommandCatalog = {
             group: 'editing'
         }
     },
+    copyFormulaFromAbove: {
+        id: 'editing.copyFormulaFromAbove',
+        label: '复制上方公式',
+        location: {
+            area: 'ribbon',
+            tab: 'home',
+            group: 'editing'
+        },
+        shortcut: {
+            label: "Ctrl+'",
+            aria: "Control+'",
+            editor: [
+                "Control-'"
+            ]
+        }
+    },
+    copyValueFromAbove: {
+        id: 'editing.copyValueFromAbove',
+        label: '复制上方值',
+        location: {
+            area: 'ribbon',
+            tab: 'home',
+            group: 'editing'
+        },
+        shortcut: {
+            label: "Ctrl+Shift+'",
+            aria: "Control+Shift+'",
+            editor: [
+                "Control-Shift-'"
+            ]
+        }
+    },
     clearAll: {
         id: 'editing.clearAll',
         label: '清除全部',
@@ -4720,6 +4784,56 @@ function normalizeColor(value) {
 function spreadsheet_cell_format_cellKey(row, column) {
     return `${row}:${column}`;
 }
+const spreadsheetFormatCellsTabs = [
+    {
+        id: 'number',
+        label: '数字'
+    },
+    {
+        id: 'alignment',
+        label: '对齐'
+    },
+    {
+        id: 'font',
+        label: '字体'
+    },
+    {
+        id: 'border',
+        label: '边框'
+    },
+    {
+        id: 'fill',
+        label: '填充'
+    },
+    {
+        id: 'protection',
+        label: '保护'
+    }
+];
+const defaultSpreadsheetFormatCellsOpenIntent = {
+    tab: 'number'
+};
+const spreadsheetFormatCellsTabIds = new Set(spreadsheetFormatCellsTabs.map(({ id })=>id));
+function normalizeSpreadsheetFormatCellsOpenIntent(value) {
+    if (void 0 === value) return defaultSpreadsheetFormatCellsOpenIntent;
+    if (!spreadsheet_format_cells_intent_isRecord(value)) return null;
+    const keys = Object.keys(value);
+    if (keys.some((key)=>'tab' !== key && 'focus' !== key)) return null;
+    if ('string' != typeof value.tab || !spreadsheetFormatCellsTabIds.has(value.tab)) return null;
+    if ('font' !== value.tab) return void 0 === value.focus ? {
+        tab: value.tab
+    } : null;
+    if (void 0 === value.focus) return {
+        tab: 'font'
+    };
+    return 'fontFamily' === value.focus || 'fontSize' === value.focus ? {
+        tab: 'font',
+        focus: value.focus
+    } : null;
+}
+function spreadsheet_format_cells_intent_isRecord(value) {
+    return Boolean(value && 'object' == typeof value && !Array.isArray(value));
+}
 function createSpreadsheetCellFormatExtension() {
     return createOfficeEditorExtension({
         name: 'spreadsheetCellFormat',
@@ -4734,17 +4848,27 @@ function createSpreadsheetCellFormatExtension() {
                 }
             }),
         addKeyboardShortcuts: ()=>({
-                'Mod-1': ({ can, commands }, event)=>runSpreadsheetFormatCellsShortcut(event, can.openFormatCells, commands.openFormatCells)
+                [spreadsheetCommandCatalog.formatCells.shortcut.editor["0"]]: ({ can, commands }, event)=>runSpreadsheetFormatCellsShortcut(event, void 0, can.openFormatCells, commands.openFormatCells),
+                [spreadsheetCommandCatalog.formatCellsFont.shortcut.editor["0"]]: ({ can, commands }, event)=>runSpreadsheetFormatCellsShortcut(event, {
+                        tab: 'font',
+                        focus: 'fontFamily'
+                    }, can.openFormatCells, commands.openFormatCells),
+                [spreadsheetCommandCatalog.formatCellsFontSize.shortcut.editor["0"]]: ({ can, commands }, event)=>runSpreadsheetFormatCellsShortcut(event, {
+                        tab: 'font',
+                        focus: 'fontSize'
+                    }, can.openFormatCells, commands.openFormatCells)
             })
     });
 }
-function canOpenSpreadsheetFormatCells(context) {
+function canOpenSpreadsheetFormatCells(context, intent) {
+    if (!normalizeSpreadsheetFormatCellsOpenIntent(intent)) return false;
     if (!context.editable || !context.formatCells.canOpen || !context.workbook || !context.targetSheetId || context.targetSheetId !== context.activeSheetId) return false;
     const range = liveSpreadsheetFormatCellsRange(context);
     return Boolean(range && spreadsheet_cell_range_spreadsheetCellRangeArea(range) <= 10000);
 }
-function spreadsheet_cell_format_command_openSpreadsheetFormatCells(context) {
-    if (!canOpenSpreadsheetFormatCells(context) || !context.workbook) return false;
+function spreadsheet_cell_format_command_openSpreadsheetFormatCells(context, intent) {
+    const normalizedIntent = normalizeSpreadsheetFormatCellsOpenIntent(intent);
+    if (!normalizedIntent || !canOpenSpreadsheetFormatCells(context, normalizedIntent) || !context.workbook) return false;
     const selection = context.workbook.getSelection()?.at(-1) ?? context.fallbackRange;
     const range = spreadsheet_cell_range_normalizeSpreadsheetCellRange(spreadsheetSingleRange(selection));
     if (!range) return false;
@@ -4755,7 +4879,8 @@ function spreadsheet_cell_format_command_openSpreadsheetFormatCells(context) {
             row: clampFocus(selection.row_focus, range.row),
             column: clampFocus(selection.column_focus, range.column)
         },
-        cells: []
+        cells: [],
+        intent: normalizedIntent
     };
     try {
         request.cells = context.workbook.getCellsByRange(range, {
@@ -4776,9 +4901,9 @@ function applySpreadsheetFormatCells(context, request) {
 function liveSpreadsheetFormatCellsRange(context) {
     return spreadsheet_cell_range_normalizeSpreadsheetCellRange(spreadsheetSingleRange(context.workbook?.getSelection()?.at(-1) ?? context.fallbackRange));
 }
-function runSpreadsheetFormatCellsShortcut(event, canExecute, execute) {
-    if (event.repeat || isOfficeShortcutBlocked(event.target) || isSpreadsheetNativeTextUndoTarget(event.target) || !canExecute()) return false;
-    return execute();
+function runSpreadsheetFormatCellsShortcut(event, intent, canExecute, execute) {
+    if (event.repeat || event.isComposing || isOfficeShortcutBlocked(event.target) || isSpreadsheetNativeTextUndoTarget(event.target) || !canExecute(intent)) return false;
+    return execute(intent);
 }
 function clampFocus(value, range) {
     const minimum = range[0] ?? 0;
@@ -5223,6 +5348,213 @@ function spreadsheetSelectedCellFillPlan(context, direction) {
     const sheet = context.content.sheets.find((candidate)=>candidate.id === context.targetSheetId);
     return canApplySpreadsheetCellFill(sheet, plan) ? plan : null;
 }
+const MAX_SPREADSHEET_ROWS = 1048576;
+const spreadsheetPasteContentOptions = [
+    {
+        value: 'all',
+        label: '全部',
+        richOnly: false
+    },
+    {
+        value: 'formulas',
+        label: '公式',
+        richOnly: false
+    },
+    {
+        value: 'values',
+        label: '值',
+        richOnly: false
+    },
+    {
+        value: 'formats',
+        label: '格式',
+        richOnly: true
+    },
+    {
+        value: 'comments',
+        label: '批注',
+        richOnly: true
+    },
+    {
+        value: 'validation',
+        label: '数据验证',
+        richOnly: true
+    },
+    {
+        value: 'all-except-borders',
+        label: '边框除外的全部',
+        richOnly: true
+    },
+    {
+        value: 'formulas-and-number-formats',
+        label: '公式和数字格式',
+        richOnly: true
+    },
+    {
+        value: 'values-and-number-formats',
+        label: '值和数字格式',
+        richOnly: true
+    },
+    {
+        value: 'column-widths',
+        label: '列宽',
+        richOnly: true
+    }
+];
+const spreadsheetPasteOperationOptions = [
+    {
+        value: 'none',
+        label: '无'
+    },
+    {
+        value: 'add',
+        label: '加'
+    },
+    {
+        value: 'subtract',
+        label: '减'
+    },
+    {
+        value: 'multiply',
+        label: '乘'
+    },
+    {
+        value: 'divide',
+        label: '除'
+    }
+];
+function planSpreadsheetCopyFromAbove(sheet, target, kind) {
+    if (!sheet || !isSpreadsheetCopyFromAboveKind(kind) || !spreadsheetCellCoordinateIsSupported(target.row, target.column) || 0 === target.row) return null;
+    const targetRange = {
+        row: [
+            target.row,
+            target.row
+        ],
+        column: [
+            target.column,
+            target.column
+        ]
+    };
+    if (!canMutateSpreadsheetCellRange(sheet, targetRange)) return null;
+    const source = {
+        row: target.row - 1,
+        column: target.column
+    };
+    const sourceCell = spreadsheetCopyFromAboveCellAt(sheet, source.row, source.column);
+    const targetCell = spreadsheetCopyFromAboveCellAt(sheet, target.row, target.column);
+    const formula = spreadsheetCopyableFormula(sheet, sourceCell, source.row, source.column);
+    if ('formula' === kind && sourceCell?.f && null === formula) return null;
+    const copiesFormula = 'formula' === kind && null !== formula;
+    const value = copiesFormula ? formula : spreadsheetCopyFromAboveCellValue(sourceCell);
+    if (copiesFormula ? targetCell?.f === value : !targetCell?.f && Object.is(spreadsheetCopyFromAboveCellValue(targetCell), value)) return null;
+    return {
+        formulaBarValue: value ?? '',
+        kind,
+        source,
+        targetRange,
+        value
+    };
+}
+function spreadsheetCopyableFormula(sheet, cell, row, column) {
+    if ('string' != typeof cell?.f || !cell.f.trim()) return null;
+    const formula = cell.f.trim();
+    if (!formula.startsWith('=') || formulaHasExternalReference(formula) || void 0 !== cell.spl || spreadsheetFormulaRangesForSelection(sheet, {
+        startRow: row,
+        endRow: row,
+        startColumn: column,
+        endColumn: column
+    }).length > 0) return null;
+    return formula;
+}
+function spreadsheetCopyFromAboveCellValue(cell) {
+    if (cell?.v !== void 0 && null !== cell.v) return cell.v;
+    const inlineText = spreadsheet_copy_from_above_spreadsheetInlineCellText(cell);
+    if (null !== inlineText) return inlineText;
+    if (cell?.m !== void 0 && null !== cell.m) return cell.m;
+    return null;
+}
+function spreadsheet_copy_from_above_spreadsheetInlineCellText(cell) {
+    const format = cell?.ct;
+    if (format?.t !== 'inlineStr' || !Array.isArray(format.s)) return null;
+    return format.s.map((run)=>spreadsheet_copy_from_above_isRecord(run) && ('string' == typeof run.v || 'number' == typeof run.v) ? String(run.v) : '').join('');
+}
+function spreadsheetCopyFromAboveCellAt(sheet, row, column) {
+    if (void 0 !== sheet.data) return sheet.data[row]?.[column];
+    return sheet.celldata?.find((entry)=>entry.r === row && entry.c === column)?.v;
+}
+function spreadsheetCellCoordinateIsSupported(row, column) {
+    return Number.isSafeInteger(row) && row >= 0 && row < MAX_SPREADSHEET_ROWS && Number.isSafeInteger(column) && column >= 0 && column < 16384;
+}
+function isSpreadsheetCopyFromAboveKind(value) {
+    return 'formula' === value || 'value' === value;
+}
+function spreadsheet_copy_from_above_isRecord(value) {
+    return Boolean(value && 'object' == typeof value && !Array.isArray(value));
+}
+function createSpreadsheetCopyFromAboveExtension() {
+    return createOfficeEditorExtension({
+        name: 'spreadsheetCopyFromAbove',
+        addCommands: ()=>({
+                copyCellFromAbove: {
+                    canExecute: (context, kind)=>null !== spreadsheetSelectedCopyFromAbovePlan(context, kind),
+                    execute: copySpreadsheetCellFromAbove
+                }
+            }),
+        addKeyboardShortcuts: ()=>({
+                [spreadsheetCommandCatalog.copyFormulaFromAbove.shortcut.editor["0"]]: ({ can, commands }, event)=>runSpreadsheetCopyFromAboveShortcut(event, 'formula', can.copyCellFromAbove, commands.copyCellFromAbove),
+                [spreadsheetCommandCatalog.copyValueFromAbove.shortcut.editor["0"]]: ({ can, commands }, event)=>runSpreadsheetCopyFromAboveShortcut(event, 'value', can.copyCellFromAbove, commands.copyCellFromAbove)
+            })
+    });
+}
+function copySpreadsheetCellFromAbove(context, kind) {
+    const plan = spreadsheetSelectedCopyFromAbovePlan(context, kind);
+    if (!plan || !context.workbook || !context.targetSheetId) return false;
+    try {
+        context.workbook.batchCallApis([
+            {
+                name: 'setCellValuesByRange',
+                args: [
+                    [
+                        [
+                            plan.value
+                        ]
+                    ],
+                    plan.targetRange,
+                    {
+                        id: context.targetSheetId
+                    }
+                ]
+            }
+        ]);
+    } catch  {
+        return false;
+    }
+    try {
+        context.formulaBar?.setValue(plan.formulaBarValue);
+    } catch  {}
+    return true;
+}
+function spreadsheetSelectedCopyFromAbovePlan(context, kind) {
+    const workbook = context.workbook;
+    const sheetId = context.targetSheetId;
+    if (!context.editable || !workbook || !sheetId || sheetId !== context.activeSheetId) return null;
+    try {
+        const selection = finiteSpreadsheetSelection(workbook.getSelection()?.at(-1) ?? context.fallbackRange);
+        const row = selection.row_focus ?? selection.row[0] ?? 0;
+        const column = selection.column_focus ?? selection.column[0] ?? 0;
+        const sheet = context.content.sheets.find((candidate)=>candidate.id === sheetId);
+        return planSpreadsheetCopyFromAbove(sheet, {
+            row,
+            column
+        }, kind);
+    } catch  {
+        return null;
+    }
+}
+function runSpreadsheetCopyFromAboveShortcut(event, kind, canExecute, execute) {
+    if (event.repeat || event.isComposing || isOfficeShortcutBlocked(event.target) || isSpreadsheetNativeTextUndoTarget(event.target) || !isSpreadsheetGridKeyboardTarget(event.target) || !canExecute(kind)) return false;
+    return execute(kind);
+}
 function canEditSpreadsheetSelection(context) {
     return Boolean(context.editable && context.workbook && context.targetSheetId);
 }
@@ -6068,81 +6400,6 @@ function clampSpreadsheetDataValidationFocus(value, range) {
     const focus = 'number' == typeof value && Number.isFinite(value) ? Math.trunc(value) : minimum;
     return Math.min(maximum, Math.max(minimum, focus));
 }
-const MAX_SPREADSHEET_ROWS = 1048576;
-const spreadsheetPasteContentOptions = [
-    {
-        value: 'all',
-        label: '全部',
-        richOnly: false
-    },
-    {
-        value: 'formulas',
-        label: '公式',
-        richOnly: false
-    },
-    {
-        value: 'values',
-        label: '值',
-        richOnly: false
-    },
-    {
-        value: 'formats',
-        label: '格式',
-        richOnly: true
-    },
-    {
-        value: 'comments',
-        label: '批注',
-        richOnly: true
-    },
-    {
-        value: 'validation',
-        label: '数据验证',
-        richOnly: true
-    },
-    {
-        value: 'all-except-borders',
-        label: '边框除外的全部',
-        richOnly: true
-    },
-    {
-        value: 'formulas-and-number-formats',
-        label: '公式和数字格式',
-        richOnly: true
-    },
-    {
-        value: 'values-and-number-formats',
-        label: '值和数字格式',
-        richOnly: true
-    },
-    {
-        value: 'column-widths',
-        label: '列宽',
-        richOnly: true
-    }
-];
-const spreadsheetPasteOperationOptions = [
-    {
-        value: 'none',
-        label: '无'
-    },
-    {
-        value: 'add',
-        label: '加'
-    },
-    {
-        value: 'subtract',
-        label: '减'
-    },
-    {
-        value: 'multiply',
-        label: '乘'
-    },
-    {
-        value: 'divide',
-        label: '除'
-    }
-];
 const MILLISECONDS_PER_DAY = 86400000;
 const MINUTES_PER_DAY = 1440;
 const EXCEL_1900_EPOCH_UTC = Date.UTC(1899, 11, 30);
@@ -8608,6 +8865,7 @@ function createSpreadsheetEditorExtensions() {
         createSpreadsheetTableExtension(),
         createSpreadsheetAutoSumExtension(),
         createSpreadsheetCellFillExtension(),
+        createSpreadsheetCopyFromAboveExtension(),
         createSpreadsheetVisibilityShortcutExtension(),
         createOfficeEditorExtension({
             name: 'spreadsheetFormatPainter',
@@ -13438,7 +13696,7 @@ function AlignmentPanel({ source, draft, errors, touched, setDraft, touch }) {
         ]
     });
 }
-function FontPanel({ source, draft, errors, touched, setDraft, touch }) {
+function FontPanel({ source, draft, errors, touched, initialFocus, setDraft, touch }) {
     const familyMixed = source.fields.fontFamily.mixed && !touched.fontFamily;
     const sizeMixed = source.fields.fontSize.mixed && !touched.fontSize;
     const underlineMixed = source.fields.underline.mixed && !touched.underline;
@@ -13456,6 +13714,8 @@ function FontPanel({ source, draft, errors, touched, setDraft, touch }) {
                 label: "字体",
                 children: /*#__PURE__*/ jsx(OfficeSelect, {
                     ariaLabel: "单元格字体",
+                    ariaKeyShortcuts: spreadsheetCommandCatalog.formatCellsFont.shortcut.aria,
+                    initialFocus: 'fontFamily' === initialFocus,
                     value: familyMixed ? MIXED_VALUE : draft.fontFamily,
                     options: withMixedOption(spreadsheetFontFamilyOptions(draft.fontFamily), familyMixed),
                     onValueChange: (value)=>{
@@ -13472,6 +13732,8 @@ function FontPanel({ source, draft, errors, touched, setDraft, touch }) {
                 label: "字号",
                 children: /*#__PURE__*/ jsx(OfficeSelect, {
                     ariaLabel: "单元格字号",
+                    ariaKeyShortcuts: spreadsheetCommandCatalog.formatCellsFontSize.shortcut.aria,
+                    initialFocus: 'fontSize' === initialFocus,
                     value: sizeMixed ? MIXED_VALUE : String(draft.fontSize),
                     options: withMixedOption(spreadsheetFontSizeOptions(draft.fontSize), sizeMixed),
                     onValueChange: (value)=>{
@@ -13549,6 +13811,7 @@ function FontPanel({ source, draft, errors, touched, setDraft, touch }) {
             /*#__PURE__*/ jsx("div", {
                 className: "work-spreadsheet-format-cells-font-preview",
                 style: {
+                    backgroundColor: spreadsheetFontPreviewBackground(draft.fontColor),
                     color: draft.fontColor,
                     fontFamily: draft.fontFamily,
                     fontSize: `${Math.max(10, draft.fontSize)}px`,
@@ -13566,6 +13829,21 @@ function FontPanel({ source, draft, errors, touched, setDraft, touch }) {
         ]
     });
 }
+function spreadsheetFontPreviewBackground(color) {
+    const match = /^#([0-9a-f]{6})$/i.exec(color.trim());
+    if (!match?.[1]) return '#f4f6f8';
+    const channels = [
+        0,
+        2,
+        4
+    ].map((offset)=>Number.parseInt(match[1].slice(offset, offset + 2), 16));
+    const [red = 0, green = 0, blue = 0] = channels.map((channel)=>{
+        const component = channel / 255;
+        return component <= 0.04045 ? component / 12.92 : ((component + 0.055) / 1.055) ** 2.4;
+    });
+    const luminance = 0.2126 * red + 0.7152 * green + 0.0722 * blue;
+    return luminance >= 0.55 ? '#172033' : '#f4f6f8';
+}
 function BorderPanel({ source, draft, touched, setDraft, touch }) {
     const hasTarget = (target)=>draft.borders.some((format)=>format.target === target);
     const updateBorders = (borders)=>{
@@ -13818,32 +14096,6 @@ function borderCss(format) {
     const style = 'dotted' === format.style ? 'dotted' : format.style.includes('dash') ? 'dashed' : 'solid';
     return `${width}px ${style} ${format.color}`;
 }
-const spreadsheetFormatCellsTabs = [
-    {
-        id: 'number',
-        label: '数字'
-    },
-    {
-        id: 'alignment',
-        label: '对齐'
-    },
-    {
-        id: 'font',
-        label: '字体'
-    },
-    {
-        id: 'border',
-        label: '边框'
-    },
-    {
-        id: 'fill',
-        label: '填充'
-    },
-    {
-        id: 'protection',
-        label: '保护'
-    }
-];
 function createSpreadsheetFormatCellsDialogSource(content, sheetId, rangeInput, cells, requestedActiveCell) {
     const range = spreadsheet_cell_range_normalizeSpreadsheetCellRange(rangeInput);
     const sheet = content.sheets.find((candidate)=>candidate.id === sheetId);
@@ -14015,10 +14267,10 @@ function sameDialogValue(left, right) {
 function clampIndex(value, minimum, maximum) {
     return Math.min(maximum, Math.max(minimum, Math.trunc(value)));
 }
-function SpreadsheetFormatCellsDialog({ source, restoreFocusTarget, onApply, onClose }) {
+function SpreadsheetFormatCellsDialog({ source, restoreFocusTarget, openIntent = defaultSpreadsheetFormatCellsOpenIntent, onApply, onClose }) {
     const [draft, setDraft] = useState(()=>createSpreadsheetFormatCellsDraft(source));
     const [touched, setTouched] = useState({});
-    const [activeTab, setActiveTab] = useState('number');
+    const [activeTab, setActiveTab] = useState(openIntent.tab);
     const formId = useId();
     const idBase = `spreadsheet-format-cells-${useId().replaceAll(':', '')}`;
     const errors = spreadsheetFormatCellsDraftErrors(draft);
@@ -14079,6 +14331,7 @@ function SpreadsheetFormatCellsDialog({ source, restoreFocusTarget, onApply, onC
                     draft: draft,
                     errors: errors,
                     touched: touched,
+                    initialFocus: 'font' === openIntent.tab ? openIntent.focus : void 0,
                     setDraft: setDraft,
                     touch: (field)=>setTouched((current)=>({
                                 ...current,
@@ -23061,7 +23314,7 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
     const [selectionState, setSelectionState] = useState(null);
     const formatPainterSelectionHandlerRef = useRef((_sheetId, _selection)=>void 0);
     const [contextMenu, setContextMenu] = useState(null);
-    const [formatCellsSource, setFormatCellsSource] = useState(null);
+    const [formatCellsDialog, setFormatCellsDialog] = useState(null);
     const formatCellsInvokerRef = useRef(null);
     const formatCellsSelectionRef = useRef(null);
     const formatCellsApplyingRef = useRef(false);
@@ -23211,7 +23464,7 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
         panelTriggerRef.current = null;
         setPanel(null);
         setContextMenu(null);
-        setFormatCellsSource(null);
+        setFormatCellsDialog(null);
         formatCellsInvokerRef.current = null;
         formatCellsSelectionRef.current = null;
         formatCellsApplyingRef.current = false;
@@ -23491,14 +23744,17 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
                 column_focus: request.activeCell.column
             }
         };
-        setFormatCellsSource(source);
+        setFormatCellsDialog({
+            source,
+            intent: request.intent
+        });
         return true;
     }, []);
     const closeSpreadsheetFormatCells = useCallback(()=>{
         const invoker = formatCellsInvokerRef.current;
         const canvas = spreadsheetCanvasRef.current;
         const openedFromGrid = Boolean(invoker && canvas?.contains(invoker));
-        setFormatCellsSource(null);
+        setFormatCellsDialog(null);
         requestAnimationFrame(()=>{
             if (openedFromGrid || !invoker?.isConnected) focusSpreadsheetGrid(canvas, {
                 focusOrigin: invoker
@@ -23639,7 +23895,7 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
         },
         formatPainter,
         formatCells: {
-            canOpen: !preview && null === formatCellsSource,
+            canOpen: !preview && null === formatCellsDialog,
             open: openSpreadsheetFormatCells
         },
         hyperlink: spreadsheetHyperlink.commandPort,
@@ -24082,16 +24338,17 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
                 onClose: ()=>setContextMenu(null),
                 onRestoreFocus: ()=>focusSpreadsheetGrid(spreadsheetCanvasRef.current)
             }),
-            formatCellsSource && /*#__PURE__*/ jsx(SpreadsheetFormatCellsDialog, {
-                source: formatCellsSource,
+            formatCellsDialog && /*#__PURE__*/ jsx(SpreadsheetFormatCellsDialog, {
+                source: formatCellsDialog.source,
+                openIntent: formatCellsDialog.intent,
                 restoreFocusTarget: ()=>formatCellsInvokerRef.current?.isConnected ? formatCellsInvokerRef.current : spreadsheetGridFocusTarget(spreadsheetCanvasRef.current),
                 onApply: (patch)=>{
                     formatCellsApplyingRef.current = true;
                     let handled = false;
                     try {
                         handled = spreadsheetCommands.applyCellFormat({
-                            sheetId: formatCellsSource.sheetId,
-                            range: formatCellsSource.range,
+                            sheetId: formatCellsDialog.source.sheetId,
+                            range: formatCellsDialog.source.range,
                             patch
                         });
                     } finally{
@@ -24217,6 +24474,7 @@ function spreadsheetCommandsWithGridFocus(commands, restoreFocus) {
         activateFormatPainter: afterSuccessfulCommand(commands.activateFormatPainter),
         cancelFormatPainter: afterSuccessfulCommand(commands.cancelFormatPainter),
         clearSelectedCells: afterSuccessfulCommand(commands.clearSelectedCells),
+        copyCellFromAbove: afterSuccessfulCommand(commands.copyCellFromAbove),
         copySelection: afterSuccessfulCommand(commands.copySelection),
         convertTableToRange: afterSuccessfulCommand(commands.convertTableToRange),
         cutSelection: afterSuccessfulCommand(commands.cutSelection),

package/dist/internal/features/work/editors/office-select.d.ts

@@ -8,7 +8,7 @@ export interface OfficeSelectOption<T extends string = string> {
     previewStyle?: CSSProperties;
     searchText?: string;
 }
-export declare function OfficeSelect<T extends string>({ ariaLabel, value, options, onValueChange, disabled, placeholder, className, }: {
+export declare function OfficeSelect<T extends string>({ ariaLabel, value, options, onValueChange, disabled, placeholder, className, ariaKeyShortcuts, initialFocus, }: {
     ariaLabel: string;
     value: T;
     options: readonly OfficeSelectOption<T>[];
@@ -16,4 +16,6 @@ export declare function OfficeSelect<T extends string>({ ariaLabel, value, optio
     disabled?: boolean;
     placeholder?: string;
     className?: string;
+    ariaKeyShortcuts?: string;
+    initialFocus?: boolean;
 }): import("react").JSX.Element;

package/dist/internal/features/work/editors/spreadsheet-command-catalog.d.ts

@@ -406,6 +406,34 @@ export declare const spreadsheetCommandCatalog: {
             readonly editor: readonly ["Mod-1"];
         };
     };
+    readonly formatCellsFont: {
+        readonly id: "font.formatCellsFont";
+        readonly label: "设置字体格式";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "font";
+        };
+        readonly shortcut: {
+            readonly label: "Cmd/Ctrl+Shift+F";
+            readonly aria: "Control+Shift+F Meta+Shift+F";
+            readonly editor: readonly ["Mod-Shift-f"];
+        };
+    };
+    readonly formatCellsFontSize: {
+        readonly id: "font.formatCellsFontSize";
+        readonly label: "设置字号格式";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "font";
+        };
+        readonly shortcut: {
+            readonly label: "Cmd/Ctrl+Shift+P";
+            readonly aria: "Control+Shift+P Meta+Shift+P";
+            readonly editor: readonly ["Mod-Shift-p"];
+        };
+    };
     readonly borderTop: {
         readonly id: "font.borderTop";
         readonly label: "上框线";
@@ -852,6 +880,34 @@ export declare const spreadsheetCommandCatalog: {
             readonly group: "editing";
         };
     };
+    readonly copyFormulaFromAbove: {
+        readonly id: "editing.copyFormulaFromAbove";
+        readonly label: "复制上方公式";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "editing";
+        };
+        readonly shortcut: {
+            readonly label: "Ctrl+'";
+            readonly aria: "Control+'";
+            readonly editor: readonly ["Control-'"];
+        };
+    };
+    readonly copyValueFromAbove: {
+        readonly id: "editing.copyValueFromAbove";
+        readonly label: "复制上方值";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "editing";
+        };
+        readonly shortcut: {
+            readonly label: "Ctrl+Shift+'";
+            readonly aria: "Control+Shift+'";
+            readonly editor: readonly ["Control-Shift-'"];
+        };
+    };
     readonly clearAll: {
         readonly id: "editing.clearAll";
         readonly label: "清除全部";

package/dist/internal/features/work/editors/spreadsheet-command-controller.d.ts

@@ -7,9 +7,11 @@ import type { SpreadsheetAutoSumFunction } from './spreadsheet-auto-sum';
 import { type SpreadsheetCellClearMode } from './spreadsheet-cell-clear';
 import type { SpreadsheetCellBorderFormat } from './spreadsheet-cell-border';
 import type { SpreadsheetCellFormatRequest } from './spreadsheet-cell-format';
+import type { SpreadsheetFormatCellsOpenIntent } from './spreadsheet-format-cells-intent';
 import type { SpreadsheetCellRange } from './spreadsheet-cell-range';
 import type { SpreadsheetCellStyleChoice } from './spreadsheet-cell-style';
 import type { SpreadsheetCellFillDirection } from './spreadsheet-cell-fill';
+import type { SpreadsheetCopyFromAboveKind } from './spreadsheet-copy-from-above';
 import { type SpreadsheetFontSizeDirection } from './spreadsheet-font-size-command';
 import { type SpreadsheetDateTimeKind } from './spreadsheet-date-time-command';
 import type { SpreadsheetDataValidationRequest, SpreadsheetDataValidationTarget } from './spreadsheet-data-validation';
@@ -118,6 +120,7 @@ export interface SpreadsheetFormatCellsOpenRequest {
         column: number;
     };
     cells: (Cell | null)[][];
+    intent: SpreadsheetFormatCellsOpenIntent;
 }
 export interface SpreadsheetFormatCellsCommandPort {
     canOpen: boolean;
@@ -162,6 +165,7 @@ export interface SpreadsheetEditorCommands {
     applyTable: (request: SpreadsheetTableRequest) => boolean;
     cancelFormatPainter: () => boolean;
     clearSelectedCells: (mode?: SpreadsheetCellClearMode) => boolean;
+    copyCellFromAbove: (kind: SpreadsheetCopyFromAboveKind) => boolean;
     copySelection: () => boolean;
     cutSelection: () => boolean;
     deleteSelectedStructure: (axis: SpreadsheetStructureAxis) => boolean;
@@ -177,7 +181,7 @@ export interface SpreadsheetEditorCommands {
     openAutoFilterMenu: () => boolean;
     openDataValidation: () => boolean;
     openFind: () => boolean;
-    openFormatCells: () => boolean;
+    openFormatCells: (intent?: SpreadsheetFormatCellsOpenIntent) => boolean;
     openGoTo: () => boolean;
     openHyperlink: () => boolean;
     openPasteSpecial: () => boolean;

package/dist/internal/features/work/editors/spreadsheet-copy-from-above-command.d.ts

@@ -0,0 +1,3 @@
+import { type OfficeEditorExtension } from './office-editor-extension';
+import type { SpreadsheetCommandContext, SpreadsheetEditorCommands } from './spreadsheet-command-controller';
+export declare function createSpreadsheetCopyFromAboveExtension(): OfficeEditorExtension<SpreadsheetCommandContext, SpreadsheetEditorCommands>;

package/dist/internal/features/work/editors/spreadsheet-copy-from-above.d.ts

@@ -0,0 +1,18 @@
+import type { WorkSpreadsheetSheet } from '../work-types';
+import type { SpreadsheetCellRange } from './spreadsheet-cell-range';
+export type SpreadsheetCopyFromAboveKind = 'formula' | 'value';
+export type SpreadsheetCopyFromAboveValue = boolean | number | string | null;
+export interface SpreadsheetCopyFromAbovePlan {
+    formulaBarValue: SpreadsheetCopyFromAboveValue | '';
+    kind: SpreadsheetCopyFromAboveKind;
+    source: {
+        row: number;
+        column: number;
+    };
+    targetRange: SpreadsheetCellRange;
+    value: SpreadsheetCopyFromAboveValue;
+}
+export declare function planSpreadsheetCopyFromAbove(sheet: WorkSpreadsheetSheet | undefined, target: {
+    row: number;
+    column: number;
+}, kind: SpreadsheetCopyFromAboveKind): SpreadsheetCopyFromAbovePlan | null;

package/dist/internal/features/work/editors/spreadsheet-format-cells-dialog-model.d.ts

@@ -4,26 +4,7 @@ import { type SpreadsheetUnderlineStyle } from '../work-spreadsheet-underline';
 import { type SpreadsheetCellBorderFormat, type SpreadsheetCellBorderStyle } from './spreadsheet-cell-border';
 import { type SpreadsheetCellFormatPatch, type SpreadsheetHorizontalAlignment, type SpreadsheetVerticalAlignment } from './spreadsheet-cell-format';
 import { type SpreadsheetCellRange } from './spreadsheet-cell-range';
-export declare const spreadsheetFormatCellsTabs: readonly [{
-    readonly id: "number";
-    readonly label: "数字";
-}, {
-    readonly id: "alignment";
-    readonly label: "对齐";
-}, {
-    readonly id: "font";
-    readonly label: "字体";
-}, {
-    readonly id: "border";
-    readonly label: "边框";
-}, {
-    readonly id: "fill";
-    readonly label: "填充";
-}, {
-    readonly id: "protection";
-    readonly label: "保护";
-}];
-export type SpreadsheetFormatCellsTabId = (typeof spreadsheetFormatCellsTabs)[number]['id'];
+export { spreadsheetFormatCellsTabs, type SpreadsheetFormatCellsTabId, } from './spreadsheet-format-cells-intent';
 export interface SpreadsheetFormatCellsField<T> {
     value: T;
     mixed: boolean;

package/dist/internal/features/work/editors/spreadsheet-format-cells-dialog-panels.d.ts

@@ -1,6 +1,7 @@
 import type { Dispatch, SetStateAction } from 'react';
 import type { SpreadsheetCellFormatPatch } from './spreadsheet-cell-format';
 import type { SpreadsheetFormatCellsDialogSource, SpreadsheetFormatCellsDraft, SpreadsheetFormatCellsDraftErrors, SpreadsheetFormatCellsTabId, SpreadsheetFormatCellsTouched } from './spreadsheet-format-cells-dialog-model';
+import type { SpreadsheetFormatCellsInitialFocus } from './spreadsheet-format-cells-intent';
 interface PanelProps {
     activeTab: SpreadsheetFormatCellsTabId;
     idBase: string;
@@ -8,6 +9,7 @@ interface PanelProps {
     draft: SpreadsheetFormatCellsDraft;
     errors: SpreadsheetFormatCellsDraftErrors;
     touched: SpreadsheetFormatCellsTouched;
+    initialFocus?: SpreadsheetFormatCellsInitialFocus;
     setDraft: Dispatch<SetStateAction<SpreadsheetFormatCellsDraft>>;
     touch: (field: keyof SpreadsheetCellFormatPatch) => void;
 }

package/dist/internal/features/work/editors/spreadsheet-format-cells-dialog.d.ts

@@ -1,8 +1,10 @@
 import type { SpreadsheetCellFormatPatch } from './spreadsheet-cell-format';
 import { type SpreadsheetFormatCellsDialogSource } from './spreadsheet-format-cells-dialog-model';
-export declare function SpreadsheetFormatCellsDialog({ source, restoreFocusTarget, onApply, onClose, }: {
+import { type SpreadsheetFormatCellsOpenIntent } from './spreadsheet-format-cells-intent';
+export declare function SpreadsheetFormatCellsDialog({ source, restoreFocusTarget, openIntent, onApply, onClose, }: {
     source: SpreadsheetFormatCellsDialogSource;
     restoreFocusTarget: () => HTMLElement | null;
+    openIntent?: SpreadsheetFormatCellsOpenIntent;
     onApply: (patch: SpreadsheetCellFormatPatch) => boolean;
     onClose: () => void;
 }): import("react").JSX.Element;

package/dist/internal/features/work/editors/spreadsheet-format-cells-intent.d.ts

@@ -0,0 +1,32 @@
+export declare const spreadsheetFormatCellsTabs: readonly [{
+    readonly id: "number";
+    readonly label: "数字";
+}, {
+    readonly id: "alignment";
+    readonly label: "对齐";
+}, {
+    readonly id: "font";
+    readonly label: "字体";
+}, {
+    readonly id: "border";
+    readonly label: "边框";
+}, {
+    readonly id: "fill";
+    readonly label: "填充";
+}, {
+    readonly id: "protection";
+    readonly label: "保护";
+}];
+export type SpreadsheetFormatCellsTabId = (typeof spreadsheetFormatCellsTabs)[number]['id'];
+export type SpreadsheetFormatCellsInitialFocus = 'fontFamily' | 'fontSize';
+export type SpreadsheetFormatCellsOpenIntent = {
+    tab: 'font';
+    focus?: SpreadsheetFormatCellsInitialFocus;
+} | {
+    tab: Exclude<SpreadsheetFormatCellsTabId, 'font'>;
+    focus?: never;
+};
+export declare const defaultSpreadsheetFormatCellsOpenIntent: {
+    readonly tab: "number";
+};
+export declare function normalizeSpreadsheetFormatCellsOpenIntent(value: unknown): SpreadsheetFormatCellsOpenIntent | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -89,6 +89,8 @@
     "playground:visual": "playwright test --config playwright.config.ts",
     "playground:visual:spreadsheet-data-validation": "playwright test visual-tests/spreadsheet-data-validation.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-date-time": "playwright test visual-tests/spreadsheet-date-time.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:spreadsheet-copy-from-above": "playwright test visual-tests/spreadsheet-copy-from-above.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:spreadsheet-font-dialog-shortcuts": "playwright test visual-tests/spreadsheet-font-dialog-shortcuts.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-diagonal-borders": "playwright test visual-tests/spreadsheet-diagonal-borders.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-font-colors-shortcuts": "playwright test visual-tests/spreadsheet-font-colors-shortcuts.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-hyperlink": "playwright test visual-tests/spreadsheet-hyperlink.functional.spec.ts --config playwright.config.ts",
@@ -163,6 +165,10 @@
     "test:e2e:spreadsheet-diagonal-borders:check": "a3s-test check tests/e2e/spreadsheet-diagonal-borders.acl --json",
     "test:e2e:spreadsheet-date-time": "a3s-test run tests/e2e/spreadsheet-date-time.acl --json",
     "test:e2e:spreadsheet-date-time:check": "a3s-test check tests/e2e/spreadsheet-date-time.acl --json",
+    "test:e2e:spreadsheet-copy-from-above": "A3S_TEST_SUITE=tests/e2e/spreadsheet-copy-from-above.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:spreadsheet-copy-from-above:check": "a3s-test check tests/e2e/spreadsheet-copy-from-above.acl --json",
+    "test:e2e:spreadsheet-font-dialog-shortcuts": "A3S_TEST_SUITE=tests/e2e/spreadsheet-font-dialog-shortcuts.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:spreadsheet-font-dialog-shortcuts:check": "a3s-test check tests/e2e/spreadsheet-font-dialog-shortcuts.acl --json",
     "test:e2e:spreadsheet-hyperlink": "a3s-test run tests/e2e/spreadsheet-hyperlink.acl --json",
     "test:e2e:spreadsheet-hyperlink:check": "a3s-test check tests/e2e/spreadsheet-hyperlink.acl --json",
     "test:e2e:spreadsheet-maximum-sparse": "a3s-test run tests/e2e/spreadsheet-maximum-sparse.acl --json",