@a3s-lab/office 0.1.0 → 0.2.2

package/README.md

@@ -91,8 +91,12 @@ The images below are committed visual-regression baselines from the real
 - **Product-native UI** — Complete Office-style surfaces with no required
   backend, account system, or storage model.
 - **Accessible responsive shell** — Compact sidebars, slide navigation, AI
-  panes, dialogs, menus, and popovers share bounded keyboard navigation,
-  background isolation, topmost Escape handling, and focus restoration.
+  panes, responsive chart inspectors, dialogs, menus, and popovers share
+  bounded keyboard navigation, background isolation, topmost Escape handling,
+  and focus restoration.
+  Persistent desktop navigation and the temporary phone drawer keep separate
+  open states, so live breakpoint changes never turn a desktop sidebar into an
+  unexpected blocking modal or steal focus from the workspace.
   Shared color palettes expand to an eight-column touch layout on phones while
   preserving spatial arrow-key navigation.
 - **Editor-scoped zoom** — Status controls and Ctrl/Cmd + mouse-wheel gestures
@@ -246,20 +250,79 @@ 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, styles,
+  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;
+  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, precision table sizing and autofit,
-  viewport-safe comment drafting,
-  focus-preserving comment review and citation drafts, tracked changes, notes,
+  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. Theme tint and shade values resolve
+  for table borders and cell fills across edit, preview, and RGB-stable export.
+  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.
+  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.
+  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, and keyboard-accessible host-defined
-  selection menus across both editing surfaces. _Markdown import/export._
+  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
@@ -269,11 +332,15 @@ interaction model.
   PageUp/PageDown, row, column, and all-cells selection shortcuts, Cmd/Ctrl
   formatting through root-scoped capture before vendor grid listeners, an
   editor-owned Cmd/Ctrl+F search bar that finds displayed values, raw values,
-  formulas, and sparse cells without opening browser Find,
+  formulas, and sparse cells without opening browser Find, with a viewport-safe
+  phone layout, touch-sized controls, and exact grid-focus restoration,
+  desktop workbook task panes that become focus-contained phone dialogs with
+  an inert workbook background and exact ribbon-invoker restoration,
   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, keyboard-operated cells and sheet tabs, direct type-to-edit,
+  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/percent, and decimal
@@ -283,9 +350,13 @@ interaction model.
   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 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
+  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,
@@ -389,8 +460,8 @@ CLI, MCP, the typed Rust API, and the packaged Office Skill share the same
 bounded contracts. They inspect and modify files without launching desktop
 Office or scraping editor UI.
 
-Read the [native engine design](docs/native-office-engine.md), the complete
-[CLI reference](docs/cli-reference.md), or the published
+Read the [native engine design](docs/latest/en/native-office-engine.md), the
+complete [CLI reference](docs/latest/en/cli-reference.md), or the published
 [CLI and Skill guide](https://a3s-lab.github.io/Office/docs/automation/).
 
 ## Architecture
@@ -408,7 +479,8 @@ PDFium provider for read-only PDF page evidence. Both planes expose typed
 contracts; neither requires an A3S backend.
 
 For engine ownership, Worker/WASM boundaries, delivery stages, and performance
-gates, see [Browser editor architecture](docs/browser-editor-architecture.md).
+gates, see
+[Browser editor architecture](docs/latest/en/browser-editor-architecture.md).
 
 ## Project status
 
@@ -420,7 +492,7 @@ 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/editor-quality-roadmap.md).
+the [editor quality roadmap](docs/latest/en/editor-quality-roadmap.md).
 
 ## Development
 
@@ -442,18 +514,23 @@ committed visual contracts; see [CONTRIBUTING.md](CONTRIBUTING.md).
 ## Documentation
 
 The published website keeps the interactive Playground at its root and builds
-the searchable Rspress documentation center under `/docs/`. Both surfaces use
-the same deployment base, so preview, Pages, and fork deployments keep working
+the searchable Rspress documentation center under `/docs/`. Simplified Chinese
+is the stable default, English remains available from the language menu, and
+the version menu switches between `latest` and frozen release documentation.
+Search is scoped to the active language and version. Both surfaces use the
+same deployment base, so preview, Pages, and fork deployments keep working
 without hard-coded return URLs.
 
 - [Live Playground](https://a3s-lab.github.io/Office/)
 - [Documentation center](https://a3s-lab.github.io/Office/docs/)
+- [A3S Office 0.2.0 documentation](https://a3s-lab.github.io/Office/docs/0.2.0/)
+- [A3S Office 0.1.0 documentation](https://a3s-lab.github.io/Office/docs/0.1.0/)
 - [React, Vue, and Web Component integration](https://a3s-lab.github.io/Office/docs/components/)
 - [Office CLI and coding-agent Skill](https://a3s-lab.github.io/Office/docs/automation/)
-- [Browser editor architecture](docs/browser-editor-architecture.md)
-- [Native Office engine](docs/native-office-engine.md)
-- [CLI reference](docs/cli-reference.md)
-- [Editor quality roadmap](docs/editor-quality-roadmap.md)
+- [Browser editor architecture](docs/latest/en/browser-editor-architecture.md)
+- [Native Office engine](docs/latest/en/native-office-engine.md)
+- [CLI reference](docs/latest/en/cli-reference.md)
+- [Editor quality roadmap](docs/latest/en/editor-quality-roadmap.md)
 - [Changelog](CHANGELOG.md)
 
 ## Community and security