superdoc 2.4.0-next.42 → 2.4.0-next.44

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

@@ -3701,6 +3701,7 @@ function createSuperDocUI(options) {
 		if (options?.invalidateQueuedNavigation !== false) queuedTrackChangeNavigationInvalidation += 1;
 	};
 	const listeners = /* @__PURE__ */ new Set();
+	let state;
 	let disposed = false;
 	let controllerRef = null;
 	const asyncReads = /* @__PURE__ */ new Map();
@@ -6666,15 +6667,24 @@ function createSuperDocUI(options) {
 		const target = rawTarget && typeof rawTarget === "object" ? rawTarget : null;
 		let next = null;
 		if (target?.entityType === "trackedChange" && typeof target.entityId === "string" && target.entityId.length > 0) {
-			const paintedEntityId = target.entityId;
 			const targetStory = target.story && typeof target.story === "object" ? target.story : void 0;
-			const allStoryItems = readAllStoryTrackChanges();
-			const entityId = (allStoryItems ? targetStory ? buildStoryScopedTrackedChangeIdContext(allStoryItems, targetStory).toPublicId(paintedEntityId) : buildTrackedChangeIdContext(allStoryItems).toPublicId(paintedEntityId) : null) ?? paintedEntityId;
 			const story = targetStory && storyLocatorSignature(targetStory) !== storyLocatorSignature(null) ? targetStory : void 0;
+			const rawPaintedEntityId = typeof target.paintedEntityId === "string" && target.paintedEntityId.length > 0 ? target.paintedEntityId : null;
+			const lookupEntityId = rawPaintedEntityId ?? target.entityId;
+			const publicId = (() => {
+				if (story) {
+					const allStoryItems = readAllStoryTrackChanges();
+					const storyContext = allStoryItems ? buildStoryScopedTrackedChangeIdContext(allStoryItems, story) : null;
+					return storyContext?.toPublicId(lookupEntityId) ?? storyContext?.toPublicId(target.entityId) ?? target.entityId;
+				}
+				const bodyContext = buildTrackedChangeIdContext(Array.isArray(state?.trackChanges.items) ? state.trackChanges.items : []);
+				return bodyContext.toPublicId(lookupEntityId) ?? bodyContext.toPublicId(target.entityId) ?? target.entityId;
+			})();
+			const paintedEntityId = rawPaintedEntityId ?? (lookupEntityId !== publicId ? lookupEntityId : null);
 			next = {
-				id: entityId,
+				id: publicId,
 				...story ? { story } : {},
-				...typeof target.paintedEntityId === "string" && target.paintedEntityId.length > 0 ? { paintedEntityId: target.paintedEntityId } : entityId !== paintedEntityId ? { paintedEntityId } : {}
+				...paintedEntityId && paintedEntityId !== publicId ? { paintedEntityId } : {}
 			};
 		}
 		if (rawTarget == null && next == null && explicitActiveChange != null && hasPendingTrackChangeRevealFocus(explicitActiveChange)) return false;
@@ -6740,7 +6750,7 @@ function createSuperDocUI(options) {
 	};
 	syncCoordinatorEditor();
 	syncTrackedChangeFocusFromHostReviewTarget(readHostActiveReviewTarget(readHostReviewSource()));
-	let state = computeState();
+	state = computeState();
 	lastOptimisticInlineSelectionSignature = selectionInlineValueSignature(state.selection);
 	const syncHostEventsSubscription = () => {
 		const events = (getEditor()?.host)?.events;
@@ -8742,6 +8752,66 @@ function createSuperDocUI(options) {
 		}
 	};
 	/**
+	* Derive the browser-shell's `importedId` carrier-lookup alias from a
+	* public list row's `wordRevisionIds` / `sourceIds` provenance fields,
+	* mirroring `create-v2-tracked-changes-adapter.js`'s own derivation
+	* (`wordRevisionIds.insert ?? .delete ?? .format ?? sourceIds.wordIdInsert
+	* ?? .wordIdDelete ?? .wordIdOther[0]`). A carrier imported from a legacy
+	* Word revision id is painted with THIS id, not the canonical public id —
+	* `focusTrackedChange`'s carrier lookup only tries it when explicitly
+	* passed as `importedId` on an object input (see `scrollTrackChangeIntoView`).
+	*/
+	const deriveTrackedChangeImportedId = (row) => {
+		if (!row || typeof row !== "object") return null;
+		const record = row;
+		const wordRevisionIds = record.wordRevisionIds && typeof record.wordRevisionIds === "object" ? record.wordRevisionIds : null;
+		const sourceIds = record.sourceIds && typeof record.sourceIds === "object" ? record.sourceIds : null;
+		const wordIdOther = Array.isArray(sourceIds?.wordIdOther) ? sourceIds.wordIdOther : void 0;
+		const candidate = wordRevisionIds?.insert ?? wordRevisionIds?.delete ?? wordRevisionIds?.format ?? sourceIds?.wordIdInsert ?? sourceIds?.wordIdDelete ?? wordIdOther?.[0];
+		return typeof candidate === "string" && candidate.length > 0 ? candidate : null;
+	};
+	/**
+	* Scroll a tracked-change target into view, falling back to the v2
+	* browser-shell's `focusTrackedChange` (the same mechanism the built-in
+	* comments/tracked-changes sidebar uses via `CommentDialog.vue`'s
+	* `setFocus`) when the shared host geometry path can't resolve the target.
+	* The host's `normalizeGeometryTarget` only understands `text`/`replacement`
+	* targets (enriched with painted `segments`) and never `structural`/
+	* `formatting` targets, so those always fail the primary path and need this
+	* fallback.
+	*
+	* `story`, when present, is threaded into the fallback input as
+	* `trackedChangeStory` — a bare id always resolves to the body story in
+	* `focusTrackedChange`'s target resolver, which would collapse a non-body
+	* (footnote/header/footer) occurrence onto its body counterpart sharing the
+	* same raw id. `importedId`, when present, is threaded in too: the carrier
+	* lookup (`buildTrackChangeCarrierLookupIds`) tries it as an ADDITIONAL alias
+	* alongside the canonical id, for rows whose painted carrier only matches
+	* through a legacy-imported Word revision id, not the canonical public id
+	* (`create-v2-tracked-changes-adapter.test.js` pins this alias path as
+	* necessary for some rows).
+	*/
+	const scrollTrackChangeIntoView = async (changeId, target, story, importedId, options) => {
+		const primary = await scrollTargetIntoView(target, options);
+		if (primary.ok) return primary;
+		const trackedChanges = getV2TrackedChanges();
+		const focusTrackedChange = trackedChanges?.focusTrackedChange;
+		if (typeof focusTrackedChange !== "function") return primary;
+		const fallbackInput = story || importedId ? {
+			commentId: changeId,
+			...story ? { trackedChangeStory: story } : {},
+			...importedId ? { importedId } : {}
+		} : changeId;
+		try {
+			const fallbackResult = await Promise.resolve(focusTrackedChange.call(trackedChanges, fallbackInput));
+			if (fallbackResult && typeof fallbackResult === "object" && fallbackResult.ok === true) return {
+				success: true,
+				ok: true
+			};
+		} catch {}
+		return primary;
+	};
+	/**
 	* Resolve a document entity (comment / tracked change) to its anchor target.
 	* Prefers the already-loaded list row, falling back to a live `get({ id })`
 	* read when the list does not carry the row.
@@ -9003,9 +9073,11 @@ function createSuperDocUI(options) {
 				rollback();
 				return { success: false };
 			}
+			const activeRow = trackChangesSub.get().items.find((item) => entityRowMatchesRequest(item, activeId, optimisticActiveChange?.story)) ?? trackChangesSub.get().items.find((item) => readEntityId(item) === activeId);
+			const importedId = deriveTrackedChangeImportedId(activeRow);
 			trackedChangeNavigationInFlight += 1;
 			try {
-				const result = await scrollTargetIntoView(target, {
+				const result = await scrollTrackChangeIntoView(activeId, target, optimisticActiveChange?.story, importedId, {
 					behavior: "auto",
 					shouldContinue: isCurrent
 				});
@@ -9129,7 +9201,9 @@ function createSuperDocUI(options) {
 			const requestedAtInvalidation = trackChangeRevealInvalidation;
 			const loadedItems = trackChangesSub.get().items;
 			const publicId = buildTrackedChangeIdContext(loadedItems).toPublicId(changeId) ?? changeId;
-			const story = readEntityRequestStory(loadedItems.find((item) => readEntityId(item) === publicId));
+			const matchingRow = loadedItems.find((item) => readEntityId(item) === publicId);
+			const story = readEntityRequestStory(matchingRow);
+			const importedId = deriveTrackedChangeImportedId(matchingRow);
 			const previousActiveChange = explicitActiveChange;
 			const requestedActiveChange = {
 				id: publicId,
@@ -9161,7 +9235,7 @@ function createSuperDocUI(options) {
 				recompute();
 				trackedChangeNavigationInFlight += 1;
 				try {
-					const result = await scrollTargetIntoView(target, {
+					const result = await scrollTrackChangeIntoView(publicId, target, story, importedId, {
 						behavior: "auto",
 						shouldContinue: isCurrent
 					});

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

@@ -3701,6 +3701,7 @@ function createSuperDocUI(options) {
 		if (options?.invalidateQueuedNavigation !== false) queuedTrackChangeNavigationInvalidation += 1;
 	};
 	const listeners = /* @__PURE__ */ new Set();
+	let state;
 	let disposed = false;
 	let controllerRef = null;
 	const asyncReads = /* @__PURE__ */ new Map();
@@ -6666,15 +6667,24 @@ function createSuperDocUI(options) {
 		const target = rawTarget && typeof rawTarget === "object" ? rawTarget : null;
 		let next = null;
 		if (target?.entityType === "trackedChange" && typeof target.entityId === "string" && target.entityId.length > 0) {
-			const paintedEntityId = target.entityId;
 			const targetStory = target.story && typeof target.story === "object" ? target.story : void 0;
-			const allStoryItems = readAllStoryTrackChanges();
-			const entityId = (allStoryItems ? targetStory ? buildStoryScopedTrackedChangeIdContext(allStoryItems, targetStory).toPublicId(paintedEntityId) : buildTrackedChangeIdContext(allStoryItems).toPublicId(paintedEntityId) : null) ?? paintedEntityId;
 			const story = targetStory && storyLocatorSignature(targetStory) !== storyLocatorSignature(null) ? targetStory : void 0;
+			const rawPaintedEntityId = typeof target.paintedEntityId === "string" && target.paintedEntityId.length > 0 ? target.paintedEntityId : null;
+			const lookupEntityId = rawPaintedEntityId ?? target.entityId;
+			const publicId = (() => {
+				if (story) {
+					const allStoryItems = readAllStoryTrackChanges();
+					const storyContext = allStoryItems ? buildStoryScopedTrackedChangeIdContext(allStoryItems, story) : null;
+					return storyContext?.toPublicId(lookupEntityId) ?? storyContext?.toPublicId(target.entityId) ?? target.entityId;
+				}
+				const bodyContext = buildTrackedChangeIdContext(Array.isArray(state?.trackChanges.items) ? state.trackChanges.items : []);
+				return bodyContext.toPublicId(lookupEntityId) ?? bodyContext.toPublicId(target.entityId) ?? target.entityId;
+			})();
+			const paintedEntityId = rawPaintedEntityId ?? (lookupEntityId !== publicId ? lookupEntityId : null);
 			next = {
-				id: entityId,
+				id: publicId,
 				...story ? { story } : {},
-				...typeof target.paintedEntityId === "string" && target.paintedEntityId.length > 0 ? { paintedEntityId: target.paintedEntityId } : entityId !== paintedEntityId ? { paintedEntityId } : {}
+				...paintedEntityId && paintedEntityId !== publicId ? { paintedEntityId } : {}
 			};
 		}
 		if (rawTarget == null && next == null && explicitActiveChange != null && hasPendingTrackChangeRevealFocus(explicitActiveChange)) return false;
@@ -6740,7 +6750,7 @@ function createSuperDocUI(options) {
 	};
 	syncCoordinatorEditor();
 	syncTrackedChangeFocusFromHostReviewTarget(readHostActiveReviewTarget(readHostReviewSource()));
-	let state = computeState();
+	state = computeState();
 	lastOptimisticInlineSelectionSignature = selectionInlineValueSignature(state.selection);
 	const syncHostEventsSubscription = () => {
 		const events = (getEditor()?.host)?.events;
@@ -8742,6 +8752,66 @@ function createSuperDocUI(options) {
 		}
 	};
 	/**
+	* Derive the browser-shell's `importedId` carrier-lookup alias from a
+	* public list row's `wordRevisionIds` / `sourceIds` provenance fields,
+	* mirroring `create-v2-tracked-changes-adapter.js`'s own derivation
+	* (`wordRevisionIds.insert ?? .delete ?? .format ?? sourceIds.wordIdInsert
+	* ?? .wordIdDelete ?? .wordIdOther[0]`). A carrier imported from a legacy
+	* Word revision id is painted with THIS id, not the canonical public id —
+	* `focusTrackedChange`'s carrier lookup only tries it when explicitly
+	* passed as `importedId` on an object input (see `scrollTrackChangeIntoView`).
+	*/
+	const deriveTrackedChangeImportedId = (row) => {
+		if (!row || typeof row !== "object") return null;
+		const record = row;
+		const wordRevisionIds = record.wordRevisionIds && typeof record.wordRevisionIds === "object" ? record.wordRevisionIds : null;
+		const sourceIds = record.sourceIds && typeof record.sourceIds === "object" ? record.sourceIds : null;
+		const wordIdOther = Array.isArray(sourceIds?.wordIdOther) ? sourceIds.wordIdOther : void 0;
+		const candidate = wordRevisionIds?.insert ?? wordRevisionIds?.delete ?? wordRevisionIds?.format ?? sourceIds?.wordIdInsert ?? sourceIds?.wordIdDelete ?? wordIdOther?.[0];
+		return typeof candidate === "string" && candidate.length > 0 ? candidate : null;
+	};
+	/**
+	* Scroll a tracked-change target into view, falling back to the v2
+	* browser-shell's `focusTrackedChange` (the same mechanism the built-in
+	* comments/tracked-changes sidebar uses via `CommentDialog.vue`'s
+	* `setFocus`) when the shared host geometry path can't resolve the target.
+	* The host's `normalizeGeometryTarget` only understands `text`/`replacement`
+	* targets (enriched with painted `segments`) and never `structural`/
+	* `formatting` targets, so those always fail the primary path and need this
+	* fallback.
+	*
+	* `story`, when present, is threaded into the fallback input as
+	* `trackedChangeStory` — a bare id always resolves to the body story in
+	* `focusTrackedChange`'s target resolver, which would collapse a non-body
+	* (footnote/header/footer) occurrence onto its body counterpart sharing the
+	* same raw id. `importedId`, when present, is threaded in too: the carrier
+	* lookup (`buildTrackChangeCarrierLookupIds`) tries it as an ADDITIONAL alias
+	* alongside the canonical id, for rows whose painted carrier only matches
+	* through a legacy-imported Word revision id, not the canonical public id
+	* (`create-v2-tracked-changes-adapter.test.js` pins this alias path as
+	* necessary for some rows).
+	*/
+	const scrollTrackChangeIntoView = async (changeId, target, story, importedId, options) => {
+		const primary = await scrollTargetIntoView(target, options);
+		if (primary.ok) return primary;
+		const trackedChanges = getV2TrackedChanges();
+		const focusTrackedChange = trackedChanges?.focusTrackedChange;
+		if (typeof focusTrackedChange !== "function") return primary;
+		const fallbackInput = story || importedId ? {
+			commentId: changeId,
+			...story ? { trackedChangeStory: story } : {},
+			...importedId ? { importedId } : {}
+		} : changeId;
+		try {
+			const fallbackResult = await Promise.resolve(focusTrackedChange.call(trackedChanges, fallbackInput));
+			if (fallbackResult && typeof fallbackResult === "object" && fallbackResult.ok === true) return {
+				success: true,
+				ok: true
+			};
+		} catch {}
+		return primary;
+	};
+	/**
 	* Resolve a document entity (comment / tracked change) to its anchor target.
 	* Prefers the already-loaded list row, falling back to a live `get({ id })`
 	* read when the list does not carry the row.
@@ -9003,9 +9073,11 @@ function createSuperDocUI(options) {
 				rollback();
 				return { success: false };
 			}
+			const activeRow = trackChangesSub.get().items.find((item) => entityRowMatchesRequest(item, activeId, optimisticActiveChange?.story)) ?? trackChangesSub.get().items.find((item) => readEntityId(item) === activeId);
+			const importedId = deriveTrackedChangeImportedId(activeRow);
 			trackedChangeNavigationInFlight += 1;
 			try {
-				const result = await scrollTargetIntoView(target, {
+				const result = await scrollTrackChangeIntoView(activeId, target, optimisticActiveChange?.story, importedId, {
 					behavior: "auto",
 					shouldContinue: isCurrent
 				});
@@ -9129,7 +9201,9 @@ function createSuperDocUI(options) {
 			const requestedAtInvalidation = trackChangeRevealInvalidation;
 			const loadedItems = trackChangesSub.get().items;
 			const publicId = buildTrackedChangeIdContext(loadedItems).toPublicId(changeId) ?? changeId;
-			const story = readEntityRequestStory(loadedItems.find((item) => readEntityId(item) === publicId));
+			const matchingRow = loadedItems.find((item) => readEntityId(item) === publicId);
+			const story = readEntityRequestStory(matchingRow);
+			const importedId = deriveTrackedChangeImportedId(matchingRow);
 			const previousActiveChange = explicitActiveChange;
 			const requestedActiveChange = {
 				id: publicId,
@@ -9161,7 +9235,7 @@ function createSuperDocUI(options) {
 				recompute();
 				trackedChangeNavigationInFlight += 1;
 				try {
-					const result = await scrollTargetIntoView(target, {
+					const result = await scrollTrackChangeIntoView(publicId, target, story, importedId, {
 						behavior: "auto",
 						shouldContinue: isCurrent
 					});

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.42",
+	superdocVersion: "2.4.0-next.44",
 	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.42",
+	superdocVersion: "2.4.0-next.44",
 	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/index.d.ts

@@ -742,6 +742,16 @@ export type CellBorders = {
     bottom?: BorderSpec;
     left?: BorderSpec;
 };
+/** True when a normalized border contributes a visible edge. */
+export declare const isPresentBorder: (border?: BorderSpec) => border is BorderSpec;
+/** True when the source explicitly suppresses an edge rather than omitting it. */
+export declare const isExplicitNoneBorder: (border?: unknown) => boolean;
+/**
+ * Resolve the single visible edge shared by two cells according to
+ * ECMA-376 Part 1 §17.4.66. Kept in the editor-neutral contract package so
+ * import and DOM paint use one conflict algorithm.
+ */
+export declare const resolveBorderConflict: (first?: BorderSpec, second?: BorderSpec) => BorderSpec | undefined;
 export type TableCellAttrs = {
     borders?: CellBorders;
     padding?: BoxSpacing;
@@ -974,6 +984,13 @@ export type TextFormatting = {
 export type TextPart = {
     text: string;
     formatting?: TextFormatting;
+    /**
+     * Paragraph properties carried by the first visible part of a shape-text
+     * paragraph. Shape text is intentionally flattened into `parts`, so this
+     * marker preserves the authored block geometry without introducing a second
+     * competing text model.
+     */
+    paragraphProperties?: ShapeTextParagraphProperties;
     /** Optional field token (e.g., PAGE/NUMPAGES/SECTIONPAGES) resolved at render time. */
     fieldType?: 'PAGE' | 'NUMPAGES' | 'SECTIONPAGES';
     /** PAGE/SECTIONPAGES field-local value formatting override. */
@@ -999,6 +1016,17 @@ export type TextPart = {
     height?: number;
     alt?: string;
 };
+/** Paragraph geometry used by flattened DrawingML/VML shape text. */
+export type ShapeTextParagraphProperties = {
+    horizontalAlign?: 'left' | 'center' | 'right' | 'justify';
+    spacingBefore?: number;
+    spacingAfter?: number;
+    line?: number;
+    lineUnit?: 'px' | 'multiplier';
+    leftIndent?: number;
+    rightIndent?: number;
+    firstLineIndent?: number;
+};
 /** Text content configuration for shapes. */
 export type ShapeTextContent = {
     /** Array of text parts with individual formatting. */
@@ -1025,6 +1053,8 @@ export type VectorShapeStyle = {
     fillColor?: FillColor;
     strokeColor?: StrokeColor;
     strokeWidth?: number;
+    /** Optional per-edge frame used by render-only table cells inside legacy shape groups. */
+    borders?: CellBorders;
     lineEnds?: LineEnds;
     textContent?: ShapeTextContent;
     textAlign?: string;
@@ -1124,6 +1154,8 @@ export type VectorShapeDrawing = DrawingBlockBase & {
 export type TextboxDrawing = DrawingBlockBase & {
     drawingKind: 'textboxShape';
     geometry: DrawingGeometry;
+    /** `a:spAutoFit`: resize the shape height to its measured text content. */
+    autoFit?: boolean;
     shapeKind?: string;
     customGeometry?: CustomGeometryData;
     fillColor?: FillColor;
@@ -1312,6 +1344,8 @@ export type ColumnBreakBlock = {
 /** Positioning for anchored images (offsets in CSS px). */
 export type ImageAnchor = {
     isAnchored?: boolean;
+    /** 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';
@@ -1418,7 +1452,7 @@ export type ExclusionZone = {
         left: number;
         right: number;
     };
-    wrapMode: 'left' | 'right' | 'both' | 'none' | 'largest';
+    wrapMode: 'left' | 'right' | 'both' | 'none' | 'largest' | 'topBottom';
     polygon?: number[][];
 };
 export type ParagraphSpacing = {
@@ -1930,6 +1964,18 @@ export type Line = {
      */
     tabWidths?: Record<number, number>;
 };
+/**
+ * One contiguous horizontal region available to a measured paragraph line.
+ *
+ * Coordinates are relative to the paragraph fragment's content origin. A line
+ * can expose multiple regions when text wraps on both sides of a floating
+ * object. Measuring owns the line breaks inside these regions; layout owns
+ * deriving the regions from page/column float geometry.
+ */
+export type ParagraphLineRegion = {
+    offsetX: number;
+    width: number;
+};
 export type LineSegment = {
     runIndex: number;
     fromChar: number;

package/dist/layout-engine/layout-bridge/src/layoutHeaderFooter.d.ts

@@ -1,4 +1,4 @@
-import { FlowBlock, HeaderFooterLayout, Measure, PageNumberChapterSeparator, PageNumberFormat, ParagraphBlock, ParagraphMeasure } from '../../contracts/src/index.js';
+import { FlowBlock, HeaderFooterLayout, Measure, PageNumberChapterSeparator, PageNumberFormat, ParagraphBlock, ParagraphLineRegion, ParagraphMeasure } from '../../contracts/src/index.js';
 import { HeaderFooterConstraints, LayoutExecutionCheckpoint, LayoutExecutionControl } from '../../layout-engine/src/index.js';
 import { MeasureCache } from './cache.js';
 import { ResolveHeaderFooterTokensOptions } from './resolveHeaderFooterTokens.js';
@@ -127,4 +127,4 @@ export declare function invalidateHeaderFooterMeasureCache(blockIds: string[]):
  * @param pageResolver - Callback to resolve display page info for a physical page number
  * @returns Batch result with layouts, blocks, and measures for each variant
  */
-export declare function layoutHeaderFooterWithCache(sections: HeaderFooterBatch, constraints: HeaderFooterConstraints, measureBlock: MeasureResolver, cache?: HeaderFooterLayoutCache, totalPages?: number, pageResolver?: PageResolver, kind?: 'header' | 'footer', fontSignature?: string, remeasureParagraph?: (block: ParagraphBlock, maxWidth: number, firstLineIndent?: number) => ParagraphMeasure, options?: ResolveHeaderFooterTokensOptions, execution?: HeaderFooterLayoutExecution): Promise<HeaderFooterBatchResult>;
+export declare function layoutHeaderFooterWithCache(sections: HeaderFooterBatch, constraints: HeaderFooterConstraints, measureBlock: MeasureResolver, cache?: HeaderFooterLayoutCache, totalPages?: number, pageResolver?: PageResolver, kind?: 'header' | 'footer', fontSignature?: string, remeasureParagraph?: (block: ParagraphBlock, maxWidth: number, firstLineIndent?: number, lineRegions?: readonly (readonly ParagraphLineRegion[])[]) => ParagraphMeasure, options?: ResolveHeaderFooterTokensOptions, execution?: HeaderFooterLayoutExecution): Promise<HeaderFooterBatchResult>;

package/dist/layout-engine/layout-bridge/src/remeasure.d.ts

@@ -1,4 +1,4 @@
-import { ParagraphBlock, ParagraphMeasure } from '../../contracts/src/index.js';
+import { ParagraphBlock, ParagraphMeasure, ParagraphLineRegion } from '../../contracts/src/index.js';
 /** Drop cached text widths and the canvas context. Call when registered font faces may have changed. */
 export declare function clearRemeasureTextCaches(): void;
 /**
@@ -72,4 +72,4 @@ export declare function clearRemeasureTextCaches(): void;
  * // First line has only 170px available (200 - 30), subsequent lines have full 200px
  * ```
  */
-export declare function remeasureParagraph(block: ParagraphBlock, maxWidth: number, firstLineIndent?: number): ParagraphMeasure;
+export declare function remeasureParagraph(block: ParagraphBlock, maxWidth: number, firstLineIndent?: number, lineRegions?: readonly (readonly ParagraphLineRegion[])[]): ParagraphMeasure;

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

@@ -31,6 +31,19 @@ export type FloatingObjectManager = {
         width: number;
         offsetX: number;
     };
+    /**
+     * Compute every contiguous horizontal region available to a line.
+     * Unlike computeAvailableWidth, this preserves both sides of a centered
+     * `wrapText="bothSides"` object instead of collapsing them to one side.
+     */
+    computeAvailableRegions(lineY: number, lineHeight: number, baseWidth: number, columnIndex: number, pageNumber: number): Array<{
+        offsetX: number;
+        width: number;
+    }>;
+    /**
+     * Return the first Y coordinate below every overlapping TopAndBottom float.
+     */
+    computeVerticalClearance(lineY: number, lineHeight: number, columnIndex: number, pageNumber: number): number | null;
     /**
      * Get all floating images for a page (for debugging/painting).
      */

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

@@ -1,4 +1,4 @@
-import { ColumnLayout, FlowBlock, HeaderFooterLayout, Layout, Measure, Page, ParagraphBlock, ParagraphMeasure, SectionMetadata, FlowMode, DocumentBackground } from '../../contracts/src/index.js';
+import { ColumnLayout, FlowBlock, HeaderFooterLayout, Layout, Measure, Page, ParagraphBlock, ParagraphMeasure, SectionMetadata, FlowMode, DocumentBackground, ParagraphLineRegion } from '../../contracts/src/index.js';
 import { PageState, ConstraintBoundary } from './paginator.js';
 import { LayoutExecutionControl } from './execution.js';
 type PageSize = {
@@ -31,7 +31,7 @@ export type LayoutOptions = {
         marginTop?: number;
         marginBottom?: number;
     };
-    remeasureParagraph?: (block: ParagraphBlock, maxWidth: number, firstLineIndent?: number) => ParagraphMeasure;
+    remeasureParagraph?: (block: ParagraphBlock, maxWidth: number, firstLineIndent?: number, lineRegions?: readonly (readonly ParagraphLineRegion[])[]) => ParagraphMeasure;
     /** @internal Positioned paragraph frames that render without advancing the story cursor. */
     nonFlowPositionedParagraphFrameIds?: ReadonlySet<string>;
     sectionMetadata?: SectionMetadata[];
@@ -337,8 +337,8 @@ export declare function layoutDocumentRange(input: LayoutRangeInput): LayoutRang
  * Returns separate measurement bounds (for pagination) and render bounds
  * (for overlay shift). See the Coordinate Contract in the fix plan for details.
  */
-export declare function layoutHeaderFooter(blocks: FlowBlock[], measures: Measure[], constraints: HeaderFooterConstraints, kind?: 'header' | 'footer', remeasureParagraph?: (block: ParagraphBlock, maxWidth: number, firstLineIndent?: number) => ParagraphMeasure): HeaderFooterLayout;
-export declare function layoutHeaderFooterCooperatively(blocks: FlowBlock[], measures: Measure[], constraints: HeaderFooterConstraints, kind?: 'header' | 'footer', remeasureParagraph?: (block: ParagraphBlock, maxWidth: number, firstLineIndent?: number) => ParagraphMeasure, execution?: LayoutExecutionControl): Promise<HeaderFooterLayout>;
+export declare function layoutHeaderFooter(blocks: FlowBlock[], measures: Measure[], constraints: HeaderFooterConstraints, kind?: 'header' | 'footer', remeasureParagraph?: LayoutOptions['remeasureParagraph']): HeaderFooterLayout;
+export declare function layoutHeaderFooterCooperatively(blocks: FlowBlock[], measures: Measure[], constraints: HeaderFooterConstraints, kind?: 'header' | 'footer', remeasureParagraph?: LayoutOptions['remeasureParagraph'], execution?: LayoutExecutionControl): Promise<HeaderFooterLayout>;
 export { buildAnchorMap, resolvePageRefTokens, getTocBlocksForRemeasurement } from './resolvePageRefs.js';
 export { buildChapterContextByPage, buildChapterContextByPageCooperatively, computeDisplayPageNumber, computeDisplayPageNumberCooperatively, formatPageNumber, formatPageNumberFieldValue, formatSectionPageNumberText, normalizeChapterMarkerText, } from './pageNumbering.js';
 export type { ChapterPageInfo, DisplayPageInfo, PageNumberFormat } from './pageNumbering.js';

package/dist/layout-engine/layout-engine/src/layout-paragraph.d.ts

@@ -1,6 +1,6 @@
 import { FloatingObjectManager } from './floating-objects.js';
 import { PageState } from './paginator.js';
-import { PageMargins, ParagraphBlock, ParagraphMeasure, ImageBlock, ImageMeasure, DrawingBlock, DrawingMeasure } from '../../contracts/src/index.js';
+import { PageMargins, ParagraphBlock, ParagraphMeasure, ImageBlock, ImageMeasure, DrawingBlock, DrawingMeasure, ParagraphLineRegion } from '../../contracts/src/index.js';
 import { AnchoredTable } from './anchors.js';
 /**
  * SD-2656: ordered footnote anchor entry. The body slicer reads the candidate
@@ -21,7 +21,7 @@ export type ParagraphLayoutContext = {
     advanceColumn: (state: PageState) => PageState;
     columnX: (state: PageState, columnIndex?: number) => number;
     floatManager: FloatingObjectManager;
-    remeasureParagraph?: (block: ParagraphBlock, maxWidth: number, firstLineIndent?: number) => ParagraphMeasure;
+    remeasureParagraph?: (block: ParagraphBlock, maxWidth: number, firstLineIndent?: number, lineRegions?: readonly (readonly ParagraphLineRegion[])[]) => ParagraphMeasure;
     /**
      * Override the paragraph's spacing-after value. Used when contextual spacing
      * should suppress spacing between this paragraph and the next (same-style) paragraph.

package/dist/layout-engine/painters/dom/src/table/border-utils.d.ts

@@ -79,32 +79,9 @@ export declare const borderValueToSpec: (value?: TableBorderValue | null) => Bor
  * ```
  */
 export declare const resolveTableBorderValue: (explicit: TableBorderValue | undefined | null, fallback?: TableBorderValue | undefined | null) => BorderSpec | undefined;
-export declare const isPresentBorder: (b?: BorderSpec) => b is BorderSpec;
-/**
- * True when a border is EXPLICITLY set to none/nil (`w:val="nil"`/`"none"`), as opposed to
- * simply unset/absent. The distinction matters for shared interior edges (§17.4.66): an
- * explicit none on BOTH adjacent cells suppresses the divider, while an unset side inherits
- * the table's insideH/insideV. Accepts either a CellBorders BorderSpec (`{style:'none'}`) or
- * a TableBorderValue (`{none:true}`).
- */
-export declare const isExplicitNoneBorder: (b?: unknown) => boolean;
-/**
- * OOXML cell-border conflict resolution (ECMA-376 §17.4.66).
- *
- * With zero cell spacing, two cells sharing an edge each specify a border; the spec
- * collapses them to a SINGLE displayed border:
- *  1. If either side is nil/none/absent, the opposing (present) border is displayed.
- *  2. Otherwise the border with greater weight wins, where
- *     weight = (#lines in the style) × (style number).
- *  3. Equal weight → the style higher on the precedence list (single first) wins.
- *  4. Identical style → the color with the smaller brightness (R+B+2G, then B+2G, then
- *     G) wins; finally the first border (reading order) wins.
- *
- * @param a - One side's border (the owning cell's, e.g. the lower/right cell)
- * @param b - The opposing side's border (e.g. the upper/left neighbor)
- * @returns The single BorderSpec to display, or undefined if neither is present.
- */
-export declare const resolveBorderConflict: (a?: BorderSpec, b?: BorderSpec) => BorderSpec | undefined;
+export declare const isPresentBorder: (border?: BorderSpec) => border is BorderSpec;
+export declare const isExplicitNoneBorder: (border?: unknown) => boolean;
+export declare const resolveBorderConflict: (first?: BorderSpec, second?: BorderSpec) => BorderSpec | undefined;
 /**
  * Creates a border overlay element for a table fragment.
  *

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-Dmv8Hjs6.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-C7loo2YE.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-B5SqT0gL.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-C6qsVKMY.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-Dmv8Hjs6.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-C7loo2YE.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-B5SqT0gL.es.js";
+import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-C6qsVKMY.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-Dmv8Hjs6.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-C7loo2YE.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");
@@ -43260,7 +43260,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.42";
+		this.version = "2.4.0-next.44";
 		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-B5SqT0gL.es.js";
+import { a as DOM_CLASS_NAMES, i as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-C6qsVKMY.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";
@@ -43193,7 +43193,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.42";
+		this.version = "2.4.0-next.44";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];