@a3s-lab/office 0.31.0 → 0.32.0

package/dist/index.js

@@ -2,14 +2,14 @@ var src_DOCUMENT_SNAPSHOT_VERSION = 1;
 var src_DOCUMENT_SOURCE_VERSION = 1;
 var src_OFFICE_COLLABORATION_VERSION = 1;
 export { AGENT_PROPOSAL_PROTOCOL, OFFICE_NOTIFICATION_EVENT, createAgentProposalInstruction, createAgentProposalRequest, getAgentProposalStatus, subscribeOfficeNotifications } from "./6489.js";
-export { DOCUMENT_SNAPSHOT_MEDIA_TYPE, DOCUMENT_SNAPSHOT_SCHEMA, DOCUMENT_SOURCE_MEDIA_TYPE, DOCUMENT_SOURCE_SCHEMA, OFFICE_COLLABORATION_DEFAULT_MAX_TRANSPORT_PAYLOAD_BYTES, OFFICE_COLLABORATION_MAX_TRANSPORT_PAYLOAD_BYTES, OFFICE_COLLABORATION_PRESENCE_FIELD, OFFICE_FILE_ACCEPT, applyDocumentSource, artifactExtension, artifactExtension as workArtifactExtension, artifactKindLabel, artifactKindLabel as workArtifactKindLabel, createArtifactBlob, createOfficeCollaborationPresence, createOfficeCollaborationTransportBinding, createPdfCollaborationContent, decodeDocumentSnapshot, defaultPptxRuntimeUrl, downloadArtifact, downloadArtifactPdf, encodeDocumentSnapshot, forgetSourceBlob, importOfficeFile, officeKindForFile, pdfPagesForExport, projectDocumentSource, readSourceBlob, registerSourceBlob } from "./4104.js";
+export { DOCUMENT_SNAPSHOT_MEDIA_TYPE, DOCUMENT_SNAPSHOT_SCHEMA, DOCUMENT_SOURCE_MEDIA_TYPE, DOCUMENT_SOURCE_SCHEMA, OFFICE_COLLABORATION_DEFAULT_MAX_TRANSPORT_PAYLOAD_BYTES, OFFICE_COLLABORATION_MAX_TRANSPORT_PAYLOAD_BYTES, OFFICE_COLLABORATION_PRESENCE_FIELD, OFFICE_FILE_ACCEPT, applyDocumentSource, artifactExtension, artifactExtension as workArtifactExtension, artifactKindLabel, artifactKindLabel as workArtifactKindLabel, createArtifactBlob, createOfficeCollaborationPresence, createOfficeCollaborationTransportBinding, createPdfCollaborationContent, decodeDocumentSnapshot, defaultPptxRuntimeUrl, downloadArtifact, downloadArtifactPdf, encodeDocumentSnapshot, importOfficeFile, officeKindForFile, pdfPagesForExport, projectDocumentSource } from "./core.js";
 export { DocumentEditor, MarkdownEditor, PDF_EVIDENCE_COORDINATE_BASIS, PdfViewer, PresentationEditor, SpreadsheetEditor, defaultDocumentArabicLayoutFontUrl, defaultDocumentHebrewLayoutFontUrl, defaultDocumentLatinLayoutFontUrl, defaultDocumentLayoutFontUrl, defaultDocumentLayoutFonts, defaultOfficeKernelWasmUrl, defaultPdfiumWasmUrl, preloadOfficeEditor } from "./432.js";
 export { OFFICE_COLLABORATION_NAMESPACE, OFFICE_COLLABORATION_PROTOCOL, OfficeCollaborationError, createOfficeCollaborationSession, readOfficeCollaborationMetadata } from "./9787.js";
 export { assertPdfCollaborationSource, createOfficePdfCollaborationBinding, initializeOfficePdfCollaboration, readOfficePdfCollaboration, readOfficePdfCollaborationSource, replaceOfficePdfCollaboration } from "./3818.js";
 export { createArtifact, createOfficeId, officeTemplates } from "./4121.js";
-export { createOfficeDocumentCollaborationBinding, initializeOfficeDocumentCollaboration, officeDocumentCollaborationFragment, readOfficeDocumentCollaboration } from "./6282.js";
+export { createOfficeDocumentCollaborationBinding, forgetSourceBlob, initializeOfficeDocumentCollaboration, officeDocumentCollaborationFragment, readOfficeDocumentCollaboration, readSourceBlob, registerSourceBlob } from "./4174.js";
 export { createOfficeMarkdownCollaborationBinding, initializeOfficeMarkdownCollaboration, readOfficeMarkdownCollaboration, replaceOfficeMarkdownCollaboration } from "./2591.js";
 export { createOfficePresentationCollaborationBinding, initializeOfficePresentationCollaboration, readOfficePresentationCollaboration, replaceOfficePresentationCollaboration } from "./4560.js";
-export { createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./1544.js";
+export { createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./3266.js";
 export { normalizeWorkSpreadsheetBubbleScale, normalizeWorkSpreadsheetBubbleSizeRepresents, normalizeWorkSpreadsheetChartAxisGroup, normalizeWorkSpreadsheetCombinationSeriesType, normalizeWorkSpreadsheetDataLabelPosition, normalizeWorkSpreadsheetDataLabels, normalizeWorkSpreadsheetDoughnutHoleSize, normalizeWorkSpreadsheetErrorBars, normalizeWorkSpreadsheetRadarStyle, normalizeWorkSpreadsheetScatterStyle, normalizeWorkSpreadsheetTrendline, normalizeWorkSpreadsheetTrendlineType, workSpreadsheetChartSupportsAxes, workSpreadsheetChartSupportsErrorBars, workSpreadsheetChartSupportsTrendlines, workSpreadsheetChartTypeLabel, workSpreadsheetChartUsesNumericXAxis, workSpreadsheetCombinationSeriesTypeLabel, workSpreadsheetDataLabelPositionLabel, workSpreadsheetErrorBarTypeLabel, workSpreadsheetErrorBarValueTypeLabel, workSpreadsheetTrendlineTypeLabel } from "./8715.js";
 export { src_DOCUMENT_SNAPSHOT_VERSION as DOCUMENT_SNAPSHOT_VERSION, src_DOCUMENT_SOURCE_VERSION as DOCUMENT_SOURCE_VERSION, src_OFFICE_COLLABORATION_VERSION as OFFICE_COLLABORATION_VERSION };

package/dist/internal/features/work/editors/document-compare-dialog.d.ts

@@ -0,0 +1,14 @@
+import type { DocumentComparisonApplyResult, DocumentComparisonMode } from '../work-document-compare';
+export interface DocumentCompareDialogRequest {
+    author: string;
+    file: File;
+    mode: DocumentComparisonMode;
+}
+export interface DocumentCompareDialogProps {
+    initialMode: DocumentComparisonMode;
+    restoreFocusTarget: () => HTMLElement | null;
+    onApplied: (result: DocumentComparisonApplyResult) => void;
+    onClose: () => void;
+    onSubmit: (request: DocumentCompareDialogRequest) => Promise<DocumentComparisonApplyResult>;
+}
+export declare function DocumentCompareDialog({ initialMode, restoreFocusTarget, onApplied, onClose, onSubmit, }: DocumentCompareDialogProps): import("react").JSX.Element;

package/dist/internal/features/work/editors/document-toolbar.d.ts

@@ -1,6 +1,7 @@
 import type { Editor } from '@tiptap/core';
 import type { WorkDocumentCaptionKind } from '../work-document-captions';
 import { type WorkDocumentChange } from '../work-document-changes';
+import type { DocumentComparisonMode } from '../work-document-compare';
 import type { WorkDocumentFieldKind } from '../work-document-fields';
 import type { WorkDocumentLayoutFont } from '../work-document-fonts';
 import type { WorkDocumentNoteKind } from '../work-document-notes';
@@ -80,9 +81,10 @@ interface DocumentToolbarProps {
     onRibbonTabChange?: (tab: DocumentRibbonTabId) => boolean | undefined | Promise<boolean | undefined>;
     onToggleTrackChanges: () => void;
     onToggleChanges: () => void;
+    onOpenComparison: (mode: DocumentComparisonMode) => void;
     onDecideChange?: (change: WorkDocumentChange, decision: 'accept' | 'reject') => boolean;
     onOpenWordCount: () => void;
     onOpenFindReplace: (mode: DocumentFindReplaceMode) => void;
 }
-export declare function DocumentToolbar({ editor, defaultRibbonCollapsed, reviewOnly, suggestionOnly, history, layoutOpen, layout, layoutFonts, navigationOpen, pageColor, showPageNumbers, showHiddenText, showRulers, spellcheckEnabled, viewMode, zoom, pageChromeEditor, pageChromeEditingPart, pageChromeShowPageNumber, onRequestImage, onPageChromeEditingPartChange, onClosePageChrome, onTogglePageChromePageNumber, onToggleLayout, onLayoutChange, onOpenLayout, onToggleNavigation, onTogglePageNumbers, onToggleHiddenText, onToggleRulers, onPageColorChange, onToggleSpellcheck, onViewModeChange, onZoomChange, onZoomFit, onInsertSection, onInsertNote, onInsertCaption, onInsertCrossReference, onOpenTableOfContents, onOpenIndexEntry, onOpenIndex, citationsOpen, citationSourceCount, onToggleCitations, onInsertField, onRefreshFields, onRefreshIndex, onRefreshTableOfContents, canInsertComment, onInsertComment, commentsOpen, commentCount, onToggleComments, trackChanges, changesOpen, changeCount, findReplaceMode, fileActions, onRibbonTabChange, onToggleTrackChanges, onToggleChanges, onDecideChange, onOpenWordCount, onOpenFindReplace, }: DocumentToolbarProps): import("react").JSX.Element;
+export declare function DocumentToolbar({ editor, defaultRibbonCollapsed, reviewOnly, suggestionOnly, history, layoutOpen, layout, layoutFonts, navigationOpen, pageColor, showPageNumbers, showHiddenText, showRulers, spellcheckEnabled, viewMode, zoom, pageChromeEditor, pageChromeEditingPart, pageChromeShowPageNumber, onRequestImage, onPageChromeEditingPartChange, onClosePageChrome, onTogglePageChromePageNumber, onToggleLayout, onLayoutChange, onOpenLayout, onToggleNavigation, onTogglePageNumbers, onToggleHiddenText, onToggleRulers, onPageColorChange, onToggleSpellcheck, onViewModeChange, onZoomChange, onZoomFit, onInsertSection, onInsertNote, onInsertCaption, onInsertCrossReference, onOpenTableOfContents, onOpenIndexEntry, onOpenIndex, citationsOpen, citationSourceCount, onToggleCitations, onInsertField, onRefreshFields, onRefreshIndex, onRefreshTableOfContents, canInsertComment, onInsertComment, commentsOpen, commentCount, onToggleComments, trackChanges, changesOpen, changeCount, findReplaceMode, fileActions, onRibbonTabChange, onToggleTrackChanges, onToggleChanges, onOpenComparison, onDecideChange, onOpenWordCount, onOpenFindReplace, }: DocumentToolbarProps): import("react").JSX.Element;
 export {};

package/dist/internal/features/work/editors/use-document-comparison.d.ts

@@ -0,0 +1,9 @@
+import type { Editor } from '@tiptap/core';
+import { type DocumentComparisonMode } from '../work-document-compare';
+export declare function useDocumentComparison({ editor, onApplied, }: {
+    editor: Editor | null;
+    onApplied: () => void;
+}): {
+    dialog: import("react").JSX.Element | null;
+    open: (mode: DocumentComparisonMode) => void;
+};

package/dist/internal/features/work/work-document-changes.d.ts

@@ -36,3 +36,8 @@ declare module '@tiptap/core' {
 }
 export declare const DocumentChange: Mark<DocumentChangeOptions, any>;
 export declare function collectDocumentChanges(document: ProseMirrorNode): WorkDocumentChange[];
+/**
+ * Resolves every revision on an immutable document snapshot. A malformed
+ * formatting snapshot returns `null` instead of approximating the baseline.
+ */
+export declare function resolveAllDocumentChanges(document: ProseMirrorNode, decision: 'accept' | 'reject'): ProseMirrorNode | null;

package/dist/internal/features/work/work-document-compare-diff.d.ts

@@ -0,0 +1,38 @@
+export type DocumentSequenceDiff<T> = {
+    kind: 'equal';
+    left: T[];
+    right: T[];
+} | {
+    kind: 'delete';
+    left: T[];
+    right: [];
+} | {
+    kind: 'insert';
+    left: [];
+    right: T[];
+};
+export type DocumentSequenceAlignment<T> = {
+    kind: 'equal' | 'substitute';
+    left: T;
+    right: T;
+} | {
+    kind: 'delete';
+    left: T;
+    right: null;
+} | {
+    kind: 'insert';
+    left: null;
+    right: T;
+};
+/**
+ * Computes a deterministic LCS diff while bounding the allocated matrix.
+ * Callers can fall back to one replacement when the requested matrix is too
+ * large instead of allowing adversarial documents to allocate without limit.
+ */
+export declare function boundedDocumentSequenceDiff<T>(left: readonly T[], right: readonly T[], equal: (left: T, right: T) => boolean, maximumCells: number): DocumentSequenceDiff<T>[] | null;
+/**
+ * Aligns document blocks with a weighted substitution cost. A substitution
+ * cost below two pairs related blocks; a cost of two or more prefers an
+ * explicit deletion plus insertion.
+ */
+export declare function boundedDocumentSequenceAlignment<T>(left: readonly T[], right: readonly T[], substitutionCost: (left: T, right: T) => number, maximumCells: number): DocumentSequenceAlignment<T>[] | null;

package/dist/internal/features/work/work-document-compare-stability.d.ts

@@ -0,0 +1,5 @@
+export declare function stableJson(value: unknown): string;
+export declare function stableHash(value: string): string;
+export declare function wordParagraphId(value: string): string;
+export declare function normalizedDate(value: string): string;
+export declare function boundedMetadata(value: string, maximum: number): string;

package/dist/internal/features/work/work-document-compare.d.ts

@@ -0,0 +1,27 @@
+import { type Content, type Editor } from '@tiptap/core';
+export type DocumentComparisonMode = 'compare' | 'combine';
+export type DocumentComparisonDiagnosticCode = 'changed-complex-structure' | 'combine-baseline-mismatch' | 'combine-resolution-invalid' | 'combine-structural-revisions' | 'combine-without-revisions' | 'comparison-limit-exceeded' | 'current-revisions-present' | 'empty-structural-change' | 'invalid-revised-content' | 'revised-revisions-present' | 'section-layout-mismatch' | 'unsupported-inline-review-state';
+export interface DocumentComparisonDiagnostic {
+    code: DocumentComparisonDiagnosticCode;
+    message: string;
+    section?: number;
+    block?: number;
+}
+export interface DocumentComparisonSummary {
+    insertions: number;
+    deletions: number;
+    formatting: number;
+    paragraphFormatting: number;
+}
+export interface DocumentComparisonOptions {
+    mode: DocumentComparisonMode;
+    author: string;
+    date: string;
+    sourceName: string;
+}
+export interface DocumentComparisonApplyResult {
+    status: 'applied' | 'unchanged' | 'unsupported';
+    summary: DocumentComparisonSummary;
+    diagnostics: DocumentComparisonDiagnostic[];
+}
+export declare function applyDocumentComparison(editor: Editor, revisedContent: Content, options: DocumentComparisonOptions): DocumentComparisonApplyResult;

package/dist/styles.css

@@ -9930,6 +9930,200 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
   }
 }
 
+.work-document-compare-dialog {
+  width: min(650px, 100%);
+}
+
+.work-document-compare-dialog form {
+  gap: 15px;
+  display: grid;
+}
+
+.work-document-compare-mode {
+  border: 0;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 10px;
+  margin: 0;
+  padding: 0;
+  display: grid;
+}
+
+.work-document-compare-mode > legend {
+  color: var(--a3s-muted);
+  margin-bottom: 8px;
+  font-size: 11px;
+  font-weight: 700;
+}
+
+.work-document-compare-mode > label {
+  cursor: pointer;
+  min-width: 0;
+  position: relative;
+}
+
+.work-document-compare-mode input {
+  opacity: 0;
+  width: 1px;
+  height: 1px;
+  position: absolute;
+}
+
+.work-document-compare-mode label > span {
+  border: 1px solid var(--a3s-line);
+  background: var(--a3s-panel);
+  border-radius: 10px;
+  grid-template-columns: auto minmax(0, 1fr);
+  align-content: start;
+  gap: 4px 9px;
+  min-height: 94px;
+  padding: 13px 14px;
+  transition: border-color .14s, background-color .14s;
+  display: grid;
+}
+
+.work-document-compare-mode label:hover > span {
+  border-color: var(--a3s-line-strong);
+  background: var(--a3s-panel-soft);
+}
+
+.work-document-compare-mode input:checked + span {
+  border-color: var(--a3s-accent);
+  background: color-mix(in srgb, var(--a3s-accent) 8%, var(--a3s-panel));
+}
+
+.work-document-compare-mode input:focus-visible + span {
+  outline: 2px solid var(--a3s-accent);
+  outline-offset: 2px;
+}
+
+.work-document-compare-mode svg {
+  color: var(--a3s-accent);
+  grid-row: 1 / span 2;
+}
+
+.work-document-compare-mode strong {
+  font-size: 13px;
+  line-height: 1.2;
+}
+
+.work-document-compare-mode small {
+  color: var(--a3s-muted);
+  font-size: 11px;
+  line-height: 1.45;
+}
+
+.work-document-compare-file {
+  border: 1px dashed var(--a3s-line-strong);
+  background: var(--a3s-panel-soft);
+  width: 100%;
+  min-height: 78px;
+  color: var(--a3s-ink);
+  text-align: left;
+  cursor: pointer;
+  border-radius: 10px;
+  outline: 0;
+  grid-template-columns: auto minmax(0, 1fr);
+  align-items: center;
+  gap: 12px;
+  padding: 13px 15px;
+  display: grid;
+}
+
+.work-document-compare-file:hover:not(:disabled) {
+  border-color: var(--a3s-accent);
+}
+
+.work-document-compare-file:focus-visible {
+  outline: 2px solid var(--a3s-accent);
+  outline-offset: 2px;
+}
+
+.work-document-compare-file:disabled {
+  cursor: wait;
+  opacity: .65;
+}
+
+.work-document-compare-file > svg {
+  color: var(--a3s-accent);
+}
+
+.work-document-compare-file > span, .work-document-compare-author {
+  gap: 4px;
+  min-width: 0;
+  display: grid;
+}
+
+.work-document-compare-file strong {
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: 13px;
+  overflow: hidden;
+}
+
+.work-document-compare-file small, .work-document-compare-author small {
+  color: var(--a3s-muted);
+  font-size: 11px;
+  line-height: 1.45;
+}
+
+.work-document-compare-author > span {
+  color: var(--a3s-muted);
+  font-size: 11px;
+  font-weight: 700;
+}
+
+.work-document-compare-author .work-office-text-field {
+  width: 100%;
+}
+
+.work-document-compare-boundary, .work-document-compare-status, .work-document-compare-errors {
+  border: 1px solid var(--a3s-line);
+  border-radius: 9px;
+  margin: 0;
+  padding: 12px 14px;
+  font-size: 11px;
+  line-height: 1.5;
+}
+
+.work-document-compare-boundary {
+  background: var(--a3s-panel-soft);
+}
+
+.work-document-compare-boundary > strong, .work-document-compare-errors > strong {
+  font-size: 12px;
+}
+
+.work-document-compare-boundary > p {
+  color: var(--a3s-muted);
+  margin: 3px 0 0;
+}
+
+.work-document-compare-status {
+  border-color: color-mix(in srgb, var(--a3s-green) 42%, var(--a3s-line));
+  color: var(--a3s-green);
+}
+
+.work-document-compare-errors {
+  border-color: color-mix(in srgb, var(--a3s-red) 35%, var(--a3s-line));
+  background: color-mix(in srgb, var(--a3s-red) 5%, var(--a3s-panel));
+  color: var(--a3s-red);
+}
+
+.work-document-compare-errors ul {
+  margin: 5px 0 0;
+  padding-left: 18px;
+}
+
+@media (width <= 560px) {
+  .work-document-compare-mode {
+    grid-template-columns: minmax(0, 1fr);
+  }
+
+  .work-document-compare-mode label > span {
+    min-height: 0;
+  }
+}
+
 [data-office-character-position-half-points] {
   vertical-align: var(--work-document-character-position);
 }

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

@@ -283,6 +283,29 @@ DOCX import/export maps that model to strict or transitional `w:pPrChange`,
 while Yjs stores the same node attributes and immutable decision audit without a
 parallel transport model.
 
+Document comparison is a pure planning boundary before the editor transaction.
+The current and imported TipTap/ProseMirror trees remain immutable while a
+deterministic weighted block alignment pairs related paragraphs and headings;
+an LCS token diff then produces insertion and deletion marks, while exact mark
+and paragraph-property snapshots produce character- and paragraph-formatting
+revisions. Stable semantic signatures seed generated identities, so the same
+inputs and options produce the same ordering and IDs. Only a fully admitted
+plan replaces the mounted document, and that replacement is one transaction,
+one controlled publication, and one Undo record.
+
+Combine validates rather than guesses. It rejects every imported revision on
+an immutable reviewed snapshot and compares the resulting semantic signature
+with the current baseline. Only an exact match can transfer the reviewed inline
+and formatting revisions while retaining current paragraph and section
+identities. Existing current revisions, malformed review snapshots, structural
+block revisions, layout mismatches, and changed complex objects leave the
+mounted document untouched. Compare is bounded to 1,024 blocks per version,
+1,000,000 combined text characters, and about 1.1 million cells for block
+alignment or any inline matrix. This planner currently runs on the main thread;
+it does not claim a Worker or WASM diff path. The bounds and atomic commit keep
+that synchronous work explicit until measured evidence justifies another
+execution boundary.
+
 Selected document text has a typed host-owned context-menu boundary.
 `getSelectionMenuItems` receives an immutable snapshot containing the selected
 plain text and structured fragment, bounded adjacent text, synchronized HTML,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -89,6 +89,7 @@
     "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-comparison": "playwright test visual-tests/document-comparison.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",
@@ -122,8 +123,8 @@
     "performance:pdf": "bun .a3s-test/performance/generate-fixtures.ts --pdf-only && bun .a3s-test/performance/benchmark-pdf.ts --url http://127.0.0.1:4175/ --runs 3 --timeout-ms 120000",
     "performance:presentation": "bun .a3s-test/performance/generate-fixtures.ts --presentations-only && bun .a3s-test/performance/benchmark-presentation.ts --url http://127.0.0.1:4175/ --runs 3 --timeout-ms 120000 --modes default,content-visibility",
     "test": "rstest",
-    "test:e2e": "bun run test:e2e:fixtures && a3s-test run tests/e2e/word-page-color.acl --json && a3s-test run tests/e2e/word-page-setup-phone.acl --json && a3s-test run tests/e2e/word-paragraph-layout-phone.acl --json && a3s-test run tests/e2e/word-list-formatting-phone.acl --json && a3s-test run tests/e2e/word-font-picker-phone.acl --json && a3s-test run tests/e2e/word-comments-drawer.acl --json && a3s-test run tests/e2e/word-comment-windowing.acl --json && a3s-test run tests/e2e/word-citations-phone.acl --json && a3s-test run tests/e2e/word-navigation-search.acl --json && a3s-test run tests/e2e/word-navigation-windowing.acl --json && a3s-test run tests/e2e/word-find-replace-phone.acl --json && a3s-test run tests/e2e/word-page-navigation.acl --json && a3s-test run tests/e2e/word-page-windowing.acl --json && a3s-test run tests/e2e/word-ai-question.acl --json && a3s-test run tests/e2e/word-picture-insert.acl --json && a3s-test run tests/e2e/word-picture-alt-text-phone.acl --json && a3s-test run tests/e2e/word-track-changes-phone.acl --json && a3s-test run tests/e2e/word-formatting-revision.acl --json && a3s-test run tests/e2e/word-paragraph-formatting-revision.acl --json && a3s-test run tests/e2e/word-review-conflict-phone.acl --json && a3s-test run tests/e2e/word-revision-windowing.acl --json && a3s-test run tests/e2e/word-table-phone.acl --json && a3s-test run tests/e2e/word-table-borders.acl --json && a3s-test run tests/e2e/word-theme-table.acl --json && a3s-test run tests/e2e/word-styled-table.acl --json && a3s-test run tests/e2e/word-multi-page-table.acl --json && a3s-test run tests/e2e/word-cross-reference-phone.acl --json && a3s-test run tests/e2e/word-bookmark-links-phone.acl --json && a3s-test run tests/e2e/word-notes-phone.acl --json && a3s-test run tests/e2e/word-fields-phone.acl --json && a3s-test run tests/e2e/spreadsheet-phone-rename.acl --json && a3s-test run tests/e2e/spreadsheet-phone-find.acl --json && a3s-test run tests/e2e/spreadsheet-phone-context-menu.acl --json && a3s-test run tests/e2e/spreadsheet-phone-task-pane.acl --json && a3s-test run tests/e2e/spreadsheet-maximum-sparse.acl --json && a3s-test run tests/e2e/spreadsheet-cell-style.acl --json && a3s-test run tests/e2e/spreadsheet-paste-special.acl --json && a3s-test run tests/e2e/spreadsheet-hyperlink.acl --json && a3s-test run tests/e2e/presentation-cut-paste-focus.acl --json && a3s-test run tests/e2e/presentation-presenter-view.acl --json && a3s-test run tests/e2e/presentation-phone-chart-pane.acl --json && a3s-test run tests/e2e/presentation-phone-comments.acl --json && a3s-test run tests/e2e/pdf-thumbnail-keyboard.acl --json && a3s-test run tests/e2e/pdf-page-drawer-phone.acl --json && a3s-test run tests/e2e/markdown-phone-modes.acl --json && a3s-test run tests/e2e/office-sidebar-breakpoint.acl --json && a3s-test run tests/e2e/office-docs-navigation.acl --json && a3s-test run tests/e2e/collaboration-playground-entry.acl --json && a3s-test run tests/e2e/collaboration-document-comments.acl --command-timeout-ms 120000 --json && a3s-test run tests/e2e/collaboration-document-suggestions.acl --command-timeout-ms 120000 --json && a3s-test run tests/e2e/collaboration-participants.acl --json && a3s-test run tests/e2e/collaboration-pdf-annotations.acl --json && a3s-test run tests/e2e/collaboration-spreadsheet-cells.acl --json && a3s-test run tests/e2e/collaboration-presentation-elements.acl --json",
-    "test:e2e:check": "bun run test:e2e:fixtures && a3s-test check tests/e2e/word-page-color.acl --json && a3s-test check tests/e2e/word-page-setup-phone.acl --json && a3s-test check tests/e2e/word-paragraph-layout-phone.acl --json && a3s-test check tests/e2e/word-list-formatting-phone.acl --json && a3s-test check tests/e2e/word-font-picker-phone.acl --json && a3s-test check tests/e2e/word-comments-drawer.acl --json && a3s-test check tests/e2e/word-comment-windowing.acl --json && a3s-test check tests/e2e/word-citations-phone.acl --json && a3s-test check tests/e2e/word-navigation-search.acl --json && a3s-test check tests/e2e/word-navigation-windowing.acl --json && a3s-test check tests/e2e/word-find-replace-phone.acl --json && a3s-test check tests/e2e/word-page-navigation.acl --json && a3s-test check tests/e2e/word-page-windowing.acl --json && a3s-test check tests/e2e/word-ai-question.acl --json && a3s-test check tests/e2e/word-picture-insert.acl --json && a3s-test check tests/e2e/word-picture-alt-text-phone.acl --json && a3s-test check tests/e2e/word-track-changes-phone.acl --json && a3s-test check tests/e2e/word-formatting-revision.acl --json && a3s-test check tests/e2e/word-paragraph-formatting-revision.acl --json && a3s-test check tests/e2e/word-review-conflict-phone.acl --json && a3s-test check tests/e2e/word-revision-windowing.acl --json && a3s-test check tests/e2e/word-table-phone.acl --json && a3s-test check tests/e2e/word-table-borders.acl --json && a3s-test check tests/e2e/word-theme-table.acl --json && a3s-test check tests/e2e/word-styled-table.acl --json && a3s-test check tests/e2e/word-multi-page-table.acl --json && a3s-test check tests/e2e/word-cross-reference-phone.acl --json && a3s-test check tests/e2e/word-bookmark-links-phone.acl --json && a3s-test check tests/e2e/word-notes-phone.acl --json && a3s-test check tests/e2e/word-fields-phone.acl --json && a3s-test check tests/e2e/spreadsheet-phone-rename.acl --json && a3s-test check tests/e2e/spreadsheet-phone-find.acl --json && a3s-test check tests/e2e/spreadsheet-phone-context-menu.acl --json && a3s-test check tests/e2e/spreadsheet-phone-task-pane.acl --json && a3s-test check tests/e2e/spreadsheet-maximum-sparse.acl --json && a3s-test check tests/e2e/spreadsheet-cell-style.acl --json && a3s-test check tests/e2e/spreadsheet-paste-special.acl --json && a3s-test check tests/e2e/spreadsheet-hyperlink.acl --json && a3s-test check tests/e2e/presentation-cut-paste-focus.acl --json && a3s-test check tests/e2e/presentation-presenter-view.acl --json && a3s-test check tests/e2e/presentation-phone-chart-pane.acl --json && a3s-test check tests/e2e/presentation-phone-comments.acl --json && a3s-test check tests/e2e/pdf-thumbnail-keyboard.acl --json && a3s-test check tests/e2e/pdf-page-drawer-phone.acl --json && a3s-test check tests/e2e/markdown-phone-modes.acl --json && a3s-test check tests/e2e/office-sidebar-breakpoint.acl --json && a3s-test check tests/e2e/office-docs-navigation.acl --json && a3s-test check tests/e2e/collaboration-playground-entry.acl --json && a3s-test check tests/e2e/collaboration-document-comments.acl --json && a3s-test check tests/e2e/collaboration-document-suggestions.acl --json && a3s-test check tests/e2e/collaboration-participants.acl --json && a3s-test check tests/e2e/collaboration-pdf-annotations.acl --json && a3s-test check tests/e2e/collaboration-spreadsheet-cells.acl --json && a3s-test check tests/e2e/collaboration-presentation-elements.acl --json",
+    "test:e2e": "bun run test:e2e:fixtures && a3s-test run tests/e2e/word-page-color.acl --json && a3s-test run tests/e2e/word-page-setup-phone.acl --json && a3s-test run tests/e2e/word-paragraph-layout-phone.acl --json && a3s-test run tests/e2e/word-list-formatting-phone.acl --json && a3s-test run tests/e2e/word-font-picker-phone.acl --json && a3s-test run tests/e2e/word-comments-drawer.acl --json && a3s-test run tests/e2e/word-comment-windowing.acl --json && a3s-test run tests/e2e/word-citations-phone.acl --json && a3s-test run tests/e2e/word-navigation-search.acl --json && a3s-test run tests/e2e/word-navigation-windowing.acl --json && a3s-test run tests/e2e/word-find-replace-phone.acl --json && a3s-test run tests/e2e/word-page-navigation.acl --json && a3s-test run tests/e2e/word-page-windowing.acl --json && a3s-test run tests/e2e/word-ai-question.acl --json && a3s-test run tests/e2e/word-picture-insert.acl --json && a3s-test run tests/e2e/word-picture-alt-text-phone.acl --json && a3s-test run tests/e2e/word-track-changes-phone.acl --json && a3s-test run tests/e2e/word-formatting-revision.acl --json && a3s-test run tests/e2e/word-paragraph-formatting-revision.acl --json && a3s-test run tests/e2e/word-document-comparison.acl --json && a3s-test run tests/e2e/word-review-conflict-phone.acl --json && a3s-test run tests/e2e/word-revision-windowing.acl --json && a3s-test run tests/e2e/word-table-phone.acl --json && a3s-test run tests/e2e/word-table-borders.acl --json && a3s-test run tests/e2e/word-theme-table.acl --json && a3s-test run tests/e2e/word-styled-table.acl --json && a3s-test run tests/e2e/word-multi-page-table.acl --json && a3s-test run tests/e2e/word-cross-reference-phone.acl --json && a3s-test run tests/e2e/word-bookmark-links-phone.acl --json && a3s-test run tests/e2e/word-notes-phone.acl --json && a3s-test run tests/e2e/word-fields-phone.acl --json && a3s-test run tests/e2e/spreadsheet-phone-rename.acl --json && a3s-test run tests/e2e/spreadsheet-phone-find.acl --json && a3s-test run tests/e2e/spreadsheet-phone-context-menu.acl --json && a3s-test run tests/e2e/spreadsheet-phone-task-pane.acl --json && a3s-test run tests/e2e/spreadsheet-maximum-sparse.acl --json && a3s-test run tests/e2e/spreadsheet-cell-style.acl --json && a3s-test run tests/e2e/spreadsheet-paste-special.acl --json && a3s-test run tests/e2e/spreadsheet-hyperlink.acl --json && a3s-test run tests/e2e/presentation-cut-paste-focus.acl --json && a3s-test run tests/e2e/presentation-presenter-view.acl --json && a3s-test run tests/e2e/presentation-phone-chart-pane.acl --json && a3s-test run tests/e2e/presentation-phone-comments.acl --json && a3s-test run tests/e2e/pdf-thumbnail-keyboard.acl --json && a3s-test run tests/e2e/pdf-page-drawer-phone.acl --json && a3s-test run tests/e2e/markdown-phone-modes.acl --json && a3s-test run tests/e2e/office-sidebar-breakpoint.acl --json && a3s-test run tests/e2e/office-docs-navigation.acl --json && a3s-test run tests/e2e/collaboration-playground-entry.acl --json && a3s-test run tests/e2e/collaboration-document-comments.acl --command-timeout-ms 120000 --json && a3s-test run tests/e2e/collaboration-document-suggestions.acl --command-timeout-ms 120000 --json && a3s-test run tests/e2e/collaboration-participants.acl --json && a3s-test run tests/e2e/collaboration-pdf-annotations.acl --json && a3s-test run tests/e2e/collaboration-spreadsheet-cells.acl --json && a3s-test run tests/e2e/collaboration-presentation-elements.acl --json",
+    "test:e2e:check": "bun run test:e2e:fixtures && a3s-test check tests/e2e/word-page-color.acl --json && a3s-test check tests/e2e/word-page-setup-phone.acl --json && a3s-test check tests/e2e/word-paragraph-layout-phone.acl --json && a3s-test check tests/e2e/word-list-formatting-phone.acl --json && a3s-test check tests/e2e/word-font-picker-phone.acl --json && a3s-test check tests/e2e/word-comments-drawer.acl --json && a3s-test check tests/e2e/word-comment-windowing.acl --json && a3s-test check tests/e2e/word-citations-phone.acl --json && a3s-test check tests/e2e/word-navigation-search.acl --json && a3s-test check tests/e2e/word-navigation-windowing.acl --json && a3s-test check tests/e2e/word-find-replace-phone.acl --json && a3s-test check tests/e2e/word-page-navigation.acl --json && a3s-test check tests/e2e/word-page-windowing.acl --json && a3s-test check tests/e2e/word-ai-question.acl --json && a3s-test check tests/e2e/word-picture-insert.acl --json && a3s-test check tests/e2e/word-picture-alt-text-phone.acl --json && a3s-test check tests/e2e/word-track-changes-phone.acl --json && a3s-test check tests/e2e/word-formatting-revision.acl --json && a3s-test check tests/e2e/word-paragraph-formatting-revision.acl --json && a3s-test check tests/e2e/word-document-comparison.acl --json && a3s-test check tests/e2e/word-review-conflict-phone.acl --json && a3s-test check tests/e2e/word-revision-windowing.acl --json && a3s-test check tests/e2e/word-table-phone.acl --json && a3s-test check tests/e2e/word-table-borders.acl --json && a3s-test check tests/e2e/word-theme-table.acl --json && a3s-test check tests/e2e/word-styled-table.acl --json && a3s-test check tests/e2e/word-multi-page-table.acl --json && a3s-test check tests/e2e/word-cross-reference-phone.acl --json && a3s-test check tests/e2e/word-bookmark-links-phone.acl --json && a3s-test check tests/e2e/word-notes-phone.acl --json && a3s-test check tests/e2e/word-fields-phone.acl --json && a3s-test check tests/e2e/spreadsheet-phone-rename.acl --json && a3s-test check tests/e2e/spreadsheet-phone-find.acl --json && a3s-test check tests/e2e/spreadsheet-phone-context-menu.acl --json && a3s-test check tests/e2e/spreadsheet-phone-task-pane.acl --json && a3s-test check tests/e2e/spreadsheet-maximum-sparse.acl --json && a3s-test check tests/e2e/spreadsheet-cell-style.acl --json && a3s-test check tests/e2e/spreadsheet-paste-special.acl --json && a3s-test check tests/e2e/spreadsheet-hyperlink.acl --json && a3s-test check tests/e2e/presentation-cut-paste-focus.acl --json && a3s-test check tests/e2e/presentation-presenter-view.acl --json && a3s-test check tests/e2e/presentation-phone-chart-pane.acl --json && a3s-test check tests/e2e/presentation-phone-comments.acl --json && a3s-test check tests/e2e/pdf-thumbnail-keyboard.acl --json && a3s-test check tests/e2e/pdf-page-drawer-phone.acl --json && a3s-test check tests/e2e/markdown-phone-modes.acl --json && a3s-test check tests/e2e/office-sidebar-breakpoint.acl --json && a3s-test check tests/e2e/office-docs-navigation.acl --json && a3s-test check tests/e2e/collaboration-playground-entry.acl --json && a3s-test check tests/e2e/collaboration-document-comments.acl --json && a3s-test check tests/e2e/collaboration-document-suggestions.acl --json && a3s-test check tests/e2e/collaboration-participants.acl --json && a3s-test check tests/e2e/collaboration-pdf-annotations.acl --json && a3s-test check tests/e2e/collaboration-spreadsheet-cells.acl --json && a3s-test check tests/e2e/collaboration-presentation-elements.acl --json",
     "test:e2e:fixtures": "bun scripts/create-e2e-fixtures.ts",
     "test:e2e:large-documents": "bun .a3s-test/performance/generate-fixtures.ts --documents-only && a3s-test run tests/e2e/word-large-document-windowing.acl --json",
     "test:e2e:large-documents:check": "a3s-test check tests/e2e/word-large-document-windowing.acl --json",
@@ -213,6 +214,8 @@
     "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-document-comparison": "A3S_TEST_SUITE=tests/e2e/word-document-comparison.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:writer-document-comparison:check": "a3s-test check tests/e2e/word-document-comparison.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",