refactor(fields): accept generic options in SECTIONPAGES preprocessor

Replace the third positional `_docxOrFieldRunRPr` argument with a
generic field-preprocessing `options` object (docx, instructionTokens,
fieldRunRPr), keeping backward-compat with the legacy positional w:rPr.
Update cache-invalidation test fixtures to the `pageNumberFieldFormat`
run shape.

Author: luccas-harbour

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

@@ -57,14 +57,14 @@ describe('Cache Invalidation', () => {
           {
             kind: 'paragraph',
             id: 'p1',
-            runs: [{ text: '0', token: 'pageNumber', pageNumberFormat: 'decimal' }],
+            runs: [{ text: '0', token: 'pageNumber', pageNumberFieldFormat: { format: 'decimal' } }],
           } as ParagraphBlock,
         ];
         const romanBlocks: FlowBlock[] = [
           {
             kind: 'paragraph',
             id: 'p1',
-            runs: [{ text: '0', token: 'pageNumber', pageNumberFormat: 'upperRoman' }],
+            runs: [{ text: '0', token: 'pageNumber', pageNumberFieldFormat: { format: 'upperRoman' } }],
           } as ParagraphBlock,
         ];
 

packages/super-editor/src/editors/v1/core/super-converter/field-references/fld-preprocessors/section-pages-preprocessor.js

@@ -5,19 +5,19 @@ import { parsePageInstruction } from './page-instruction.js';
  *
  * @param {import('../../v2/types/index.js').OpenXmlNode[]} nodesToCombine The nodes between separate and end.
  * @param {string} [instrText] The SECTIONPAGES instruction text.
- * @param {unknown} [_docxOrFieldRunRPr] The parsed docx in the main import path, or w:rPr in header/footer-only preprocessing.
+ * @param {{ docx?: import('../../v2/docxHelper').ParsedDocx, instructionTokens?: Array<{type: string, text?: string}> | null, fieldRunRPr?: import('../../v2/types/index.js').OpenXmlNode | null } | import('../../v2/types/index.js').OpenXmlNode | null} [options] Generic field preprocessing options, or legacy positional w:rPr.
  * @param {Array<{type: string, text?: string}> | null} [_instructionTokens] Raw instruction tokens.
  * @param {import('../../v2/types/index.js').OpenXmlNode | null} [fieldRunRPr=null] The w:rPr node captured from field sequence nodes.
  * @returns {import('../../v2/types/index.js').OpenXmlNode[]}
  */
 export function preProcessSectionPagesInstruction(
   nodesToCombine,
   instrText = '',
-  _docxOrFieldRunRPr = null,
+  options = null,
   _instructionTokens,
   fieldRunRPr = null,
 ) {
-  const effectiveFieldRunRPr = fieldRunRPr ?? (_docxOrFieldRunRPr?.name === 'w:rPr' ? _docxOrFieldRunRPr : null);
+  const effectiveFieldRunRPr = fieldRunRPr ?? options?.fieldRunRPr ?? (options?.name === 'w:rPr' ? options : null);
   const parsedInstruction = parsePageInstruction(instrText, 'SECTIONPAGES');
   const sectionPageCountNode = {
     name: 'sd:sectionPageCount',