@a3s-lab/office 0.29.0 → 0.30.0

package/dist/internal/features/work/work-types.d.ts

@@ -196,6 +196,7 @@ export interface WorkSpreadsheetCellRange {
     row: [number, number];
     column: [number, number];
 }
+export type WorkSpreadsheetDataValidationErrorStyle = 'information' | 'stop' | 'warning';
 export interface WorkSpreadsheetDataValidationItem {
     type: string;
     type2: string;
@@ -204,8 +205,16 @@ export interface WorkSpreadsheetDataValidationItem {
     value2: string;
     validity: string;
     remote: boolean;
+    /** Defaults to true for legacy A3S artifacts. */
+    allowBlank?: boolean;
+    /** Product semantic; OOXML stores the inverse in `showDropDown`. */
+    showDropdownArrow?: boolean;
     prohibitInput: boolean;
+    errorStyle?: WorkSpreadsheetDataValidationErrorStyle;
+    errorTitle?: string;
+    errorMessage?: string;
     hintShow: boolean;
+    hintTitle?: string;
     hintValue: string;
     checked?: boolean;
 }

package/dist/internal/kernel/office-kernel-protocol.d.ts

@@ -140,6 +140,7 @@ export interface OfficeKernelTextLayoutRun {
     fallbackFontIds?: string[];
     fontSize: number;
     lineHeight: number;
+    language?: string;
     letterSpacing?: number;
     ligatures?: boolean;
     kerning?: boolean;

package/dist/styles.css

@@ -9718,7 +9718,7 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
   display: grid;
 }
 
-.work-document-font-dialog-run-border {
+.work-document-font-dialog-run-border, .work-document-font-dialog-run-shading {
   border: 1px solid color-mix(in srgb, var(--a3s-line) 78%, transparent);
   background: var(--a3s-panel-soft);
   border-radius: 8px;
@@ -9731,7 +9731,11 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
   display: grid;
 }
 
-.work-document-font-dialog-run-border > legend {
+.work-document-font-dialog-run-shading {
+  grid-template-columns: repeat(4, minmax(0, 1fr));
+}
+
+.work-document-font-dialog-run-border > legend, .work-document-font-dialog-run-shading > legend {
   color: var(--a3s-muted);
   padding: 0 4px;
   font-size: 11px;
@@ -9815,7 +9819,7 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
     grid-template-columns: repeat(2, minmax(0, 1fr));
   }
 
-  .work-document-font-dialog-run-border {
+  .work-document-font-dialog-run-border, .work-document-font-dialog-run-shading {
     grid-template-columns: minmax(0, 1fr);
   }
 
@@ -9828,6 +9832,104 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
   }
 }
 
+.work-document-proofing-dialog {
+  width: min(640px, 100%);
+}
+
+.work-document-proofing-dialog form {
+  gap: 16px;
+  display: grid;
+}
+
+.work-document-proofing-dialog fieldset {
+  border: 1px solid var(--a3s-line);
+  border-radius: 10px;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 14px;
+  margin: 0;
+  padding: 15px 16px 17px;
+  display: grid;
+}
+
+.work-document-proofing-dialog legend {
+  color: var(--a3s-ink);
+  padding: 0 5px;
+  font-size: 11px;
+  font-weight: 700;
+}
+
+.work-document-proofing-dialog-language {
+  align-content: start;
+  gap: 6px;
+  min-width: 0;
+  display: grid;
+}
+
+.work-document-proofing-dialog-language > label, .work-document-proofing-dialog-state-label {
+  color: var(--a3s-muted);
+  font-size: 11px;
+  font-weight: 650;
+}
+
+.work-document-proofing-dialog-language > div {
+  grid-template-columns: minmax(0, 1fr) auto;
+  gap: 6px;
+  display: grid;
+}
+
+.work-document-proofing-dialog-language .work-office-text-field {
+  width: 100%;
+  min-width: 0;
+}
+
+.work-document-proofing-dialog-language .ds-button {
+  white-space: nowrap;
+  padding-inline: 9px;
+}
+
+.work-document-proofing-dialog-language > p, .work-document-proofing-dialog-state > p, .work-document-proofing-dialog-help, .work-document-proofing-dialog-error {
+  margin: 0;
+  font-size: 11px;
+  line-height: 1.5;
+}
+
+.work-document-proofing-dialog-language > p, .work-document-proofing-dialog-state > p, .work-document-proofing-dialog-help {
+  color: var(--a3s-muted);
+}
+
+.work-document-proofing-dialog-state {
+  border: 1px solid var(--a3s-line);
+  background: var(--a3s-panel-soft);
+  border-radius: 10px;
+  grid-template-columns: minmax(110px, auto) minmax(220px, 1fr);
+  align-items: center;
+  gap: 8px 14px;
+  padding: 14px 16px;
+  display: grid;
+}
+
+.work-document-proofing-dialog-state > p {
+  grid-column: 1 / -1;
+}
+
+.work-document-proofing-dialog-state .work-office-select, .work-document-proofing-dialog-state button[role="combobox"] {
+  width: 100%;
+}
+
+.work-document-proofing-dialog-help code {
+  color: var(--a3s-ink);
+}
+
+.work-document-proofing-dialog-error {
+  color: var(--a3s-red);
+}
+
+@media (width <= 620px) {
+  .work-document-proofing-dialog fieldset, .work-document-proofing-dialog-state {
+    grid-template-columns: minmax(0, 1fr);
+  }
+}
+
 [data-office-character-position-half-points] {
   vertical-align: var(--work-document-character-position);
 }
@@ -12453,6 +12555,200 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
   padding: 0;
 }
 
+.work-document-table-of-contents {
+  box-sizing: border-box;
+  border: 1px solid color-mix(in srgb, var(--a3s-line) 82%, #8aa7d8);
+  background: color-mix(in srgb, var(--a3s-panel) 96%, #edf4ff);
+  width: 100%;
+  color: var(--a3s-ink);
+  cursor: default;
+  border-radius: 6px;
+  margin: 14px 0 20px;
+  padding: 14px 16px 16px;
+}
+
+.work-document-table-of-contents.ProseMirror-selectednode {
+  border-color: var(--a3s-blue);
+  outline: 2px solid color-mix(in srgb, var(--a3s-blue) 22%, transparent);
+  outline-offset: 2px;
+}
+
+.work-document-table-of-contents-header {
+  border-bottom: 1px solid var(--a3s-line);
+  justify-content: space-between;
+  align-items: baseline;
+  gap: 12px;
+  margin-bottom: 10px;
+  padding-bottom: 7px;
+  display: flex;
+}
+
+.work-document-table-of-contents-header strong {
+  font-family: var(--a3s-font-display, inherit);
+  letter-spacing: -.02em;
+  font-size: 18px;
+  font-weight: 680;
+}
+
+.work-document-table-of-contents-header span {
+  color: var(--a3s-muted);
+  font-variant-numeric: tabular-nums;
+  font-size: 9px;
+}
+
+.work-document-table-of-contents-list {
+  gap: 3px;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  display: grid;
+}
+
+.work-document-table-of-contents-list > li {
+  min-width: 0;
+  padding-left: calc((var(--work-toc-level, 1) - 1) * 16px);
+  align-items: baseline;
+  gap: 5px;
+  font-size: 11px;
+  line-height: 1.6;
+  display: flex;
+}
+
+.work-document-table-of-contents-list a, .work-document-table-of-contents-list li > span:first-child {
+  color: inherit;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  text-decoration: none;
+  overflow: hidden;
+}
+
+.work-document-table-of-contents-list a:hover {
+  color: var(--a3s-blue);
+  text-decoration: underline;
+}
+
+.work-document-table-of-contents-list i {
+  border-bottom: 1px dotted
+    color-mix(in srgb, var(--a3s-muted) 68%, transparent);
+  flex: 24px;
+  min-width: 12px;
+  transform: translateY(-2px);
+}
+
+.work-document-table-of-contents[data-toc-leader="dash"] .work-document-table-of-contents-list i {
+  border-bottom-style: dashed;
+}
+
+.work-document-table-of-contents[data-toc-leader="underline"] .work-document-table-of-contents-list i {
+  border-bottom-style: solid;
+}
+
+.work-document-table-of-contents[data-toc-leader="none"] .work-document-table-of-contents-list i, .work-document-table-of-contents[data-toc-right-align-page-numbers="false"] .work-document-table-of-contents-list i {
+  border: 0;
+  flex: 0 0 5px;
+  min-width: 5px;
+}
+
+.work-document-table-of-contents-page {
+  font-variant-numeric: tabular-nums;
+  flex: none;
+}
+
+.work-document-table-of-contents-empty {
+  color: var(--a3s-muted);
+  font-style: italic;
+  padding-left: 0 !important;
+}
+
+.work-document-table-of-contents-dialog {
+  width: min(520px, 100%);
+}
+
+.work-document-table-of-contents-dialog-grid {
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 10px;
+  display: grid;
+}
+
+.work-document-table-of-contents-dialog-field, .work-document-table-of-contents-dialog-leader {
+  min-width: 0;
+  color: var(--a3s-muted);
+  gap: 6px;
+  font-size: 10px;
+  display: grid;
+}
+
+.work-document-table-of-contents-dialog-grid .work-office-select, .work-document-table-of-contents-dialog-leader .work-office-select {
+  width: 100%;
+}
+
+.work-document-table-of-contents-dialog-options {
+  border: 1px solid var(--a3s-line);
+  background: var(--a3s-panel-soft);
+  border-radius: 7px;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 8px;
+  margin: 14px 0;
+  padding: 10px;
+  display: grid;
+}
+
+.work-document-table-of-contents-dialog-preview {
+  border: 1px solid var(--a3s-line);
+  background: var(--a3s-bg);
+  min-width: 0;
+  color: var(--a3s-ink);
+  border-radius: 7px;
+  gap: 5px;
+  margin-top: 14px;
+  padding: 14px;
+  font-size: 10px;
+  display: grid;
+}
+
+.work-document-table-of-contents-dialog-preview > legend {
+  margin-bottom: 4px;
+  font-size: 14px;
+}
+
+.work-document-table-of-contents-dialog-preview > span {
+  align-items: baseline;
+  gap: 5px;
+  display: flex;
+}
+
+.work-document-table-of-contents-dialog-preview > span.nested {
+  padding-left: 16px;
+}
+
+.work-document-table-of-contents-dialog-preview i {
+  border-bottom: 1px dotted var(--a3s-muted);
+  flex: 1;
+}
+
+.work-document-table-of-contents-dialog-preview[data-toc-leader="dash"] i {
+  border-bottom-style: dashed;
+}
+
+.work-document-table-of-contents-dialog-preview[data-toc-leader="underline"] i {
+  border-bottom-style: solid;
+}
+
+.work-document-table-of-contents-dialog-preview[data-toc-leader="none"] i, .work-document-table-of-contents-dialog-preview[data-toc-right-align-page-numbers="false"] i {
+  border: 0;
+  flex: 0 0 5px;
+}
+
+@media (width <= 520px) {
+  .work-document-table-of-contents {
+    padding-inline: 12px;
+  }
+
+  .work-document-table-of-contents-dialog-grid, .work-document-table-of-contents-dialog-options {
+    grid-template-columns: 1fr;
+  }
+}
+
 .work-document-equation {
   vertical-align: -.12em;
   border-radius: .2em;
@@ -17080,6 +17376,17 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
   padding: 8px 10px;
 }
 
+.work-spreadsheet-data-validation-message-grid {
+  grid-template-columns: minmax(0, .7fr) minmax(0, 1.3fr);
+  align-items: start;
+  gap: 10px;
+  display: grid;
+}
+
+.work-spreadsheet-data-validation-message-grid .ds-field.message {
+  grid-column: 1 / -1;
+}
+
 .work-spreadsheet-data-validation-dialog textarea {
   resize: vertical;
   min-height: 70px;
@@ -17096,7 +17403,7 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
 }
 
 @media (width <= 560px) {
-  .work-spreadsheet-data-validation-condition-grid, .work-spreadsheet-data-validation-values.two, .work-spreadsheet-data-validation-behavior {
+  .work-spreadsheet-data-validation-condition-grid, .work-spreadsheet-data-validation-values.two, .work-spreadsheet-data-validation-behavior, .work-spreadsheet-data-validation-message-grid {
     grid-template-columns: minmax(0, 1fr);
   }
 }

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

@@ -94,7 +94,22 @@ 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.
+   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 +736,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.30.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -90,7 +90,9 @@
     "playground:visual:document-emphasis": "playwright test visual-tests/document-emphasis.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 +134,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 +180,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 +206,14 @@
     "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-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",