Merge personalisation WordList into Grid 3

Process WordList items attached to a page (from personalisation) and merge them into the existing Grid.WordList.Items.WordListItem array. Checks for a known symbol key ('wordListItems'), handles casing variations of existing items, ensures an array, and appends new items in Grid 3 format (Text.p.s.r, Image as '', PartOfSpeech 'Unknown'). Skips processing if there is no existing WordList.Items to avoid creating new cells.

Author: willwade

src/processors/gridsetProcessor.ts

@@ -2760,6 +2760,40 @@ class GridsetProcessor extends BaseProcessor {
         }
       }
 
+      // Process WordList items attached to the page (from personalisation)
+      // These are tracked separately and shouldn't create new cells
+      // Use a known symbol key to check for WordList items
+      const WORDLIST_ITEMS_KEY = 'wordListItems';
+      const wordListItems = (page as any)[WORDLIST_ITEMS_KEY] as
+        | Array<{ label: string; message: string }>
+        | undefined;
+
+      if (wordListItems && wordListItems.length > 0 && originalGrid.Grid?.WordList?.Items) {
+        const existingItems =
+          originalGrid.Grid.WordList.Items.WordListItem ||
+          originalGrid.Grid.WordList.Items.wordlistitem ||
+          [];
+        const itemsArray = Array.isArray(existingItems) ? existingItems : [existingItems];
+
+        // Add new WordList items with proper Grid 3 format
+        for (const item of wordListItems) {
+          itemsArray.push({
+            Text: {
+              p: {
+                s: {
+                  r: item.label,
+                },
+              },
+            },
+            Image: '',
+            PartOfSpeech: 'Unknown',
+          });
+        }
+
+        // Update the WordList
+        originalGrid.Grid.WordList.Items.WordListItem = itemsArray;
+      }
+
       // Build the updated grid XML and format for Grid 3 compatibility
       let builtXml = gridBuilder.build(originalGrid);
       builtXml = formatGrid3XmlComplete(builtXml);