@a3s-lab/office 0.13.0 → 0.14.0

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

@@ -1,9 +1,10 @@
-import type { ReactNode } from 'react';
-export declare function OfficeCheckbox({ ariaLabel, checked, onCheckedChange, children, disabled, className, }: {
+import { type ReactNode } from 'react';
+export declare function OfficeCheckbox({ ariaLabel, checked, onCheckedChange, children, disabled, className, indeterminate, }: {
     ariaLabel: string;
     checked: boolean;
     onCheckedChange: (checked: boolean) => void;
     children: ReactNode;
     disabled?: boolean;
     className?: string;
+    indeterminate?: boolean;
 }): import("react").JSX.Element;

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

@@ -1,2 +1,3 @@
 import type { KeyboardEvent } from 'react';
 export declare function moveOfficeMenuFocus(event: KeyboardEvent<HTMLElement>): boolean;
+export declare function moveOfficeGridMenuFocus(event: KeyboardEvent<HTMLElement>, columns: number): boolean;

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

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

package/dist/internal/features/work/editors/spreadsheet-auto-sum.d.ts

@@ -0,0 +1,19 @@
+import type { WorkSpreadsheetSheet } from '../work-types';
+import { type SpreadsheetCellRange, type SpreadsheetCellRangeInput } from './spreadsheet-cell-range';
+export declare const spreadsheetAutoSumMaximumTargets = 1000;
+export type SpreadsheetAutoSumFunction = 'sum' | 'average' | 'count' | 'max' | 'min';
+export interface SpreadsheetAutoSumWrite {
+    range: SpreadsheetCellRange;
+    values: string[][];
+}
+export interface SpreadsheetAutoSumPlan {
+    formulaBarValue: string;
+    function: SpreadsheetAutoSumFunction;
+    selection: SpreadsheetCellRange & {
+        row_focus: number;
+        column_focus: number;
+    };
+    targetCellCount: number;
+    writes: SpreadsheetAutoSumWrite[];
+}
+export declare function planSpreadsheetAutoSum(sheet: WorkSpreadsheetSheet | undefined, selection: SpreadsheetCellRangeInput, functionName: SpreadsheetAutoSumFunction): SpreadsheetAutoSumPlan | null;

package/dist/internal/features/work/editors/spreadsheet-cell-border-per-cell.d.ts

@@ -0,0 +1,5 @@
+import type { WorkSpreadsheetContent } from '../work-types';
+import { type SpreadsheetCellBorderFormat } from './spreadsheet-cell-border';
+import { type SpreadsheetCellRangeInput } from './spreadsheet-cell-range';
+export declare const MAX_SPREADSHEET_PER_CELL_BORDER_CELLS = 10000;
+export declare function setSpreadsheetCellBordersPerCell(content: WorkSpreadsheetContent, sheetId: string, range: SpreadsheetCellRangeInput, formats: readonly SpreadsheetCellBorderFormat[]): WorkSpreadsheetContent | null;

package/dist/internal/features/work/editors/spreadsheet-cell-border.d.ts

@@ -1,4 +1,4 @@
-import type { WorkSpreadsheetContent } from '../work-types';
+import type { WorkSpreadsheetContent, WorkSpreadsheetSheet } from '../work-types';
 import { type SpreadsheetCellRangeInput } from './spreadsheet-cell-range';
 export declare const spreadsheetCellBorderTargets: readonly ["top", "bottom", "left", "right", "none", "all", "outside", "inside", "horizontal", "vertical", "diagonal"];
 export type SpreadsheetCellBorderTarget = (typeof spreadsheetCellBorderTargets)[number];
@@ -9,6 +9,20 @@ export interface SpreadsheetCellBorderFormat {
     color: string;
     style: SpreadsheetCellBorderStyle;
 }
+export interface SpreadsheetResolvedCellBorderLine {
+    color: string;
+    style: string;
+}
+export interface SpreadsheetResolvedCellBorders {
+    bottom?: SpreadsheetResolvedCellBorderLine;
+    diagonal?: SpreadsheetResolvedCellBorderLine;
+    left?: SpreadsheetResolvedCellBorderLine;
+    right?: SpreadsheetResolvedCellBorderLine;
+    top?: SpreadsheetResolvedCellBorderLine;
+}
 export declare const MAX_SPREADSHEET_DIAGONAL_BORDER_CELLS = 4096;
+export declare function spreadsheetNativeBorderStyle(style: SpreadsheetCellBorderStyle): string;
 export declare function canSetSpreadsheetCellBorders(content: WorkSpreadsheetContent, sheetId: string, range: SpreadsheetCellRangeInput, format: SpreadsheetCellBorderFormat): boolean;
 export declare function setSpreadsheetCellBorders(content: WorkSpreadsheetContent, sheetId: string, range: SpreadsheetCellRangeInput, format: SpreadsheetCellBorderFormat): WorkSpreadsheetContent | null;
+export declare function spreadsheetCellBordersAt(sheet: WorkSpreadsheetSheet | undefined, row: number, column: number): SpreadsheetResolvedCellBorders;
+export declare function normalizeSpreadsheetBorderFormat(format: SpreadsheetCellBorderFormat): SpreadsheetCellBorderFormat | null;

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

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

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

@@ -0,0 +1,36 @@
+import type { Cell } from '@fortune-sheet/core';
+import type { WorkSpreadsheetContent, WorkSpreadsheetSheet } from '../work-types';
+import { type SpreadsheetCellBorderFormat } from './spreadsheet-cell-border';
+import { type SpreadsheetCellRange } from './spreadsheet-cell-range';
+export declare const MAX_SPREADSHEET_CELL_FORMAT_CELLS = 10000;
+export type SpreadsheetHorizontalAlignment = 'general' | 'left' | 'center' | 'right';
+export type SpreadsheetVerticalAlignment = 'top' | 'middle' | 'bottom';
+export interface SpreadsheetCellFormatPatch {
+    numberFormat?: string;
+    horizontalAlignment?: SpreadsheetHorizontalAlignment;
+    verticalAlignment?: SpreadsheetVerticalAlignment;
+    wrapText?: boolean;
+    rotation?: number;
+    fontFamily?: string;
+    fontSize?: number;
+    fontColor?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strike?: boolean;
+    fillColor?: string | null;
+    borders?: readonly SpreadsheetCellBorderFormat[];
+    locked?: boolean;
+    hidden?: boolean;
+}
+export interface SpreadsheetCellFormatRequest {
+    sheetId: string;
+    range: SpreadsheetCellRange;
+    patch: SpreadsheetCellFormatPatch;
+}
+export declare function canApplySpreadsheetCellFormat(content: WorkSpreadsheetContent, request: SpreadsheetCellFormatRequest): boolean;
+export declare function applySpreadsheetCellFormat(content: WorkSpreadsheetContent, request: SpreadsheetCellFormatRequest): WorkSpreadsheetContent | null;
+export declare function spreadsheetCellProtectionAt(sheet: WorkSpreadsheetSheet, row: number, column: number, cell?: Cell | null | undefined): {
+    locked: boolean;
+    hidden: boolean;
+};

package/dist/internal/features/work/editors/spreadsheet-cell-mutation-guard.d.ts

@@ -0,0 +1,4 @@
+import type { WorkSpreadsheetSheet } from '../work-types';
+import { type SpreadsheetCellRange } from './spreadsheet-cell-range';
+export declare function canMutateSpreadsheetCellRange(sheet: WorkSpreadsheetSheet | undefined, range: SpreadsheetCellRange): boolean;
+export declare function canMutateSpreadsheetCellRanges(sheet: WorkSpreadsheetSheet | undefined, ranges: readonly SpreadsheetCellRange[]): boolean;

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

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

package/dist/internal/features/work/editors/spreadsheet-cell-style-ribbon.d.ts

@@ -0,0 +1,9 @@
+import type { Cell } from '@fortune-sheet/core';
+import type { SpreadsheetResolvedCellBorders } from './spreadsheet-cell-border';
+import type { SpreadsheetEditorCanCommands, SpreadsheetEditorCommands } from './spreadsheet-command-controller';
+export declare function SpreadsheetCellStyleRibbon({ can, commands, toolbarCell, toolbarCellBorders, }: {
+    can: SpreadsheetEditorCanCommands;
+    commands: SpreadsheetEditorCommands;
+    toolbarCell: Cell | null | undefined;
+    toolbarCellBorders?: SpreadsheetResolvedCellBorders;
+}): import("react").JSX.Element;

package/dist/internal/features/work/editors/spreadsheet-cell-style.d.ts

@@ -0,0 +1,41 @@
+import type { Cell } from '@fortune-sheet/core';
+import type { WorkSpreadsheetContent } from '../work-types';
+import { type SpreadsheetCellBorderFormat, type SpreadsheetResolvedCellBorders } from './spreadsheet-cell-border';
+import { type SpreadsheetCellRangeInput } from './spreadsheet-cell-range';
+export declare const spreadsheetCellStylePresetIds: readonly ["normal", "good", "bad", "neutral", "calculation", "checkCell", "explanatoryText", "input", "linkedCell", "note", "output", "warningText", "heading1", "heading2", "heading3", "heading4", "total"];
+export type SpreadsheetCellStyleChoice = (typeof spreadsheetCellStylePresetIds)[number];
+export type SpreadsheetCellStylePreset = SpreadsheetCellStyleChoice | 'custom';
+export declare const MAX_SPREADSHEET_CELL_STYLE_CELLS = 10000;
+interface SpreadsheetCellStyleFormat {
+    bg: string;
+    bl: 0 | 1;
+    cl: 0 | 1;
+    fc: string;
+    ff: string;
+    fs: number;
+    it: 0 | 1;
+    un: 0 | 1;
+}
+export interface SpreadsheetCellStylePreview {
+    backgroundColor: string;
+    color: string;
+    fontSize?: string;
+    fontStyle?: 'italic' | 'normal';
+    fontWeight?: number;
+    textDecoration?: 'none' | 'underline';
+}
+export interface SpreadsheetCellStyleDefinition {
+    id: SpreadsheetCellStyleChoice;
+    label: string;
+    group: '常用' | '数据和模型' | '标题和汇总';
+    description: string;
+    format: SpreadsheetCellStyleFormat;
+    borders?: readonly SpreadsheetCellBorderFormat[];
+    preview: SpreadsheetCellStylePreview;
+}
+export declare const spreadsheetCellStyleDefinitions: readonly [SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition, SpreadsheetCellStyleDefinition];
+export declare function spreadsheetCellStyleDefinition(preset: SpreadsheetCellStyleChoice): SpreadsheetCellStyleDefinition;
+export declare function spreadsheetCellStylePreset(cell: Cell | null | undefined, borders?: SpreadsheetResolvedCellBorders): SpreadsheetCellStylePreset;
+export declare function canApplySpreadsheetCellStyle(content: WorkSpreadsheetContent, sheetId: string, range: SpreadsheetCellRangeInput, preset: SpreadsheetCellStyleChoice): boolean;
+export declare function applySpreadsheetCellStyle(content: WorkSpreadsheetContent, sheetId: string, range: SpreadsheetCellRangeInput, preset: SpreadsheetCellStyleChoice): WorkSpreadsheetContent | null;
+export {};

package/dist/internal/features/work/editors/spreadsheet-clipboard-shortcuts.d.ts

@@ -3,3 +3,4 @@ export interface SpreadsheetClipboardShortcutOptions {
     execute(): boolean;
 }
 export declare function runSpreadsheetClipboardShortcut(event: KeyboardEvent, canExecute: SpreadsheetClipboardShortcutOptions['canExecute'], execute: SpreadsheetClipboardShortcutOptions['execute']): boolean;
+export declare function runSpreadsheetPasteSpecialShortcut(event: KeyboardEvent, canExecute: SpreadsheetClipboardShortcutOptions['canExecute'], execute: SpreadsheetClipboardShortcutOptions['execute']): boolean;

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

@@ -0,0 +1,13 @@
+import { type SpreadsheetClipboardSnapshot } from './spreadsheet-paste-special';
+export interface SpreadsheetClipboardPort {
+    readText(): Promise<string>;
+    writeText(value: string): Promise<void>;
+}
+export declare function parseSpreadsheetClipboardText(value: string): string[][];
+export declare const browserSpreadsheetClipboard: SpreadsheetClipboardPort;
+export declare function storeRichSpreadsheetClipboard(snapshot: SpreadsheetClipboardSnapshot): void;
+export declare function spreadsheetClipboardSnapshotForText(plainText: string): SpreadsheetClipboardSnapshot | null;
+export declare function clearRichSpreadsheetClipboard(): void;
+export declare function readSpreadsheetClipboardText(readSystem: (() => Promise<string>) | undefined, readLocal: () => string, timeoutMs?: number, canReadSystem?: () => boolean | Promise<boolean>): Promise<string>;
+export declare function writeSpreadsheetClipboardText(value: string, writeSystem: ((value: string) => Promise<void>) | undefined, writeLocal: (value: string) => void, timeoutMs?: number, onSystemWriteResult?: (succeeded: boolean) => void): Promise<void>;
+export declare function copySpreadsheetSelection(clipboard: SpreadsheetClipboardPort, value: string, cut: boolean): Promise<boolean>;

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

@@ -80,6 +80,20 @@ export declare const spreadsheetCommandCatalog: {
             readonly editor: readonly ["Mod-v"];
         };
     };
+    readonly pasteSpecial: {
+        readonly id: "clipboard.pasteSpecial";
+        readonly label: "选择性粘贴";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "clipboard";
+        };
+        readonly shortcut: {
+            readonly label: "Cmd/Ctrl+Alt+V";
+            readonly aria: "Control+Alt+V Meta+Alt+V";
+            readonly editor: readonly ["Mod-Alt-v"];
+        };
+    };
     readonly cut: {
         readonly id: "clipboard.cut";
         readonly label: "剪切";
@@ -173,6 +187,163 @@ export declare const spreadsheetCommandCatalog: {
             readonly editor: readonly ["Mod-5"];
         };
     };
+    readonly numberFormatGeneral: {
+        readonly id: "number.general";
+        readonly label: "常规";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "number";
+        };
+        readonly shortcut: {
+            readonly label: "Cmd/Ctrl+Shift+~";
+            readonly aria: "Control+Shift+~ Meta+Shift+~";
+            readonly editor: readonly ["Mod-Shift-~"];
+        };
+    };
+    readonly numberFormatNumber: {
+        readonly id: "number.number";
+        readonly label: "数字";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "number";
+        };
+        readonly shortcut: {
+            readonly label: "Cmd/Ctrl+Shift+!";
+            readonly aria: "Control+Shift+! Meta+Shift+!";
+            readonly editor: readonly ["Mod-Shift-!"];
+        };
+    };
+    readonly numberFormatCurrency: {
+        readonly id: "number.currency";
+        readonly label: "货币";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "number";
+        };
+        readonly shortcut: {
+            readonly label: "Cmd/Ctrl+Shift+$";
+            readonly aria: "Control+Shift+$ Meta+Shift+$";
+            readonly editor: readonly ["Mod-Shift-$"];
+        };
+    };
+    readonly numberFormatAccounting: {
+        readonly id: "number.accounting";
+        readonly label: "会计专用";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "number";
+        };
+    };
+    readonly numberFormatPercent: {
+        readonly id: "number.percent";
+        readonly label: "百分比";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "number";
+        };
+        readonly shortcut: {
+            readonly label: "Cmd/Ctrl+Shift+%";
+            readonly aria: "Control+Shift+% Meta+Shift+%";
+            readonly editor: readonly ["Mod-Shift-%"];
+        };
+    };
+    readonly numberFormatDate: {
+        readonly id: "number.date";
+        readonly label: "短日期";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "number";
+        };
+        readonly shortcut: {
+            readonly label: "Cmd/Ctrl+Shift+#";
+            readonly aria: "Control+Shift+# Meta+Shift+#";
+            readonly editor: readonly ["Mod-Shift-#"];
+        };
+    };
+    readonly numberFormatTime: {
+        readonly id: "number.time";
+        readonly label: "时间";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "number";
+        };
+        readonly shortcut: {
+            readonly label: "Cmd/Ctrl+Shift+@";
+            readonly aria: "Control+Shift+@ Meta+Shift+@";
+            readonly editor: readonly ["Mod-Shift-@"];
+        };
+    };
+    readonly numberFormatScientific: {
+        readonly id: "number.scientific";
+        readonly label: "科学计数";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "number";
+        };
+        readonly shortcut: {
+            readonly label: "Cmd/Ctrl+Shift+^";
+            readonly aria: "Control+Shift+^ Meta+Shift+^";
+            readonly editor: readonly ["Mod-Shift-^"];
+        };
+    };
+    readonly numberFormatFraction: {
+        readonly id: "number.fraction";
+        readonly label: "分数";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "number";
+        };
+    };
+    readonly numberFormatText: {
+        readonly id: "number.text";
+        readonly label: "文本";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "number";
+        };
+    };
+    readonly decreaseDecimalPlaces: {
+        readonly id: "number.decreaseDecimalPlaces";
+        readonly label: "减少小数位";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "number";
+        };
+    };
+    readonly increaseDecimalPlaces: {
+        readonly id: "number.increaseDecimalPlaces";
+        readonly label: "增加小数位";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "number";
+        };
+    };
+    readonly formatCells: {
+        readonly id: "number.formatCells";
+        readonly label: "设置单元格格式";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "number";
+        };
+        readonly shortcut: {
+            readonly label: "Cmd/Ctrl+1";
+            readonly aria: "Control+1 Meta+1";
+            readonly editor: readonly ["Mod-1"];
+        };
+    };
     readonly borderTop: {
         readonly id: "font.borderTop";
         readonly label: "上框线";
@@ -331,6 +502,15 @@ export declare const spreadsheetCommandCatalog: {
             readonly group: "styles";
         };
     };
+    readonly cellStyles: {
+        readonly id: "styles.cellStyles";
+        readonly label: "单元格样式";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "styles";
+        };
+    };
     readonly insertRowsAbove: {
         readonly id: "cells.insertRowsAbove";
         readonly label: "在上方插入行";
@@ -385,6 +565,56 @@ export declare const spreadsheetCommandCatalog: {
             readonly group: "cells";
         };
     };
+    readonly autoSum: {
+        readonly id: "editing.autoSum";
+        readonly label: "自动求和";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "editing";
+        };
+        readonly shortcut: {
+            readonly label: "Alt+=";
+            readonly aria: "Alt+=";
+            readonly editor: readonly ["Alt-equal"];
+        };
+    };
+    readonly autoAverage: {
+        readonly id: "editing.autoAverage";
+        readonly label: "平均值";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "editing";
+        };
+    };
+    readonly autoCount: {
+        readonly id: "editing.autoCount";
+        readonly label: "计数";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "editing";
+        };
+    };
+    readonly autoMaximum: {
+        readonly id: "editing.autoMaximum";
+        readonly label: "最大值";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "editing";
+        };
+    };
+    readonly autoMinimum: {
+        readonly id: "editing.autoMinimum";
+        readonly label: "最小值";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "editing";
+        };
+    };
     readonly fillDown: {
         readonly id: "editing.fillDown";
         readonly label: "向下填充";
@@ -495,6 +725,29 @@ export declare const spreadsheetCommandCatalog: {
             readonly editor: readonly ["Mod-f"];
         };
     };
+    readonly findAndSelect: {
+        readonly id: "editing.findAndSelect";
+        readonly label: "查找和选择";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "editing";
+        };
+    };
+    readonly goTo: {
+        readonly id: "editing.goTo";
+        readonly label: "定位";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "editing";
+        };
+        readonly shortcut: {
+            readonly label: "Ctrl+G 或 F5";
+            readonly aria: "Control+G F5";
+            readonly editor: readonly ["Control-g", "F5"];
+        };
+    };
     readonly insertChart: {
         readonly id: "insert.chart";
         readonly label: "插入图表";

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

@@ -2,13 +2,19 @@ import type { Cell, Selection, Sheet } from '@fortune-sheet/core';
 import { type SpreadsheetGridSize } from '../spreadsheet-sparse';
 import type { WorkSpreadsheetContent } from '../work-types';
 import { type OfficeEditorCanCommands, type OfficeEditorExtension } from './office-editor-extension';
+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 { SpreadsheetCellRange } from './spreadsheet-cell-range';
+import type { SpreadsheetCellStyleChoice } from './spreadsheet-cell-style';
 import type { SpreadsheetCellFillDirection } from './spreadsheet-cell-fill';
 import { type SpreadsheetCellMergeCommand } from './spreadsheet-cell-merge';
 import type { SpreadsheetFormatPainterMode } from './spreadsheet-format-painter';
 import { type SpreadsheetFreezePanePreset } from './spreadsheet-freeze-panes';
 import { type SpreadsheetKeyboardSelection, type SpreadsheetSelectionMove, type SpreadsheetSelectionScope } from './spreadsheet-keyboard-navigation';
+import type { SpreadsheetPasteContent } from './spreadsheet-paste-special';
+import { type SpreadsheetDecimalPlacesDirection } from './spreadsheet-number-format-command';
 import { type SpreadsheetSheetMoveDirection } from './spreadsheet-sheet-model';
 export interface SpreadsheetWorkbookCommandPort {
     autoFillCell: (copyRange: SpreadsheetCommandRange, applyRange: SpreadsheetCommandRange, direction: SpreadsheetCellFillDirection) => void;
@@ -74,10 +80,14 @@ export interface SpreadsheetHistoryCommandPort {
 export interface SpreadsheetClipboardCommandPort {
     canCopySelection: boolean;
     canCutSelection: boolean;
+    canOpenPasteSpecial: boolean;
     canPasteSelection: boolean;
+    canPasteSpecial: (content: SpreadsheetPasteContent) => boolean;
     copySelection: () => boolean;
     cutSelection: () => boolean;
+    openPasteSpecial: () => boolean;
     pasteSelection: () => boolean;
+    pasteSpecial: (content: SpreadsheetPasteContent) => boolean;
 }
 export interface SpreadsheetAutoFilterCommandPort {
     active: boolean;
@@ -94,6 +104,25 @@ export interface SpreadsheetFormatPainterCommandPort {
     applySelection: (target: SpreadsheetCommandSelection) => boolean;
     cancel: () => boolean;
 }
+export interface SpreadsheetFormatCellsOpenRequest {
+    sheetId: string;
+    range: SpreadsheetCellRange;
+    activeCell: {
+        row: number;
+        column: number;
+    };
+    cells: (Cell | null)[][];
+}
+export interface SpreadsheetFormatCellsCommandPort {
+    canOpen: boolean;
+    open: (request: SpreadsheetFormatCellsOpenRequest) => boolean;
+}
+export interface SpreadsheetNavigationCommandPort {
+    canOpenFind: boolean;
+    canOpenGoTo: boolean;
+    openFind: () => boolean;
+    openGoTo: () => boolean;
+}
 export interface SpreadsheetFormulaBarCommandPort {
     setValue: (value: unknown) => void;
 }
@@ -104,6 +133,10 @@ export interface SpreadsheetEditorCommands {
     activateSheet: (sheetId: string) => boolean;
     activateFormatPainter: (mode: SpreadsheetFormatPainterMode) => boolean;
     addSheet: () => boolean;
+    adjustDecimalPlaces: (direction: SpreadsheetDecimalPlacesDirection) => boolean;
+    applyCellStyle: (preset: SpreadsheetCellStyleChoice) => boolean;
+    applyCellFormat: (request: SpreadsheetCellFormatRequest) => boolean;
+    applyAutoSum: (functionName: SpreadsheetAutoSumFunction) => boolean;
     applyFormatPainter: (target: SpreadsheetCommandSelection) => boolean;
     cancelFormatPainter: () => boolean;
     clearSelectedCells: (mode?: SpreadsheetCellClearMode) => boolean;
@@ -119,8 +152,13 @@ export interface SpreadsheetEditorCommands {
     moveSheet: (sheetId: string, direction: SpreadsheetSheetMoveDirection) => boolean;
     moveSelection: (move: SpreadsheetSelectionMove, extend: boolean) => boolean;
     openAutoFilterMenu: () => boolean;
+    openFind: () => boolean;
+    openFormatCells: () => boolean;
+    openGoTo: () => boolean;
+    openPasteSpecial: () => boolean;
     pasteCells: (values: readonly (readonly unknown[])[]) => boolean;
     pasteSelection: () => boolean;
+    pasteSpecial: (content: SpreadsheetPasteContent) => boolean;
     recalculateFormula: (scope: 'selection' | 'workbook') => boolean;
     renameSheet: (sheetId: string, name: string) => boolean;
     redo: () => boolean;
@@ -149,7 +187,9 @@ export interface SpreadsheetCommandContext {
     fallbackRange: SpreadsheetCommandRange;
     formulaBar: SpreadsheetFormulaBarCommandPort | null;
     formatPainter: SpreadsheetFormatPainterCommandPort;
+    formatCells: SpreadsheetFormatCellsCommandPort;
     history: SpreadsheetHistoryCommandPort | null;
+    navigation: SpreadsheetNavigationCommandPort;
     onChange: (content: WorkSpreadsheetContent) => void;
     selection: SpreadsheetCommandSelection | null;
     targetSheetGridSize?: SpreadsheetGridSize | null;

package/dist/internal/features/work/editors/spreadsheet-context-menu.d.ts

@@ -1,19 +1,14 @@
 import type { WorkspaceContextMenuItem } from '../../workspace/components/workspace-context-menu';
 import type { WorkSpreadsheetAgentSelection } from '../work-spreadsheet-agent-context';
 import type { SpreadsheetEditorCanCommands, SpreadsheetEditorCommands, SpreadsheetStructureAxis } from './spreadsheet-command-controller';
-type SpreadsheetContextCan = Pick<SpreadsheetEditorCanCommands, 'clearSelectedCells' | 'pasteCells'>;
-type SpreadsheetContextCommands = Pick<SpreadsheetEditorCommands, 'clearSelectedCells' | 'pasteCells'>;
+type SpreadsheetContextCan = Pick<SpreadsheetEditorCanCommands, 'clearSelectedCells' | 'copySelection' | 'cutSelection' | 'openPasteSpecial' | 'pasteSelection'>;
+type SpreadsheetContextCommands = Pick<SpreadsheetEditorCommands, 'clearSelectedCells' | 'copySelection' | 'cutSelection' | 'openPasteSpecial' | 'pasteSelection'>;
 type SpreadsheetStructureCan = Pick<SpreadsheetEditorCanCommands, 'deleteSelectedStructure' | 'insertSelectedStructure' | 'setSelectedStructureHidden' | 'setSelectedStructureSize' | 'sortSelectedCells'>;
 type SpreadsheetStructureCommands = Pick<SpreadsheetEditorCommands, 'deleteSelectedStructure' | 'insertSelectedStructure' | 'setSelectedStructureHidden' | 'setSelectedStructureSize' | 'sortSelectedCells'>;
 type SpreadsheetSortCan = Pick<SpreadsheetEditorCanCommands, 'sortSelectedCells'>;
 type SpreadsheetSortCommands = Pick<SpreadsheetEditorCommands, 'sortSelectedCells'>;
-export interface SpreadsheetClipboardPort {
-    readText(): Promise<string>;
-    writeText(value: string): Promise<void>;
-}
-export declare function spreadsheetCoreContextMenuItems({ can, clipboard, commands, selection, }: {
+export declare function spreadsheetCoreContextMenuItems({ can, commands, selection, }: {
     can: SpreadsheetContextCan;
-    clipboard?: SpreadsheetClipboardPort;
     commands: SpreadsheetContextCommands;
     selection: Pick<WorkSpreadsheetAgentSelection, 'clipboard' | 'reference'>;
 }): WorkspaceContextMenuItem[];
@@ -29,10 +24,5 @@ export declare function spreadsheetSortContextMenuItems({ can, commands, idSuffi
     idSuffix?: string;
     separatorBefore?: boolean;
 }): WorkspaceContextMenuItem[];
-export declare function parseSpreadsheetClipboardText(value: string): string[][];
-export declare const browserSpreadsheetClipboard: SpreadsheetClipboardPort;
-export declare function readSpreadsheetClipboardText(readSystem: (() => Promise<string>) | undefined, readLocal: () => string, timeoutMs?: number, canReadSystem?: () => boolean | Promise<boolean>): Promise<string>;
-export declare function writeSpreadsheetClipboardText(value: string, writeSystem: ((value: string) => Promise<void>) | undefined, writeLocal: (value: string) => void, timeoutMs?: number): Promise<void>;
-export declare function copySpreadsheetSelection(clipboard: SpreadsheetClipboardPort, value: string, cut: boolean): Promise<boolean>;
-export declare function pasteSpreadsheetSelection(clipboard: SpreadsheetClipboardPort, paste: SpreadsheetContextCommands['pasteCells']): Promise<void>;
-export {};
+export { browserSpreadsheetClipboard, copySpreadsheetSelection, parseSpreadsheetClipboardText, readSpreadsheetClipboardText, writeSpreadsheetClipboardText, } from './spreadsheet-clipboard';
+export type { SpreadsheetClipboardPort } from './spreadsheet-clipboard';

package/dist/internal/features/work/editors/spreadsheet-editor-ribbon.d.ts

@@ -1,12 +1,13 @@
 import type { Cell, Selection } from '@fortune-sheet/core';
 import type { WorkSpreadsheetContent } from '../work-types';
+import type { SpreadsheetResolvedCellBorders } from './spreadsheet-cell-border';
 import { type SpreadsheetRibbonTabId } from './spreadsheet-command-catalog';
 import type { SpreadsheetEditorCanCommands, SpreadsheetEditorCommands } from './spreadsheet-command-controller';
 import type { SpreadsheetFormatPainterMode } from './spreadsheet-format-painter';
 import type { SpreadsheetWorkbookPanelView } from './spreadsheet-workbook-panel';
 import { type WorkOfficeFileAction } from './work-office-chrome';
 export type { SpreadsheetRibbonTabId } from './spreadsheet-command-catalog';
-export declare function SpreadsheetEditorRibbon({ activeTab, autoFilterActive, can, commands, content, fileActions, findOpen, formatPainterMode, freezePanesActive, freezePanesSelection, gridLinesVisible, panelId, onOpenFind, onTabChange, onTogglePanel, panel, toolbarCell, }: {
+export declare function SpreadsheetEditorRibbon({ activeTab, autoFilterActive, can, commands, content, fileActions, findOpen, formatPainterMode, freezePanesActive, freezePanesSelection, gridLinesVisible, panelId, onTabChange, onTogglePanel, panel, toolbarCell, toolbarCellBorders, }: {
     activeTab: SpreadsheetRibbonTabId;
     autoFilterActive?: boolean;
     can: SpreadsheetEditorCanCommands;
@@ -19,9 +20,9 @@ export declare function SpreadsheetEditorRibbon({ activeTab, autoFilterActive, c
     freezePanesSelection?: Selection;
     gridLinesVisible: boolean;
     panelId: string;
-    onOpenFind: () => void;
     onTabChange: (tab: SpreadsheetRibbonTabId) => void;
     onTogglePanel: (panel: SpreadsheetWorkbookPanelView, trigger: HTMLButtonElement) => void;
     panel: SpreadsheetWorkbookPanelView | null;
     toolbarCell: Cell | null | undefined;
+    toolbarCellBorders?: SpreadsheetResolvedCellBorders;
 }): import("react").JSX.Element;