@willwade/aac-processors 0.2.4 → 0.2.6

package/dist/browser/utilities/analytics/metrics/core.js

@@ -804,6 +804,10 @@ export class MetricsCalculator {
                     }
                     if (!parentMetrics)
                         return;
+                    // Build set of original Suggest Words predictions (from Prediction.PredictThis).
+                    // These require an extra confirmation tap from the user. Smart grammar
+                    // morphology outcomes are generated automatically and need no extra tap.
+                    const suggestWordsSet = new Set((btn.parameters?.predictions || []).map((w) => w.toLowerCase()));
                     // Calculate effort for each word form
                     btn.predictions.forEach((wordForm, index) => {
                         const wordFormLower = wordForm.toLowerCase();
@@ -816,8 +820,14 @@ export class MetricsCalculator {
                         // Using similar logic to button scanning effort
                         const predictionPriorItems = predictionRowIndex * predictionsGridCols + predictionColIndex;
                         const predictionSelectionEffort = visualScanEffort(predictionPriorItems);
-                        // Word form effort = parent button's cumulative effort + selection effort
-                        const wordFormEffort = parentMetrics.effort + predictionSelectionEffort;
+                        // Add confirmation cost for Suggest Words outcomes only.
+                        // Suggest Words requires an explicit tap on the prediction bar,
+                        // while smart grammar morphology forms are auto-generated (no extra tap).
+                        const suggestWordsConfirmation = suggestWordsSet.has(wordFormLower)
+                            ? EFFORT_CONSTANTS.SUGGEST_WORDS_SELECTION_EFFORT
+                            : 0;
+                        // Word form effort = parent button's cumulative effort + selection effort + confirmation
+                        const wordFormEffort = parentMetrics.effort + predictionSelectionEffort + suggestWordsConfirmation;
                         // Check if this word already exists as a regular button
                         const existingBtn = existingLabels.get(wordFormLower);
                         // If word exists and has lower or equal effort, skip the word form
@@ -838,9 +848,10 @@ export class MetricsCalculator {
                             semantic_id: parentMetrics.semantic_id,
                             clone_id: parentMetrics.clone_id,
                             temporary_home_id: parentMetrics.temporary_home_id,
-                            is_word_form: true, // Mark this as a word form metric
-                            parent_button_id: btn.id, // Track parent button
-                            parent_button_label: parentMetrics.label, // Track parent label
+                            is_word_form: true,
+                            is_suggest_words: suggestWordsSet.has(wordFormLower) || undefined,
+                            parent_button_id: btn.id,
+                            parent_button_label: parentMetrics.label,
                         };
                         wordFormMetrics.push(wordFormBtn);
                         existingLabels.set(wordFormLower, wordFormBtn);

package/dist/browser/utilities/analytics/metrics/effort.js

@@ -31,6 +31,7 @@ export const EFFORT_CONSTANTS = {
     SCAN_SELECTION_COST: 0.1, // Cost of a switch selection
     DEFAULT_SCAN_ERROR_RATE: 0.1, // 10% chance of missing a selection
     SCAN_RETRY_PENALTY: 1.0, // Cost multiplier for a full loop retry
+    SUGGEST_WORDS_SELECTION_EFFORT: 0.5, // Extra tap to confirm a Suggest Words prediction
 };
 /**
  * Calculate button size effort based on grid dimensions