@a3s-lab/office 0.34.0 → 0.35.0

package/README.md

@@ -13,13 +13,13 @@
 
 <p align="center">
   <a href="https://github.com/A3S-Lab/Office/actions/workflows/ci.yml"><img alt="CI status" src="https://img.shields.io/github/actions/workflow/status/A3S-Lab/Office/ci.yml?branch=main&amp;style=flat-square&amp;label=CI"></a>
-  <a href="https://a3s-lab.github.io/Office/"><img alt="Open the live Playground" src="https://img.shields.io/badge/Live_Playground-open-2f6fed?style=flat-square"></a>
+  <a href="https://a3s-lab.github.io/Office/playground/"><img alt="Open the live Playground" src="https://img.shields.io/badge/Live_Playground-open-2f6fed?style=flat-square"></a>
   <a href="#project-status"><img alt="Project status: pre-1.0" src="https://img.shields.io/badge/status-pre--1.0-7a5bd6?style=flat-square"></a>
   <a href="LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-159469?style=flat-square"></a>
 </p>
 
 <p align="center">
-  <a href="https://a3s-lab.github.io/Office/">Playground</a> ·
+  <a href="https://a3s-lab.github.io/Office/playground/">Playground</a> ·
   <a href="https://a3s-lab.github.io/Office/docs/">Documentation</a> ·
   <a href="#quick-start">Quick start</a> ·
   <a href="#editor-capability-comparison">Editors</a> ·
@@ -56,7 +56,7 @@ workflows, and a separate Rust automation plane.
 
 ## Latest on `main`
 
-The `0.34.0` release plus the current `main` branch expose these capabilities
+The `0.35.0` release plus the current `main` branch expose these capabilities
 as normal user-facing Playground templates, with matching implementation
 detail in the documentation:
 
@@ -71,16 +71,17 @@ detail in the documentation:
 | Spreadsheet | Complete common Data Validation input, blank/dropdown, and Stop/Warning/Information error settings with native XLSX round trips | Playground **Latest capabilities → 数据验证** · [Spreadsheet reference](docs/latest/en/components/spreadsheet.mdx#data-validation) |
 | PDF | Insert, delete, rotate, reorder, extract, merge, and split pages through a dedicated Web Worker, with Blob-level Undo/Redo and independent binary reopen verification | Playground **Latest capabilities → 组织 PDF 页面** · [PDF reference](docs/latest/en/components/pdf.mdx#page-organization) |
 
-All eight entries are reachable from the first Playground viewport. The seven
-content templates also remain under **新建**; **组织 PDF 页面** opens the normal
-PDF file workflow because page organization must operate on host-provided source
-bytes. The highlighted strip keeps each capability discoverable without a deep
-documentation section or an `?e2e=` fixture.
+All eight entries are reachable from the first Playground viewport. The
+filterable capability gallery groups releases by editor, publishes the source
+release on every card, and grows from one shared metadata list instead of a
+fixed-width strip. The seven content templates also remain under **新建**;
+**组织 PDF 页面** opens the normal PDF file workflow because page organization
+must operate on host-provided source bytes.
 
 ## See it working
 
 The images below are committed visual-regression baselines from the real
-[Playground](https://a3s-lab.github.io/Office/), not conceptual mockups.
+[Playground](https://a3s-lab.github.io/Office/playground/), not conceptual mockups.
 
 <p align="center">
   <a href="visual-tests/__snapshots__/linux/desktop-1280/document.png">
@@ -364,7 +365,7 @@ bun run playground
 ```
 
 Then open the local URL printed by the development server. For a zero-install
-tour, use the [live Playground](https://a3s-lab.github.io/Office/).
+tour, use the [live Playground](https://a3s-lab.github.io/Office/playground/).
 Choose **体验格式修订**, open **审阅**, then **查看修订（2）** to inspect the
 independent Formatting and Paragraph Formatting cards and exercise accept or
 reject semantics.
@@ -1613,15 +1614,16 @@ committed visual contracts; see [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Documentation
 
-The published website keeps the interactive Playground at its root and builds
-the searchable Rspress documentation center under `/docs/`. Simplified Chinese
-is the stable default, English remains available from the language menu, and
-the version menu switches between `latest` and frozen release documentation.
-Search is scoped to the active language and version. Both surfaces use the
-same deployment base, so preview, Pages, and fork deployments keep working
-without hard-coded return URLs.
+The published website follows the A3S UI documentation model: the searchable
+Rspress documentation center owns the website root, while Playground is a
+primary top-navigation route under `/playground/`. Simplified Chinese is the
+stable default, English remains available from the language menu, and the
+version menu switches between `latest` and frozen release documentation.
+Search is scoped to the active language and version. Both surfaces derive
+their paths from one deployment base, so preview, Pages, and fork deployments
+keep working without hard-coded return URLs.
 
-- [Live Playground](https://a3s-lab.github.io/Office/)
+- [Live Playground](https://a3s-lab.github.io/Office/playground/)
 - [Documentation center](https://a3s-lab.github.io/Office/docs/)
 - [A3S Office 0.34.0 documentation](https://a3s-lab.github.io/Office/docs/0.34.0/)
 - [A3S Office 0.33.0 documentation](https://a3s-lab.github.io/Office/docs/0.33.0/)

package/dist/0~presentation-editor.js

@@ -2425,6 +2425,9 @@ function PlaceholderButtons({ onAdd }) {
     });
 }
 const PRESENTATION_WORKSPACE_FOCUS_RETRY_FRAMES = 6;
+function presentationInitialEditingElementId(elements) {
+    return elements.find((element)=>element.placeholder?.type === 'title' && presentationElementCanEditContent(element) && !element.text.trim() && !element.textRuns?.some((run)=>run.text.trim()))?.id ?? null;
+}
 function restorePresentationWorkspaceFocus(root, getState, focusOrigin = document.activeElement) {
     if (!root) return;
     const commandTrigger = focusOrigin;
@@ -4356,6 +4359,7 @@ function PresentationTextEditor({ autoFocus = false, element, onChange, onEditor
     const onSelectionChangeRef = useRef(onSelectionChange);
     const appliedSignatureRef = useRef(presentationTextElementSignature(element));
     const initialContentRef = useRef(presentationTextElementHtml(element));
+    const initialFocusTargetRef = useRef("u" > typeof document && document.activeElement instanceof HTMLElement ? document.activeElement : null);
     elementRef.current = element;
     onChangeRef.current = onChange;
     onEditorChangeRef.current = onEditorChange;
@@ -4410,7 +4414,8 @@ function PresentationTextEditor({ autoFocus = false, element, onChange, onEditor
     useEffect(()=>{
         if (!autoFocus || !editor || editor.isDestroyed) return;
         const frame = window.requestAnimationFrame(()=>{
-            if (!editor.isDestroyed) editor.commands.focus('end');
+            if (editor.isDestroyed || !presentationFocusOwnerIsUnchanged(initialFocusTargetRef.current)) return;
+            editor.commands.focus('end');
         });
         return ()=>window.cancelAnimationFrame(frame);
     }, [
@@ -4438,6 +4443,12 @@ function PresentationTextEditor({ autoFocus = false, element, onChange, onEditor
         style: presentationTextBaseStyle(element)
     });
 }
+function presentationFocusOwnerIsUnchanged(initialFocusTarget) {
+    if ("u" < typeof document) return true;
+    const currentFocusTarget = document.activeElement;
+    if (!currentFocusTarget || currentFocusTarget === document.body) return true;
+    return !initialFocusTarget || currentFocusTarget === initialFocusTarget;
+}
 function createPresentationTextEditorExtensions(placeholder = '输入文字') {
     return [
         starter_kit.configure({
@@ -7881,9 +7892,12 @@ function usePresentationReviewCommands({ content, onChange, onClearSelection, on
 function activePresentationReviewInvoker() {
     return "u" > typeof document && document.activeElement instanceof HTMLElement ? document.activeElement : null;
 }
-function usePresentationSelection(elements) {
-    const [selectedElementIds, setSelectedElementIds] = useState([]);
-    const [editingElementId, setEditingElementId] = useState(null);
+function usePresentationSelection(elements, initialEditingElementId = null) {
+    const initialEditingElementExists = Boolean(initialEditingElementId && elements.some((element)=>element.id === initialEditingElementId));
+    const [selectedElementIds, setSelectedElementIds] = useState(()=>initialEditingElementExists && initialEditingElementId ? selectionWithPendingIds(elements, [
+            initialEditingElementId
+        ]) : []);
+    const [editingElementId, setEditingElementId] = useState(()=>initialEditingElementExists ? initialEditingElementId : null);
     const clear = useCallback(()=>{
         setSelectedElementIds([]);
         setEditingElementId(null);
@@ -8482,7 +8496,7 @@ function PresentationEditingSurface({ initialSlide, autoFocus = true, collaborat
     const selectedLayout = designContent.layouts?.find((layout)=>layout.id === selectedSlide?.layoutId) ?? designContent.layouts?.[0];
     const selectedMaster = designContent.masters?.find((master)=>master.id === selectedLayout?.masterId) ?? designContent.masters?.[0];
     const activeElements = 'layout' === designMode ? selectedLayout?.elements ?? [] : 'master' === designMode ? selectedMaster?.elements ?? [] : selectedSlide?.elements ?? [];
-    const selection = usePresentationSelection(activeElements);
+    const selection = usePresentationSelection(activeElements, autoFocus ? presentationInitialEditingElementId(activeElements) : null);
     const presentationPresenceLocation = useMemo(()=>({
             kind: 'presentation',
             slideId: selectedSlide.id,

package/dist/0~spreadsheet-editor.js

@@ -5315,6 +5315,70 @@ function spreadsheetCellFillRangeIsSafe(range) {
 function sameSpreadsheetCellRange(left, right) {
     return left.row[0] === right.row[0] && left.row[1] === right.row[1] && left.column[0] === right.column[0] && left.column[1] === right.column[1];
 }
+function canEditSpreadsheetSelection(context) {
+    return Boolean(context.editable && context.workbook && context.targetSheetId);
+}
+function spreadsheetLiveCommandRange(context) {
+    const selection = spreadsheetLiveCommandSelection(context);
+    return spreadsheetSingleRange(selection ?? context.fallbackRange);
+}
+function spreadsheetLiveCommandSelection(context) {
+    return spreadsheetLiveCommandSelections(context)?.at(-1);
+}
+function spreadsheetLiveCommandSelections(context) {
+    const shadow = context.selectionRef?.current;
+    if (shadow?.sheetId === context.targetSheetId) return [
+        shadow.selection
+    ];
+    return context.workbook?.getSelection();
+}
+function acceptSpreadsheetSelectionChange(selectionRef, sheetId, selection) {
+    const nextSelection = finiteSpreadsheetSelection(selection);
+    const requested = selectionRef.requested;
+    if (requested && (requested.sheetId !== sheetId || !sameSpreadsheetSelectionValue(requested.selection, nextSelection))) return null;
+    const next = {
+        sheetId,
+        selection: nextSelection
+    };
+    selectionRef.current = next;
+    return next;
+}
+function rememberSpreadsheetCommandSelection(context, selection) {
+    if (!context.selectionRef || !context.targetSheetId) return;
+    const next = {
+        ...selection,
+        row: [
+            ...selection.row
+        ],
+        column: [
+            ...selection.column
+        ]
+    };
+    context.selectionRef.current = {
+        sheetId: context.targetSheetId,
+        selection: next
+    };
+    context.selectionRef.requested = {
+        sheetId: context.targetSheetId,
+        selection: {
+            ...next,
+            row: [
+                ...next.row
+            ],
+            column: [
+                ...next.column
+            ]
+        }
+    };
+}
+function releaseSpreadsheetSelectionRequest(selectionRef) {
+    selectionRef.requested = null;
+}
+function sameSpreadsheetSelectionValue(left, right) {
+    const normalizedLeft = finiteSpreadsheetSelection(left);
+    const normalizedRight = finiteSpreadsheetSelection(right);
+    return normalizedLeft.row[0] === normalizedRight.row[0] && normalizedLeft.row[1] === normalizedRight.row[1] && normalizedLeft.column[0] === normalizedRight.column[0] && normalizedLeft.column[1] === normalizedRight.column[1] && normalizedLeft.row_focus === normalizedRight.row_focus && normalizedLeft.column_focus === normalizedRight.column_focus;
+}
 function createSpreadsheetCellFillExtension() {
     return createOfficeEditorExtension({
         name: 'spreadsheetCellFill',
@@ -5365,9 +5429,11 @@ function materializeSpreadsheetCellFillRows(sheet, plan) {
 }
 function spreadsheetSelectedCellFillPlan(context, direction) {
     if (!context.editable || !context.workbook || !context.targetSheetId || context.targetSheetId !== context.activeSheetId) return null;
-    const selections = context.workbook.getSelection();
+    const selections = spreadsheetLiveCommandSelections(context);
     if (selections?.length !== 1) return null;
-    const plan = planSpreadsheetCellFill(selections[0], direction);
+    const selection = selections[0];
+    if (!selection) return null;
+    const plan = planSpreadsheetCellFill(selection, direction);
     if (!plan) return null;
     const sheet = context.content.sheets.find((candidate)=>candidate.id === context.targetSheetId);
     return canApplySpreadsheetCellFill(sheet, plan) ? plan : null;
@@ -6323,13 +6389,6 @@ function applySelectedCellStyle(context, preset) {
 function liveSpreadsheetCellStyleRange(context) {
     return spreadsheetSingleRange(context.workbook?.getSelection()?.at(-1) ?? context.fallbackRange);
 }
-function canEditSpreadsheetSelection(context) {
-    return Boolean(context.editable && context.workbook && context.targetSheetId);
-}
-function spreadsheetLiveCommandRange(context) {
-    const selection = context.workbook?.getSelection()?.at(-1);
-    return spreadsheetSingleRange(selection ?? context.fallbackRange);
-}
 const MAX_SPREADSHEET_ROWS = 1048576;
 const spreadsheetPasteContentOptions = [
     {
@@ -8493,7 +8552,7 @@ function updateSpreadsheetSelection(context, storage, update) {
     if (!context.workbook || !context.targetSheetId) return false;
     const sheet = context.content.sheets.find((candidate)=>candidate.id === context.targetSheetId);
     if (!sheet) return false;
-    const liveSelection = context.workbook.getSelection()?.at(-1) ?? context.fallbackRange;
+    const liveSelection = spreadsheetLiveCommandSelection(context) ?? context.fallbackRange;
     const rememberedFocus = storage.focus;
     const selection = rememberedFocus && spreadsheetSelectionContainsFocus(liveSelection, rememberedFocus) ? {
         ...liveSelection,
@@ -8507,6 +8566,7 @@ function updateSpreadsheetSelection(context, storage, update) {
         ], {
             id: context.targetSheetId
         });
+        rememberSpreadsheetCommandSelection(context, next);
         storage.focus = {
             row: next.row_focus ?? next.row[1] ?? next.row[0] ?? 0,
             column: next.column_focus ?? next.column[1] ?? next.column[0] ?? 0
@@ -10010,6 +10070,16 @@ function pasteCells(context, values) {
         ], {
             id: context.targetSheetId
         });
+        rememberSpreadsheetCommandSelection(context, {
+            row: [
+                ...range.row
+            ],
+            column: [
+                ...range.column
+            ],
+            row_focus: range.row[0],
+            column_focus: range.column[0]
+        });
     } catch  {}
     syncSpreadsheetFormulaBar(context, data[0][0]);
     return true;
@@ -25395,6 +25465,60 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
     const editorFocusOrigin = useOfficeEditorFocusOrigin();
     const workbookRef = useRef(null);
     const projectedWorkbookSheetsRef = useRef([]);
+    useLayoutEffect(()=>{
+        const container = spreadsheetCanvasRef.current;
+        if (!container || preview) return;
+        let pendingEditor = null;
+        let pointerEnteredEditor = false;
+        const moveEditorCaretToEnd = (editor)=>{
+            if (document.activeElement !== editor || !editor.isConnected || !editor.textContent) return false;
+            const selection = document.getSelection();
+            if (!selection) return false;
+            const range = document.createRange();
+            range.selectNodeContents(editor);
+            range.collapse(false);
+            selection.removeAllRanges();
+            selection.addRange(range);
+            return true;
+        };
+        const handlePointerDown = (event)=>{
+            pointerEnteredEditor = event.target instanceof Element && Boolean(event.target.closest('.luckysheet-cell-input'));
+        };
+        const handleFocusIn = (event)=>{
+            const target = event.target;
+            const editor = target instanceof Element ? target.closest('.luckysheet-cell-input') : null;
+            if (!editor || pointerEnteredEditor) {
+                pendingEditor = null;
+                pointerEnteredEditor = false;
+                return;
+            }
+            pendingEditor = editor;
+            queueMicrotask(()=>{
+                if (pendingEditor === editor && moveEditorCaretToEnd(editor)) pendingEditor = null;
+            });
+        };
+        const observer = new MutationObserver(()=>{
+            const editor = pendingEditor;
+            if (!editor || document.activeElement !== editor) return;
+            if (!editor.textContent) return;
+            moveEditorCaretToEnd(editor);
+            pendingEditor = null;
+        });
+        container.addEventListener('pointerdown', handlePointerDown, true);
+        container.addEventListener('focusin', handleFocusIn, true);
+        observer.observe(container, {
+            characterData: true,
+            childList: true,
+            subtree: true
+        });
+        return ()=>{
+            container.removeEventListener('pointerdown', handlePointerDown, true);
+            container.removeEventListener('focusin', handleFocusIn, true);
+            observer.disconnect();
+        };
+    }, [
+        preview
+    ]);
     const spreadsheetZoomRef = useRef(100);
     const [workbookInstance, setWorkbookInstance] = useState(null);
     const bindWorkbookInstance = useCallback((instance)=>{
@@ -25413,6 +25537,10 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
     const [panel, setPanel] = useState(null);
     const panelTriggerRef = useRef(null);
     const [selectionState, setSelectionState] = useState(null);
+    const selectionStateRef = useRef({
+        current: null,
+        requested: null
+    });
     const formatPainterSelectionHandlerRef = useRef((_sheetId, _selection)=>void 0);
     const [contextMenu, setContextMenu] = useState(null);
     const [formatCellsDialog, setFormatCellsDialog] = useState(null);
@@ -25588,15 +25716,16 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
                 collaborationView?.activateSheet(id);
                 if (previewRef.current) setPreviewActiveSheetId(id);
                 else setNavigationActiveSheetId(id);
+                selectionStateRef.current.current = null;
+                releaseSpreadsheetSelectionRequest(selectionStateRef.current);
                 setSelectionState(null);
             },
             afterSelectionChange: (sheetId, selection)=>{
-                collaborationView?.select(sheetId, selection);
-                setSelectionState({
-                    sheetId,
-                    selection
-                });
-                formatPainterSelectionHandlerRef.current(sheetId, selection);
+                const next = acceptSpreadsheetSelectionChange(selectionStateRef.current, sheetId, selection);
+                if (!next) return;
+                collaborationView?.select(sheetId, next.selection);
+                setSelectionState(next);
+                formatPainterSelectionHandlerRef.current(sheetId, next.selection);
             },
             beforeUpdateCell: (row, column)=>{
                 const sheet = contentRef.current.sheets.find((candidate)=>candidate.id === activeSheetIdRef.current);
@@ -25876,6 +26005,8 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
         if (!sheet) return false;
         activeSheetIdRef.current = sheetId;
         if (collaborationView && !collaborationView.activateSheet(sheetId)) return false;
+        selectionStateRef.current.current = null;
+        releaseSpreadsheetSelectionRequest(selectionStateRef.current);
         setSelectionState(null);
         if (previewRef.current) setPreviewActiveSheetId(sheetId);
         try {
@@ -25910,7 +26041,7 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
                 targetRow: activeCell.row,
                 targetColumn: activeCell.column
             });
-            setSelectionState({
+            const nextSelection = {
                 sheetId,
                 selection: {
                     row: [
@@ -25922,7 +26053,21 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
                     row_focus: activeCell.row,
                     column_focus: activeCell.column
                 }
-            });
+            };
+            selectionStateRef.current.current = nextSelection;
+            selectionStateRef.current.requested = {
+                sheetId,
+                selection: {
+                    ...nextSelection.selection,
+                    row: [
+                        ...nextSelection.selection.row
+                    ],
+                    column: [
+                        ...nextSelection.selection.column
+                    ]
+                }
+            };
+            setSelectionState(nextSelection);
         } catch  {
             return false;
         }
@@ -26043,6 +26188,7 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
             toggle: (attribute)=>richTextSelectionRef.current?.toggle(contentRef.current, acceptSpreadsheetCommandChange, attribute) ?? false
         },
         selection: selectionState,
+        selectionRef: selectionStateRef.current,
         table: spreadsheetTable.commandPort,
         targetSheetGridSize,
         targetSheetId: toolbarSheetId,
@@ -26150,6 +26296,7 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
         if ('Escape' === event.key && isSpreadsheetCellEditingTarget(event.target)) requestAnimationFrame(()=>focusSpreadsheetGrid(spreadsheetCanvasRef.current));
     };
     const handleSpreadsheetKeyDownCapture = (event)=>{
+        releaseSpreadsheetSelectionRequest(selectionStateRef.current);
         if ('Alt' === event.key && !event.repeat && event.target instanceof Element && event.target.closest('.fortune-sheet-overlay') && reserveAutoFilterAltKey()) {
             event.preventDefault();
             event.stopPropagation();
@@ -26158,6 +26305,7 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
         handleSpreadsheetEditingEscape(event);
     };
     const handleSpreadsheetPointerDownCapture = (event)=>{
+        releaseSpreadsheetSelectionRequest(selectionStateRef.current);
         const controller = richTextSelectionRef.current;
         if (!controller) return;
         if (!isSpreadsheetRichTextFormatPointerTarget(event.target)) return void controller.clear();

package/dist/internal/features/work/editors/presentation-editor-focus.d.ts

@@ -1,4 +1,5 @@
 import type { PresentationEditorCommands } from './presentation-command-types';
+import type { WorkSlideElement } from '../work-types';
 export interface PresentationObjectFocusState {
     editingElementId: string | null;
     selectedElementIds: readonly string[];
@@ -7,6 +8,7 @@ export interface PresentationWorkspaceFocusState extends PresentationObjectFocus
     selectedSlideId: string;
     viewMode: 'normal' | 'sorter';
 }
+export declare function presentationInitialEditingElementId(elements: readonly WorkSlideElement[]): string | null;
 export declare function restorePresentationObjectFocus(container: HTMLElement | null, getState: () => PresentationObjectFocusState, focusOrigin?: Element | null): void;
 export declare function restorePresentationWorkspaceFocus(root: HTMLElement | null, getState: () => PresentationWorkspaceFocusState, focusOrigin?: Element | null): void;
 export declare function presentationWorkspaceFocusTarget(root: HTMLElement, state: PresentationWorkspaceFocusState): HTMLElement | undefined;

package/dist/internal/features/work/editors/presentation-text-editor.d.ts

@@ -13,6 +13,13 @@ export interface PresentationTextEditorProps {
     onSelectionChange?: () => void;
 }
 export declare function PresentationTextEditor({ autoFocus, element, onChange, onEditorChange, onExitEditing, onSelectionChange, }: PresentationTextEditorProps): import("react").JSX.Element | null;
+/**
+ * Keep delayed first-open focus from overriding a deliberate focus move that
+ * happened while the rich-text editor was being created. The document body is
+ * treated as an unfocused baseline so opening from a non-focusable surface can
+ * still enter the editor normally.
+ */
+export declare function presentationFocusOwnerIsUnchanged(initialFocusTarget: HTMLElement | null): boolean;
 export declare function createPresentationTextEditorExtensions(placeholder?: string): Extensions;
 export declare function presentationTextElementHtml(element: WorkSlideElement): string;
 export declare function presentationTextValue(editor: Editor, element: WorkSlideElement): PresentationTextValue;

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

@@ -67,6 +67,15 @@ export interface SpreadsheetCommandSelection {
     sheetId: string;
     selection: Selection;
 }
+/**
+ * Synchronous selection state shared by commands and the Fortune Sheet bridge.
+ * Fortune applies API calls through React state, so reading its imperative API
+ * twice in the same task can otherwise return the previous selection.
+ */
+export interface SpreadsheetSelectionRef {
+    current: SpreadsheetCommandSelection | null;
+    requested: SpreadsheetCommandSelection | null;
+}
 export type SpreadsheetStructureAxis = 'row' | 'column';
 export type SpreadsheetStructureInsertPosition = 'before' | 'after';
 export type SpreadsheetSortDirection = 'ascending' | 'descending';
@@ -238,6 +247,7 @@ export interface SpreadsheetCommandContext {
     onChange: (content: WorkSpreadsheetContent) => void;
     richTextFormat?: SpreadsheetRichTextFormatCommandPort | null;
     selection: SpreadsheetCommandSelection | null;
+    selectionRef?: SpreadsheetSelectionRef;
     table: SpreadsheetTableCommandPort;
     targetSheetGridSize?: SpreadsheetGridSize | null;
     targetSheetId: string;

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

@@ -1,3 +1,24 @@
-import type { SpreadsheetCommandContext, SpreadsheetCommandRange } from './spreadsheet-command-controller';
+import type { SpreadsheetCommandContext, SpreadsheetCommandSelection, SpreadsheetCommandRange, SpreadsheetSelectionRef } from './spreadsheet-command-controller';
 export declare function canEditSpreadsheetSelection(context: SpreadsheetCommandContext): boolean;
 export declare function spreadsheetLiveCommandRange(context: SpreadsheetCommandContext): SpreadsheetCommandRange;
+/**
+ * Returns the most recent selection known to the Office bridge. The ref is
+ * intentionally checked before Fortune's imperative API because that API is
+ * backed by React state and can lag behind a just-issued keyboard command.
+ */
+export declare function spreadsheetLiveCommandSelection(context: SpreadsheetCommandContext): SpreadsheetCommandRange | undefined;
+/**
+ * Returns all current selections while preserving the workbook's multi-range
+ * semantics. A synchronous command selection is represented as one range.
+ */
+export declare function spreadsheetLiveCommandSelections(context: SpreadsheetCommandContext): SpreadsheetCommandRange[] | undefined;
+/**
+ * Accept a Fortune selection callback unless it is older than a pending
+ * programmatic selection request. The returned value is the normalized state
+ * that should be published to React and collaboration consumers.
+ */
+export declare function acceptSpreadsheetSelectionChange(selectionRef: SpreadsheetSelectionRef, sheetId: string, selection: SpreadsheetCommandRange): SpreadsheetCommandSelection | null;
+export declare function rememberSpreadsheetCommandSelection(context: SpreadsheetCommandContext, selection: SpreadsheetCommandRange): void;
+/** Clear a pending programmatic request when a fresh user intent arrives. */
+export declare function releaseSpreadsheetSelectionRequest(selectionRef: SpreadsheetSelectionRef): void;
+export declare function sameSpreadsheetSelectionValue(left: SpreadsheetCommandRange, right: SpreadsheetCommandRange): boolean;

package/dist/internal/features/work/editors/use-presentation-selection.d.ts

@@ -8,4 +8,4 @@ export interface PresentationSelectionController {
     select: (elementId: string | null, additive?: boolean) => void;
     selectedElementIds: string[];
 }
-export declare function usePresentationSelection(elements: readonly WorkSlideElement[]): PresentationSelectionController;
+export declare function usePresentationSelection(elements: readonly WorkSlideElement[], initialEditingElementId?: string | null): PresentationSelectionController;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.34.0",
+  "version": "0.35.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -72,8 +72,8 @@
     "build": "bun run kernel:build && rslib",
     "collaboration-server:typecheck": "tsc --noEmit -p examples/collaboration-server/tsconfig.json",
     "dev": "bun run kernel:build && rslib --watch",
-    "docs:build": "rspress build -c website/rspress.config.ts && bun scripts/rewrite-docs-base.ts",
-    "docs:dev": "rspress -c website/rspress.config.ts",
+    "docs:build": "bun scripts/build-docs.ts",
+    "docs:dev": "rspress -c website/rspress.docs.config.ts",
     "format": "biome format --write .",
     "format:check": "biome format .",
     "lint": "biome lint .",
@@ -82,9 +82,9 @@
     "kernel:test": "bun run kernel:build && bun scripts/smoke-office-kernel.ts",
     "playground": "bun run playground:assets && rsbuild dev --config playground/rsbuild.config.ts",
     "playground:assets": "bun run build && bash scripts/package-office-skill.sh",
-    "playground:build": "bun run playground:assets && rsbuild build --config playground/rsbuild.config.ts && bun run docs:build",
+    "playground:build": "bun run playground:assets && bun run docs:build && rsbuild build --config playground/rsbuild.config.ts",
     "playground:bundle-check": "bun scripts/check-playground-bundle.ts",
-    "playground:preview": "rsbuild preview --config playground/rsbuild.config.ts --host 127.0.0.1 --port 4175 --strict-port",
+    "playground:preview": "rspress preview -c website/rspress.config.ts --host 127.0.0.1 --port 4175",
     "playground:typecheck": "tsc --noEmit -p playground/tsconfig.json",
     "playground:visual": "playwright test --config playwright.config.ts",
     "playground:visual:document-emphasis": "playwright test visual-tests/document-emphasis.functional.spec.ts --config playwright.config.ts",
@@ -118,12 +118,12 @@
     "playground:visual:pdf-page-organization": "playwright test visual-tests/pdf-page-organization.functional.spec.ts --config playwright.config.ts",
     "playground:visual:update": "playwright test --config playwright.config.ts --update-snapshots",
     "performance:fixtures": "bun .a3s-test/performance/generate-fixtures.ts",
-    "performance:large-document-edits": "bun .a3s-test/performance/generate-fixtures.ts --documents-only && bun .a3s-test/performance/benchmark-document-edit.ts http://127.0.0.1:4175/ 3",
-    "performance:large-documents": "bun .a3s-test/performance/generate-fixtures.ts --documents-only && bun .a3s-test/performance/benchmark.ts --url http://127.0.0.1:4175/ --scenarios document-text,document-table --runs 3 --timeout-ms 180000",
-    "performance:large-spreadsheet-edits": "bun .a3s-test/performance/generate-fixtures.ts --spreadsheets-only && bun .a3s-test/performance/benchmark-spreadsheet-edit.ts http://127.0.0.1:4175/ 3",
-    "performance:large-spreadsheets": "bun .a3s-test/performance/generate-fixtures.ts --spreadsheets-only && bun .a3s-test/performance/benchmark.ts --url http://127.0.0.1:4175/ --scenarios spreadsheet --runs 5 --timeout-ms 180000",
-    "performance:pdf": "bun .a3s-test/performance/generate-fixtures.ts --pdf-only && bun .a3s-test/performance/benchmark-pdf.ts --url http://127.0.0.1:4175/ --runs 3 --timeout-ms 120000",
-    "performance:presentation": "bun .a3s-test/performance/generate-fixtures.ts --presentations-only && bun .a3s-test/performance/benchmark-presentation.ts --url http://127.0.0.1:4175/ --runs 3 --timeout-ms 120000 --modes default,content-visibility",
+    "performance:large-document-edits": "bun .a3s-test/performance/generate-fixtures.ts --documents-only && bun .a3s-test/performance/benchmark-document-edit.ts http://127.0.0.1:4175/playground/ 3",
+    "performance:large-documents": "bun .a3s-test/performance/generate-fixtures.ts --documents-only && bun .a3s-test/performance/benchmark.ts --url http://127.0.0.1:4175/playground/ --scenarios document-text,document-table --runs 3 --timeout-ms 180000",
+    "performance:large-spreadsheet-edits": "bun .a3s-test/performance/generate-fixtures.ts --spreadsheets-only && bun .a3s-test/performance/benchmark-spreadsheet-edit.ts http://127.0.0.1:4175/playground/ 3",
+    "performance:large-spreadsheets": "bun .a3s-test/performance/generate-fixtures.ts --spreadsheets-only && bun .a3s-test/performance/benchmark.ts --url http://127.0.0.1:4175/playground/ --scenarios spreadsheet --runs 5 --timeout-ms 180000",
+    "performance:pdf": "bun .a3s-test/performance/generate-fixtures.ts --pdf-only && bun .a3s-test/performance/benchmark-pdf.ts --url http://127.0.0.1:4175/playground/ --runs 3 --timeout-ms 120000",
+    "performance:presentation": "bun .a3s-test/performance/generate-fixtures.ts --presentations-only && bun .a3s-test/performance/benchmark-presentation.ts --url http://127.0.0.1:4175/playground/ --runs 3 --timeout-ms 120000 --modes default,content-visibility",
     "test": "rstest",
     "test:e2e": "bun run test:e2e:fixtures && a3s-test run tests/e2e/word-page-color.acl --json && a3s-test run tests/e2e/word-page-setup-phone.acl --json && a3s-test run tests/e2e/word-paragraph-layout-phone.acl --json && a3s-test run tests/e2e/word-list-formatting-phone.acl --json && a3s-test run tests/e2e/word-font-picker-phone.acl --json && a3s-test run tests/e2e/word-comments-drawer.acl --json && a3s-test run tests/e2e/word-comment-windowing.acl --json && a3s-test run tests/e2e/word-citations-phone.acl --json && a3s-test run tests/e2e/word-navigation-search.acl --json && a3s-test run tests/e2e/word-navigation-windowing.acl --json && a3s-test run tests/e2e/word-find-replace-phone.acl --json && a3s-test run tests/e2e/word-page-navigation.acl --json && a3s-test run tests/e2e/word-page-windowing.acl --json && a3s-test run tests/e2e/word-ai-question.acl --json && a3s-test run tests/e2e/word-picture-insert.acl --json && a3s-test run tests/e2e/word-picture-alt-text-phone.acl --json && a3s-test run tests/e2e/word-track-changes-phone.acl --json && a3s-test run tests/e2e/word-formatting-revision.acl --json && a3s-test run tests/e2e/word-paragraph-formatting-revision.acl --json && a3s-test run tests/e2e/word-document-comparison.acl --json && a3s-test run tests/e2e/word-review-conflict-phone.acl --json && a3s-test run tests/e2e/word-revision-windowing.acl --json && a3s-test run tests/e2e/word-table-phone.acl --json && a3s-test run tests/e2e/word-table-borders.acl --json && a3s-test run tests/e2e/word-theme-table.acl --json && a3s-test run tests/e2e/word-styled-table.acl --json && a3s-test run tests/e2e/word-multi-page-table.acl --json && a3s-test run tests/e2e/word-cross-reference-phone.acl --json && a3s-test run tests/e2e/word-bookmark-links-phone.acl --json && a3s-test run tests/e2e/word-notes-phone.acl --json && a3s-test run tests/e2e/word-fields-phone.acl --json && a3s-test run tests/e2e/spreadsheet-phone-rename.acl --json && a3s-test run tests/e2e/spreadsheet-phone-find.acl --json && a3s-test run tests/e2e/spreadsheet-phone-context-menu.acl --json && a3s-test run tests/e2e/spreadsheet-phone-task-pane.acl --json && a3s-test run tests/e2e/spreadsheet-maximum-sparse.acl --json && a3s-test run tests/e2e/spreadsheet-cell-style.acl --json && a3s-test run tests/e2e/spreadsheet-paste-special.acl --json && a3s-test run tests/e2e/spreadsheet-hyperlink.acl --json && a3s-test run tests/e2e/presentation-cut-paste-focus.acl --json && a3s-test run tests/e2e/presentation-presenter-view.acl --json && a3s-test run tests/e2e/presentation-phone-chart-pane.acl --json && a3s-test run tests/e2e/presentation-phone-comments.acl --json && a3s-test run tests/e2e/pdf-thumbnail-keyboard.acl --json && a3s-test run tests/e2e/pdf-page-drawer-phone.acl --json && a3s-test run tests/e2e/markdown-phone-modes.acl --json && a3s-test run tests/e2e/office-sidebar-breakpoint.acl --json && a3s-test run tests/e2e/office-docs-navigation.acl --json && a3s-test run tests/e2e/collaboration-playground-entry.acl --json && a3s-test run tests/e2e/collaboration-document-comments.acl --command-timeout-ms 120000 --json && a3s-test run tests/e2e/collaboration-document-suggestions.acl --command-timeout-ms 120000 --json && a3s-test run tests/e2e/collaboration-participants.acl --json && a3s-test run tests/e2e/collaboration-pdf-annotations.acl --json && a3s-test run tests/e2e/collaboration-spreadsheet-cells.acl --json && a3s-test run tests/e2e/collaboration-presentation-elements.acl --json",
     "test:e2e:check": "bun run test:e2e:fixtures && a3s-test check tests/e2e/word-page-color.acl --json && a3s-test check tests/e2e/word-page-setup-phone.acl --json && a3s-test check tests/e2e/word-paragraph-layout-phone.acl --json && a3s-test check tests/e2e/word-list-formatting-phone.acl --json && a3s-test check tests/e2e/word-font-picker-phone.acl --json && a3s-test check tests/e2e/word-comments-drawer.acl --json && a3s-test check tests/e2e/word-comment-windowing.acl --json && a3s-test check tests/e2e/word-citations-phone.acl --json && a3s-test check tests/e2e/word-navigation-search.acl --json && a3s-test check tests/e2e/word-navigation-windowing.acl --json && a3s-test check tests/e2e/word-find-replace-phone.acl --json && a3s-test check tests/e2e/word-page-navigation.acl --json && a3s-test check tests/e2e/word-page-windowing.acl --json && a3s-test check tests/e2e/word-ai-question.acl --json && a3s-test check tests/e2e/word-picture-insert.acl --json && a3s-test check tests/e2e/word-picture-alt-text-phone.acl --json && a3s-test check tests/e2e/word-track-changes-phone.acl --json && a3s-test check tests/e2e/word-formatting-revision.acl --json && a3s-test check tests/e2e/word-paragraph-formatting-revision.acl --json && a3s-test check tests/e2e/word-document-comparison.acl --json && a3s-test check tests/e2e/word-review-conflict-phone.acl --json && a3s-test check tests/e2e/word-revision-windowing.acl --json && a3s-test check tests/e2e/word-table-phone.acl --json && a3s-test check tests/e2e/word-table-borders.acl --json && a3s-test check tests/e2e/word-theme-table.acl --json && a3s-test check tests/e2e/word-styled-table.acl --json && a3s-test check tests/e2e/word-multi-page-table.acl --json && a3s-test check tests/e2e/word-cross-reference-phone.acl --json && a3s-test check tests/e2e/word-bookmark-links-phone.acl --json && a3s-test check tests/e2e/word-notes-phone.acl --json && a3s-test check tests/e2e/word-fields-phone.acl --json && a3s-test check tests/e2e/spreadsheet-phone-rename.acl --json && a3s-test check tests/e2e/spreadsheet-phone-find.acl --json && a3s-test check tests/e2e/spreadsheet-phone-context-menu.acl --json && a3s-test check tests/e2e/spreadsheet-phone-task-pane.acl --json && a3s-test check tests/e2e/spreadsheet-maximum-sparse.acl --json && a3s-test check tests/e2e/spreadsheet-cell-style.acl --json && a3s-test check tests/e2e/spreadsheet-paste-special.acl --json && a3s-test check tests/e2e/spreadsheet-hyperlink.acl --json && a3s-test check tests/e2e/presentation-cut-paste-focus.acl --json && a3s-test check tests/e2e/presentation-presenter-view.acl --json && a3s-test check tests/e2e/presentation-phone-chart-pane.acl --json && a3s-test check tests/e2e/presentation-phone-comments.acl --json && a3s-test check tests/e2e/pdf-thumbnail-keyboard.acl --json && a3s-test check tests/e2e/pdf-page-drawer-phone.acl --json && a3s-test check tests/e2e/markdown-phone-modes.acl --json && a3s-test check tests/e2e/office-sidebar-breakpoint.acl --json && a3s-test check tests/e2e/office-docs-navigation.acl --json && a3s-test check tests/e2e/collaboration-playground-entry.acl --json && a3s-test check tests/e2e/collaboration-document-comments.acl --json && a3s-test check tests/e2e/collaboration-document-suggestions.acl --json && a3s-test check tests/e2e/collaboration-participants.acl --json && a3s-test check tests/e2e/collaboration-pdf-annotations.acl --json && a3s-test check tests/e2e/collaboration-spreadsheet-cells.acl --json && a3s-test check tests/e2e/collaboration-presentation-elements.acl --json",
@@ -142,6 +142,8 @@
     "test:e2e:initial-focus:check": "a3s-test check tests/e2e/office-editor-initial-focus.acl --json",
     "test:e2e:docs": "a3s-test run tests/e2e/office-docs-navigation.acl --json",
     "test:e2e:docs:check": "a3s-test check tests/e2e/office-docs-navigation.acl --json",
+    "test:e2e:homepage": "A3S_TEST_SUITE=tests/e2e/homepage-editor-demo.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:homepage:check": "a3s-test check tests/e2e/homepage-editor-demo.acl --json",
     "test:e2e:latest-capabilities": "A3S_TEST_SUITE=tests/e2e/latest-capabilities-discoverability.acl bash scripts/run-a3s-test-web-gate.sh",
     "test:e2e:latest-capabilities:check": "a3s-test check tests/e2e/latest-capabilities-discoverability.acl --json",
     "test:e2e:collaboration-participants": "a3s-test run tests/e2e/collaboration-participants.acl --json",
@@ -307,15 +309,16 @@
     }
   },
   "devDependencies": {
+    "@a3s-lab/testkit": "0.6.2",
     "@biomejs/biome": "2.4.15",
     "@fontsource-variable/geist": "^5.3.0",
     "@fontsource-variable/geist-mono": "^5.3.0",
-    "@rspress/core": "^2.0.17",
-    "@rspress/shared": "2.0.19",
     "@playwright/test": "1.61.1",
     "@rsbuild/core": "^2.1.5",
     "@rsbuild/plugin-react": "^2.1.0",
     "@rslib/core": "^0.23.2",
+    "@rspress/core": "^2.0.17",
+    "@rspress/shared": "2.0.19",
     "@rstest/adapter-rslib": "^0.10.6",
     "@rstest/core": "^0.10.6",
     "@rstest/coverage-v8": "0.10.6",