@a3s-lab/office 0.48.1 → 0.49.0

package/dist/0~work-office-diagnostics.js

@@ -1,7 +1,7 @@
 import { __webpack_require__ } from "./0~rslib-runtime.js";
 import { contentTypeForPart, directChildren, OoxmlPackage, parseXml, firstDescendant, isDocumentParagraphArtBorderStyle, descendants, directChild, xmlContainsAnyElement, attribute, documentRunBorderIsVisible } from "./6968.js";
 import { normalizeDocumentBookmarkName, docxBookmarkReferenceTarget, DOCUMENT_LEGACY_TEXT_EFFECT_NAMES, normalizeDocumentBookmarkNativeId, supportedDocxDocumentFieldInstruction, supportedDocxBookmarkReferenceInstruction, documentCitationTagsFromInstruction, docxDocumentFieldKind, docxDocumentFieldTarget } from "./4174.js";
-import { isSupportedDocxEquationPlacement, inspectDocxPageSize, inspectDocxContentControls, hasInvalidDocxFieldStructure, createDocxTableStyleResolver, inspectDocxRunBorder, inspectDocxEquation, inspectDocxPageMarginSettings, inspectDocxRunShading, supportedDocxIndexField, docxCaptionSequenceKind, inspectDocxPageBorders, docxCaptionBookmark, inspectDocxLegacyTextEffects, inspectDocxPageMargins, inspectDocxPaperSource, createDocxParagraphStyleResolver, inspectDocxRunFonts, supportedDocxTableOfContentsField, docxFieldOccurrences, supportedDocxIndexEntryField, inspectDocxTextBoxes, markDocxParagraphBorders, isSupportedDocxParagraphFormattingChange, docxFieldOccurrenceIsInlineEditable, inspectDocxHiddenText, isSupportedDocxRunFormattingChange, isSupportedDocxNumberingChange, markDocxParagraphShading, docxFieldInstructions } from "./0~3320.js";
+import { isSupportedDocxEquationPlacement, inspectDocxPageSize, inspectDocxContentControls, hasInvalidDocxFieldStructure, createDocxTableStyleResolver, inspectDocxRunBorder, inspectDocxEquation, inspectDocxPageMarginSettings, inspectDocxRunShading, supportedDocxMovePairCount, supportedDocxIndexField, docxCaptionSequenceKind, inspectDocxPageBorders, isSupportedDocxMoveChange, docxCaptionBookmark, inspectDocxLegacyTextEffects, inspectDocxPageMargins, inspectDocxPaperSource, createDocxParagraphStyleResolver, inspectDocxRunFonts, supportedDocxTableOfContentsField, docxFieldOccurrences, supportedDocxIndexEntryField, inspectDocxTextBoxes, markDocxParagraphBorders, isSupportedDocxParagraphFormattingChange, docxFieldOccurrenceIsInlineEditable, inspectDocxHiddenText, isSupportedDocxRunFormattingChange, isSupportedDocxNumberingChange, markDocxParagraphShading, docxFieldInstructions } from "./0~5600.js";
 import { normalizeDocumentHref } from "./0~work-document-links.js";
 import { xmlAttributeLocalName, resolveDocxOpenTypeFeatures, inspectDocxProofingLanguages, readDocxBibliography, inspectDocxEmphasisMark, createDocxThemeResolver, DOCX_WORD_2010_NAMESPACE, inspectDocxNoProof, parseDocxParagraphDefaultCollapsed, readDocxImageTransform, DOCX_WORDPROCESSING_NAMESPACES, xmlAttributeNamespace, inspectDocxKerningThresholdHalfPoints } from "./0~3534.js";
 import { updateSpreadsheetWorksheetCompatibilitySummary, inspectXlsxPivotTables, isSupportedXlsxChartLegend, isSupportedXlsxChartPlotLayout, xlsxChartNodeUsesStackedGrouping, isSupportedXlsxChartSeriesFormatting, readXlsxFormulaFeaturesFromPackage, inspectXlsxHeaderFooterText, emptySpreadsheetWorksheetCompatibilitySummary, isSupportedXlsxWorksheetImageContentType, MAX_XLSX_WORKSHEET_IMAGE_BYTES, xlsxChartSeriesFormattingShapeProperties, diagnoseXlsxProtection, isEditableXlsxPaperSizeCode, isSupportedXlsxCombinationChartNodes } from "./4166.js";
@@ -2223,6 +2223,14 @@ async function analyzeDocxCompatibility(file, messages, sourcePackage) {
                 ...descendants(document, 'ins'),
                 ...descendants(document, 'del')
             ];
+            const moveFromRevisions = descendants(document, 'moveFrom');
+            const moveToRevisions = descendants(document, 'moveTo');
+            const moveRevisionCount = moveFromRevisions.length + moveToRevisions.length;
+            const supportedMovePairCount = supportedDocxMovePairCount(document);
+            const supportedMoveRevisionCount = [
+                ...moveFromRevisions,
+                ...moveToRevisions
+            ].filter(isSupportedDocxMoveChange).length;
             const runFormattingRevisions = descendants(document, 'rPrChange');
             const paragraphFormattingRevisions = descendants(document, 'pPrChange');
             const numberingRevisions = descendants(document, 'numberingChange');
@@ -2233,14 +2241,17 @@ async function analyzeDocxCompatibility(file, messages, sourcePackage) {
             if (supportedRunFormattingRevisionCount) issues.push(work_office_diagnostics_issue('docx.revisions.formatting', 'Character-formatting revisions', `${supportedRunFormattingRevisionCount} bounded character-formatting revision(s) preserve author, date, current formatting, and prior bold, italic, underline, strike, text case, hidden text, outline, shadow, emboss, imprint, subscript, superscript, font, size, color, highlight, character borders, character shading, character scale, spacing, kerning threshold, emphasis mark, baseline position, grid state, proofing languages, and explicit proofing state. They remain reviewable in Work and round-trip as native w:rPrChange records.`, 'info'));
             if (supportedParagraphFormattingRevisionCount) issues.push(work_office_diagnostics_issue('docx.revisions.paragraph-formatting', 'Paragraph-formatting revisions', `${supportedParagraphFormattingRevisionCount} bounded paragraph-formatting revision(s) preserve author, date, current formatting, and prior alignment, direction, indentation, spacing, pagination, outline, tab-stop, border, shading, and collapsed state. They remain reviewable in Work and round-trip as native w:pPrChange records.`, 'info'));
             if (supportedNumberingRevisionCount) issues.push(work_office_diagnostics_issue('docx.revisions.numbering', 'Numbering revisions', `${supportedNumberingRevisionCount} bounded ordered-list numbering revision(s) preserve author, date, prior start, and common decimal, letter, or Roman formats. Contiguous list-item records remain reviewable as one Work change and round-trip as native w:numberingChange records.`, 'info'));
-            if (textRevisions.some((revision)=>!descendants(revision, 't').length && !descendants(revision, 'delText').length) || supportedRunFormattingRevisionCount !== runFormattingRevisions.length || supportedParagraphFormattingRevisionCount !== paragraphFormattingRevisions.length || supportedNumberingRevisionCount !== numberingRevisions.length || [
-                'moveFrom',
-                'moveTo',
+            if (supportedMovePairCount) issues.push(work_office_diagnostics_issue('docx.revisions.move', 'Move revisions', `${supportedMovePairCount} bounded text move revision(s) preserve author, date, source and destination text, remain reviewable as one atomic Work change, and round-trip as native w:moveFrom and w:moveTo records. Rich content, range markers, and relationship-bound moves remain on the compatibility path.`, 'info'));
+            if (textRevisions.some((revision)=>!descendants(revision, 't').length && !descendants(revision, 'delText').length) || supportedRunFormattingRevisionCount !== runFormattingRevisions.length || supportedParagraphFormattingRevisionCount !== paragraphFormattingRevisions.length || supportedNumberingRevisionCount !== numberingRevisions.length || supportedMoveRevisionCount !== moveRevisionCount || supportedMoveRevisionCount !== 2 * supportedMovePairCount || [
+                'moveFromRangeStart',
+                'moveFromRangeEnd',
+                'moveToRangeStart',
+                'moveToRangeEnd',
                 'tblPrChange',
                 'trPrChange',
                 'tcPrChange',
                 'sectPrChange'
-            ].some((name)=>descendants(document, name).length)) issues.push(work_office_diagnostics_issue('docx.revisions.structural', 'Structural revisions', 'Moved content plus unsupported character formatting, paragraph formatting, numbering, section, row, cell, and table-property revisions may be normalized; Work currently reviews body-text insertions/deletions and bounded character-, paragraph-, and ordered-list-numbering subsets.'));
+            ].some((name)=>descendants(document, name).length)) issues.push(work_office_diagnostics_issue('docx.revisions.structural', 'Structural revisions', 'Moved content plus unsupported character formatting, paragraph formatting, numbering, section, row, cell, and table-property revisions may be normalized; Work currently reviews body-text insertions/deletions and bounded text moves, character-, paragraph-, and ordered-list-numbering subsets.'));
             if (captionDiagnostics.hasUnsupportedFields) issues.push(work_office_diagnostics_issue('docx.fields', 'Fields', 'Fields beyond supported body fields, citations, bibliographies, caption SEQ fields, and bookmark or caption REF fields are converted to their current displayed value.'));
             const sectionProperties = descendants(document, 'sectPr');
             const columnProperties = descendants(document, 'cols');

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-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,6 +283,14 @@ 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;
@@ -291,7 +299,9 @@ 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.
+one controlled publication, and one Undo record. The planner does not infer
+move pairs from arbitrary delete/insert similarities; 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 +590,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.49.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",