@docx-editor.dev/core 2.31.0 → 2.33.0

package/dist/{types-barrel-CkF2JbU4.d.ts → tree-op-types-Df4oY2u4.d.ts}

@@ -1,4 +1,4 @@
-import { d as HistoryGroupOutcome } from './editor-scope-C7ke1KJG.js';
+import { H as HistoryGroupOutcome } from './editor-scope-CA6egMaK.js';
 
 /**
  * Why a zip was refused at the trust boundary.
@@ -341,6 +341,7 @@ declare const XML_NAMESPACE_URI = "http://www.w3.org/XML/1998/namespace";
 declare const XMLNS_NAMESPACE_URI = "http://www.w3.org/2000/xmlns/";
 /** The `w14` wordml-2010 extension namespace — `w14:paraId`/`w14:textId` live here. */
 declare const W14_NAMESPACE_URI = "http://schemas.microsoft.com/office/word/2010/wordml";
+/** @internal */
 declare const DRAWINGML_MAIN_NAMESPACE_URI = "http://schemas.openxmlformats.org/drawingml/2006/main";
 declare const WP_NAMESPACE_URI = "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing";
 declare const PIC_NAMESPACE_URI = "http://schemas.openxmlformats.org/drawingml/2006/picture";
@@ -1144,24 +1145,100 @@ type OoxmlInvariantResult = {
  */
 declare function readOoxmlPart(xml: string, metadata: OoxmlPartMetadata, limits?: XmlLimits): OoxmlReadResult;
 
-/** Plain text fitted to a floating shape box, painted with one fill and an optional outline. */
-interface LegacyTextArtProjection {
-    readonly text: string;
-    readonly fontFamily: string;
-    readonly bold: boolean;
-    readonly italic: boolean;
-    /** `RRGGBB`, or null when the shape is not filled. */
-    readonly fillHex: string | null;
-    readonly fillAlpha: number;
-    /** `RRGGBB`, or null when the shape is not stroked. */
-    readonly strokeHex: string | null;
-    readonly strokeAlpha: number;
-    readonly strokeWidthPt: number;
-    /** Clockwise rotation about the box centre, in [0, 360). */
-    readonly rotationDegrees: number;
+/** @internal */
+type ShapeSchemeColorResolver = (scheme: string) => string | null;
+/** A resolved shape colour. @public */
+interface ShapeColor {
+    /** Validated six-character sRGB hex, without `#`. */
+    readonly hex: string;
+    /** Opacity, 0..1. */
+    readonly alpha: number;
+}
+/** @internal */
+declare function resolveColorNode(color: OoxmlNode, resolveSchemeColor?: ShapeSchemeColorResolver, placeholder?: ShapeColor): ShapeColor | null;
+/** @internal */
+declare function directFill(parent: OoxmlElement, resolveSchemeColor?: ShapeSchemeColorResolver, placeholder?: ShapeColor): {
+    readonly present: boolean;
+    readonly color: ShapeColor | null;
+};
+
+/** A pattern fill: the tile's foreground rows and the two colours. @public */
+interface VectorPattern {
+    /** Eight rows of foreground cells from the top; the leftmost cell is the high bit. */
+    readonly rows: readonly number[];
+    readonly foreground: ShapeColor;
+    readonly background: ShapeColor;
+}
+
+/** An affine map `[a, b, c, d, e, f]`: x' = a x + c y + e, y' = b x + d y + f. */
+type AffineMatrix = readonly [number, number, number, number, number, number];
+/** One colour stop of a gradient. @public */
+interface GradientStop {
+    /** Position along the gradient, 0..1. */
+    readonly offset: number;
+    /** Validated six-character sRGB hex, without `#`. */
+    readonly hex: string;
+    /** Opacity, 0..1. */
+    readonly alpha: number;
+}
+/**
+ * A gradient ready to paint. `linear` runs from (x1, y1) to (x2, y2); `radial` grows from
+ * its centre (cx, cy) at offset 0 to radius r at offset 1. Both are in gradient space, which
+ * `matrix` maps onto the component's point space.
+ */
+interface VectorGradient {
+    readonly kind: 'linear' | 'radial';
+    /** Stops in offset order; at least two. */
+    readonly stops: readonly GradientStop[];
+    /** `[x1, y1, x2, y2]` for a linear gradient, `[cx, cy, r]` for a radial one. */
+    readonly coords: readonly number[];
+    /** Gradient space onto the component's point space. */
+    readonly matrix: AffineMatrix;
+}
+
+/**
+ * Outline geometry of a text box shape. A polygon's points are shares of the box, from 0 at
+ * its top-left to 1 at its far side, so the outline stretches with a box that fits its text.
+ */
+type TextboxOutlineProjection = {
+    readonly kind: 'ellipse';
+}
+/** The corner radius is `arc` times the box's shorter side. */
+ | {
+    readonly kind: 'roundRect';
+    readonly arc: number;
+} | {
+    readonly kind: 'polygon';
+    readonly subpaths: readonly (readonly {
+        readonly x: number;
+        readonly y: number;
+    }[])[];
+};
+/**
+ * The text area of a box of any size: shares of its width and height (an oval, a preset), or
+ * the inscribed square of a round rectangle's corner arc on every side.
+ */
+type TextboxTextAreaRule = {
+    readonly kind: 'share';
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+    readonly left: number;
+} | {
+    readonly kind: 'arc';
+    readonly arc: number;
+};
+
+/** A text box shadow: colour, opacity and page offset. */
+interface LegacyTextboxShadow {
+    readonly hex: string;
+    readonly alpha: number;
+    readonly offsetXEmu: number;
+    readonly offsetYEmu: number;
+    /** The shadow is the solid silhouette, seen only outside the shape. */
+    readonly obscured: boolean;
 }
 
-type ShapeSchemeColorResolver = (scheme: string) => string | null;
 type ShapeStyleMatrixResolver = (kind: 'fill' | 'line', index: number) => OoxmlElement | null;
 /**
  * The renderable subset of a `wps:wsp` non-picture graphic, or of one bounded `wpg:wgp`
@@ -1170,6 +1247,8 @@ type ShapeStyleMatrixResolver = (kind: 'fill' | 'line', index: number) => OoxmlE
  * from `a:srgbClr` or from the theme, through `a:schemeClr` or a `wps:style` matrix
  * reference. Anything richer (gradient and picture fills, text bodies, rotation, a nested
  * group) projects as `null` and paints the labelled placeholder instead.
+ *
+ * @public
  */
 interface VectorShapeProjection {
     /** The drawing extent that frames the subpath coordinate space. */
@@ -1200,7 +1279,13 @@ interface VectorShapeProjection {
     readonly strokeWidthEmu: number;
     /** Independently styled paths, always non-empty. A direct shape has one component. */
     readonly components: readonly VectorShapeComponent[];
+    /**
+     * Geometry outside the extent paints too. A drawing canvas does not cut its members at
+     * its frame: a member placed past an edge shows whole.
+     */
+    readonly overflowVisible?: true;
 }
+/** One painted layer of a vector shape. @public */
 interface VectorShapeComponent {
     readonly subpathsEmu: readonly (readonly Readonly<{
         x: number;
@@ -1218,15 +1303,50 @@ interface VectorShapeComponent {
     readonly strokeHex: string | null;
     readonly strokeAlpha: number;
     readonly strokeWidthEmu: number;
+    /**
+     * A gradient fill (`a:gradFill`), painted in place of `fillHex` where the painter can.
+     * `fillHex` then holds the mean of its stops.
+     */
+    readonly fillGradient?: VectorGradient;
+    /** A preset pattern the fill paints with; `fillHex` is its mean colour. */
+    readonly fillPattern?: VectorPattern;
+    /** The outer shadow the shape casts, painted under this component. */
+    readonly shadow?: ShapeShadow;
+    /**
+     * The component only casts `shadow`: it is the silhouette of a shape with several paths,
+     * placed before them, and paints no fill or outline of its own.
+     */
+    readonly shadowOnly?: true;
     /** Authored line ends and joins, inherited from the selected theme line when absent. */
     readonly strokeCap?: 'butt' | 'round' | 'square';
-    readonly strokeJoin?: 'round' | 'bevel';
+    readonly strokeJoin?: 'round' | 'bevel' | 'miter';
+    /** Miter limit in line widths, for a miter join. */
+    readonly strokeMiterLimit?: number;
+    /** Dash and gap lengths in multiples of the stroke width; absent for a solid outline. */
+    readonly strokeDash?: readonly number[];
+    /** Paint clips to these closed subpaths, as an inner shadow clips to its shape. */
+    readonly clipEmu?: readonly (readonly Readonly<{
+        x: number;
+        y: number;
+    }>[])[];
+    /** In a picture's frame: paints under the picture (its shadow and fill), not over it. */
+    readonly belowPicture?: true;
+    /**
+     * How far the stroked path lies outside the geometry by design, in EMU: a picture outline
+     * runs half its width outside the picture, so the whole stroke stays off the picture.
+     */
+    readonly strokeOutsetEmu?: number;
     /**
      * The outline sits inside the closed geometry (`a:ln algn="in"`): painters draw it at twice
      * its width clipped to the path, so the authored width stays inside the shape and adds no
      * reach past the extent. Set only for a closed outline with area.
      */
     readonly strokeInset?: boolean;
+    /**
+     * The subpaths fill by the nonzero winding rule rather than even-odd, so overlapping
+     * subpaths of one direction stay filled where they cross.
+     */
+    readonly fillRule?: 'nonzero';
 }
 /**
  * The story carried by a `wps:wsp` text box (`wps:txbx` → `w:txbxContent`).
@@ -1234,6 +1354,8 @@ interface VectorShapeComponent {
  * The projection captures only the story root and the shape chrome reads; it never walks the
  * story content, so the per-drawing element budget is not spent on paragraphs. Layout collects
  * blocks from `content` under its own caps.
+ *
+ * @internal
  */
 interface TextboxStoryProjection {
     /** Canonical node id of the `w:txbxContent` element. */
@@ -1262,34 +1384,168 @@ interface TextboxStoryProjection {
     readonly strokeHex: string | null;
     /** Outline width in EMU; 0 when absent. */
     readonly strokeWidthEmu: number;
+    /** The shape around a legacy VML story; absent for an upright rectangle. */
+    readonly legacyFrame?: TextboxLegacyFrame;
+    /** The outline is centred on the shape edge, half outside the extent, as VML strokes it. */
+    readonly strokeCentered?: true;
+    /** VML `insetpen`: the outline lies inside the box and insets the text by its full width. */
+    readonly strokeInset?: true;
+    /** VML `mso-fit-shape-to-text`: the box height follows its text when laid out. */
+    readonly fitHeightToText?: true;
+    /** Outline dash pattern in multiples of the outline width; absent for solid. */
+    readonly strokeDash?: readonly number[];
+    /** How outline dashes end; absent for flat ends. */
+    readonly strokeCap?: 'round' | 'square';
+    /** The shape painted again under itself in one colour, offset on the page. */
+    readonly shadow?: LegacyTextboxShadow;
+    /**
+     * The story is DrawingML shape text lowered to read-only paragraphs (a diagram's text): it
+     * lays out without the document's styles and with the DrawingML line rule.
+     */
+    readonly drawingText?: true;
+    /**
+     * The drawing's `vectorShape` paints the box's fill, outline and effects; the story paints
+     * only its text. The fill and outline fields stay for the text insets they give.
+     */
+    readonly chromeByVector?: true;
 }
-
-/** Only generated, escaped SVG and relationship slots; never authored markup. */
-type LegacyGraphicFragment = string | Readonly<{
-    relationshipId: string;
-    before: string;
-    after: string;
-    nativeCrop?: SourceCrop;
-}>;
-interface LegacyGraphicProjection {
-    readonly width: number;
-    readonly height: number;
-    readonly fragments: readonly LegacyGraphicFragment[];
+/** Shape geometry, turn and text flow of a text box: a legacy VML one, or a DrawingML one. */
+interface TextboxLegacyFrame {
+    /** Space between the shape box and its text area, in EMU, before the story insets. */
+    readonly textAreaEmu: Readonly<{
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    }>;
+    /** Outline geometry; null for a rectangle. */
+    readonly outline: TextboxOutlineProjection | null;
+    /** Clockwise shape turn in degrees, in [0, 360). */
+    readonly rotationDegrees: number;
+    /** The text turns with the shape; otherwise it stays upright in the turned box. */
+    readonly textTurnsWithShape: boolean;
+    /**
+     * `vertical` runs lines top to bottom, stacked right to left; `verticalBottomToTop` runs
+     * them bottom to top, stacked left to right.
+     */
+    readonly flow: 'horizontal' | 'vertical' | 'verticalBottomToTop';
+    /** The shape paints and its text does not, as a text area some shapes write hides it. */
+    readonly textHidden?: true;
+    /** How the text area follows the box size, for a box that fits its text. */
+    readonly textAreaRule?: TextboxTextAreaRule;
 }
 
-/** Picture color adjustments shared by projection, layout, and paint.
+/** An outer shadow: the shape's silhouette, offset, blurred and filled in one colour. */
+interface ShapeShadow {
+    /** Offset of the silhouette, in the component's point space. */
+    readonly dxEmu: number;
+    /** Vertical offset of the silhouette, in the same units. */
+    readonly dyEmu: number;
+    /** Blur radius in the same units; 0 is a crisp silhouette. */
+    readonly blurEmu: number;
+    /** Validated six-character sRGB hex, without `#`. */
+    readonly hex: string;
+    /** Opacity, 0..1. */
+    readonly alpha: number;
+}
+/**
+ * The effect list a shape paints with, and the colour `phClr` stands for in it.
+ *
+ * @internal
+ */
+interface ShapeEffectList {
+    /** The shape's own `a:effectLst`, or the one in the theme effect style it references. */
+    readonly effectLst: OoxmlElement;
+    /** True when `effectLst` comes from the theme through the shape's `effectRef`. */
+    readonly fromTheme: boolean;
+    /** The colour of the `effectRef`, which `phClr` in a theme effect list stands for. */
+    readonly placeholder?: ShapeColor;
+}
+/**
+ * A mirror image below a picture that fades out downward (`a:reflection`), as the effects
+ * renderer projects it for paint.
+ *
  * @public
  */
-interface DrawingImageEffects {
-    /** Fixed alpha multiplier for raster painting; omitted means opaque. */
-    readonly opacity?: number;
-    readonly grayscale: boolean;
-    readonly brightness: number;
-    readonly contrast: number;
-    readonly bilevel?: number;
+interface ShapeReflection {
+    /** Opacity where the mirror image meets the shape. */
+    readonly startAlpha: number;
+    /** Opacity at `endPosition`; below it the mirror image is clear. */
+    readonly endAlpha: number;
+    /** Where the fade ends, as a share of the shape's height. */
+    readonly endPosition: number;
+    /** Gap between the shape and its mirror image. */
+    readonly distanceEmu: number;
+    /** Blur radius of the mirror image. */
+    readonly blurEmu: number;
 }
 
-/** One text box member of a drawing group. */
+/** Effects that change how a picture itself paints, beyond what its frame draws. @public */
+interface PictureFrameEffects {
+    /** A mirror image of the picture below it. */
+    readonly reflection?: ShapeReflection;
+    /** The picture's edge fades out over this distance inside it. */
+    readonly softEdgeEmu?: number;
+}
+
+/** The rule a layout widens to its line. */
+interface HorizontalRuleProjection {
+    /** `RRGGBB` of the bar, or of its upper band when shaded. */
+    readonly fillHex: string;
+    /** The lower band is light grey, as a groove. */
+    readonly shaded: boolean;
+    /** The bar's share of its line, in (0, 1]. */
+    readonly widthFraction: number;
+    /** A set width in points, which the line caps; absent for a share of the line. */
+    readonly widthPt?: number;
+    /** Where a bar shorter than its line sits on it. */
+    readonly align: 'left' | 'center' | 'right';
+}
+
+/** @internal */
+declare const CHART_GRAPHIC_DATA_URI = "http://schemas.openxmlformats.org/drawingml/2006/chart";
+/** @internal */
+declare const CHART_NAMESPACE_URI = "http://schemas.openxmlformats.org/drawingml/2006/chart";
+/** One resolved chart part. @internal */
+interface ChartPart {
+    /** The `c:chartSpace` root. */
+    readonly chartSpace: OoxmlElement;
+    /** Canonical part name, for story ids and diagnostics. */
+    readonly partName: string;
+    /** The theme's Latin heading and body faces, which chart text takes through tokens. */
+    readonly themeFaces: ChartThemeFaces;
+}
+/** @internal */
+interface ChartThemeFaces {
+    readonly major: string | null;
+    readonly minor: string | null;
+}
+/** Resolves the chart part behind one `c:chart` element of the owner story part. @internal */
+type ChartPartResolver = (chart: OoxmlElement) => ChartPart | null;
+
+/** @internal */
+declare const CHARTEX_GRAPHIC_DATA_URI = "http://schemas.microsoft.com/office/drawing/2014/chartex";
+/** @internal */
+declare const CHARTEX_NAMESPACE_URI = "http://schemas.microsoft.com/office/drawing/2014/chartex";
+/** The namespace of chart style and colour style parts. @internal */
+declare const CHART_STYLE_NAMESPACE_URI = "http://schemas.microsoft.com/office/drawing/2012/chartStyle";
+/** One resolved chartex part. @internal */
+interface ChartexPart {
+    /** The `cx:chartSpace` root. */
+    readonly chartSpace: OoxmlElement;
+    /** Canonical part name, for story ids and diagnostics. */
+    readonly partName: string;
+    /** The `cs:chartStyle` root the chartex part names, or null. */
+    readonly style: OoxmlElement | null;
+    /** The `cs:colorStyle` root the chartex part names, or null. */
+    readonly colors: OoxmlElement | null;
+    /** The theme's Latin heading and body faces, which chart text takes through tokens. */
+    readonly themeFaces: ChartThemeFaces;
+}
+/** Resolves the chartex part behind one `cx:chart` element of the owner story part. @internal */
+type ChartexPartResolver = (chart: OoxmlElement) => ChartexPart | null;
+
+/** One text box member of a drawing group. @internal */
 interface GroupTextboxProjection {
     /** Canonical node id of the member `wps:wsp`; namespaces the story's line ids. */
     readonly memberNodeId: string;
@@ -1309,523 +1565,709 @@ interface GroupTextboxProjection {
     readonly rotationDegrees: number;
 }
 
-/** The relationship namespace `r:id` lives in. */
-declare const OFFICE_RELATIONSHIP_NAMESPACE_URI = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
-/** The `Type` a hyperlink relationship declares. */
-declare const HYPERLINK_RELATIONSHIP_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
-/**
- * What a part's relationships answer for one `r:id`: the authored target and whether the
- * package declared it external. `null` for an id the part does not declare — a DANGLING
- * relationship, which is a real thing in real documents.
- */
-type RelationshipTargetResolver = (relationshipId: string) => {
-    readonly target: string;
-    readonly external: boolean;
-    /**
-     * The PACKAGE's own verdict on this target (`validateExternalTarget`): whether it is an
-     * absolute URI with a safe scheme.
-     *
-     * Carried separately because `sanitizeHref` cannot answer it. That function is a SCHEME
-     * allowlist and deliberately admits relative URLs — the right rule for a value the host
-     * authored, and the wrong one for a value a `.docx` did. A file-supplied
-     * `Target="/admin/delete-account"` has no scheme to refuse, so it would pass the
-     * allowlist and resolve against the EMBEDDING APPLICATION'S origin: a link reading
-     * "Company policy" that issues an authenticated same-origin request to whatever host
-     * app the editor is mounted in. Absent, a target is treated as unverified.
-     */
-    readonly sinkSafe?: boolean;
-} | null;
+/** Opaque handle — bytes are reachable only through {@link mintValidatedImageBytes}. */
+interface ValidatedImageBytesHandle {
+    readonly registryId: number;
+    readonly resourceKey: string;
+    readonly contentId: string;
+    readonly generation: number;
+}
+
 /**
- * What a hyperlink points at, which decides what activating it may do.
+ * The engine's trust-boundary caps: recursion depth, element counts, and the rest.
  *
- * The security-relevant split: an `external` link goes through `sanitizeHref` and opens only on
- * explicit user action, while an anchor merely scrolls and never navigates.
+ * A caller may LOWER any of these but never raise or disable one — an override of `Infinity`,
+ * zero, a negative or `NaN` clamps into `(0, ceiling]` rather than turning the limit off. These
+ * are security ceilings, not performance budgets.
  */
-type HyperlinkKind = 
-/** `r:id` → a relationship with `TargetMode="External"`. Opens somewhere else. */
-'external'
-/** `w:anchor` → a bookmark in this document. Scrolls, never navigates. */
- | 'internal'
+interface ResourceLimits {
+    /** Max nested-structure recursion (tables/shapes/SDT/groups). */
+    readonly maxRecursionDepth: number;
+    /** Max total parsed element count. */
+    readonly maxElementCount: number;
+    /** Max package part count. */
+    readonly maxPartCount: number;
+    /** Max total decompressed bytes (zip-bomb guard). */
+    readonly maxDecompressedBytes: number;
+    /** Max total compressed input bytes. */
+    readonly maxCompressedBytes: number;
+    /** Max decompressed:compressed ratio per entry. */
+    readonly maxCompressionRatio: number;
+    /** In-memory chunk budget for streaming/spooling. */
+    readonly maxChunkBytes: number;
+    /** Max pagination passes before non-convergence is declared. */
+    readonly maxPaginationPasses: number;
+    /** Max queued items in any bounded work queue. */
+    readonly maxQueueDepth: number;
+}
+/** Non-disableable hard ceilings: no resolved limit may exceed these. */
+declare const HARD_CEILINGS: ResourceLimits;
+/** Finite defaults, all <= their hard ceiling. */
+declare const DEFAULT_LIMITS: ResourceLimits;
 /**
- * `r:id` naming a relationship the part does not declare, or one that is not external.
- *
- * The link keeps its runs — the text is never lost twice — but there is nothing to
- * activate, so it paints inert exactly like a refused scheme.
+ * Resolve caller overrides into a frozen, always-finite limit set. Each value is
+ * `min(override>0 ? override : default, ceiling)`. Infinity/0/negative/NaN can
+ * never disable a limit — the hard ceiling always wins.
  */
- | 'unresolved';
-/** A resolved hyperlink: its kind, its target, and the tooltip Word shows on hover. */
-interface HyperlinkTarget {
-    readonly kind: HyperlinkKind;
-    /**
-     * The authored target, verbatim: the relationship's `Target` for an `r:id` link, the
-     * anchor name for an internal one. Save re-emits from the tree, never from this — it is
-     * here so a UI can show what the document actually says.
-     */
-    readonly authored: string;
-    /**
-     * The sanitized runtime projection, or `null` when there is nothing safe to navigate to.
-     * The ONLY value permitted in a DOM `href`, `window.open`, or a copied link.
-     */
-    readonly href: string | null;
-    /** `w:anchor`, for an internal link. */
-    readonly anchor?: string;
-    /** `w:tooltip` — Word's hover text; paint puts it on the anchor's `title`. */
-    readonly tooltip?: string;
-    /** The authored `r:id`, so an edit can rewrite the relationship it names. */
-    readonly relationshipId?: string;
+declare function resolveLimits(overrides?: Partial<ResourceLimits>): ResourceLimits;
+/** Bounded image decode limits (typed-drawings-and-images task 4). */
+/** Trust-boundary caps specific to image decoding and embedding. */
+interface ImageResourceLimits {
+    readonly maxEncodedBytes: number;
+    readonly maxDecodedBytes: number;
+    readonly maxPixels: number;
+    readonly maxDimension: number;
+    readonly maxPolygonPoints: number;
+    readonly maxExternalRedirects: number;
 }
-/** Whether a node is a typed `w:hyperlink`. */
-declare function isHyperlinkNode(node: OoxmlNode): boolean;
-/** A typed hyperlink's `w:anchor`, or undefined. */
-declare function hyperlinkAnchorOf(link: OoxmlNode): string | undefined;
-/** A typed hyperlink's `r:id`, or undefined. */
-declare function hyperlinkRelationshipIdOf(link: OoxmlNode): string | undefined;
+/** Image caps nothing can raise past. A caller's override clamps into these. */
+declare const IMAGE_RESOURCE_HARD_CEILINGS: ImageResourceLimits;
+/** The image caps in force when a host configures none. Conservative and finite. */
+declare const DEFAULT_IMAGE_RESOURCE_LIMITS: ImageResourceLimits;
+/** Resolve caller overrides into frozen image limits; hard ceilings cannot be raised. */
+declare function resolveImageResourceLimits(overrides?: Partial<ImageResourceLimits>): ImageResourceLimits;
+
 /**
- * Read a typed `w:hyperlink` into its target record.
- *
- * `r:id` wins over `w:anchor` when a link carries both, matching Word: the relationship
- * names the document and the anchor names a place inside it, so the pair is a link to a
- * bookmark in ANOTHER file — which this engine will not follow, but whose external half is
- * the part that decides where it points.
+ * Raster media the decode port measures and any authoring path may write.
  *
- * A link with neither is `unresolved`: it paints its runs and does nothing.
+ * BMP and WebP are here for the same reason the other three are: an `<img>` decodes them
+ * natively, so they need a signature and a structural header and nothing else. BMP is what
+ * older documents carry; WebP is what current Word writes.
  */
-declare function hyperlinkTargetOf(link: OoxmlNode, resolve: RelationshipTargetResolver): HyperlinkTarget;
+type SupportedImageMime = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/bmp' | 'image/webp';
+/**
+ * Vector media painted straight from validated bytes. An `<img>` renders SVG in the
+ * browser's secure static mode — no script, no external subresource loads — so there is
+ * no decode step and no raster buffer sized by a file-supplied number.
+ */
+type VectorImageMime = 'image/svg+xml';
+/** Every mime the painter can hand to an `<img>`. */
+type RenderableImageMime = SupportedImageMime | VectorImageMime;
+/**
+ * Media kept in the package byte-for-byte that the painter cannot hand to an `<img>`.
+ * A decode port may rasterize it; without one it paints as a labelled placeholder.
+ */
+type PreservedImageMime = 'image/tiff' | 'image/x-emf' | 'image/x-wmf';
+/** @internal */
+type MetafileImageMime = 'image/x-emf' | 'image/x-wmf';
 
-interface DrawingProjectionLimits {
-    readonly maxCompatibilityBranches: number;
-    readonly maxVisitedElements: number;
-    readonly maxDrawingDepth: number;
+/**
+ * What is known about one embedded image: validated, refused, or still decoding.
+ *
+ * Content type is a CLAIM. Signature sniffing, structural header validation and the decode port
+ * are authoritative, and bytes that fail them never enter public state.
+ */
+type ImageResourceState = {
+    readonly kind: 'ready';
+    readonly partName: string;
+    readonly contentId: string;
+    readonly resourceKey: string;
+    readonly validatedHandle: ValidatedImageBytesHandle;
+    readonly mime: RenderableImageMime;
+    readonly pixelWidth: number;
+    readonly pixelHeight: number;
+    readonly dpiX: number;
+    readonly dpiY: number;
+} | {
+    readonly kind: 'unrenderable';
+    readonly partName: string | null;
+    readonly mime: RenderableImageMime | PreservedImageMime | 'unknown';
+    readonly reason: 'unsupported-format' | 'non-picture-graphic' | 'signature-mismatch' | 'decode-failed' | 'resource-limit';
+} | {
+    readonly kind: 'external';
+    readonly relationshipId: string;
+    readonly sinkSafe: boolean;
+} | {
+    readonly kind: 'missing';
+    readonly relationshipId: string;
+} | {
+    readonly kind: 'pending';
+    readonly resourceKey: string;
+};
+/**
+ * The injected image decoder.
+ *
+ * A port rather than a direct `Image`/`createImageBitmap` call, so a worker or server runtime
+ * supplies its own and the engine never reaches for a browser global.
+ */
+interface ImageDecodePort {
+    decode(bytes: Uint8Array, mime: SupportedImageMime, limits: ImageResourceLimits, 
+    /** Aborted when the owning lookup/session is disposed. */
+    signal?: AbortSignal): Promise<Readonly<{
+        pixelWidth: number;
+        pixelHeight: number;
+        dpiX: number;
+        dpiY: number;
+    }>>;
+    /**
+     * Optional conversion of media an `<img>` cannot render (EMF/WMF metafiles, TIFF) into a
+     * renderable raster. The returned bytes are untrusted and re-enter the full raster
+     * validation path (sniff, header, pixel caps, decode) before they can become a ready
+     * resource. A null return declines the format and keeps the labelled placeholder; so does
+     * a throw, as `decode-failed`.
+     */
+    convertPreserved?(bytes: Uint8Array, mime: PreservedImageMime, limits: ImageResourceLimits, 
+    /** Aborted when the owning lookup/session is disposed. */
+    signal?: AbortSignal): Promise<Readonly<{
+        bytes: Uint8Array;
+        mime: SupportedImageMime;
+    }> | null>;
 }
-interface DrawingDiagnostic {
-    readonly code: 'malformed-drawing' | 'unsupported-graphic' | 'unresolvable-frame' | 'invalid-geometry' | 'resource-refused' | 'wrap-polygon-over-limit' | 'wrap-polygon-malformed';
-    readonly nodeId: string;
-    readonly detail: string | null;
+/** Resolves a relationship id to a validated image resource, or reports why it could not. */
+interface ImageResourceLookup {
+    readonly resolveEmbedded: (ownerPartName: string, relationshipId: string) => Promise<ImageResourceState>;
+    readonly resolveLinked: (ownerPartName: string, relationshipId: string) => ImageResourceState;
+    readonly resolveForProjection: (projection: DrawingProjection) => Promise<ImageResourceState>;
+    readonly liveReferenceCount: (partName: string) => number;
+    readonly dispose: () => void;
+}
+/** Maximum prefix inspected for SVG root detection (exported for bounded-scan tests). */
+declare const MAX_SVG_SNIFF_BYTES = 512;
+/** A raster header that passed structural validation: its real MIME type and pixel extent. */
+interface ValidatedRasterHeader {
+    readonly pixelWidth: number;
+    readonly pixelHeight: number;
+    /** Horizontal physical density when bounded header metadata supplies it. */
+    readonly dpiX?: number;
+    /** Vertical physical density when bounded header metadata supplies it. */
+    readonly dpiY?: number;
 }
+/** Bounded scan for an `<svg` document root (optional `<?xml` prolog only). */
+declare function hasBoundedSvgRoot(bytes: Uint8Array): boolean;
+/** Signature sniffing — authoritative over declared content type. */
+declare function sniffImageMime(bytes: Uint8Array): RenderableImageMime | PreservedImageMime | 'unknown';
+/** Structural PNG IHDR validation before decode. */
+declare function validatePngHeader(bytes: Uint8Array): ValidatedRasterHeader | null;
+/** Structural GIF logical screen descriptor validation before decode. */
+declare function validateGifHeader(bytes: Uint8Array): ValidatedRasterHeader | null;
+/** Bounded JPEG marker scan through the first supported SOF marker. */
+declare function validateJpegHeader(bytes: Uint8Array): ValidatedRasterHeader | null;
+/**
+ * Intrinsic size of an SVG, resolved the way a browser sizes one: absolute `width`/`height`
+ * first, then `viewBox` for the missing axis or ratio, then the CSS 300x150 default.
+ *
+ * This is metadata for insert and reset-to-natural-size only. Layout uses the authored
+ * `wp:extent` and the browser rasterizes into that box, so nothing here sizes an allocation
+ * and an out-of-range value is clamped rather than refused.
+ */
+declare function resolveSvgIntrinsicSize(bytes: Uint8Array, limits: ImageResourceLimits): ValidatedRasterHeader | null;
+/**
+ * Validate a raster image's header structurally and report its real MIME type and extent.
+ *
+ * Content type is a CLAIM; this is what makes it a fact. A file declaring `image/png` over JPEG
+ * bytes is caught here rather than at decode.
+ */
+declare function validateRasterHeader(bytes: Uint8Array, mime: SupportedImageMime): ValidatedRasterHeader | null;
+/** Package-wide live drawing references to a media part name. */
+declare function liveDrawingReferenceCount(pkg: OoxmlPackage, partName: string): number;
+/** How the image cache decodes, and what it will spend doing so. */
+interface CreateImageResourceCacheOptions {
+    readonly limits?: Partial<ImageResourceLimits>;
+    readonly decodePort: ImageDecodePort;
+}
+/**
+ * Derived cache for one immutable package snapshot. Registry identity is
+ * `(package snapshot, decodePort object, normalized limits)` — the first caller
+ * never imposes its decoder or limits on later callers with different options.
+ */
+declare function imageResourceLookupFor(pkg: OoxmlPackage, options: CreateImageResourceCacheOptions): ImageResourceLookup;
+/** @deprecated Prefer {@link imageResourceLookupFor} — registry binds cache to package identity. */
+/** Build the per-document image cache. Validated bytes only; refusals are remembered too. */
+declare function createImageResourceCache(initialPkg: OoxmlPackage, options: CreateImageResourceCacheOptions): ImageResourceLookup;
 
-/** One picture painted as a member of a drawing group. */
-interface GroupPictureProjection {
-    readonly embeddedRelationshipId: string | null;
-    readonly linkedRelationshipId: string | null;
-    readonly crop: Readonly<{
-        left: number;
-        top: number;
-        right: number;
-        bottom: number;
-    }>;
-    /** The picture's rectangle inside the drawing extent, in extent EMU. */
-    readonly frameEmu: Readonly<{
-        x: number;
-        y: number;
-        cx: number;
-        cy: number;
-    }>;
-    /** Canonical node id of the `pic:pic` member. The vector projection skips it. */
-    readonly memberNodeId: string;
+/**
+ * Plain text fitted to a floating shape box, painted with one fill and an optional outline.
+ *
+ * @internal
+ */
+interface LegacyTextArtProjection {
+    readonly text: string;
+    readonly fontFamily: string;
+    readonly bold: boolean;
+    readonly italic: boolean;
+    /** `RRGGBB`, or null when the shape is not filled. */
+    readonly fillHex: string | null;
+    readonly fillAlpha: number;
+    /** `RRGGBB`, or null when the shape is not stroked. */
+    readonly strokeHex: string | null;
+    readonly strokeAlpha: number;
+    readonly strokeWidthPt: number;
+    /** Clockwise rotation about the box centre, in [0, 360). */
+    readonly rotationDegrees: number;
+    /** `trim`: the ink fills the whole box, with no text inset. */
+    readonly trim?: true;
     /**
-     * Whether the group is the chosen branch of a run-level `mc:AlternateContent`. Layout then
-     * drops the whole group when the picture resource fails, as the projection drops other
-     * MC payloads it cannot draw.
+     * Data an installed text art layout (`DrawingRenderers.textArtLayout`) reads: plain JSON
+     * values, so equal projections stay equal. The engine never reads it.
      */
-    readonly alternateContent: boolean;
+    readonly renderData?: unknown;
 }
 
 /**
- * Whether a drawing sits in the text flow or is positioned against a frame.
+ * A chart plot type. A classic chart names it by its element without the `Chart` suffix:
+ * column and bar charts are both `bar`, and `ofPie` is a pie-of-pie or bar-of-pie chart. A
+ * chartex chart names it by its series layout: `waterfall`, `funnel`, `boxWhisker`,
+ * `treemap`, `sunburst` and `regionMap` by their layout id, `histogram` for a clustered
+ * column series, and `pareto` for a Pareto chart (a clustered column series with its
+ * Pareto line).
  *
- * The distinction that decides everything downstream: an inline drawing occupies a character
- * position, while an anchored one has offsets relative to a page, margin or column.
+ * @public
  */
-type DrawingKind = 'inline' | 'anchored';
-/** Nine Word wrap menu targets (inline plus eight floating modes). @public */
-type ImageWrapTarget = 'inline' | 'square' | 'squareLeft' | 'squareRight' | 'tight' | 'through' | 'topAndBottom' | 'behind' | 'inFront';
-/** Every text-wrap mode a drawing may be set to, including `inline`. */
-declare const IMAGE_WRAP_TARGETS: readonly ImageWrapTarget[];
-type DrawingWrapElement = 'none' | 'square' | 'tight' | 'through' | 'topAndBottom';
-type DrawingHorizontalReferenceFrame = 'character' | 'column' | 'insideMargin' | 'leftMargin' | 'margin' | 'outsideMargin' | 'page' | 'rightMargin';
-type DrawingVerticalReferenceFrame = 'bottomMargin' | 'insideMargin' | 'line' | 'margin' | 'outsideMargin' | 'page' | 'paragraph' | 'topMargin';
-/** `a:srcRect` — how much of each edge of the source image is cropped away, as fractions. */
-interface SourceCrop {
-    readonly left: number;
-    readonly top: number;
-    readonly right: number;
-    readonly bottom: number;
-}
-interface DrawingTransform {
-    readonly rotationDegrees: number;
-    readonly flipHorizontal: boolean;
-    readonly flipVertical: boolean;
-    /** Source `a:off` in EMU; defaults to origin when absent. */
-    readonly offsetEmu: Readonly<{
-        x: number;
-        y: number;
-    }>;
-    /** Source `a:ext` in EMU; zero falls back to `wp:extent` at geometry time. */
-    readonly extentEmu: Readonly<{
-        cx: number;
-        cy: number;
-    }>;
-}
+type DrawingChartPlotType = 'area' | 'area3D' | 'bar' | 'bar3D' | 'bubble' | 'doughnut' | 'line' | 'line3D' | 'ofPie' | 'pie' | 'pie3D' | 'radar' | 'scatter' | 'stock' | 'surface' | 'surface3D' | 'waterfall' | 'funnel' | 'histogram' | 'pareto' | 'boxWhisker' | 'treemap' | 'sunburst' | 'regionMap';
 /**
- * What a drawing refuses: selection, movement, resizing, aspect change.
+ * How the page shows a chart: `chart` when the installed chart renderer draws it,
+ * `fallback` when it shows the content saved in its `mc:AlternateContent` fallback (a
+ * picture, a shape, a group or VML), and `placeholder` when it shows the labeled chart
+ * placeholder.
  *
- * Read and honoured rather than advisory — chrome that offered a handle the store will refuse
- * would promise an edit that cannot happen.
+ * @public
  */
-interface DrawingLocks {
-    readonly select: boolean;
-    readonly move: boolean;
-    readonly resize: boolean;
-    readonly changeAspect: boolean;
-}
-interface DrawingLocksInput {
-    readonly select?: boolean;
-    readonly move?: boolean;
-    readonly resize?: boolean;
-    readonly changeAspect?: boolean;
-}
+type DrawingChartShownAs = 'chart' | 'fallback' | 'placeholder';
 /**
- * An anchored drawing's position: offsets, and the frames they are relative to.
+ * The title and plot types of a chart, as text, and how the page shows it.
  *
- * The relative-to bases matter as much as the offsets. Writing an offset without preserving its
- * base re-anchors the drawing against a different reference and moves it somewhere nobody asked.
+ * A drawing record carries it as `chart` whenever the drawing holds a chart whose chart part
+ * can be read, in each of the three states that `shownAs` names. A visible drawing in a
+ * skipped `mc:Choice` can retain a placeholder when its bounds are usable. Chart metadata
+ * is present only when the projection resolves the chart part.
+ *
+ * @public
  */
-interface DrawingPositionInput {
+interface DrawingChartSummary {
     /**
-     * `'simple'` when `@simplePos="1"`: `horizontalEmu` / `verticalEmu` are authoritative
-     * `wp:simplePos` x/y. `'frame'` (default) uses positionH/V relative frames.
+     * The title the chart shows, as plain text: its own title, typed or from a cell, or the name
+     * of its only series for an automatic title. Null when it shows none, and when a title with
+     * no text of its own sits on a chart with several series. Runs of white space collapse to one
+     * space, and the text is cut to at most 200 UTF-16 code units.
+     *
+     * A chartex chart (waterfall, funnel, histogram, Pareto, box and whisker, treemap, sunburst,
+     * region map) reads only its own title text. Its title is null when the title element has
+     * no text of its own and the chart shows its default caption, and a chartex chart never uses
+     * a series name as an automatic title.
      */
-    readonly mode?: 'frame' | 'simple';
-    readonly horizontalEmu?: number;
-    readonly verticalEmu?: number;
-    readonly relativeToH?: DrawingHorizontalReferenceFrame;
-    readonly relativeToV?: DrawingVerticalReferenceFrame;
+    readonly title: string | null;
+    /**
+     * The chart's plot types in document order; a classic combination chart has more than one.
+     * A chartex chart reports exactly one plot type, or none when its series layout is not one
+     * of the chartex types.
+     */
+    readonly plotTypes: readonly DrawingChartPlotType[];
+    /**
+     * How the page shows the chart. The projection sets it from the renderers installed when
+     * the document opened: `chart` (the record has a `vectorShape`), `fallback` (the record
+     * paints the fallback content, such as a picture `resource`), or `placeholder` (the record
+     * has `placeholderGraphicKind` `'chart'`). Read this field rather than the other fields.
+     */
+    readonly shownAs: DrawingChartShownAs;
 }
-interface DrawingProjection {
-    readonly drawingNodeId: string;
-    readonly ownerPartName: string;
-    readonly kind: DrawingKind;
-    readonly relationshipId: string | null;
-    readonly docPrId: number | null;
-    readonly name: string;
-    readonly title: string;
-    readonly description: string;
-    readonly hyperlinkHref: string | null;
-    readonly hidden: boolean;
-    readonly extentEmu: Readonly<{
-        cx: number;
-        cy: number;
-    }>;
-    readonly effectExtentEmu: Readonly<{
-        top: number;
-        right: number;
-        bottom: number;
-        left: number;
-    }>;
-    readonly inlineDistancesEmu: Readonly<{
-        top: number;
-        right: number;
-        bottom: number;
-        left: number;
-    }>;
-    readonly wrap: ImageWrapTarget;
-    readonly wrapGeometry: DrawingWrapProjection | null;
-    readonly position: DrawingPositionProjection | null;
-    readonly anchor: Readonly<{
-        simplePos: boolean;
-        relativeHeight: number;
-        behindDocument: boolean;
-        layoutInCell: boolean;
-        allowOverlap: boolean;
-    }> | null;
-    readonly picture: PictureProjection | null;
-    readonly vectorShape: VectorShapeProjection | null;
-    /** The picture member of a `wpg:wgp` group; `picture` stays null for a group. */
-    readonly groupPicture: GroupPictureProjection | null;
-    readonly textboxStory: TextboxStoryProjection | null;
-    /** Text box members of a `wpg:wgp` group, laid out read-only; absent when none has text. */
-    readonly groupTextboxes?: readonly GroupTextboxProjection[];
-    /** Read-only preview of the supported native VML subset; the canonical XML is untouched. */
-    readonly legacyGraphic?: LegacyGraphicProjection;
-    /** Floating VML text art (a text watermark), fitted to the box by layout. */
-    readonly textArt?: LegacyTextArtProjection;
-    readonly locks: DrawingLocks;
-    readonly effects: DrawingImageEffects;
-    readonly compatibilityBranchNodeId: string | null;
-    readonly diagnostics: readonly DrawingDiagnostic[];
-    /** Layout-only wrap area of an MC payload that cannot paint (`wrapFootprintProjection`). */
-    readonly footprintOnly?: true;
+
+/** Only generated, escaped SVG and relationship slots; never authored markup. */
+type LegacyGraphicFragment = string | Readonly<{
+    relationshipId: string;
+    before: string;
+    after: string;
+    nativeCrop?: SourceCrop;
+}>;
+interface LegacyGraphicProjection {
+    readonly width: number;
+    readonly height: number;
+    readonly fragments: readonly LegacyGraphicFragment[];
+    /**
+     * The relationship of the one uncropped picture that fills the whole graphic, when that is
+     * all it paints. The graphic then resolves to that picture, which every output can paint.
+     */
+    readonly soleImageRelationshipId?: string;
 }
-interface DrawingAccessibility {
+
+/** Picture color adjustments shared by projection, layout, and paint.
+ * @public
+ */
+interface DrawingImageEffects {
+    /** Fixed alpha multiplier for raster painting; omitted means opaque. */
+    readonly opacity?: number;
+    readonly grayscale: boolean;
+    readonly brightness: number;
+    readonly contrast: number;
+    readonly bilevel?: number;
+}
+
+/** The relationship namespace `r:id` lives in. */
+declare const OFFICE_RELATIONSHIP_NAMESPACE_URI = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+/** The `Type` a hyperlink relationship declares. */
+declare const HYPERLINK_RELATIONSHIP_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
+/**
+ * What a part's relationships answer for one `r:id`: the authored target and whether the
+ * package declared it external. `null` for an id the part does not declare — a DANGLING
+ * relationship, which is a real thing in real documents.
+ */
+type RelationshipTargetResolver = (relationshipId: string) => {
+    readonly target: string;
+    readonly external: boolean;
     /**
-     * The record takes part in layout only, for example the wrap area of a payload that cannot
-     * paint. Outputs must not paint, hit-test, select, link, or export it.
+     * The PACKAGE's own verdict on this target (`validateExternalTarget`): whether it is an
+     * absolute URI with a safe scheme.
+     *
+     * Carried separately because `sanitizeHref` cannot answer it. That function is a SCHEME
+     * allowlist and deliberately admits relative URLs — the right rule for a value the host
+     * authored, and the wrong one for a value a `.docx` did. A file-supplied
+     * `Target="/admin/delete-account"` has no scheme to refuse, so it would pass the
+     * allowlist and resolve against the EMBEDDING APPLICATION'S origin: a link reading
+     * "Company policy" that issues an authenticated same-origin request to whatever host
+     * app the editor is mounted in. Absent, a target is treated as unverified.
      */
-    readonly hidden: boolean;
-    readonly decorative: boolean;
-    readonly label: string | null;
+    readonly sinkSafe?: boolean;
+} | null;
+/**
+ * What a hyperlink points at, which decides what activating it may do.
+ *
+ * The security-relevant split: an `external` link goes through `sanitizeHref` and opens only on
+ * explicit user action, while an anchor merely scrolls and never navigates.
+ */
+type HyperlinkKind = 
+/** `r:id` → a relationship with `TargetMode="External"`. Opens somewhere else. */
+'external'
+/** `w:anchor` → a bookmark in this document. Scrolls, never navigates. */
+ | 'internal'
+/**
+ * `r:id` naming a relationship the part does not declare, or one that is not external.
+ *
+ * The link keeps its runs — the text is never lost twice — but there is nothing to
+ * activate, so it paints inert exactly like a refused scheme.
+ */
+ | 'unresolved';
+/** A resolved hyperlink: its kind, its target, and the tooltip Word shows on hover. */
+interface HyperlinkTarget {
+    readonly kind: HyperlinkKind;
+    /**
+     * The authored target, verbatim: the relationship's `Target` for an `r:id` link, the
+     * anchor name for an internal one. Save re-emits from the tree, never from this — it is
+     * here so a UI can show what the document actually says.
+     */
+    readonly authored: string;
+    /**
+     * The sanitized runtime projection, or `null` when there is nothing safe to navigate to.
+     * The ONLY value permitted in a DOM `href`, `window.open`, or a copied link.
+     */
+    readonly href: string | null;
+    /** `w:anchor`, for an internal link. */
+    readonly anchor?: string;
+    /** `w:tooltip` — Word's hover text; paint puts it on the anchor's `title`. */
+    readonly tooltip?: string;
+    /** The authored `r:id`, so an edit can rewrite the relationship it names. */
+    readonly relationshipId?: string;
 }
-interface DrawingPositionProjection {
-    readonly simplePosition: Readonly<{
-        xEmu: number;
-        yEmu: number;
-    }>;
-    readonly horizontal: Readonly<{
-        relativeFrom: DrawingHorizontalReferenceFrame;
-        align: string | null;
-        offsetEmu: number | null;
-    }>;
-    readonly vertical: Readonly<{
-        relativeFrom: DrawingVerticalReferenceFrame;
-        align: string | null;
-        offsetEmu: number | null;
-    }>;
+/** Whether a node is a typed `w:hyperlink`. */
+declare function isHyperlinkNode(node: OoxmlNode): boolean;
+/** A typed hyperlink's `w:anchor`, or undefined. */
+declare function hyperlinkAnchorOf(link: OoxmlNode): string | undefined;
+/** A typed hyperlink's `r:id`, or undefined. */
+declare function hyperlinkRelationshipIdOf(link: OoxmlNode): string | undefined;
+/**
+ * Read a typed `w:hyperlink` into its target record.
+ *
+ * `r:id` wins over `w:anchor` when a link carries both, matching Word: the relationship
+ * names the document and the anchor names a place inside it, so the pair is a link to a
+ * bookmark in ANOTHER file — which this engine will not follow, but whose external half is
+ * the part that decides where it points.
+ *
+ * A link with neither is `unresolved`: it paints its runs and does nothing.
+ */
+declare function hyperlinkTargetOf(link: OoxmlNode, resolve: RelationshipTargetResolver): HyperlinkTarget;
+
+interface DrawingProjectionLimits {
+    readonly maxCompatibilityBranches: number;
+    readonly maxVisitedElements: number;
+    readonly maxDrawingDepth: number;
 }
-interface DrawingWrapProjection {
-    readonly element: DrawingWrapElement;
-    readonly textSide: 'bothSides' | 'left' | 'right' | 'largest';
-    readonly distancesEmu: Readonly<{
+interface DrawingDiagnostic {
+    readonly code: 'malformed-drawing' | 'unsupported-graphic' | 'unresolvable-frame' | 'invalid-geometry' | 'resource-refused' | 'wrap-polygon-over-limit' | 'wrap-polygon-malformed';
+    readonly nodeId: string;
+    readonly detail: string | null;
+}
+/** @internal */
+declare function isElement(node: OoxmlNode): node is OoxmlElement;
+
+/** One picture painted as a member of a drawing group. */
+interface GroupPictureProjection {
+    readonly embeddedRelationshipId: string | null;
+    readonly linkedRelationshipId: string | null;
+    readonly crop: Readonly<{
+        left: number;
         top: number;
         right: number;
         bottom: number;
-        left: number;
     }>;
-    readonly polygon: readonly Readonly<{
+    /** The picture's rectangle inside the drawing extent, in extent EMU. */
+    readonly frameEmu: Readonly<{
+        x: number;
+        y: number;
+        cx: number;
+        cy: number;
+    }>;
+    /** Canonical node id of the `pic:pic` member. The vector projection skips it. */
+    readonly memberNodeId: string;
+    /**
+     * Whether the group is the chosen branch of a run-level `mc:AlternateContent`. Layout then
+     * drops the whole group when the picture resource fails, as the projection drops other
+     * MC payloads it cannot draw.
+     */
+    readonly alternateContent: boolean;
+    /** The ring that clips the picture, in the unit square of the extent; absent for a box. */
+    readonly clipUnit?: readonly Readonly<{
         x: number;
         y: number;
     }>[];
 }
-interface PictureProjection {
-    readonly embeddedRelationshipId: string | null;
-    readonly linkedRelationshipId: string | null;
-    readonly crop: SourceCrop;
-    readonly fillMode: 'stretch' | 'tile';
-    readonly transform: DrawingTransform;
-    readonly presetGeometry: string | null;
-}
-/**
- * Project one `w:drawing` into the resolved shape layout and chrome read.
- *
- * Bounded throughout: extents, crops and nesting all come from a file. Returns a projection that
- * reports `hidden` and its locks rather than throwing, so an unusable drawing degrades to
- * something the surface can skip.
- */
-declare function projectDrawing(drawing: OoxmlDrawingNode, context: Readonly<{
-    ownerPartName: string;
-    supportedMcRequires: ReadonlySet<string>;
-    limits: DrawingProjectionLimits;
-    namespaceScope?: ReadonlyMap<string, string>;
-    resolveRelationship?: RelationshipTargetResolver;
-    resolveSchemeColor?: ShapeSchemeColorResolver;
-    resolveStyleMatrixReference?: ShapeStyleMatrixResolver;
-}>): DrawingProjection | null;
 
-/** Opaque handle — bytes are reachable only through {@link mintValidatedImageBytes}. */
-interface ValidatedImageBytesHandle {
-    readonly registryId: number;
-    readonly resourceKey: string;
-    readonly contentId: string;
-    readonly generation: number;
+/** @internal */
+declare const DIAGRAM_NAMESPACE_URI = "http://schemas.openxmlformats.org/drawingml/2006/diagram";
+/** The parts one diagram drawing renders from. @internal */
+interface DiagramParts {
+    /** The data model root (`dgm:dataModel`): background and outline of the whole diagram. */
+    readonly dataModel: OoxmlElement;
+    /** The saved drawing root (`dsp:drawing`), or null when the package has none. */
+    readonly drawing: OoxmlElement | null;
+    /** Canonical name of the saved drawing part, for diagnostics and cache keys. */
+    readonly drawingPartName: string | null;
+    /** Canonical name of the data model part. */
+    readonly dataPartName: string;
+    /** The layout definition root (`dgm:layoutDef`), or null. */
+    readonly layoutDef: OoxmlElement | null;
+    /** The quick style root (`dgm:styleDef`), or null. */
+    readonly styleDef: OoxmlElement | null;
+    /** The colours root (`dgm:colorsDef`), or null. */
+    readonly colorsDef: OoxmlElement | null;
+    /** The theme's body (minor) Latin font, which diagram text uses unless it names one. */
+    readonly fontFamily: string;
 }
-
 /**
- * The engine's trust-boundary caps: recursion depth, element counts, and the rest.
+ * Resolves the parts behind one `dgm:relIds` element of the owner story part. The same
+ * resolver answers the chart part behind a `c:chart` element through `chart`, so the drawing
+ * projection threads one resolver for every part-backed graphic.
  *
- * A caller may LOWER any of these but never raise or disable one — an override of `Infinity`,
- * zero, a negative or `NaN` clamps into `(0, ceiling]` rather than turning the limit off. These
- * are security ceilings, not performance budgets.
- */
-interface ResourceLimits {
-    /** Max nested-structure recursion (tables/shapes/SDT/groups). */
-    readonly maxRecursionDepth: number;
-    /** Max total parsed element count. */
-    readonly maxElementCount: number;
-    /** Max package part count. */
-    readonly maxPartCount: number;
-    /** Max total decompressed bytes (zip-bomb guard). */
-    readonly maxDecompressedBytes: number;
-    /** Max total compressed input bytes. */
-    readonly maxCompressedBytes: number;
-    /** Max decompressed:compressed ratio per entry. */
-    readonly maxCompressionRatio: number;
-    /** In-memory chunk budget for streaming/spooling. */
-    readonly maxChunkBytes: number;
-    /** Max pagination passes before non-convergence is declared. */
-    readonly maxPaginationPasses: number;
-    /** Max queued items in any bounded work queue. */
-    readonly maxQueueDepth: number;
-}
-/** Non-disableable hard ceilings: no resolved limit may exceed these. */
-declare const HARD_CEILINGS: ResourceLimits;
-/** Finite defaults, all <= their hard ceiling. */
-declare const DEFAULT_LIMITS: ResourceLimits;
-/**
- * Resolve caller overrides into a frozen, always-finite limit set. Each value is
- * `min(override>0 ? override : default, ceiling)`. Infinity/0/negative/NaN can
- * never disable a limit — the hard ceiling always wins.
+ * @internal
  */
-declare function resolveLimits(overrides?: Partial<ResourceLimits>): ResourceLimits;
-/** Bounded image decode limits (typed-drawings-and-images task 4). */
-/** Trust-boundary caps specific to image decoding and embedding. */
-interface ImageResourceLimits {
-    readonly maxEncodedBytes: number;
-    readonly maxDecodedBytes: number;
-    readonly maxPixels: number;
-    readonly maxDimension: number;
-    readonly maxPolygonPoints: number;
-    readonly maxExternalRedirects: number;
+interface DiagramPartResolver {
+    /** The diagram parts behind one `dgm:relIds` element, or null when they do not resolve. */
+    (relIds: OoxmlElement): DiagramParts | null;
+    /** The chart part behind one `c:chart` element of the same story part. */
+    readonly chart?: ChartPartResolver;
+    /** The chartex part behind one `cx:chart` element of the same story part. */
+    readonly chartex?: ChartexPartResolver;
 }
-/** Image caps nothing can raise past. A caller's override clamps into these. */
-declare const IMAGE_RESOURCE_HARD_CEILINGS: ImageResourceLimits;
-/** The image caps in force when a host configures none. Conservative and finite. */
-declare const DEFAULT_IMAGE_RESOURCE_LIMITS: ImageResourceLimits;
-/** Resolve caller overrides into frozen image limits; hard ceilings cannot be raised. */
-declare function resolveImageResourceLimits(overrides?: Partial<ImageResourceLimits>): ImageResourceLimits;
 
 /**
- * Raster media the decode port measures and any authoring path may write.
- *
- * BMP and WebP are here for the same reason the other three are: an `<img>` decodes them
- * natively, so they need a signature and a structural header and nothing else. BMP is what
- * older documents carry; WebP is what current Word writes.
- */
-type SupportedImageMime = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/bmp' | 'image/webp';
-/**
- * Vector media painted straight from validated bytes. An `<img>` renders SVG in the
- * browser's secure static mode — no script, no external subresource loads — so there is
- * no decode step and no raster buffer sized by a file-supplied number.
- */
-type VectorImageMime = 'image/svg+xml';
-/** Every mime the painter can hand to an `<img>`. */
-type RenderableImageMime = SupportedImageMime | VectorImageMime;
-/**
- * Media kept in the package byte-for-byte that the painter cannot hand to an `<img>`.
- * A decode port may rasterize it; without one it paints as a labelled placeholder.
- */
-type PreservedImageMime = 'image/tiff' | 'image/x-emf' | 'image/x-wmf';
-/**
- * What is known about one embedded image: validated, refused, or still decoding.
- *
- * Content type is a CLAIM. Signature sniffing, structural header validation and the decode port
- * are authoritative, and bytes that fail them never enter public state.
- */
-type ImageResourceState = {
-    readonly kind: 'ready';
-    readonly partName: string;
-    readonly contentId: string;
-    readonly resourceKey: string;
-    readonly validatedHandle: ValidatedImageBytesHandle;
-    readonly mime: RenderableImageMime;
-    readonly pixelWidth: number;
-    readonly pixelHeight: number;
-    readonly dpiX: number;
-    readonly dpiY: number;
-} | {
-    readonly kind: 'unrenderable';
-    readonly partName: string | null;
-    readonly mime: RenderableImageMime | PreservedImageMime | 'unknown';
-    readonly reason: 'unsupported-format' | 'non-picture-graphic' | 'signature-mismatch' | 'decode-failed' | 'resource-limit';
-} | {
-    readonly kind: 'external';
-    readonly relationshipId: string;
-    readonly sinkSafe: boolean;
-} | {
-    readonly kind: 'missing';
-    readonly relationshipId: string;
-} | {
-    readonly kind: 'pending';
-    readonly resourceKey: string;
-};
-/**
- * The injected image decoder.
+ * Whether a drawing sits in the text flow or is positioned against a frame.
  *
- * A port rather than a direct `Image`/`createImageBitmap` call, so a worker or server runtime
- * supplies its own and the engine never reaches for a browser global.
+ * The distinction that decides everything downstream: an inline drawing occupies a character
+ * position, while an anchored one has offsets relative to a page, margin or column.
  */
-interface ImageDecodePort {
-    decode(bytes: Uint8Array, mime: SupportedImageMime, limits: ImageResourceLimits, 
-    /** Aborted when the owning lookup/session is disposed. */
-    signal?: AbortSignal): Promise<Readonly<{
-        pixelWidth: number;
-        pixelHeight: number;
-        dpiX: number;
-        dpiY: number;
-    }>>;
-    /**
-     * Optional conversion of media an `<img>` cannot render (EMF/WMF metafiles, TIFF) into a
-     * renderable raster. The returned bytes are untrusted and re-enter the full raster
-     * validation path (sniff, header, pixel caps, decode) before they can become a ready
-     * resource. A null return declines the format and keeps the labelled placeholder; so does
-     * a throw, as `decode-failed`.
-     */
-    convertPreserved?(bytes: Uint8Array, mime: PreservedImageMime, limits: ImageResourceLimits, 
-    /** Aborted when the owning lookup/session is disposed. */
-    signal?: AbortSignal): Promise<Readonly<{
-        bytes: Uint8Array;
-        mime: SupportedImageMime;
-    }> | null>;
-}
-/** Resolves a relationship id to a validated image resource, or reports why it could not. */
-interface ImageResourceLookup {
-    readonly resolveEmbedded: (ownerPartName: string, relationshipId: string) => Promise<ImageResourceState>;
-    readonly resolveLinked: (ownerPartName: string, relationshipId: string) => ImageResourceState;
-    readonly resolveForProjection: (projection: DrawingProjection) => Promise<ImageResourceState>;
-    readonly liveReferenceCount: (partName: string) => number;
-    readonly dispose: () => void;
-}
-/** Maximum prefix inspected for SVG root detection (exported for bounded-scan tests). */
-declare const MAX_SVG_SNIFF_BYTES = 512;
-/** A raster header that passed structural validation: its real MIME type and pixel extent. */
-interface ValidatedRasterHeader {
-    readonly pixelWidth: number;
-    readonly pixelHeight: number;
-    /** Horizontal physical density when bounded header metadata supplies it. */
-    readonly dpiX?: number;
-    /** Vertical physical density when bounded header metadata supplies it. */
-    readonly dpiY?: number;
+type DrawingKind = 'inline' | 'anchored';
+/** Nine Word wrap menu targets (inline plus eight floating modes). @public */
+type ImageWrapTarget = 'inline' | 'square' | 'squareLeft' | 'squareRight' | 'tight' | 'through' | 'topAndBottom' | 'behind' | 'inFront';
+/** Every text-wrap mode a drawing may be set to, including `inline`. */
+declare const IMAGE_WRAP_TARGETS: readonly ImageWrapTarget[];
+type DrawingWrapElement = 'none' | 'square' | 'tight' | 'through' | 'topAndBottom';
+type DrawingHorizontalReferenceFrame = 'character' | 'column' | 'insideMargin' | 'leftMargin' | 'margin' | 'outsideMargin' | 'page' | 'rightMargin';
+type DrawingVerticalReferenceFrame = 'bottomMargin' | 'insideMargin' | 'line' | 'margin' | 'outsideMargin' | 'page' | 'paragraph' | 'topMargin';
+/** `a:srcRect` — how much of each edge of the source image is cropped away, as fractions. */
+interface SourceCrop {
+    readonly left: number;
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+}
+interface DrawingTransform {
+    readonly rotationDegrees: number;
+    readonly flipHorizontal: boolean;
+    readonly flipVertical: boolean;
+    /** Source `a:off` in EMU; defaults to origin when absent. */
+    readonly offsetEmu: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    /** Source `a:ext` in EMU; zero falls back to `wp:extent` at geometry time. */
+    readonly extentEmu: Readonly<{
+        cx: number;
+        cy: number;
+    }>;
 }
-/** Bounded scan for an `<svg` document root (optional `<?xml` prolog only). */
-declare function hasBoundedSvgRoot(bytes: Uint8Array): boolean;
-/** Signature sniffing — authoritative over declared content type. */
-declare function sniffImageMime(bytes: Uint8Array): RenderableImageMime | PreservedImageMime | 'unknown';
-/** Structural PNG IHDR validation before decode. */
-declare function validatePngHeader(bytes: Uint8Array): ValidatedRasterHeader | null;
-/** Structural GIF logical screen descriptor validation before decode. */
-declare function validateGifHeader(bytes: Uint8Array): ValidatedRasterHeader | null;
-/** Bounded JPEG marker scan through the first supported SOF marker. */
-declare function validateJpegHeader(bytes: Uint8Array): ValidatedRasterHeader | null;
 /**
- * Intrinsic size of an SVG, resolved the way a browser sizes one: absolute `width`/`height`
- * first, then `viewBox` for the missing axis or ratio, then the CSS 300x150 default.
+ * What a drawing refuses: selection, movement, resizing, aspect change.
  *
- * This is metadata for insert and reset-to-natural-size only. Layout uses the authored
- * `wp:extent` and the browser rasterizes into that box, so nothing here sizes an allocation
- * and an out-of-range value is clamped rather than refused.
+ * Read and honoured rather than advisory — chrome that offered a handle the store will refuse
+ * would promise an edit that cannot happen.
  */
-declare function resolveSvgIntrinsicSize(bytes: Uint8Array, limits: ImageResourceLimits): ValidatedRasterHeader | null;
+interface DrawingLocks {
+    readonly select: boolean;
+    readonly move: boolean;
+    readonly resize: boolean;
+    readonly changeAspect: boolean;
+}
+interface DrawingLocksInput {
+    readonly select?: boolean;
+    readonly move?: boolean;
+    readonly resize?: boolean;
+    readonly changeAspect?: boolean;
+}
 /**
- * Validate a raster image's header structurally and report its real MIME type and extent.
+ * An anchored drawing's position: offsets, and the frames they are relative to.
  *
- * Content type is a CLAIM; this is what makes it a fact. A file declaring `image/png` over JPEG
- * bytes is caught here rather than at decode.
+ * The relative-to bases matter as much as the offsets. Writing an offset without preserving its
+ * base re-anchors the drawing against a different reference and moves it somewhere nobody asked.
  */
-declare function validateRasterHeader(bytes: Uint8Array, mime: SupportedImageMime): ValidatedRasterHeader | null;
-/** Package-wide live drawing references to a media part name. */
-declare function liveDrawingReferenceCount(pkg: OoxmlPackage, partName: string): number;
-/** How the image cache decodes, and what it will spend doing so. */
-interface CreateImageResourceCacheOptions {
-    readonly limits?: Partial<ImageResourceLimits>;
-    readonly decodePort: ImageDecodePort;
+interface DrawingPositionInput {
+    /**
+     * `'simple'` when `@simplePos="1"`: `horizontalEmu` / `verticalEmu` are authoritative
+     * `wp:simplePos` x/y. `'frame'` (default) uses positionH/V relative frames.
+     */
+    readonly mode?: 'frame' | 'simple';
+    readonly horizontalEmu?: number;
+    readonly verticalEmu?: number;
+    readonly relativeToH?: DrawingHorizontalReferenceFrame;
+    readonly relativeToV?: DrawingVerticalReferenceFrame;
+}
+interface DrawingProjection {
+    readonly drawingNodeId: string;
+    readonly ownerPartName: string;
+    readonly kind: DrawingKind;
+    readonly relationshipId: string | null;
+    readonly docPrId: number | null;
+    readonly name: string;
+    readonly title: string;
+    readonly description: string;
+    readonly hyperlinkHref: string | null;
+    readonly hidden: boolean;
+    readonly extentEmu: Readonly<{
+        cx: number;
+        cy: number;
+    }>;
+    readonly effectExtentEmu: Readonly<{
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    }>;
+    readonly inlineDistancesEmu: Readonly<{
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    }>;
+    readonly wrap: ImageWrapTarget;
+    readonly wrapGeometry: DrawingWrapProjection | null;
+    readonly position: DrawingPositionProjection | null;
+    readonly anchor: Readonly<{
+        simplePos: boolean;
+        relativeHeight: number;
+        behindDocument: boolean;
+        layoutInCell: boolean;
+        allowOverlap: boolean;
+    }> | null;
+    readonly picture: PictureProjection | null;
+    readonly vectorShape: VectorShapeProjection | null;
+    /** The picture member of a `wpg:wgp` group; `picture` stays null for a group. */
+    readonly groupPicture: GroupPictureProjection | null;
+    /**
+     * The group's other picture members, in document order. Each paints above `groupPicture`
+     * and the ones before it, and below `vectorShape`. Absent when the group has one picture.
+     */
+    readonly groupPictureLayers?: readonly GroupPictureProjection[];
+    readonly textboxStory: TextboxStoryProjection | null;
+    /** Text box members of a `wpg:wgp` group, laid out read-only; absent when none has text. */
+    readonly groupTextboxes?: readonly GroupTextboxProjection[];
+    /** The title and plot types of a chart: rendered, shown by its fallback, or a placeholder. */
+    readonly chartSummary?: DrawingChartSummary;
+    /**
+     * The picture saved in the `mc:Fallback` of a chart's `mc:AlternateContent`, whichever
+     * branch the page shows, for an output that exports a chart as its saved picture. Absent
+     * when the fallback is not a picture that paints.
+     */
+    readonly chartFallbackPicture?: PictureProjection;
+    /** Read-only preview of the supported native VML subset; the canonical XML is untouched. */
+    readonly legacyGraphic?: LegacyGraphicProjection;
+    /** Floating VML text art (a text watermark), fitted to the box by layout. */
+    readonly textArt?: LegacyTextArtProjection;
+    /** A horizontal rule; layout widens it to its line and gives it its `vectorShape`. */
+    readonly horizontalRule?: HorizontalRuleProjection;
+    readonly locks: DrawingLocks;
+    readonly effects: DrawingImageEffects;
+    readonly compatibilityBranchNodeId: string | null;
+    readonly diagnostics: readonly DrawingDiagnostic[];
+    /** Layout-only wrap area of an MC payload that cannot paint (`wrapFootprintProjection`). */
+    readonly footprintOnly?: true;
+}
+interface DrawingAccessibility {
+    /**
+     * The record takes part in layout only, for example the wrap area of a payload that cannot
+     * paint. Outputs must not paint, hit-test, select, link, or export it.
+     */
+    readonly hidden: boolean;
+    readonly decorative: boolean;
+    readonly label: string | null;
+}
+interface DrawingPositionProjection {
+    readonly simplePosition: Readonly<{
+        xEmu: number;
+        yEmu: number;
+    }>;
+    readonly horizontal: Readonly<{
+        relativeFrom: DrawingHorizontalReferenceFrame;
+        align: string | null;
+        offsetEmu: number | null;
+    }>;
+    readonly vertical: Readonly<{
+        relativeFrom: DrawingVerticalReferenceFrame;
+        align: string | null;
+        offsetEmu: number | null;
+    }>;
+}
+interface DrawingWrapProjection {
+    readonly element: DrawingWrapElement;
+    readonly textSide: 'bothSides' | 'left' | 'right' | 'largest';
+    readonly distancesEmu: Readonly<{
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    }>;
+    readonly polygon: readonly Readonly<{
+        x: number;
+        y: number;
+    }>[];
+}
+interface PictureProjection {
+    readonly embeddedRelationshipId: string | null;
+    readonly linkedRelationshipId: string | null;
+    readonly crop: SourceCrop;
+    readonly fillMode: 'stretch' | 'tile';
+    readonly transform: DrawingTransform;
+    readonly presetGeometry: string | null;
+    /** The clip ring of non-rectangular geometry, in the unit square of the extent. */
+    readonly clipUnit?: readonly Readonly<{
+        x: number;
+        y: number;
+    }>[];
+    /** Effects that change how the picture itself paints: a reflection, soft edges. */
+    readonly frameEffects?: PictureFrameEffects;
 }
 /**
- * Derived cache for one immutable package snapshot. Registry identity is
- * `(package snapshot, decodePort object, normalized limits)` — the first caller
- * never imposes its decoder or limits on later callers with different options.
+ * Project one `w:drawing` into the resolved shape layout and chrome read.
+ *
+ * Bounded throughout: extents, crops and nesting all come from a file. Returns a projection that
+ * reports `hidden` and its locks rather than throwing, so an unusable drawing degrades to
+ * something the surface can skip.
  */
-declare function imageResourceLookupFor(pkg: OoxmlPackage, options: CreateImageResourceCacheOptions): ImageResourceLookup;
-/** @deprecated Prefer {@link imageResourceLookupFor} — registry binds cache to package identity. */
-/** Build the per-document image cache. Validated bytes only; refusals are remembered too. */
-declare function createImageResourceCache(initialPkg: OoxmlPackage, options: CreateImageResourceCacheOptions): ImageResourceLookup;
+declare function projectDrawing(drawing: OoxmlDrawingNode, context: Readonly<{
+    ownerPartName: string;
+    supportedMcRequires: ReadonlySet<string>;
+    limits: DrawingProjectionLimits;
+    namespaceScope?: ReadonlyMap<string, string>;
+    resolveRelationship?: RelationshipTargetResolver;
+    resolveSchemeColor?: ShapeSchemeColorResolver;
+    resolveStyleMatrixReference?: ShapeStyleMatrixResolver;
+    resolveDiagramParts?: DiagramPartResolver;
+}>): DrawingProjection | null;
 
 /** Caps applied while loading a package: zip, XML, part count and relationship count. */
 interface OoxmlPackageLimits {
@@ -2001,6 +2443,18 @@ type AutomationTableMutation = {
     readonly kind: 'deleteRows' | 'deleteColumns';
     readonly index: number;
     readonly count: number;
+} | {
+    /** Merge the rectangle from one cell to another, by row and in-row cell index. */
+    readonly kind: 'mergeCells';
+    readonly topRow: number;
+    readonly firstCell: number;
+    readonly bottomRow: number;
+    readonly lastCell: number;
+} | {
+    readonly kind: 'splitCell';
+    readonly cellId: string;
+    readonly rowCount: number;
+    readonly columnCount: number;
 } | {
     readonly kind: 'delete';
 } | {
@@ -2031,6 +2485,70 @@ interface SetFieldCodeOp {
     readonly code: string;
 }
 
+/**
+ * Insert an allowlisted page-number complex field at a UTF-16 offset.
+ *
+ * `PAGE_X_OF_Y` is PAGE + literal " of " + NUMPAGES in one undoable op. Non-page
+ * instructions are refused — never authored through this path.
+ */
+interface InsertPageFieldOp {
+    readonly op: 'insertPageField';
+    readonly paragraphId: string;
+    readonly offset: number;
+    readonly field: 'PAGE' | 'NUMPAGES' | 'SECTIONPAGES' | 'PAGE_X_OF_Y';
+    /**
+     * Write this as a TRACKED insertion, on the same terms as `insertText`.
+     *
+     * The whole field — every `w:fldChar`, the instruction, the `PAGE_X_OF_Y` literal —
+     * goes into ONE `w:ins`, because the field is one proposal: rejecting it must take
+     * the complete atom back, never leave a `begin` standing without its `end`.
+     */
+    readonly revision?: RevisionAttributionInput;
+}
+/**
+ * Insert one complex field with an empty cached result at a UTF-16 offset.
+ *
+ * The instruction must be one that `inertFieldInstruction` admits: a page number, a reference
+ * to a bookmark, note, or style, a sequence number, or a date. It is written as text and never
+ * evaluated. Every other instruction refuses with `invalidArgs`.
+ */
+interface InsertComplexFieldOp {
+    readonly op: 'insertComplexField';
+    readonly paragraphId: string;
+    readonly offset: number;
+    readonly instruction: string;
+    /** Write the whole field as ONE tracked insertion, on the same terms as `insertText`. */
+    readonly revision?: RevisionAttributionInput;
+}
+
+/** Set one field's cached result text. See the module comment for the placements. */
+interface SetFieldResultOp {
+    readonly op: 'setFieldResult';
+    readonly paragraphId: string;
+    /** The begin `w:fldChar`, or the `w:fldSimple` element. */
+    readonly fieldNodeId: string;
+    /** Plain text. A tab becomes `w:tab`; other control characters refuse. */
+    readonly text: string;
+    /**
+     * The author whose pending insertion holds the field. The result joins that insertion. The
+     * op mints no revision of its own.
+     */
+    readonly revision?: RevisionAttributionInput;
+}
+
+/** Insert one inline `m:oMath` and the plain runs beside it. */
+interface InsertEquationOp {
+    readonly op: 'insertEquation';
+    readonly paragraphId: string;
+    readonly offset: number;
+    /** Plain runs and exactly one inline `m:oMath`, in order. Receive fresh ids at apply. */
+    readonly nodes: readonly OoxmlNode[];
+    /** Model length of `nodes`: their text, plus one for the equation. */
+    readonly length: number;
+    /** Write the nodes as ONE tracked insertion, on the same terms as `insertText`. */
+    readonly revision?: RevisionAttributionInput;
+}
+
 type InsertTextOp = {
     readonly op: 'insertText';
     readonly paragraphId: string;
@@ -2857,13 +3375,25 @@ interface RevisionBatchEntry {
 /** Why a requested decision remains pending. @public */
 type RevisionBatchSkipReason = 'unsupported-revision' | 'incomplete-group' | 'retained-structure' | 'unknown-revision';
 /**
- * Why an `unsupported-revision` skip happened: a refused site, a formatting change whose earlier
- * properties were not recorded so it cannot be rejected, a read-only review item, or a change
- * with no sites in the part.
+ * The structure behind a skip.
+ *
+ * For `unsupported-revision`: a refused site, a formatting change whose earlier properties were
+ * not recorded so it cannot be rejected, a read-only review item, a change with no sites, a
+ * change a content control lock keeps (`locked-content`), or a change in a data-bound content
+ * control (`bound-content`). The last two have their own codes, `review.locked-content` and
+ * `review.bound-content`; `reviewCodeOfSkip` reads them.
+ *
+ * For `incomplete-group`, the change the decision would also decide: the other half of a move or
+ * merge (`paired-change`), a change inside content the decision removes (`removed-content`) or
+ * inside properties a reject replaces (`replaced-properties`), a change the decision would empty
+ * (`emptied-change`), a change that encloses the selected one (`enclosing-change`), or another
+ * site of a group the planner keeps together (`grouped-change`).
+ *
+ * For `retained-structure`: a row kept for the table nested in it (`nested-table`).
  *
  * @public
  */
-type RevisionBatchSkipDetail = RevisionSiteRefusal | 'unrecorded-properties' | 'read-only' | 'no-sites';
+type RevisionBatchSkipDetail = RevisionSiteRefusal | 'unrecorded-properties' | 'read-only' | 'no-sites' | 'paired-change' | 'removed-content' | 'replaced-properties' | 'emptied-change' | 'enclosing-change' | 'grouped-change' | 'nested-table' | 'locked-content' | 'bound-content';
 /** Outcome of one selected-set decision. Counts refer to review decisions, not XML markers. @public */
 interface RevisionBatchResult {
     readonly resolved: readonly RevisionBatchEntry[];
@@ -2871,16 +3401,36 @@ interface RevisionBatchResult {
         readonly key: string;
         readonly reason: RevisionBatchSkipReason;
         readonly revision?: RevisionBatchEntry;
-        /** For `unsupported-revision`, which engine condition refused it. */
+        /**
+         * The condition or structure behind the skip, such as `locked-content` or `paired-change`.
+         * `reviewCodeOfSkip` turns the reason and the detail into one review code.
+         */
         readonly detail?: RevisionBatchSkipDetail;
     }[];
     /** All pending decisions in the addressed scope, including excluded and unsupported changes. */
     readonly remaining: number;
 }
-/** @internal Pure preflight; callers commit its operations through their normal write guards. */
-declare function planRevisionBatch(part: OoxmlPart, action: 'accept' | 'reject', keys?: readonly string[], scopeRoot?: OoxmlNode): {
+/**
+ * @internal Pure preflight; callers commit its operations through their normal write guards.
+ *
+ * `countRemaining: false` skips the exact count of the decisions left after the batch, and
+ * reports `remaining` as the decisions not resolved here. The exact count resolves the whole
+ * batch once more on a copy and lists what is left, which on a long reviewed document cost more
+ * than the plan itself, and a caller that reads only the operations or the skipped changes
+ * (a check, one decision, an editor that recounts its queue) paid it on every call.
+ */
+declare function planRevisionBatch(part: OoxmlPart, action: 'accept' | 'reject', keys?: readonly string[], scopeRoot?: OoxmlNode, options?: {
+    readonly countRemaining?: boolean;
+    /**
+     * A decision on these changes themselves, not a filtered selection: the other half of a
+     * selected move resolves with it, and changes inside content it removes go along.
+     */
+    readonly explicit?: boolean;
+}): {
     ops: readonly TreeDocOp[];
     result: RevisionBatchResult;
+    /** Keys of unselected changes the decision removes with their content. Explicit only. */
+    swept?: readonly string[];
 };
 
 /** Why a requested change keeps its attribution. @public */
@@ -3787,26 +4337,7 @@ type TreeDocOp = SetFieldCodeOp | {
     readonly offset: number;
     /** Write this as a TRACKED insertion, on the same terms as `insertText`. */
     readonly revision?: RevisionAttributionInput;
-} | {
-    /**
-     * Insert an allowlisted page-number complex field at a UTF-16 offset.
-     *
-     * `PAGE_X_OF_Y` is PAGE + literal " of " + NUMPAGES in one undoable op. Non-page
-     * instructions are refused — never authored through this path.
-     */
-    readonly op: 'insertPageField';
-    readonly paragraphId: string;
-    readonly offset: number;
-    readonly field: 'PAGE' | 'NUMPAGES' | 'SECTIONPAGES' | 'PAGE_X_OF_Y';
-    /**
-     * Write this as a TRACKED insertion, on the same terms as `insertText`.
-     *
-     * The whole field — every `w:fldChar`, the instruction, the `PAGE_X_OF_Y` literal —
-     * goes into ONE `w:ins`, because the field is one proposal: rejecting it must take
-     * the complete atom back, never leave a `begin` standing without its `end`.
-     */
-    readonly revision?: RevisionAttributionInput;
-} | {
+} | InsertPageFieldOp | InsertComplexFieldOp | SetFieldResultOp | InsertEquationOp | {
     /**
      * Move a numbered paragraph to another `w:numPr/w:ilvl`.
      *
@@ -4095,6 +4626,8 @@ type TreeDocOp = SetFieldCodeOp | {
         readonly xpath: string;
         readonly storeItemId: string;
     };
+    /** Propose the control as a tracked `w:ins`; rejecting removes it with its text. */
+    readonly revision?: RevisionAttributionInput;
 } | {
     /** Repeating-section item insert — unsupported at this layer (out of scope). */
     readonly op: 'addRepeatingSectionItem';
@@ -4169,6 +4702,18 @@ type TreeDocOp = SetFieldCodeOp | {
     readonly op: 'deleteTableColumn';
     readonly tableId: string;
     readonly gridColumnId: string;
+} | {
+    /** Merge cells covering one rectangle into its top-left cell, content in reading order. */
+    readonly op: 'mergeTableCells';
+    readonly tableId: string;
+    readonly cellIds: readonly string[];
+} | {
+    /** Split one cell into `rows` by `columns` equal cells; a one-row cell adds rows. */
+    readonly op: 'splitTableCell';
+    readonly tableId: string;
+    readonly cellId: string;
+    readonly rows: number;
+    readonly columns: number;
 } | {
     /**
      * Resize one internal divider between two adjacent canonical grid columns.
@@ -4648,8 +5193,18 @@ type TreeOpRejection = 'unknown-op' | 'unknown-paragraph' | 'not-a-paragraph' |
  * mapping cannot be trusted and the inserted row would not match it.
  */
  | 'row-hides-cell'
-/** Column edit refused because the table carries horizontal or vertical merges. */
+/** The table carries a legacy `w:hMerge`, which grid edits cannot place. */
  | 'table-has-merge'
+/** The cells to merge do not cover one rectangle, or cover only one cell. */
+ | 'cells-not-rectangle'
+/** A cell merged over several rows splits only into a divisor of them. */
+ | 'split-rows-not-divisor'
+/** The cells hold a tracked cell insertion, deletion, or merge. */
+ | 'cell-has-revision'
+/** The split cells would be narrower than the minimum column width. */
+ | 'cell-too-narrow'
+/** Without `w:tblGrid`, a cell splits only into a divisor of the columns it spans. */
+ | 'split-needs-grid'
 /** The addressed grid column id is missing or ambiguous without `w:tblGrid`. */
  | 'unknown-grid-column'
 /** The operation would exceed bounded table topology limits. */
@@ -4660,6 +5215,8 @@ type TreeOpRejection = 'unknown-op' | 'unknown-paragraph' | 'not-a-paragraph' |
  | 'unknown-drawing'
 /** The drawing's graphic payload is not a supported picture. */
  | 'not-a-picture-drawing'
+/** A chart in any state: only a delete applies, and it removes the whole chart. */
+ | 'chart-drawing'
 /** A lock flag or `@locked` forbids this mutation. */
  | 'drawing-locked'
 /** Finite EMU extent, crop, or position value is out of range. */
@@ -4687,5 +5244,5 @@ type TreeOpResult = {
     readonly detail?: string;
 };
 
-export { validateRasterHeader as a$, DEFAULT_IMAGE_RESOURCE_LIMITS as aV, IMAGE_WRAP_TARGETS as aW, TEXT_FORM_FORMATS as aX, resolveImageResourceLimits as aY, resolveSvgIntrinsicSize as aZ, sniffImageMime as a_, DEFAULT_LIMITS as bF, DEFAULT_OOXML_PACKAGE_LIMITS as bG, DEFAULT_ZIP_LIMITS as bH, HARD_CEILINGS as bL, HYPERLINK_RELATIONSHIP_TYPE as bM, IMAGE_RELATIONSHIP_TYPE as bP, IMAGE_RESOURCE_HARD_CEILINGS as bQ, MAX_CONTENT_CONTROLS_PER_PART as bY, MAX_CONTENT_CONTROL_NESTING as bZ, MAX_SVG_SNIFF_BYTES as b_, ACCEPTED_PARAGRAPH_PROPERTIES as bj, ACCEPTED_RUN_PROPERTIES as bk, CONTENT_CONTROL_ID_MAX as bm, CONTENT_CONTROL_PROPERTY_ORDER as bn, OFFICE_RELATIONSHIP_NAMESPACE_URI as c1, OOXML_NODE_IDENTITY_RULES as c2, TABLE_BORDER_STYLES as cO, W15_NAMESPACE_URI as cV, WML_NAMESPACE_URI as cW, XMLNS_NAMESPACE_URI as cX, XML_NAMESPACE_URI as cY, reviewItemKey as d$, allocateContentControlId as d4, asciiFold as d5, buildContentTypeIndex as d6, buildRelationshipSet as d7, childElements as d8, commentAnchorsOfStory as d9, isContentControlWrapper as dA, isContentRevisionKind as dB, isHyperlinkNode as dC, isRangeMarkerKind as dD, isValidMime as dE, legacyCheckboxFieldsOf as dF, liveDrawingReferenceCount as dG, lockForbidsEdit as dH, lockForbidsRemoval as dI, normalizePartName as dJ, orderedContentControlProperties as dK, parseContentControlId as dL, partNameKey as dM, planRevisionAuthorChange as dN, planRevisionBatch as dO, projectDrawing as dP, readOnOffChild as dQ, readOoxmlPackage as dR, readOoxmlPart as dS, readXml as dT, readZip as dU, resolveContentControlLock as dV, resolveContentType as dW, resolveImageRelationship as dX, resolveInternalTarget as dY, resolveLimits as dZ, resolveRelationship as d_, commentsOfPart as da, contentControlContentChildren as db, contentControlContentNodeOf as dc, contentControlEndPropertiesNodeOf as dd, contentControlLevelOf as de, contentControlPropertiesNodeOf as df, contentControlPropertiesOf as dg, contentControlTextOf as dh, contentControlsIn as di, createImageResourceCache as dj, detectDuplicateNames as dk, enclosedBookmarkDeletions as dl, extensionKey as dm, findContentControl as dn, findElement as dp, firstReviewRange as dq, flattenContentControls as dr, hasAnyComment as ds, hasBoundedSvgRoot as dt, hyperlinkAnchorOf as du, hyperlinkRelationshipIdOf as dv, hyperlinkTargetOf as dw, imageResourceLookupFor as dx, isContentControlContentNode as dy, isContentControlNode as dz, reviewItemRanges as e0, textContent as e1, textFormFieldsOf as e2, threadStateOfPart as e3, validateExternalTarget as e4, validateGifHeader as e5, validateJpegHeader as e6, validatePngHeader as e7, withPart as e8, withoutBookmarkInPart as e9, writeOoxmlPackage as ea, writeZip as eb, activeReviewItem as ed, reviewItemPositionRank as ee, reviewItemsAt as ef, reviewThreadRootOf as eg };
-export type { DrawingVerticalReferenceFrame as $, ParagraphTabStop as A, Block as B, CommentRecord as C, DocxDocument as D, ExecResult as E, RevisionType as F, Section as G, HeaderFooterSet as H, InsertableContentControlType as I, SectionProperties as J, StyleDefinition as K, Theme as L, ThemeColorScheme as M, OoxmlNode as N, OoxmlPart as O, Paragraph as P, OoxmlPackage as Q, ReviewModelInput as R, StyleDefinitions as S, Table as T, OoxmlNodeId as U, OoxmlGenericElementNode as V, DocxDocumentJSON as W, DrawingHorizontalReferenceFrame as X, DrawingKind as Y, DrawingLocks as Z, DrawingPositionInput as _, ReviewItem as a, FontDefinition as a0, ImageResourceState as a1, ImageWrapTarget as a2, NumberingRef as a3, PageMargins as a4, ParagraphDisagreements as a5, ParagraphFormatCommand as a6, Point as a7, PreservedImageMime as a8, Rect as a9, RevisionBatchSkipReason as aA, RevisionSiteRefusal as aB, TreeOpRejection as aC, ImageResourceLimits as aD, ImageDecodePort as aE, AutomationTableMutation as aF, RevisionAttributionInput as aG, PackageWatermarkWrite as aH, OoxmlInvariantIssue as aI, DrawingTreeDocOp as aJ, ImpactClass as aK, OoxmlParagraphNode as aL, OoxmlNoteNode as aM, OoxmlContinuationSeparatorNode as aN, OoxmlEndnotesNode as aO, OoxmlFootnotesNode as aP, OoxmlNoteRefNode as aQ, OoxmlNoteReferenceNode as aR, OoxmlSeparatorNode as aS, SourceCrop as aT, TreeDocColorValue as aU, RenderableImageMime as aa, RevisionAuthorResult as ab, RevisionBatchResult as ac, Run as ad, SelectionPin as ae, SupportedImageMime as af, TableCell as ag, TableRow as ah, Unsubscribe as ai, ValidatedImageBytesHandle as aj, VectorImageMime as ak, Watermark as al, WatermarkLayout as am, WatermarkState as an, TreeDocOp as ao, OoxmlElement as ap, OoxmlContentControlNode as aq, OoxmlContentControlContentNode as ar, OoxmlPackageRejection as as, OoxmlProperty as at, OoxmlPackageResult as au, OoxmlPackageLimits as av, RevisionAuthorEntry as aw, RevisionAuthorSkipReason as ax, RevisionBatchEntry as ay, RevisionBatchSkipDetail as az, ReviewRevisionItem as b, NameRejection as b$, TextFormFieldRange as b0, TextFormFieldOptions as b1, DrawingTransform as b2, TableBorderStyle as b3, DrawingAccessibility as b4, DrawingImageEffects as b5, VectorShapeProjection as b6, DrawingProjection as b7, OoxmlDrawingNode as b8, OoxmlInvariantResult as b9, ContentControlProperties as bA, ContentTypeError as bB, ContentTypeIndex as bC, ContentTypeRecords as bD, CreateImageResourceCacheOptions as bE, DefaultRecord as bI, DeleteBookmarkOp as bJ, DeleteTextOp as bK, HyperlinkKind as bN, HyperlinkTarget as bO, ImageRelationshipResolution as bR, ImageResourceLookup as bS, IndexResult as bT, InsertBookmarkOp as bU, InsertBuildingBlockOp as bV, InsertTextOp as bW, LegacyCheckboxFieldRange as bX, OoxmlFldCharNode as ba, OoxmlFldSimpleNode as bb, OoxmlInstrTextNode as bc, TreeOpResult as bd, RelationshipRecord as be, OoxmlHardBreakNode as bf, OoxmlAttribute as bg, ResourceLimits as bh, CommentThreadState as bi, BookmarkOpPosition as bl, CommentAnchor as bo, CommentPosition as bp, CommitTextFormFieldOp as bq, ContentControlCheckbox as br, ContentControlCheckboxState as bs, ContentControlDataBinding as bt, ContentControlDateFormat as bu, ContentControlEntry as bv, ContentControlKind as bw, ContentControlLevel as bx, ContentControlListItem as by, ContentControlLock as bz, ReviewCommentItem as c, XmlRejection as c$, NameResult as c0, OoxmlBodyNode as c3, OoxmlBookmarkEndNode as c4, OoxmlBookmarkStartNode as c5, OoxmlContentControlCalendarNode as c6, OoxmlContentControlCheckboxNode as c7, OoxmlContentControlCheckedNode as c8, OoxmlContentControlCheckedStateNode as c9, OoxmlTabNode as cA, OoxmlTextElementNode as cB, OoxmlTextNode as cC, OoxmlWmlValAttribute as cD, OoxmlXmlSpaceAttribute as cE, OverrideRecord as cF, RelationshipError as cG, RelationshipSetResult as cH, RelationshipTargetResolver as cI, ResolveResult as cJ, ResolvedRelationship as cK, SetLegacyCheckboxOp as cL, SetLegacyDropdownOp as cM, SetTextFormFieldDefaultOp as cN, TabStopWrite as cP, TargetMode as cQ, TextFormFieldType as cR, TreeDocOpKind as cS, TreeOpEffect as cT, ValidatedRasterHeader as cU, XmlLimits as cZ, XmlNode as c_, OoxmlContentControlComboBoxNode as ca, OoxmlContentControlDataBindingNode as cb, OoxmlContentControlDateFormatNode as cc, OoxmlContentControlDateNode as cd, OoxmlContentControlDropDownListNode as ce, OoxmlContentControlEndPropertiesNode as cf, OoxmlContentControlLidNode as cg, OoxmlContentControlListItemNode as ch, OoxmlContentControlPropertiesNode as ci, OoxmlContentControlStoreMappedDataAsNode as cj, OoxmlContentControlTextNode as ck, OoxmlContentControlUncheckedStateNode as cl, OoxmlDocumentNode as cm, OoxmlExternalTarget as cn, OoxmlGenericExtensionAttribute as co, OoxmlHyperlinkNode as cp, OoxmlInvariantIssueCode as cq, OoxmlKnownNodeAttribute as cr, OoxmlNamespaceBinding as cs, OoxmlNodeIdentityRules as ct, OoxmlParagraphPropertiesNode as cu, OoxmlPartMetadata as cv, OoxmlReadRejection as cw, OoxmlReadResult as cx, OoxmlRunNode as cy, OoxmlRunPropertiesNode as cz, ReviewCustomItem as d, XmlResult as d0, ZipLimits as d1, ZipReadResult as d2, ZipRejection as d3, ReviewPosition as e, VectorShapeComponent as ec, ReviewRange as f, ReviewRevisionKind as g, RevisionAddress as h, ContentControlType as i, DocTarget as j, RunFormatting as k, Extent as l, ContainerRef as m, ContentControlFilter as n, DocRange as o, Revision as p, DocComment as q, ColorValue as r, ContentControl as s, DocAnchor as t, DocAnchorRange as u, DocLocation as v, DocumentBody as w, ExecErrorCode as x, IndentFormatting as y, ParagraphFlags as z };
+export { DEFAULT_ZIP_LIMITS as b$, DEFAULT_IMAGE_RESOURCE_LIMITS as b6, IMAGE_WRAP_TARGETS as b7, TEXT_FORM_FORMATS as b8, resolveImageResourceLimits as b9, CHART_GRAPHIC_DATA_URI as bA, CHART_NAMESPACE_URI as bB, CHART_STYLE_NAMESPACE_URI as bC, CONTENT_CONTROL_ID_MAX as bD, CONTENT_CONTROL_PROPERTY_ORDER as bE, DEFAULT_LIMITS as bZ, DEFAULT_OOXML_PACKAGE_LIMITS as b_, resolveSvgIntrinsicSize as ba, sniffImageMime as bb, validateRasterHeader as bc, ACCEPTED_PARAGRAPH_PROPERTIES as bv, ACCEPTED_RUN_PROPERTIES as bw, CHARTEX_GRAPHIC_DATA_URI as by, CHARTEX_NAMESPACE_URI as bz, DIAGRAM_NAMESPACE_URI as c0, DRAWINGML_MAIN_NAMESPACE_URI as c1, HARD_CEILINGS as c7, HYPERLINK_RELATIONSHIP_TYPE as c8, IMAGE_RELATIONSHIP_TYPE as cb, IMAGE_RESOURCE_HARD_CEILINGS as cc, MAX_CONTENT_CONTROLS_PER_PART as cn, MAX_CONTENT_CONTROL_NESTING as co, MAX_SVG_SNIFF_BYTES as cp, OFFICE_RELATIONSHIP_NAMESPACE_URI as cs, OOXML_NODE_IDENTITY_RULES as ct, hasBoundedSvgRoot as d$, allocateContentControlId as dC, asciiFold as dD, buildContentTypeIndex as dE, buildRelationshipSet as dF, childElements as dG, commentAnchorsOfStory as dH, commentsOfPart as dI, contentControlContentChildren as dJ, contentControlContentNodeOf as dK, contentControlEndPropertiesNodeOf as dL, contentControlLevelOf as dM, contentControlPropertiesNodeOf as dN, contentControlPropertiesOf as dO, contentControlTextOf as dP, contentControlsIn as dQ, createImageResourceCache as dR, detectDuplicateNames as dS, directFill as dT, enclosedBookmarkDeletions as dU, extensionKey as dV, findContentControl as dW, findElement as dX, firstReviewRange as dY, flattenContentControls as dZ, hasAnyComment as d_, TABLE_BORDER_STYLES as dg, W15_NAMESPACE_URI as dr, WML_NAMESPACE_URI as ds, XMLNS_NAMESPACE_URI as dt, XML_NAMESPACE_URI as du, hyperlinkAnchorOf as e0, hyperlinkRelationshipIdOf as e1, hyperlinkTargetOf as e2, imageResourceLookupFor as e3, isContentControlContentNode as e4, isContentControlNode as e5, isContentControlWrapper as e6, isContentRevisionKind as e7, isElement as e8, isHyperlinkNode as e9, reviewItemRanges as eA, textContent as eB, textFormFieldsOf as eC, threadStateOfPart as eD, validateExternalTarget as eE, validateGifHeader as eF, validateJpegHeader as eG, validatePngHeader as eH, withPart as eI, withoutBookmarkInPart as eJ, writeOoxmlPackage as eK, writeZip as eL, activeReviewItem as eQ, reviewItemPositionRank as eR, reviewItemsAt as eS, reviewThreadRootOf as eT, isRangeMarkerKind as ea, isValidMime as eb, legacyCheckboxFieldsOf as ec, liveDrawingReferenceCount as ed, lockForbidsEdit as ee, lockForbidsRemoval as ef, normalizePartName as eg, orderedContentControlProperties as eh, parseContentControlId as ei, partNameKey as ej, planRevisionAuthorChange as ek, planRevisionBatch as el, projectDrawing as em, readOnOffChild as en, readOoxmlPackage as eo, readOoxmlPart as ep, readXml as eq, readZip as er, resolveColorNode as es, resolveContentControlLock as et, resolveContentType as eu, resolveImageRelationship as ev, resolveInternalTarget as ew, resolveLimits as ex, resolveRelationship as ey, reviewItemKey as ez };
+export type { Table as $, ParagraphDisagreements as A, Block as B, CommentRecord as C, DocxDocument as D, ExecResult as E, ParagraphFlags as F, ParagraphTabStop as G, HeaderFooterSet as H, InsertableContentControlType as I, RevisionAuthorEntry as J, RevisionAuthorResult as K, RevisionAuthorSkipReason as L, RevisionBatchEntry as M, NumberingRef as N, OoxmlPart as O, PageMargins as P, RevisionBatchResult as Q, ReviewModelInput as R, StyleDefinitions as S, RevisionBatchSkipDetail as T, RevisionBatchSkipReason as U, RevisionSiteRefusal as V, RevisionType as W, Run as X, Section as Y, SectionProperties as Z, StyleDefinition as _, ReviewItem as a, DrawingImageEffects as a$, TableCell as a0, TableRow as a1, Theme as a2, ThemeColorScheme as a3, OoxmlNode as a4, OoxmlPackage as a5, DocxDocumentJSON as a6, DrawingHorizontalReferenceFrame as a7, DrawingKind as a8, DrawingLocks as a9, OoxmlPackageRejection as aA, AutomationTableMutation as aB, OoxmlProperty as aC, OoxmlPackageResult as aD, RevisionAttributionInput as aE, TreeOpRejection as aF, OoxmlNodeId as aG, PackageWatermarkWrite as aH, OoxmlInvariantIssue as aI, DrawingTreeDocOp as aJ, ImpactClass as aK, OoxmlParagraphNode as aL, OoxmlNoteNode as aM, OoxmlContinuationSeparatorNode as aN, OoxmlEndnotesNode as aO, OoxmlFootnotesNode as aP, OoxmlNoteRefNode as aQ, OoxmlNoteReferenceNode as aR, OoxmlSeparatorNode as aS, SourceCrop as aT, TextFormFieldRange as aU, TextFormFieldOptions as aV, DrawingTransform as aW, TableBorderStyle as aX, TextboxOutlineProjection as aY, VectorShapeComponent as aZ, DrawingAccessibility as a_, DrawingPositionInput as aa, DrawingVerticalReferenceFrame as ab, FontDefinition as ac, ImageDecodePort as ad, ImageResourceLimits as ae, ImageResourceState as af, ImageWrapTarget as ag, ParagraphFormatCommand as ah, Point as ai, PreservedImageMime as aj, Rect as ak, RenderableImageMime as al, SelectionPin as am, SupportedImageMime as an, Unsubscribe as ao, ValidatedImageBytesHandle as ap, VectorImageMime as aq, Watermark as ar, WatermarkLayout as as, WatermarkState as at, TreeDocOp as au, OoxmlElement as av, OoxmlContentControlNode as aw, OoxmlGenericElementNode as ax, OoxmlContentControlContentNode as ay, OoxmlPackageLimits as az, ReviewRevisionItem as b, DrawingChartSummary as b0, VectorShapeProjection as b1, PictureFrameEffects as b2, DrawingProjection as b3, OoxmlDrawingNode as b4, TreeDocColorValue as b5, ChartPart as bF, ChartThemeFaces as bG, ChartexPart as bH, CommentAnchor as bI, CommentPosition as bJ, CommitTextFormFieldOp as bK, ContentControlCheckbox as bL, ContentControlCheckboxState as bM, ContentControlDataBinding as bN, ContentControlDateFormat as bO, ContentControlEntry as bP, ContentControlKind as bQ, ContentControlLevel as bR, ContentControlListItem as bS, ContentControlLock as bT, ContentControlProperties as bU, ContentTypeError as bV, ContentTypeIndex as bW, ContentTypeRecords as bX, CreateImageResourceCacheOptions as bY, OoxmlAttribute as bd, OoxmlInvariantResult as be, LegacyTextArtProjection as bf, ChartPartResolver as bg, ChartexPartResolver as bh, ShapeSchemeColorResolver as bi, ShapeEffectList as bj, GroupTextboxProjection as bk, MetafileImageMime as bl, OoxmlFldCharNode as bm, OoxmlFldSimpleNode as bn, OoxmlInstrTextNode as bo, TreeOpResult as bp, RelationshipRecord as bq, OoxmlHardBreakNode as br, ShapeColor as bs, ResourceLimits as bt, CommentThreadState as bu, BookmarkOpPosition as bx, ReviewCommentItem as c, OoxmlTabNode as c$, DefaultRecord as c2, DeleteBookmarkOp as c3, DeleteTextOp as c4, DiagramPartResolver as c5, DiagramParts as c6, HyperlinkKind as c9, OoxmlContentControlCheckedStateNode as cA, OoxmlContentControlComboBoxNode as cB, OoxmlContentControlDataBindingNode as cC, OoxmlContentControlDateFormatNode as cD, OoxmlContentControlDateNode as cE, OoxmlContentControlDropDownListNode as cF, OoxmlContentControlEndPropertiesNode as cG, OoxmlContentControlLidNode as cH, OoxmlContentControlListItemNode as cI, OoxmlContentControlPropertiesNode as cJ, OoxmlContentControlStoreMappedDataAsNode as cK, OoxmlContentControlTextNode as cL, OoxmlContentControlUncheckedStateNode as cM, OoxmlDocumentNode as cN, OoxmlExternalTarget as cO, OoxmlGenericExtensionAttribute as cP, OoxmlHyperlinkNode as cQ, OoxmlInvariantIssueCode as cR, OoxmlKnownNodeAttribute as cS, OoxmlNamespaceBinding as cT, OoxmlNodeIdentityRules as cU, OoxmlParagraphPropertiesNode as cV, OoxmlPartMetadata as cW, OoxmlReadRejection as cX, OoxmlReadResult as cY, OoxmlRunNode as cZ, OoxmlRunPropertiesNode as c_, HyperlinkTarget as ca, ImageRelationshipResolution as cd, ImageResourceLookup as ce, IndexResult as cf, InsertBookmarkOp as cg, InsertBuildingBlockOp as ch, InsertComplexFieldOp as ci, InsertEquationOp as cj, InsertPageFieldOp as ck, InsertTextOp as cl, LegacyCheckboxFieldRange as cm, NameRejection as cq, NameResult as cr, OoxmlBodyNode as cu, OoxmlBookmarkEndNode as cv, OoxmlBookmarkStartNode as cw, OoxmlContentControlCalendarNode as cx, OoxmlContentControlCheckboxNode as cy, OoxmlContentControlCheckedNode as cz, ReviewCustomItem as d, OoxmlTextElementNode as d0, OoxmlTextNode as d1, OoxmlWmlValAttribute as d2, OoxmlXmlSpaceAttribute as d3, OverrideRecord as d4, RelationshipError as d5, RelationshipSetResult as d6, RelationshipTargetResolver as d7, ResolveResult as d8, ResolvedRelationship as d9, ZipReadResult as dA, ZipRejection as dB, SetFieldResultOp as da, SetLegacyCheckboxOp as db, SetLegacyDropdownOp as dc, SetTextFormFieldDefaultOp as dd, ShapeReflection as de, ShapeShadow as df, TabStopWrite as dh, TargetMode as di, TextFormFieldType as dj, TextboxStoryProjection as dk, TreeDocOpKind as dl, TreeOpEffect as dm, ValidatedRasterHeader as dn, VectorGradient as dp, VectorPattern as dq, XmlLimits as dv, XmlNode as dw, XmlRejection as dx, XmlResult as dy, ZipLimits as dz, ReviewPosition as e, AffineMatrix as eM, DrawingChartPlotType as eN, DrawingChartShownAs as eO, GradientStop as eP, ReviewRange as f, ReviewRevisionKind as g, RevisionAddress as h, ContentControlType as i, DocTarget as j, RunFormatting as k, Extent as l, ContainerRef as m, ContentControlFilter as n, DocRange as o, Revision as p, DocComment as q, ColorValue as r, ContentControl as s, DocAnchor as t, DocAnchorRange as u, DocLocation as v, DocumentBody as w, ExecErrorCode as x, IndentFormatting as y, Paragraph as z };