fix(contracts): ignore later refs for fallback resolution

Author: luccas-harbour

packages/layout-engine/contracts/src/header-footer-inheritance.ts

@@ -51,10 +51,16 @@ export function resolveInheritedHeaderFooterRefWithType({
   const fromSection = resolveVariantRef(sectionIds, variantType);
   if (fromSection) return fromSection;
 
-  const hasSectionAwareRefs =
-    sectionMap != null &&
-    sectionMap.size > 0 &&
-    (sectionMap.has(sectionIndex) || (identifier.sectionCount ?? 0) > sectionIndex);
+  let hasPriorSectionRefs = false;
+  if (sectionMap) {
+    for (const index of sectionMap.keys()) {
+      if (index < sectionIndex) {
+        hasPriorSectionRefs = true;
+        break;
+      }
+    }
+  }
+  const hasSectionAwareRefs = sectionMap != null && (sectionMap.has(sectionIndex) || hasPriorSectionRefs);
   if (hasSectionAwareRefs) {
     for (let index = sectionIndex - 1; index >= 0; index -= 1) {
       const inherited = resolveVariantRef(sectionMap.get(index), variantType);

packages/layout-engine/layout-bridge/test/headerFooterUtils.test.ts

@@ -977,5 +977,25 @@ describe('headerFooterUtils', () => {
       expect(resolved?.type).toBe('default');
       expect(resolved?.contentId).toBe('converter-default');
     });
+
+    it('uses converter fallback refs when only later sections define refs', () => {
+      const identifier = buildMultiSectionIdentifier(
+        [{ sectionIndex: 0 }, { sectionIndex: 1, headerRefs: { default: 'section-1-default' } }],
+        undefined,
+        { headerIds: { default: 'converter-default' } },
+      );
+      const layout: Layout = {
+        pageSize: { w: 600, h: 800 },
+        pages: [{ number: 1, fragments: [], sectionIndex: 0 }],
+        headerFooter: {
+          default: { pages: [{ number: 1, fragments: [] }] },
+        },
+      };
+
+      const resolved = resolveHeaderFooterForPageAndSection(layout, 0, identifier, { kind: 'header' });
+
+      expect(resolved?.type).toBe('default');
+      expect(resolved?.contentId).toBe('converter-default');
+    });
   });
 });