@a3s-lab/office 0.28.0 → 0.30.0

package/README.md

@@ -54,6 +54,23 @@ workflows, and a separate Rust automation plane.
 - **Automate deterministically** through the native CLI, standard MCP server,
   or packaged Office Skill.
 
+## Latest on `main`
+
+The `0.30.0` release and current Pages deployment expose these capabilities as
+normal user-facing Playground templates, with matching implementation detail
+in the versioned documentation:
+
+| Editor | Latest capability | Public entry |
+| --- | --- | --- |
+| Writer | Insert, customize, navigate, and explicitly refresh a typed Table of Contents with heading and native outline levels 1–9, hyperlinks, page numbers, alignment, four leader styles, and native DOCX `TOC` round trips | Playground **Latest capabilities → 可更新目录** · [Document reference](docs/latest/en/components/document.mdx#native-table-of-contents) |
+| 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) |
+
+The same four entries remain available under **新建**. The highlighted strip
+exists so a capability is discoverable from the first Playground viewport
+instead of only through a deep documentation section or an `?e2e=` fixture.
+
 ## See it working
 
 The images below are committed visual-regression baselines from the real
@@ -110,11 +127,11 @@ baseline rather than one specific release.
 
 | Capability | A3S Office today | Traditional Office baseline |
 | --- | --- | --- |
-| Text, paragraphs, lists, and styles | **Supported** — structured editing, independent native ASCII, high ANSI, East Asian, and complex-script font slots with direct/theme identity, native all-caps and small-caps effects, exact DOCX character scale plus signed spacing, half-point kerning thresholds, all five native East Asian emphasis marks, native hidden text with explicit visible resets, four independent native outline/shadow/emboss/imprint effects with conflict-safe authoring, and baseline position in one advanced font dialog, all 18 native DOCX underline values with direct or theme color identity, independent native single/double strikethrough with explicit resets, formatting revisions, clipboard, format painter, and undo/redo | Mature authoring with a broader long-tail style and typography catalog |
+| Text, paragraphs, lists, and styles | **Supported** — structured editing, independent native ASCII, high ANSI, East Asian, and complex-script font slots with direct/theme identity, independent Latin/East Asian/bidi proofing-language slots and explicit proofing inclusion/exclusion, native all-caps and small-caps effects, exact DOCX character scale plus signed spacing, half-point kerning thresholds, all five native East Asian emphasis marks, native hidden text with explicit visible resets, native character borders with 25 visible line styles plus `nil` and `none`, direct or theme color, width, spacing, shadow, and frame semantics, four independent native outline/shadow/emboss/imprint effects with conflict-safe authoring, and baseline position in one advanced font dialog, all 18 native DOCX underline values with direct or theme color identity, independent native single/double strikethrough with explicit resets, formatting revisions, clipboard, format painter, and undo/redo | Mature authoring with a broader long-tail style and typography 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 |
+| References and document generation | **Partial** — typed Table of Contents authoring and refresh, bookmarks, links, captions, cross-references, citations, notes, and common fields | 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 |
@@ -127,7 +144,7 @@ baseline rather than one specific release.
 | Formatting and style rendering | **Partial** — native fonts, colors, borders, alignment, number formats, cell styles, all 17 native non-solid OOXML pattern fills, native linear/path XLSX gradients, and one Format Cells surface that authors none, solid, pattern, or gradient fills with exact geometry and 2–256 ordered stops; static date/time entry, contrast-safe font preview, native XLSX rich-text runs, selected-text font formatting, direct formula-bar/F2 insertion or deletion, and bounded authenticated formatted-HTML paste | Disjoint multi-edit rich-text authoring, broader themes, locale formats, and advanced style effects |
 | Ribbon and shortcuts | **Partial** — common Office-style Home/Data/View commands, grid-scoped shortcuts, and focused Font-dialog aliases | Larger command catalog and platform-specific accelerators |
 | Formulas and recalculation | **Partial** — dependency-aware calculation 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 |
+| 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 |
 | Large worksheets | **Supported with boundaries** — maximum-dimension sparse import/editing and viewport-bounded Canvas painting | Highly optimized native grid with hardware-dependent limits |
 | Files and printing | **Partial** — XLS/XLSX/ODS/CSV import, XLSX export, and PDF output | Broader round trips, external data, print fidelity, and legacy conversion |
 | External data, macros, and specialist analysis | **Gap** — active macros are never executed; bounded models are still needed for data connections and solver-like tools | Established data, macro/add-in, scenario, and optimization ecosystems |
@@ -216,6 +233,19 @@ is requested. The complete gap inventory and exit evidence live in the
   undoable action. Safe inline DOCX fields round-trip natively, while nested,
   incomplete, cross-paragraph, deleted, or instructionless structures stay
   text and produce an explicit compatibility warning.
+  Writer Table of Contents blocks reuse the same heading outline and live
+  Worker/WASM page resolver instead of maintaining parallel heading or page
+  state. Insert, customize, and explicit refresh each commit one TipTap
+  transaction and one Undo record. Semantic headings and native outline-level
+  paragraphs cover levels 1–9; included items without a native paragraph
+  identity receive one in the same transaction so hyperlinks survive
+  structural edits. Page-number visibility and alignment,
+  dot/dash/underline/no leaders, and at most 512 cached entries remain typed in
+  the DOM. DOCX export writes a native `w:sdt`/`TOC` content control and live
+  field with cached entries; import accepts the common `\\o`, `\\h`, `\\z`,
+  `\\u`, full-range `\\n`, and space-separator `\\p` subset while diagnosing
+  lossy custom style mappings. The Playground's **可更新目录** template exposes
+  the complete flow.
 - **Framework choice** — React components, Vue 3 adapters, Custom Elements,
   and a framework-neutral Core API over the same engine.
 - **Responsive computation** — Lazy editor chunks, cancellable Workers,
@@ -577,6 +607,34 @@ Protection ranges, passwordless editable ranges, and conditional formatting
 also remain compact and round-trip through native XLSX records without
 allocating every covered cell.
 
+### Complete Spreadsheet data-validation settings
+
+Data → Data Validation authors list, whole-number, decimal, date, and text-length
+rules across one or more selected ranges. The same dialog now owns the complete
+common input and error metadata: `allowBlank`, `showDropdownArrow`,
+`hintTitle`, `hintValue`, `prohibitInput`, `errorStyle`, `errorTitle`, and
+`errorMessage`. Titles are bounded to 32 Unicode code points, the input message
+to 255, and the error message to 225. Disabling a message keeps its text so a
+later re-enable does not discard the user's draft.
+
+The mounted grid reads compact rules without expanding blank cells, honors
+`allowBlank`, can hide the in-cell list arrow, shows the authored input title
+and message, and uses the authored error title and message when rejecting an
+invalid value. The current Fortune boundary still has one blocking browser
+alert path whenever error alerts are enabled. `stop`, `warning`, and
+`information` therefore round-trip as exact native file semantics, but the
+browser does not yet reproduce the separate warning/information confirmation
+branches of a desktop suite. Custom formulas and dependent lists also remain
+explicit gaps.
+
+XLSX import and export preserve `allowBlank`, `showErrorMessage`,
+`showInputMessage`, `errorStyle`, `errorTitle`, `error`, `promptTitle`, and
+`prompt`. The public `showDropdownArrow` name describes what users see, while
+SpreadsheetML stores the inverse in `showDropDown`. On the public Playground
+home page, choose **新建 → 数据验证** to inspect list, date, and priority
+examples with all three alert styles. This is a normal user-facing template,
+not an `?e2e=` fixture or a documentation-only example.
+
 Native XLSX pattern fills retain all 17 non-solid OOXML pattern identities plus
 their foreground and background RGB, theme, indexed, automatic, and tint color
 origins. Canvas draws them only for visible cells, behind text and below table
@@ -732,6 +790,69 @@ model. CSS provides bounded browser and PDF paint projections while eligible
 paragraphs remain on the Worker/WASM layout path. The Playground's **文字效果**
 template demonstrates all four effects and the conflict-safe transition.
 
+Native Writer character borders retain all 25 visible WordprocessingML
+`w:bdr` line styles plus explicit `nil` and `none` resets. The typed model keeps
+direct or theme colors with tint and shade, widths from 2 through 96
+eighth-points, text spacing from 0 through 31 points, and explicit shadow and
+frame flags. The Home Font group exposes a direct Character Border toggle, and
+the shared `Cmd/Ctrl+D` Advanced Font Settings dialog distinguishes mixed,
+Follow style, explicit no-border, and editable border states. Line style,
+color, width, spacing, shadow, and frame changes apply through one transaction
+and one Undo record; Format Painter uses the same mark. Traditional Office
+defines no dedicated shortcut for this command, so A3S Office does not invent
+one.
+
+Document defaults, paragraph and character styles, body text, headers,
+footers, footnotes, endnotes, formatting revisions, strict or transitional
+DOCX import, exact export, and reopen share the model. Malformed, duplicated,
+misplaced, namespace-spoofed, child- or text-bearing, extra-attribute,
+art-style, out-of-range, and unresolved-theme input fails closed. The DOM uses
+`data-office-run-border`; CSS renders every edge with bounded line-style,
+padding, shadow, and cloned-fragment projections. Visible character borders use
+browser-authoritative line measurement because border and padding alter inline
+geometry, while explicit `nil` and `none` remain eligible for Worker/WASM
+layout. Browser and PDF paint are bounded visual approximations; the OOXML
+semantics remain exact. The Playground's **字符边框** template exercises the
+complete authoring and one-step Undo path.
+
+Native Writer character shading retains one exact `w:shd` value rather than a
+flattened CSS fill. The typed model preserves every WordprocessingML pattern,
+direct or automatic foreground/background colors, independent theme channels
+with tint and shade, and explicit `nil`. Document defaults, paragraph and
+character styles, conditional table styles, body, page chrome, notes,
+formatting revisions, strict/transitional import, exact export, and reopen use
+the same resolver. Invalid or spoofed leaves fail closed and are diagnosed.
+
+The shared `Cmd/Ctrl+D` Advanced Font Settings dialog distinguishes mixed,
+Follow style, explicit no-shading, and editable pattern/color states; changes
+commit with Format Painter and one-step Undo semantics. The DOM stores bounded
+JSON in `data-office-run-shading`, while CSS projects patterns without changing
+line geometry, so eligible content stays on the Worker/WASM path. Native
+`w:highlight` remains independent and takes display precedence without
+clobbering shading. The Playground's **字符底纹** template demonstrates the
+complete flow.
+
+Native Writer proofing languages retain the three independent WordprocessingML
+`w:lang` slots: Latin `w:val`, East Asian `w:eastAsia`, and bidi `w:bidi`.
+Native `w:noProof` remains an independent three-state property: inherited,
+explicitly checked with `w:val="false"`, or excluded from proofing. The Review
+ribbon's **设置校对语言** dialog accepts bounded BCP 47 language tags, keeps
+untouched mixed slots unchanged, exposes Follow style for each slot, and applies
+the touched language and proofing-state fields through one transaction and one
+Undo record. The same contract is available while editing headers and footers.
+
+Document defaults, paragraph and character styles, body text, headers,
+footers, footnotes, endnotes, formatting revisions, strict/transitional DOCX
+import, exact export, and reopen share the closed model. Malformed, duplicated,
+misplaced, namespace-spoofed, nested, text-bearing, extra-attribute, invalid-tag,
+or invalid on/off input fails closed and appears in compatibility diagnostics.
+The DOM stores canonical JSON in `data-office-proofing-languages`, stores an
+explicit Boolean in `data-office-no-proof`, and projects the effective `lang`
+and `spellcheck` attributes without claiming a bundled dictionary or grammar
+service. Valid effective languages also reach the Worker/WASM text-layout run
+and RustyBuzz shaping buffer. The Playground's **校对语言** template demonstrates
+Latin, East Asian, bidi, explicitly checked, and excluded states.
+
 Supported native OMML equations now survive as bounded structured objects in
 the document body, headers, footers, footnotes, and endnotes. Inline and display
 math, Unicode runs with literal/normal-text semantics, math script/style,
@@ -1432,6 +1553,8 @@ 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.30.0 documentation](https://a3s-lab.github.io/Office/docs/0.30.0/)
+- [A3S Office 0.29.0 documentation](https://a3s-lab.github.io/Office/docs/0.29.0/)
 - [A3S Office 0.28.0 documentation](https://a3s-lab.github.io/Office/docs/0.28.0/)
 - [A3S Office 0.27.0 documentation](https://a3s-lab.github.io/Office/docs/0.27.0/)
 - [A3S Office 0.26.0 documentation](https://a3s-lab.github.io/Office/docs/0.26.0/)

package/dist/0~1403.js

@@ -1,4 +1,4 @@
-import { createOfficeId as createWorkId } from "./5184.js";
+import { createOfficeId as createWorkId } from "./4121.js";
 function expandPresentationGroupSelection(elements, selectedIds) {
     const byId = new Map();
     const membersByGroupId = new Map();

package/dist/0~4980.js

@@ -1,6 +1,6 @@
 import jszip from "jszip";
 import { documentNoteKey } from "./6282.js";
-import { directChild, xmlNamespacePrefix, attribute, parseXml } from "./5184.js";
+import { directChild, xmlNamespacePrefix, attribute, parseXml } from "./4121.js";
 import { DEFAULT_DOCUMENT_PAGE_COLOR, normalizeDocumentPageColor } from "./0~work-document-page-color.js";
 const MAX_NATIVE_ID = 2147483647;
 const MIN_NATIVE_COMMENT_ID = -2147483648;

package/dist/0~7048.js

@@ -3,7 +3,7 @@ import { useCallback, useEffect, useId, useRef, useState } from "react";
 import { Check, ChevronDown, ChevronUp, Minus } from "lucide-react";
 import { Dialog } from "./0~4595.js";
 import { button_Button, office_text_field_OfficeTextField, office_text_field_OfficeTextArea } from "./0~6090.js";
-import { OFFICE_KERNEL_SPREADSHEET_MAX_ROWS as office_kernel_spreadsheet_protocol_OFFICE_KERNEL_SPREADSHEET_MAX_ROWS, isOfficeKernelSpreadsheetError } from "./5184.js";
+import { OFFICE_KERNEL_SPREADSHEET_MAX_ROWS as office_kernel_spreadsheet_protocol_OFFICE_KERNEL_SPREADSHEET_MAX_ROWS, isOfficeKernelSpreadsheetError } from "./4121.js";
 function CollectionState({ children, icon, actions, tone = 'neutral', role, className = '' }) {
     return /*#__PURE__*/ jsxs("div", {
         className: `ds-collection-state ${tone}${className ? ` ${className}` : ''}`,