@a3s-lab/office 0.2.2 → 0.4.0

package/dist/internal/features/work/work-document-image-layout.d.ts

@@ -1,17 +1,45 @@
 import { type Editor } from '@tiptap/core';
-export type WorkDocumentImageLayout = 'inline' | 'square' | 'topBottom';
+import { type WorkDocumentImageWrapContour, type WorkDocumentImageWrapSide } from './work-document-image-wrap-contour';
+export type WorkDocumentImageLayout = 'inline' | 'square' | 'tight' | 'through' | 'topBottom' | 'none';
 export type WorkDocumentImageAlignment = 'left' | 'center' | 'right';
+export type WorkDocumentImageHorizontalReference = 'column' | 'margin' | 'page';
+export type WorkDocumentImageVerticalReference = 'paragraph' | 'margin' | 'page';
+export interface WorkDocumentImagePosition {
+    horizontalOffset: number | null;
+    verticalOffset: number | null;
+    horizontalReference: WorkDocumentImageHorizontalReference;
+    verticalReference: WorkDocumentImageVerticalReference;
+}
+export interface WorkDocumentImageCrop {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+export interface WorkDocumentImageLayer {
+    relativeHeight: number;
+    behindDocument: boolean;
+    allowOverlap: boolean;
+    layoutInCell: boolean;
+    lockAnchor: boolean;
+}
 export interface WorkDocumentImageLayoutOptions {
     layout: WorkDocumentImageLayout;
     alignment: WorkDocumentImageAlignment;
     wrapDistance: number;
+    wrapSide: WorkDocumentImageWrapSide;
 }
 export interface WorkDocumentImageProperties extends WorkDocumentImageLayoutOptions {
     width: number | null;
     height: number | null;
     lockAspectRatio: boolean;
     alternativeText: string;
+    position?: WorkDocumentImagePosition | null;
+    crop?: WorkDocumentImageCrop | null;
+    contour?: WorkDocumentImageWrapContour | null;
+    layer?: WorkDocumentImageLayer | null;
 }
+export type { WorkDocumentImageWrapContour, WorkDocumentImageWrapPoint, WorkDocumentImageWrapSide, } from './work-document-image-wrap-contour';
 export interface DocumentImageCommandOptions {
     restoreFocus?: boolean;
 }
@@ -24,6 +52,7 @@ declare module '@tiptap/core' {
         };
     }
 }
+export declare const MAX_DOCUMENT_IMAGE_RELATIVE_HEIGHT = 4294967295;
 export declare const DocumentImage: import("@tiptap/core").Node<import("@tiptap/extension-image").ImageOptions, any>;
 export declare function documentImageLayoutOptions(editor: Editor): WorkDocumentImageLayoutOptions;
 export declare function documentImageProperties(editor: Editor): WorkDocumentImageProperties;
@@ -32,9 +61,25 @@ export declare function setDocumentImageLayoutOptions(editor: Editor, value: Par
 export declare function setDocumentImageAlternativeText(editor: Editor, alternativeText: string, options?: DocumentImageCommandOptions): boolean;
 export declare function documentImageAlternativeText(editor: Editor): string;
 export declare function documentImageLayoutFromElement(element: Element): WorkDocumentImageLayoutOptions;
+export declare function documentImagePositionFromElement(element: Element): WorkDocumentImagePosition | null;
+export declare function documentImageCropFromElement(element: Element): WorkDocumentImageCrop | null;
+export declare function documentImageLayerFromElement(element: Element): WorkDocumentImageLayer;
 export declare function normalizeDocumentImageLayoutOptions(value: Partial<Record<keyof WorkDocumentImageLayoutOptions, unknown>>): WorkDocumentImageLayoutOptions;
 export declare function normalizeDocumentImageLayout(value: unknown): WorkDocumentImageLayout;
 export declare function normalizeDocumentImageAlignment(value: unknown): WorkDocumentImageAlignment;
 export declare function normalizeDocumentImageWrapDistance(value: unknown): number;
 export declare function normalizeDocumentImageDimension(value: unknown): number | null;
 export declare function normalizeDocumentImageLockAspectRatio(value: unknown): boolean;
+export declare function normalizeDocumentImagePosition(value: Partial<Record<keyof WorkDocumentImagePosition, unknown>>): WorkDocumentImagePosition | null;
+export declare function normalizeDocumentImageOffset(value: unknown): number | null;
+export declare function normalizeDocumentImageHorizontalReference(value: unknown): WorkDocumentImageHorizontalReference;
+export declare function normalizeDocumentImageVerticalReference(value: unknown): WorkDocumentImageVerticalReference;
+export declare function normalizeDocumentImageCrop(value: Partial<Record<'cropBottom' | 'cropLeft' | 'cropRight' | 'cropTop', unknown>>): WorkDocumentImageCrop | null;
+export declare function normalizeDocumentImageCropEdge(value: unknown): number;
+export declare function normalizeDocumentImageLayer(value: Partial<Record<keyof WorkDocumentImageLayer, unknown>>): WorkDocumentImageLayer;
+export declare function normalizeDocumentImageRelativeHeight(value: unknown): number;
+export declare function documentImageLayerCssZIndex(layer: WorkDocumentImageLayer): number;
+export declare function isContourImageLayout(layout: WorkDocumentImageLayout): layout is 'through' | 'tight';
+export declare function wrapsBesideImage(layout: WorkDocumentImageLayout): boolean;
+export declare function applyDocumentImageCropToElement(element: HTMLElement, crop: WorkDocumentImageCrop | null): void;
+export declare function applyDocumentImageLayerToElement(element: HTMLElement, layer: WorkDocumentImageLayer): void;

package/dist/internal/features/work/work-document-image-wrap-contour.d.ts

@@ -0,0 +1,16 @@
+export type WorkDocumentImageWrapSide = 'bothSides' | 'left' | 'right' | 'largest';
+export interface WorkDocumentImageWrapPoint {
+    x: number;
+    y: number;
+}
+export interface WorkDocumentImageWrapContour {
+    edited: boolean;
+    points: WorkDocumentImageWrapPoint[];
+}
+export declare function normalizeDocumentImageWrapSide(value: unknown): WorkDocumentImageWrapSide;
+export declare function normalizeDocumentImageWrapContour(value: Partial<Record<'edited' | 'points' | 'wrapPolygon' | 'wrapPolygonEdited', unknown>>): WorkDocumentImageWrapContour | null;
+export declare function defaultDocumentImageWrapContour(): WorkDocumentImageWrapContour;
+export declare function documentImageWrapContourFromElement(element: Element): WorkDocumentImageWrapContour | null;
+export declare function serializeDocumentImageWrapPoints(points: readonly WorkDocumentImageWrapPoint[]): string;
+export declare function applyDocumentImageWrapContourToElement(element: HTMLElement, contour: WorkDocumentImageWrapContour | null): void;
+export declare function documentImageWrapContourCss(contour: WorkDocumentImageWrapContour): string;

package/dist/internal/features/work/work-document-incremental-layout.d.ts

@@ -1,4 +1,4 @@
-import type { OfficeKernelLayoutBlock, OfficeKernelLayoutResult, OfficeKernelPageMetrics } from '../../kernel/office-kernel-protocol';
+import type { OfficeKernelLayoutBlock, OfficeKernelLayoutResult } from '../../kernel/office-kernel-protocol';
 export interface PositionedOfficeKernelLayoutBlock {
     block: OfficeKernelLayoutBlock;
     from: number;
@@ -14,4 +14,4 @@ export declare function planIncrementalDocumentLayout(previous: {
     blocks: readonly PositionedOfficeKernelLayoutBlock[];
     layout: OfficeKernelLayoutResult;
 } | null, next: readonly PositionedOfficeKernelLayoutBlock[], dirtyFrom: number): IncrementalDocumentLayoutPlan;
-export declare function mergeIncrementalDocumentLayout(previous: OfficeKernelLayoutResult, partial: OfficeKernelLayoutResult, page: OfficeKernelPageMetrics): OfficeKernelLayoutResult;
+export declare function mergeIncrementalDocumentLayout(previous: OfficeKernelLayoutResult, partial: OfficeKernelLayoutResult): OfficeKernelLayoutResult;

package/dist/internal/features/work/work-document-model-codec.d.ts

@@ -1,3 +1,6 @@
-import type { WorkDocumentContent } from './work-types';
+import { getSchema } from '@tiptap/core';
+import type { WorkDocumentContent, WorkDocumentNode } from './work-types';
+export declare function workDocumentSchema(): ReturnType<typeof getSchema>;
+export declare function serializeWorkDocumentNode(root: WorkDocumentNode): string;
 export declare function createWorkDocumentModelFromContent(content: WorkDocumentContent): WorkDocumentContent;
 export declare function materializeWorkDocumentContent(content: WorkDocumentContent): WorkDocumentContent;

package/dist/internal/features/work/work-document-note-integrity.d.ts

@@ -0,0 +1,2 @@
+import { Plugin } from '@tiptap/pm/state';
+export declare function createDocumentNoteIntegrityPlugin(referenceNodeName?: string, definitionNodeName?: string): Plugin;

package/dist/internal/features/work/work-document-page-borders.d.ts

@@ -0,0 +1,25 @@
+import { type DocumentBorderPresentation, type DocumentParagraphBorder } from './work-document-paragraph-borders';
+import type { WorkDocumentMargins } from './work-types';
+export declare const DOCUMENT_PAGE_BORDER_EDGES: readonly ["top", "left", "bottom", "right"];
+export type WorkDocumentPageBorderEdge = (typeof DOCUMENT_PAGE_BORDER_EDGES)[number];
+export type WorkDocumentPageBorderDisplay = 'allPages' | 'firstPage' | 'notFirstPage';
+export type WorkDocumentPageBorderOffsetFrom = 'page' | 'text';
+export type WorkDocumentPageBorderZOrder = 'front' | 'back';
+export interface WorkDocumentPageBorders {
+    display?: WorkDocumentPageBorderDisplay;
+    offsetFrom?: WorkDocumentPageBorderOffsetFrom;
+    zOrder?: WorkDocumentPageBorderZOrder;
+    edges: Partial<Record<WorkDocumentPageBorderEdge, DocumentParagraphBorder>>;
+}
+export interface ResolvedDocumentPageBorders {
+    display: WorkDocumentPageBorderDisplay;
+    offsetFrom: WorkDocumentPageBorderOffsetFrom;
+    zOrder: WorkDocumentPageBorderZOrder;
+    edges: Partial<Record<WorkDocumentPageBorderEdge, DocumentBorderPresentation>>;
+    insets: Record<WorkDocumentPageBorderEdge, number>;
+}
+export declare function normalizeDocumentPageBorders(source: unknown): WorkDocumentPageBorders | null;
+export declare function parseDocumentPageBorders(source: unknown): WorkDocumentPageBorders | null;
+export declare function serializeDocumentPageBorders(source: unknown): string | undefined;
+export declare function documentPageBordersVisible(source: unknown, sectionPage: number): boolean;
+export declare function resolveDocumentPageBorders(source: unknown, margins: WorkDocumentMargins): ResolvedDocumentPageBorders | null;

package/dist/internal/features/work/work-document-page-capture.d.ts

@@ -1,9 +1,16 @@
+export interface WorkLiveDocumentCapturePage {
+    height: number;
+    left: number;
+    top: number;
+    width: number;
+}
 export interface WorkLiveDocumentCaptureSurface {
     element: HTMLElement;
     pageCount: number;
     pageGap: number;
     pageHeight: number;
     pageWidth: number;
+    pages?: readonly WorkLiveDocumentCapturePage[];
 }
 export interface WorkLiveDocumentCapture {
     backgroundColor: string;
@@ -12,4 +19,5 @@ export interface WorkLiveDocumentCapture {
     viewport: HTMLDivElement;
 }
 export declare function mountWorkLiveDocumentCapture(surface: WorkLiveDocumentCaptureSurface, firstPageIndex?: number, captureHeight?: number): WorkLiveDocumentCapture;
+export declare function positionWorkLiveDocumentCapture(capture: WorkLiveDocumentCapture, surface: WorkLiveDocumentCaptureSurface, pageIndex: number, captureHeight?: number): WorkLiveDocumentCapturePage;
 export declare function normalizeWorkLiveDocumentSnapshot(snapshot: HTMLElement): void;

package/dist/internal/features/work/work-document-page-frames.d.ts

@@ -0,0 +1,15 @@
+import type { OfficeKernelPageMetrics } from '../../kernel/office-kernel-protocol';
+export interface DocumentPageFrame {
+    height: number;
+    left: number;
+    page: OfficeKernelPageMetrics;
+    pageIndex: number;
+    top: number;
+    width: number;
+}
+export interface DocumentPageSurfaceGeometry {
+    frames: DocumentPageFrame[];
+    height: number;
+    width: number;
+}
+export declare function documentPageSurfaceGeometry(pages: readonly OfficeKernelPageMetrics[], fallback: OfficeKernelPageMetrics, requestedPageCount?: number): DocumentPageSurfaceGeometry;

package/dist/internal/features/work/work-document-page-margins.d.ts

@@ -0,0 +1,56 @@
+import type { WorkDocumentMargins, WorkDocumentSectionLayout } from './work-types';
+export declare const DOCUMENT_PAGE_MARGIN_KEYS: readonly ["top", "right", "bottom", "left", "header", "footer", "gutter"];
+export type WorkDocumentPageMarginKey = (typeof DOCUMENT_PAGE_MARGIN_KEYS)[number];
+export type WorkDocumentPageMarginEdge = 'top' | 'right' | 'bottom' | 'left';
+export type WorkDocumentPageMarginVerticalEdge = 'top' | 'bottom';
+export type WorkDocumentPageMarginMode = 'clearChrome' | 'fromPageEdge';
+export type WorkDocumentGutterPosition = 'left' | 'right' | 'top';
+/**
+ * Canonical Word page-margin geometry in twentieths of a point.
+ *
+ * Keeping the native integer unit avoids changing valid OOXML values merely
+ * because the browser and the editing UI project the same geometry in pixels
+ * and millimetres. Negative top or bottom values retain Word's explicit
+ * header/footer-overlap semantics.
+ */
+export interface WorkDocumentPageMargins {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+    header: number;
+    footer: number;
+    gutter: number;
+    mirrorMargins?: boolean;
+    gutterAtTop?: boolean;
+    gutterOnRight?: boolean;
+}
+export interface ResolvedDocumentPageMargins {
+    body: WorkDocumentMargins;
+    unboundedBody: WorkDocumentMargins;
+    headerDistance: number;
+    footerDistance: number;
+    gutter: number;
+    gutterPosition: WorkDocumentGutterPosition;
+    mirrorMargins: boolean;
+    topMode: WorkDocumentPageMarginMode;
+    bottomMode: WorkDocumentPageMarginMode;
+    bounded: boolean;
+}
+export declare function normalizeDocumentPageMargins(source: unknown): WorkDocumentPageMargins | null;
+export declare function parseDocumentPageMargins(source: unknown): WorkDocumentPageMargins | null;
+export declare function serializeDocumentPageMargins(source: unknown): string | undefined;
+export declare function documentPageMarginsForLayout(layout: Pick<WorkDocumentSectionLayout, 'margins' | 'pageMargins'>): WorkDocumentPageMargins;
+export declare function documentPageMarginsFromBody(margins: WorkDocumentMargins): WorkDocumentPageMargins;
+export declare function documentPageMarginBody(source: unknown, fallback: WorkDocumentMargins): WorkDocumentMargins;
+export declare function documentPageHorizontalMarginTwips(layout: Pick<WorkDocumentSectionLayout, 'margins' | 'pageMargins'>): number;
+export declare function resolveDocumentPageMargins(layout: Pick<WorkDocumentSectionLayout, 'margins' | 'orientation' | 'pageGeometry' | 'pageMargins' | 'pageSize'>, physicalPage?: number): ResolvedDocumentPageMargins;
+export declare function updateDocumentPageMarginMillimeters(layout: WorkDocumentSectionLayout, key: WorkDocumentPageMarginKey, millimeters: number): WorkDocumentSectionLayout;
+export declare function updateDocumentPageMarginMode(layout: WorkDocumentSectionLayout, edge: WorkDocumentPageMarginVerticalEdge, mode: WorkDocumentPageMarginMode): WorkDocumentSectionLayout;
+export declare function updateDocumentGutterPosition(layout: WorkDocumentSectionLayout, position: WorkDocumentGutterPosition): WorkDocumentSectionLayout;
+export declare function updateDocumentMirrorMargins(layout: WorkDocumentSectionLayout, mirrored: boolean): WorkDocumentSectionLayout;
+export declare function reconcileDocumentPageMarginUpdate(previous: WorkDocumentSectionLayout, next: WorkDocumentSectionLayout): WorkDocumentSectionLayout;
+export declare function documentPageMarginGlobalsChanged(previous: WorkDocumentSectionLayout, next: WorkDocumentSectionLayout): boolean;
+export declare function synchronizeDocumentPageMarginGlobals(layout: WorkDocumentSectionLayout, source: WorkDocumentPageMargins): WorkDocumentSectionLayout;
+export declare function twipsToMillimeters(value: number): number;
+export declare function millimetersToTwips(value: number): number;

package/dist/internal/features/work/work-document-page-size.d.ts

@@ -0,0 +1,47 @@
+import type { WorkDocumentPaperSize, WorkDocumentSectionLayout } from './work-types';
+export interface WorkDocumentPageGeometry {
+    width: number;
+    height: number;
+    orientation?: 'portrait' | 'landscape';
+    code?: number;
+}
+export interface WorkDocumentPaperSource {
+    first?: number;
+    other?: number;
+}
+export interface ResolvedDocumentPageSize {
+    width: number;
+    height: number;
+    nativeWidth: number;
+    nativeHeight: number;
+    widthPixels: number;
+    heightPixels: number;
+    widthPoints: number;
+    heightPoints: number;
+    orientation: 'portrait' | 'landscape';
+    preset: WorkDocumentPaperSize;
+    bounded: boolean;
+}
+export declare const DOCUMENT_PAPER_SIZE_PRESETS: readonly ["a3", "a4", "a5", "letter", "legal", "tabloid"];
+export declare const MAX_WORD_PAGE_TWIPS = 31680;
+export declare const MAX_WORD_PAPER_CODE = 118;
+export declare const MAX_WORD_PAPER_SOURCE_CODE = 65535;
+export declare function normalizeDocumentPageGeometry(source: unknown): WorkDocumentPageGeometry | null;
+export declare function normalizeDocumentPaperSource(source: unknown): WorkDocumentPaperSource | null;
+export declare function parseDocumentPageGeometry(source: unknown): WorkDocumentPageGeometry | null;
+export declare function parseDocumentPaperSource(source: unknown): WorkDocumentPaperSource | null;
+export declare function serializeDocumentPageGeometry(source: unknown): string | undefined;
+export declare function serializeDocumentPaperSource(source: unknown): string | undefined;
+export declare function normalizeDocumentPaperSize(source: unknown, fallback?: WorkDocumentPaperSize): WorkDocumentPaperSize;
+export declare function documentPageGeometryForLayout(layout: Pick<WorkDocumentSectionLayout, 'orientation' | 'pageGeometry' | 'pageSize'>): WorkDocumentPageGeometry;
+export declare function documentPageGeometryFromPreset(preset: Exclude<WorkDocumentPaperSize, 'custom'>, orientation: 'portrait' | 'landscape'): WorkDocumentPageGeometry;
+export declare function documentPaperSizeForGeometry(source: unknown): WorkDocumentPaperSize;
+export declare function documentPageOrientationForGeometry(source: unknown, fallback?: 'portrait' | 'landscape'): 'portrait' | 'landscape';
+export declare function resolveDocumentPageSize(layout: Pick<WorkDocumentSectionLayout, 'orientation' | 'pageGeometry' | 'pageSize'>): ResolvedDocumentPageSize;
+export declare function applyDocumentPageGeometry(layout: WorkDocumentSectionLayout, source: WorkDocumentPageGeometry): WorkDocumentSectionLayout;
+export declare function updateDocumentPaperSizePreset(layout: WorkDocumentSectionLayout, pageSize: Exclude<WorkDocumentPaperSize, 'custom'>): WorkDocumentSectionLayout;
+export declare function updateDocumentCustomPageMillimeters(layout: WorkDocumentSectionLayout, dimension: 'height' | 'width', millimeters: number): WorkDocumentSectionLayout;
+export declare function updateDocumentPageOrientation(layout: WorkDocumentSectionLayout, orientation: 'portrait' | 'landscape'): WorkDocumentSectionLayout;
+export declare function reconcileDocumentPageSizeUpdate(previous: WorkDocumentSectionLayout, next: WorkDocumentSectionLayout): WorkDocumentSectionLayout;
+export declare function pageMillimetersToTwips(value: number): number;
+export declare function pageTwipsToMillimeters(value: number): number;

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

@@ -3,7 +3,6 @@ import type { OfficeKernelPageMetrics, OfficeKernelTextLayoutParagraphResult } f
 import type { DocumentPaginationSnapshot } from './work-document-pagination-types';
 import type { WorkDocumentSectionLayout } from './work-types';
 export declare function measureDocumentLayoutBlocks(editor: Editor, previous?: DocumentPaginationSnapshot | null, dirtyFrom?: number, textLayouts?: ReadonlyMap<string, OfficeKernelTextLayoutParagraphResult>, maximumFragmentedTableRowHeight?: number): DocumentPaginationSnapshot;
-export declare function documentPageMetrics(layout: WorkDocumentSectionLayout): OfficeKernelPageMetrics;
+export declare function documentPageMetrics(layout: WorkDocumentSectionLayout, physicalPage?: number): OfficeKernelPageMetrics;
 export declare function documentPageBodyHeight(page: OfficeKernelPageMetrics): number;
 export declare function documentPaginationSurfaceHeight(pageCount: number, page: OfficeKernelPageMetrics): number;
-export declare function documentPageChromeHeights(editor: Editor): Pick<OfficeKernelPageMetrics, 'headerHeight' | 'footerHeight'>;

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

@@ -1,8 +1,9 @@
-import type { OfficeKernelLayoutBlock, OfficeKernelLayoutBreak, OfficeKernelPageMetrics, OfficeKernelTextLayoutParagraph } from '../../kernel/office-kernel-protocol';
+import type { OfficeKernelLayoutBlock, OfficeKernelLayoutBreak, OfficeKernelPageMetrics, OfficeKernelPageStyle, OfficeKernelTextLayoutParagraph } from '../../kernel/office-kernel-protocol';
 import type { WorkDocumentSectionLayout } from './work-types';
 export interface DocumentPaginationVisualBreak extends OfficeKernelLayoutBreak {
     position: number;
-    page: OfficeKernelPageMetrics;
+    previousPage: OfficeKernelPageMetrics;
+    nextPage: OfficeKernelPageMetrics;
     inlineOffsetLeft: number;
     inlineOffsetRight: number;
     previousPageChrome?: DocumentPaginationVisualPageChrome;
@@ -21,6 +22,8 @@ export interface DocumentPaginationSection {
     index: number;
     position: number;
     layout: WorkDocumentSectionLayout;
+    pageStyleId: string;
+    page: OfficeKernelPageMetrics;
 }
 export interface DocumentTablePaginationBreak {
     tableId: string;
@@ -42,6 +45,7 @@ export interface DocumentTableCellFragmentMeasurement {
     from: number;
     to: number;
     boundaries: DocumentTableCellBoundary[];
+    continuesFromPreviousRow?: boolean;
     tableOffsetLeft?: number;
     outerWidth?: number;
     contentOffsetLeft?: number;
@@ -79,6 +83,7 @@ export interface MeasuredDocumentLayoutBlock {
 }
 export interface DocumentPaginationSnapshot {
     blocks: MeasuredDocumentLayoutBlock[];
+    pageStyles: OfficeKernelPageStyle[];
     measuredBlockCount: number;
     reusedBlockCount: number;
     unsupportedLayout: boolean;

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

@@ -2,10 +2,10 @@ import { Extension } from '@tiptap/core';
 import type { DocumentPaginationVisualBreak } from './work-document-pagination-types';
 export { createDocumentLineFragments, createShapedDocumentLineFragments, findDocumentLineStartOffset, } from './work-document-line-measurement';
 export { reusableDocumentLayoutBlocks } from './work-document-pagination-dom';
-export { documentPageBodyHeight, documentPageChromeHeights, documentPageMetrics, documentPaginationSurfaceHeight, measureDocumentLayoutBlocks, } from './work-document-pagination-measurement';
+export { documentPageBodyHeight, documentPageMetrics, documentPaginationSurfaceHeight, measureDocumentLayoutBlocks, } from './work-document-pagination-measurement';
 export type { DocumentPaginationSection, DocumentPaginationSnapshot, DocumentPaginationVisualBreak, DocumentPaginationVisualPageChrome, DocumentTableCellBoundary, DocumentTableCellFragmentMeasurement, DocumentTableCellPageBreak, DocumentTablePaginationBreak, DocumentTableRowFragmentPlan, DocumentTextLayoutCollection, MeasuredDocumentLayoutBlock, } from './work-document-pagination-types';
 export { createDocumentTableRowFragmentPlan } from './work-document-table-pagination';
-export { collectDocumentTextLayoutParagraphs, collectDocumentTextLayoutRuns, } from './work-document-text-layout';
+export { collectDocumentTextLayoutParagraphs, collectDocumentTextLayoutRuns, documentTextLayoutBatches, } from './work-document-text-layout';
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
         documentPagination: {

package/dist/internal/features/work/work-document-paragraph-borders.d.ts

@@ -0,0 +1,32 @@
+import { type DocxThemeColorReference } from './work-docx-theme-reference';
+export declare const DOCUMENT_PARAGRAPH_BORDERS_ATTRIBUTE = "data-office-paragraph-borders";
+export declare const DOCUMENT_PARAGRAPH_BORDER_EDGES: readonly ["top", "left", "bottom", "right", "between", "bar"];
+export type DocumentParagraphBorderEdge = (typeof DOCUMENT_PARAGRAPH_BORDER_EDGES)[number];
+export declare const DOCUMENT_PARAGRAPH_BORDER_STYLES: readonly ["nil", "none", "single", "thick", "double", "dotted", "dashed", "dotDash", "dotDotDash", "triple", "thinThickSmallGap", "thickThinSmallGap", "thinThickThinSmallGap", "thinThickMediumGap", "thickThinMediumGap", "thinThickThinMediumGap", "thinThickLargeGap", "thickThinLargeGap", "thinThickThinLargeGap", "wave", "doubleWave", "dashSmallGap", "dashDotStroked", "threeDEmboss", "threeDEngrave", "outset", "inset", "apples", "archedScallops", "babyPacifier", "babyRattle", "balloons3Colors", "balloonsHotAir", "basicBlackDashes", "basicBlackDots", "basicBlackSquares", "basicThinLines", "basicWhiteDashes", "basicWhiteDots", "basicWhiteSquares", "basicWideInline", "basicWideMidline", "basicWideOutline", "bats", "birds", "birdsFlight", "cabins", "cakeSlice", "candyCorn", "celticKnotwork", "certificateBanner", "chainLink", "champagneBottle", "checkedBarBlack", "checkedBarColor", "checkered", "christmasTree", "circlesLines", "circlesRectangles", "classicalWave", "clocks", "compass", "confetti", "confettiGrays", "confettiOutline", "confettiStreamers", "confettiWhite", "cornerTriangles", "couponCutoutDashes", "couponCutoutDots", "crazyMaze", "creaturesButterfly", "creaturesFish", "creaturesInsects", "creaturesLadyBug", "crossStitch", "cup", "decoArch", "decoArchColor", "decoBlocks", "diamondsGray", "doubleD", "doubleDiamonds", "earth1", "earth2", "eclipsingSquares1", "eclipsingSquares2", "eggsBlack", "fans", "film", "firecrackers", "flowersBlockPrint", "flowersDaisies", "flowersModern1", "flowersModern2", "flowersPansy", "flowersRedRose", "flowersRoses", "flowersTeacup", "flowersTiny", "gems", "gingerbreadMan", "gradient", "handmade1", "handmade2", "heartBalloon", "heartGray", "hearts", "heebieJeebies", "holly", "houseFunky", "hypnotic", "iceCreamCones", "lightBulb", "lightning1", "lightning2", "mapPins", "mapleLeaf", "mapleMuffins", "marquee", "marqueeToothed", "moons", "mosaic", "musicNotes", "northwest", "ovals", "packages", "palmsBlack", "palmsColor", "paperClips", "papyrus", "partyFavor", "partyGlass", "pencils", "people", "peopleWaving", "peopleHats", "poinsettias", "postageStamp", "pumpkin1", "pushPinNote2", "pushPinNote1", "pyramids", "pyramidsAbove", "quadrants", "rings", "safari", "sawtooth", "sawtoothGray", "scaredCat", "seattle", "shadowedSquares", "sharksTeeth", "shorebirdTracks", "skyrocket", "snowflakeFancy", "snowflakes", "sombrero", "southwest", "stars", "starsTop", "stars3d", "starsBlack", "starsShadowed", "sun", "swirligig", "tornPaper", "tornPaperBlack", "trees", "triangleParty", "triangles", "tribal1", "tribal2", "tribal3", "tribal4", "tribal5", "tribal6", "triangle1", "triangle2", "triangleCircle1", "triangleCircle2", "shapes1", "shapes2", "twistedLines1", "twistedLines2", "vine", "waveline", "weavingAngles", "weavingBraid", "weavingRibbon", "weavingStrips", "whiteFlowers", "woodwork", "xIllusions", "zanyTriangles", "zigZag", "zigZagStitch"];
+export type DocumentParagraphBorderStyle = (typeof DOCUMENT_PARAGRAPH_BORDER_STYLES)[number];
+export interface DocumentParagraphBorderColor {
+    value: 'auto' | `#${string}`;
+    theme?: DocxThemeColorReference;
+}
+export interface DocumentParagraphBorder {
+    style: DocumentParagraphBorderStyle;
+    color?: DocumentParagraphBorderColor;
+    size?: number;
+    space?: number;
+    shadow?: boolean;
+    frame?: boolean;
+}
+export type DocumentParagraphBorders = Partial<Record<DocumentParagraphBorderEdge, DocumentParagraphBorder>>;
+export declare function normalizeDocumentParagraphBorders(source: unknown): DocumentParagraphBorders | null;
+export declare function normalizeDocumentParagraphBorder(source: unknown): DocumentParagraphBorder | null;
+export declare function parseDocumentParagraphBorders(source: unknown): DocumentParagraphBorders | null;
+export declare function serializeDocumentParagraphBorders(source: unknown): string | undefined;
+export declare function parseDocumentParagraphBordersElement(element: HTMLElement): DocumentParagraphBorders | null;
+export declare function documentParagraphBordersDomAttributes(source: unknown): Record<string, string>;
+export declare function isDocumentParagraphArtBorderStyle(style: DocumentParagraphBorderStyle): boolean;
+export interface DocumentBorderPresentation {
+    color: `#${string}` | 'transparent';
+    style: 'none' | 'solid' | 'dashed' | 'dotted' | 'double' | 'inset' | 'outset';
+    width: number;
+}
+export declare function documentBorderPresentation(border: DocumentParagraphBorder): DocumentBorderPresentation;

package/dist/internal/features/work/work-document-paragraph-identity.d.ts

@@ -0,0 +1,26 @@
+import { Extension } from '@tiptap/core';
+export interface WorkDocumentParagraphIdentity {
+    paragraphId: string;
+    textId: string;
+}
+export interface WorkDocumentParagraphIdentitySource {
+    paragraphId?: unknown;
+    textId?: unknown;
+}
+export interface WorkDocumentParagraphIdentityRegistry {
+    paragraphIds: Set<string>;
+}
+interface DocumentParagraphIdentityOptions {
+    types: string[];
+}
+export declare const DOCUMENT_PARAGRAPH_ID_ATTRIBUTE = "data-office-paragraph-id";
+export declare const DOCUMENT_PARAGRAPH_TEXT_ID_ATTRIBUTE = "data-office-paragraph-text-id";
+export declare const DocumentParagraphIdentity: Extension<DocumentParagraphIdentityOptions, any>;
+export declare function normalizeDocumentParagraphId(value: unknown): string | null;
+export declare function createDocumentParagraphIdentityRegistry(): WorkDocumentParagraphIdentityRegistry;
+export declare function normalizeDocumentParagraphIdentity(source: WorkDocumentParagraphIdentitySource): WorkDocumentParagraphIdentity | null;
+export declare function documentParagraphIdentityFromElement(element: Element): WorkDocumentParagraphIdentity | null;
+export declare function applyDocumentParagraphIdentityToElement(element: Element, source: WorkDocumentParagraphIdentitySource): WorkDocumentParagraphIdentity | null;
+export declare function uniqueDocumentParagraphIdentity(source: WorkDocumentParagraphIdentitySource, registry: WorkDocumentParagraphIdentityRegistry): WorkDocumentParagraphIdentity;
+export declare function createDocumentParagraphIdentity(): WorkDocumentParagraphIdentity;
+export {};

package/dist/internal/features/work/work-document-paragraph-shading.d.ts

@@ -0,0 +1,18 @@
+import { type DocxThemeColorReference } from './work-docx-theme-reference';
+export type DocumentParagraphShadingPattern = 'nil' | 'clear' | 'solid' | 'horzStripe' | 'vertStripe' | 'reverseDiagStripe' | 'diagStripe' | 'horzCross' | 'diagCross' | 'thinHorzStripe' | 'thinVertStripe' | 'thinReverseDiagStripe' | 'thinDiagStripe' | 'thinHorzCross' | 'thinDiagCross' | 'pct5' | 'pct10' | 'pct12' | 'pct15' | 'pct20' | 'pct25' | 'pct30' | 'pct35' | 'pct37' | 'pct40' | 'pct45' | 'pct50' | 'pct55' | 'pct60' | 'pct62' | 'pct65' | 'pct70' | 'pct75' | 'pct80' | 'pct85' | 'pct87' | 'pct90' | 'pct95';
+export interface DocumentParagraphShadingColor {
+    value: 'auto' | `#${string}`;
+    theme?: DocxThemeColorReference;
+}
+export interface DocumentParagraphShading {
+    pattern: DocumentParagraphShadingPattern;
+    color?: DocumentParagraphShadingColor;
+    fill?: DocumentParagraphShadingColor;
+}
+export declare const DOCUMENT_PARAGRAPH_SHADING_PATTERNS: Set<DocumentParagraphShadingPattern>;
+export declare function normalizeDocumentParagraphShading(source: unknown): DocumentParagraphShading | null;
+export declare function parseDocumentParagraphShading(source: unknown): DocumentParagraphShading | null;
+export declare function serializeDocumentParagraphShading(source: unknown): string | undefined;
+export declare function parseDocumentParagraphShadingElement(element: HTMLElement): DocumentParagraphShading | null;
+export declare function documentParagraphShadingDomAttributes(source: unknown): Record<string, string>;
+export declare function normalizeCssColor(source: string | null | undefined): 'transparent' | `#${string}` | null;

package/dist/internal/features/work/work-document-review-conflicts.d.ts

@@ -0,0 +1,35 @@
+import type { Node as ProseMirrorNode } from '@tiptap/pm/model';
+import { type WorkDocumentChange, type WorkDocumentChangeKind } from './work-document-changes';
+import { type WorkDocumentCommentAnchor } from './work-document-comments';
+import type { WorkDocumentComment } from './work-types';
+export type WorkDocumentReviewKind = 'comment' | WorkDocumentChangeKind;
+export type WorkDocumentReviewConflictReason = 'kind-changed' | 'record-removed' | 'removed' | 'text-changed';
+export interface WorkDocumentReviewConflict {
+    readonly id: string;
+    readonly kind: WorkDocumentReviewKind;
+    readonly reason: WorkDocumentReviewConflictReason;
+    readonly previousText: string;
+    readonly nextKind?: WorkDocumentChangeKind;
+    readonly nextText?: string;
+}
+export interface WorkDocumentReviewConflictEvent {
+    readonly artifactId?: string;
+    readonly conflicts: readonly WorkDocumentReviewConflict[];
+}
+export interface WorkDocumentReviewSnapshot {
+    comments: readonly WorkDocumentCommentAnchor[];
+    changes: readonly WorkDocumentChange[];
+}
+export interface ReconcileDocumentReviewConflictsOptions {
+    active: readonly WorkDocumentReviewConflict[];
+    before: WorkDocumentReviewSnapshot;
+    after: WorkDocumentReviewSnapshot;
+    comments: readonly WorkDocumentComment[];
+}
+export interface ReconciledDocumentReviewConflicts {
+    active: WorkDocumentReviewConflict[];
+    detected: WorkDocumentReviewConflict[];
+}
+export declare function collectDocumentReviewSnapshot(document: ProseMirrorNode): WorkDocumentReviewSnapshot;
+export declare function reconcileDocumentReviewConflicts({ active, before, after, comments, }: ReconcileDocumentReviewConflictsOptions): ReconciledDocumentReviewConflicts;
+export declare function documentReviewConflictKey(conflict: WorkDocumentReviewConflict): string;

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

@@ -22,6 +22,10 @@ export interface DocumentSectionNodeAttributes {
     showPageNumbers: boolean;
     pageNumberStart: number | null;
     pageChrome: string;
+    pageBorders: string;
+    pageMargins: string;
+    pageGeometry: string;
+    paperSource: string;
     documentGridType: WorkDocumentGridType | '';
     documentGridLinePitch: number | null;
 }

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

@@ -0,0 +1,19 @@
+import type { WorkDocumentContent } from './work-types';
+export declare const WORK_DOCUMENT_SNAPSHOT_SCHEMA: "a3s.office.document.snapshot";
+export declare const WORK_DOCUMENT_SNAPSHOT_VERSION: 1;
+export declare const WORK_DOCUMENT_SNAPSHOT_MEDIA_TYPE: "application/vnd.a3s.office.document-snapshot+json;version=1";
+export interface WorkDocumentSnapshot {
+    schema: typeof WORK_DOCUMENT_SNAPSHOT_SCHEMA;
+    version: typeof WORK_DOCUMENT_SNAPSHOT_VERSION;
+    content: WorkDocumentContent;
+}
+/**
+ * Encode the complete controlled document value as deterministic JSON.
+ *
+ * The snapshot requires a synchronized structured model. Optional properties
+ * whose value is `undefined` are omitted because undefined is outside the JSON
+ * data model; every JSON-defined field is retained exactly.
+ */
+export declare function encodeWorkDocumentSnapshot(content: WorkDocumentContent): string;
+/** Decode and validate one versioned structured-document snapshot. */
+export declare function decodeWorkDocumentSnapshot(encoded: string): WorkDocumentContent;

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

@@ -0,0 +1,23 @@
+import type { WorkDocumentContent } from './work-types';
+export declare const WORK_DOCUMENT_SOURCE_SCHEMA: "a3s.office.document.source";
+export declare const WORK_DOCUMENT_SOURCE_VERSION: 1;
+export declare const WORK_DOCUMENT_SOURCE_MEDIA_TYPE: "text/markdown; charset=utf-8";
+export interface WorkDocumentSource {
+    schema: typeof WORK_DOCUMENT_SOURCE_SCHEMA;
+    version: typeof WORK_DOCUMENT_SOURCE_VERSION;
+    mediaType: typeof WORK_DOCUMENT_SOURCE_MEDIA_TYPE;
+    content: string;
+}
+/**
+ * Project one structured Office document into an agent-readable source value.
+ *
+ * The source is deliberately a subordinate projection, not a replacement for
+ * the lossless document snapshot. Version 1 supports one structured section so
+ * it cannot silently flatten distinct section layouts.
+ */
+export declare function projectWorkDocumentSource(content: WorkDocumentContent): WorkDocumentSource;
+/**
+ * Apply an agent-readable source revision to the document body while retaining
+ * every Office-owned field and the exact section identity/layout attributes.
+ */
+export declare function applyWorkDocumentSource(content: WorkDocumentContent, source: WorkDocumentSource): WorkDocumentContent;

package/dist/internal/features/work/work-document-table-column-widths.d.ts

@@ -0,0 +1,7 @@
+export type DocumentTableColumnWidthType = 'pixels' | 'percent';
+export declare const MIN_DOCUMENT_TABLE_COLUMN_PERCENT = 1;
+export declare const MAX_DOCUMENT_TABLE_COLUMN_PERCENT = 100;
+export declare function normalizeDocumentTableColumnPercent(value: unknown): number | null;
+export declare function normalizeDocumentTableColumnPercentages(value: unknown, expectedCount?: number): number[] | null;
+export declare function documentTableColumnPercentagesFromElement(cell: HTMLElement): number[] | null;
+export declare function renderDocumentTableColumnPercentages(value: unknown): Record<string, string>;

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

@@ -1,6 +1,7 @@
 import { type DocumentTableVerticalAlign } from './work-document-table-cell-formatting';
 import { type DocumentTableCellMarginOverrides, type DocumentTableProperties } from './work-document-table-geometry';
 import type { DocumentTableRowHeightRule } from './work-document-table-row';
+import { type DocumentTableColumnWidthType } from './work-document-table-column-widths';
 export declare const MIN_DOCUMENT_TABLE_COLUMN_WIDTH = 25;
 export declare const MIN_DOCUMENT_TABLE_ROW_HEIGHT = 12;
 export declare const MAX_DOCUMENT_TABLE_DIMENSION = 4000;
@@ -13,8 +14,10 @@ export interface DocumentTablePropertyChanges {
         repeatHeader?: boolean;
     };
     column?: {
+        type?: DocumentTableColumnWidthType;
         width: number;
         renderedColumnWidths?: readonly number[];
+        renderedTableWidth?: number;
     };
     cell?: {
         verticalAlign: DocumentTableVerticalAlign;

package/dist/internal/features/work/work-document-table-row-identity.d.ts

@@ -0,0 +1,15 @@
+import { Extension } from '@tiptap/core';
+export interface WorkDocumentTableRowIdentity {
+    rowId: string;
+    rowTextId: string;
+}
+export interface WorkDocumentTableRowIdentitySource {
+    rowId?: unknown;
+    rowTextId?: unknown;
+}
+export declare const DOCUMENT_TABLE_ROW_ID_ATTRIBUTE = "data-office-row-id";
+export declare const DOCUMENT_TABLE_ROW_TEXT_ID_ATTRIBUTE = "data-office-row-text-id";
+export declare const DocumentTableRowIdentity: Extension<any, any>;
+export declare function normalizeDocumentTableRowIdentity(source: WorkDocumentTableRowIdentitySource): WorkDocumentTableRowIdentity | null;
+export declare function documentTableRowIdentityFromElement(element: Element): WorkDocumentTableRowIdentity | null;
+export declare function applyDocumentTableRowIdentityToElement(element: Element, source: WorkDocumentTableRowIdentitySource): WorkDocumentTableRowIdentity | null;

package/dist/internal/features/work/work-document-table-sizing.d.ts

@@ -3,11 +3,13 @@ import { type EditorState } from '@tiptap/pm/state';
 import { type DocumentTableRowHeightRule } from './work-document-table-row';
 import { type DocumentTableAlignment, type DocumentTableCellMargins, type DocumentTableLayoutAlgorithm, type DocumentTableLayoutMode, type DocumentTablePreferredWidthType, type DocumentTableProperties } from './work-document-table-geometry';
 import { type DocumentTablePropertyChanges } from './work-document-table-property-changes';
+import { type DocumentTableColumnWidthType } from './work-document-table-column-widths';
 export { normalizeDocumentTableGeometry, normalizeDocumentTableLayoutMode, } from './work-document-table-geometry';
 export type { DocumentTableAlignment, DocumentTableCellMargins, DocumentTableGeometry, DocumentTableLayoutAlgorithm, DocumentTableLayoutMode, DocumentTablePreferredWidth, DocumentTablePreferredWidthType, DocumentTableProperties, } from './work-document-table-geometry';
 export type { DocumentTablePropertyChanges } from './work-document-table-property-changes';
 export interface DocumentTableSizingState {
     columnWidth: number | null;
+    columnWidthType: DocumentTableColumnWidthType;
     rowHeight: number | null;
     rowHeightRule: DocumentTableRowHeightRule | null;
     layoutMode: DocumentTableLayoutMode;
@@ -24,6 +26,7 @@ declare module '@tiptap/core' {
     interface Commands<ReturnType> {
         documentTableSizing: {
             setDocumentTableColumnWidth: (width: number, renderedColumnWidths?: readonly number[]) => ReturnType;
+            setDocumentTableColumnWidthPercent: (width: number, renderedColumnWidths?: readonly number[], renderedTableWidth?: number) => ReturnType;
             setDocumentTableRowHeight: (height: number | null, rule?: DocumentTableRowHeightRule) => ReturnType;
             setDocumentTableLayoutMode: (mode: DocumentTableLayoutMode, renderedTableWidth?: number) => ReturnType;
             setDocumentTableAlignment: (alignment: DocumentTableAlignment) => ReturnType;

package/dist/internal/features/work/work-document-text-layout.d.ts

@@ -1,8 +1,10 @@
 import type { Editor } from '@tiptap/core';
 import type { Node as ProseMirrorNode } from '@tiptap/pm/model';
-import type { OfficeKernelTextLayoutRun } from '../../kernel/office-kernel-protocol';
+import type { OfficeKernelTextLayoutParagraph, OfficeKernelTextLayoutRun } from '../../kernel/office-kernel-protocol';
 import type { WorkDocumentLayoutFont } from './work-document-fonts';
 import type { DocumentPaginationSnapshot, DocumentTextLayoutCollection } from './work-document-pagination-types';
+export declare const DOCUMENT_TEXT_LAYOUT_BATCH_SIZE = 1024;
+export declare function documentTextLayoutBatches(paragraphs: readonly OfficeKernelTextLayoutParagraph[]): OfficeKernelTextLayoutParagraph[][];
 export declare function collectDocumentTextLayoutParagraphs(editor: Editor, fonts: readonly WorkDocumentLayoutFont[], loadedFontIds: ReadonlySet<string>, previous?: DocumentPaginationSnapshot | null, dirtyFrom?: number): DocumentTextLayoutCollection;
 export declare function isDocumentLineFragmentNode(node: ProseMirrorNode): boolean;
 export declare function documentTextLayoutContent(node: ProseMirrorNode): string | null;