@willwade/aac-processors 0.0.4 → 0.0.6

package/dist/processors/astericsGridProcessor.js

@@ -360,8 +360,26 @@ function getHighContrastNeutralColor(backgroundColor) {
     }
     return calculateLuminance(normalized) < 0.5 ? '#f5f5f5' : '#808080';
 }
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function normalizeStringRecord(input) {
+    if (!isRecord(input)) {
+        return undefined;
+    }
+    const entries = [];
+    Object.entries(input).forEach(([key, value]) => {
+        if (typeof value === 'string') {
+            entries.push([key, value]);
+        }
+    });
+    if (entries.length === 0) {
+        return undefined;
+    }
+    return Object.fromEntries(entries);
+}
 function normalizeColorScheme(raw) {
-    if (!raw || typeof raw !== 'object')
+    if (!isRecord(raw))
         return null;
     const scheme = raw;
     const nameCandidate = [scheme.name, scheme.key, scheme.id].find((value) => typeof value === 'string' && value.length > 0);
@@ -373,21 +391,22 @@ function normalizeColorScheme(raw) {
         categories = scheme.categories.filter((value) => typeof value === 'string');
         colors = scheme.colors.filter((value) => typeof value === 'string');
     }
-    else if (scheme.colorMap && typeof scheme.colorMap === 'object') {
-        categories = Object.keys(scheme.colorMap);
+    else if (isRecord(scheme.colorMap)) {
+        const colorMap = scheme.colorMap;
+        categories = Object.keys(colorMap);
         colors = categories.map((category) => {
-            const colorValue = scheme.colorMap[category];
+            const colorValue = colorMap[category];
             return typeof colorValue === 'string' ? colorValue : '#ffffff';
         });
     }
     if (!categories.length || !colors.length) {
         return null;
     }
-    const mappingsCandidate = (typeof scheme.mappings === 'object' && scheme.mappings) ||
-        (typeof scheme.categoryMappings === 'object' && scheme.categoryMappings) ||
-        (typeof scheme.categoryMapping === 'object' && scheme.categoryMapping) ||
+    const mappingsCandidate = normalizeStringRecord(scheme.mappings) ||
+        normalizeStringRecord(scheme.categoryMappings) ||
+        normalizeStringRecord(scheme.categoryMapping) ||
         undefined;
-    const customBordersCandidate = typeof scheme.customBorders === 'object' && scheme.customBorders ? scheme.customBorders : undefined;
+    const customBordersCandidate = normalizeStringRecord(scheme.customBorders);
     return {
         name: nameCandidate,
         categories,
@@ -397,11 +416,12 @@ function normalizeColorScheme(raw) {
     };
 }
 function getAllColorSchemeDefinitions(colorConfig) {
-    const additional = Array.isArray(colorConfig?.additionalColorSchemes)
+    const rawAdditional = Array.isArray(colorConfig?.additionalColorSchemes)
         ? colorConfig.additionalColorSchemes
-            .map((scheme) => normalizeColorScheme(scheme))
-            .filter((value) => Boolean(value))
         : [];
+    const additional = rawAdditional
+        .map((scheme) => normalizeColorScheme(scheme))
+        .filter((value) => Boolean(value));
     return [...DEFAULT_COLOR_SCHEME_DEFINITIONS, ...additional];
 }
 function getActiveColorSchemeDefinition(colorConfig) {
@@ -412,7 +432,8 @@ function getActiveColorSchemeDefinition(colorConfig) {
     if (!schemes.length) {
         return null;
     }
-    const activeName = (typeof colorConfig.activeColorScheme === 'string' && colorConfig.activeColorScheme) || undefined;
+    const activeName = (typeof colorConfig.activeColorScheme === 'string' && colorConfig.activeColorScheme) ||
+        undefined;
     const normalizedName = activeName ? COLOR_SCHEME_ALIASES[activeName] || activeName : undefined;
     if (normalizedName) {
         const match = schemes.find((scheme) => scheme.name === normalizedName);
@@ -435,11 +456,13 @@ function getSchemeColorForCategory(category, scheme, fallback) {
     const color = scheme.colors[index];
     return typeof color === 'string' ? color : fallback;
 }
-function resolveBorderColor(element, colorConfig, scheme, backgroundColor, schemeColor, fallbackBorder) {
+function resolveBorderColor(element, colorConfig = {}, scheme, backgroundColor, schemeColor, fallbackBorder) {
     const defaultBorderColor = (fallbackBorder || '#808080').toLowerCase();
-    const colorMode = colorConfig?.colorMode || 'COLOR_MODE_BACKGROUND';
+    const colorMode = typeof colorConfig.colorMode === 'string' ? colorConfig.colorMode : 'COLOR_MODE_BACKGROUND';
     if (colorMode === 'COLOR_MODE_BORDER') {
-        return (getSchemeColorForCategory(element.colorCategory, scheme, fallbackBorder || '#808080') || fallbackBorder || '#808080');
+        return (getSchemeColorForCategory(element.colorCategory, scheme, fallbackBorder || '#808080') ||
+            fallbackBorder ||
+            '#808080');
     }
     if (colorMode === 'COLOR_MODE_BOTH') {
         if (!element.colorCategory) {
@@ -459,22 +482,24 @@ function resolveBorderColor(element, colorConfig, scheme, backgroundColor, schem
     if (defaultBorderColor !== '#808080') {
         return fallbackBorder || '#808080';
     }
-    const gridBackground = colorConfig?.gridBackgroundColor || '#ffffff';
+    const gridBackground = typeof colorConfig.gridBackgroundColor === 'string'
+        ? colorConfig.gridBackgroundColor
+        : '#ffffff';
     return getHighContrastNeutralColor(gridBackground);
 }
-function resolveButtonColors(element, colorConfig, scheme) {
-    const fallbackBackground = colorConfig?.elementBackgroundColor || '#FFFFFF';
-    const fallbackBorder = colorConfig?.elementBorderColor || '#808080';
-    const colorMode = colorConfig?.colorMode || 'COLOR_MODE_BACKGROUND';
+function resolveButtonColors(element, colorConfig = {}, scheme) {
+    const fallbackBackground = typeof colorConfig.elementBackgroundColor === 'string'
+        ? colorConfig.elementBackgroundColor
+        : '#FFFFFF';
+    const fallbackBorder = typeof colorConfig.elementBorderColor === 'string' ? colorConfig.elementBorderColor : '#808080';
+    const colorMode = typeof colorConfig.colorMode === 'string' ? colorConfig.colorMode : 'COLOR_MODE_BACKGROUND';
     const isSchemeActive = colorConfig?.colorSchemesActivated !== false;
     const schemeColor = isSchemeActive && colorMode !== 'COLOR_MODE_BORDER'
         ? getSchemeColorForCategory(element.colorCategory, scheme || null)
         : undefined;
     const backgroundColor = element.backgroundColor || schemeColor || fallbackBackground || '#FFFFFF';
-    const borderColor = resolveBorderColor(element, colorConfig || {}, scheme || null, backgroundColor, schemeColor, fallbackBorder);
-    const fontColor = element.fontColor ||
-        colorConfig?.fontColor ||
-        getContrastingTextColor(backgroundColor);
+    const borderColor = resolveBorderColor(element, colorConfig, scheme || null, backgroundColor, schemeColor, fallbackBorder);
+    const fontColor = element.fontColor || colorConfig?.fontColor || getContrastingTextColor(backgroundColor);
     return {
         backgroundColor,
         borderColor,
@@ -584,9 +609,11 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         switch (action.modelName) {
             case 'GridActionSpeakCustom':
                 if (action.speakText && typeof action.speakText === 'object') {
-                    Object.values(action.speakText).forEach((text) => {
-                        if (text && typeof text === 'string')
-                            texts.push(text);
+                    const speakTextMap = action.speakText;
+                    Object.values(speakTextMap).forEach((textValue) => {
+                        if (typeof textValue === 'string' && textValue.length > 0) {
+                            texts.push(textValue);
+                        }
                     });
                 }
                 break;
@@ -632,7 +659,10 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         if (!grdFile.grids) {
             return tree;
         }
-        const colorConfig = grdFile.metadata?.colorConfig;
+        const rawColorConfig = grdFile.metadata?.colorConfig;
+        const colorConfig = isRecord(rawColorConfig)
+            ? rawColorConfig
+            : undefined;
         const activeColorSchemeDefinition = getActiveColorSchemeDefinition(colorConfig);
         // First pass: create all pages
         grdFile.grids.forEach((grid) => {
@@ -683,8 +713,9 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                 }
                 // Handle navigation relationships
                 const navAction = element.actions.find((a) => a.modelName === 'GridActionNavigate');
-                if (navAction && navAction.toGridId) {
-                    const targetPage = tree.getPage(navAction.toGridId);
+                const targetGridId = navAction && typeof navAction.toGridId === 'string' ? navAction.toGridId : undefined;
+                if (targetGridId) {
+                    const targetPage = tree.getPage(targetGridId);
                     if (targetPage) {
                         targetPage.parentId = page.id;
                     }
@@ -708,8 +739,18 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
     getLocalizedText(text) {
         if (typeof text === 'string')
             return text;
-        if (typeof text === 'object' && text) {
-            return text.en || text.de || text.es || Object.values(text)[0] || '';
+        if (isRecord(text)) {
+            const preferred = ['en', 'de', 'es'];
+            for (const lang of preferred) {
+                const value = text[lang];
+                if (typeof value === 'string' && value.length > 0) {
+                    return value;
+                }
+            }
+            const fallback = Object.values(text).find((value) => typeof value === 'string' && value.length > 0);
+            if (fallback) {
+                return fallback;
+            }
         }
         return '';
     }
@@ -717,32 +758,29 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         let audioRecording;
         if (this.loadAudio) {
             const audioAction = element.actions.find((a) => a.modelName === 'GridActionAudio');
-            if (audioAction && audioAction.dataBase64) {
+            if (audioAction && typeof audioAction.dataBase64 === 'string') {
+                const parsedId = Number.parseInt(String(audioAction.id), 10);
+                const metadata = {};
+                if (typeof audioAction.mimeType === 'string') {
+                    metadata.mimeType = audioAction.mimeType;
+                }
+                if (typeof audioAction.durationMs === 'number') {
+                    metadata.durationMs = audioAction.durationMs;
+                }
                 audioRecording = {
-                    id: parseInt(audioAction.id) || undefined,
+                    id: Number.isNaN(parsedId) ? undefined : parsedId,
                     data: Buffer.from(audioAction.dataBase64, 'base64'),
-                    identifier: audioAction.filename,
-                    metadata: JSON.stringify({
-                        mimeType: audioAction.mimeType,
-                        durationMs: audioAction.durationMs,
-                    }),
+                    identifier: typeof audioAction.filename === 'string' ? audioAction.filename : undefined,
+                    metadata: JSON.stringify(metadata),
                 };
             }
         }
         const colorStyles = resolveButtonColors(element, colorConfig, activeColorScheme);
         const navAction = element.actions.find((a) => a.modelName === 'GridActionNavigate');
-        const targetPageId = navAction ? navAction.toGridId : null;
-        // Determine button type based on actions
-        let buttonType = 'SPEAK';
-        if (targetPageId) {
-            buttonType = 'NAVIGATE';
-        }
+        const targetPageId = navAction && typeof navAction.toGridId === 'string' ? navAction.toGridId : null;
         const label = this.getLocalizedLabel(element.label);
         // Create semantic action from AstericsGrid element
         let semanticAction;
-        let legacyAction = null;
-        // Find the primary action
-        const primaryAction = element.actions[0]; // AstericsGrid typically has one primary action
         if (navAction && targetPageId) {
             semanticAction = {
                 category: treeStructure_1.AACSemanticCategory.NAVIGATION,
@@ -759,10 +797,6 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                     targetPageId: targetPageId,
                 },
             };
-            legacyAction = {
-                type: 'NAVIGATE',
-                targetPageId: targetPageId,
-            };
         }
         else {
             // Check for other action types
@@ -785,9 +819,6 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                                 message: 'Delete word',
                             },
                         };
-                        legacyAction = {
-                            type: 'DELETE_WORD',
-                        };
                         break;
                     case 'COLLECT_ACTION_REMOVE_CHAR':
                         semanticAction = {
@@ -804,9 +835,6 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                                 message: 'Delete character',
                             },
                         };
-                        legacyAction = {
-                            type: 'DELETE_CHARACTER',
-                        };
                         break;
                     case 'COLLECT_ACTION_CLEAR':
                         semanticAction = {
@@ -823,9 +851,6 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                                 message: 'Clear text',
                             },
                         };
-                        legacyAction = {
-                            type: 'CLEAR_TEXT',
-                        };
                         break;
                 }
             }
@@ -847,9 +872,6 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                                 message: 'Go back',
                             },
                         };
-                        legacyAction = {
-                            type: 'GO_BACK',
-                        };
                         break;
                     case 'TO_HOME':
                         semanticAction = {
@@ -866,9 +888,6 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                                 message: 'Go home',
                             },
                         };
-                        legacyAction = {
-                            type: 'GO_HOME',
-                        };
                         break;
                 }
             }
@@ -916,7 +935,10 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             }
         }
         // Determine the final background color
-        const finalBackgroundColor = element.backgroundColor || colorStyles.backgroundColor || colorConfig?.elementBackgroundColor || '#FFFFFF';
+        const finalBackgroundColor = element.backgroundColor ||
+            colorStyles.backgroundColor ||
+            colorConfig?.elementBackgroundColor ||
+            '#FFFFFF';
         // Determine font color with priority:
         // 1. Explicit element.fontColor (highest priority)
         // 2. Resolved color from color category
@@ -954,18 +976,18 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             id: element.id,
             label: label,
             message: label,
-            targetPageId: targetPageId,
+            targetPageId: targetPageId || undefined,
             semanticAction: semanticAction,
             audioRecording: audioRecording,
             image: imageName, // Store image filename/reference
-            parameters: imageData ? {
-                ...{ imageData: imageData } // Store actual image data in parameters for conversion
-            } : undefined,
+            parameters: imageData
+                ? {
+                    ...{ imageData: imageData }, // Store actual image data in parameters for conversion
+                }
+                : undefined,
             style: {
                 backgroundColor: finalBackgroundColor,
-                borderColor: colorStyles.borderColor ||
-                    colorConfig?.elementBorderColor ||
-                    '#CCCCCC',
+                borderColor: colorStyles.borderColor || colorConfig?.elementBorderColor || '#CCCCCC',
                 borderWidth: colorConfig?.borderWidth || 1,
                 fontFamily: colorConfig?.fontFamily || 'Arial',
                 fontSize: colorConfig?.fontSizePct ? colorConfig.fontSizePct * 16 : 16, // Default to 16px
@@ -996,7 +1018,10 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                 Object.keys(grid.label).forEach((lang) => {
                     const originalText = grid.label[lang];
                     if (originalText && translations.has(originalText)) {
-                        grid.label[lang] = translations.get(originalText);
+                        const translation = translations.get(originalText);
+                        if (translation !== undefined) {
+                            grid.label[lang] = translation;
+                        }
                     }
                 });
             }
@@ -1007,7 +1032,10 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                     Object.keys(element.label).forEach((lang) => {
                         const originalText = element.label[lang];
                         if (originalText && translations.has(originalText)) {
-                            element.label[lang] = translations.get(originalText);
+                            const translation = translations.get(originalText);
+                            if (translation !== undefined) {
+                                element.label[lang] = translation;
+                            }
                         }
                     });
                 }
@@ -1015,7 +1043,10 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                 if (element.wordForms) {
                     element.wordForms.forEach((wordForm) => {
                         if (wordForm.value && translations.has(wordForm.value)) {
-                            wordForm.value = translations.get(wordForm.value);
+                            const translation = translations.get(wordForm.value);
+                            if (translation !== undefined) {
+                                wordForm.value = translation;
+                            }
                         }
                     });
                 }
@@ -1030,12 +1061,13 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         switch (action.modelName) {
             case 'GridActionSpeakCustom':
                 if (action.speakText && typeof action.speakText === 'object') {
-                    Object.keys(action.speakText).forEach((lang) => {
-                        const originalText = action.speakText[lang];
+                    const speakTextMap = action.speakText;
+                    Object.keys(speakTextMap).forEach((lang) => {
+                        const originalText = speakTextMap[lang];
                         if (typeof originalText === 'string' && translations.has(originalText)) {
                             const translation = translations.get(originalText);
-                            if (translation) {
-                                action.speakText[lang] = translation;
+                            if (translation !== undefined) {
+                                speakTextMap[lang] = translation;
                             }
                         }
                     });
@@ -1044,13 +1076,13 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             case 'GridActionChangeLang':
                 if (typeof action.language === 'string' && translations.has(action.language)) {
                     const translation = translations.get(action.language);
-                    if (translation) {
+                    if (translation !== undefined) {
                         action.language = translation;
                     }
                 }
                 if (typeof action.voice === 'string' && translations.has(action.voice)) {
                     const translation = translations.get(action.voice);
-                    if (translation) {
+                    if (translation !== undefined) {
                         action.voice = translation;
                     }
                 }
@@ -1058,13 +1090,13 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             case 'GridActionHTTP':
                 if (typeof action.restUrl === 'string' && translations.has(action.restUrl)) {
                     const translation = translations.get(action.restUrl);
-                    if (translation) {
+                    if (translation !== undefined) {
                         action.restUrl = translation;
                     }
                 }
                 if (typeof action.body === 'string' && translations.has(action.body)) {
                     const translation = translations.get(action.body);
-                    if (translation) {
+                    if (translation !== undefined) {
                         action.body = translation;
                     }
                 }
@@ -1072,7 +1104,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             case 'GridActionOpenWebpage':
                 if (typeof action.openURL === 'string' && translations.has(action.openURL)) {
                     const translation = translations.get(action.openURL);
-                    if (translation) {
+                    if (translation !== undefined) {
                         action.openURL = translation;
                     }
                 }
@@ -1080,7 +1112,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             case 'GridActionMatrix':
                 if (typeof action.sendText === 'string' && translations.has(action.sendText)) {
                     const translation = translations.get(action.sendText);
-                    if (translation) {
+                    if (translation !== undefined) {
                         action.sendText = translation;
                     }
                 }

package/dist/processors/excelProcessor.d.ts

@@ -12,13 +12,13 @@ export declare class ExcelProcessor extends BaseProcessor {
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
      * @returns Array of all text content found in the Excel file
      */
-    extractTexts(filePathOrBuffer: string | Buffer): string[];
+    extractTexts(_filePathOrBuffer: string | Buffer): string[];
     /**
      * Load Excel file into AACTree structure
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
      * @returns AACTree representation of the Excel file
      */
-    loadIntoTree(filePathOrBuffer: string | Buffer): AACTree;
+    loadIntoTree(_filePathOrBuffer: string | Buffer): AACTree;
     /**
      * Process texts in Excel file (apply translations)
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
@@ -26,7 +26,7 @@ export declare class ExcelProcessor extends BaseProcessor {
      * @param outputPath - Path where translated Excel file should be saved
      * @returns Buffer containing the translated Excel file
      */
-    processTexts(filePathOrBuffer: string | Buffer, translations: Map<string, string>, outputPath: string): Buffer;
+    processTexts(_filePathOrBuffer: string | Buffer, _translations: Map<string, string>, outputPath: string): Buffer;
     /**
      * Convert an AAC page to an Excel worksheet
      * @param workbook - Excel workbook to add worksheet to