[2/16] refactor(layout): lift fragment metadata into resolved paint items (#2811)

* refactor(layout): lift page metadata into ResolvedPage

* refactor(layout): lift fragment metadata into resolved paint items

Add pmStart, pmEnd, continuesFromPrev, continuesOnNext, markerWidth,
and metadata fields to resolved paint item types. Populate them in
the resolvers and update the painter to prefer resolved item data
over legacy Fragment reads with fallbacks.

* fix(layout): use resolved continuation state for paragraph first-line width

Author: tupizz

packages/layout-engine/contracts/src/resolved-layout.ts

@@ -3,6 +3,7 @@ import type {
   FlowMode,
   Fragment,
   ImageBlock,
+  ImageFragmentMetadata,
   Line,
   PageMargins,
   SectionVerticalAlign,
@@ -105,6 +106,16 @@ export type ResolvedFragmentItem = {
   blockId: string;
   /** Index within page.fragments — bridge to legacy content rendering. */
   fragmentIndex: number;
+  /** ProseMirror start position for click-to-position mapping. */
+  pmStart?: number;
+  /** ProseMirror end position for click-to-position mapping. */
+  pmEnd?: number;
+  /** Whether this fragment continues from a previous page. */
+  continuesFromPrev?: boolean;
+  /** Whether this fragment continues on the next page. */
+  continuesOnNext?: boolean;
+  /** List marker box width in pixels (para/list-item only). */
+  markerWidth?: number;
   /** Pre-resolved paragraph content for non-table paragraph fragments. */
   content?: ResolvedParagraphContent;
 };
@@ -205,6 +216,14 @@ export type ResolvedTableItem = {
   blockId: string;
   /** Index within page.fragments — bridge to legacy rendering. */
   fragmentIndex: number;
+  /** ProseMirror start position for click-to-position mapping. */
+  pmStart?: number;
+  /** ProseMirror end position for click-to-position mapping. */
+  pmEnd?: number;
+  /** Whether this table fragment continues from a previous page. */
+  continuesFromPrev?: boolean;
+  /** Whether this table fragment continues on the next page. */
+  continuesOnNext?: boolean;
   /** Pre-extracted TableBlock (replaces blockLookup.get()). */
   block: TableBlock;
   /** Pre-extracted TableMeasure (replaces blockLookup.get()). */
@@ -241,8 +260,14 @@ export type ResolvedImageItem = {
   blockId: string;
   /** Index within page.fragments — bridge to legacy rendering. */
   fragmentIndex: number;
+  /** ProseMirror start position for click-to-position mapping. */
+  pmStart?: number;
+  /** ProseMirror end position for click-to-position mapping. */
+  pmEnd?: number;
   /** Pre-extracted ImageBlock (replaces blockLookup.get()). */
   block: ImageBlock;
+  /** Image metadata for interactive resizing (original dimensions, aspect ratio). */
+  metadata?: ImageFragmentMetadata;
 };
 
 /**
@@ -271,6 +296,10 @@ export type ResolvedDrawingItem = {
   blockId: string;
   /** Index within page.fragments — bridge to legacy rendering. */
   fragmentIndex: number;
+  /** ProseMirror start position for click-to-position mapping. */
+  pmStart?: number;
+  /** ProseMirror end position for click-to-position mapping. */
+  pmEnd?: number;
   /** Pre-extracted DrawingBlock (replaces blockLookup.get()). */
   block: DrawingBlock;
 };

packages/layout-engine/layout-resolved/src/resolveDrawing.ts

@@ -17,7 +17,7 @@ export function resolveDrawingItem(
 ): ResolvedDrawingItem {
   const { block } = requireResolvedBlockAndMeasure(blockMap, fragment.blockId, 'drawing', 'drawing', 'drawing');
 
-  return {
+  const item: ResolvedDrawingItem = {
     kind: 'fragment',
     fragmentKind: 'drawing',
     id: resolveDrawingFragmentId(fragment),
@@ -31,4 +31,7 @@ export function resolveDrawingItem(
     fragmentIndex,
     block,
   };
+  if (fragment.pmStart != null) item.pmStart = fragment.pmStart;
+  if (fragment.pmEnd != null) item.pmEnd = fragment.pmEnd;
+  return item;
 }

packages/layout-engine/layout-resolved/src/resolveImage.ts

@@ -17,7 +17,7 @@ export function resolveImageItem(
 ): ResolvedImageItem {
   const { block } = requireResolvedBlockAndMeasure(blockMap, fragment.blockId, 'image', 'image', 'image');
 
-  return {
+  const item: ResolvedImageItem = {
     kind: 'fragment',
     fragmentKind: 'image',
     id: resolveImageFragmentId(fragment),
@@ -31,4 +31,8 @@ export function resolveImageItem(
     fragmentIndex,
     block,
   };
+  if (fragment.pmStart != null) item.pmStart = fragment.pmStart;
+  if (fragment.pmEnd != null) item.pmEnd = fragment.pmEnd;
+  if (fragment.metadata != null) item.metadata = fragment.metadata;
+  return item;
 }