@a3s-lab/office 0.21.0 → 0.22.0

package/COLLABORATION_ROADMAP.md

@@ -2,7 +2,7 @@
 
 This roadmap defines one versioned collaboration protocol for every A3S Office
 editor and for native CLI/coding-agent clients. It complements `ROADMAP.md`,
-which tracks editor capability parity with WPS.
+which tracks editor capability parity with Traditional Office.
 
 ## Design invariants
 

package/README.md

@@ -22,11 +22,11 @@
   <a href="https://a3s-lab.github.io/Office/">Playground</a> ·
   <a href="https://a3s-lab.github.io/Office/docs/">Documentation</a> ·
   <a href="#quick-start">Quick start</a> ·
-  <a href="#five-format-native-surfaces">Editors</a> ·
+  <a href="#editor-capability-comparison">Editors</a> ·
   <a href="#real-time-collaboration">Collaboration</a> ·
   <a href="#native-automation">Automation</a> ·
   <a href="#architecture">Architecture</a> ·
-  <a href="ROADMAP.md">WPS gap roadmap</a> ·
+  <a href="ROADMAP.md">Capability roadmap</a> ·
   <a href="COLLABORATION_ROADMAP.md">Collaboration roadmap</a> ·
   <a href="CONTRIBUTING.md">Contributing</a>
 </p>
@@ -96,6 +96,86 @@ The images below are committed visual-regression baselines from the real
   </tr>
 </table>
 
+## Editor capability comparison
+
+The tables below compare capability families, not button counts or visual
+similarity. **Supported** means the editable path has deterministic tests or
+native round-trip evidence. **Partial** means a useful path exists with a
+documented fidelity boundary. **Gap** means no product-grade editable path
+exists yet. Traditional Office availability varies by application, platform,
+edition, and subscription; its column describes the conventional suite
+baseline rather than one specific release.
+
+### Document
+
+| Capability | A3S Office today | Traditional Office baseline |
+| --- | --- | --- |
+| Text, paragraphs, lists, and styles | **Supported** — structured editing, formatting, clipboard, format painter, and undo/redo | Mature authoring with a broader long-tail style catalog |
+| Page layout and rendering | **Partial** — sections, margins, page size, columns, headers/footers, fields, and live pagination | Desktop-grade pagination, print layout, and vector output |
+| Tables, pictures, and equations | **Partial** — rich table geometry, floating pictures, crop/wrap, and structured OMML | Broader drawings, text boxes, charts, WordArt, and SmartArt |
+| Comments, revisions, and collaboration | **Partial** — comments, suggestions, text/format revisions, decisions, Yjs presence, and host relay contracts | Full revision families plus integrated sharing and review services |
+| References and document generation | **Partial** — bookmarks, links, captions, cross-references, citations, notes, and common fields | TOC/index authoring, mail merge, compare/combine, and broader fields |
+| Ribbon and shortcuts | **Supported** — responsive Office-style ribbon and editor-scoped daily-writing shortcuts | Complete desktop shortcut and contextual-tool surface |
+| Very large documents | **Supported with boundaries** — bounded 100,000-block plain-document windows and measured edit/navigation budgets | Native-engine virtualization with device-dependent limits |
+| DOCX and PDF fidelity | **Partial** — source-aware DOCX preservation and live-layout raster PDF export | Broader legacy/OOXML compatibility and searchable vector PDF output |
+
+### Spreadsheet
+
+| Capability | A3S Office today | Traditional Office baseline |
+| --- | --- | --- |
+| Cells, sheets, navigation, and history | **Supported** — multiple sheets, sparse editing, search, clipboard, fill, and undo/redo | Mature grid workflows across desktop and web |
+| Formatting and style rendering | **Partial** — native fonts, colors, borders, alignment, number formats, cell styles, and static date/time entry | Broader themes, locale formats, rich text, and advanced style effects |
+| Ribbon and shortcuts | **Partial** — common Office-style Home/Data/View commands and grid-scoped shortcuts | Larger command catalog and platform-specific accelerators |
+| Formulas and recalculation | **Partial** — dependency-aware calculation and common formula paths | Wider functions, arrays, volatile semantics, and calculation parity |
+| 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 |
+| 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 |
+
+### Presentation
+
+| Capability | A3S Office today | Traditional Office baseline |
+| --- | --- | --- |
+| Slide and object editing | **Supported** — slide lifecycle, scene editing, multi-selection, grouping, transforms, and guides | Mature slide and drawing workflows |
+| Text, shapes, tables, charts, and images | **Partial** — typed editable objects with native import/export paths | Broader shapes, connectors, effects, SmartArt, and embedded chart editing |
+| Masters and layouts | **Partial** — import/export inheritance with editable common paths | Full visual master, layout, and placeholder authoring |
+| Transitions and timings | **Partial** — fade, push, wipe, split, cut, and click/automatic advance | Broader transition catalog and timing controls |
+| Animations and media | **Gap** — no production animation timeline, trigger model, audio, video, or recording path | Object animation, motion paths, media editing, and recording |
+| Slideshow and presenter workflows | **Supported** — current/beginning start, keyboard playback, notes, timer, and responsive presenter view | Rehearsal, recording, ink/laser, and richer multi-display controls |
+| Review and collaboration | **Partial** — comments, shared presence, remote object locations, and host transport | Threads, assignments, mentions, and integrated cloud review |
+| PPTX, print, PDF, and video | **Partial** — PPTX round trip plus slide/notes/handout PDF models; no video export | Broader print controls, vector fidelity, media preservation, and video export |
+
+### PDF
+
+| Capability | A3S Office today | Traditional Office baseline |
+| --- | --- | --- |
+| Rendering and navigation | **Supported** — PDFium pages, thumbnails, zoom, keyboard navigation, and bounded long-file windows | Mature desktop/web viewing and navigation |
+| Search and text evidence | **Supported with boundaries** — browser search and bounded native text-layer evidence | Broader tagged-PDF reading order and accessibility extraction |
+| Annotations, forms, and save | **Supported** — common annotations, appearance controls, form filling, history, and save | Broader stamps, measurements, form authoring, scripts, and signatures |
+| Existing text, image, and object editing | **Gap** — no safe production content-stream editing path | Direct text/object editing with font and layout recovery |
+| Page organization | **Gap** — insert, delete, rotate, reorder, extract, merge, and split are not yet editable | Complete page organization workflows |
+| Compression, conversion, and OCR | **Gap / host boundary** — provider contracts are required for authoritative conversion and OCR | Integrated optimization, conversion, and scanned-document recognition |
+| Signatures, protection, and redaction | **Gap / host boundary** — trusted identity and destructive-content guarantees are required | E-signing, certificate validation, encryption, sanitization, and true redaction |
+| AI and real-time collaboration | **Host-owned** — typed page/text evidence, Yjs review records, presence, and provider-neutral ports | Typically bundled with account, storage, and model services |
+
+### Markdown
+
+Markdown is an A3S Office differentiator rather than a parity target.
+
+| Capability | A3S Office today | Traditional Office baseline |
+| --- | --- | --- |
+| Source and visual editing | **Supported** — GFM source, visual mode, synchronized split preview, and source-native history | No standard first-class Markdown editor |
+| Tables, tasks, links, images, and code | **Supported** — format-native Markdown structures in both editing modes | Usually represented through rich-document conversion or plain text |
+| Responsive UI and shortcuts | **Supported** — desktop split view, phone single-surface modes, and editor-scoped formatting | Depends on a text editor, add-in, or conversion workflow |
+| Collaboration | **Supported** — Yjs content, Awareness presence, remote selections, and host-owned transport | Usually available only after conversion into a cloud document format |
+| Import, export, and automation | **Supported** — direct Markdown round trip plus typed browser, CLI, MCP, and agent mutations | No shared native Markdown automation contract |
+
+Document and Markdown accept public TipTap Extensions. Spreadsheet,
+Presentation, and PDF expose stable host ports rather than private command
+contexts. Editor engines and large runtime assets load only when their surface
+is requested. The complete gap inventory and exit evidence live in the
+[capability roadmap](ROADMAP.md).
+
 ## Why A3S Office
 
 - **Product-native UI** — Complete Office-style surfaces with no required
@@ -397,274 +477,6 @@ into the PDF; searchable text and vector output remain future fidelity work.
 Copyable React, Vue, and Web Component examples live in the
 [component documentation](https://a3s-lab.github.io/Office/docs/components/).
 
-## Five format-native surfaces
-
-Each surface keeps a canonical model that matches its file format and user
-interaction model.
-
-- **Document** — Pagination, sections, focused page-setup tabs, clean page
-  margins with on-demand header/footer editing, outline navigation with
-  contextual full-text results, keyboard-operated live physical-page raster
-  thumbnails with viewport-bounded capture, and shared virtualized
-  long-document windows for page buttons, heading rows, full-text results, and
-  tracked-revision and anchored-comment review that preserve native scroll
-  distance, sparse current/selection/draft pins, and Home/End reachability;
-  a WPS-familiar command catalog, quick-access undo and redo, a priority-aware
-  adaptive and persistently collapsible ribbon whose tabs can temporarily
-  expose commands; WPS-oriented Insert groups and direct Page Layout presets
-  for margins, orientation, paper size, and columns, with matching advanced
-  Page Setup destinations; WPS-oriented References, Review, and View groups,
-  direct tracked-change navigation and decisions, contextual object tabs, and
-  viewport-calculated 100%, one-page, and page-width zoom; an actionable status
-  bar with live word-count details, WPS `Ctrl+Shift+G`, keyboard-traversable
-  view and zoom controls, and compact Web prioritization; editor-scoped WPS
-  formatting, paragraph, style, and review shortcuts, plus a permission-free
-  formatting clipboard and one-shot format painter shared with compatible
-  header and footer formatting, paragraph styles and phone-sized
-  paragraph-spacing and pagination controls
-  with touch targets and exact invoker-focus restoration; stable compact-ribbon
-  edge paging and viewport-bounded list galleries with touch-sized numbering
-  actions, selection-preserving bullet and numbering commands, and explicit
-  Escape-to-invoker focus restoration;
-  grouped bundled, common system, monospace, imported, and host-provided font
-  choices with live typeface previews, independent table layout algorithms,
-  auto, percentage, or pixel preferred widths, left/center/right placement,
-  indentation, table-level cell margins, cell-level margin overrides, and
-  rendered column measurements for autofit tables. One Table Properties dialog
-  presents table, row, column, and cell tabs. It combines preferred width,
-  placement, and indent with selected-row height and pagination, current-column
-  width, and selected-cell vertical alignment and margins. The complete draft
-  commits in one TipTap transaction and one undo record while untouched imported
-  measurements and partial margin inheritance retain their exact source values.
-  Cancel and Escape discard the draft and restore the exact ribbon invoker;
-  compact layouts keep tabs, numeric steppers, and footer actions touch-sized. A
-  contextual Picture Properties workflow combines centimeter width and height,
-  a per-image aspect-ratio lock, inline/square/top-and-bottom wrapping,
-  alignment, text distance, and alternative text. It commits only changed
-  fields in one TipTap history entry, preserves untouched imported dimensions
-  exactly, and retains the image selection and invoker focus after apply,
-  cancel, or Escape on desktop and phone layouts. A
-  reusable table-border pen with all, outside, inside, and individual-edge
-  targets, per-edge DOCX border preservation, and bounded `basedOn` table-style
-  inheritance with whole-table, banded row or column, first/last row or column,
-  and corner-cell formatting. Conditional fills, borders, bold, italic,
-  underline, strikethrough, fonts, and text colors are materialized before
-  direct table, cell, paragraph, and run formatting. Conditional paragraph
-  alignment, direction, indents, spacing and line rules, pagination rules, and
-  tab stops use the same precedence chain. Paragraph shading follows document
-  defaults, based-on paragraph styles, conditional table styles, and direct
-  formatting in that order. The complete Word `w:shd` pattern set, independent
-  foreground/background colors, `auto`, `nil` resets, and independently tinted
-  or shaded theme references remain structured through body and page-chrome
-  HTML; browser previews use bounded CSS masks while DOCX export restores the
-  native pattern and both theme channels. Preview follows Word's tint-over-shade
-  precedence when both transforms occur on one theme channel while retaining
-  both attributes for export. Malformed, duplicated,
-  namespace-spoofed, relationship-bound, or unresolved theme values fail closed
-  instead of inheriting stale shading. Theme tint and shade values resolve for
-  table borders and cell fills across edit, preview, and RGB-stable export.
-  Paragraph borders use the same precedence chain and retain the complete
-  `w:pBdr` model: schema-ordered `top`, `left`, `bottom`, `right`, `between`,
-  and facing-page `bar` edges; all 197 line and art styles; direct, automatic,
-  and theme colors; eighth-point or point widths; spacing; shadow; and frame.
-  Physical edges remain editable CSS, while art, between-paragraph, and
-  facing-page behavior uses a bounded browser approximation; DOCX export
-  restores the exact native edge set and attributes. Direct CSS edits replace
-  only the edited edge's theme binding, strict and transitional namespaces are
-  accepted, and malformed order, duplicates, spoofed namespaces, unsafe
-  attributes, invalid measures, and unresolved themes fail closed.
-  Splittable table rows that exceed a full physical page
-  continue at paragraph boundaries with repeated heading rows on every page,
-  viewport-safe comment drafting and focus-preserving citation drafts, tracked
-  changes, notes,
-  pointer- and Shift+F10-accessible host-defined selection menus, and shared
-  edit/preview/PDF typography and page-chrome placement. Editing, read-only
-  preview, and browser PDF export share one live pagination result. Tail edits
-  reuse the stable physical-page prefix, including resolved first/odd/even
-  headers, footers, page numbers, and navigation descriptors. Browser DOM
-  measurement runs in bounded 32 ms slices and yields only between top-level
-  blocks; document edits abort stale passes before a snapshot is committed, so
-  long repagination work does not monopolize the browser event loop.
-  Real DOCX fixtures provide deterministic A3S Test evidence for inherited
-  table styling across edit and preview, a centered 62.5% table with table and
-  cell margin overrides, all four Table Properties tabs at 390 px, exact
-  preservation of untouched cell-margin edges, a complete 390 px Picture
-  Properties flow, and a 120-paragraph row across three physical pages through
-  the final table content and following paragraph.
-  A direct-formatting A4 fixture also runs through a real WPS Writer PDF export
-  and a page-only browser comparison. Its automatic line spacing, paragraph
-  gaps, centered fixed table, row heights, borders, fills, and cell margins
-  stay within the checked one-pixel layout-landmark budget while preserving
-  the original OOXML line multiples for DOCX export.
-  Separate 30-row common-font, 36-row CJK-font, 18-row document-grid, and
-  30-row multilingual-script matrices now gate text-band positions against
-  WPS. DOCX import selects the Word `ascii`, `hAnsi`, `eastAsia`, or `cs` font
-  slot from the run script, including complex-script bold, italic, size, and
-  RTL overrides. The browser keeps the measured per-font automatic-line
-  advance, while DOCX round trips retain the section `docGrid` type and line
-  pitch and each run's `snapToGrid` override.
-  _DOCX import/export; PDF export._
-- **Markdown** — GFM source, visual editing, synchronized and resizable split
-  preview, source-native undo/redo with typing coalescing and selection restore,
-  source-aware ribbon formatting and shortcuts, empty-source guidance, task
-  lists, tables, links, images, code, a flat reading surface with a comfortable
-  line length, and keyboard-accessible host-defined selection menus across both
-  editing surfaces. At phone widths, Source and Preview each use the complete
-  workspace instead of being compressed into two stacked panes. _Markdown
-  import/export._
-- **Spreadsheet** — Multiple sheets, formulas, dependency-aware recalculation,
-  live selection statistics, an A3S-owned worksheet bar with lifecycle and
-  color controls, safe deletion confirmation, in-place rename validation, a
-  grid-aligned single-row responsive workbook footer that keeps the active
-  worksheet and its actions visible across window and phone-width changes,
-  selection-preserving undo/redo, deterministic Arrow, Enter, Tab, Home,
-  PageUp/PageDown, row, column, and all-cells selection shortcuts, Cmd/Ctrl
-  formatting through root-scoped capture before vendor grid listeners, an
-  WPS-style Home and Editing Find and Select menu whose editor-owned
-  `Cmd/Ctrl+F` search finds displayed values, raw values, formulas, and sparse
-  cells without opening browser Find, plus view-only `Ctrl+G` and `F5` Go To
-  for direct, quoted cross-sheet, and named ranges without content updates,
-  Undo records, or sparse materialization, with a viewport-safe phone Find
-  layout, touch-sized controls, bounded validation, and exact focus restoration,
-  desktop workbook task panes that become focus-contained phone dialogs with
-  an inert workbook background and exact ribbon-invoker restoration,
-  a WPS-familiar command catalog and tab order, quick-access Undo and Redo,
-  a priority-aware adaptive and collapsible ribbon with temporary tab
-  expansion, an executable Home clipboard group whose Paste, Cut, and Copy
-  commands share the permission-resilient local fallback with their WPS
-  shortcuts, a WPS-style Paste split command with quick All, Values, Formulas,
-  and Formatting actions plus `Cmd/Ctrl+Alt+V` Paste Special for ten content
-  modes, arithmetic operations, Skip blanks, Transpose, translated formula
-  references, rich same-editor styles/comments/validation/merges/column widths,
-  bounded TSV fallback, one-step Undo, and fail-closed protected or unsafe
-  targets, an Insert and Links Hyperlink command with grid-scoped `Cmd/Ctrl+K`,
-  accessible Web page, cell-range, and worksheet targets, explicit Edit and
-  Remove, immutable dense/sparse updates, content/style/comment preservation,
-  exact focus restoration, one-step Undo, and fail-closed unsafe, hidden,
-  protected, pivot, or out-of-bounds targets, a Data and Data Tools Validation
-  command for lists, whole numbers, decimals, dates, and text length across
-  multiple ranges, compact rule writes and removal, input messages,
-  invalid-input blocking, 1900/1904-aware XLSX date round trips, exact focus
-  restoration, one-step Undo, and fail-closed protected, merged, pivot,
-  read-only, invalid, out-of-bounds, or over-10,000-cell targets, native
-  Spreadsheet Tables/ListObjects through Insert and grid-scoped `Cmd/Ctrl+T`,
-  bounded current-region or explicit-range creation, canonical unique headers,
-  a contextual Table Design ribbon with editable names, 60 OOXML
-  Light/Medium/Dark styles, first/last-column emphasis and row/column stripes,
-  visible-range Canvas styling, sparse-safe Convert to Range, row/column
-  reconciliation, native XLSX table parts and supported filters, one-step Undo,
-  browser/Yjs record convergence, and fail-closed overlap, merge, AutoFilter,
-  protection, pivot, invalid, or over-100,000-cell targets, a WPS-style
-  Format Painter with
-  single-use and double-click locked
-  sessions, cross-sheet range-pattern tiling, Escape cancellation, and native
-  style-only writes, Home and Font Grow/Shrink Font commands with
-  `Cmd/Ctrl+Shift+.` / `Cmd/Ctrl+]` and `Cmd/Ctrl+Shift+,` / `Cmd/Ctrl+[` aliases,
-  per-cell mixed-size stepping, native rectangle compaction, a 10,000-cell
-  bound, and one-step Undo, a WPS-style Underline split control with single,
-  double, single-accounting, and double-accounting styles, exact Format Cells
-  and XLSX round trips, active-style-aware `Cmd/Ctrl+U` toggling, and WPS
-  `Ctrl+2`, `Ctrl+3`, and `Ctrl+4` aliases for Bold, Italic, and Underline;
-  Automatic Color and No Fill remove direct text and background colors instead
-  of hard-coding replacements, a
-  keyboard-accessible WPS Text Orientation menu with horizontal, both 45-degree
-  angles, stacked vertical, rotate-up, and rotate-down choices, exact Fortune
-  `rt` / `tr='3'` and OOXML 0–180 / 255 round trips, a 10,000-cell guard, and
-  one-batch Undo, plus a cell-border split control with side, all,
-  outside, inside, horizontal, vertical, clear, independent diagonal-down and
-  diagonal-up targets, crossed-border composition, ten native line styles,
-  exact color selection, compact overlapping range writes, exact OOXML
-  direction preservation through Paste Special, Yjs, XLSX export, and reopen,
-  `Cmd/Ctrl+Shift+&` Outside Borders and `Cmd/Ctrl+Shift+_` Clear Borders,
-  single-update undo, and grid-focus restoration, Conditional Formatting under
-  Home and Styles, executable
-  sorting plus WPS-style AutoFilter under Data, finite current-region discovery,
-  `Cmd/Ctrl+Shift+L` toggling, an `Alt+ArrowDown` keyboard filter menu,
-  a Home and Cells Rows and Columns menu for inserting above, below, left, or
-  right, deleting selected rows or columns, and hiding or unhiding rows and
-  columns through the shared structure command port, including grid-scoped
-  `Cmd/Ctrl+9`, `Cmd/Ctrl+0`, `Cmd/Ctrl+Shift+9`, and `Cmd/Ctrl+Shift+0`
-  shortcuts with 10,000-row and 1,000-column allocation guards, a Home and
-  Alignment Merge and Center split control with
-  Merge Cells, Merge Across, Unmerge Cells, Unmerge and Fill, and the WPS
-  `Ctrl+M` shortcut through one controlled native workbook batch,
-  a Home and Editing Clear menu for independently removing content, formats,
-  comments, hyperlinks, or all cell state while preserving merge geometry,
-  with Delete and Backspace mapped to Clear Contents,
-  a Home and Editing Fill menu for Down, Right, Up, and Left with native
-  relative-formula and style propagation, WPS `Cmd/Ctrl+D` and `Cmd/Ctrl+R`
-  shortcuts, one-step history, protected-range preflight, a 50,000-target-cell
-  guard, and sparse-row-safe execution,
-  a WPS AutoSum split command before Fill with Sum, Average, Count, Maximum,
-  and Minimum, the editor-scoped `Alt+=` Sum shortcut, contiguous source
-  inference above or left of a blank target, multi-formula totals rows and
-  columns, target-style preservation, merged/protected/read-only/pivot and
-  overwrite preflight, a 1,000-formula bound, sparse-safe native batches, and
-  one-step history,
-  Home and Number presets for General, Number, CNY Currency, Accounting,
-  Percentage, Short Date, Time, Scientific, Fraction, and Text, including the
-  seven standard `Cmd/Ctrl+Shift` format shortcuts, exact XLSX format-code
-  round trips, value/formula preservation, and one-step history, plus
-  10,000-cell-bounded Increase/Decrease Decimal commands that retain every
-  cell's format family across mixed selections and commit one native batch,
-  a WPS-style Format Cells dialog under Home and Number with the editor-scoped
-  `Cmd/Ctrl+1` shortcut, functional Number, Alignment, Font, Border, Fill, and
-  Protection tabs, untouched mixed-value preservation, custom native number
-  codes, compact protection ranges, dense/sparse representation retention,
-  bounded blank-cell materialization, one controlled update and one Undo
-  record per Apply, and exact launcher or remounted-grid focus restoration,
-  a Home and Styles gallery with 17 WPS built-in cell styles grouped as Common,
-  Data and Model, and Titles and Totals, true native previews, two-dimensional
-  keyboard navigation, a 10,000-cell bound, blank-cell styling, per-cell border
-  semantics, current-style recognition without private markers, one-step
-  history, and direct XLSX font, fill, alignment, wrap, rotation, border, and
-  number-format XF round trips; imported theme, indexed, automatic, and tint
-  identities for direct font, solid-fill, and border colors survive unrelated
-  edits and Yjs transport when the rendered RGB and palette slot still agree,
-  while changed or conflicting colors safely export as explicit RGB,
-  a View and Window Freeze Panes menu for current-cell, top-row, first-column,
-  and unfreeze patterns with XLSX round trips, and visible F9 workbook
-  recalculation,
-  Shift+F11 creation, Ctrl/Cmd+PageUp/PageDown switching in edit and read-only
-  preview,
-  one shared cell/worksheet context-menu surface with executable shortcut
-  hints that becomes a touch-sized, scrollable bottom action sheet on phones,
-  keyboard-operated cells and sheet tabs, direct type-to-edit,
-  permission-resilient multi-cell cut/copy/paste, clear, F2 editing, and
-  focus-safe Escape behavior, direct
-  font-family, vertical-alignment, text-wrap, number-format, and decimal
-  controls, charts, validation, protection, comments, and print settings.
-  _XLSX, XLS, ODS, and CSV import; XLSX and PDF export._
-- **Presentation** — Typed slide scene graph, multi-selection, groups, object
-  transforms, keyboard-accessible table-size insertion, Shift+F10-accessible
-  native slide and object context actions, guides, comments, transitions,
-  editor-scoped formatting and clipboard shortcuts that restore the selected
-  object, a docked desktop chart inspector that becomes a focus-contained modal
-  surface whenever it overlays the canvas, docked desktop comment review that
-  becomes a readable, touch-sized, focus-contained full-editor modal on phones
-  with dirty-draft cancellation and exact invoker restoration, a dismissible
-  phone slide navigator, a top-aligned phone canvas with a priority-aware status
-  bar, one-step slideshow from the beginning or current slide,
-  keyboard-complete playback, and a responsive presenter view with one
-  navigation strip, current/next context, speaker notes, and a session timer.
-  _PPTX import/export; PDF export._
-- **PDF** — PDFium rendering, navigation, search, form filling, annotations,
-  annotation color, opacity, compatible stroke-width controls, history,
-  a scrollable page-thumbnail rail with current-page synchronization and
-  focus-synchronized Arrow/Home/End navigation, a 32-thumbnail hard window,
-  cancellation of stale PDFium bitmap tasks, bounded main-page rendering for
-  long files, and a dismissible page drawer whose phone trigger stays in the
-  page controls instead of covering PDF content,
-  focus-safe page and search drafts, responsive search-result, navigation, and
-  zoom controls, editor-scoped shortcuts, and a keyboard-operated overflow menu
-  that retains secondary annotation tools and appearance settings on phones.
-  _PDF open/save._
-
-Document and Markdown accept public TipTap Extensions. Spreadsheet,
-Presentation, and PDF expose stable host ports rather than their internal
-command contexts. Editor engines and large runtime assets load only when that
-surface is requested.
-
 ## Controlled by design
 
 A3S Office is headless at the product boundary, not at the UI boundary. The
@@ -1495,10 +1307,10 @@ minor release may still include breaking model changes. Required migrations
 will be called out in the [changelog](CHANGELOG.md).
 
 The project targets predictable browser editing and file preservation, not
-pixel parity with every Microsoft Office or WPS feature. Unsupported OOXML
-semantics and fidelity gaps remain explicit compatibility boundaries instead
-of being silently approximated. Track product depth and release evidence in
-the [editor quality roadmap](docs/latest/en/editor-quality-roadmap.md).
+pixel parity with every Traditional Office feature. Unsupported OOXML semantics
+and fidelity gaps remain explicit compatibility boundaries instead of being
+silently approximated. Track product depth and release evidence in the
+[editor quality roadmap](docs/latest/en/editor-quality-roadmap.md).
 
 ## Development
 
@@ -1535,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.22.0 documentation](https://a3s-lab.github.io/Office/docs/0.22.0/)
 - [A3S Office 0.21.0 documentation](https://a3s-lab.github.io/Office/docs/0.21.0/)
 - [A3S Office 0.20.0 documentation](https://a3s-lab.github.io/Office/docs/0.20.0/)
 - [A3S Office 0.19.0 documentation](https://a3s-lab.github.io/Office/docs/0.19.0/)

package/dist/0~6090.js

@@ -257,6 +257,7 @@ function shortcutCodeKey(code) {
     if ('Space' === code) return 'space';
     if ('Equal' === code) return 'equal';
     if ('Minus' === code) return 'minus';
+    if ('Semicolon' === code) return ';';
     if ('Comma' === code) return ',';
     if ('Period' === code) return '.';
     return null;

package/dist/0~spreadsheet-editor.js

@@ -1,7 +1,7 @@
 import { __webpack_require__ } from "./0~rslib-runtime.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Workbook } from "@fortune-sheet/react";
-import { AArrowDown, AArrowUp, AlignCenter, AlignLeft, AlignRight, AlignVerticalJustifyCenter, AlignVerticalJustifyEnd, AlignVerticalJustifyStart, ArrowDown, ArrowDownToLine, ArrowLeft, ArrowLeftToLine, ArrowRight, ArrowRightToLine, ArrowUp, ArrowUpToLine, BadgeJapaneseYen, BarChart3, BetweenHorizontalEnd, BetweenHorizontalStart, BetweenVerticalEnd, BetweenVerticalStart, Bold, Bookmark, Calculator, Check, ChevronDown, ChevronLeft, ChevronRight, ClipboardPaste, Cloud, Columns3, Copy, CopyPlus, DecimalsArrowLeft, DecimalsArrowRight, Eraser, Eye, EyeOff, FileX2, Globe2, Grid2X2, Grid3X3, Hash, Italic, KeyRound, Layers2, Link2, Link2Off, ListChecks, ListFilter, LocateFixed, Merge, MessageSquareX, MoveHorizontal, MoveVertical, Paintbrush, Palette, PanelLeft, PanelTop, PanelsTopLeft, Pencil, Percent, Plus, Printer, Redo2, RefreshCw, Rows3, Save, Scissors, Search, Settings2, ShieldCheck, Sigma, SortAsc, SortDesc, Strikethrough, SwatchBook, Table2, TableProperties, Trash2, Underline, Undo2, WrapText, X } from "lucide-react";
+import { AArrowDown, AArrowUp, AlignCenter, AlignLeft, AlignRight, AlignVerticalJustifyCenter, AlignVerticalJustifyEnd, AlignVerticalJustifyStart, ArrowDown, ArrowDownToLine, ArrowLeft, ArrowLeftToLine, ArrowRight, ArrowRightToLine, ArrowUp, ArrowUpToLine, BadgeJapaneseYen, BarChart3, BetweenHorizontalEnd, BetweenHorizontalStart, BetweenVerticalEnd, BetweenVerticalStart, Bold, Bookmark, Calculator, CalendarClock, CalendarDays, Check, ChevronDown, ChevronLeft, ChevronRight, ClipboardPaste, Clock, Cloud, Columns3, Copy, CopyPlus, DecimalsArrowLeft, DecimalsArrowRight, Eraser, Eye, EyeOff, FileX2, Globe2, Grid2X2, Grid3X3, Hash, Italic, KeyRound, Layers2, Link2, Link2Off, ListChecks, ListFilter, LocateFixed, Merge, MessageSquareX, MoveHorizontal, MoveVertical, Paintbrush, Palette, PanelLeft, PanelTop, PanelsTopLeft, Pencil, Percent, Plus, Printer, Redo2, RefreshCw, Rows3, Save, Scissors, Search, Settings2, ShieldCheck, Sigma, SortAsc, SortDesc, Strikethrough, SwatchBook, Table2, TableProperties, Trash2, Underline, Undo2, WrapText, X } from "lucide-react";
 import { Fragment as external_react_Fragment, cloneElement, memo, useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { genarate, indexToColumnChar, update as core_update } from "@fortune-sheet/core";
 import { freezeImportedSpreadsheetCell, spreadsheetTextOrientationFromChoice, spreadsheetMatrixProfile, withoutEditableRange, spreadsheetTextOrientationFromAngle, isSpreadsheetTextOrientationId, normalizeSpreadsheetConditionalVisualOptions, spreadsheetCellValueWithDiagonalBorder, spreadsheetUnderlineCellValue, effectiveSpreadsheetPageSetup, attachSpreadsheetShownCommentCells, withEditableRange, sameSpreadsheetHistoryValue, createOfficeSpreadsheetCollaborationBinding as createWorkOfficeSpreadsheetCollaborationBinding, isSpreadsheetConditionalComparisonOperator, spreadsheetConditionalIconForValue, defaultSpreadsheetConditionalIconThresholds, spreadsheetUnderlineStyle, normalizeSpreadsheetDateValidationBoundary, sheetProtectionAuthority, editableRangeCellCount, unlockedCellCount, registerDerivedSpreadsheetMatrix, editableRangeRequiresCredentials, spreadsheetTextOrientationCellStyle, normalizeSpreadsheetConditionalIconSetFormat, defaultSpreadsheetDataBarOptions, spreadsheetConditionalThresholdValue, spreadsheetTextOrientationChoiceFromCell, normalizeSheetProtectionAuthority, withSheetProtection, defaultSpreadsheetColorScaleThresholds, spreadsheetProtectionKey, spreadsheetDiagonalBorderFromCellValue, SPREADSHEET_CONDITIONAL_ICON_SETS, protectedSheetCount, withSheetSelectionPermissions, SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS, spreadsheetConditionalComparisonNeedsUpperValue, drawSpreadsheetConditionalIcon, spreadsheetTextOrientationFromCell, replaceOfficeSpreadsheetCollaboration as replaceWorkOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration as readWorkOfficeSpreadsheetCollaboration, spreadsheetConditionalThresholdsEqual, isSpreadsheetUnderlineStyle, spreadsheetVisibleTextRotationFromCell } from "./5045.js";
@@ -3236,6 +3236,38 @@ const spreadsheetCommandCatalog = {
             group: 'number'
         }
     },
+    insertCurrentDate: {
+        id: 'number.insertCurrentDate',
+        label: '插入当前日期',
+        location: {
+            area: 'ribbon',
+            tab: 'home',
+            group: 'number'
+        },
+        shortcut: {
+            label: 'Ctrl+;',
+            aria: 'Control+;',
+            editor: [
+                'Control-;'
+            ]
+        }
+    },
+    insertCurrentTime: {
+        id: 'number.insertCurrentTime',
+        label: '插入当前时间',
+        location: {
+            area: 'ribbon',
+            tab: 'home',
+            group: 'number'
+        },
+        shortcut: {
+            label: 'Ctrl+Shift+;',
+            aria: 'Control+Shift+;',
+            editor: [
+                'Control-Shift-;'
+            ]
+        }
+    },
     formatCells: {
         id: 'number.formatCells',
         label: '设置单元格格式',
@@ -6036,6 +6068,207 @@ function clampSpreadsheetDataValidationFocus(value, range) {
     const focus = 'number' == typeof value && Number.isFinite(value) ? Math.trunc(value) : minimum;
     return Math.min(maximum, Math.max(minimum, focus));
 }
+const MAX_SPREADSHEET_ROWS = 1048576;
+const spreadsheetPasteContentOptions = [
+    {
+        value: 'all',
+        label: '全部',
+        richOnly: false
+    },
+    {
+        value: 'formulas',
+        label: '公式',
+        richOnly: false
+    },
+    {
+        value: 'values',
+        label: '值',
+        richOnly: false
+    },
+    {
+        value: 'formats',
+        label: '格式',
+        richOnly: true
+    },
+    {
+        value: 'comments',
+        label: '批注',
+        richOnly: true
+    },
+    {
+        value: 'validation',
+        label: '数据验证',
+        richOnly: true
+    },
+    {
+        value: 'all-except-borders',
+        label: '边框除外的全部',
+        richOnly: true
+    },
+    {
+        value: 'formulas-and-number-formats',
+        label: '公式和数字格式',
+        richOnly: true
+    },
+    {
+        value: 'values-and-number-formats',
+        label: '值和数字格式',
+        richOnly: true
+    },
+    {
+        value: 'column-widths',
+        label: '列宽',
+        richOnly: true
+    }
+];
+const spreadsheetPasteOperationOptions = [
+    {
+        value: 'none',
+        label: '无'
+    },
+    {
+        value: 'add',
+        label: '加'
+    },
+    {
+        value: 'subtract',
+        label: '减'
+    },
+    {
+        value: 'multiply',
+        label: '乘'
+    },
+    {
+        value: 'divide',
+        label: '除'
+    }
+];
+const MILLISECONDS_PER_DAY = 86400000;
+const MINUTES_PER_DAY = 1440;
+const EXCEL_1900_EPOCH_UTC = Date.UTC(1899, 11, 30);
+function spreadsheetDateTimeEntry(kind, now) {
+    if (!Number.isFinite(now.getTime())) return null;
+    if ('date' === kind) {
+        const year = now.getFullYear();
+        const month = now.getMonth();
+        const day = now.getDate();
+        const value = (Date.UTC(year, month, day) - EXCEL_1900_EPOCH_UTC) / MILLISECONDS_PER_DAY;
+        if (!Number.isFinite(value)) return null;
+        return {
+            format: {
+                fa: 'yyyy-MM-dd',
+                t: 'd'
+            },
+            formulaBarValue: `${padDatePart(year, 4)}-${padDatePart(month + 1)}-${padDatePart(day)}`,
+            value
+        };
+    }
+    if ('time' !== kind) return null;
+    const hours = now.getHours();
+    const minutes = now.getMinutes();
+    return {
+        format: {
+            fa: 'hh:mm',
+            t: 'd'
+        },
+        formulaBarValue: `${padDatePart(hours)}:${padDatePart(minutes)}`,
+        value: (60 * hours + minutes) / MINUTES_PER_DAY
+    };
+}
+function createSpreadsheetDateTimeExtension() {
+    return createOfficeEditorExtension({
+        name: 'spreadsheetDateTime',
+        addCommands: ()=>({
+                insertCurrentDateTime: {
+                    canExecute: (context, kind)=>isSpreadsheetDateTimeKind(kind) && null !== spreadsheetDateTimeTarget(context),
+                    execute: insertCurrentSpreadsheetDateTime
+                }
+            }),
+        addKeyboardShortcuts: ()=>({
+                [spreadsheetCommandCatalog.insertCurrentDate.shortcut.editor["0"]]: ({ can, commands }, event)=>runSpreadsheetDateTimeShortcut(event, 'date', can.insertCurrentDateTime, commands.insertCurrentDateTime),
+                [spreadsheetCommandCatalog.insertCurrentTime.shortcut.editor["0"]]: ({ can, commands }, event)=>runSpreadsheetDateTimeShortcut(event, 'time', can.insertCurrentDateTime, commands.insertCurrentDateTime)
+            })
+    });
+}
+function insertCurrentSpreadsheetDateTime(context, kind) {
+    if (!isSpreadsheetDateTimeKind(kind)) return false;
+    const target = spreadsheetDateTimeTarget(context);
+    const entry = spreadsheetDateTimeEntry(kind, new Date());
+    if (!target || !entry || !context.workbook) return false;
+    try {
+        context.workbook.batchCallApis([
+            {
+                name: 'setCellValuesByRange',
+                args: [
+                    [
+                        [
+                            entry.value
+                        ]
+                    ],
+                    target.range,
+                    {
+                        id: target.sheetId
+                    }
+                ]
+            },
+            {
+                name: 'setCellFormatByRange',
+                args: [
+                    'ct',
+                    entry.format,
+                    target.range,
+                    {
+                        id: target.sheetId
+                    }
+                ]
+            }
+        ]);
+    } catch  {
+        return false;
+    }
+    try {
+        context.formulaBar?.setValue(entry.formulaBarValue);
+    } catch  {}
+    return true;
+}
+function spreadsheetDateTimeTarget(context) {
+    const workbook = context.workbook;
+    const sheetId = context.targetSheetId;
+    if (!context.editable || !workbook || !sheetId || sheetId !== context.activeSheetId) return null;
+    try {
+        const selection = finiteSpreadsheetSelection(workbook.getSelection()?.at(-1) ?? context.fallbackRange);
+        const row = selection.row_focus ?? selection.row[0] ?? 0;
+        const column = selection.column_focus ?? selection.column[0] ?? 0;
+        if (!Number.isSafeInteger(row) || row < 0 || row >= MAX_SPREADSHEET_ROWS || !Number.isSafeInteger(column) || column < 0 || column >= 16384) return null;
+        const range = {
+            row: [
+                row,
+                row
+            ],
+            column: [
+                column,
+                column
+            ]
+        };
+        const sheet = context.content.sheets.find((candidate)=>candidate.id === sheetId);
+        return canMutateSpreadsheetCellRange(sheet, range) ? {
+            range,
+            sheetId
+        } : null;
+    } catch  {
+        return null;
+    }
+}
+function runSpreadsheetDateTimeShortcut(event, kind, canExecute, execute) {
+    if (event.repeat || event.isComposing || isOfficeShortcutBlocked(event.target) || isSpreadsheetNativeTextUndoTarget(event.target) || !isSpreadsheetGridKeyboardTarget(event.target) || !canExecute(kind)) return false;
+    return execute(kind);
+}
+function isSpreadsheetDateTimeKind(value) {
+    return 'date' === value || 'time' === value;
+}
+function padDatePart(value, length = 2) {
+    return String(value).padStart(length, '0');
+}
 function canApplySpreadsheetCellMerge(sheet, range, command) {
     if (!sheet) return false;
     const normalized = normalizeSpreadsheetCellMergeRange(range);
@@ -8368,6 +8601,7 @@ function createSpreadsheetEditorExtensions() {
         createSpreadsheetCellBorderExtension(),
         createSpreadsheetCellStyleExtension(),
         createSpreadsheetNumberFormatExtension(),
+        createSpreadsheetDateTimeExtension(),
         createSpreadsheetNavigationExtension(),
         createSpreadsheetDataValidationExtension(),
         createSpreadsheetHyperlinkExtension(),
@@ -10721,6 +10955,73 @@ function SpreadsheetUnderlineGlyph({ style }) {
         })
     });
 }
+function SpreadsheetDateTimeMenu({ can, commands }) {
+    const items = [
+        {
+            definition: spreadsheetCommandCatalog.insertCurrentDate,
+            icon: /*#__PURE__*/ jsx(CalendarDays, {
+                size: 16
+            }),
+            kind: 'date'
+        },
+        {
+            definition: spreadsheetCommandCatalog.insertCurrentTime,
+            icon: /*#__PURE__*/ jsx(Clock, {
+                size: 16
+            }),
+            kind: 'time'
+        }
+    ];
+    const disabled = items.every(({ kind })=>!can.insertCurrentDateTime(kind));
+    return /*#__PURE__*/ jsx(Popover, {
+        label: "日期和时间",
+        panelLabel: "插入日期和时间",
+        panelRole: "menu",
+        portal: true,
+        className: "work-spreadsheet-ribbon-menu-root",
+        panelClassName: "work-office-context-menu work-spreadsheet-ribbon-menu",
+        disabled: disabled,
+        focusFirstOnOpen: true,
+        onPanelKeyDown: moveOfficeMenuFocus,
+        trigger: (triggerProps, { open })=>/*#__PURE__*/ jsxs("button", {
+                ...triggerProps,
+                className: `with-label work-spreadsheet-ribbon-menu-trigger work-spreadsheet-date-time-trigger${open ? ' active' : ''}`,
+                title: "插入当前日期或时间（Ctrl+; / Ctrl+Shift+;）",
+                children: [
+                    /*#__PURE__*/ jsx(CalendarClock, {
+                        size: 19
+                    }),
+                    /*#__PURE__*/ jsx("span", {
+                        children: "日期和时间"
+                    })
+                ]
+            }),
+        children: (close)=>items.map(({ definition, icon, kind })=>/*#__PURE__*/ jsxs("button", {
+                    type: "button",
+                    role: "menuitem",
+                    tabIndex: -1,
+                    "aria-label": definition.label,
+                    "aria-keyshortcuts": definition.shortcut.aria,
+                    disabled: !can.insertCurrentDateTime(kind),
+                    onClick: ()=>{
+                        close();
+                        commands.insertCurrentDateTime(kind);
+                    },
+                    children: [
+                        /*#__PURE__*/ jsx("span", {
+                            className: "work-spreadsheet-ribbon-menu-item-icon",
+                            children: icon
+                        }),
+                        /*#__PURE__*/ jsx("span", {
+                            children: definition.label
+                        }),
+                        /*#__PURE__*/ jsx("kbd", {
+                            children: definition.shortcut.label
+                        })
+                    ]
+                }, definition.id))
+    });
+}
 const spreadsheetNumberFormatOptions = [
     {
         value: 'general',
@@ -10918,16 +11219,25 @@ function SpreadsheetNumberRibbonGroup({ can, commands, toolbarCell }) {
         label: "数字",
         priority: "high",
         children: [
-            /*#__PURE__*/ jsx(OfficeSelect, {
-                className: "work-spreadsheet-number-format",
-                ariaLabel: "数字格式",
-                value: numberFormatPreset,
-                disabled: !can.setCellFormat('ct', currentNumberFormatValue),
-                options: spreadsheetNumberFormatOptions,
-                onValueChange: (preset)=>{
-                    if ('custom' === preset) return;
-                    commands.setCellFormat('ct', spreadsheetNumberFormatValue(spreadsheetNumberFormatCode(preset), toolbarCell));
-                }
+            /*#__PURE__*/ jsxs("div", {
+                className: "work-spreadsheet-number-format-stack",
+                children: [
+                    /*#__PURE__*/ jsx(OfficeSelect, {
+                        className: "work-spreadsheet-number-format",
+                        ariaLabel: "数字格式",
+                        value: numberFormatPreset,
+                        disabled: !can.setCellFormat('ct', currentNumberFormatValue),
+                        options: spreadsheetNumberFormatOptions,
+                        onValueChange: (preset)=>{
+                            if ('custom' === preset) return;
+                            commands.setCellFormat('ct', spreadsheetNumberFormatValue(spreadsheetNumberFormatCode(preset), toolbarCell));
+                        }
+                    }),
+                    /*#__PURE__*/ jsx(SpreadsheetDateTimeMenu, {
+                        can: can,
+                        commands: commands
+                    })
+                ]
             }),
             /*#__PURE__*/ jsx(WorkOfficeRibbonButton, {
                 label: `${currencyDefinition.label}格式`,
@@ -13784,81 +14094,6 @@ function formatCellsSelectionDescription(source) {
     const columns = source.range.column[1] - source.range.column[0] + 1;
     return `设置当前选区的数字、对齐、字体、边框、填充和保护属性（${rows} 行 × ${columns} 列）。`;
 }
-const MAX_SPREADSHEET_ROWS = 1048576;
-const spreadsheetPasteContentOptions = [
-    {
-        value: 'all',
-        label: '全部',
-        richOnly: false
-    },
-    {
-        value: 'formulas',
-        label: '公式',
-        richOnly: false
-    },
-    {
-        value: 'values',
-        label: '值',
-        richOnly: false
-    },
-    {
-        value: 'formats',
-        label: '格式',
-        richOnly: true
-    },
-    {
-        value: 'comments',
-        label: '批注',
-        richOnly: true
-    },
-    {
-        value: 'validation',
-        label: '数据验证',
-        richOnly: true
-    },
-    {
-        value: 'all-except-borders',
-        label: '边框除外的全部',
-        richOnly: true
-    },
-    {
-        value: 'formulas-and-number-formats',
-        label: '公式和数字格式',
-        richOnly: true
-    },
-    {
-        value: 'values-and-number-formats',
-        label: '值和数字格式',
-        richOnly: true
-    },
-    {
-        value: 'column-widths',
-        label: '列宽',
-        richOnly: true
-    }
-];
-const spreadsheetPasteOperationOptions = [
-    {
-        value: 'none',
-        label: '无'
-    },
-    {
-        value: 'add',
-        label: '加'
-    },
-    {
-        value: 'subtract',
-        label: '减'
-    },
-    {
-        value: 'multiply',
-        label: '乘'
-    },
-    {
-        value: 'divide',
-        label: '除'
-    }
-];
 function captureSpreadsheetClipboardSnapshot(content, sheetId, selection, plainText) {
     const range = spreadsheet_cell_range_normalizeSpreadsheetCellRange(selection);
     const sheet = content.sheets.find((candidate)=>candidate.id === sheetId);
@@ -23988,6 +24223,7 @@ function spreadsheetCommandsWithGridFocus(commands, restoreFocus) {
         deleteSelectedStructure: afterSuccessfulCommand(commands.deleteSelectedStructure),
         fillSelectedCells: afterSuccessfulCommand(commands.fillSelectedCells),
         insertSelectedStructure: afterSuccessfulCommand(commands.insertSelectedStructure),
+        insertCurrentDateTime: afterSuccessfulCommand(commands.insertCurrentDateTime),
         mergeSelectedCells: afterSuccessfulCommand(commands.mergeSelectedCells),
         openPasteSpecial: afterSuccessfulCommand(commands.openPasteSpecial),
         pasteSelection: afterSuccessfulCommand(commands.pasteSelection),

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

@@ -364,6 +364,34 @@ export declare const spreadsheetCommandCatalog: {
             readonly group: "number";
         };
     };
+    readonly insertCurrentDate: {
+        readonly id: "number.insertCurrentDate";
+        readonly label: "插入当前日期";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "number";
+        };
+        readonly shortcut: {
+            readonly label: "Ctrl+;";
+            readonly aria: "Control+;";
+            readonly editor: readonly ["Control-;"];
+        };
+    };
+    readonly insertCurrentTime: {
+        readonly id: "number.insertCurrentTime";
+        readonly label: "插入当前时间";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "number";
+        };
+        readonly shortcut: {
+            readonly label: "Ctrl+Shift+;";
+            readonly aria: "Control+Shift+;";
+            readonly editor: readonly ["Control-Shift-;"];
+        };
+    };
     readonly formatCells: {
         readonly id: "number.formatCells";
         readonly label: "设置单元格格式";

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

@@ -11,6 +11,7 @@ import type { SpreadsheetCellRange } from './spreadsheet-cell-range';
 import type { SpreadsheetCellStyleChoice } from './spreadsheet-cell-style';
 import type { SpreadsheetCellFillDirection } from './spreadsheet-cell-fill';
 import { type SpreadsheetFontSizeDirection } from './spreadsheet-font-size-command';
+import { type SpreadsheetDateTimeKind } from './spreadsheet-date-time-command';
 import type { SpreadsheetDataValidationRequest, SpreadsheetDataValidationTarget } from './spreadsheet-data-validation';
 import { type SpreadsheetCellMergeCommand } from './spreadsheet-cell-merge';
 import type { SpreadsheetFormatPainterMode } from './spreadsheet-format-painter';
@@ -169,6 +170,7 @@ export interface SpreadsheetEditorCommands {
     fillSelectedCells: (direction: SpreadsheetCellFillDirection) => boolean;
     hideSheet: (sheetId: string) => boolean;
     insertSelectedStructure: (axis: SpreadsheetStructureAxis, position: SpreadsheetStructureInsertPosition) => boolean;
+    insertCurrentDateTime: (kind: SpreadsheetDateTimeKind) => boolean;
     mergeSelectedCells: (command: SpreadsheetCellMergeCommand) => boolean;
     moveSheet: (sheetId: string, direction: SpreadsheetSheetMoveDirection) => boolean;
     moveSelection: (move: SpreadsheetSelectionMove, extend: boolean) => boolean;

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

@@ -0,0 +1,14 @@
+import type { Cell } from '@fortune-sheet/core';
+import type { SpreadsheetCommandContext, SpreadsheetEditorCommands } from './spreadsheet-command-controller';
+import { type OfficeEditorExtension } from './office-editor-extension';
+export type SpreadsheetDateTimeKind = 'date' | 'time';
+export interface SpreadsheetDateTimeEntry {
+    format: NonNullable<Cell['ct']> & {
+        fa: string;
+        t: string;
+    };
+    formulaBarValue: string;
+    value: number;
+}
+export declare function spreadsheetDateTimeEntry(kind: SpreadsheetDateTimeKind, now: Date): SpreadsheetDateTimeEntry | null;
+export declare function createSpreadsheetDateTimeExtension(): OfficeEditorExtension<SpreadsheetCommandContext, SpreadsheetEditorCommands>;

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

@@ -0,0 +1,8 @@
+import type { SpreadsheetEditorCanCommands, SpreadsheetEditorCommands } from './spreadsheet-command-controller';
+type SpreadsheetDateTimeCanCommands = Pick<SpreadsheetEditorCanCommands, 'insertCurrentDateTime'>;
+type SpreadsheetDateTimeCommands = Pick<SpreadsheetEditorCommands, 'insertCurrentDateTime'>;
+export declare function SpreadsheetDateTimeMenu({ can, commands, }: {
+    can: SpreadsheetDateTimeCanCommands;
+    commands: SpreadsheetDateTimeCommands;
+}): import("react").JSX.Element;
+export {};

package/dist/styles.css

@@ -13885,6 +13885,41 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
   min-width: 94px;
 }
 
+.work-spreadsheet-number-format-stack {
+  flex-direction: column;
+  flex: 0 0 94px;
+  gap: 2px;
+  width: 94px;
+  height: 51px;
+  display: flex;
+}
+
+.work-spreadsheet-number-format-stack > .work-spreadsheet-ribbon-menu-root {
+  width: 94px;
+  min-width: 0;
+}
+
+.work-office-ribbon .work-office-toolbar .work-spreadsheet-number-format-stack .work-spreadsheet-date-time-trigger.with-label {
+  flex-direction: row;
+  justify-content: flex-start;
+  gap: 4px;
+  width: 94px;
+  min-width: 94px;
+  height: 21px;
+  padding: 0 6px;
+}
+
+.work-office-ribbon .work-office-toolbar .work-spreadsheet-number-format-stack .work-spreadsheet-date-time-trigger.with-label > svg {
+  width: 14px;
+  height: 14px;
+}
+
+.work-office-ribbon .work-office-toolbar .work-spreadsheet-number-format-stack .work-spreadsheet-date-time-trigger.with-label > span {
+  max-width: 66px;
+  font-size: 9px;
+  line-height: 11px;
+}
+
 .work-spreadsheet-workbook-panel {
   z-index: 8;
   border-left: 1px solid var(--a3s-line);

package/docs/latest/en/browser-editor-architecture.md

@@ -47,17 +47,17 @@ model:
    and compacts low-priority, then normal-priority groups before exposing group
    paging. It can remain collapsed; activating a tab temporarily overlays that
    tab's commands without moving the document, and an outside pointer action
-   returns to the compact row. Writer routes its catalogued WPS font-size,
+   returns to the compact row. Writer routes its catalogued Traditional Office font-size,
    alignment, line-spacing, heading, spelling, field-refresh, comment, and
    track-changes shortcuts only while the document surface owns the event. The
-   status route uses the same catalog for WPS word count, opening live page,
+   status route uses the same catalog for Traditional Office word count, opening live page,
    word, character, and paragraph details from either `Ctrl+Shift+G` or the
-   visible count. Its local formatting clipboard powers WPS copy-format and
+   visible count. Its local formatting clipboard powers Traditional Office copy-format and
    paste-format shortcuts
    plus a one-shot format painter without requiring browser clipboard access;
    paste replaces only direct character and paragraph formatting, preserving
    links, comments, and revision semantics in one document transaction.
-   Header and footer TipTap surfaces register the same WPS alignment and
+   Header and footer TipTap surfaces register the same Traditional Office alignment and
    copy-format shortcuts. Cross-surface paste retains compatible marks and
    paragraph attributes while falling back from unsupported heading nodes.
    Writer orders Insert commands as Pages, Table, Illustrations, Links, Header
@@ -105,11 +105,11 @@ model:
    page metrics and scroll viewport. Picture, Table, and Header and Footer tabs
    carry explicit contextual semantics and disappear with their selection. The
    Spreadsheet shell now uses the same responsive ribbon contract with its own
-   command catalog and workbook semantics. It keeps the WPS tab order, places
+   command catalog and workbook semantics. It keeps the Traditional Office tab order, places
    Conditional Formatting under Home and Styles, exposes real sorting under
    Data, and owns F9 workbook recalculation in the root-scoped keyboard
    controller. Paste, Cut, and Copy live in the first Home group; both button
-   clicks and WPS shortcuts cross one clipboard command port before using the
+   clicks and Traditional Office shortcuts cross one clipboard command port before using the
    permission-resilient browser/local clipboard implementation. Paste Special
    extends that port with a versioned rich snapshot and a pure bounded planner
    instead of delegating mutation to rendered vendor controls. Quick All,
@@ -136,7 +136,7 @@ model:
    `Alt+ArrowDown`. The Fortune adapter only exposes the header trigger and
    value menu, adding dialog, checkbox, focus-restoration, and keyboard
    semantics without making vendor DOM text the command contract. Freeze Panes
-   also stays controlled: a pure model translates the current WPS cell into
+   also stays controlled: a pure model translates the current Traditional Office cell into
    rows above and columns left or applies top-row and first-column presets, a
    typed View command performs one immutable workbook update, and the native
    Fortune/XLSX frozen-pane model remains the render and serialization
@@ -300,7 +300,7 @@ focus restoration.
 | --- | --- | --- | --- |
 | Document | One TipTap/ProseMirror body tree retained across editing and read-only preview, controlled TipTap header/footer surfaces with direct paper-margin editing and a contextual ribbon, one typography and page-chrome baseline across editing, preview, and PDF surfaces, a persistent typed heading-navigation pane with active-selection tracking, filtering and collapsible keyboard traversal, host-owned selected-text menus with full document context and range-mapped async commands, responsive and keyboard-operated paragraph-style and list galleries, typed bullet and numbering commands with restart/continue/start controls, typed physical-page and section-page descriptors, repeated first/default/even page chrome, a versioned structured model with an HTML compatibility representation, prefix-reused visual-line measurement and pages, page decorations, page-aware horizontal and vertical rulers for page margins, paragraph indents and typed tab stops, structured list-item pagination, explicit paragraph and list-item direction, compact spacing and pagination controls, typed inline/square/tight/through/top-and-bottom/no-wrap image layout and floating-image drawing layers, imported style-inherited paragraph properties, structured inline tabs, and theme-aware run font/size/color/background import | Worker plus resumable Rust/WASM flow pagination and Rustybuzz shaping across CSS-matched registered text runs; the same live result remains mounted in read-only preview and is consumed by bounded browser PDF capture, including eligible list paragraphs, Unicode bidi level segmentation, ordered per-grapheme font fallback, packaged Latin/CJK/Arabic/Hebrew faces, and structured left-to-right tabs, with explicit DOM and JavaScript fallbacks for text affected by supported floats | Language-complete font substitution, complete Word style and numbering coverage, locale-complete and bidirectional tabs, arbitrary floating-object geometry and non-image drawing layers, complex table flow, searchable/vector PDF output, and loss-preserving OOXML package state |
 | Markdown | TipTap visual editing with a resizable source-and-preview split view by default, source-aware ribbon formatting and shortcuts, bounded source-native history with coalesced typing and selection restoration, host-defined selection menus across both editing surfaces, GFM tables, strikethrough, autolinks and nested task lists, controlled source state, coalesced preview rebuilds, proportional pane scrolling, keyboard-adjustable pane sizing, a flat measure-bounded reading surface, optional visual or source-only views, and a full-workspace Source/Preview switch on phones | No kernel required for normal editing | CommonMark differential fixtures, multi-megabyte profiling, and an off-main-thread parser boundary when measurements justify it |
-| Spreadsheet | Fortune Sheet grid integrated with the shared Office shell, a WPS-oriented command catalog and tab order, quick-access Undo and Redo, a priority-aware adaptive and collapsible ribbon with temporary tab expansion, Home and Styles Conditional Formatting, Home and Cells row/column insertion and deletion through the shared typed structure commands, Home and Alignment Merge and Center plus Merge Cells, Merge Across, Unmerge Cells, and Unmerge and Fill through one native-model-backed controlled batch per intent and the WPS `Ctrl+M` shortcut, Home and Font native strikethrough through the same typed formatting command and WPS `Cmd/Ctrl+5`, Home and Editing Clear All, Formats, Contents, Comments, and Hyperlinks with Delete/Backspace mapped to content-only clearing and merge geometry retained, Data sorting and AutoFilter with bounded current-region discovery, controlled filter state, WPS toggle and header-menu shortcuts, and accessible vendor menu semantics, View and Window Freeze Panes with WPS current-cell, top-row, first-column, and unfreeze patterns backed by controlled state and native XLSX frozen panes, Formulas and F9 workbook recalculation, an executable Home clipboard group with permission-resilient Paste, Cut, and Copy plus a WPS-style one-shot and locked Format Painter for bounded cross-sheet native-style patterns, shared grid/formula/footer visual tokens and one spreadsheet accent across selection, sheet tabs, menus, and zoom, an A3S-owned accessible single-row workbook footer for creation, activation, rename, duplicate, color, hide, reorder, delete, selection status, and zoom, a resize-observed worksheet viewport that keeps the active tab and its touch action visible across desktop, compact, and phone-width changes, one cell/worksheet context-menu surface whose displayed accelerators remain executable while the menu owns focus, Arrow/Home/End tab navigation plus Shift+F10 and native context-menu access, typed editing and calculation command ports, A3S-owned deterministic Arrow, Enter, Tab, Home, PageUp/PageDown, extended-selection, row, column, and all-cells keyboard commands, selection-preserving focus restoration across controlled workbook remounts and F2/Escape editing transitions, Cmd/Ctrl formatting, undo/redo, clear, a permission-resilient editor-local clipboard fallback, Shift+F11 sheet creation, and Ctrl/Cmd+PageUp/PageDown sheet-navigation shortcuts, direct font-family, horizontal/vertical-alignment, text-wrap, general/number/percent, and decimal-place controls backed by native cell-style keys, live count/sum/average selection summaries, operation-driven sparse-workbook projection, guarded controlled-value remounts that reject stale engine callbacks, and no-history result patches with cell-scoped Fortune fallback | Versioned, cancellable Worker/Rust-WASM calculation sessions using the shared bounded Rust formula parser, retained formula ASTs, incremental forward/reverse dependency graphs, dirty-subgraph recalculation, cross-sheet references, and a dynamically loaded JavaScript fallback | A3S-owned virtual grid, moving replacement projection off the main thread, broader Excel formula semantics, A3S-owned custom number-format evaluation, and print layout |
+| Spreadsheet | Fortune Sheet grid integrated with the shared Office shell, an Office-oriented command catalog and tab order, quick-access Undo and Redo, a priority-aware adaptive and collapsible ribbon with temporary tab expansion, Home and Styles Conditional Formatting, Home and Cells row/column insertion and deletion through the shared typed structure commands, Home and Alignment Merge and Center plus Merge Cells, Merge Across, Unmerge Cells, and Unmerge and Fill through one native-model-backed controlled batch per intent and the Traditional Office `Ctrl+M` shortcut, Home and Font native strikethrough through the same typed formatting command and Traditional Office `Cmd/Ctrl+5`, Home and Editing Clear All, Formats, Contents, Comments, and Hyperlinks with Delete/Backspace mapped to content-only clearing and merge geometry retained, Data sorting and AutoFilter with bounded current-region discovery, controlled filter state, Traditional Office toggle and header-menu shortcuts, and accessible vendor menu semantics, View and Window Freeze Panes with Traditional Office current-cell, top-row, first-column, and unfreeze patterns backed by controlled state and native XLSX frozen panes, Formulas and F9 workbook recalculation, an executable Home clipboard group with permission-resilient Paste, Cut, and Copy plus an Office-style one-shot and locked Format Painter for bounded cross-sheet native-style patterns, shared grid/formula/footer visual tokens and one spreadsheet accent across selection, sheet tabs, menus, and zoom, an A3S-owned accessible single-row workbook footer for creation, activation, rename, duplicate, color, hide, reorder, delete, selection status, and zoom, a resize-observed worksheet viewport that keeps the active tab and its touch action visible across desktop, compact, and phone-width changes, one cell/worksheet context-menu surface whose displayed accelerators remain executable while the menu owns focus, Arrow/Home/End tab navigation plus Shift+F10 and native context-menu access, typed editing and calculation command ports, A3S-owned deterministic Arrow, Enter, Tab, Home, PageUp/PageDown, extended-selection, row, column, and all-cells keyboard commands, selection-preserving focus restoration across controlled workbook remounts and F2/Escape editing transitions, Cmd/Ctrl formatting, undo/redo, clear, a permission-resilient editor-local clipboard fallback, Shift+F11 sheet creation, and Ctrl/Cmd+PageUp/PageDown sheet-navigation shortcuts, direct font-family, horizontal/vertical-alignment, text-wrap, general/number/percent, and decimal-place controls backed by native cell-style keys, live count/sum/average selection summaries, operation-driven sparse-workbook projection, guarded controlled-value remounts that reject stale engine callbacks, and no-history result patches with cell-scoped Fortune fallback | Versioned, cancellable Worker/Rust-WASM calculation sessions using the shared bounded Rust formula parser, retained formula ASTs, incremental forward/reverse dependency graphs, dirty-subgraph recalculation, cross-sheet references, and a dynamically loaded JavaScript fallback | A3S-owned virtual grid, moving replacement projection off the main thread, broader Excel formula semantics, A3S-owned custom number-format evaluation, and print layout |
 | Presentation | Scene canvas with ordered typed multi-selection, persistent nested browser groups, native PPTX group-node export, exact keyboard-accessible table-dimension insertion, native slide/object context actions with optional AI actions, a separate object/content editing state, one on-demand TipTap instance, collective move/scale/nudge/clipboard/delete/layer commands, selection-bound alignment and distribution, typed group/ungroup commands, one typed dispatcher for ribbon commands, editor-scoped shortcuts with post-command selection focus, direct beginning/current-slide playback with fullscreen fallback, frame-coalesced transactional move/resize previews that commit once on pointer release, two-level thumbnail node and scene windowing, and a phone stage that top-aligns the primary canvas while retaining one readable slide indicator beside view and zoom controls | Revisioned, cancellable Worker/Rust-WASM slide-relative alignment and object-set snapping with typed visual guides and a JavaScript fallback | Arbitrary rotated or reflected PPTX group transforms, connectors, theme resolution, text fitting, kernel-owned thumbnail layout, and slide serialization |
 | PDF | PDFium-backed page rendering with an A3S-owned responsive toolbar, a scrollable page-thumbnail rail with active-page synchronization and bounded bitmap/DOM windowing, a focus-contained phone page drawer, and typed capability controllers for navigation, zoom, search, basic annotations, annotation color, opacity, compatible stroke-width defaults and selection updates, history, and save; page and search drafts cancel without accidental commands, shortcuts remain scoped to the PDF root, and compact widths retain page status while exposing search-result traversal, navigation, zoom, and history through the keyboard-operated overflow menu | PDFium WebAssembly | Forms, redaction review, page organization, and reopen fixtures |
 
@@ -635,7 +635,7 @@ The current browser-kernel slice collects contiguous geometry-affecting text
 runs from eligible paragraphs. Each run carries an ordered registered font
 stack, size, line height, letter spacing, ligature, and kerning behavior. Font
 families and normal/italic styles remain exact; numeric weights follow the CSS
-Fonts matching order so WPS-style values such as 680 or 730 select a registered
+Fonts matching order so Office-style values such as 680 or 730 select a registered
 700 face. When a family has only one normal-style weight, the same face
 provides deterministic metrics for browser-synthesized bold text. The kernel
 selects a face for each grapheme, joins adjacent selections that use the same
@@ -816,13 +816,13 @@ numbering settings. Reversed lists, per-item `value` overrides, native Word
 list-identity continuation, arbitrary multilevel templates, and loss-preserving
 custom numbering formats remain later fidelity gates.
 
-The declared direct-formatting layout slice now has a real WPS Writer reference
+The declared direct-formatting layout slice now has a real Traditional Office Writer reference
 gate. Its deterministic A4 fixture uses installed Arial runs, explicit OOXML
 paragraph spacing, a fixed centered table, direct cell fills and borders, and
 physical cell margins. Automatic `w:line` values retain their original OOXML
-multiples for export while the browser applies the measured WPS single-line
+multiples for export while the browser applies the measured Traditional Office single-line
 font metric; imported tables no longer receive editor-only block margins. The
-Windows parity workflow exports the same fixture through WPS, captures both
+Windows parity workflow exports the same fixture through Traditional Office, captures both
 794 by 1123 CSS-pixel pages, and rejects page-size, landmark, or bounded pixel
 differences. Language-complete font substitution, variable font axes, the
 remaining character and table style properties, non-image floating-object
@@ -1181,7 +1181,7 @@ Migration to browser-native OOXML is staged:
    editing surfaces.
 
 Each stage needs compatibility fixtures, deterministic layout goldens, large
-document performance budgets, and real Microsoft Office and WPS
+document performance budgets, and real Microsoft Office and Traditional Office
 interoperability evidence before it can be described as fidelity-complete.
 
 ## Delivery roadmap
@@ -1225,7 +1225,7 @@ bundle regression.
 
 Exit criteria: deterministic layout goldens for the supported feature set;
 incremental reflow does not rebuild unaffected pages; DOCX fixtures round-trip
-through Microsoft Word and WPS without losing unsupported package parts.
+through Microsoft Word and Traditional Office without losing unsupported package parts.
 
 ### Stage 3: spreadsheet calculation and virtualization
 
@@ -1355,7 +1355,7 @@ window.
 Exit criteria: object drag and resize stay interactive on complex slides;
 partial rich-text formatting survives PPTX round trips; masters, layouts,
 themes, tables, charts, links, and notes have compatibility fixtures for
-PowerPoint and WPS.
+PowerPoint and Traditional Office.
 
 ### Stage 5: PDF product surface
 
@@ -1415,7 +1415,7 @@ page window rather than the complete file.
   CLI, MCP server, and Skill.
 
 Exit criteria: import-edit-export fixtures show semantic and package-level
-round-trip evidence in Microsoft Office and WPS; unsupported content is
+round-trip evidence in Microsoft Office and Traditional Office; unsupported content is
 retained or rejected explicitly, never silently discarded.
 
 ## Performance gates

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -88,6 +88,7 @@
     "playground:typecheck": "tsc --noEmit -p playground/tsconfig.json",
     "playground:visual": "playwright test --config playwright.config.ts",
     "playground:visual:spreadsheet-data-validation": "playwright test visual-tests/spreadsheet-data-validation.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:spreadsheet-date-time": "playwright test visual-tests/spreadsheet-date-time.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-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",
@@ -160,6 +161,8 @@
     "test:e2e:spreadsheet-data-validation:check": "a3s-test check tests/e2e/spreadsheet-data-validation.acl --json",
     "test:e2e:spreadsheet-diagonal-borders": "a3s-test run tests/e2e/spreadsheet-diagonal-borders.acl --json",
     "test:e2e:spreadsheet-diagonal-borders:check": "a3s-test check tests/e2e/spreadsheet-diagonal-borders.acl --json",
+    "test:e2e:spreadsheet-date-time": "a3s-test run tests/e2e/spreadsheet-date-time.acl --json",
+    "test:e2e:spreadsheet-date-time:check": "a3s-test check tests/e2e/spreadsheet-date-time.acl --json",
     "test:e2e:spreadsheet-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",
@@ -179,6 +182,7 @@
     "test:e2e:writer-status": "a3s-test run tests/e2e/word-status-bar.acl --json",
     "test:e2e:writer-status:check": "a3s-test check tests/e2e/word-status-bar.acl --json",
     "test:wps-layout": "powershell -NoProfile -ExecutionPolicy Bypass -File scripts/test-wps-layout-parity.ps1",
+    "test:office-layout": "bun run test:wps-layout",
     "test:watch": "rstest --watch",
     "typecheck": "tsc --noEmit"
   },