fix(sequence-field): preserve cached numbering for lowercase seq fields

Only dispatch the SEQ pre-processor for uppercase SEQ instructions so
lowercase `seq` fields keep their cached visible result runs instead of
being re-resolved. Also recurse into run-wrapped content when extracting
resolved text so cached numbers nested inside runs are captured.

Author: luccas-harbour

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

@@ -31,6 +31,9 @@ import { extractFieldKeyword } from '../field-keyword.js';
  * @returns {InstructionPreProcessor | null} The pre-processor function or null if not found.
  */
 export const getInstructionPreProcessor = (instruction) => {
+  const rawInstructionType = String(instruction ?? '')
+    .trim()
+    .split(/\s+/)[0];
   const instructionType = extractFieldKeyword(instruction);
   switch (instructionType) {
     case 'PAGE':
@@ -59,6 +62,7 @@ export const getInstructionPreProcessor = (instruction) => {
     case 'STYLEREF':
       return preProcessStylerefInstruction;
     case 'SEQ':
+      if (rawInstructionType !== 'SEQ') return null;
       return preProcessSeqInstruction;
     case 'CITATION':
       return preProcessCitationInstruction;

packages/super-editor/src/editors/v1/core/super-converter/field-references/fld-preprocessors/index.test.js

@@ -7,6 +7,7 @@ import { preProcessPageRefInstruction } from './page-ref-preprocessor.js';
 import { preProcessHyperlinkInstruction } from './hyperlink-preprocessor.js';
 import { preProcessTocInstruction } from './toc-preprocessor.js';
 import { preProcessRefInstruction } from './ref-preprocessor.js';
+import { preProcessSeqInstruction } from './seq-preprocessor.js';
 
 describe('getInstructionPreProcessor', () => {
   const mockDocx = {
@@ -67,6 +68,16 @@ describe('getInstructionPreProcessor', () => {
     expect(processor).toBe(expectedProcessor);
   });
 
+  it('should dispatch uppercase SEQ fields', () => {
+    const processor = getInstructionPreProcessor('SEQ Figure \\* ARABIC');
+    expect(processor).toBe(preProcessSeqInstruction);
+  });
+
+  it('should leave lowercase seq fields unprocessed to preserve cached numbering results', () => {
+    const processor = getInstructionPreProcessor('seq level2 \\*arabic');
+    expect(processor).toBeNull();
+  });
+
   it('should return preProcessTocInstruction for TOC instruction', () => {
     const instruction = 'TOC \\o "1-3" \\h \\z \\u';
     const processor = getInstructionPreProcessor(instruction);

packages/super-editor/src/editors/v1/core/super-converter/field-references/preProcessNodesForFldChar.test.js

@@ -120,6 +120,17 @@ describe('preProcessNodesForFldChar', () => {
     ]);
   });
 
+  it('should preserve cached visible result runs for lowercase seq fields', () => {
+    const { processedNodes } = preProcessNodesForFldChar(complexFieldNodes('seq level2 \\*arabic', '1'), mockDocx);
+
+    expect(processedNodes).toHaveLength(5);
+    expect(processedNodes.some((node) => node.name === 'sd:sequenceField')).toBe(false);
+    expect(processedNodes[3]).toEqual({
+      name: 'w:r',
+      elements: [{ name: 'w:t', elements: [{ type: 'text', text: '1' }] }],
+    });
+  });
+
   it('should handle nested fields (PAGEREF within HYPERLINK)', () => {
     const nodes = [
       { name: 'w:r', elements: [{ name: 'w:fldChar', attributes: { 'w:fldCharType': 'begin' } }] },

packages/super-editor/src/editors/v1/core/super-converter/v3/handlers/sd/sequenceField/sequence-field-export-routing.test.js

@@ -1,6 +1,7 @@
 import { describe, expect, it } from 'vitest';
 import { exportSchemaToJson } from '../../../../exporter.js';
 import { translator as runTranslator } from '../../w/r/r-translator.js';
+import { translator as sequenceFieldTranslator } from './sequenceField-translator.js';
 
 const SEQUENCE_FIELD_INSTRUCTION = 'SEQ Figure \\* ARABIC';
 
@@ -30,6 +31,28 @@ function hasFieldCharType(node, fieldType) {
 }
 
 describe('sequenceField export routing', () => {
+  it('extracts cached result text from run-wrapped field content', () => {
+    const encoded = sequenceFieldTranslator.encode({
+      nodes: [
+        {
+          name: 'sd:sequenceField',
+          attributes: { instruction: 'seq level2 \\*arabic' },
+          elements: [
+            {
+              type: 'run',
+              content: [{ type: 'text', text: '1', marks: [] }],
+            },
+          ],
+        },
+      ],
+      nodeListHandler: {
+        handler: () => [{ type: 'run', content: [{ type: 'text', text: '1', marks: [] }] }],
+      },
+    });
+
+    expect(encoded.attrs.resolvedNumber).toBe('1');
+  });
+
   it('exports sequenceField nodes as fldChar + instrText runs', () => {
     const exported = exportSchemaToJson({
       node: buildSequenceFieldNode(),

packages/super-editor/src/editors/v1/core/super-converter/v3/handlers/sd/sequenceField/sequenceField-translator.js

@@ -113,10 +113,17 @@ function parseSeqInstruction(instruction) {
  */
 function extractResolvedText(content) {
   if (!Array.isArray(content)) return '';
-  return content
-    .filter((n) => n.type === 'text')
-    .map((n) => n.text || '')
-    .join('');
+  let text = '';
+  for (const node of content) {
+    if (!node) continue;
+    if (node.type === 'text') {
+      text += node.text || '';
+    }
+    if (Array.isArray(node.content)) {
+      text += extractResolvedText(node.content);
+    }
+  }
+  return text;
 }
 
 /** @type {import('@translator').NodeTranslatorConfig} */