superdoc 2.4.0-next.50 → 2.4.0-next.52

package/dist/chunks/{create-super-doc-ui-C6qsVKMY.es.js → create-super-doc-ui-B_1l545i.es.js}

@@ -13,6 +13,8 @@ var DOM_CLASS_NAMES = {
 	PAGE: "superdoc-page",
 	/** Fragment container (paragraph, table, image block, etc.). */
 	FRAGMENT: "superdoc-fragment",
+	/** Non-flowing fragment whose visual position must not define body flow geometry. */
+	FLOATING_FRAGMENT: "superdoc-floating-fragment",
 	/** Line container within a fragment. */
 	LINE: "superdoc-line",
 	/**

package/dist/chunks/{create-super-doc-ui-C7loo2YE.cjs → create-super-doc-ui-DNtHxzz_.cjs}

@@ -13,6 +13,8 @@ var DOM_CLASS_NAMES = {
 	PAGE: "superdoc-page",
 	/** Fragment container (paragraph, table, image block, etc.). */
 	FRAGMENT: "superdoc-fragment",
+	/** Non-flowing fragment whose visual position must not define body flow geometry. */
+	FLOATING_FRAGMENT: "superdoc-floating-fragment",
 	/** Line container within a fragment. */
 	LINE: "superdoc-line",
 	/**

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.4.0-next.50",
+	superdocVersion: "2.4.0-next.52",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.4.0-next.50",
+	superdocVersion: "2.4.0-next.52",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/layout-engine/contracts/src/graphic-placement.d.ts

@@ -1,7 +1,19 @@
-type AnchorVRelative = 'paragraph' | 'page' | 'margin';
-type AnchorHRelative = 'column' | 'page' | 'margin';
-type AnchorAlignH = 'left' | 'center' | 'right';
-type AnchorAlignV = 'top' | 'center' | 'bottom';
+/** ECMA-376 Part 1 §20.4.3.4 (`ST_RelFromH`). */
+export declare const ANCHOR_H_RELATIVE_VALUES: readonly ["margin", "page", "column", "character", "leftMargin", "rightMargin", "insideMargin", "outsideMargin"];
+/** ECMA-376 Part 1 §20.4.3.5 (`ST_RelFromV`). */
+export declare const ANCHOR_V_RELATIVE_VALUES: readonly ["margin", "page", "paragraph", "line", "topMargin", "bottomMargin", "insideMargin", "outsideMargin"];
+/** ECMA-376 Part 1 §20.4.3.1 (`ST_AlignH`). */
+export declare const ANCHOR_H_ALIGN_VALUES: readonly ["left", "right", "center", "inside", "outside"];
+/** ECMA-376 Part 1 §20.4.3.2 (`ST_AlignV`). */
+export declare const ANCHOR_V_ALIGN_VALUES: readonly ["top", "bottom", "center", "inside", "outside"];
+export type AnchorHRelative = (typeof ANCHOR_H_RELATIVE_VALUES)[number];
+export type AnchorVRelative = (typeof ANCHOR_V_RELATIVE_VALUES)[number];
+export type AnchorAlignH = (typeof ANCHOR_H_ALIGN_VALUES)[number];
+export type AnchorAlignV = (typeof ANCHOR_V_ALIGN_VALUES)[number];
+export declare function isAnchorHRelative(value: unknown): value is AnchorHRelative;
+export declare function isAnchorVRelative(value: unknown): value is AnchorVRelative;
+export declare function isAnchorAlignH(value: unknown): value is AnchorAlignH;
+export declare function isAnchorAlignV(value: unknown): value is AnchorAlignV;
 export declare function isPositionedParagraphFrame<T extends {
     wrap?: string;
 }>(frame: T | undefined): frame is T & {
@@ -35,6 +47,10 @@ export type ColumnLayoutForAnchor = {
  */
 export type ResolveAnchoredGraphicYInput = {
     anchor?: {
+        simplePos?: {
+            x: number;
+            y: number;
+        };
         vRelativeFrom?: AnchorVRelative;
         alignV?: AnchorAlignV;
         offsetV?: number;
@@ -49,8 +65,12 @@ export type ResolveAnchoredGraphicYInput = {
      * Used for `paragraph` and legacy (undefined vRelativeFrom) positioning.
      */
     anchorParagraphY?: number;
+    /** Anchor line top Y. Falls back to the paragraph top when unavailable. */
+    anchorLineY?: number;
     /** First line height of the anchor paragraph (paragraph-relative alignV). */
     firstLineHeight?: number;
+    /** One-based physical page number, used by inside/outside placement. */
+    pageNumber?: number;
     /**
      * When true, anchor has no host paragraph (pre-registered / paragraphless layout).
      * For `vRelativeFrom: 'paragraph'`, use `contentTop + offsetV` instead of alignV on a
@@ -62,15 +82,24 @@ export type ResolveAnchoredGraphicYInput = {
  * Resolve the vertical paint position for an anchored graphic (image, drawing, or table).
  */
 export declare function resolveAnchoredGraphicY(input: ResolveAnchoredGraphicYInput): number;
+export type ResolveAnchoredGraphicXContext = {
+    /** One-based physical page number, used by inside/outside placement. */
+    pageNumber?: number;
+    /** Page-space X of the anchor character. Falls back to the column origin. */
+    anchorCharacterX?: number;
+};
 /**
  * Resolve horizontal paint position for an anchored graphic.
  */
 export declare function resolveAnchoredGraphicX(anchor: {
+    simplePos?: {
+        x: number;
+        y: number;
+    };
     hRelativeFrom?: AnchorHRelative;
     alignH?: AnchorAlignH;
     offsetH?: number;
 }, columnIndex: number, columns: ColumnLayoutForAnchor, objectWidth: number, margins?: {
     left?: number;
     right?: number;
-}, pageWidth?: number): number;
-export {};
+}, pageWidth?: number, context?: ResolveAnchoredGraphicXContext): number;

package/dist/layout-engine/contracts/src/index.d.ts

@@ -1,6 +1,7 @@
 import { TabStop } from './engines/tabs.js';
 import { PageNumberChapterSeparator, PageNumberFieldFormat, PageNumberFormat } from './page-number-formatting.js';
 import { TrackedChangeSemanticColorKey } from './semantic-colors.js';
+import { AnchorAlignH, AnchorAlignV, AnchorHRelative, AnchorVRelative } from './graphic-placement.js';
 import { ParagraphDirectionContext, RunBidiContext, RunScriptContext, TableDirectionContext } from './direction-context.js';
 import { LayoutSourceIdentity } from './layout-identity.js';
 export { computeTabStops, layoutWithTabs, calculateTabWidth } from './engines/tabs.js';
@@ -17,7 +18,7 @@ export { shouldApplyJustify, calculateJustifySpacing, getFirstLineIndentOffset,
 export { parseInsetClipPathForScale, formatInsetClipPathTransform, type InsetClipPathScale, } from './clip-path-inset.js';
 export { SUBSCRIPT_SUPERSCRIPT_SCALE, normalizeBaselineShift, hasExplicitBaselineShift, isSuperscriptOrSubscript, usesDefaultScriptLayout, scaleFontSizeForVerticalText, resolveBaseFontSizeForVerticalText, type VerticalTextAlign, } from './vertical-text.js';
 export { computeFragmentPmRange, computeLinePmRange, type LinePmRange } from './pm-range.js';
-export { resolveAnchoredGraphicY, resolveAnchoredGraphicX, resolveFooterPageFrameOriginY, isPositionedParagraphFrame, isPagePositionedParagraphFrame, type ColumnLayoutForAnchor, type ResolveAnchoredGraphicYInput, } from './graphic-placement.js';
+export { resolveAnchoredGraphicY, resolveAnchoredGraphicX, resolveFooterPageFrameOriginY, isPositionedParagraphFrame, isPagePositionedParagraphFrame, isAnchorHRelative, isAnchorVRelative, isAnchorAlignH, isAnchorAlignV, ANCHOR_H_RELATIVE_VALUES, ANCHOR_V_RELATIVE_VALUES, ANCHOR_H_ALIGN_VALUES, ANCHOR_V_ALIGN_VALUES, type ColumnLayoutForAnchor, type ResolveAnchoredGraphicYInput, type ResolveAnchoredGraphicXContext, type AnchorHRelative, type AnchorVRelative, type AnchorAlignH, type AnchorAlignV, } from './graphic-placement.js';
 export { LAYOUT_BOUNDARY_SCHEMA, bodyStoryLocator, namedStoryLocator, computeLayoutFragmentId, buildLayoutSourceIdentity, buildLayoutSourceIdentityForFragment, } from './layout-identity.js';
 export type { LayoutBlockRef, LayoutFragmentId, LayoutPartialRowIdentity, LayoutSourceIdentity, LayoutStoryKind, LayoutStoryLocator, } from './layout-identity.js';
 export { LAYOUT_SEGMENT_GEOMETRY_SCHEMA } from './segment-geometry.js';
@@ -1350,12 +1351,21 @@ export type ColumnBreakBlock = {
 /** Positioning for anchored images (offsets in CSS px). */
 export type ImageAnchor = {
     isAnchored?: boolean;
+    /**
+     * Page-space coordinates from `wp:simplePos` in CSS px.
+     * ECMA-376 Part 1 §20.4.2.13: when present because `wp:anchor/@simplePos`
+     * is true, these coordinates override positionH/positionV.
+     */
+    simplePos?: {
+        x: number;
+        y: number;
+    };
     /** Keep the anchored object inside its table cell and resize the cell as needed. */
     layoutInCell?: boolean;
-    hRelativeFrom?: 'column' | 'page' | 'margin';
-    vRelativeFrom?: 'paragraph' | 'page' | 'margin';
-    alignH?: 'left' | 'center' | 'right';
-    alignV?: 'top' | 'center' | 'bottom';
+    hRelativeFrom?: AnchorHRelative;
+    vRelativeFrom?: AnchorVRelative;
+    alignH?: AnchorAlignH;
+    alignV?: AnchorAlignV;
     offsetH?: number;
     offsetV?: number;
     behindDoc?: boolean;
@@ -1371,6 +1381,7 @@ export type ImageAnchor = {
  */
 export declare function isPageRelativeAnchor(input: {
     anchor?: {
+        simplePos?: unknown;
         vRelativeFrom?: unknown;
     } | null;
 } | null | undefined): boolean;
@@ -2476,6 +2487,18 @@ export type HeaderFooterType = 'default' | 'first' | 'even' | 'odd';
 export type HeaderFooterPage = {
     number: number;
     fragments: Fragment[];
+    /**
+     * Measurement height for this page's resolved story content. PAGE/NUMPAGES
+     * fields can wrap differently across physical pages, so paint alignment must
+     * not substitute the layout-wide maximum for this value.
+     */
+    measurementHeight?: number;
+    /** Per-page minimum rendered y, including out-of-band decorations. */
+    minY?: number;
+    /** Per-page maximum rendered y + fragment height. */
+    maxY?: number;
+    /** Per-page visual extent (`maxY - minY`). */
+    renderHeight?: number;
     numberText?: string;
     /** Section-aware numeric page value before formatting. */
     displayNumber?: number;

package/dist/layout-engine/contracts/src/resolved-layout.d.ts

@@ -476,6 +476,11 @@ export declare function isResolvedDrawingItem(item: ResolvedPaintItem): item is
 /** A resolved header/footer page — mirrors HeaderFooterPage but with resolved items. */
 export type ResolvedHeaderFooterPage = {
     number: number;
+    /** Page-local measurement height; see `HeaderFooterPage.measurementHeight`. */
+    measurementHeight?: number;
+    minY?: number;
+    maxY?: number;
+    renderHeight?: number;
     numberText?: string;
     /** Section-aware numeric page value before formatting. */
     displayNumber?: number;

package/dist/layout-engine/dom-contract/src/class-names.d.ts

@@ -12,6 +12,8 @@ export declare const DOM_CLASS_NAMES: {
     readonly PAGE: "superdoc-page";
     /** Fragment container (paragraph, table, image block, etc.). */
     readonly FRAGMENT: "superdoc-fragment";
+    /** Non-flowing fragment whose visual position must not define body flow geometry. */
+    readonly FLOATING_FRAGMENT: "superdoc-floating-fragment";
     /** Line container within a fragment. */
     readonly LINE: "superdoc-line";
     /**

package/dist/layout-engine/layout-engine/src/floating-objects.d.ts

@@ -1,4 +1,4 @@
-import { ImageBlock, ImageMeasure, ExclusionZone, DrawingBlock, DrawingMeasure, TableBlock, TableMeasure, ColumnLayoutForAnchor } from '../../contracts/src/index.js';
+import { ImageBlock, ImageMeasure, ExclusionZone, DrawingBlock, DrawingMeasure, TableBlock, TableMeasure, ColumnLayoutForAnchor, ResolveAnchoredGraphicXContext } from '../../contracts/src/index.js';
 type FloatBlock = ImageBlock | DrawingBlock;
 type FloatMeasure = ImageMeasure | DrawingMeasure;
 export type FloatingObjectManager = {
@@ -69,5 +69,5 @@ export declare function createFloatingObjectManager(columns: ColumnLayout, margi
 export declare function computeAnchorX(anchor: NonNullable<ImageBlock['anchor']>, columnIndex: number, columns: ColumnLayout, imageWidth: number, margins?: {
     left?: number;
     right?: number;
-}, pageWidth?: number): number;
+}, pageWidth?: number, context?: ResolveAnchoredGraphicXContext): number;
 export {};

package/dist/layout-engine/layout-engine/src/inline-drawing-alignment.d.ts

@@ -0,0 +1,9 @@
+import { FlowBlock, Measure, Page } from '../../contracts/src/index.js';
+/**
+ * Word baseline-aligns an inline zero-height connector with the run that owns
+ * it. Projection keeps vector drawings as sibling blocks, so the connector has
+ * already reserved its authored flow height before the empty carrier paragraph
+ * is laid out. Reposition only its paint fragment once that carrier's measured
+ * baseline is known; later flow remains untouched.
+ */
+export declare function alignInlineZeroHeightDrawingFragments(pages: Page[], blocks: FlowBlock[], measures: Measure[]): void;

package/dist/layout-engine/painters/dom/src/renderer.d.ts

@@ -600,6 +600,12 @@ export declare class DomPainter {
      * Uses resolved data for spatial properties and delegates PM attributes to the legacy path.
      */
     private isAnchoredMediaFragment;
+    /**
+     * Marks fragments whose paint coordinates are independent from body flow.
+     * DOM consumers such as header/footer hit-testing must not infer page margins
+     * from floating objects that happen to paint above the first flow block.
+     */
+    private applyFragmentFlowClass;
     private shouldRenderBehindPageContent;
     private isHeaderWordArtWatermark;
     private isVmlTextWatermarkImage;

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-C7loo2YE.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DNtHxzz_.cjs");
 let react = require("react");
 //#region src/public/ui/react.ts
 /**

package/dist/public/ui-react.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-C6qsVKMY.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-B_1l545i.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 //#region src/public/ui/react.ts
 /**

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-C7loo2YE.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DNtHxzz_.cjs");
 exports.BUILT_IN_COMMAND_IDS = require_create_super_doc_ui.BUILT_IN_COMMAND_IDS;
 exports.createSuperDocUI = require_create_super_doc_ui.createSuperDocUI;
 exports.shallowEqual = require_create_super_doc_ui.shallowEqual;

package/dist/public/ui.es.js

@@ -1,2 +1,2 @@
-import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-C6qsVKMY.es.js";
+import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-B_1l545i.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };

package/dist/superdoc.cjs

@@ -4,7 +4,7 @@ const require_blank_docx = require("./chunks/blank-docx-BuFAbRjs.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-D38u8ta_.cjs");
 const require_uuid = require("./chunks/uuid-BhG0ngwk.cjs");
 const require_jszip = require("./chunks/jszip-RC64TPzL.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-C7loo2YE.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-DNtHxzz_.cjs");
 const require__plugin_vue_export_helper = require("./chunks/_plugin-vue_export-helper-SDR04tiH.cjs");
 const require_constants = require("./chunks/constants-DpXuDx_g.cjs");
 let vue = require("vue");
@@ -43261,7 +43261,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.4.0-next.50";
+		this.version = "2.4.0-next.52";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];

package/dist/superdoc.es.js

@@ -3,7 +3,7 @@ import { t as blank_default } from "./chunks/blank-docx-DzQccOlW.es.js";
 import { t as import_eventemitter3 } from "./chunks/eventemitter3-CMOjDs74.es.js";
 import { t as v4 } from "./chunks/uuid-H0Xcmmhy.es.js";
 import { a as init_dist$1, i as global, n as init_dist$2, o as Buffer, r as process$1, s as init_dist, t as require_jszip_min } from "./chunks/jszip-VxCFV9YS.es.js";
-import { a as DOM_CLASS_NAMES, i as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-C6qsVKMY.es.js";
+import { a as DOM_CLASS_NAMES, i as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-B_1l545i.es.js";
 import { t as _plugin_vue_export_helper_default } from "./chunks/_plugin-vue_export-helper-BOaGB7Aw.es.js";
 import { t as PDF_TO_CSS_UNITS } from "./chunks/constants-B6VBlmKp.es.js";
 import * as Vue from "vue";
@@ -43194,7 +43194,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.4.0-next.50";
+		this.version = "2.4.0-next.52";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];