@betteroffice/docx 0.4.2 → 0.5.0

package/dist/frameDelta-CLeO7K5z.d.mts

@@ -1,807 +0,0 @@
-import { T as TextModernEffects } from './formatting-gqLFeJ9X.mjs';
-import { D as DrawingScene, c as ShapeTextBodyProperties } from './content-DSb-6a9T.mjs';
-
-interface DisplayList {
-    /** Contract version. Undefined reads as legacy version 0. */
-    contractVersion?: number;
-    pages: DisplayPage[];
-}
-/**
- * Modern (`w14:*`) run text-effect payload carried on text/glyph primitives.
- * Same shape as the document model's `TextModernEffects` — px distances,
- * degree directions, 0..1 opacities, resolved `#rrggbb` colors.
- */
-type DisplayTextModernEffects = TextModernEffects;
-interface DisplayPage {
-    pageIndex: number;
-    width: number;
-    height: number;
-    /** Authored body content box (page-local px), derived from page margins. */
-    contentBounds?: DisplayBounds;
-    /** Authored body column boxes in reading order (page-local px). */
-    columnBounds?: DisplayBounds[];
-    /** Stable section identity for this page. Undefined = legacy/global section. */
-    sectionId?: string;
-    /** Zero-based section ordinal. */
-    sectionIndex?: number;
-    /** Zero-based page ordinal within the section. */
-    sectionPageIndex?: number;
-    /** Effective page number within the section, after any restart. */
-    sectionPageNumber?: number;
-    /** Formatted PAGE label (for example, "vii"). */
-    pageLabel?: string;
-    primitives: DisplayPrimitive[];
-    /** Leading primitives painted beneath the header and footer. */
-    watermarkPrimitiveCount?: number;
-    /** Resolved page background. Undefined = transparent/host white. */
-    background?: string;
-    pageBorders?: PageBorderPrimitive[];
-    header?: HfRegion;
-    footer?: HfRegion;
-    /** Footnote/endnote regions in page coordinates. Undefined = none. */
-    noteAreas?: NoteRegion[];
-    /** Geometry only: the page's content is built when the host asks for it. */
-    unbuilt?: boolean;
-    /** For an unbuilt page, the lowest and highest body position its layout places. */
-    positionSpan?: [number, number];
-}
-/** A page-local rectangle emitted as display-list metadata. */
-interface DisplayBounds {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-/** Page note region; primitives retain normal doc/a11y metadata. */
-interface NoteRegion {
-    kind?: 'footnote' | 'endnote';
-    sectionId?: string;
-    y?: number;
-    height?: number;
-    columns?: number;
-    separatorPrimitives?: DisplayPrimitive[];
-    primitives?: DisplayPrimitive[];
-    noteIds?: number[];
-    /**
-     * Per-note backlink metadata (W17): the body-doc range of each note's
-     * reference mark plus its formatted label, so the a11y mirror can wire
-     * note ↔ reference associations (doc-noteref / doc-backlink). Parallel to
-     * `noteIds`; undefined = legacy region without backlink data.
-     */
-    notes?: NoteRegionNote[];
-}
-/** Backlink metadata for one note in a NoteRegion. */
-interface NoteRegionNote {
-    id?: number;
-    /** Body-doc range of the reference mark anchoring this note. */
-    anchorDocStart?: number;
-    anchorDocEnd?: number;
-    /** Formatted reference label (display number / custom mark). File-derived. */
-    label?: string;
-}
-interface HfRegion {
-    rId: string;
-    kind: 'header' | 'footer';
-    y: number;
-    height: number;
-    primitives: DisplayPrimitive[];
-}
-type DisplayPrimitive = TextRunPrimitive | GlyphRunPrimitive | RectPrimitive | LinePrimitive | ImagePrimitive | ShapePrimitive | DecorationPrimitive;
-interface TableCellRef {
-    row: number;
-    col: number;
-    rowSpan: number;
-    colSpan: number;
-    continuation?: boolean;
-    /** Stable semantic cell identity. */
-    cellId?: string;
-    /** Cell participates as a row/column header. */
-    isHeader?: boolean;
-    /** Header cell was repeated on a continuation page. */
-    repeatedHeader?: boolean;
-    /** Word `w:noWrap` cell behavior. */
-    noWrap?: boolean;
-    /** IDs of header cells that label this data cell. */
-    headerIds?: string[];
-    /** Collapsed-border ownership retained for exact fragment replay. */
-    ownsTopBorder?: boolean;
-    ownsRightBorder?: boolean;
-    ownsBottomBorder?: boolean;
-    ownsLeftBorder?: boolean;
-}
-/** Table-fragment semantics shared by every primitive emitted for that fragment. */
-interface DisplayTableMetadata {
-    tableId?: string;
-    rowStart?: number;
-    rowEnd?: number;
-    rowCount?: number;
-    columnCount?: number;
-    headerRowCount?: number;
-    caption?: string;
-    description?: string;
-    parentTableId?: string;
-}
-/** Resolved review presentation for the primitive's `commentIds`. */
-interface DisplayCommentMetadata {
-    status?: 'active' | 'resolved';
-    authorId?: string;
-    paletteIndex?: number;
-    color?: string;
-    selected?: boolean;
-    /** Reviewer display name (file-derived, attacker-controlled). */
-    authorName?: string;
-    /** Comment date string, passed through verbatim. */
-    date?: string;
-    /** Plain-text comment body excerpt (builder-capped, file-derived). */
-    text?: string;
-    /** Number of replies in the thread. */
-    replyCount?: number;
-    /** Reply summaries in thread order (builder-capped). */
-    replies?: DisplayCommentReply[];
-}
-/** One reply summary inside DisplayCommentMetadata. */
-interface DisplayCommentReply {
-    authorName?: string;
-    date?: string;
-    text?: string;
-}
-/**
- * Inert field identity for a11y announcement. `instruction` is the raw Word
- * field instruction, carried for announcement/inspection ONLY — it is never
- * parsed into behavior or executed by any consumer (see the repo security guidelines security).
- */
-interface DisplayFieldMetadata {
-    /** Painter-resolved category (PAGE, NUMPAGES, DATE, TIME, OTHER). */
-    category?: string;
-    /** Raw Word field type token (e.g. TOC, PAGEREF, REF). */
-    type?: string;
-    /** Raw field instruction text (announce-only, builder-capped). */
-    instruction?: string;
-}
-/** Footnote/endnote reference identity on the body reference-mark primitive. */
-interface DisplayNoteRef {
-    kind?: 'footnote' | 'endnote';
-    id?: number;
-}
-/** Scoped clip/group membership emitted by the Rust compiler. */
-interface DisplayClipGroupMetadata {
-    id?: string;
-    clip?: {
-        x?: number;
-        y?: number;
-        w?: number;
-        h?: number;
-    };
-    opacity?: number;
-}
-/** Horizontal paint slot for text laid out with guessed metrics. */
-interface DisplayPaintClip {
-    x: number;
-    w: number;
-}
-interface StructuralRevision {
-    scope: 'pmark' | 'table' | 'row' | 'cell';
-    author: string;
-    date?: string;
-    revisionId: string;
-    kind: 'ins' | 'del' | 'merge';
-    rowIndex?: number;
-    colIndex?: number;
-}
-interface SdtAttrs {
-    groupId: string;
-    sdtType: string;
-    depth?: number;
-    tag?: string;
-    alias?: string;
-    lock?: string;
-    checked?: boolean;
-    bound?: boolean;
-    repeatingItem?: boolean;
-}
-interface InlineSdtWidgetAttrs {
-    kind: 'checkbox';
-    /** Rich control kind. Undefined = legacy checkbox. */
-    controlKind?: 'checkbox' | 'dropDownList' | 'comboBox' | 'date' | 'picture' | 'repeatingSection';
-    groupId: string;
-    pos: number;
-    tag?: string;
-    alias?: string;
-    checked?: boolean;
-    controlId?: number;
-    value?: string;
-    selectedIndex?: number;
-    listItems?: Array<{
-        displayText?: string;
-        value?: string;
-    }>;
-    dateFormat?: string;
-    dateLanguage?: string;
-    locked?: boolean;
-}
-interface ChartA11yAttrs {
-    label: string;
-}
-interface DocAttrs {
-    docStart?: number;
-    docEnd?: number;
-    blockId?: number;
-    blockKey?: string;
-    fragmentDocStart?: number;
-    fragmentDocEnd?: number;
-    paraId?: string;
-    fromLine?: number;
-    toLine?: number;
-    /** Resolved line index within the owning paragraph. */
-    lineIndex?: number;
-    /**
-     * Table cell the primitive paints inside, when any. The a11y mirror builds
-     * real ARIA table semantics (role table/row/cell, aria-row/colindex) from
-     * this — without it a table block reads as a flat run of text.
-     */
-    cell?: TableCellRef;
-    /** Sanitized hyperlink target when this primitive paints linked content. */
-    href?: string;
-    /** Optional hyperlink tooltip/title for popup UI. */
-    tooltip?: string;
-    /** ScreenTip exposed as DOM `title`; undefined falls back to `tooltip`. */
-    linkTitle?: string;
-    /** Safe hyperlink target frame. */
-    linkTarget?: string;
-    /** Link history bit. Undefined = host-unmanaged. */
-    linkHistory?: boolean;
-    /** Location within the target document. */
-    linkDocLocation?: string;
-    commentIds?: string[];
-    /**
-     * Inert field identity when this primitive paints a field result. The a11y
-     * mirror announces it (data-field-* + aria-description); nothing executes it.
-     */
-    field?: DisplayFieldMetadata;
-    /**
-     * Footnote/endnote reference identity when this primitive is the body
-     * reference mark — the mirror renders it as a doc-noteref link to the
-     * note's mirror element (W17 backlinks).
-     */
-    noteRef?: DisplayNoteRef;
-    revision?: {
-        author: string;
-        date: string;
-        revisionId: string;
-        kind: 'ins' | 'del';
-    };
-    /** Synthetic numbering glyph for the first line of a list paragraph. */
-    listMarker?: boolean;
-    /** Pending suggestion paint for a synthetic numbering glyph. */
-    listMarkerRevision?: 'ins' | 'del';
-    structuralRevision?: StructuralRevision;
-    /** Innermost block-level content-control identity for this primitive. */
-    sdt?: SdtAttrs;
-    /** Full outer-to-inner content-control ancestry. */
-    sdtPath?: SdtAttrs[];
-    /** Inline content-control widget metadata when this text run is its glyph. */
-    inlineSdtWidget?: InlineSdtWidgetAttrs;
-    /** Accessibility summary for primitives that compose one chart block. */
-    chart?: ChartA11yAttrs;
-    /** Logical/source order, independent of visual bidi paint order. */
-    logicalOrder?: number;
-    /** Resolved bidi embedding level. */
-    bidiLevel?: number;
-    /** BCP-47 language for a11y/font fallback. */
-    lang?: string;
-    /** Decorative content is omitted from the accessibility mirror. */
-    decorative?: boolean;
-    /** Authored accessibility name. */
-    ariaLabel?: string;
-    /** Authored accessibility description. */
-    ariaDescription?: string;
-    /** Hidden authored object. Undefined = visible. */
-    hiddenObject?: boolean;
-    /** Stable logical scene/group identity. */
-    groupId?: string;
-    /** Review presentation for comment-associated primitives. */
-    comment?: DisplayCommentMetadata;
-    /** Scoped clip/group membership. Undefined = ungrouped. */
-    clipGroup?: DisplayClipGroupMetadata;
-    /** Enclosing table-fragment identity and accessibility semantics. */
-    table?: DisplayTableMetadata;
-    /** Inline native-shape atom; true only for paragraph-inline shapes. */
-    inlineShapeAtom?: boolean;
-}
-interface TextRunPrimitive extends DocAttrs {
-    kind: 'text';
-    text: string;
-    x: number;
-    baselineY: number;
-    width: number;
-    paintClip?: DisplayPaintClip;
-    font: string;
-    color: string;
-    letterSpacing?: number;
-    wordSpacing?: number;
-    rtl?: boolean;
-    /** 0..1 alpha applied only to this run. Absent = opaque. */
-    opacity?: number;
-    /** Degrees clockwise around the primitive's geometry center. Absent = 0. */
-    rotationDeg?: number;
-    /** Horizontal text scale as a percentage (100 = normal). Absent = 100. */
-    horizontalScale?: number;
-    /** Render glyphs uppercase without changing the accessible source text. */
-    allCaps?: boolean;
-    /** Render lowercase glyphs as small uppercase. */
-    smallCaps?: boolean;
-    /** Hidden run shown in editing view as dimmed/dotted, matching the DOM painter. */
-    hidden?: boolean;
-    /** CSS-like shadow effect from run formatting. */
-    textShadow?: 'shadow' | 'emboss' | 'imprint';
-    /** Outlined / hollow text. */
-    textOutline?: boolean;
-    /** CJK emphasis mark. */
-    emphasisMark?: 'dot' | 'comma' | 'circle' | 'underDot';
-    /** Legacy text-effect class hook for the a11y mirror. */
-    textEffect?: 'blinkBackground' | 'lights' | 'antsBlack' | 'antsRed' | 'shimmer' | 'sparkle';
-    /** Modern w14 text effects (glow/shadow/reflection/textFill/textOutline). */
-    modernEffects?: DisplayTextModernEffects;
-    /** Shaped tab/TOC leader metadata. Undefined = ordinary text. */
-    leaderGlyphs?: Omit<LeaderGlyphPrimitive, 'kind'>;
-}
-interface PositionedGlyph {
-    id: number;
-    x: number;
-    y: number;
-    cluster: number;
-    advance?: number;
-    /** Logical cluster order before bidi reordering. */
-    logicalOrder?: number;
-    /** Bidi embedding level for this cluster. */
-    bidiLevel?: number;
-}
-/** Shaped glyph run with source text for accessibility. */
-interface GlyphRunPrimitive extends DocAttrs {
-    kind: 'glyphRun';
-    fontId: number;
-    size: number;
-    color: string;
-    text: string;
-    glyphs: PositionedGlyph[];
-    paintClip?: DisplayPaintClip;
-    fallbackFont?: string;
-    wordSpacing?: number;
-    rtl?: boolean;
-    /** 0..1 alpha applied only to this run. Absent = opaque. */
-    opacity?: number;
-    /** Degrees clockwise around the primitive's geometry center. Absent = 0. */
-    rotationDeg?: number;
-    /** Horizontal text scale as a percentage (100 = normal). Absent = 100. */
-    horizontalScale?: number;
-    /** Render glyphs uppercase without changing the accessible source text. */
-    allCaps?: boolean;
-    /** Render lowercase glyphs as small uppercase. */
-    smallCaps?: boolean;
-    /** Hidden run shown in editing view as dimmed/dotted, matching the DOM painter. */
-    hidden?: boolean;
-    /** CSS-like shadow effect from run formatting. */
-    textShadow?: 'shadow' | 'emboss' | 'imprint';
-    /** Outlined / hollow text. */
-    textOutline?: boolean;
-    /** CJK emphasis mark. */
-    emphasisMark?: 'dot' | 'comma' | 'circle' | 'underDot';
-    /** Legacy text-effect class hook for the a11y mirror. */
-    textEffect?: 'blinkBackground' | 'lights' | 'antsBlack' | 'antsRed' | 'shimmer' | 'sparkle';
-    /** Modern w14 text effects (glow/shadow/reflection/textFill/textOutline). */
-    modernEffects?: DisplayTextModernEffects;
-    /** Shaped tab/TOC leader metadata. Undefined = ordinary glyph run. */
-    leaderGlyphs?: Omit<LeaderGlyphPrimitive, 'kind'>;
-}
-interface RectPrimitive extends DocAttrs {
-    kind: 'rect';
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-    fill: string;
-    /** Alpha multiplier. Undefined = 1. */
-    opacity?: number;
-}
-/** Word/CSS line recipe retained instead of flattening to a solid stroke. */
-type DisplayBorderStyle = 'solid' | 'double' | 'dotted' | 'dashed' | 'dashDot' | 'dashDotDot' | 'triple' | 'thinThick' | 'thickThin' | 'wave' | 'doubleWave' | 'groove' | 'ridge' | 'inset' | 'outset';
-interface LinePrimitive extends DocAttrs {
-    kind: 'line';
-    x1: number;
-    y1: number;
-    x2: number;
-    y2: number;
-    strokeWidth: number;
-    color: string;
-    dash?: number[];
-    role?: 'border' | 'table-border' | 'table-cut' | 'separator';
-    /** Full border recipe. Undefined = infer solid/dash from `dash`. */
-    borderStyle?: DisplayBorderStyle;
-    /** Secondary color for 3-D/multi-stroke recipes. */
-    secondaryColor?: string;
-    /** Alpha multiplier. Undefined = 1. */
-    opacity?: number;
-    /** Owner of the retained Word border recipe. */
-    borderOwner?: 'cell' | 'fragment' | 'paragraph' | 'textBox';
-}
-interface PageBorderSide {
-    width: number;
-    color: string;
-    style: 'solid' | 'double' | 'dotted' | 'dashed' | 'groove' | 'ridge' | 'inset' | 'outset';
-}
-interface PageBorderPrimitive {
-    kind: 'pageBorder';
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-    zOrder?: 'front' | 'back';
-    top?: PageBorderSide;
-    right?: PageBorderSide;
-    bottom?: PageBorderSide;
-    left?: PageBorderSide;
-}
-interface ImagePrimitive extends DocAttrs {
-    kind: 'image';
-    shapeType?: string;
-    relId: string;
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-    rotationDeg?: number;
-    /** 0..1 alpha applied only to this image. Absent = opaque. */
-    opacity?: number;
-    /** Flip about the content-frame center. Undefined = false. */
-    flipH?: boolean;
-    /** Flip about the content-frame center. Undefined = false. */
-    flipV?: boolean;
-    /** Original image frame when w/h are a transformed layout bbox. */
-    contentFrame?: {
-        x?: number;
-        y?: number;
-        w?: number;
-        h?: number;
-    };
-    /** Canvas/CSS filter string for renderer-owned effects, e.g. watermark washout. */
-    filter?: string;
-    /** True for decorative/non-content images such as picture watermarks. */
-    decorative?: boolean;
-    crop?: {
-        top: number;
-        right: number;
-        bottom: number;
-        left: number;
-    };
-    altText?: string;
-    /** Ordered image effects. Undefined = use legacy `filter` only. */
-    effects?: Array<{
-        kind?: string;
-        amount?: number;
-        threshold?: number;
-        colors?: string[];
-        rawName?: string;
-    }>;
-    /** Picture border recipe. Undefined = none. */
-    border?: {
-        width?: number;
-        color?: string;
-        style?: string;
-        dash?: number[];
-    };
-}
-type ShapePathCommand = {
-    type: 'move';
-    x: number;
-    y: number;
-} | {
-    type: 'line';
-    x: number;
-    y: number;
-} | {
-    type: 'quad';
-    cpx: number;
-    cpy: number;
-    x: number;
-    y: number;
-} | {
-    type: 'cubic';
-    cp1x: number;
-    cp1y: number;
-    cp2x: number;
-    cp2y: number;
-    x: number;
-    y: number;
-} | {
-    type: 'close';
-};
-interface ShapePrimitive extends DocAttrs {
-    kind: 'shape';
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-    /** Page-local path commands scaled from the shape's normalized geometry. */
-    geometryPath: ShapePathCommand[];
-    fill?: string;
-    stroke?: {
-        color: string;
-        width: number;
-        /** DrawingML/CSS dash style token. */
-        dash?: string;
-    };
-    transform?: {
-        rotation?: number;
-        flipH?: boolean;
-        flipV?: boolean;
-    };
-    /** True when the shape carries no accessible inner text. */
-    decorative?: boolean;
-    /** Alpha multiplier. Undefined = 1. */
-    opacity?: number;
-    /** Lossless paint server; undefined = legacy `fill`. */
-    fillPaint?: {
-        kind?: 'none' | 'solid' | 'gradient' | 'pattern' | 'picture' | 'theme';
-        color?: string;
-        angle?: number;
-        gradientType?: string;
-        stops?: Array<{
-            position?: number;
-            color?: string;
-        }>;
-        patternPreset?: string;
-        foregroundColor?: string;
-        backgroundColor?: string;
-        pictureRelId?: string;
-        /**
-         * Resolved SAFE embedded source for a picture fill (`blob:`/`data:` only —
-         * external-mode blip relationships are never resolved, so opening a file
-         * cannot trigger a network fetch). The canvas image resolver rejects any
-         * other scheme as defense in depth. Absent = unresolvable, paint the
-         * legacy `fill`/`color` instead.
-         */
-        pictureSrc?: string;
-        /** Picture source crop fractions (`a:srcRect`, 0..1; negative = outset). */
-        pictureSrcRect?: {
-            left?: number;
-            top?: number;
-            right?: number;
-            bottom?: number;
-        };
-        /** Picture fill mode. Absent = 'stretch' (`a:stretch`). */
-        pictureFillMode?: 'stretch' | 'tile';
-        /** Tile parameters when `pictureFillMode` = 'tile'. Offsets px, scales fractions. */
-        pictureTile?: {
-            offsetX?: number;
-            offsetY?: number;
-            scaleX?: number;
-            scaleY?: number;
-            alignment?: string;
-            flip?: 'none' | 'x' | 'y' | 'xy';
-        };
-        /** Stretch target rect fractions of the shape box (`a:fillRect`, 0..1). */
-        pictureStretchRect?: {
-            left?: number;
-            top?: number;
-            right?: number;
-            bottom?: number;
-        };
-        /** Picture alpha 0..1 (`a:alphaModFix`). Absent = opaque. */
-        pictureOpacity?: number;
-        themeRefIndex?: number;
-    };
-    /** Lossless DrawingML stroke details beyond the legacy `stroke` triple. */
-    strokePaint?: {
-        color?: string;
-        width?: number;
-        dash?: string;
-        customDash?: number[];
-        compound?: 'single' | 'double' | 'thickThin' | 'thinThick' | 'triple';
-        alignment?: 'center' | 'inset';
-        cap?: 'flat' | 'round' | 'square';
-        join?: 'bevel' | 'miter' | 'round';
-        miterLimit?: number;
-        headEnd?: {
-            type?: string;
-            width?: string;
-            length?: string;
-        };
-        tailEnd?: {
-            type?: string;
-            width?: string;
-            length?: string;
-        };
-    };
-    /** Ordered 2-D effects. Undefined = none. */
-    effects?: Array<{
-        kind?: string;
-        color?: string;
-        opacity?: number;
-        blurRadius?: number;
-        distance?: number;
-        direction?: number;
-        size?: number;
-        rawName?: string;
-    }>;
-    /** Effect extents in page px. Undefined = zero. */
-    effectExtent?: {
-        top?: number;
-        right?: number;
-        bottom?: number;
-        left?: number;
-    };
-    /** Versioned heterogeneous DrawingML group/canvas scene. */
-    drawingScene?: DrawingScene;
-    /** Full DrawingML `a:bodyPr` projection for shape text. */
-    textBodyProperties?: ShapeTextBodyProperties;
-}
-interface DecorationPrimitive extends DocAttrs {
-    kind: 'decoration';
-    deco: 'underline' | 'strike' | 'highlight' | 'comment-range' | 'spell';
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-    color: string;
-    dashed?: boolean;
-    dotted?: boolean;
-    /** Exact highlight font-box/source slice. Undefined = legacy rect. */
-    highlightSlice?: {
-        sourceStart?: number;
-        sourceEnd?: number;
-        ascent?: number;
-        descent?: number;
-        includesTrailingWhitespace?: boolean;
-    };
-    /** Full border/decoration recipe. Undefined = solid/dashed/dotted flags. */
-    style?: DisplayBorderStyle;
-}
-/** Shaped tab/TOC leader glyphs; absent metrics mean no painted leader. */
-interface LeaderGlyphPrimitive extends DocAttrs {
-    /** Primitive tag. Undefined when embedded as run metadata. */
-    kind?: 'leaderGlyphs';
-    glyph?: string;
-    count?: number;
-    x?: number;
-    baselineY?: number;
-    advance?: number;
-    width?: number;
-    font?: string;
-    fontId?: number;
-    size?: number;
-    color?: string;
-    rtl?: boolean;
-}
-
-declare const FRAME_DELTA_VERSION = 1;
-declare const FRAME_DELTA_HEADER_BYTES = 80;
-declare const FRAME_DELTA_PAGE_OP_BYTES = 48;
-type FrameDeltaErrorCode = 'invalid-frame' | 'unsupported-version' | 'stale-frame' | 'base-mismatch';
-declare class FrameDeltaError extends Error {
-    readonly code: FrameDeltaErrorCode;
-    constructor(code: FrameDeltaErrorCode, message: string);
-}
-interface FramePageUpsert {
-    readonly kind: 'upsert';
-    readonly pageIndex: number;
-    readonly pageId: bigint;
-    readonly fingerprint: bigint;
-    /** Zero-copy view into {@link DecodedFrameDelta.bytes}. */
-    readonly primitiveIds: BigUint64Array;
-    readonly page: DisplayPage;
-}
-interface FramePageRemove {
-    readonly kind: 'remove';
-    readonly pageIndex: number;
-    readonly pageId: bigint;
-}
-interface FramePageMove {
-    readonly kind: 'move';
-    readonly pageIndex: number;
-    readonly pageId: bigint;
-    readonly fingerprint: bigint;
-}
-interface FramePrimitivePositionPatch {
-    readonly primitiveId: bigint;
-    readonly docStart?: number | null;
-    readonly docEnd?: number | null;
-    readonly fragmentDocStart?: number | null;
-    readonly fragmentDocEnd?: number | null;
-    readonly inlineWidgetPos?: number | null;
-}
-interface FramePagePositionPatch {
-    readonly kind: 'patch-positions';
-    readonly pageIndex: number;
-    readonly pageId: bigint;
-    readonly fingerprint: bigint;
-    readonly patches: readonly FramePrimitivePositionPatch[];
-}
-interface FramePositionShiftRun {
-    readonly start: number;
-    readonly count: number;
-    readonly changedMask: number;
-    readonly delta: number;
-}
-/** A note region note's new backlink anchor; null clears the field. */
-interface FrameNoteAnchor {
-    readonly area: number;
-    readonly note: number;
-    readonly start: number | null;
-    readonly end: number | null;
-}
-interface FramePagePositionShift {
-    readonly kind: 'shift-positions';
-    readonly pageIndex: number;
-    readonly pageId: bigint;
-    readonly fingerprint: bigint;
-    readonly runs: readonly FramePositionShiftRun[];
-    readonly anchors: readonly FrameNoteAnchor[];
-    readonly spanDelta?: number;
-}
-type FramePageOperation = FramePageUpsert | FramePageRemove | FramePageMove | FramePagePositionPatch | FramePagePositionShift;
-interface DecodedFrameDelta {
-    readonly protocolVersion: typeof FRAME_DELTA_VERSION;
-    readonly full: boolean;
-    readonly docEpoch: number;
-    readonly layoutEpoch: number;
-    readonly frameEpoch: number;
-    readonly baseFrameEpoch: number;
-    readonly pageCount: number;
-    readonly contractVersion?: number;
-    readonly operations: readonly FramePageOperation[];
-    /** Complete binary frame; safe to transfer when the caller owns its buffer. */
-    readonly bytes: Uint8Array;
-}
-interface RetainedFramePage {
-    readonly pageIndex: number;
-    readonly pageId: bigint;
-    readonly fingerprint: bigint;
-    readonly primitiveIds: BigUint64Array;
-    readonly page: DisplayPage;
-}
-interface RetainedFrame {
-    readonly protocolVersion: typeof FRAME_DELTA_VERSION;
-    readonly docEpoch: number;
-    readonly layoutEpoch: number;
-    readonly frameEpoch: number;
-    readonly contractVersion?: number;
-    readonly pages: readonly RetainedFramePage[];
-    /** IDs whose canvas/mirror/interactive projections must be replaced. */
-    readonly damagedPageIds: ReadonlySet<bigint>;
-    /** Removed surfaces, retained separately because they are absent from pages. */
-    readonly removedPageIds: ReadonlySet<bigint>;
-    readonly displayList: DisplayList;
-}
-/**
- * Decode and fully validate one binary FrameDelta v1 without mutating retained
- * browser state. Page payloads are typed values, not embedded JSON strings.
- */
-declare function decodeFrameDelta(input: Uint8Array | ArrayBuffer): DecodedFrameDelta;
-/** @internal Decode in resumable slices without publishing partial state. */
-declare function decodeFrameDeltaSteps(input: Uint8Array | ArrayBuffer): Generator<void, DecodedFrameDelta>;
-/** Apply one already-validated frame atomically, rejecting stale generations. */
-declare function applyFrameDelta(previous: RetainedFrame | null, delta: DecodedFrameDelta): RetainedFrame;
-/**
- * Apply a frame while reusing position-only page arenas owned exclusively by
- * the caller. Worker/main resident-engine hot paths replace their outer frame
- * atomically and have no concurrent readers; avoiding deep suffix clones keeps
- * geometry shifts from creating periodic multi-megabyte GC stalls.
- */
-declare function applyFrameDeltaOwned(previous: RetainedFrame | null, delta: DecodedFrameDelta): RetainedFrame;
-/**
- * Hidden in-place mutation counter for one display page. The owned delta path
- * (`applyFrameDeltaOwned`) patches primitive positions through the SAME page
- * object, so page identity alone cannot prove content equality; identity-based
- * consumers (query-facade handle adoption) must compare this revision too. The
- * property is non-enumerable, so serialization and structural reads never see
- * it.
- */
-declare function displayPageRevision(page: DisplayPage): number;
-/**
- * Counts the owned shifts that moved this page's note anchors in place, for
- * consumers that render the anchors (the accessibility mirror) and otherwise
- * key on page identity.
- */
-declare function displayPageNoteAnchorRevision(page: DisplayPage): number;
-
-export { type DisplayList as D, FRAME_DELTA_HEADER_BYTES as F, type GlyphRunPrimitive as G, type HfRegion as H, type ImagePrimitive as I, type LinePrimitive as L, type PositionedGlyph as P, type RetainedFrame as R, type TextRunPrimitive as T, type DisplayPage as a, type DisplayPrimitive as b, type DecodedFrameDelta as c, type DecorationPrimitive as d, type DisplayBounds as e, type DocAttrs as f, FRAME_DELTA_PAGE_OP_BYTES as g, FRAME_DELTA_VERSION as h, FrameDeltaError as i, type FrameDeltaErrorCode as j, type FramePageOperation as k, type RectPrimitive as l, type RetainedFramePage as m, type TableCellRef as n, applyFrameDelta as o, applyFrameDeltaOwned as p, decodeFrameDelta as q, decodeFrameDeltaSteps as r, displayPageNoteAnchorRevision as s, displayPageRevision as t };