@a3s-lab/office 0.23.0 → 0.24.0

package/README.md

@@ -124,8 +124,8 @@ 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, 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 |
+| 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,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.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/)

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~spreadsheet-editor.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: '上框线',
@@ -4752,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',
@@ -4766,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;
@@ -4787,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, {
@@ -4808,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;
@@ -13603,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;
@@ -13621,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)=>{
@@ -13637,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)=>{
@@ -13714,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`,
@@ -13731,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)=>{
@@ -13983,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);
@@ -14180,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);
@@ -14244,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,
@@ -23226,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);
@@ -23376,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;
@@ -23656,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
@@ -23804,7 +23895,7 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
         },
         formatPainter,
         formatCells: {
-            canOpen: !preview && null === formatCellsSource,
+            canOpen: !preview && null === formatCellsDialog,
             open: openSpreadsheetFormatCells
         },
         hyperlink: spreadsheetHyperlink.commandPort,
@@ -24247,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{

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: "上框线";

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

@@ -7,6 +7,7 @@ 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';
@@ -119,6 +120,7 @@ export interface SpreadsheetFormatCellsOpenRequest {
         column: number;
     };
     cells: (Cell | null)[][];
+    intent: SpreadsheetFormatCellsOpenIntent;
 }
 export interface SpreadsheetFormatCellsCommandPort {
     canOpen: boolean;
@@ -179,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-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.23.0",
+  "version": "0.24.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -90,6 +90,7 @@
     "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",
@@ -166,6 +167,8 @@
     "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",