@willwade/aac-processors 0.2.3 → 0.2.4

package/dist/processors/astericsGridProcessor.js

@@ -613,7 +613,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                 });
             });
         }
-        catch (error) {
+        catch (_error) {
             // If JSON parsing fails, return empty array
         }
         return texts;
@@ -1029,7 +1029,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                 // Use detected format for filename
                 imageName = element.image.id || `image.${imageFormat}`;
             }
-            catch (e) {
+            catch (_e) {
                 // Invalid base64 data, skip image
             }
         }
@@ -1042,19 +1042,23 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             audioRecording: audioRecording,
             visibility: mapAstericsVisibility(element.hidden),
             image: imageName, // Store image filename/reference
-            parameters: imageData
-                ? {
-                    ...{ imageData: imageData }, // Store actual image data in parameters for conversion
-                }
-                : undefined,
             style: {
                 backgroundColor: finalBackgroundColor,
                 borderColor: colorStyles.borderColor || colorConfig?.elementBorderColor || '#CCCCCC',
                 borderWidth: colorConfig?.borderWidth || 1,
                 fontFamily: colorConfig?.fontFamily || 'Arial',
-                fontSize: colorConfig?.fontSizePct ? colorConfig.fontSizePct * 16 : 16, // Default to 16px
+                fontSize: colorConfig?.fontSizePct ? colorConfig.fontSizePct * 16 : 16,
                 fontColor: fontColor,
             },
+            wordForms: element.wordForms && element.wordForms.length > 0 ? element.wordForms : undefined,
+            parameters: {
+                ...(imageData ? { imageData: imageData } : {}),
+                ...(element.actions?.some((a) => a.modelName === 'GridActionWordForm')
+                    ? {
+                        wordFormActions: element.actions.filter((a) => a.modelName === 'GridActionWordForm'),
+                    }
+                    : {}),
+            },
         });
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
@@ -1321,6 +1325,11 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                     });
                 }
                 const locale = tree.metadata?.locale || 'en';
+                if (button.parameters?.wordFormActions &&
+                    Array.isArray(button.parameters.wordFormActions)) {
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+                    actions.push(...button.parameters.wordFormActions);
+                }
                 return {
                     id: button.id,
                     modelName: 'GridElement',
@@ -1330,7 +1339,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                     x: calculatedX,
                     y: calculatedY,
                     label: { [locale]: button.label },
-                    wordForms: [],
+                    wordForms: button.wordForms || [],
                     image: {
                         data: null,
                         author: undefined,
@@ -1422,7 +1431,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                             audioAction.durationMs = parsedMetadata.durationMs || audioAction.durationMs;
                             audioAction.filename = parsedMetadata.filename || audioAction.filename;
                         }
-                        catch (e) {
+                        catch (_e) {
                             // Use defaults if metadata parsing fails
                         }
                     }
@@ -1474,7 +1483,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                 });
             });
         }
-        catch (error) {
+        catch (_error) {
             // If JSON parsing fails, return empty array
         }
         return elementIds;
@@ -1499,7 +1508,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                 }
             }
         }
-        catch (error) {
+        catch (_error) {
             // If JSON parsing fails, return false
         }
         return false;

package/dist/processors/excelProcessor.js

@@ -309,7 +309,11 @@ class ExcelProcessor extends baseProcessor_1.BaseProcessor {
         // Create internal link to another worksheet
         const sanitizedTargetName = this.sanitizeWorksheetName(targetPageId);
         cell.value = {
-            text: cell.value?.toString() || '',
+            text: typeof cell.value === 'string'
+                ? cell.value
+                : typeof cell.value === 'number' || typeof cell.value === 'boolean'
+                    ? String(cell.value)
+                    : '',
             hyperlink: `#'${sanitizedTargetName}'!A1`,
         };
     }

package/dist/processors/gridset/helpers.js

@@ -84,7 +84,7 @@ async function openImage(gridsetBuffer, entryPath, password = (0, password_1.res
         }
         return data;
     }
-    catch (error) {
+    catch (_error) {
         return null;
     }
 }
@@ -174,7 +174,7 @@ function getCommonDocumentsPath() {
             return match[1].trim();
         }
     }
-    catch (error) {
+    catch (_error) {
         // Registry access failed, fall back to default
     }
     // Default fallback path
@@ -230,7 +230,7 @@ async function findGrid3UserPaths(fileAdapter = io_1.defaultFileAdapter) {
             }
         }
     }
-    catch (error) {
+    catch (_error) {
         // Silently fail if directory access fails
     }
     return results;

package/dist/processors/gridset/imageDebug.js

@@ -88,7 +88,7 @@ async function auditGridsetImages(gridsetBuffer, password = (0, password_2.resol
                             }
                         }
                     }
-                    catch (e) {
+                    catch (_e) {
                         // FileMap parsing failed, continue without it
                     }
                 }
@@ -169,7 +169,7 @@ async function auditGridsetImages(gridsetBuffer, password = (0, password_2.resol
                     }
                 }
             }
-            catch (e) {
+            catch (_e) {
                 // Skip grids that can't be processed
                 continue;
             }

package/dist/processors/gridsetProcessor.js

@@ -465,7 +465,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                 }
             }
         }
-        catch (e) {
+        catch (_e) {
             /* ignore: optional FileMap.xml may be missing or malformed */
         }
         // First, load styles from Settings0/Styles/styles.xml (Grid3 format)
@@ -536,7 +536,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                 const normalizedEntry = imageEntry.entryName.replace(/\\/g, '/');
                 imageDataCache.set(normalizedEntry, data);
             }
-            catch (err) {
+            catch (_err) {
                 // Silently fail - individual image loading failures shouldn't break the entire load
             }
         }
@@ -569,7 +569,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                         }
                     }
                 }
-                catch (e) {
+                catch (_e) {
                     // Skip errors in first pass
                 }
             }
@@ -584,7 +584,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                     xmlContent = (0, io_1.decodeText)(buffer);
                     console.log(`[Gridset] Raw XML content (first 200 chars) for ${entry.entryName}:`, xmlContent.substring(0, 200));
                 }
-                catch (e) {
+                catch (_e) {
                     // Skip unreadable files
                     continue;
                 }
@@ -943,6 +943,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                         // infer action type implicitly from commands; no explicit enum needed
                         let navigationTarget;
                         let detectedCommands = []; // Store detected command metadata
+                        let buttonPos; // Part-of-speech from Action.InsertText
                         const commands = content.Commands?.Command || content.commands?.command;
                         let predictionWords;
                         // Resolve image for this cell using FileMap and coordinate heuristics
@@ -1229,8 +1230,11 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                                         break;
                                     }
                                     case 'Action.InsertText': {
-                                        // speak
                                         const insertText = getParam('text');
+                                        const posParam = getParam('pos');
+                                        if (posParam) {
+                                            buttonPos = posParam;
+                                        }
                                         semanticAction = {
                                             category: treeStructure_1.AACSemanticCategory.COMMUNICATION,
                                             intent: treeStructure_1.AACSemanticIntent.INSERT_TEXT,
@@ -1238,7 +1242,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                                             platformData: {
                                                 grid3: {
                                                     commandId,
-                                                    parameters: { text: insertText },
+                                                    parameters: { text: insertText, pos: posParam },
                                                 },
                                             },
                                             fallback: {
@@ -1457,8 +1461,10 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                         }
                         // Extract grammar tags from commands (Smart Grammar)
                         const grammar = {};
+                        if (buttonPos)
+                            grammar.pos = buttonPos;
                         detectedCommands.forEach((cmd) => {
-                            if (cmd.parameters.pos)
+                            if (!grammar.pos && cmd.parameters.pos)
                                 grammar.pos = cmd.parameters.pos;
                             if (cmd.parameters.person)
                                 grammar.person = cmd.parameters.person;
@@ -1468,6 +1474,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                                 grammar.feature = cmd.parameters.feature;
                         });
                         const isSmartGrammarCell = Object.keys(grammar).length > 0;
+                        const effectivePos = buttonPos || grammar.pos || undefined;
                         const button = new treeStructure_1.AACButton({
                             id: `${gridId}_btn_${idx}`,
                             label: String(label),
@@ -1505,6 +1512,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                                 : gridPredictionWords.length > 0
                                     ? [...gridPredictionWords]
                                     : undefined,
+                            pos: effectivePos,
                             parameters: {
                                 pluginMetadata: pluginMetadata, // Store full plugin metadata for future use
                                 grid3Commands: detectedCommands, // Store detected command metadata
@@ -1676,7 +1684,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                 }
             }
         }
-        catch (e) {
+        catch (_e) {
             // If settings.xml parsing fails, tree.rootId will default to first page
         }
         // Set metadata on tree

package/dist/processors/obfProcessor.js

@@ -51,7 +51,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                     return null;
                 }
             }
-            catch (err) {
+            catch (_err) {
                 continue;
             }
         }
@@ -97,7 +97,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                         return dataUrl;
                     }
                 }
-                catch (err) {
+                catch (_err) {
                     // Continue to next path
                     continue;
                 }
@@ -321,7 +321,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                     return obj;
                 }
             }
-            catch (error) {
+            catch (_error) {
                 // Log parsing errors for debugging but don't throw
             }
             return null;
@@ -728,7 +728,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
             // eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/no-unsafe-return
             return require('../validation/obfValidator').ObfValidator;
         }
-        catch (error) {
+        catch (_error) {
             throw new Error('Validation utilities are not available in this environment.');
         }
     }

package/dist/processors/snap/helpers.js

@@ -37,7 +37,7 @@ async function collectFiles(root, matcher, maxDepth = 3, fileAdapter = io_1.defa
         try {
             entries = await listDir(current.dir);
         }
-        catch (error) {
+        catch (_error) {
             continue;
         }
         for (const entry of entries) {
@@ -143,7 +143,7 @@ async function openImage(dbOrFile, entryPath, fileAdapter = io_1.defaultFileAdap
                 const dir = dirname(dbPath);
                 await removePath(dir);
             }
-            catch (e) {
+            catch (_e) {
                 // Ignore cleanup errors
             }
         }
@@ -187,7 +187,7 @@ async function findSnapPackages(packageNamePattern = 'TobiiDynavox', fileAdapter
             }
         }
     }
-    catch (error) {
+    catch (_error) {
         // Silently fail if directory access fails
     }
     return results;

package/dist/processors/snapProcessor.js

@@ -218,7 +218,7 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
                             try {
                                 positions = JSON.parse(sg.SerializedGridPositions);
                             }
-                            catch (e) {
+                            catch (_e) {
                                 // Invalid JSON, skip this group
                                 return;
                             }
@@ -439,7 +439,7 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
                                 }
                             }
                         }
-                        catch (e) {
+                        catch (_e) {
                             // Ignore JSON parse errors in commands
                         }
                     }

package/dist/processors/touchchatProcessor.js

@@ -104,7 +104,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
                     idMappings.set(mapping.numeric_id, mapping.string_id);
                 });
             }
-            catch (e) {
+            catch (_e) {
                 // No mapping table, use numeric IDs as strings
             }
             // Load styles
@@ -122,7 +122,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
                     pageStyles.set(style.id, style);
                 });
             }
-            catch (e) {
+            catch (_e) {
                 // console.log('No styles found:', e);
             }
             // First, load all pages and get their names from resources
@@ -310,7 +310,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
                     }
                 });
             }
-            catch (e) {
+            catch (_e) {
                 // console.log('No button box cells found:', e);
             }
             // Load buttons directly linked to pages via resources
@@ -369,7 +369,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
                         page.addButton(button);
                 });
             }
-            catch (e) {
+            catch (_e) {
                 // console.log('No direct page buttons found:', e);
             }
             // Load navigation actions
@@ -416,7 +416,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
                     }
                 });
             }
-            catch (e) {
+            catch (_e) {
                 // console.log('No navigation actions found:', e);
             }
             // Try to load root ID from multiple sources in order of priority
@@ -457,7 +457,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
                     tree.metadata.defaultHomePageId = rootPageId;
                 }
             }
-            catch (e) {
+            catch (_e) {
                 // No metadata table or other error, use first page as root
                 if (rootPageId) {
                     tree.rootId = rootPageId;

package/dist/utilities/analytics/metrics/core.d.ts

@@ -39,6 +39,20 @@ export declare class MetricsCalculator {
      * Calculate what percentage of links to this board match semantic_id/clone_id
      */
     private calculateBoardLinkPercentages;
+    /**
+     * Quick check whether any button in the tree has a POS tag.
+     * Used to auto-enable smart grammar without requiring explicit opt-in.
+     */
+    private treeHasPosTags;
+    /**
+     * Expand morphological predictions from POS tags on buttons
+     *
+     * For each button that has a POS tag (e.g., 'Verb', 'Noun'), use the
+     * MorphologyEngine to generate inflected word forms and populate the
+     * button's predictions array. This is done as a pre-processing step
+     * before calculateWordFormMetrics assigns effort to each form.
+     */
+    private expandMorphologicalPredictions;
     /**
      * Calculate metrics for word forms (smart grammar predictions)
      *