@a3s-lab/office 0.22.0 → 0.23.0

package/README.md

@@ -123,7 +123,7 @@ 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 |
+| 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, 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 |
 | Formulas and recalculation | **Partial** — dependency-aware calculation and common formula paths | Wider functions, arrays, volatile semantics, and calculation parity |
@@ -1347,6 +1347,7 @@ 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.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~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";
@@ -3752,6 +3752,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: '清除全部',
@@ -5223,6 +5255,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 +6307,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 +8772,7 @@ function createSpreadsheetEditorExtensions() {
         createSpreadsheetTableExtension(),
         createSpreadsheetAutoSumExtension(),
         createSpreadsheetCellFillExtension(),
+        createSpreadsheetCopyFromAboveExtension(),
         createSpreadsheetVisibilityShortcutExtension(),
         createOfficeEditorExtension({
             name: 'spreadsheetFormatPainter',
@@ -24217,6 +24382,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/spreadsheet-command-catalog.d.ts

@@ -852,6 +852,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

@@ -10,6 +10,7 @@ import type { SpreadsheetCellFormatRequest } from './spreadsheet-cell-format';
 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';
@@ -162,6 +163,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;

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -89,6 +89,7 @@
     "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-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 +164,8 @@
     "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-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",