@a3s-lab/office 0.48.1 → 0.50.0

package/dist/4174.js

@@ -10096,12 +10096,23 @@ const DocumentChange = Mark.create({
                 parseHTML: (element)=>{
                     const declared = element.getAttribute('data-change-kind');
                     if ('formatting' === declared) return 'formatting';
+                    if ('move' === declared) return 'move';
                     return 'del' === element.tagName.toLowerCase() ? 'deletion' : 'insertion';
                 },
                 renderHTML: (attributes)=>({
                         'data-change-kind': attributes.kind
                     })
             },
+            moveRole: {
+                default: '',
+                parseHTML: (element)=>{
+                    const role = element.getAttribute('data-change-move-role');
+                    return 'from' === role || 'to' === role ? role : '';
+                },
+                renderHTML: (attributes)=>'from' === attributes.moveRole || 'to' === attributes.moveRole ? {
+                        'data-change-move-role': attributes.moveRole
+                    } : {}
+            },
             id: {
                 default: '',
                 parseHTML: (element)=>element.getAttribute('data-change-id') ?? '',
@@ -10189,7 +10200,7 @@ const DocumentChange = Mark.create({
         ];
     },
     renderHTML ({ mark, HTMLAttributes }) {
-        const tag = 'deletion' === mark.attrs.kind ? 'del' : 'formatting' === mark.attrs.kind ? 'span' : 'ins';
+        const tag = 'deletion' === mark.attrs.kind ? 'del' : 'move' === mark.attrs.kind && 'from' === mark.attrs.moveRole ? 'del' : 'formatting' === mark.attrs.kind ? 'span' : 'ins';
         return [
             tag,
             mergeAttributes(HTMLAttributes, {
@@ -10289,6 +10300,7 @@ const DocumentChange = Mark.create({
 function collectDocumentChanges(document1) {
     const changes = new Map();
     const blockChangeRanges = new Map();
+    const moveTextParts = new Map();
     document1.descendants((node, position)=>{
         if (('paragraph' === node.type.name || 'heading' === node.type.name) && ('insertion' === node.attrs.blockChangeKind || 'deletion' === node.attrs.blockChangeKind)) {
             const kind = node.attrs.blockChangeKind;
@@ -10365,6 +10377,7 @@ function collectDocumentChanges(document1) {
         const mark = work_document_changes_documentChangeMark(node.marks);
         if (!mark) return;
         const kind = changeKind(mark.attrs.kind);
+        const moveRole = documentMoveRole(mark.attrs.moveRole);
         const id = work_document_changes_stringAttribute(mark.attrs.id) || `change-at-${position}`;
         const key = `${kind}:${id}`;
         if (blockChangeRanges.get(key)?.some((range)=>position >= range.from && position + node.nodeSize <= range.to)) return;
@@ -10372,12 +10385,38 @@ function collectDocumentChanges(document1) {
         if (current) {
             current.from = Math.min(current.from, position);
             current.to = Math.max(current.to, position + node.nodeSize);
-            current.text += node.text;
+            if ('move' === kind && moveRole) {
+                const parts = moveTextParts.get(key) ?? {};
+                const previous = parts[moveRole];
+                parts[moveRole] = previous ? {
+                    text: previous.text + node.text,
+                    from: Math.min(previous.from, position),
+                    to: Math.max(previous.to, position + node.nodeSize)
+                } : {
+                    text: node.text,
+                    from: position,
+                    to: position + node.nodeSize
+                };
+                moveTextParts.set(key, parts);
+                if (current.moveRole !== moveRole) delete current.moveRole;
+            } else current.text += node.text;
             return;
         }
+        if ('move' === kind && moveRole) {
+            const parts = moveTextParts.get(key) ?? {};
+            parts[moveRole] = {
+                text: node.text,
+                from: position,
+                to: position + node.nodeSize
+            };
+            moveTextParts.set(key, parts);
+        }
         changes.set(key, {
             id,
             kind,
+            ...moveRole ? {
+                moveRole
+            } : {},
             ...work_document_changes_stringAttribute(mark.attrs.actorId) ? {
                 actorId: work_document_changes_stringAttribute(mark.attrs.actorId)
             } : {},
@@ -10385,9 +10424,27 @@ function collectDocumentChanges(document1) {
             date: work_document_changes_stringAttribute(mark.attrs.date),
             from: position,
             to: position + node.nodeSize,
-            text: node.text
+            text: node.text ?? ''
         });
     });
+    for (const [key, parts] of moveTextParts){
+        const change = changes.get(key);
+        if (!change) continue;
+        const source = parts.from;
+        const destination = parts.to;
+        if (source && destination) {
+            change.text = source.text === destination.text ? source.text : `${source.text} → ${destination.text}`;
+            change.from = destination.from;
+            change.to = destination.to;
+        } else {
+            const only = source ?? destination;
+            if (only) {
+                change.text = only.text;
+                change.from = only.from;
+                change.to = only.to;
+            }
+        }
+    }
     return Array.from(changes.values()).sort((left, right)=>left.from - right.from);
 }
 function resolveAllDocumentChanges(document1, decision) {
@@ -10409,7 +10466,7 @@ function resolveDocumentChangesTransaction(state, tr, type, decision, ids) {
     const numberingSegments = numberingChangeSegments(state.doc).filter((segment)=>!ids || ids.has(segment.id));
     const blockSegments = blockChangeSegments(state.doc).filter((segment)=>!ids || ids.has(segment.id));
     if (!segments.length && !paragraphSegments.length && !numberingSegments.length && !blockSegments.length) return 0;
-    if (paragraphSegments.some((segment)=>!parseDocumentParagraphFormatting(segment.before)) || numberingSegments.some((segment)=>!parseDocumentNumberingChange(segment.before)) || 'reject' === decision && segments.some((segment)=>'formatting' === segment.kind && !parseDocumentCharacterFormatting(segment.before))) return 0;
+    if (paragraphSegments.some((segment)=>!parseDocumentParagraphFormatting(segment.before)) || numberingSegments.some((segment)=>!parseDocumentNumberingChange(segment.before)) || 'reject' === decision && segments.some((segment)=>'formatting' === segment.kind && !parseDocumentCharacterFormatting(segment.before)) || segments.some((segment)=>'move' === segment.kind && 'from' !== segment.moveRole && 'to' !== segment.moveRole) || !validMoveSegments(segments)) return 0;
     closeHistory(tr);
     tr.setMeta(documentChangePluginKey, {
         decision
@@ -10425,6 +10482,12 @@ function resolveDocumentChangesTransaction(state, tr, type, decision, ids) {
             if ('reject' === decision) formattingRejections.push(segment);
             continue;
         }
+        if ('move' === segment.kind) {
+            const source = 'from' === segment.moveRole;
+            const removeContent = 'accept' === decision ? source : !source;
+            (removeContent ? contentDeletions : markRemovals).push(segment);
+            continue;
+        }
         const removeMark = 'accept' === decision && 'insertion' === segment.kind || 'reject' === decision && 'deletion' === segment.kind;
         (removeMark ? markRemovals : contentDeletions).push(segment);
     }
@@ -10507,16 +10570,35 @@ function documentChangeSegments(document1, type) {
         if (!node.isText) return;
         const mark = node.marks.find((candidate)=>candidate.type === type);
         if (!mark) return;
+        const moveRole = documentMoveRole(mark.attrs.moveRole);
         segments.push({
             id: work_document_changes_stringAttribute(mark.attrs.id) || `change-at-${position}`,
             kind: changeKind(mark.attrs.kind),
+            ...moveRole ? {
+                moveRole
+            } : {},
             from: position,
             to: position + node.nodeSize,
-            before: work_document_changes_stringAttribute(mark.attrs.before)
+            before: work_document_changes_stringAttribute(mark.attrs.before),
+            text: node.text ?? ''
         });
     });
     return segments;
 }
+function validMoveSegments(segments) {
+    const moves = new Map();
+    for (const segment of segments){
+        if ('move' !== segment.kind) continue;
+        if ('from' !== segment.moveRole && 'to' !== segment.moveRole) return false;
+        const current = moves.get(segment.id) ?? {
+            from: '',
+            to: ''
+        };
+        current[segment.moveRole] += segment.text;
+        moves.set(segment.id, current);
+    }
+    return Array.from(moves.values()).every(({ from, to })=>Boolean(from && to && from === to));
+}
 function paragraphChangeSegments(document1) {
     const segments = [];
     document1.descendants((node, position)=>{
@@ -10613,9 +10695,12 @@ function work_document_changes_documentChangeMark(marks) {
     return marks.find((mark)=>'documentChange' === mark.type.name);
 }
 function changeKind(value) {
-    if ('deletion' === value || 'formatting' === value) return value;
+    if ('deletion' === value || 'formatting' === value || 'move' === value) return value;
     return 'insertion';
 }
+function documentMoveRole(value) {
+    return 'from' === value || 'to' === value ? value : null;
+}
 function paragraphChangeAttribute(field, htmlName) {
     const modelName = `paragraphChange${field[0]?.toUpperCase() ?? ''}${field.slice(1)}`;
     return {
@@ -21439,9 +21524,9 @@ function changeIdentity(decision) {
     return `${decision.changeKind}:${decision.changeId}`;
 }
 function office_document_collaboration_change_decisions_changeKind(value, shared) {
-    if ('insertion' === value || 'deletion' === value || 'formatting' === value || 'paragraph-formatting' === value || 'numbering' === value) return value;
+    if ('insertion' === value || 'deletion' === value || 'formatting' === value || 'paragraph-formatting' === value || 'numbering' === value || 'move' === value) return value;
     if (shared) invalidSharedSidecars('tracked-change decision kind');
-    invalidInputSidecars('an insertion, deletion, formatting, paragraph-formatting, or numbering tracked-change kind');
+    invalidInputSidecars('an insertion, deletion, formatting, paragraph-formatting, numbering, or move tracked-change kind');
 }
 function decisionAction(value, shared) {
     if ('accept' === value || 'reject' === value) return value;

package/dist/internal/features/work/editors/controlled-editor-composition.d.ts

@@ -1,20 +1,66 @@
 import type { Editor } from '@tiptap/core';
+import type { Transaction } from '@tiptap/pm/state';
+export interface ControlledCompositionRange {
+    from: number;
+    to: number;
+}
+export interface ControlledCompositionSnapshot {
+    id: number;
+    range: ControlledCompositionRange | null;
+    text: string | null;
+}
+type CompositionSettledHandler = (editor: Editor, snapshot: ControlledCompositionSnapshot) => void;
 /**
- * Keeps controlled TipTap editors from publishing or reconciling content while
- * the browser and ProseMirror still own an IME composition. The zero-delay
- * settlement lets ProseMirror flush WebKit's pending DOM records first; the
- * bounded retries cover runtimes that keep `view.composing` true briefly after
- * `compositionend` without adding work to ordinary keyboard input.
+ * Tracks the browser-owned part of a controlled TipTap composition.
+ *
+ * WebKit can expose the provisional Latin spelling to ProseMirror, dispatch
+ * `compositionend`, and only then deliver the committed CJK text. Merely
+ * delaying `onChange` leaves both strings in the document. This controller
+ * keeps the original composition range mapped through every transaction and
+ * gives the owning editor one bounded opportunity to replace that range with
+ * the committed text after the browser has finished its DOM flush.
  */
 export declare class ControlledEditorComposition {
     private active;
+    private committedInputSeen;
+    private committedText;
+    private compositionData;
+    private deadline;
     private generation;
+    private awaitingCommittedTransaction;
+    private range;
+    private rangeFrozen;
     private settling;
+    private settleAt;
+    private settleHandler;
+    private settleEditor;
+    private sessionId;
     private timer;
-    start(): void;
-    end(editor: Editor, onSettled: (editor: Editor) => void): void;
+    /** Start tracking the selection that the browser is about to compose over. */
+    start(editor?: Editor | null): void;
+    /**
+     * Keep the composition range aligned with ProseMirror's current document.
+     * This includes the transaction generated when a browser first exposes the
+     * provisional pinyin and the transaction generated by a late committed
+     * input event.
+     */
+    recordTransaction(transaction: Transaction): void;
+    /** Observe beforeinput/input without taking ownership of the browser event. */
+    noteInput(event: Event): void;
+    /**
+     * End a composition. The two-argument form is retained for the Markdown and
+     * presentation editors; document editing passes compositionend.data as the
+     * middle argument so late WebKit input can be distinguished from typing.
+     */
+    end(editor: Editor, dataOrHandler: string | null | undefined | CompositionSettledHandler, maybeHandler?: CompositionSettledHandler): void;
     isBlocking(editor?: Editor | null): boolean;
     destroy(): void;
+    private selectionRange;
+    private currentRangeText;
+    private snapshot;
+    private scheduleQuietSettlement;
     private scheduleSettlement;
+    private clearSettlement;
     private cancelTimer;
 }
+export {};

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

@@ -31,9 +31,11 @@ export interface DocumentPaginationPageDescriptorDerivation {
     derivedPageCount: number;
 }
 export interface UseDocumentPaginationOptions {
+    compositionRevision?: number;
     editor: Editor | null;
     documentRevision: number;
     enabled: boolean;
+    isComposing?: () => boolean;
     layoutKey: string;
     page: OfficeKernelPageMetrics;
     selectionVersion: number;
@@ -49,7 +51,7 @@ export interface UseDocumentPaginationValue {
     paginating: boolean;
     resolveFieldContext: WorkDocumentFieldContextResolver | null;
 }
-export declare function useDocumentPagination({ editor, documentRevision, enabled, layoutKey, page, selectionVersion, wasmUrl, layoutFonts, loadedLayoutFontIds, }: UseDocumentPaginationOptions): UseDocumentPaginationValue;
+export declare function useDocumentPagination({ compositionRevision, editor, documentRevision, enabled, isComposing, layoutKey, page, selectionVersion, wasmUrl, layoutFonts, loadedLayoutFontIds, }: UseDocumentPaginationOptions): UseDocumentPaginationValue;
 export declare function createDocumentFieldPaginationContextResolver(pagination: DocumentPaginationResult): WorkDocumentFieldContextResolver;
 export declare function documentResizeObservationPositions(blocks: readonly MeasuredDocumentLayoutBlock[]): ReadonlyMap<HTMLElement, number>;
 export declare function documentResizeObservationTargets(editorDom: HTMLElement, blocks: readonly MeasuredDocumentLayoutBlock[]): {

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

@@ -1,7 +1,7 @@
 import { Mark } from '@tiptap/core';
 import { type Node as ProseMirrorNode } from '@tiptap/pm/model';
-import type { WorkDocumentChangeKind } from './work-types';
-export type { WorkDocumentChangeKind } from './work-types';
+import type { WorkDocumentChangeKind, WorkDocumentMoveRole } from './work-types';
+export type { WorkDocumentChangeKind, WorkDocumentMoveRole, } from './work-types';
 export interface WorkDocumentChangeIdentity {
     id: string;
     actorId?: string;
@@ -10,6 +10,8 @@ export interface WorkDocumentChangeIdentity {
 }
 export interface WorkDocumentChange extends WorkDocumentChangeIdentity {
     kind: WorkDocumentChangeKind;
+    /** Present when a change is one side of a native Word move revision. */
+    moveRole?: WorkDocumentMoveRole;
     from: number;
     to: number;
     text: string;

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

@@ -0,0 +1,28 @@
+import type { WorkDocumentChange, WorkDocumentChangeIdentity } from './work-document-changes';
+import type { WorkDocumentChangeKind } from './work-types';
+export type DocumentComparisonMode = 'compare' | 'combine';
+export interface DocumentComparisonSummary {
+    insertions: number;
+    deletions: number;
+    formatting: number;
+    paragraphFormatting: number;
+    /** Number of paired text moves inferred by Compare (when non-zero). */
+    moves?: number;
+}
+export interface DocumentComparisonOptions {
+    mode: DocumentComparisonMode;
+    author: string;
+    date: string;
+    sourceName: string;
+}
+export interface ComparisonIdentityFactory {
+    create(kind: WorkDocumentChangeKind, before?: string): WorkDocumentChangeIdentity;
+    paragraphIdentity(channel: string): {
+        paragraphId: string;
+        textId: string;
+    };
+    summary: DocumentComparisonSummary;
+}
+export declare function createComparisonIdentityFactory(currentSignature: string, revisedSignature: string, options: DocumentComparisonOptions): ComparisonIdentityFactory;
+export declare function summarizeComparisonChanges(changes: readonly WorkDocumentChange[]): DocumentComparisonSummary;
+export declare function emptyComparisonSummary(): DocumentComparisonSummary;

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

@@ -0,0 +1,60 @@
+import type { Mark as ProseMirrorMark, Node as ProseMirrorNode, Schema } from '@tiptap/pm/model';
+import type { WorkDocumentChangeIdentity, WorkDocumentChangeKind } from './work-document-changes';
+import type { WorkDocumentMoveRole } from './work-types';
+export interface InlineUnit {
+    text: string;
+    marks: readonly ProseMirrorMark[];
+    leadingWhitespaceAttached?: boolean;
+}
+export type InlineDiffStep = {
+    kind: 'equal';
+    left: InlineUnit[];
+    right: InlineUnit[];
+} | {
+    kind: 'delete';
+    left: InlineUnit[];
+    right: [];
+} | {
+    kind: 'insert';
+    left: [];
+    right: InlineUnit[];
+};
+export interface InlineMoveCandidate {
+    stepIndex: number;
+    kind: 'delete' | 'insert';
+    units: InlineUnit[];
+    start: number;
+    end: number;
+    startOffset: number;
+    endOffset: number;
+    text: string;
+}
+export interface InlineMovePair {
+    deletion: InlineMoveCandidate;
+    insertion: InlineMoveCandidate;
+}
+export interface InlineMoveAssignment {
+    role: WorkDocumentMoveRole;
+    candidate: InlineMoveCandidate;
+    identity: WorkDocumentChangeIdentity;
+}
+export interface ComparisonMoveIdentityFactory {
+    create(kind: WorkDocumentChangeKind): WorkDocumentChangeIdentity;
+}
+type MarksEqual = (left: readonly ProseMirrorMark[], right: readonly ProseMirrorMark[]) => boolean;
+type StripReviewMarks = (marks: readonly ProseMirrorMark[]) => ProseMirrorMark[];
+type AppendRevisionUnits = (target: ProseMirrorNode[], units: readonly InlineUnit[], kind: 'insertion' | 'deletion', identity: WorkDocumentChangeIdentity, schema: Schema, stripReviewMarks: StripReviewMarks) => void;
+export declare const MAX_INFERRED_MOVE_TEXT = 65536;
+export declare function appendRevisionUnits(target: ProseMirrorNode[], units: readonly InlineUnit[], kind: 'insertion' | 'deletion', identity: WorkDocumentChangeIdentity, schema: Schema, stripReviewMarks: StripReviewMarks): void;
+/**
+ * Pairs only deterministic same-text ranges inside one block. Duplicate
+ * candidates and ranges whose marks differ are deliberately left as ordinary
+ * insertions/deletions so Compare never guesses at an ambiguous move.
+ */
+export declare function inferInlineMovePairs(changes: readonly InlineDiffStep[], marksEqual: MarksEqual): InlineMovePair[];
+/**
+ * Splits an ordinary diff step around paired move ranges while retaining the
+ * exact whitespace and mark boundaries needed to reconstruct either version.
+ */
+export declare function appendComparisonRevisionUnits(target: ProseMirrorNode[], units: InlineUnit[], kind: 'insertion' | 'deletion', schema: Schema, factory: ComparisonMoveIdentityFactory, stripReviewMarks: StripReviewMarks, appendRevisionUnits: AppendRevisionUnits, moves?: readonly InlineMoveAssignment[]): void;
+export {};

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

@@ -1,5 +1,6 @@
 import { type Content, type Editor } from '@tiptap/core';
-export type DocumentComparisonMode = 'compare' | 'combine';
+import { type DocumentComparisonOptions, type DocumentComparisonSummary } from './work-document-compare-identities';
+export type { DocumentComparisonMode, DocumentComparisonOptions, DocumentComparisonSummary, } from './work-document-compare-identities';
 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;
@@ -7,18 +8,6 @@ export interface DocumentComparisonDiagnostic {
     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;

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

@@ -1,6 +1,7 @@
-import type { WorkDocumentChangeIdentity, WorkDocumentChangeKind } from './work-document-changes';
+import type { WorkDocumentChangeIdentity, WorkDocumentChangeKind, WorkDocumentMoveRole } from './work-document-changes';
 export interface ImportedDocxChangeMarker extends WorkDocumentChangeIdentity {
     kind: WorkDocumentChangeKind;
+    moveRole?: WorkDocumentMoveRole;
     start: string;
     end: string;
 }
@@ -10,3 +11,11 @@ export interface ImportedDocxChangeMarkers {
 export declare function markDocxTextChanges(document: Document): ImportedDocxChangeMarkers;
 export declare function applyImportedDocxChangeMarkers(document: Document, markers: ImportedDocxChangeMarkers): void;
 export declare function hasImportedDocxChangeMarkers(markers: ImportedDocxChangeMarkers): boolean;
+/**
+ * Returns whether one move wrapper uses the bounded, text-only Word shape.
+ * Range-marker moves and relationship-bearing children intentionally remain on
+ * the compatibility path until their structural semantics are modelled.
+ */
+export declare function isSupportedDocxMoveChange(element: Element): boolean;
+/** Counts complete, paired move revisions in a WordprocessingML story. */
+export declare function supportedDocxMovePairCount(document: Document): number;

package/dist/internal/features/work/work-docx-move-revision-export.d.ts

@@ -0,0 +1,35 @@
+export type DocxMoveRevisionRole = 'from' | 'to';
+export interface DocxMoveRevisionRegistration {
+    kind: 'move-from' | 'move-to';
+    wireId: number;
+    id: number;
+    author: string;
+    date: string;
+}
+export interface DocxMoveRevisionPatch {
+    wireId: number;
+    id: number;
+    role: DocxMoveRevisionRole;
+    author: string;
+    date: string;
+}
+/**
+ * Allocates transient revision IDs while the `docx` package creates its
+ * ordinary `w:ins`/`w:del` wrappers. The post-pack patcher changes those
+ * wrappers to native `w:moveFrom`/`w:moveTo` elements and restores the shared
+ * logical revision ID. Negative wire IDs cannot collide with the positive
+ * IDs emitted for ordinary tracked changes.
+ */
+export declare class DocxMoveRevisionPatchCollector {
+    readonly patches: DocxMoveRevisionPatch[];
+    private readonly registrations;
+    private nextWireId;
+    register(element: HTMLElement, id: number, revisionDate?: string): DocxMoveRevisionRegistration | null;
+}
+/**
+ * Converts the transient wrappers emitted by `docx` into native Word move
+ * revisions. Every registered side must be emitted at least once; a missing
+ * side is treated as a programming or package-generation error rather than
+ * silently producing a half-move that Word would interpret differently.
+ */
+export declare function patchDocxMoveRevisions(buffer: ArrayBuffer, patches: readonly DocxMoveRevisionPatch[]): Promise<ArrayBuffer>;

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

@@ -106,7 +106,9 @@ export interface WorkDocumentContent {
     comments?: WorkDocumentComment[];
     bibliography?: WorkDocumentBibliography;
 }
-export type WorkDocumentChangeKind = 'insertion' | 'deletion' | 'formatting' | 'paragraph-formatting' | 'numbering';
+export type WorkDocumentChangeKind = 'insertion' | 'deletion' | 'formatting' | 'paragraph-formatting' | 'numbering' | 'move';
+/** The side of a native Word move revision represented by a text mark. */
+export type WorkDocumentMoveRole = 'from' | 'to';
 export type WorkDocumentChangeDecisionAction = 'accept' | 'reject';
 /**
  * Immutable audit record created when an editor accepts or rejects one

package/dist/styles.css

@@ -9256,6 +9256,10 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
   border-left-color: #0f7b78;
 }
 
+.work-document-change-item.move {
+  border-left-color: #b06a1f;
+}
+
 .work-document-change-summary {
   min-width: 0;
   color: var(--a3s-ink);
@@ -9292,6 +9296,11 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
   background: #e5f5f3;
 }
 
+.work-document-change-list .work-document-change-item.move .work-document-change-summary > span {
+  color: #8a4f0f;
+  background: #fff3df;
+}
+
 .work-document-change-summary strong {
   text-overflow: ellipsis;
   white-space: nowrap;

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

@@ -283,15 +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.
 
+Text-only move revisions are a paired inline concern rather than two unrelated
+insert/delete cards. A `move` identity keeps explicit `from` and `to` roles;
+review navigation targets the destination side, while accept or reject validates
+and resolves both equal-text sides in one transaction. Native DOCX import/export
+maps the pair to strict or transitional `w:moveFrom`/`w:moveTo`, and the Yjs
+sidecar stores one immutable `changeKind: "move"` decision record for the
+complete intent.
+
 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.
+revisions. A bounded same-paragraph pass may pair a lexical range that occurs
+exactly once in a delete chunk and once in an insert chunk when its marks and
+carried separators match; the result is one `move` identity with source and
+destination roles. 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. Duplicate,
+rich, cross-paragraph, and over-limit candidates remain ordinary revisions or
+diagnostics rather than being guessed into moves; native paired moves remain
+reviewable when they already exist.
 
 Combine validates rather than guesses. It rejects every imported revision on
 an immutable reviewed snapshot and compares the resulting semantic signature
@@ -580,7 +594,9 @@ The public formatting fixture also exercises the non-windowed review boundary
 with independent character- and paragraph-formatting cards. Focused A3S Test
 suites reject each kind separately, verify that text and the other revision
 remain intact, and prove full paragraph alignment, indentation, spacing, and
-line-height restoration with clean browser diagnostics.
+line-height restoration with clean browser diagnostics. Focused move fixtures
+verify paired source/destination resolution, destination-only navigation,
+immutable collaboration audit, and native DOCX reopen without marker leakage.
 
 Spreadsheet now uses a persistent browser Rust/WASM calculation session. The
 editor initializes it with a sparse workbook replacement, sends bounded cell

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.48.1",
+  "version": "0.50.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -87,12 +87,14 @@
     "playground:preview": "rspress preview -c website/rspress.config.ts --host 127.0.0.1 --port 4175",
     "playground:typecheck": "tsc --noEmit -p playground/tsconfig.json",
     "playground:ime:webkit": "playwright test --config playwright.ime.config.ts",
+    "playground:testkit": "playwright test --config playwright.testkit.config.ts",
     "playground:visual": "playwright test --config playwright.config.ts",
     "playground:visual:docs-changelog": "playwright test visual-tests/docs-changelog.functional.spec.ts --config playwright.config.ts",
     "playground:visual:home": "playwright test visual-tests/playground-home.functional.spec.ts --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-move-revision": "playwright test visual-tests/document-move-revision.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",
@@ -140,8 +142,12 @@
     "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/playground/ --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/playground/ --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-text-box-phone.acl --json && a3s-test run tests/e2e/word-content-controls-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-numbering-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-text-box-phone.acl --json && a3s-test check tests/e2e/word-content-controls-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-numbering-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": "bun run test:e2e:fixtures && A3S_TEST_SUITE=all bash scripts/run-a3s-test-web-gate.sh && bun run test:e2e:testkit",
+    "test:e2e:check": "bun run test:e2e:fixtures && bun scripts/check-a3s-test-suites.ts",
+    "test:e2e:testkit": "bash scripts/run-a3s-testkit-ui-gate.sh",
+    "test:e2e:testkit:check": "A3S_TEST_SUITE=office-testkit-ui.acl bun scripts/check-a3s-test-suites.ts",
+    "test:e2e:all": "bun run test:e2e",
+    "test:e2e:all:check": "bun run test:e2e:check",
     "test:e2e:writer-text-box": "bun run test:e2e:fixtures && A3S_TEST_SUITE=tests/e2e/word-text-box-phone.acl bash scripts/run-a3s-test-web-gate.sh",
     "test:e2e:writer-text-box:check": "a3s-test check tests/e2e/word-text-box-phone.acl --json",
     "test:e2e:writer-content-control": "bun run test:e2e:fixtures && A3S_TEST_SUITE=tests/e2e/word-content-controls-phone.acl bash scripts/run-a3s-test-web-gate.sh",
@@ -293,6 +299,8 @@
     "test:e2e:writer-formatting-revision:check": "a3s-test check tests/e2e/word-formatting-revision.acl --json",
     "test:e2e:writer-paragraph-formatting-revision": "a3s-test run tests/e2e/word-paragraph-formatting-revision.acl --json",
     "test:e2e:writer-paragraph-formatting-revision:check": "a3s-test check tests/e2e/word-paragraph-formatting-revision.acl --json",
+    "test:e2e:writer-move-revision": "a3s-test run tests/e2e/word-move-revision.acl --json",
+    "test:e2e:writer-move-revision:check": "a3s-test check tests/e2e/word-move-revision.acl --json",
     "test:e2e:writer-status": "a3s-test run tests/e2e/word-status-bar.acl --json",
     "test:e2e:writer-status:check": "a3s-test check tests/e2e/word-status-bar.acl --json",
     "test:wps-layout": "powershell -NoProfile -ExecutionPolicy Bypass -File scripts/test-wps-layout-parity.ps1",