@a3s-lab/office 0.34.0 → 0.36.0

package/README.md

@@ -13,13 +13,13 @@
 
 <p align="center">
   <a href="https://github.com/A3S-Lab/Office/actions/workflows/ci.yml"><img alt="CI status" src="https://img.shields.io/github/actions/workflow/status/A3S-Lab/Office/ci.yml?branch=main&amp;style=flat-square&amp;label=CI"></a>
-  <a href="https://a3s-lab.github.io/Office/"><img alt="Open the live Playground" src="https://img.shields.io/badge/Live_Playground-open-2f6fed?style=flat-square"></a>
+  <a href="https://a3s-lab.github.io/Office/playground/"><img alt="Open the live Playground" src="https://img.shields.io/badge/Live_Playground-open-2f6fed?style=flat-square"></a>
   <a href="#project-status"><img alt="Project status: pre-1.0" src="https://img.shields.io/badge/status-pre--1.0-7a5bd6?style=flat-square"></a>
   <a href="LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-159469?style=flat-square"></a>
 </p>
 
 <p align="center">
-  <a href="https://a3s-lab.github.io/Office/">Playground</a> ·
+  <a href="https://a3s-lab.github.io/Office/playground/">Playground</a> ·
   <a href="https://a3s-lab.github.io/Office/docs/">Documentation</a> ·
   <a href="#quick-start">Quick start</a> ·
   <a href="#editor-capability-comparison">Editors</a> ·
@@ -56,9 +56,8 @@ workflows, and a separate Rust automation plane.
 
 ## Latest on `main`
 
-The `0.34.0` release plus the current `main` branch expose these capabilities
-as normal user-facing Playground templates, with matching implementation
-detail in the documentation:
+The `0.36.0` release exposes these capabilities as normal user-facing
+Playground templates, with matching implementation detail in the documentation:
 
 | Editor | Latest capability | Public entry |
 | --- | --- | --- |
@@ -69,18 +68,20 @@ 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) |
 | PDF | Insert, delete, rotate, reorder, extract, merge, and split pages through a dedicated Web Worker, with Blob-level Undo/Redo and independent binary reopen verification | Playground **Latest capabilities → 组织 PDF 页面** · [PDF reference](docs/latest/en/components/pdf.mdx#page-organization) |
 
-All eight entries are reachable from the first Playground viewport. The seven
-content templates also remain under **新建**; **组织 PDF 页面** opens the normal
-PDF file workflow because page organization must operate on host-provided source
-bytes. The highlighted strip keeps each capability discoverable without a deep
-documentation section or an `?e2e=` fixture.
+All nine entries are reachable from the first Playground viewport. The
+filterable capability gallery groups releases by editor, publishes the source
+release on every card, and grows from one shared metadata list instead of a
+fixed-width strip. The eight content templates also remain under **新建**;
+**组织 PDF 页面** opens the normal PDF file workflow because page organization
+must operate on host-provided source bytes.
 
 ## See it working
 
 The images below are committed visual-regression baselines from the real
-[Playground](https://a3s-lab.github.io/Office/), not conceptual mockups.
+[Playground](https://a3s-lab.github.io/Office/playground/), not conceptual mockups.
 
 <p align="center">
   <a href="visual-tests/__snapshots__/linux/desktop-1280/document.png">
@@ -150,8 +151,8 @@ baseline rather than one specific release.
 | Cells, sheets, navigation, and history | **Supported** — multiple sheets, sparse editing, search, clipboard, four-direction fill, exact formula/value copy from above, and undo/redo | Mature grid workflows across desktop and web |
 | Formatting and style rendering | **Partial** — native fonts, colors, borders, alignment, number formats, cell styles, 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 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 common validation rules with complete input/error-setting authoring | Calculated columns, slicers, pivot charts, custom/dependent validation rules, advanced analysis, and broader browser alert flows |
+| 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 |
 | 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 |
@@ -364,7 +365,7 @@ bun run playground
 ```
 
 Then open the local URL printed by the development server. For a zero-install
-tour, use the [live Playground](https://a3s-lab.github.io/Office/).
+tour, use the [live Playground](https://a3s-lab.github.io/Office/playground/).
 Choose **体验格式修订**, open **审阅**, then **查看修订（2）** to inspect the
 independent Formatting and Paragraph Formatting cards and exercise accept or
 reject semantics.
@@ -739,9 +740,25 @@ stable IDs, workbook-unique names, zero-based ranges, ordered columns, filters,
 header/totals flags, and built-in style identity. XLSX import and export keep
 native table parts and relationships. Table styling is resolved only for the
 visible Canvas cells; converting a table to a range materializes the confirmed
-appearance without densifying unrelated worksheet space. Structured-reference
-calculation, calculated columns, complete totals authoring, slicers, and
-external/query tables are not yet claimed.
+appearance without densifying unrelated worksheet space.
+
+The calculation kernel resolves a bounded common structured-reference subset:
+table names or `displayName`, worksheet-qualified tables, contiguous column
+ranges, `#All`, `#Headers`, `#Data`, `#Totals`, `#This Row`, and table-local
+`[@Column]` formulas. Rust/WASM and JavaScript fallback share the parser,
+catalog, dependency graph, and no-history projection path. Requests accept at
+most 1,024 tables and materialize at most 100,000 cells per structured range;
+whole-row/column, three-dimensional, external, disjoint, missing, or
+over-budget references fail closed. A validated calculated-column rule is
+inferred from matching current-row formulas and fills only newly inserted table
+body rows. Existing values, formulas, and manual exceptions always win; a
+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.
 
 Use `downloadArtifact` to start a browser download or
 `createArtifactBlob` when your application owns upload and persistence.
@@ -1613,16 +1630,18 @@ committed visual contracts; see [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Documentation
 
-The published website keeps the interactive Playground at its root and builds
-the searchable Rspress documentation center under `/docs/`. Simplified Chinese
-is the stable default, English remains available from the language menu, and
-the version menu switches between `latest` and frozen release documentation.
-Search is scoped to the active language and version. Both surfaces use the
-same deployment base, so preview, Pages, and fork deployments keep working
-without hard-coded return URLs.
+The published website follows the A3S UI documentation model: the searchable
+Rspress documentation center owns the website root, while Playground is a
+primary top-navigation route under `/playground/`. Simplified Chinese is the
+stable default, English remains available from the language menu, and the
+version menu switches between `latest` and frozen release documentation.
+Search is scoped to the active language and version. Both surfaces derive
+their paths from one deployment base, so preview, Pages, and fork deployments
+keep working without hard-coded return URLs.
 
-- [Live Playground](https://a3s-lab.github.io/Office/)
+- [Live Playground](https://a3s-lab.github.io/Office/playground/)
 - [Documentation center](https://a3s-lab.github.io/Office/docs/)
+- [A3S Office 0.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/)
 - [A3S Office 0.32.0 documentation](https://a3s-lab.github.io/Office/docs/0.32.0/)