A new callback function added on Crossword Provider

package.json

@@ -16,7 +16,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/JaredReisinger/react-crossword"
+    "url": "https://github.com/JaredReisinger/react-crossword.git"
   },
   "license": "MIT",
   "engines": {

src/CrosswordProvider.tsx

@@ -161,6 +161,15 @@ export const crosswordProviderPropTypes = {
    */
   onCellChange: PropTypes.func,
 
+  /**
+   * callback function called when a cell is selected(e.g. when the user selects a
+   * cell); called with  `(direction, number, row, cols)` arguments, where the `direction`
+   * is the current direction, `number` is the index of the clue and `row` and `col` are
+   *  the 0-based position of the cell
+   */
+
+  onCellSelected: PropTypes.func,
+
   /**
    * callback function called when a clue is selected
    */
@@ -265,6 +274,19 @@ export type CrosswordProviderProps = EnhancedProps<
      */
     onCellChange?: (row: number, col: number, char: string) => void;
 
+    /**
+     * callback function called when a cell is selected(e.g. when the user selects a
+     * cell); called with  `(direction, number, row, cols)` arguments, where the `direction`
+     * is the current direction, `number` is the index of the clue and `row` and `col` are
+     *  the 0-based position of the cell
+     */
+    onCellSelected?: (
+      direction: Direction,
+      number: string | undefined,
+      row: number,
+      col: number
+    ) => void;
+
     /**
      * callback function called when a clue is selected
      */
@@ -339,6 +361,7 @@ const CrosswordProvider = React.forwardRef<
       onCrosswordComplete,
       onCrosswordCorrect,
       onCellChange,
+      onCellSelected,
       onClueSelected,
       useStorage,
       storageKey,
@@ -626,9 +649,13 @@ const CrosswordProvider = React.forwardRef<
         setCurrentDirection(direction);
         setCurrentNumber(candidate[direction] ?? '');
 
+        if (onCellSelected) {
+          onCellSelected(direction, candidate[direction] ?? '', row, col);
+        }
+
         return candidate;
       },
-      [currentDirection, getCellData]
+      [currentDirection, getCellData, onCellSelected]
     );
 
     const moveRelative = useCallback(
@@ -714,6 +741,15 @@ const CrosswordProvider = React.forwardRef<
               setCurrentDirection(other);
               setCurrentNumber(cellData[other] ?? '');
             }
+
+            if (onCellSelected) {
+              onCellSelected(
+                other,
+                cellData[other] ?? '',
+                focusedRow,
+                focusedCol
+              );
+            }
             break;
           }
 
@@ -778,6 +814,7 @@ const CrosswordProvider = React.forwardRef<
         data,
         currentNumber,
         moveTo,
+        onCellSelected,
       ]
     );
 
@@ -886,11 +923,15 @@ const CrosswordProvider = React.forwardRef<
           }
 
           setCurrentNumber(cellData[direction] ?? '');
+
+          if (onCellSelected) {
+            onCellSelected(direction, cellData[direction] ?? '', row, col);
+          }
         }
 
         focus();
       },
-      [currentDirection, focus, focused, focusedCol, focusedRow]
+      [currentDirection, focus, focused, focusedCol, focusedRow, onCellSelected]
     );
 
     const handleInputClick = useCallback<
@@ -915,8 +956,25 @@ const CrosswordProvider = React.forwardRef<
 
         setCurrentNumber(cellData[direction] ?? '');
         focus();
+
+        if (onCellSelected) {
+          onCellSelected(
+            direction,
+            cellData[direction] ?? '',
+            focusedCol,
+            focusedRow
+          );
+        }
       },
-      [currentDirection, focus, focused, focusedCol, focusedRow, getCellData]
+      [
+        currentDirection,
+        focus,
+        focused,
+        focusedCol,
+        focusedRow,
+        getCellData,
+        onCellSelected,
+      ]
     );
 
     const handleClueSelected = useCallback(
@@ -1132,6 +1190,7 @@ CrosswordProvider.defaultProps = {
   onCrosswordComplete: undefined,
   onCrosswordCorrect: undefined,
   onCellChange: undefined,
+  onCellSelected: undefined,
   onClueSelected: undefined,
   children: undefined,
 };

src/context.ts

@@ -35,6 +35,7 @@ export interface CrosswordContextType {
   handleInputClick: React.MouseEventHandler<HTMLInputElement>;
   /** A handler for clue selection. */
   handleClueSelected: (direction: Direction, number: string) => void;
+
   /** Provides registration for focus actions */
   registerFocusHandler: (focusHandler: FocusHandler | null) => void;