@willwade/aac-processors 0.2.5 → 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

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

@@ -807,6 +807,10 @@ 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();
@@ -819,8 +823,14 @@ class MetricsCalculator {
                         // Using similar logic to button scanning effort
                         const predictionPriorItems = predictionRowIndex * predictionsGridCols + predictionColIndex;
                         const predictionSelectionEffort = (0, effort_1.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_1.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
@@ -841,9 +851,10 @@ 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/utilities/analytics/metrics/effort.d.ts

@@ -31,6 +31,7 @@ export declare const EFFORT_CONSTANTS: {
     readonly SCAN_SELECTION_COST: 0.1;
     readonly DEFAULT_SCAN_ERROR_RATE: 0.1;
     readonly SCAN_RETRY_PENALTY: 1;
+    readonly SUGGEST_WORDS_SELECTION_EFFORT: 0.5;
 };
 /**
  * Calculate button size effort based on grid dimensions

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

@@ -47,6 +47,7 @@ exports.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

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

@@ -19,6 +19,7 @@ export interface ButtonMetrics {
     comp_level?: number;
     comp_effort?: number;
     is_word_form?: boolean;
+    is_suggest_words?: boolean;
     parent_button_id?: string;
     parent_button_label?: string;
     pos?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@willwade/aac-processors",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "A comprehensive TypeScript library for processing AAC (Augmentative and Alternative Communication) file formats with translation support",
   "main": "dist/index.js",
   "browser": "dist/browser/index.browser.js",