@willwade/aac-processors 0.0.4 → 0.0.6

package/dist/processors/gridsetProcessor.js

@@ -56,7 +56,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                                     r: text,
                                 },
                                 {
-                                    r: { '__cdata': ' ' },
+                                    r: { __cdata: ' ' },
                                 },
                             ],
                         },
@@ -131,92 +131,85 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                     },
                 };
             case 'SPEAK_TEXT':
-            case 'SPEAK_IMMEDIATE':
-                // For communication buttons, insert text into message bar (sentence building)
-                // Grid3 requires explicit trailing space for automatic word spacing
-                // Use two <s> elements: one for the word, one for the space (CDATA preserves whitespace)
-                // Users can speak the complete sentence with a dedicated Speak button
-                {
-                    let text = semanticAction.text || button.message || button.label || '';
-                    // Remove trailing space from message if present (we'll add it as separate segment)
-                    if (text.endsWith(' ')) {
-                        text = text.slice(0, -1);
-                    }
-                    return {
-                        Command: {
-                            '@_ID': 'Action.InsertText',
-                            Parameter: {
-                                '@_Key': 'text',
-                                p: {
-                                    s: [
-                                        {
-                                            r: text,
-                                        },
-                                        {
-                                            r: { '__cdata': ' ' },
-                                        },
-                                    ],
-                                },
+            case 'SPEAK_IMMEDIATE': {
+                // Users can speak the complete sentence with a dedicated Speak button // Use two <s> elements: one for the word, one for the space (CDATA preserves whitespace) // Grid3 requires explicit trailing space for automatic word spacing // For communication buttons, insert text into message bar (sentence building)
+                let text = semanticAction.text || button.message || button.label || '';
+                // Remove trailing space from message if present (we'll add it as separate segment)
+                if (text.endsWith(' ')) {
+                    text = text.slice(0, -1);
+                }
+                return {
+                    Command: {
+                        '@_ID': 'Action.InsertText',
+                        Parameter: {
+                            '@_Key': 'text',
+                            p: {
+                                s: [
+                                    {
+                                        r: text,
+                                    },
+                                    {
+                                        r: { __cdata: ' ' },
+                                    },
+                                ],
                             },
                         },
-                    };
+                    },
+                };
+            }
+            case 'INSERT_TEXT': {
+                // Use two <s> elements: one for the word, one for the space (CDATA preserves whitespace) // Add trailing space for word buttons to enable sentence building
+                let text = semanticAction.text || button.message || button.label || '';
+                // Remove trailing space from message if present (we'll add it as separate segment)
+                if (text.endsWith(' ')) {
+                    text = text.slice(0, -1);
                 }
-            case 'INSERT_TEXT':
-                // Add trailing space for word buttons to enable sentence building
-                // Use two <s> elements: one for the word, one for the space (CDATA preserves whitespace)
-                {
-                    let text = semanticAction.text || button.message || button.label || '';
-                    // Remove trailing space from message if present (we'll add it as separate segment)
-                    if (text.endsWith(' ')) {
-                        text = text.slice(0, -1);
-                    }
-                    return {
-                        Command: {
-                            '@_ID': 'Action.InsertText',
-                            Parameter: {
-                                '@_Key': 'text',
-                                p: {
-                                    s: [
-                                        {
-                                            r: text,
-                                        },
-                                        {
-                                            r: { '__cdata': ' ' },
-                                        },
-                                    ],
-                                },
+                return {
+                    Command: {
+                        '@_ID': 'Action.InsertText',
+                        Parameter: {
+                            '@_Key': 'text',
+                            p: {
+                                s: [
+                                    {
+                                        r: text,
+                                    },
+                                    {
+                                        r: { __cdata: ' ' },
+                                    },
+                                ],
                             },
                         },
-                    };
-                }
-            default:
-                // Fallback to insert text with structured XML format
+                    },
+                };
+            }
+            default: {
                 // Use two <s> elements: one for the word, one for the space (CDATA preserves whitespace)
-                {
-                    let text = semanticAction.text || button.message || button.label || '';
-                    // Remove trailing space from message if present (we'll add it as separate segment)
-                    if (text.endsWith(' ')) {
-                        text = text.slice(0, -1);
-                    }
-                    return {
-                        Command: {
-                            '@_ID': 'Action.InsertText',
-                            Parameter: {
-                                '@_Key': 'text',
-                                p: {
-                                    s: [
-                                        {
-                                            r: text,
-                                        },
-                                        {
-                                            r: { '__cdata': ' ' },
-                                        },
-                                    ],
-                                },
+                // Fallback to insert text with structured XML format
+                let text = semanticAction.text || button.message || button.label || '';
+                // Remove trailing space from message if present (we'll add it as separate segment)
+                if (text.endsWith(' ')) {
+                    text = text.slice(0, -1);
+                }
+                return {
+                    Command: {
+                        '@_ID': 'Action.InsertText',
+                        Parameter: {
+                            '@_Key': 'text',
+                            p: {
+                                s: [
+                                    {
+                                        r: text,
+                                    },
+                                    {
+                                        r: { __cdata: ' ' },
+                                    },
+                                ],
                             },
                         },
-                    };
-                }
+                    },
+                };
+            }
         }
     }
     // Helper function to convert Grid 3 style to AACStyle
@@ -288,10 +281,8 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                 if (entries) {
                     const arr = Array.isArray(entries) ? entries : [entries];
                     for (const ent of arr) {
-                        const staticFile = (ent['@_StaticFile'] ||
-                            ent.StaticFile ||
-                            ent.staticFile ||
-                            '').replace(/\\/g, '/');
+                        const rawStaticFile = ent['@_StaticFile'] || ent.StaticFile || ent.staticFile;
+                        const staticFile = typeof rawStaticFile === 'string' ? rawStaticFile.replace(/\\/g, '/') : '';
                         if (!staticFile)
                             continue;
                         const df = ent.DynamicFiles || ent.dynamicFiles;
@@ -987,26 +978,22 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         const buttonImages = new Map();
         // Helper function to add style and return its ID
         const addStyle = (style) => {
-            if (!style || typeof style !== 'object')
-                return '';
-            const obj = style;
-            if (Object.keys(obj).length === 0)
+            if (!style)
                 return '';
-            const styleKey = JSON.stringify(obj);
+            const normalizedStyle = { ...style };
+            const styleKey = JSON.stringify(normalizedStyle);
             const existing = uniqueStyles.get(styleKey);
             if (existing)
                 return existing.id;
             const styleId = `Style${styleIdCounter++}`;
-            uniqueStyles.set(styleKey, { id: styleId, style: obj });
+            uniqueStyles.set(styleKey, { id: styleId, style: normalizedStyle });
             return styleId;
         };
         // Collect styles from all pages and buttons
         Object.values(tree.pages).forEach((page) => {
-            if (page.style)
-                addStyle(page.style);
+            addStyle(page.style);
             page.buttons.forEach((button) => {
-                if (button.style)
-                    addStyle(button.style);
+                addStyle(button.style);
             });
         });
         // Get the home/start grid from tree.rootId, fallback to first page
@@ -1053,8 +1040,8 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                     // When TileColour is present, BackColour is the surround (outer area)
                     // For "None" surround, just use BackColour for the fill (no TileColour)
                     BackColour: this.ensureAlphaChannel(style.backgroundColor),
-                    BorderColour: this.ensureAlphaChannel(style.borderColor) || '#000000FF',
-                    FontColour: this.ensureAlphaChannel(style.fontColor) || '#000000FF',
+                    BorderColour: this.ensureAlphaChannel(style.borderColor),
+                    FontColour: this.ensureAlphaChannel(style.fontColor),
                     FontName: style.fontFamily || 'Arial',
                     FontSize: style.fontSize?.toString() || '16',
                 };
@@ -1081,7 +1068,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         // Collect grid file paths for FileMap.xml
         const gridFilePaths = [];
         // Create a grid for each page
-        Object.values(tree.pages).forEach((page, index) => {
+        Object.values(tree.pages).forEach((page) => {
             const gridData = {
                 Grid: {
                     '@_xmlns:xsi': 'http://www.w3.org/2001/XMLSchema-instance',
@@ -1121,8 +1108,9 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                                     if (button.image) {
                                         // Try to determine file extension from image name or default to PNG
                                         let imageExt = 'png';
-                                        if (button.image.match(/\.(png|jpg|jpeg|gif|svg)$/i)) {
-                                            imageExt = button.image.match(/\.(png|jpg|jpeg|gif|svg)$/i)[1].toLowerCase();
+                                        const imageMatch = button.image.match(/\.(png|jpg|jpeg|gif|svg)$/i);
+                                        if (imageMatch) {
+                                            imageExt = imageMatch[1].toLowerCase();
                                         }
                                         // Grid3 dynamically constructs image filenames by prepending cell coordinates
                                         // The XML should only contain the suffix: -0-text-0.{ext}
@@ -1131,7 +1119,9 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                                         // Extract image data from button parameters if available
                                         // (AstericsGridProcessor stores it there during loadIntoTree)
                                         let imageData = Buffer.alloc(0);
-                                        if (button.parameters && button.parameters.imageData && Buffer.isBuffer(button.parameters.imageData)) {
+                                        if (button.parameters &&
+                                            button.parameters.imageData &&
+                                            Buffer.isBuffer(button.parameters.imageData)) {
                                             imageData = button.parameters.imageData;
                                         }
                                         // Store image data for later writing to ZIP
@@ -1182,7 +1172,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                                     }
                                     return cellData;
                                 }),
-                            ]
+                            ],
                         }
                         : { Cell: [] },
                 },
@@ -1202,7 +1192,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
             zip.addFile(gridPath, Buffer.from(xmlContent, 'utf8'));
         });
         // Write image files to ZIP
-        buttonImages.forEach((imgData, buttonId) => {
+        buttonImages.forEach((imgData) => {
             if (imgData.imageData && imgData.imageData.length > 0) {
                 // Create image path in the grid's directory
                 const imagePath = `Grids\\${imgData.pageName}\\${imgData.x}-${imgData.y}-0-text-0.${imgData.ext}`;
@@ -1221,7 +1211,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                         const imageFiles = [];
                         // Collect image filenames for buttons on this page
                         // IMPORTANT: FileMap.xml requires full paths like "Grids\PageName\1-5-0-text-0.png"
-                        buttonImages.forEach((imgData, buttonId) => {
+                        buttonImages.forEach((imgData) => {
                             if (imgData.pageName === gridName && imgData.imageData.length > 0) {
                                 const imagePath = `Grids\\${gridName}\\${imgData.x}-${imgData.y}-0-text-0.${imgData.ext}`;
                                 imageFiles.push(imagePath);
@@ -1229,9 +1219,11 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                         });
                         return {
                             '@_StaticFile': gridPath,
-                            DynamicFiles: imageFiles.length > 0 ? {
-                                File: imageFiles
-                            } : {},
+                            DynamicFiles: imageFiles.length > 0
+                                ? {
+                                    File: imageFiles,
+                                }
+                                : {},
                         };
                     }),
                 },

package/dist/processors/index.d.ts

@@ -11,5 +11,6 @@ export { getPageTokenImageMap, getAllowedImageEntries, openImage } from './grids
 export { getPageTokenImageMap as getGridsetPageTokenImageMap, getAllowedImageEntries as getGridsetAllowedImageEntries, openImage as openGridsetImage, } from './gridset/helpers';
 export { resolveGrid3CellImage } from './gridset/resolver';
 export { createWordlist, extractWordlists, updateWordlist, wordlistToXml, type WordList, type WordListItem, } from './gridset/wordlistHelpers';
+export { DEFAULT_GRID3_STYLES, CATEGORY_STYLES, ensureAlphaChannel, createDefaultStylesXml, createCategoryStyle, type Grid3Style, } from './gridset/styleHelpers';
 export { getPageTokenImageMap as getSnapPageTokenImageMap, getAllowedImageEntries as getSnapAllowedImageEntries, openImage as openSnapImage, } from './snap/helpers';
 export { getPageTokenImageMap as getTouchChatPageTokenImageMap, getAllowedImageEntries as getTouchChatAllowedImageEntries, openImage as openTouchChatImage, } from './touchchat/helpers';

package/dist/processors/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.openTouchChatImage = exports.getTouchChatAllowedImageEntries = exports.getTouchChatPageTokenImageMap = exports.openSnapImage = exports.getSnapAllowedImageEntries = exports.getSnapPageTokenImageMap = exports.wordlistToXml = exports.updateWordlist = exports.extractWordlists = exports.createWordlist = exports.resolveGrid3CellImage = exports.openGridsetImage = exports.getGridsetAllowedImageEntries = exports.getGridsetPageTokenImageMap = exports.openImage = exports.getAllowedImageEntries = exports.getPageTokenImageMap = exports.AstericsGridProcessor = exports.TouchChatProcessor = exports.SnapProcessor = exports.OpmlProcessor = exports.ObfProcessor = exports.GridsetProcessor = exports.ExcelProcessor = exports.DotProcessor = exports.ApplePanelsProcessor = void 0;
+exports.openTouchChatImage = exports.getTouchChatAllowedImageEntries = exports.getTouchChatPageTokenImageMap = exports.openSnapImage = exports.getSnapAllowedImageEntries = exports.getSnapPageTokenImageMap = exports.createCategoryStyle = exports.createDefaultStylesXml = exports.ensureAlphaChannel = exports.CATEGORY_STYLES = exports.DEFAULT_GRID3_STYLES = exports.wordlistToXml = exports.updateWordlist = exports.extractWordlists = exports.createWordlist = exports.resolveGrid3CellImage = exports.openGridsetImage = exports.getGridsetAllowedImageEntries = exports.getGridsetPageTokenImageMap = exports.openImage = exports.getAllowedImageEntries = exports.getPageTokenImageMap = exports.AstericsGridProcessor = exports.TouchChatProcessor = exports.SnapProcessor = exports.OpmlProcessor = exports.ObfProcessor = exports.GridsetProcessor = exports.ExcelProcessor = exports.DotProcessor = exports.ApplePanelsProcessor = void 0;
 var applePanelsProcessor_1 = require("./applePanelsProcessor");
 Object.defineProperty(exports, "ApplePanelsProcessor", { enumerable: true, get: function () { return applePanelsProcessor_1.ApplePanelsProcessor; } });
 var dotProcessor_1 = require("./dotProcessor");
@@ -36,6 +36,13 @@ Object.defineProperty(exports, "createWordlist", { enumerable: true, get: functi
 Object.defineProperty(exports, "extractWordlists", { enumerable: true, get: function () { return wordlistHelpers_1.extractWordlists; } });
 Object.defineProperty(exports, "updateWordlist", { enumerable: true, get: function () { return wordlistHelpers_1.updateWordlist; } });
 Object.defineProperty(exports, "wordlistToXml", { enumerable: true, get: function () { return wordlistHelpers_1.wordlistToXml; } });
+// Gridset (Grid 3) style helpers
+var styleHelpers_1 = require("./gridset/styleHelpers");
+Object.defineProperty(exports, "DEFAULT_GRID3_STYLES", { enumerable: true, get: function () { return styleHelpers_1.DEFAULT_GRID3_STYLES; } });
+Object.defineProperty(exports, "CATEGORY_STYLES", { enumerable: true, get: function () { return styleHelpers_1.CATEGORY_STYLES; } });
+Object.defineProperty(exports, "ensureAlphaChannel", { enumerable: true, get: function () { return styleHelpers_1.ensureAlphaChannel; } });
+Object.defineProperty(exports, "createDefaultStylesXml", { enumerable: true, get: function () { return styleHelpers_1.createDefaultStylesXml; } });
+Object.defineProperty(exports, "createCategoryStyle", { enumerable: true, get: function () { return styleHelpers_1.createCategoryStyle; } });
 // Snap helpers (stubs)
 var helpers_3 = require("./snap/helpers");
 Object.defineProperty(exports, "getSnapPageTokenImageMap", { enumerable: true, get: function () { return helpers_3.getPageTokenImageMap; } });

package/dist/processors/obfProcessor.d.ts

@@ -5,6 +5,8 @@ declare class ObfProcessor extends BaseProcessor {
     private processBoard;
     extractTexts(filePathOrBuffer: string | Buffer): string[];
     loadIntoTree(filePathOrBuffer: string | Buffer): AACTree;
+    private buildGridMetadata;
+    private createObfBoardFromPage;
     processTexts(filePathOrBuffer: string | Buffer, translations: Map<string, string>, outputPath: string): Buffer;
     saveFromTree(tree: AACTree, outputPath: string): void;
     /**

package/dist/processors/obfProcessor.js

@@ -9,12 +9,15 @@ const treeStructure_1 = require("../core/treeStructure");
 // Removed unused import: FileProcessor
 const adm_zip_1 = __importDefault(require("adm-zip"));
 const fs_1 = __importDefault(require("fs"));
+// Removed unused import: path
+const OBF_FORMAT_VERSION = 'open-board-0.1';
 class ObfProcessor extends baseProcessor_1.BaseProcessor {
     constructor(options) {
         super(options);
     }
     processBoard(boardData, _boardPath) {
-        const buttons = (boardData.buttons || []).map((btn) => {
+        const sourceButtons = boardData.buttons || [];
+        const buttons = sourceButtons.map((btn) => {
             const semanticAction = btn.load_board
                 ? {
                     category: treeStructure_1.AACSemanticCategory.NAVIGATION,
@@ -46,33 +49,62 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                 targetPageId: btn.load_board?.path,
             });
         });
+        const buttonMap = new Map(buttons.map((btn) => [btn.id, btn]));
         const page = new treeStructure_1.AACPage({
             id: String(boardData?.id || ''),
             name: String(boardData?.name || ''),
             grid: [],
             buttons,
             parentId: null,
+            locale: boardData.locale,
+            descriptionHtml: boardData.description_html,
+            images: boardData.images,
+            sounds: boardData.sounds,
         });
         // Process grid layout if available
         if (boardData.grid) {
-            const rows = boardData.grid.rows;
-            const cols = boardData.grid.columns;
-            const grid = Array(rows)
-                .fill(null)
-                .map(() => Array(cols).fill(null));
-            for (const btn of boardData.buttons) {
-                if (typeof btn.box_id === 'number') {
-                    const row = Math.floor(btn.box_id / cols);
-                    const col = btn.box_id % cols;
-                    if (row < rows && col < cols) {
-                        const aacBtn = buttons.find((b) => b.id === btn.id);
-                        if (aacBtn) {
-                            grid[row][col] = aacBtn;
+            const rows = typeof boardData.grid.rows === 'number'
+                ? boardData.grid.rows
+                : boardData.grid.order?.length || 0;
+            const cols = typeof boardData.grid.columns === 'number'
+                ? boardData.grid.columns
+                : boardData.grid.order
+                    ? boardData.grid.order.reduce((max, row) => Math.max(max, Array.isArray(row) ? row.length : 0), 0)
+                    : 0;
+            if (rows > 0 && cols > 0) {
+                const grid = Array.from({ length: rows }, () => Array.from({ length: cols }, () => null));
+                if (Array.isArray(boardData.grid.order) && boardData.grid.order.length) {
+                    boardData.grid.order.forEach((orderRow, rowIndex) => {
+                        if (!Array.isArray(orderRow))
+                            return;
+                        orderRow.forEach((cellId, colIndex) => {
+                            if (cellId === null || cellId === undefined)
+                                return;
+                            if (rowIndex >= rows || colIndex >= cols)
+                                return;
+                            const aacBtn = buttonMap.get(String(cellId));
+                            if (aacBtn) {
+                                grid[rowIndex][colIndex] = aacBtn;
+                            }
+                        });
+                    });
+                }
+                else {
+                    for (const btn of sourceButtons) {
+                        if (typeof btn.box_id === 'number') {
+                            const row = Math.floor(btn.box_id / cols);
+                            const col = btn.box_id % cols;
+                            if (row < rows && col < cols) {
+                                const aacBtn = buttonMap.get(String(btn.id));
+                                if (aacBtn) {
+                                    grid[row][col] = aacBtn;
+                                }
+                            }
                         }
                     }
                 }
+                page.grid = grid;
             }
-            page.grid = grid;
         }
         return page;
     }
@@ -123,9 +155,8 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         }
         // If input is a string path and ends with .obf, treat as JSON
         if (typeof filePathOrBuffer === 'string' && filePathOrBuffer.endsWith('.obf')) {
-            const fs = require('fs');
             try {
-                const content = fs.readFileSync(filePathOrBuffer, 'utf8');
+                const content = fs_1.default.readFileSync(filePathOrBuffer, 'utf8');
                 const boardData = tryParseObfJson(content);
                 if (boardData) {
                     console.log('[OBF] Detected .obf file, parsed as JSON');
@@ -186,6 +217,73 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         });
         return tree;
     }
+    buildGridMetadata(page) {
+        const buttonPositions = new Map();
+        const totalRows = Array.isArray(page.grid) ? page.grid.length : 0;
+        const totalColumns = totalRows > 0
+            ? page.grid.reduce((max, row) => Math.max(max, Array.isArray(row) ? row.length : 0), 0)
+            : 0;
+        if (totalRows === 0 || totalColumns === 0) {
+            if (!page.buttons.length) {
+                return { rows: 0, columns: 0, order: [], buttonPositions };
+            }
+            const fallbackRow = page.buttons.map((button, index) => {
+                const id = String(button.id ?? '');
+                buttonPositions.set(id, index);
+                return id;
+            });
+            return { rows: 1, columns: fallbackRow.length, order: [fallbackRow], buttonPositions };
+        }
+        const order = [];
+        for (let rowIndex = 0; rowIndex < totalRows; rowIndex++) {
+            const sourceRow = page.grid[rowIndex] || [];
+            const orderRow = [];
+            for (let colIndex = 0; colIndex < totalColumns; colIndex++) {
+                const cell = sourceRow[colIndex] || null;
+                if (cell) {
+                    const id = String(cell.id ?? '');
+                    orderRow.push(id);
+                    buttonPositions.set(id, rowIndex * totalColumns + colIndex);
+                }
+                else {
+                    orderRow.push(null);
+                }
+            }
+            order.push(orderRow);
+        }
+        return { rows: totalRows, columns: totalColumns, order, buttonPositions };
+    }
+    createObfBoardFromPage(page, fallbackName) {
+        const { rows, columns, order, buttonPositions } = this.buildGridMetadata(page);
+        const boardName = page.name || fallbackName;
+        return {
+            format: OBF_FORMAT_VERSION,
+            id: page.id,
+            locale: page.locale || 'en',
+            name: boardName,
+            description_html: page.descriptionHtml || boardName,
+            grid: {
+                rows,
+                columns,
+                order,
+            },
+            buttons: page.buttons.map((button) => ({
+                id: button.id,
+                label: button.label,
+                vocalization: button.message || button.label,
+                load_board: button.semanticAction?.intent === treeStructure_1.AACSemanticIntent.NAVIGATE_TO && button.targetPageId
+                    ? {
+                        path: button.targetPageId,
+                    }
+                    : undefined,
+                background_color: button.style?.backgroundColor,
+                border_color: button.style?.borderColor,
+                box_id: buttonPositions.get(String(button.id ?? '')),
+            })),
+            images: Array.isArray(page.images) ? page.images : [],
+            sounds: Array.isArray(page.sounds) ? page.sounds : [],
+        };
+    }
     processTexts(filePathOrBuffer, translations, outputPath) {
         // Load the tree, apply translations, and save to new file
         const tree = this.loadIntoTree(filePathOrBuffer);
@@ -193,15 +291,24 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
         Object.values(tree.pages).forEach((page) => {
             // Translate page names
             if (page.name && translations.has(page.name)) {
-                page.name = translations.get(page.name);
+                const translatedName = translations.get(page.name);
+                if (translatedName !== undefined) {
+                    page.name = translatedName;
+                }
             }
             // Translate button labels and messages
             page.buttons.forEach((button) => {
                 if (button.label && translations.has(button.label)) {
-                    button.label = translations.get(button.label);
+                    const translatedLabel = translations.get(button.label);
+                    if (translatedLabel !== undefined) {
+                        button.label = translatedLabel;
+                    }
                 }
                 if (button.message && translations.has(button.message)) {
-                    button.message = translations.get(button.message);
+                    const translatedMessage = translations.get(button.message);
+                    if (translatedMessage !== undefined) {
+                        button.message = translatedMessage;
+                    }
                 }
             });
         });
@@ -216,44 +323,14 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
             if (!rootPage) {
                 throw new Error('No pages to save');
             }
-            const obfBoard = {
-                id: rootPage.id,
-                name: rootPage.name || 'Exported Board',
-                buttons: rootPage.buttons.map((button) => ({
-                    id: button.id,
-                    label: button.label,
-                    vocalization: button.message || button.label,
-                    load_board: button.semanticAction?.intent === treeStructure_1.AACSemanticIntent.NAVIGATE_TO && button.targetPageId
-                        ? {
-                            path: button.targetPageId,
-                        }
-                        : undefined,
-                    background_color: button.style?.backgroundColor,
-                    border_color: button.style?.borderColor,
-                })),
-            };
+            const obfBoard = this.createObfBoardFromPage(rootPage, 'Exported Board');
             fs_1.default.writeFileSync(outputPath, JSON.stringify(obfBoard, null, 2));
         }
         else {
             // Save as OBZ (zip with multiple OBF files)
             const zip = new adm_zip_1.default();
             Object.values(tree.pages).forEach((page) => {
-                const obfBoard = {
-                    id: page.id,
-                    name: page.name || 'Board',
-                    buttons: page.buttons.map((button) => ({
-                        id: button.id,
-                        label: button.label,
-                        vocalization: button.message || button.label,
-                        load_board: button.semanticAction?.intent === treeStructure_1.AACSemanticIntent.NAVIGATE_TO && button.targetPageId
-                            ? {
-                                path: button.targetPageId,
-                            }
-                            : undefined,
-                        background_color: button.style?.backgroundColor,
-                        border_color: button.style?.borderColor,
-                    })),
-                };
+                const obfBoard = this.createObfBoardFromPage(page, 'Board');
                 const obfContent = JSON.stringify(obfBoard, null, 2);
                 zip.addFile(`${page.id}.obf`, Buffer.from(obfContent, 'utf8'));
             });

package/dist/processors/opmlProcessor.js

@@ -173,7 +173,18 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
                 .filter((b) => b.semanticAction?.intent === treeStructure_1.AACSemanticIntent.NAVIGATE_TO &&
                 !!b.targetPageId &&
                 !!tree.pages[b.targetPageId])
-                .map((b) => buildOutline(tree.pages[b.targetPageId], new Set(visited))); // Pass copy of visited set
+                .map((b) => {
+                const targetId = b.targetPageId;
+                if (!targetId) {
+                    return null;
+                }
+                const targetPage = tree.pages[targetId];
+                if (!targetPage) {
+                    return null;
+                }
+                return buildOutline(targetPage, new Set(visited));
+            })
+                .filter((childOutline) => childOutline !== null);
             if (childOutlines.length)
                 outline.outline = childOutlines;
             return outline;
@@ -206,8 +217,7 @@ class OpmlProcessor extends baseProcessor_1.BaseProcessor {
             },
         };
         // Convert to XML
-        const { XMLBuilder } = require('fast-xml-parser');
-        const builder = new XMLBuilder({
+        const builder = new fast_xml_parser_1.XMLBuilder({
             ignoreAttributes: false,
             format: true,
             indentBy: '    ',