@willwade/aac-processors 0.0.22 → 0.0.24

package/README.md

@@ -267,30 +267,18 @@ console.log(`Average Effort: ${result.total_words}`);
 Validate AAC files against format specifications to ensure data integrity:
 
 ```typescript
-import { ObfProcessor, GridsetProcessor } from "aac-processors";
+import { validateFileOrBuffer, getValidatorForFile } from "@willwade/aac-processors/validation";
 
-// Validate OBF/OBZ files
-const obfProcessor = new ObfProcessor();
-const result = await obfProcessor.validate("board.obf");
-
-console.log(`Valid: ${result.valid}`);
-console.log(`Errors: ${result.errors}`);
-console.log(`Warnings: ${result.warnings}`);
-
-// Detailed validation results
-if (!result.valid) {
-  result.results
-    .filter((check) => !check.valid)
-    .forEach((check) => {
-      console.log(`✗ ${check.description}: ${check.error}`);
-    });
-}
+// Works in Node, Vite, and esbuild (pass Buffers from the browser/CLI)
+const fileName = "board.obf";
+const validator = getValidatorForFile(fileName);
+const bufferOrPath = new Uint8Array(await file.arrayBuffer()); // or fs path in Node
+const result = await validateFileOrBuffer(bufferOrPath, fileName);
 
-// Validate Gridset files (with optional password for encrypted files)
-const gridsetProcessor = new GridsetProcessor({
-  gridsetPassword: "optional-password",
+console.log(result.valid, result.errors, result.warnings);
+result.results.forEach((check) => {
+  if (!check.valid) console.log(`✗ ${check.description}: ${check.error}`);
 });
-const gridsetResult = await gridsetProcessor.validate("vocab.gridsetx");
 ```
 
 #### Using the CLI
@@ -312,11 +300,15 @@ aacprocessors validate board.gridsetx --gridset-password <password>
 #### What Gets Validated?
 
 - **OBF/OBZ**: Spec compliance (Open Board Format)
-  - Required fields (format, id, locale, buttons, grid, images, sounds)
-  - Grid structure (rows, columns, order)
-  - Button references (image_id, sound_id, load_board paths)
-  - Color formats (RGB/RGBA)
-  - Cross-reference validation
+- **Gridset/Gridsetx**: ZIP/XML structure, required Smartbox assets
+- **Snap**: ZIP/package content, settings/pages/images
+- **TouchChat**: ZIP structure, vocab metadata, nested boards
+- **Asterics (.grd)**: JSON parse, grids, elements, coordinates
+- **Excel (.xlsx/.xls)**: Workbook readability and worksheet content
+- **OPML**: XML validity and outline hierarchy
+- **DOT**: Graph nodes/edges present and text content
+- **Apple Panels (.plist/.ascconfig)**: PanelDefinitions presence and buttons
+- **OBFSet**: Bundled board layout checks
 
 - **Gridset**: XML structure
   - Required elements (gridset, pages, cells)
@@ -901,4 +893,4 @@ Want to help with any of these items? See our [Contributing Guidelines](#-contri
 
 ### Credits
 
-Some of the OBF work is directly from https://github.com/open-aac/obf and https://github.com/open-aac/aac-metrics - OBLA too https://www.openboardformat.org/logs 
+Some of the OBF work is directly from https://github.com/open-aac/obf and https://github.com/open-aac/aac-metrics - OBLA too https://www.openboardformat.org/logs 

package/dist/processors/applePanelsProcessor.js

@@ -10,6 +10,7 @@ const treeStructure_1 = require("../core/treeStructure");
 const plist_1 = __importDefault(require("plist"));
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+const validation_1 = require("../validation");
 function isNormalizedPanel(panel) {
     return typeof panel.id === 'string';
 }
@@ -92,145 +93,187 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
         return texts;
     }
     loadIntoTree(filePathOrBuffer) {
-        let content;
-        if (Buffer.isBuffer(filePathOrBuffer)) {
-            content = filePathOrBuffer.toString('utf8');
-        }
-        else if (typeof filePathOrBuffer === 'string') {
-            // Check if it's a .ascconfig folder or a direct .plist file
-            if (filePathOrBuffer.endsWith('.ascconfig')) {
-                // Read from proper Apple Panels structure: *.ascconfig/Contents/Resources/PanelDefinitions.plist
-                const panelDefsPath = `${filePathOrBuffer}/Contents/Resources/PanelDefinitions.plist`;
-                if (fs_1.default.existsSync(panelDefsPath)) {
-                    content = fs_1.default.readFileSync(panelDefsPath, 'utf8');
+        const filename = typeof filePathOrBuffer === 'string' ? path_1.default.basename(filePathOrBuffer) : 'upload.plist';
+        let buffer;
+        try {
+            if (Buffer.isBuffer(filePathOrBuffer)) {
+                buffer = filePathOrBuffer;
+            }
+            else if (typeof filePathOrBuffer === 'string') {
+                if (filePathOrBuffer.endsWith('.ascconfig')) {
+                    const panelDefsPath = `${filePathOrBuffer}/Contents/Resources/PanelDefinitions.plist`;
+                    if (fs_1.default.existsSync(panelDefsPath)) {
+                        buffer = fs_1.default.readFileSync(panelDefsPath);
+                    }
+                    else {
+                        const validation = (0, validation_1.buildValidationResultFromMessage)({
+                            filename,
+                            filesize: 0,
+                            format: 'applepanels',
+                            message: `Apple Panels file not found: ${panelDefsPath}`,
+                            type: 'missing',
+                            description: 'PanelDefinitions.plist',
+                        });
+                        throw new validation_1.ValidationFailureError('Apple Panels file not found', validation);
+                    }
                 }
                 else {
-                    throw new Error(`Apple Panels file not found: ${panelDefsPath}`);
+                    buffer = fs_1.default.readFileSync(filePathOrBuffer);
                 }
             }
             else {
-                // Fallback: treat as direct .plist file
-                content = fs_1.default.readFileSync(filePathOrBuffer, 'utf8');
-            }
-        }
-        else {
-            throw new Error('Invalid input: expected string path or Buffer');
-        }
-        const parsedData = plist_1.default.parse(content);
-        // Handle both old format (panels array) and new Apple Panels format (Panels dict)
-        let panelsData = [];
-        if (Array.isArray(parsedData.panels)) {
-            panelsData = parsedData.panels.map((panel, index) => {
-                if (isNormalizedPanel(panel)) {
-                    return panel;
-                }
-                const panelData = panel || {
-                    PanelObjects: [],
-                };
-                return normalizePanel(panelData, `panel_${index}`);
-            });
-        }
-        else if (parsedData.Panels) {
-            const panelsDict = parsedData.Panels;
-            panelsData = Object.keys(panelsDict).map((panelId) => {
-                const rawPanel = panelsDict[panelId] || { PanelObjects: [] };
-                return normalizePanel(rawPanel, panelId);
-            });
-        }
-        const data = { panels: panelsData };
-        const tree = new treeStructure_1.AACTree();
-        tree.metadata.format = 'applepanels';
-        data.panels.forEach((panel) => {
-            const page = new treeStructure_1.AACPage({
-                id: panel.id,
-                name: panel.name,
-                grid: [],
-                buttons: [],
-                parentId: null,
-            });
-            // Create a 2D grid to track button positions
-            const gridLayout = [];
-            const maxRows = 20; // Reasonable default for Apple Panels
-            const maxCols = 20;
-            for (let r = 0; r < maxRows; r++) {
-                gridLayout[r] = new Array(maxCols).fill(null);
+                const validation = (0, validation_1.buildValidationResultFromMessage)({
+                    filename,
+                    filesize: 0,
+                    format: 'applepanels',
+                    message: 'Invalid input: expected string path or Buffer',
+                    type: 'input',
+                    description: 'Apple Panels input',
+                });
+                throw new validation_1.ValidationFailureError('Invalid Apple Panels input', validation);
             }
-            panel.buttons.forEach((btn, idx) => {
-                // Create semantic action from Apple Panels button
-                let semanticAction;
-                if (btn.targetPanel) {
-                    semanticAction = {
-                        category: treeStructure_1.AACSemanticCategory.NAVIGATION,
-                        intent: treeStructure_1.AACSemanticIntent.NAVIGATE_TO,
-                        targetId: btn.targetPanel,
-                        platformData: {
-                            applePanels: {
-                                actionType: 'ActionOpenPanel',
-                                parameters: { PanelID: `USER.${btn.targetPanel}` },
-                            },
-                        },
-                        fallback: {
-                            type: 'NAVIGATE',
-                            targetPageId: btn.targetPanel,
-                        },
+            const content = buffer.toString('utf8');
+            const parsedData = plist_1.default.parse(content);
+            let panelsData = [];
+            if (Array.isArray(parsedData.panels)) {
+                panelsData = parsedData.panels.map((panel, index) => {
+                    if (isNormalizedPanel(panel)) {
+                        return panel;
+                    }
+                    const panelData = panel || {
+                        PanelObjects: [],
                     };
+                    return normalizePanel(panelData, `panel_${index}`);
+                });
+            }
+            else if (parsedData.Panels) {
+                const panelsDict = parsedData.Panels;
+                panelsData = Object.keys(panelsDict).map((panelId) => {
+                    const rawPanel = panelsDict[panelId] || { PanelObjects: [] };
+                    return normalizePanel(rawPanel, panelId);
+                });
+            }
+            if (panelsData.length === 0) {
+                const validation = (0, validation_1.buildValidationResultFromMessage)({
+                    filename,
+                    filesize: buffer.byteLength,
+                    format: 'applepanels',
+                    message: 'No panels found in Apple Panels file',
+                    type: 'structure',
+                    description: 'Panels definition',
+                });
+                throw new validation_1.ValidationFailureError('Apple Panels has no panels', validation);
+            }
+            const data = { panels: panelsData };
+            const tree = new treeStructure_1.AACTree();
+            tree.metadata.format = 'applepanels';
+            data.panels.forEach((panel) => {
+                const page = new treeStructure_1.AACPage({
+                    id: panel.id,
+                    name: panel.name,
+                    grid: [],
+                    buttons: [],
+                    parentId: null,
+                });
+                const gridLayout = [];
+                const maxRows = 20;
+                const maxCols = 20;
+                for (let r = 0; r < maxRows; r++) {
+                    gridLayout[r] = new Array(maxCols).fill(null);
                 }
-                else {
-                    semanticAction = {
-                        category: treeStructure_1.AACSemanticCategory.COMMUNICATION,
-                        intent: treeStructure_1.AACSemanticIntent.SPEAK_TEXT,
-                        text: btn.message || btn.label,
-                        platformData: {
-                            applePanels: {
-                                actionType: 'ActionPressKeyCharSequence',
-                                parameters: {
-                                    CharString: btn.message || btn.label || '',
-                                    isStickyKey: false,
+                panel.buttons.forEach((btn, idx) => {
+                    let semanticAction;
+                    if (btn.targetPanel) {
+                        semanticAction = {
+                            category: treeStructure_1.AACSemanticCategory.NAVIGATION,
+                            intent: treeStructure_1.AACSemanticIntent.NAVIGATE_TO,
+                            targetId: btn.targetPanel,
+                            platformData: {
+                                applePanels: {
+                                    actionType: 'ActionOpenPanel',
+                                    parameters: { PanelID: `USER.${btn.targetPanel}` },
                                 },
                             },
+                            fallback: {
+                                type: 'NAVIGATE',
+                                targetPageId: btn.targetPanel,
+                            },
+                        };
+                    }
+                    else {
+                        semanticAction = {
+                            category: treeStructure_1.AACSemanticCategory.COMMUNICATION,
+                            intent: treeStructure_1.AACSemanticIntent.SPEAK_TEXT,
+                            text: btn.message || btn.label,
+                            platformData: {
+                                applePanels: {
+                                    actionType: 'ActionPressKeyCharSequence',
+                                    parameters: {
+                                        CharString: btn.message || btn.label || '',
+                                        isStickyKey: false,
+                                    },
+                                },
+                            },
+                            fallback: {
+                                type: 'SPEAK',
+                                message: btn.message || btn.label,
+                            },
+                        };
+                    }
+                    const button = new treeStructure_1.AACButton({
+                        id: `${panel.id}_btn_${idx}`,
+                        label: btn.label,
+                        message: btn.message || btn.label,
+                        targetPageId: btn.targetPanel,
+                        semanticAction: semanticAction,
+                        style: {
+                            backgroundColor: btn.DisplayColor,
+                            fontSize: btn.FontSize,
+                            fontWeight: btn.DisplayImageWeight === 'bold' ? 'bold' : 'normal',
                         },
-                        fallback: {
-                            type: 'SPEAK',
-                            message: btn.message || btn.label,
-                        },
-                    };
-                }
-                const button = new treeStructure_1.AACButton({
-                    id: `${panel.id}_btn_${idx}`,
-                    label: btn.label,
-                    message: btn.message || btn.label,
-                    targetPageId: btn.targetPanel,
-                    semanticAction: semanticAction,
-                    style: {
-                        backgroundColor: btn.DisplayColor,
-                        fontSize: btn.FontSize,
-                        fontWeight: btn.DisplayImageWeight === 'bold' ? 'bold' : 'normal',
-                    },
-                });
-                page.addButton(button);
-                // Place button in grid layout using Rect position data
-                if (btn.Rect) {
-                    const rect = this.parseRect(btn.Rect);
-                    if (rect) {
-                        const gridPos = this.pixelToGrid(rect.x, rect.y);
-                        const gridWidth = Math.max(1, Math.ceil(rect.width / 25));
-                        const gridHeight = Math.max(1, Math.ceil(rect.height / 25));
-                        // Place button in grid (handle width/height span)
-                        for (let r = gridPos.gridY; r < gridPos.gridY + gridHeight && r < maxRows; r++) {
-                            for (let c = gridPos.gridX; c < gridPos.gridX + gridWidth && c < maxCols; c++) {
-                                if (gridLayout[r] && gridLayout[r][c] === null) {
-                                    gridLayout[r][c] = button;
+                    });
+                    page.addButton(button);
+                    if (btn.Rect) {
+                        const rect = this.parseRect(btn.Rect);
+                        if (rect) {
+                            const gridPos = this.pixelToGrid(rect.x, rect.y);
+                            const gridWidth = Math.max(1, Math.ceil(rect.width / 25));
+                            const gridHeight = Math.max(1, Math.ceil(rect.height / 25));
+                            for (let r = gridPos.gridY; r < gridPos.gridY + gridHeight && r < maxRows; r++) {
+                                for (let c = gridPos.gridX; c < gridPos.gridX + gridWidth && c < maxCols; c++) {
+                                    if (gridLayout[r] && gridLayout[r][c] === null) {
+                                        gridLayout[r][c] = button;
+                                    }
                                 }
                             }
                         }
                     }
-                }
+                });
+                page.grid = gridLayout;
+                tree.addPage(page);
             });
-            // Set the page's grid layout
-            page.grid = gridLayout;
-            tree.addPage(page);
-        });
-        return tree;
+            return tree;
+        }
+        catch (err) {
+            if (err instanceof validation_1.ValidationFailureError) {
+                throw err;
+            }
+            const validation = (0, validation_1.buildValidationResultFromMessage)({
+                filename,
+                filesize: Buffer.isBuffer(filePathOrBuffer)
+                    ? filePathOrBuffer.byteLength
+                    : typeof filePathOrBuffer === 'string'
+                        ? fs_1.default.existsSync(filePathOrBuffer)
+                            ? fs_1.default.statSync(filePathOrBuffer).size
+                            : 0
+                        : 0,
+                format: 'applepanels',
+                message: err?.message || 'Failed to parse Apple Panels file',
+                type: 'parse',
+                description: 'Parse Apple Panels plist',
+            });
+            throw new validation_1.ValidationFailureError('Failed to load Apple Panels file', validation, err);
+        }
     }
     processTexts(filePathOrBuffer, translations, outputPath) {
         // Load the tree, apply translations, and save to new file

package/dist/processors/astericsGridProcessor.js

@@ -12,6 +12,8 @@ exports.getContrastingTextColor = getContrastingTextColor;
 const baseProcessor_1 = require("../core/baseProcessor");
 const treeStructure_1 = require("../core/treeStructure");
 const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const validation_1 = require("../validation");
 const DEFAULT_COLOR_SCHEME_DEFINITIONS = [
     {
         name: 'CS_MODIFIED_FITZGERALD_KEY_VERY_LIGHT',
@@ -664,122 +666,136 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
     }
     loadIntoTree(filePathOrBuffer) {
         const tree = new treeStructure_1.AACTree();
-        let content = Buffer.isBuffer(filePathOrBuffer)
-            ? filePathOrBuffer.toString('utf-8')
-            : fs_1.default.readFileSync(filePathOrBuffer, 'utf-8');
-        // Remove BOM if present
-        if (content.charCodeAt(0) === 0xfeff) {
-            content = content.slice(1);
-        }
-        const grdFile = JSON.parse(content);
-        if (!grdFile.grids) {
-            return tree;
-        }
-        const rawColorConfig = grdFile.metadata?.colorConfig;
-        const colorConfig = isRecord(rawColorConfig)
-            ? rawColorConfig
-            : undefined;
-        const activeColorSchemeDefinition = getActiveColorSchemeDefinition(colorConfig);
-        // First pass: create all pages
-        grdFile.grids.forEach((grid) => {
-            const page = new treeStructure_1.AACPage({
-                id: grid.id,
-                name: this.getLocalizedLabel(grid.label) || grid.id,
-                grid: [],
-                buttons: [],
-                parentId: null,
-                style: {
-                    backgroundColor: colorConfig?.gridBackgroundColor || '#FFFFFF',
-                    borderColor: colorConfig?.elementBorderColor || '#CCCCCC',
-                    borderWidth: colorConfig?.borderWidth || 1,
-                    fontFamily: colorConfig?.fontFamily || 'Arial',
-                    fontSize: colorConfig?.fontSizePct ? colorConfig.fontSizePct * 16 : 16, // Convert percentage to pixels, default to 16
-                    fontColor: colorConfig?.fontColor || '#000000',
-                },
-            });
-            tree.addPage(page);
-        });
-        // Second pass: add buttons and establish navigation
-        grdFile.grids.forEach((grid) => {
-            const page = tree.getPage(grid.id);
-            if (!page)
-                return;
-            // Create a 2D grid to track button positions
-            const gridLayout = [];
-            const maxRows = Math.max(10, grid.rowCount || 10);
-            const maxCols = Math.max(10, grid.minColumnCount || 10);
-            for (let r = 0; r < maxRows; r++) {
-                gridLayout[r] = new Array(maxCols).fill(null);
+        const filename = typeof filePathOrBuffer === 'string' ? path_1.default.basename(filePathOrBuffer) : 'upload.grd';
+        const buffer = Buffer.isBuffer(filePathOrBuffer)
+            ? filePathOrBuffer
+            : fs_1.default.readFileSync(filePathOrBuffer);
+        try {
+            let content = buffer.toString('utf-8');
+            // Remove BOM if present
+            if (content.charCodeAt(0) === 0xfeff) {
+                content = content.slice(1);
             }
-            grid.gridElements.forEach((element) => {
-                const button = this.createButtonFromElement(element, colorConfig, activeColorSchemeDefinition);
-                page.addButton(button);
-                // Place button in grid layout using its x,y coordinates
-                const buttonX = element.x || 0;
-                const buttonY = element.y || 0;
-                const buttonWidth = element.width || 1;
-                const buttonHeight = element.height || 1;
-                // Place button in grid (handle width/height span)
-                for (let r = buttonY; r < buttonY + buttonHeight && r < maxRows; r++) {
-                    for (let c = buttonX; c < buttonX + buttonWidth && c < maxCols; c++) {
-                        if (gridLayout[r] && gridLayout[r][c] === null) {
-                            gridLayout[r][c] = button;
+            const grdFile = JSON.parse(content);
+            if (!grdFile.grids) {
+                const validationResult = (0, validation_1.buildValidationResultFromMessage)({
+                    filename,
+                    filesize: buffer.byteLength,
+                    format: 'asterics',
+                    message: 'Missing grids array in Asterics .grd file',
+                    type: 'structure',
+                    description: 'Asterics grid collection',
+                });
+                throw new validation_1.ValidationFailureError('Invalid Asterics grid file', validationResult);
+            }
+            const rawColorConfig = grdFile.metadata?.colorConfig;
+            const colorConfig = isRecord(rawColorConfig)
+                ? rawColorConfig
+                : undefined;
+            const activeColorSchemeDefinition = getActiveColorSchemeDefinition(colorConfig);
+            grdFile.grids.forEach((grid) => {
+                const page = new treeStructure_1.AACPage({
+                    id: grid.id,
+                    name: this.getLocalizedLabel(grid.label) || grid.id,
+                    grid: [],
+                    buttons: [],
+                    parentId: null,
+                    style: {
+                        backgroundColor: colorConfig?.gridBackgroundColor || '#FFFFFF',
+                        borderColor: colorConfig?.elementBorderColor || '#CCCCCC',
+                        borderWidth: colorConfig?.borderWidth || 1,
+                        fontFamily: colorConfig?.fontFamily || 'Arial',
+                        fontSize: colorConfig?.fontSizePct ? colorConfig.fontSizePct * 16 : 16,
+                        fontColor: colorConfig?.fontColor || '#000000',
+                    },
+                });
+                tree.addPage(page);
+            });
+            grdFile.grids.forEach((grid) => {
+                const page = tree.getPage(grid.id);
+                if (!page)
+                    return;
+                const gridLayout = [];
+                const maxRows = Math.max(10, grid.rowCount || 10);
+                const maxCols = Math.max(10, grid.minColumnCount || 10);
+                for (let r = 0; r < maxRows; r++) {
+                    gridLayout[r] = new Array(maxCols).fill(null);
+                }
+                grid.gridElements.forEach((element) => {
+                    const button = this.createButtonFromElement(element, colorConfig, activeColorSchemeDefinition);
+                    page.addButton(button);
+                    const buttonX = element.x || 0;
+                    const buttonY = element.y || 0;
+                    const buttonWidth = element.width || 1;
+                    const buttonHeight = element.height || 1;
+                    for (let r = buttonY; r < buttonY + buttonHeight && r < maxRows; r++) {
+                        for (let c = buttonX; c < buttonX + buttonWidth && c < maxCols; c++) {
+                            if (gridLayout[r] && gridLayout[r][c] === null) {
+                                gridLayout[r][c] = button;
+                            }
                         }
                     }
-                }
-                // Handle navigation relationships
-                const navAction = element.actions.find((a) => a.modelName === 'GridActionNavigate');
-                const targetGridId = navAction && typeof navAction.toGridId === 'string' ? navAction.toGridId : undefined;
-                if (targetGridId) {
-                    const targetPage = tree.getPage(targetGridId);
-                    if (targetPage) {
-                        targetPage.parentId = page.id;
+                    const navAction = element.actions.find((a) => a.modelName === 'GridActionNavigate');
+                    const targetGridId = navAction && typeof navAction.toGridId === 'string' ? navAction.toGridId : undefined;
+                    if (targetGridId) {
+                        const targetPage = tree.getPage(targetGridId);
+                        if (targetPage) {
+                            targetPage.parentId = page.id;
+                        }
                     }
-                }
+                });
+                page.grid = gridLayout;
             });
-            // Set the page's grid layout
-            page.grid = gridLayout;
-        });
-        // Set metadata for Asterics Grid files
-        const astericsMetadata = {
-            format: 'asterics',
-            hasGlobalGrid: false, // Can be extended in the future
-        };
-        if (grdFile.grids && grdFile.grids.length > 0) {
-            astericsMetadata.name = this.getLocalizedLabel(grdFile.grids[0].label);
-            // Extract all unique languages from all grids and elements
-            const languages = new Set();
-            grdFile.grids.forEach((grid) => {
-                if (grid.label) {
-                    Object.keys(grid.label).forEach((lang) => languages.add(lang));
-                }
-                grid.gridElements?.forEach((element) => {
-                    if (element.label) {
-                        Object.keys(element.label).forEach((lang) => languages.add(lang));
+            const astericsMetadata = {
+                format: 'asterics',
+                hasGlobalGrid: false,
+            };
+            if (grdFile.grids && grdFile.grids.length > 0) {
+                astericsMetadata.name = this.getLocalizedLabel(grdFile.grids[0].label);
+                const languages = new Set();
+                grdFile.grids.forEach((grid) => {
+                    if (grid.label) {
+                        Object.keys(grid.label).forEach((lang) => languages.add(lang));
                     }
-                    // Also check word forms for languages
-                    element.wordForms?.forEach((wf) => {
-                        if (wf.lang)
-                            languages.add(wf.lang);
+                    grid.gridElements?.forEach((element) => {
+                        if (element.label) {
+                            Object.keys(element.label).forEach((lang) => languages.add(lang));
+                        }
+                        element.wordForms?.forEach((wf) => {
+                            if (wf.lang)
+                                languages.add(wf.lang);
+                        });
                     });
                 });
-            });
-            if (languages.size > 0) {
-                astericsMetadata.languages = Array.from(languages).sort();
-                // Set primary locale to English if available, otherwise the first language found
-                astericsMetadata.locale = languages.has('en')
-                    ? 'en'
-                    : languages.has('de')
-                        ? 'de'
-                        : astericsMetadata.languages[0];
+                if (languages.size > 0) {
+                    astericsMetadata.languages = Array.from(languages).sort();
+                    astericsMetadata.locale = languages.has('en')
+                        ? 'en'
+                        : languages.has('de')
+                            ? 'de'
+                            : astericsMetadata.languages[0];
+                }
+            }
+            tree.metadata = astericsMetadata;
+            if (grdFile.metadata && grdFile.metadata.homeGridId) {
+                tree.rootId = grdFile.metadata.homeGridId;
             }
+            return tree;
         }
-        tree.metadata = astericsMetadata;
-        // Set the home page from metadata.homeGridId
-        if (grdFile.metadata && grdFile.metadata.homeGridId) {
-            tree.rootId = grdFile.metadata.homeGridId;
+        catch (err) {
+            if (err instanceof validation_1.ValidationFailureError) {
+                throw err;
+            }
+            const validationResult = (0, validation_1.buildValidationResultFromMessage)({
+                filename,
+                filesize: buffer.byteLength,
+                format: 'asterics',
+                message: err?.message || 'Failed to parse Asterics grid file',
+                type: 'parse',
+                description: 'Parse Asterics grid JSON',
+            });
+            throw new validation_1.ValidationFailureError('Failed to load Asterics grid', validationResult, err);
         }
-        return tree;
     }
     getLocalizedLabel(labelMap) {
         if (!labelMap)