fix(layout): per-section footer constraints for multi-section docs (SD-1837) (#2022)

* fix(layout): per-section footer constraints and fldSimple field rendering (SD-1837)

Footer tables now respect per-section margins in multi-section documents.
Previously, all footers were measured using the first section's content
width, causing table overflow on sections with different margins.

Key changes:
- Add margins/pageSize to SectionMetadata for per-section constraint computation
- Refactor layoutPerRIdHeaderFooters to compute per-section constraints
  using composite keys (rId::sN) for section-specific measurements
- Handle pct-based table widths by pre-expanding constraints
- Add rescaleColumnWidths to all table fragment creation sites (SD-1859)
- Unwrap unhandled w:fldSimple fields (FILENAME, etc.) to render cached text

* fix(editor): footer editing and page interaction bugs (SD-1837)

Fix multiple issues with footer editing in presentation mode:

- Fix hover tooltip only showing on first page by detecting page index
  from DOM via elementsFromPoint in normalizeClientPoint
- Fix double-click on footer selecting body text by properly preventing
  default browser behavior on pointerdown in footer regions
- Fix clicking on page N redirecting to page 1 by keeping Y as global
  layout coordinates in normalizeClientPoint (only X is adjusted for
  page centering) and computing page-local Y separately from the page
  element's bounding rect for header/footer hit testing
- Fix switching between footer editors on different pages by cleaning up
  the previous editing session in enterMode before setting up the new one
- Fix footer table layout collapsing by setting table-layout:fixed on
  tables in the footer ProseMirror editor element
- Fix wrong total page count in footer by reading body layout page count
  via getBodyPageCount dependency instead of header layout
- Fix page-number NodeView reading incorrect totalPageCount property

* docs(converter): clarify preProcessPageFieldsOnly is rendering-only, not import pipeline

Author: tupizz

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

@@ -859,6 +859,17 @@ export type SectionMetadata = {
   titlePg?: boolean;
   /** Vertical alignment of content within this section's pages */
   vAlign?: SectionVerticalAlign;
+  /** Section page margins in CSS px */
+  margins?: {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+    header?: number;
+    footer?: number;
+  } | null;
+  /** Section page size in CSS px */
+  pageSize?: { w: number; h: number } | null;
 };
 
 export type PageBreakBlock = {

packages/layout-engine/layout-bridge/src/incrementalLayout.ts

@@ -36,6 +36,8 @@ export type HeaderFooterLayoutResult = {
   layout: HeaderFooterLayout;
   blocks: FlowBlock[];
   measures: Measure[];
+  /** Effective layout width when table grid widths exceed section content width (SD-1837). */
+  effectiveWidth?: number;
 };
 
 export type IncrementalLayoutResult = {

packages/layout-engine/painters/dom/src/table/renderTableCell.ts

@@ -1385,11 +1385,7 @@ export const renderTableCell = (deps: TableCellRenderDependencies): TableCellRen
            * indentation but skips marker text rendering).
            */
           const shouldRenderMarker =
-            markerLayout &&
-            markerMeasure &&
-            lineIdx === 0 &&
-            localStartLine === 0 &&
-            markerMeasure.markerWidth > 0;
+            markerLayout && markerMeasure && lineIdx === 0 && localStartLine === 0 && markerMeasure.markerWidth > 0;
 
           if (shouldRenderMarker) {
             // Prepend marker + suffix inside lineEl (mirrors renderer.ts approach)

packages/layout-engine/pm-adapter/src/sections/analysis.test.ts

@@ -846,6 +846,8 @@ describe('analysis', () => {
         footerRefs: { default: 'footer1' },
         numbering: { format: 'decimal' },
         titlePg: false,
+        margins: null,
+        pageSize: null,
       });
     });
 

packages/layout-engine/pm-adapter/src/sections/analysis.ts

@@ -204,6 +204,8 @@ export function publishSectionMetadata(sectionRanges: SectionRange[], options?:
       numbering: section.numbering,
       titlePg: section.titlePg,
       vAlign: section.vAlign,
+      margins: section.margins,
+      pageSize: section.pageSize,
     });
   });
 }

packages/super-editor/src/assets/styles/elements/prosemirror.css

@@ -162,6 +162,18 @@ https://github.com/ProseMirror/prosemirror-tables/blob/master/demo/index.html
   /* width: 100%; */
 }
 
+/* Header/footer editors: constrain table to the editor's available width.
+   Raw DOCX grid <col> widths may exceed the section's content area.
+   table-layout:auto treats col widths as preferred (not hard) constraints,
+   so the browser can redistribute columns to fit within width:100%.
+   !important overrides inline styles set by TableView.updateTable()
+   which resets styles via table.style.cssText. */
+.sd-editor-scoped .ProseMirror.sd-header-footer table {
+  table-layout: auto !important;
+  width: 100% !important;
+  max-width: 100% !important;
+}
+
 .sd-editor-scoped .ProseMirror tr {
   position: relative;
 }

packages/super-editor/src/core/header-footer/EditorOverlayManager.ts

@@ -390,7 +390,7 @@ export class EditorOverlayManager {
         position: 'absolute',
         pointerEvents: 'auto', // Critical: enables click interaction
         visibility: 'hidden', // Hidden by default, shown during editing
-        overflow: 'hidden',
+        overflow: 'visible', // Allow table overflow (page's overflow:hidden still clips at page edge)
         boxSizing: 'border-box',
       });