@a3s-lab/office 0.29.0 → 0.31.0

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

@@ -94,7 +94,36 @@ model:
    instructionless structures keep their rendered result as text and emit a
    structural compatibility warning instead of being flattened into a false
    editable field. Native export writes live simple fields and requests a Word
-   field update on open. Page Layout keeps direct margin, orientation, paper,
+   field update on open. Table of Contents is a separate block atom because its
+   native field spans cached paragraphs. It reads semantic headings and native
+   outline-level paragraphs only from the shared outline collector, reads page
+   numbers only from the pagination field resolver, and stores bounded options
+   plus at most 512 cached entries. Included outline items without a native
+   paragraph identity receive one in the insert/update transaction, so a block
+   insertion cannot invalidate its own targets. One
+   References dialog owns insert and selected-block customization; explicit
+   refresh updates every TOC in one transaction. DOCX export emits a real
+   `w:sdt`/`TOC` field, patches native leader and alignment semantics, and adds
+   stable heading bookmarks. Import accepts only the lossless common switch
+   subset and removes the complete content control before Mammoth conversion,
+   then restores one typed block after paragraph identities are applied. Each
+   imported TOC matches its cached rows independently, so repeated TOCs can
+   target the same heading.
+   Native indexes use a separate inline `documentIndexEntry` atom and block
+   `documentIndex` atom. The inline node owns stable identity plus primary,
+   secondary, cross-reference, and page-emphasis intent; the block owns only
+   bounded options, generated rows, and truncation state. One collector walks
+   the canonical TipTap document, obtains pages from the existing field-context
+   resolver, groups normalized terms, and merges same-page markers while
+   retaining every target ID. Mark/edit and block insert/customize/refresh each
+   dispatch one transaction. DOCX export maps inline atoms to native
+   `w:fldSimple` `XE` fields, writes an `INDEX` content control through an
+   isolated marker collector/patcher, and emits cached `Index1`/`Index2` rows.
+   Import marks supported XE boundaries and removes supported INDEX controls
+   before Mammoth conversion, then reconstructs typed atoms and reconnects
+   cached page rows to matching marker identities. Unsupported switches and
+   malformed structures remain on the field diagnostic path.
+   Page Layout keeps direct margin, orientation, paper,
    and equal-column presets in the ribbon; custom margins and advanced columns
    open the corresponding controlled Page Setup tab instead of duplicating a
    second settings model. References separates footnotes, captions, citations
@@ -721,6 +750,40 @@ written. This keeps direct/style inheritance and prior `w:rPrChange` values
 exact while treating browser and PDF line-style paint as a bounded visual
 approximation.
 
+Native character shading follows a separate paint-only TextStyle path. The
+closed `w:shd` model accepts every schema pattern, independent direct,
+automatic, or resolved-theme foreground/background channels, tint and shade,
+and explicit `nil`. Property sources are resolved from document defaults,
+paragraph and character styles, conditional table styles, and direct run
+properties in native precedence order. Invalid direct leaves normalize to
+`nil`, so stale inherited paint cannot reappear.
+
+The canonical mark stores bounded JSON in `data-office-run-shading`; CSS
+projects solid, line, cross, and percentage masks with cloned fragments. These
+declarations do not alter advances, so shading remains Worker/WASM eligible.
+Native highlight is retained as an independent mark and paints above shading.
+Export allocates a collision-checked temporary fill only on generated text
+runs, patches it to the exact `w:shd` attributes across editable stories, and
+then writes exact prior values into `w:rPrChange`.
+
+Native proofing metadata follows a separate semantic TextStyle path. A closed
+`w:lang` model retains Latin `w:val`, East Asian `w:eastAsia`, and bidi `w:bidi` slots
+plus explicit `w:noProof` true or false state across style resolution and every
+editable story. The canonical DOM mark uses bounded JSON in
+`data-office-proofing-languages` and an explicit Boolean in
+`data-office-no-proof`; derived `lang` and `spellcheck` attributes are display
+and browser-proofing projections, not replacement source state. Duplicate,
+misplaced, nested, text-bearing, extra-attribute, namespace-spoofed, invalid-tag,
+or invalid on/off leaves fail closed and emit compatibility diagnostics.
+
+The text-layout collector resolves the effective inherited `lang` for each DOM
+run, validates the same bounded tag grammar, and includes it in the run-style
+coalescing key. The optional protocol field is backward compatible: missing
+language keeps existing shaping, while a valid value is validated again in
+Rust and set on the RustyBuzz `UnicodeBuffer` before segment-property guessing
+and shaping. This makes language-sensitive glyph selection deterministic
+without coupling pagination to a browser dictionary or host grammar service.
+
 Tables, images, code blocks, and other complex content use explicit
 format-specific measurement. Top-level tables are row flows; eligible rows can
 additionally expose synchronized direct-cell block fragments. Ordered and bullet

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.29.0",
+  "version": "0.31.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -88,9 +88,12 @@
     "playground:typecheck": "tsc --noEmit -p playground/tsconfig.json",
     "playground:visual": "playwright test --config playwright.config.ts",
     "playground:visual:document-emphasis": "playwright test visual-tests/document-emphasis.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:document-index": "playwright test visual-tests/document-index.functional.spec.ts --config playwright.config.ts",
     "playground:visual:document-hidden-text": "playwright test visual-tests/document-hidden-text.functional.spec.ts --config playwright.config.ts",
     "playground:visual:document-legacy-text-effects": "playwright test visual-tests/document-legacy-text-effects.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:document-proofing-languages": "playwright test visual-tests/document-proofing-languages.functional.spec.ts --config playwright.config.ts",
     "playground:visual:document-run-border": "playwright test visual-tests/document-run-border.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:document-run-shading": "playwright test visual-tests/document-run-shading.functional.spec.ts --config playwright.config.ts",
     "playground:visual:document-kerning": "playwright test visual-tests/document-kerning.functional.spec.ts --config playwright.config.ts",
     "playground:visual:document-character-scale": "playwright test visual-tests/document-character-scale.functional.spec.ts --config playwright.config.ts",
     "playground:visual:document-character-position": "playwright test visual-tests/document-character-position.functional.spec.ts --config playwright.config.ts",
@@ -132,6 +135,8 @@
     "test:e2e:initial-focus:check": "a3s-test check tests/e2e/office-editor-initial-focus.acl --json",
     "test:e2e:docs": "a3s-test run tests/e2e/office-docs-navigation.acl --json",
     "test:e2e:docs:check": "a3s-test check tests/e2e/office-docs-navigation.acl --json",
+    "test:e2e:latest-capabilities": "A3S_TEST_SUITE=tests/e2e/latest-capabilities-discoverability.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:latest-capabilities:check": "a3s-test check tests/e2e/latest-capabilities-discoverability.acl --json",
     "test:e2e:collaboration-participants": "a3s-test run tests/e2e/collaboration-participants.acl --json",
     "test:e2e:collaboration-participants:check": "a3s-test check tests/e2e/collaboration-participants.acl --json",
     "test:e2e:collaboration-playground": "a3s-test run tests/e2e/collaboration-playground-entry.acl --json",
@@ -176,7 +181,7 @@
     "test:e2e:spreadsheet-gradient-fill:check": "a3s-test check tests/e2e/spreadsheet-gradient-fill.acl --json",
     "test:e2e:spreadsheet-go-to": "a3s-test run tests/e2e/spreadsheet-go-to.acl --json",
     "test:e2e:spreadsheet-go-to:check": "a3s-test check tests/e2e/spreadsheet-go-to.acl --json",
-    "test:e2e:spreadsheet-data-validation": "a3s-test run tests/e2e/spreadsheet-data-validation.acl --json",
+    "test:e2e:spreadsheet-data-validation": "A3S_TEST_SUITE=tests/e2e/spreadsheet-data-validation.acl bash scripts/run-a3s-test-web-gate.sh",
     "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",
@@ -202,8 +207,16 @@
     "test:e2e:writer-hidden-text:check": "a3s-test check tests/e2e/word-hidden-text.acl --json",
     "test:e2e:writer-legacy-text-effects": "A3S_TEST_SUITE=tests/e2e/word-legacy-text-effects.acl bash scripts/run-a3s-test-web-gate.sh",
     "test:e2e:writer-legacy-text-effects:check": "a3s-test check tests/e2e/word-legacy-text-effects.acl --json",
+    "test:e2e:writer-proofing-languages": "A3S_TEST_SUITE=tests/e2e/word-proofing-languages.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:writer-proofing-languages:check": "a3s-test check tests/e2e/word-proofing-languages.acl --json",
+    "test:e2e:writer-table-of-contents": "A3S_TEST_SUITE=tests/e2e/word-table-of-contents.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:writer-table-of-contents:check": "a3s-test check tests/e2e/word-table-of-contents.acl --json",
+    "test:e2e:writer-document-index": "A3S_TEST_SUITE=tests/e2e/word-document-index.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:writer-document-index:check": "a3s-test check tests/e2e/word-document-index.acl --json",
     "test:e2e:writer-run-border": "A3S_TEST_SUITE=tests/e2e/word-run-border.acl bash scripts/run-a3s-test-web-gate.sh",
     "test:e2e:writer-run-border:check": "a3s-test check tests/e2e/word-run-border.acl --json",
+    "test:e2e:writer-run-shading": "A3S_TEST_SUITE=tests/e2e/word-run-shading.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:writer-run-shading:check": "a3s-test check tests/e2e/word-run-shading.acl --json",
     "test:e2e:writer-kerning": "A3S_TEST_SUITE=tests/e2e/word-kerning.acl bash scripts/run-a3s-test-web-gate.sh",
     "test:e2e:writer-kerning:check": "a3s-test check tests/e2e/word-kerning.acl --json",
     "test:e2e:writer-character-scale": "A3S_TEST_SUITE=tests/e2e/word-character-scale.acl bash scripts/run-a3s-test-web-gate.sh",