@a3s-lab/office 0.36.0 → 0.37.1

package/README.md

@@ -56,7 +56,7 @@ workflows, and a separate Rust automation plane.
 
 ## Latest on `main`
 
-The `0.36.0` release exposes these capabilities as normal user-facing
+The `0.37.1` release exposes these capabilities as normal user-facing
 Playground templates, with matching implementation detail in the documentation:
 
 | Editor | Latest capability | Public entry |
@@ -68,7 +68,7 @@ Playground templates, with matching implementation detail in the documentation:
 | Writer | Native character shading with exact `w:shd` patterns, foreground/background color identity, explicit resets, authoring, and DOCX reopen | Playground **Latest capabilities → 字符底纹** · [Document reference](docs/latest/en/components/document.mdx#native-character-shading) |
 | Writer | Independent Latin, East Asian, and bidi proofing languages plus explicit `w:noProof` inclusion/exclusion | Playground **Latest capabilities → 校对语言** · [Document reference](docs/latest/en/components/document.mdx#native-proofing-languages) |
 | 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) |
-| Spreadsheet | Bounded structured-reference calculation plus automatic calculated-column fill for table names/display names, contiguous columns, header/data/totals selectors, qualified references, and table-local current-row formulas across Rust/WASM and JavaScript fallback | Playground **Latest capabilities → 结构化引用** · [Spreadsheet reference](docs/latest/en/components/spreadsheet.mdx#structured-reference-calculation) |
+| Spreadsheet | Native totals-row authoring with per-column aggregates, labels, custom formulas, filtered-row-aware `SUBTOTAL`, automatic calculated-column fill for newly inserted table body rows, and bounded structured-reference calculation across Rust/WASM and JavaScript fallback | Playground **Latest capabilities → 结构化引用** · [Totals-row reference](docs/latest/en/components/spreadsheet.mdx#native-totals-row-authoring) · [Structured-reference calculation](docs/latest/en/components/spreadsheet.mdx#structured-reference-calculation) |
 | 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 nine entries are reachable from the first Playground viewport. The
@@ -152,7 +152,8 @@ baseline rather than one specific release.
 | Formatting and style rendering | **Partial** — native fonts, colors, borders, alignment, number formats, cell styles, all 17 native non-solid OOXML pattern fills, native linear/path XLSX gradients, and one Format Cells surface that authors none, solid, pattern, or gradient fills with exact geometry and 2–256 ordered stops; static date/time entry, contrast-safe font preview, native XLSX rich-text runs, selected-text font formatting, direct formula-bar/F2 insertion or deletion, and bounded authenticated formatted-HTML paste | Disjoint multi-edit rich-text authoring, broader themes, locale formats, 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 plus bounded structured references (`Table[Column]`, contiguous ranges, `#All`/`#Headers`/`#Data`/`#Totals`/`#This Row`, and `[@Column]`) in the shared Rust/WASM and JavaScript paths | Wider functions, arrays, volatile semantics, and calculation parity |
-| Tables, pivots, charts, and rules | **Partial** — native tables, bounded structured-reference formulas, calculated-column formulas with automatic fill for newly inserted body rows, pivots, charts, conditional formatting, and common validation rules with complete input/error-setting authoring | Complete totals-row authoring, slicers, pivot charts, custom/dependent validation rules, advanced analysis, and broader browser alert flows |
+| Sort and filter | **Partial** — Traditional Office-style current-region expansion warnings for partial selections; Traditional Office-compatible top-to-bottom or left-to-right Custom Sort with stable value, custom-list, effective cell-color, effective font-color, and conditional-format icon keys; offline Simplified Chinese pinyin/stroke comparison, optional lowercase-before-uppercase case sensitivity, and lexical numeric text; seven built-in month/weekday sequences; bounded typed host-stored or mounted-session sequences; header retention for top-to-bottom sorting; top/bottom or left/right appearance placement; up to 64 ordered keys; blanks-last value behavior; axis-aware relative-formula translation; and one-step Undo; plus worksheet AutoFilter authoring, keyboard menus, common text/value/numeric/blank conditions, exactly two same-column conditions joined by AND or OR, native OOXML `*`/`?`/`~` wildcard expressions, negative prefix/suffix operators, tie-aware Top/Bottom item and percentage filters, locally evaluated above/below-average and complete native relative-date, month, and quarter dynamic families on typed 1900-system date cells, multi-column row ownership, manual-hide preservation, and native XLSX criteria round trips with imported dynamic-filter recomputation | Custom-list deletion/reordering UI, broader locale collation, source-level 1904 date-system retention for dynamic dates, large aggregate/rank Worker/WASM offload, and table/AutoFilter-integrated custom sorting |
+| Tables, pivots, charts, and rules | **Partial** — native tables, bounded structured-reference formulas, calculated-column formulas with automatic fill for newly inserted body rows, complete common totals-row authoring, pivots, charts, conditional formatting, and common validation rules with complete input/error-setting authoring | Slicers, pivot charts, custom/dependent validation rules, advanced analysis, and broader browser alert flows |
 | Large worksheets | **Supported with boundaries** — maximum-dimension sparse import/editing and viewport-bounded Canvas painting | Highly optimized native grid with hardware-dependent limits |
 | Files and printing | **Partial** — XLS/XLSX/ODS/CSV import, XLSX export, and PDF output | Broader round trips, external data, print fidelity, and legacy conversion |
 | External data, macros, and specialist analysis | **Gap** — active macros are never executed; bounded models are still needed for data connections and solver-like tools | Established data, macro/add-in, scenario, and optimization ecosystems |
@@ -216,6 +217,9 @@ is requested. The complete gap inventory and exit evidence live in the
   preserving spatial arrow-key navigation.
   Shared Office selects use 44 px phone option rows and bounded internal
   scrolling while retaining keyboard selection and exact focus restoration.
+  Host-provided file menus keep every action visually identifiable with an
+  explicit or neutral fallback icon, readable long labels, grouped destructive
+  actions, and a visible keyboard focus ring.
 - **Editor-scoped zoom** — Status controls and Ctrl/Cmd + mouse-wheel gestures
   share each surface's bounded zoom model without changing the host browser's
   page scale.
@@ -756,9 +760,15 @@ conflicting column fails closed and drops its automatic rule. XLSX
 `<calculatedColumnFormula>` metadata round-trips with the leading `=` restored
 in the controlled model, while unsafe or external formulas are omitted.
 The Playground's **结构化引用** template shows a calculated `Revenue` column,
-an insertion hint, a totals row, and a worksheet-qualified summary. Complete
-totals-row authoring, slicers, and external/query tables remain explicit
-boundaries.
+an insertion hint, an editable totals row, and a worksheet-qualified summary.
+The Table Design totals menu enables or disables the row and assigns each
+column a label, one of ten native aggregate functions, or a bounded custom
+formula. Native aggregates emit filtered-row-aware `SUBTOTAL` formulas; direct
+cell edits reconcile back into table metadata, table structure changes move
+the row without overwriting manual cells, and table renames rewrite only
+generated formulas. Dense and sparse worksheets, Yjs collaboration, and XLSX
+`totalsRowFunction`, `totalsRowLabel`, and `totalsRowFormula` round trips share
+the same model. Slicers and external/query tables remain explicit boundaries.
 
 Use `downloadArtifact` to start a browser download or
 `createArtifactBlob` when your application owns upload and persistence.
@@ -1641,6 +1651,8 @@ keep working without hard-coded return URLs.
 
 - [Live Playground](https://a3s-lab.github.io/Office/playground/)
 - [Documentation center](https://a3s-lab.github.io/Office/docs/)
+- [A3S Office 0.37.1 documentation](https://a3s-lab.github.io/Office/docs/0.37.1/)
+- [A3S Office 0.37.0 documentation](https://a3s-lab.github.io/Office/docs/0.37.0/)
 - [A3S Office 0.36.0 documentation](https://a3s-lab.github.io/Office/docs/0.36.0/)
 - [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~3557.js

@@ -1,4 +1,5 @@
 import { useEffect, useLayoutEffect, useMemo, useRef } from "react";
+import { isOfficeCompositionKeyboardEvent } from "./0~3635.js";
 import { matchesOfficeEditorKeyboardShortcut } from "./0~8136.js";
 const DEFAULT_EXTENSION_PRIORITY = 100;
 function createOfficeEditorExtension(config) {
@@ -97,7 +98,7 @@ function createOfficeEditorRuntime(initialContext, extensions, options = {}) {
         storage: Object.freeze(storage),
         can: ()=>canApi,
         handleKeyDown: (event)=>{
-            if (event.defaultPrevented) return false;
+            if (event.defaultPrevented || isOfficeCompositionKeyboardEvent(event)) return false;
             for (const instance of instances)for (const shortcut of instance.keyboardShortcuts)if (matchesOfficeEditorKeyboardShortcut(event, shortcut.shortcut) && shortcut.handler(readContext(), commandApi, canApi, event)) {
                 event.preventDefault();
                 return true;

package/dist/0~3635.js

@@ -314,10 +314,13 @@ function swatchForeground(color) {
 }
 const MODAL_DIALOG_SELECTOR = '[role="dialog"][aria-modal="true"]';
 const OFFICE_SHORTCUT_IGNORE_SELECTOR = '[data-office-shortcuts="ignore"]';
+function isOfficeCompositionKeyboardEvent(event) {
+    return event.isComposing || 'Process' === event.key || 229 === event.keyCode;
+}
 function isOfficeShortcutBlocked(target) {
     if ("u" < typeof document) return false;
     if (target instanceof Element && (target.closest(MODAL_DIALOG_SELECTOR) || target.closest(OFFICE_SHORTCUT_IGNORE_SELECTOR))) return true;
     if (document.activeElement instanceof Element && (document.activeElement.closest(MODAL_DIALOG_SELECTOR) || document.activeElement.closest(OFFICE_SHORTCUT_IGNORE_SELECTOR))) return true;
     return null !== document.querySelector(MODAL_DIALOG_SELECTOR);
 }
-export { OfficeColorPicker, isOfficeShortcutBlocked };
+export { OfficeColorPicker, isOfficeCompositionKeyboardEvent, isOfficeShortcutBlocked };

package/dist/0~7048.js

@@ -1352,6 +1352,13 @@ const browserScalarFunctionArities = new Map([
             1
         ]
     ],
+    [
+        'SUBTOTAL',
+        [
+            2,
+            255
+        ]
+    ],
     [
         'SUM',
         [
@@ -1372,6 +1379,90 @@ function normalizeSpreadsheetFunctionName(name) {
     while(normalized.startsWith('_XLFN.') || normalized.startsWith('_XLWS.'))normalized = normalized.slice(6);
     return normalized;
 }
+function evaluateParserSubtotal(parameters) {
+    const codeValue = parserNumericValue(parameters[0]);
+    if (void 0 === codeValue) return 'VALUE!';
+    const code = Math.trunc(codeValue);
+    const values = parameters.slice(1).flatMap((parameter)=>flattenParserValues(parameter));
+    for (const value of values){
+        const error = parserErrorValue(value);
+        if (error) return error;
+    }
+    switch(code){
+        case 1:
+        case 101:
+            return parserSubtotalNumeric(values, 'average');
+        case 2:
+        case 102:
+            return values.filter((value)=>'number' == typeof value).length;
+        case 3:
+        case 103:
+            return values.filter((value)=>null != value).length;
+        case 4:
+        case 104:
+            return parserSubtotalNumeric(values, 'max');
+        case 5:
+        case 105:
+            return parserSubtotalNumeric(values, 'min');
+        case 6:
+        case 106:
+            return parserSubtotalNumeric(values, 'product');
+        case 7:
+        case 107:
+            return parserSubtotalNumeric(values, 'stddev');
+        case 8:
+        case 108:
+            return parserSubtotalNumeric(values, 'stddevp');
+        case 9:
+        case 109:
+            return parserSubtotalNumeric(values, 'sum');
+        case 10:
+        case 110:
+            return parserSubtotalNumeric(values, 'var');
+        case 11:
+        case 111:
+            return parserSubtotalNumeric(values, 'varp');
+        default:
+            return 'VALUE!';
+    }
+}
+function parserSubtotalNumeric(values, operation) {
+    const numbers = values.filter((value)=>'number' == typeof value && Number.isFinite(value));
+    const count = numbers.length;
+    const sum = numbers.reduce((total, value)=>total + value, 0);
+    if ('sum' === operation) return finiteParserNumber(sum);
+    if ('average' === operation) return count ? finiteParserNumber(sum / count) : 'DIV/0!';
+    if ('max' === operation) return finiteParserNumber(Math.max(...numbers, 0));
+    if ('min' === operation) return finiteParserNumber(Math.min(...numbers, 0));
+    if ('product' === operation) return finiteParserNumber(count ? numbers.reduce((total, value)=>total * value, 1) : 0);
+    if ('stddev' === operation || 'var' === operation) {
+        if (count < 2) return 'DIV/0!';
+    } else if (0 === count) return 'DIV/0!';
+    const mean = sum / count;
+    const divisor = 'stddev' === operation || 'var' === operation ? count - 1 : count;
+    const variance = numbers.reduce((total, value)=>total + (value - mean) ** 2, 0) / divisor;
+    return finiteParserNumber('stddev' === operation || 'stddevp' === operation ? Math.sqrt(variance) : variance);
+}
+function flattenParserValues(value) {
+    if (!Array.isArray(value)) return [
+        value
+    ];
+    return value.flatMap((entry)=>flattenParserValues(entry));
+}
+function parserNumericValue(value) {
+    if ('number' == typeof value) return Number.isFinite(value) ? value : void 0;
+    if ('boolean' == typeof value) return value ? 1 : 0;
+    if ('string' != typeof value || !value.trim()) return;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : void 0;
+}
+function parserErrorValue(value) {
+    if (value instanceof Error) return value.message.startsWith('#') ? value.message.slice(1) : 'VALUE!';
+    return 'string' == typeof value && value.startsWith('#') ? value.slice(1) : void 0;
+}
+function finiteParserNumber(value) {
+    return Number.isFinite(value) ? value : 'NUM!';
+}
 function normalizeFormulaForFortuneParser(formula) {
     const source = formula.replace(/^=/, '');
     let output = '';
@@ -2154,10 +2245,11 @@ class JavaScriptSpreadsheetEvaluator {
         let unsupportedFunction;
         let materializedRangeCells = 0;
         parser.setFunction('IFERROR', evaluateParserIfError).setFunction('ROW', (parameters)=>parameters.length ? null : coordinate.row + 1).setFunction('COLUMN', (parameters)=>parameters.length ? null : coordinate.column + 1);
-        parser.on('callFunction', (name, parameters)=>{
+        parser.on('callFunction', (name, parameters, done)=>{
             const normalized = normalizeSpreadsheetFunctionName(name);
             const arity = browserScalarFunctionArities.get(normalized);
             if (!arity || parameters.length < arity[0] || parameters.length > arity[1]) unsupportedFunction ??= name.toUpperCase();
+            if ('SUBTOTAL' === normalized) done(evaluateParserSubtotal(parameters));
         });
         parser.on('callCellValue', (cell, _options, done)=>{
             const dependency = this.resolveCoordinate(indexed.sheet, cell);

package/dist/0~9073.js

@@ -1,7 +1,7 @@
 import { Fragment as jsx_runtime_Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Fragment, useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { createPortal } from "react-dom";
-import { ArrowUpRight, Check, ChevronDown, ChevronLeft, ChevronRight, ChevronUp, Eye, Minus, Plus } from "lucide-react";
+import { ArrowUpRight, Check, ChevronDown, ChevronLeft, ChevronRight, ChevronUp, Eye, File, Minus, Plus } from "lucide-react";
 import { WorkOfficeCollaborationParticipants, moveOfficeMenuFocus, Popover, matchesAriaKeyShortcuts, officeOverlayPortalRoot } from "./0~8136.js";
 const CONTEXT_MENU_MARGIN = 8;
 const CONTEXT_MENU_TAB_STOP_SELECTOR = 'a[href]:not([tabindex="-1"]), button:not(:disabled):not([tabindex="-1"]), input:not(:disabled):not([type="hidden"]):not([tabindex="-1"]), select:not(:disabled):not([tabindex="-1"]), textarea:not(:disabled):not([tabindex="-1"]), [contenteditable="true"]:not([tabindex="-1"]), [tabindex]:not([tabindex="-1"])';
@@ -1071,6 +1071,8 @@ function WorkOfficeFileMenu({ actions }) {
                                 type: "button",
                                 role: "menuitem",
                                 tabIndex: -1,
+                                className: action.danger ? 'danger' : void 0,
+                                "data-danger": action.danger ? 'true' : void 0,
                                 disabled: action.disabled,
                                 onClick: ()=>{
                                     close();
@@ -1080,9 +1082,12 @@ function WorkOfficeFileMenu({ actions }) {
                                     /*#__PURE__*/ jsx("span", {
                                         className: "work-office-file-action-icon",
                                         "aria-hidden": "true",
-                                        children: action.icon
+                                        children: action.icon ?? /*#__PURE__*/ jsx(File, {
+                                            size: 16
+                                        })
                                     }),
                                     /*#__PURE__*/ jsx("span", {
+                                        className: "work-office-file-action-label",
                                         children: action.label
                                     }),
                                     action.shortcut && /*#__PURE__*/ jsx("kbd", {

package/dist/0~presentation-editor.js

@@ -21,7 +21,7 @@ import { WorkspaceContextMenu, isWorkspaceContextMenuKeyboardEvent, WorkOfficeZo
 import { presentationAgentProposalTargets, SpreadsheetChartSeriesStyleEditor, applyPresentationAgentProposalChanges, normalizeOptionalOfficeNumber, SpreadsheetErrorBarEditor, useOfficeHistory, presentationNotesProposalTarget, presentationAgentSelection, SpreadsheetTrendlineEditor, presentationAgentMenuItems } from "./0~3539.js";
 import { slideTransitionDurationMilliseconds, workSlideAnimationIndex, workSlideAnimationForElement, remapWorkSlideAnimations, createWorkSlideTransition, workSlideTransitionsEqual, workSlideAnimationCues, initialWorkSlideAnimationCueIndex, normalizeWorkSlideAnimation, createWorkSlideAnimation, removeWorkSlideAnimationsForElements } from "./0~5809.js";
 import { createOfficeEditorExtension, useOfficeEditorRuntime, useOfficeEditorKeyboardShortcuts } from "./0~3557.js";
-import { isOfficeShortcutBlocked, OfficeColorPicker } from "./0~3635.js";
+import { isOfficeShortcutBlocked, OfficeColorPicker, isOfficeCompositionKeyboardEvent } from "./0~3635.js";
 import { normalizeDocumentHref, DOCUMENT_LINK_VALIDATION_MESSAGE } from "./0~work-document-links.js";
 import { showToast } from "./6489.js";
 import { scaledPresentationVisuals } from "./0~work-presentation-visual-scale.js";
@@ -4357,6 +4357,8 @@ function PresentationTextEditor({ autoFocus = false, element, onChange, onEditor
     const onEditorChangeRef = useRef(onEditorChange);
     const onExitEditingRef = useRef(onExitEditing);
     const onSelectionChangeRef = useRef(onSelectionChange);
+    const editorRef = useRef(null);
+    const compositionPublishTimerRef = useRef(null);
     const appliedSignatureRef = useRef(presentationTextElementSignature(element));
     const initialContentRef = useRef(presentationTextElementHtml(element));
     const initialFocusTargetRef = useRef("u" > typeof document && document.activeElement instanceof HTMLElement ? document.activeElement : null);
@@ -4368,6 +4370,30 @@ function PresentationTextEditor({ autoFocus = false, element, onChange, onEditor
     const extensions = useMemo(()=>createPresentationTextEditorExtensions(element.placeholder?.prompt ?? '输入文字'), [
         element.placeholder?.prompt
     ]);
+    const publishEditorValue = (current)=>{
+        const value = presentationTextValue(current, elementRef.current);
+        const signature = presentationTextElementSignature({
+            ...elementRef.current,
+            ...value
+        });
+        if (signature === appliedSignatureRef.current) return;
+        appliedSignatureRef.current = signature;
+        onChangeRef.current(value);
+    };
+    const cancelCompositionPublication = ()=>{
+        if (null === compositionPublishTimerRef.current) return;
+        window.clearTimeout(compositionPublishTimerRef.current);
+        compositionPublishTimerRef.current = null;
+    };
+    const publishCommittedComposition = ()=>{
+        cancelCompositionPublication();
+        compositionPublishTimerRef.current = window.setTimeout(()=>{
+            compositionPublishTimerRef.current = null;
+            const current = editorRef.current;
+            if (!current || current.isDestroyed || current.view.composing) return;
+            publishEditorValue(current);
+        }, 0);
+    };
     const editor = useEditor({
         extensions,
         content: initialContentRef.current,
@@ -4380,7 +4406,18 @@ function PresentationTextEditor({ autoFocus = false, element, onChange, onEditor
                 role: 'textbox',
                 spellcheck: 'true'
             },
+            handleDOMEvents: {
+                compositionstart: ()=>{
+                    cancelCompositionPublication();
+                    return false;
+                },
+                compositionend: ()=>{
+                    publishCommittedComposition();
+                    return false;
+                }
+            },
             handleKeyDown: (view, event)=>{
+                if (view.composing || isOfficeCompositionKeyboardEvent(event)) return false;
                 if ('Escape' !== event.key || !onExitEditingRef.current) return false;
                 const object = view.dom.closest('[data-slide-element-origin]');
                 event.preventDefault();
@@ -4390,18 +4427,17 @@ function PresentationTextEditor({ autoFocus = false, element, onChange, onEditor
             }
         },
         onCreate: ({ editor: current })=>{
+            editorRef.current = current;
             applyPresentationTextStoredMarks(current, elementRef.current);
         },
+        onDestroy: ()=>{
+            editorRef.current = null;
+            cancelCompositionPublication();
+        },
         onSelectionUpdate: ()=>onSelectionChangeRef.current?.(),
         onUpdate: ({ editor: current })=>{
-            const value = presentationTextValue(current, elementRef.current);
-            const signature = presentationTextElementSignature({
-                ...elementRef.current,
-                ...value
-            });
-            if (signature === appliedSignatureRef.current) return;
-            appliedSignatureRef.current = signature;
-            onChangeRef.current(value);
+            if (current.view.composing) return;
+            publishEditorValue(current);
         }
     });
     useEffect(()=>{