@a3s-lab/office 0.28.0 → 0.30.0

package/dist/internal/features/work/work-docx-run-border-export.d.ts

@@ -0,0 +1,17 @@
+import type { IRunOptions } from 'docx';
+import { type DocumentRunBorder } from './work-document-run-border';
+export interface DocxRunBorderPatch {
+    marker: string;
+    border: DocumentRunBorder;
+}
+export declare class DocxRunBorderPatchCollector {
+    readonly patches: DocxRunBorderPatch[];
+    private nextMarker;
+    private readonly usedColors;
+    constructor(sourceHtml: string);
+    marker(source: unknown): string | null;
+    hasMarker(value: string | null | undefined): value is string;
+}
+export declare function documentRunBorderDocxOptions(source: unknown, collector: DocxRunBorderPatchCollector): Pick<IRunOptions, 'border'>;
+export declare function patchDocxRunBorders(buffer: ArrayBuffer, patches: readonly DocxRunBorderPatch[]): Promise<ArrayBuffer>;
+export declare function setDocxRunBorderAttributes(document: Document, element: Element, border: DocumentRunBorder): void;

package/dist/internal/features/work/work-docx-run-border.d.ts

@@ -0,0 +1,20 @@
+import type { DocumentRunBorder } from './work-document-run-border';
+import { type DocxThemeSource } from './work-docx-theme';
+export type DocxRunBorderInspection = {
+    status: 'absent';
+    spoofedCount: number;
+} | {
+    status: 'invalid';
+    spoofedCount: number;
+} | {
+    status: 'valid';
+    value: DocumentRunBorder;
+    spoofedCount: number;
+};
+export interface ResolvedDocxRunBorder {
+    border: DocumentRunBorder | undefined;
+    invalidCount: number;
+    spoofedCount: number;
+}
+export declare function inspectDocxRunBorder(properties: Element | null | undefined, themeSource?: DocxThemeSource): DocxRunBorderInspection;
+export declare function resolveDocxRunBorder(propertySources: readonly Element[], themeSource?: DocxThemeSource): ResolvedDocxRunBorder;

package/dist/internal/features/work/work-docx-run-formatting-import.d.ts

@@ -7,6 +7,10 @@ import { type WorkDocumentTextCase } from './work-document-text-case';
 import { type WorkDocumentUnderlineFormatting } from './work-document-underline';
 import { type WorkDocumentStrikeFormatting } from './work-document-strike';
 import { type WorkDocumentScriptFontSlot, type WorkDocumentScriptFonts } from './work-document-script-fonts';
+import { type DocumentRunBorder } from './work-document-run-border';
+import { type DocumentRunShading } from './work-document-run-shading';
+import { type WorkDocumentHighlight } from './work-document-highlight';
+import { type WorkDocumentProofingLanguages } from './work-document-proofing';
 export interface ImportedDocxRunFormatting {
     bold?: boolean;
     italic?: boolean;
@@ -32,9 +36,14 @@ export interface ImportedDocxRunFormatting {
     fontSize?: number;
     color?: string;
     backgroundColor?: string;
+    highlight?: WorkDocumentHighlight;
     themeColor?: DocxThemeColorReference;
     themeFill?: DocxThemeColorReference;
     textCase?: WorkDocumentTextCase;
+    runBorder?: DocumentRunBorder;
+    runShading?: DocumentRunShading;
+    proofingLanguages?: WorkDocumentProofingLanguages;
+    noProof?: boolean;
 }
 export interface ImportedDocxRunFormattingMarker {
     startMarker: string;

package/dist/internal/features/work/work-docx-run-shading-diagnostics.d.ts

@@ -0,0 +1,3 @@
+import { type OoxmlPackage } from './work-ooxml-package';
+import type { WorkCompatibilityIssue } from './work-types';
+export declare function diagnoseDocxRunShading(archive: OoxmlPackage, document: Document): Promise<WorkCompatibilityIssue[]>;

package/dist/internal/features/work/work-docx-run-shading-export.d.ts

@@ -0,0 +1,17 @@
+import type { IRunOptions } from 'docx';
+import { type DocumentRunShading } from './work-document-run-shading';
+export interface DocxRunShadingPatch {
+    marker: string;
+    shading: DocumentRunShading;
+}
+export declare class DocxRunShadingPatchCollector {
+    readonly patches: DocxRunShadingPatch[];
+    private nextMarker;
+    private readonly usedColors;
+    constructor(sourceHtml: string);
+    marker(source: unknown): string | null;
+    hasMarker(value: string | null | undefined): value is string;
+}
+export declare function documentRunShadingDocxOptions(source: unknown, collector: DocxRunShadingPatchCollector): Pick<IRunOptions, 'shading'>;
+export declare function patchDocxRunShading(buffer: ArrayBuffer, patches: readonly DocxRunShadingPatch[]): Promise<ArrayBuffer>;
+export declare function setDocxRunShadingAttributes(document: Document, element: Element, source: unknown): boolean;

package/dist/internal/features/work/work-docx-run-shading.d.ts

@@ -0,0 +1,20 @@
+import type { DocumentRunShading } from './work-document-run-shading';
+import { type DocxThemeSource } from './work-docx-theme';
+export type DocxRunShadingInspection = {
+    status: 'absent';
+    spoofedCount: number;
+} | {
+    status: 'invalid';
+    spoofedCount: number;
+} | {
+    status: 'valid';
+    value: DocumentRunShading;
+    spoofedCount: number;
+};
+export interface ResolvedDocxRunShading {
+    shading: DocumentRunShading | undefined;
+    invalidCount: number;
+    spoofedCount: number;
+}
+export declare function inspectDocxRunShading(properties: Element | null | undefined, themeSource?: DocxThemeSource): DocxRunShadingInspection;
+export declare function resolveDocxRunShading(propertySources: readonly Element[], themeSource?: DocxThemeSource): ResolvedDocxRunShading;

package/dist/internal/features/work/work-docx-table-of-contents-export.d.ts

@@ -0,0 +1,11 @@
+import { type WorkDocumentTableOfContentsEntry, type WorkDocumentTableOfContentsOptions } from './work-document-table-of-contents';
+export interface DocxTableOfContentsPatch {
+    options: WorkDocumentTableOfContentsOptions;
+    entries: WorkDocumentTableOfContentsEntry[];
+}
+export declare class DocxTableOfContentsPatchCollector {
+    readonly patches: DocxTableOfContentsPatch[];
+    add(element: HTMLElement): DocxTableOfContentsPatch;
+}
+export declare function docxTableOfContents(element: HTMLElement, docx: typeof import('docx'), collector: DocxTableOfContentsPatchCollector): InstanceType<typeof docx.TableOfContents>;
+export declare function patchDocxTableOfContents(buffer: ArrayBuffer, patches: readonly DocxTableOfContentsPatch[]): Promise<ArrayBuffer>;

package/dist/internal/features/work/work-docx-table-of-contents-import.d.ts

@@ -0,0 +1,15 @@
+import { type WorkDocumentTableOfContentsEntry, type WorkDocumentTableOfContentsOptions } from './work-document-table-of-contents';
+import { type DocxFieldOccurrence } from './work-docx-field-instructions';
+export interface ImportedDocxTableOfContentsMarkers {
+    tables: ImportedDocxTableOfContentsMarker[];
+}
+export interface ImportedDocxTableOfContentsMarker {
+    marker: string;
+    id: string;
+    options: WorkDocumentTableOfContentsOptions;
+    entries: WorkDocumentTableOfContentsEntry[];
+}
+export declare function markDocxTablesOfContents(document: Document): ImportedDocxTableOfContentsMarkers;
+export declare function applyImportedDocxTableOfContentsMarkers(document: Document, markers: ImportedDocxTableOfContentsMarkers): void;
+export declare function hasImportedDocxTableOfContentsMarkers(markers: ImportedDocxTableOfContentsMarkers): boolean;
+export declare function supportedDocxTableOfContentsField(field: DocxFieldOccurrence): boolean;

package/dist/internal/features/work/work-spreadsheet-data-validation.d.ts

@@ -1,2 +1,9 @@
+import type { WorkSpreadsheetDataValidationErrorStyle } from './work-types';
+export declare const SPREADSHEET_DATA_VALIDATION_TITLE_LIMIT = 32;
+export declare const SPREADSHEET_DATA_VALIDATION_HINT_LIMIT = 255;
+export declare const SPREADSHEET_DATA_VALIDATION_ERROR_LIMIT = 225;
+export declare const SPREADSHEET_DATA_VALIDATION_ERROR_STYLES: readonly ["stop", "warning", "information"];
+export declare function normalizeSpreadsheetDataValidationErrorStyle(value: unknown): WorkSpreadsheetDataValidationErrorStyle;
+export declare function boundedSpreadsheetDataValidationText(value: unknown, limit: number): string;
 export declare function normalizeSpreadsheetDateValidationBoundary(value: string, uses1904DateSystem?: boolean): string | null;
 export declare function spreadsheetDateValidationFormula(value: string): string;

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,6 +9718,37 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
   display: grid;
 }
 
+.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;
+  grid-column: 1 / -1;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 10px 14px;
+  min-width: 0;
+  margin: 0;
+  padding: 10px 12px 12px;
+  display: grid;
+}
+
+.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;
+  font-weight: 700;
+}
+
+.work-document-font-dialog-run-border-effects {
+  align-items: end;
+  gap: 16px;
+  min-height: 32px;
+  display: flex;
+}
+
 .work-document-font-dialog-field > .work-office-select, .work-document-font-dialog-field .work-office-number-field, .work-document-font-dialog-field button[role="combobox"] {
   width: 100%;
 }
@@ -9788,6 +9819,10 @@ 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-shading {
+    grid-template-columns: minmax(0, 1fr);
+  }
+
   .work-document-font-dialog-preview {
     min-height: 88px;
   }
@@ -9797,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);
 }
@@ -12422,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;
@@ -17049,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;
@@ -17065,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
@@ -699,6 +714,62 @@ an empty nested container. The four effects change paint but not advances, so
 eligible paragraphs remain on Worker/WASM layout and the browser/PDF CSS
 projection stays an explicitly bounded approximation.
 
+Native character borders are resolved as one validated TextStyle value before
+layout eligibility, DOM serialization, and DOCX export. The closed model
+accepts 25 visible `w:bdr` line styles plus `nil` and `none`, direct or resolved
+theme colors with tint/shade identity, bounded eighth-point width, point
+spacing, shadow, and frame fields. Duplicate, misplaced, art-style,
+namespace-spoofed, child- or text-bearing, extra-attribute, out-of-range, and
+unresolved-theme leaves normalize to an explicit `nil` reset and emit a
+compatibility diagnostic instead of enabling untrusted paint or reviving
+inherited formatting.
+
+The canonical DOM mark stores semantic JSON in `data-office-run-border`; its
+CSS projection uses four-edge border paint, padding, shadow, and
+`box-decoration-break: clone`. A visible border changes inline geometry, so
+the containing paragraph deliberately uses browser-authoritative measurement.
+Explicit `nil` and `none` add no geometry and remain eligible for Worker/WASM
+shaping. The DOCX generator allocates a collision-checked temporary border
+color only inside generated runs, then patches the body, page chrome, and note
+parts to exact `w:bdr` attributes before formatting-change snapshots are
+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