@fgv/ts-sudoku-ui 5.0.1-2

package/lib/hooks/useResponsiveLayout.js

@@ -0,0 +1,139 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2023 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { useState, useEffect } from 'react';
+/**
+ * Breakpoints for responsive design
+ */
+const BREAKPOINTS = {
+    mobile: 768,
+    tablet: 1024,
+    smallHeight: 600
+};
+/**
+ * Detect if device supports touch
+ */
+function detectTouchSupport() {
+    return ('ontouchstart' in window ||
+        navigator.maxTouchPoints > 0 ||
+        (navigator.msMaxTouchPoints ?? 0) > 0);
+}
+/**
+ * Determine device type based on screen size and touch capability
+ */
+function determineDeviceType(width, height, isTouch) {
+    if (width <= BREAKPOINTS.mobile) {
+        return 'mobile';
+    }
+    if (width <= BREAKPOINTS.tablet && isTouch) {
+        return 'tablet';
+    }
+    return 'desktop';
+}
+/**
+ * Determine optimal keypad layout mode
+ */
+function determineKeypadLayoutMode(deviceType, orientation, width, height, isTouch) {
+    // Desktop: show overlay on demand or hidden by default
+    if (deviceType === 'desktop') {
+        return isTouch ? 'overlay' : 'hidden';
+    }
+    // Mobile portrait: side-by-side if width allows
+    if (deviceType === 'mobile' && orientation === 'portrait') {
+        return width >= 360 ? 'side-by-side' : 'stacked';
+    }
+    // Mobile landscape: stacked beside grid if height allows
+    if (deviceType === 'mobile' && orientation === 'landscape') {
+        return height >= BREAKPOINTS.smallHeight ? 'stacked' : 'overlay';
+    }
+    // Tablet: side-by-side in portrait, stacked in landscape
+    if (deviceType === 'tablet') {
+        return orientation === 'portrait' ? 'side-by-side' : 'stacked';
+    }
+    /* c8 ignore next 2 - defense in depth: all device types are explicitly handled above */
+    return 'overlay';
+}
+/**
+ * Hook to detect responsive layout information for optimal keypad display
+ * @param forceLayoutMode - Optional layout mode override for testing
+ * @public
+ */
+export function useResponsiveLayout(forceLayoutMode) {
+    const [layoutInfo, setLayoutInfo] = useState(() => {
+        const width = window.innerWidth;
+        const height = window.innerHeight;
+        const isTouchDevice = detectTouchSupport();
+        const orientation = width > height ? 'landscape' : 'portrait';
+        const deviceType = determineDeviceType(width, height, isTouchDevice);
+        const keypadLayoutMode = forceLayoutMode ?? determineKeypadLayoutMode(deviceType, orientation, width, height, isTouchDevice);
+        return {
+            deviceType,
+            orientation,
+            keypadLayoutMode,
+            screenWidth: width,
+            screenHeight: height,
+            isTouchDevice,
+            isSmallScreen: width <= BREAKPOINTS.mobile,
+            hasSpaceForDualKeypads: width >= 480 || (orientation === 'landscape' && height >= BREAKPOINTS.smallHeight)
+        };
+    });
+    useEffect(() => {
+        // Don't set up listeners if layout mode is forced
+        if (forceLayoutMode) {
+            return;
+        }
+        function updateLayoutInfo() {
+            const width = window.innerWidth;
+            const height = window.innerHeight;
+            const isTouchDevice = detectTouchSupport();
+            const orientation = width > height ? 'landscape' : 'portrait';
+            const deviceType = determineDeviceType(width, height, isTouchDevice);
+            const keypadLayoutMode = determineKeypadLayoutMode(deviceType, orientation, width, height, isTouchDevice);
+            setLayoutInfo({
+                deviceType,
+                orientation,
+                keypadLayoutMode,
+                screenWidth: width,
+                screenHeight: height,
+                isTouchDevice,
+                isSmallScreen: width <= BREAKPOINTS.mobile,
+                hasSpaceForDualKeypads: width >= 480 || (orientation === 'landscape' && height >= BREAKPOINTS.smallHeight)
+            });
+        }
+        // Update on resize
+        window.addEventListener('resize', updateLayoutInfo);
+        // Update on orientation change
+        window.addEventListener('orientationchange', () => {
+            // Small delay to ensure screen dimensions are updated
+            setTimeout(updateLayoutInfo, 100);
+        });
+        // Initial update
+        updateLayoutInfo();
+        return () => {
+            window.removeEventListener('resize', updateLayoutInfo);
+            window.removeEventListener('orientationchange', updateLayoutInfo);
+        };
+    }, [forceLayoutMode]);
+    return layoutInfo;
+}
+//# sourceMappingURL=useResponsiveLayout.js.map

package/lib/hooks/useResponsiveLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResponsiveLayout.js","sourceRoot":"","sources":["../../src/hooks/useResponsiveLayout.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * MIT License\n *\n * Copyright (c) 2023 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { useState, useEffect } from 'react';\n\n/**\n * Device type detection result\n * @public\n */\nexport type DeviceType = 'mobile' | 'tablet' | 'desktop';\n\n/**\n * Screen orientation\n * @public\n */\nexport type ScreenOrientation = 'portrait' | 'landscape';\n\n/**\n * Layout mode for dual keypad\n * @public\n */\nexport type KeypadLayoutMode = 'side-by-side' | 'stacked' | 'overlay' | 'hidden';\n\n/**\n * Responsive layout information\n * @public\n */\nexport interface IResponsiveLayoutInfo {\n  /** Device type based on screen size and touch capability */\n  readonly deviceType: DeviceType;\n\n  /** Current screen orientation */\n  readonly orientation: ScreenOrientation;\n\n  /** Recommended keypad layout mode */\n  readonly keypadLayoutMode: KeypadLayoutMode;\n\n  /** Screen width in pixels */\n  readonly screenWidth: number;\n\n  /** Screen height in pixels */\n  readonly screenHeight: number;\n\n  /** Whether touch is supported */\n  readonly isTouchDevice: boolean;\n\n  /** Whether the screen is considered small */\n  readonly isSmallScreen: boolean;\n\n  /** Whether the screen has enough space for dual keypads */\n  readonly hasSpaceForDualKeypads: boolean;\n}\n\n/**\n * Breakpoints for responsive design\n */\nconst BREAKPOINTS = {\n  mobile: 768,\n  tablet: 1024,\n  smallHeight: 600\n} as const;\n\n/**\n * Detect if device supports touch\n */\nfunction detectTouchSupport(): boolean {\n  return (\n    'ontouchstart' in window ||\n    navigator.maxTouchPoints > 0 ||\n    ((navigator as unknown as { msMaxTouchPoints?: number }).msMaxTouchPoints ?? 0) > 0\n  );\n}\n\n/**\n * Determine device type based on screen size and touch capability\n */\nfunction determineDeviceType(width: number, height: number, isTouch: boolean): DeviceType {\n  if (width <= BREAKPOINTS.mobile) {\n    return 'mobile';\n  }\n\n  if (width <= BREAKPOINTS.tablet && isTouch) {\n    return 'tablet';\n  }\n\n  return 'desktop';\n}\n\n/**\n * Determine optimal keypad layout mode\n */\nfunction determineKeypadLayoutMode(\n  deviceType: DeviceType,\n  orientation: ScreenOrientation,\n  width: number,\n  height: number,\n  isTouch: boolean\n): KeypadLayoutMode {\n  // Desktop: show overlay on demand or hidden by default\n  if (deviceType === 'desktop') {\n    return isTouch ? 'overlay' : 'hidden';\n  }\n\n  // Mobile portrait: side-by-side if width allows\n  if (deviceType === 'mobile' && orientation === 'portrait') {\n    return width >= 360 ? 'side-by-side' : 'stacked';\n  }\n\n  // Mobile landscape: stacked beside grid if height allows\n  if (deviceType === 'mobile' && orientation === 'landscape') {\n    return height >= BREAKPOINTS.smallHeight ? 'stacked' : 'overlay';\n  }\n\n  // Tablet: side-by-side in portrait, stacked in landscape\n  if (deviceType === 'tablet') {\n    return orientation === 'portrait' ? 'side-by-side' : 'stacked';\n  }\n  /* c8 ignore next 2 - defense in depth: all device types are explicitly handled above */\n  return 'overlay';\n}\n\n/**\n * Hook to detect responsive layout information for optimal keypad display\n * @param forceLayoutMode - Optional layout mode override for testing\n * @public\n */\nexport function useResponsiveLayout(forceLayoutMode?: KeypadLayoutMode): IResponsiveLayoutInfo {\n  const [layoutInfo, setLayoutInfo] = useState<IResponsiveLayoutInfo>(() => {\n    const width = window.innerWidth;\n    const height = window.innerHeight;\n    const isTouchDevice = detectTouchSupport();\n    const orientation: ScreenOrientation = width > height ? 'landscape' : 'portrait';\n    const deviceType = determineDeviceType(width, height, isTouchDevice);\n    const keypadLayoutMode =\n      forceLayoutMode ?? determineKeypadLayoutMode(deviceType, orientation, width, height, isTouchDevice);\n\n    return {\n      deviceType,\n      orientation,\n      keypadLayoutMode,\n      screenWidth: width,\n      screenHeight: height,\n      isTouchDevice,\n      isSmallScreen: width <= BREAKPOINTS.mobile,\n      hasSpaceForDualKeypads:\n        width >= 480 || (orientation === 'landscape' && height >= BREAKPOINTS.smallHeight)\n    };\n  });\n\n  useEffect(() => {\n    // Don't set up listeners if layout mode is forced\n    if (forceLayoutMode) {\n      return;\n    }\n\n    function updateLayoutInfo(): void {\n      const width = window.innerWidth;\n      const height = window.innerHeight;\n      const isTouchDevice = detectTouchSupport();\n      const orientation: ScreenOrientation = width > height ? 'landscape' : 'portrait';\n      const deviceType = determineDeviceType(width, height, isTouchDevice);\n      const keypadLayoutMode = determineKeypadLayoutMode(\n        deviceType,\n        orientation,\n        width,\n        height,\n        isTouchDevice\n      );\n\n      setLayoutInfo({\n        deviceType,\n        orientation,\n        keypadLayoutMode,\n        screenWidth: width,\n        screenHeight: height,\n        isTouchDevice,\n        isSmallScreen: width <= BREAKPOINTS.mobile,\n        hasSpaceForDualKeypads:\n          width >= 480 || (orientation === 'landscape' && height >= BREAKPOINTS.smallHeight)\n      });\n    }\n\n    // Update on resize\n    window.addEventListener('resize', updateLayoutInfo);\n\n    // Update on orientation change\n    window.addEventListener('orientationchange', () => {\n      // Small delay to ensure screen dimensions are updated\n      setTimeout(updateLayoutInfo, 100);\n    });\n\n    // Initial update\n    updateLayoutInfo();\n\n    return () => {\n      window.removeEventListener('resize', updateLayoutInfo);\n      window.removeEventListener('orientationchange', updateLayoutInfo);\n    };\n  }, [forceLayoutMode]);\n\n  return layoutInfo;\n}\n"]}

package/lib/index.d.ts

@@ -0,0 +1,28 @@
+export { SudokuGridEntry } from './components/SudokuGridEntry';
+export { SudokuGrid } from './components/SudokuGrid';
+export { SudokuCell } from './components/SudokuCell';
+export { SudokuControls } from './components/SudokuControls';
+export { ValidationDisplay } from './components/ValidationDisplay';
+export { CompactControlRibbon } from './components/CompactControlRibbon';
+export { DualKeypad } from './components/DualKeypad';
+export { NumberKeypad } from './components/NumberKeypad';
+export { CageOverlay } from './components/CageOverlay';
+export { CageSumIndicator } from './components/CageSumIndicator';
+export * from './contexts/DiagnosticLoggerContext';
+export { usePuzzleSession } from './hooks/usePuzzleSession';
+export { useResponsiveLayout } from './hooks/useResponsiveLayout';
+export { useKillerCombinations } from './hooks/useKillerCombinations';
+export { useCombinationElimination } from './hooks/useCombinationElimination';
+export { useKeyboardShortcut } from './hooks/useKeyboardShortcut';
+export { KillerCombinationsExplorer } from './components/KillerCombinationsExplorer';
+export { KillerCombinationsPanel } from './components/KillerCombinationsPanel';
+export { KillerCombinationsModal } from './components/KillerCombinationsModal';
+export { CombinationGrid } from './components/CombinationGrid';
+export { CombinationCard } from './components/CombinationCard';
+export type { IValidationError, ISudokuGridEntryProps, ISudokuGridProps, ICellDisplayInfo, ISudokuCellProps, ISudokuControlsProps, IValidationDisplayProps, ICageDisplayInfo, ICageOverlayProps, ICageSumIndicatorProps, IKillerCombinationsMode, ICombinationDisplayInfo, IEliminationState, IKillerCombinationsExplorerProps, ICombinationCardProps, ICombinationGridProps } from './types';
+export type { ICompactControlRibbonProps } from './components/CompactControlRibbon';
+export type { INumberKeypadProps } from './components/NumberKeypad';
+export type { IDualKeypadProps } from './components/DualKeypad';
+export type { DeviceType, ScreenOrientation, KeypadLayoutMode, IResponsiveLayoutInfo } from './hooks/useResponsiveLayout';
+export type { IKeyboardShortcutOptions } from './hooks/useKeyboardShortcut';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,cAAc,oCAAoC,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGlE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,gCAAgC,EAChC,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAGpF,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,6BAA6B,CAAC;AAGrC,YAAY,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC"}

package/lib/index.js

@@ -0,0 +1,49 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2023 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+// Main components
+export { SudokuGridEntry } from './components/SudokuGridEntry';
+export { SudokuGrid } from './components/SudokuGrid';
+export { SudokuCell } from './components/SudokuCell';
+export { SudokuControls } from './components/SudokuControls';
+export { ValidationDisplay } from './components/ValidationDisplay';
+export { CompactControlRibbon } from './components/CompactControlRibbon';
+export { DualKeypad } from './components/DualKeypad';
+export { NumberKeypad } from './components/NumberKeypad';
+export { CageOverlay } from './components/CageOverlay';
+export { CageSumIndicator } from './components/CageSumIndicator';
+// Contexts
+export * from './contexts/DiagnosticLoggerContext';
+// Hooks
+export { usePuzzleSession } from './hooks/usePuzzleSession';
+export { useResponsiveLayout } from './hooks/useResponsiveLayout';
+export { useKillerCombinations } from './hooks/useKillerCombinations';
+export { useCombinationElimination } from './hooks/useCombinationElimination';
+export { useKeyboardShortcut } from './hooks/useKeyboardShortcut';
+// Killer Combinations Components
+export { KillerCombinationsExplorer } from './components/KillerCombinationsExplorer';
+export { KillerCombinationsPanel } from './components/KillerCombinationsPanel';
+export { KillerCombinationsModal } from './components/KillerCombinationsModal';
+export { CombinationGrid } from './components/CombinationGrid';
+export { CombinationCard } from './components/CombinationCard';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,kBAAkB;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,WAAW;AACX,cAAc,oCAAoC,CAAC;AAEnD,QAAQ;AACR,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,iCAAiC;AACjC,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC","sourcesContent":["/*\n * MIT License\n *\n * Copyright (c) 2023 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n// Main components\nexport { SudokuGridEntry } from './components/SudokuGridEntry';\nexport { SudokuGrid } from './components/SudokuGrid';\nexport { SudokuCell } from './components/SudokuCell';\nexport { SudokuControls } from './components/SudokuControls';\nexport { ValidationDisplay } from './components/ValidationDisplay';\nexport { CompactControlRibbon } from './components/CompactControlRibbon';\nexport { DualKeypad } from './components/DualKeypad';\nexport { NumberKeypad } from './components/NumberKeypad';\nexport { CageOverlay } from './components/CageOverlay';\nexport { CageSumIndicator } from './components/CageSumIndicator';\n\n// Contexts\nexport * from './contexts/DiagnosticLoggerContext';\n\n// Hooks\nexport { usePuzzleSession } from './hooks/usePuzzleSession';\nexport { useResponsiveLayout } from './hooks/useResponsiveLayout';\nexport { useKillerCombinations } from './hooks/useKillerCombinations';\nexport { useCombinationElimination } from './hooks/useCombinationElimination';\nexport { useKeyboardShortcut } from './hooks/useKeyboardShortcut';\n\n// Killer Combinations Components\nexport { KillerCombinationsExplorer } from './components/KillerCombinationsExplorer';\nexport { KillerCombinationsPanel } from './components/KillerCombinationsPanel';\nexport { KillerCombinationsModal } from './components/KillerCombinationsModal';\nexport { CombinationGrid } from './components/CombinationGrid';\nexport { CombinationCard } from './components/CombinationCard';\n\n// Types\nexport type {\n  IValidationError,\n  ISudokuGridEntryProps,\n  ISudokuGridProps,\n  ICellDisplayInfo,\n  ISudokuCellProps,\n  ISudokuControlsProps,\n  IValidationDisplayProps,\n  ICageDisplayInfo,\n  ICageOverlayProps,\n  ICageSumIndicatorProps,\n  IKillerCombinationsMode,\n  ICombinationDisplayInfo,\n  IEliminationState,\n  IKillerCombinationsExplorerProps,\n  ICombinationCardProps,\n  ICombinationGridProps\n} from './types';\n\n// Compact control ribbon types\nexport type { ICompactControlRibbonProps } from './components/CompactControlRibbon';\n\n// Dual keypad types\nexport type { INumberKeypadProps } from './components/NumberKeypad';\nexport type { IDualKeypadProps } from './components/DualKeypad';\n\n// Responsive layout types\nexport type {\n  DeviceType,\n  ScreenOrientation,\n  KeypadLayoutMode,\n  IResponsiveLayoutInfo\n} from './hooks/useResponsiveLayout';\n\n// Keyboard shortcut types\nexport type { IKeyboardShortcutOptions } from './hooks/useKeyboardShortcut';\n"]}

package/lib/test/fixtures/killerSudokuPuzzles.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Stable killer sudoku puzzle definitions for testing.
+ * These puzzles have been validated and are used across multiple test files
+ * to ensure consistency in testing killer sudoku functionality.
+ *
+ * @remarks
+ * Killer sudoku cells format: "GRID_MAPPING|CAGE_DEFINITIONS"
+ * - GRID_MAPPING: 81 characters mapping each cell to a cage ID (A-Z, a-z)
+ * - CAGE_DEFINITIONS: Comma-separated list of cageId+total (e.g., "A11,B09,C20")
+ *
+ * Example: "AABBCC....|A11,B09,C20,..."
+ * - Cells 0-1 are in cage A with total 11
+ * - Cells 2-3 are in cage B with total 09
+ * - Cells 4-5 are in cage C with total 20
+ *
+ * @public
+ */
+/**
+ * Valid killer sudoku puzzle with complete cage definitions.
+ * This is a standard 9x9 killer sudoku with 27 cages.
+ */
+export declare const VALID_KILLER_SUDOKU: string;
+/**
+ * Killer sudoku puzzle metadata.
+ */
+export interface IKillerSudokuFixture {
+    id: string;
+    description: string;
+    level: number;
+    cells: string;
+}
+/**
+ * Collection of validated killer sudoku puzzles for testing.
+ */
+export declare const KILLER_SUDOKU_FIXTURES: IKillerSudokuFixture[];
+//# sourceMappingURL=killerSudokuPuzzles.d.ts.map

package/lib/test/fixtures/killerSudokuPuzzles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"killerSudokuPuzzles.d.ts","sourceRoot":"","sources":["../../../src/test/fixtures/killerSudokuPuzzles.ts"],"names":[],"mappings":"AAwBA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MACuK,CAAC;AAE1M;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,oBAAoB,EAOxD,CAAC"}

package/lib/test/fixtures/killerSudokuPuzzles.js

@@ -0,0 +1,57 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2023 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+/**
+ * Stable killer sudoku puzzle definitions for testing.
+ * These puzzles have been validated and are used across multiple test files
+ * to ensure consistency in testing killer sudoku functionality.
+ *
+ * @remarks
+ * Killer sudoku cells format: "GRID_MAPPING|CAGE_DEFINITIONS"
+ * - GRID_MAPPING: 81 characters mapping each cell to a cage ID (A-Z, a-z)
+ * - CAGE_DEFINITIONS: Comma-separated list of cageId+total (e.g., "A11,B09,C20")
+ *
+ * Example: "AABBCC....|A11,B09,C20,..."
+ * - Cells 0-1 are in cage A with total 11
+ * - Cells 2-3 are in cage B with total 09
+ * - Cells 4-5 are in cage C with total 20
+ *
+ * @public
+ */
+/**
+ * Valid killer sudoku puzzle with complete cage definitions.
+ * This is a standard 9x9 killer sudoku with 27 cages.
+ */
+export const VALID_KILLER_SUDOKU = 'ABCCCDDDEABFFGGGDEHIJKGGLLLHIJKMGLNNHOPPMQQNROOSTMUVWRSSSTTUVWRXYTTTZZabXYYYcccab|A11,B09,C09,D20,E16,F17,G30,H17,I13,J09,K11,L16,M16,N11,O16,P07,Q11,R10,S14,T39,U08,V17,W16,X06,Y26,Z06,a09,b09,c11';
+/**
+ * Collection of validated killer sudoku puzzles for testing.
+ */
+export const KILLER_SUDOKU_FIXTURES = [
+    {
+        id: 'valid-killer-1',
+        description: 'Valid Killer Sudoku Puzzle',
+        level: 1,
+        cells: VALID_KILLER_SUDOKU
+    }
+];
+//# sourceMappingURL=killerSudokuPuzzles.js.map

package/lib/test/fixtures/killerSudokuPuzzles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"killerSudokuPuzzles.js","sourceRoot":"","sources":["../../../src/test/fixtures/killerSudokuPuzzles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;;;;;;;;;;;;GAgBG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,uMAAuM,CAAC;AAY1M;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA2B;IAC5D;QACE,EAAE,EAAE,gBAAgB;QACpB,WAAW,EAAE,4BAA4B;QACzC,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,mBAAmB;KAC3B;CACF,CAAC","sourcesContent":["/*\n * MIT License\n *\n * Copyright (c) 2023 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Stable killer sudoku puzzle definitions for testing.\n * These puzzles have been validated and are used across multiple test files\n * to ensure consistency in testing killer sudoku functionality.\n *\n * @remarks\n * Killer sudoku cells format: \"GRID_MAPPING|CAGE_DEFINITIONS\"\n * - GRID_MAPPING: 81 characters mapping each cell to a cage ID (A-Z, a-z)\n * - CAGE_DEFINITIONS: Comma-separated list of cageId+total (e.g., \"A11,B09,C20\")\n *\n * Example: \"AABBCC....|A11,B09,C20,...\"\n * - Cells 0-1 are in cage A with total 11\n * - Cells 2-3 are in cage B with total 09\n * - Cells 4-5 are in cage C with total 20\n *\n * @public\n */\n\n/**\n * Valid killer sudoku puzzle with complete cage definitions.\n * This is a standard 9x9 killer sudoku with 27 cages.\n */\nexport const VALID_KILLER_SUDOKU: string =\n  'ABCCCDDDEABFFGGGDEHIJKGGLLLHIJKMGLNNHOPPMQQNROOSTMUVWRSSSTTUVWRXYTTTZZabXYYYcccab|A11,B09,C09,D20,E16,F17,G30,H17,I13,J09,K11,L16,M16,N11,O16,P07,Q11,R10,S14,T39,U08,V17,W16,X06,Y26,Z06,a09,b09,c11';\n\n/**\n * Killer sudoku puzzle metadata.\n */\nexport interface IKillerSudokuFixture {\n  id: string;\n  description: string;\n  level: number;\n  cells: string;\n}\n\n/**\n * Collection of validated killer sudoku puzzles for testing.\n */\nexport const KILLER_SUDOKU_FIXTURES: IKillerSudokuFixture[] = [\n  {\n    id: 'valid-killer-1',\n    description: 'Valid Killer Sudoku Puzzle',\n    level: 1,\n    cells: VALID_KILLER_SUDOKU\n  }\n];\n"]}

package/lib/test/unit/components/SudokuGridEntry.testHelpers.d.ts

@@ -0,0 +1,22 @@
+import { RenderResult, RenderOptions } from '@testing-library/react';
+import { IPuzzleDefinition } from '@fgv/ts-sudoku-lib';
+import { createPuzzleDefinition } from '../../../utils/puzzleDefinitionHelper';
+export type { IPuzzleDefinition };
+export { createPuzzleDefinition };
+export declare function customRender(ui: React.ReactElement, options?: RenderOptions): RenderResult;
+export declare function advanceByLongPress(ms?: number): void;
+export declare function setWindowDimensions(width: number, height: number): void;
+export declare function renderWithMobilePortrait(component: React.ReactElement, options?: RenderOptions): RenderResult;
+export declare function renderWithDesktop(component: React.ReactElement, options?: RenderOptions): RenderResult;
+export declare const mockMatchMedia: (query: string) => MediaQueryList;
+export declare const validPuzzleDescription: IPuzzleDefinition;
+export declare const simplePuzzleDescription: IPuzzleDefinition;
+export declare const sudokuXPuzzleDescription: IPuzzleDefinition;
+export declare const invalidPuzzleDescription: IPuzzleDefinition;
+export declare const defaultProps: {
+    initialPuzzleDescription: undefined;
+    onStateChange: undefined;
+    onValidationErrors: undefined;
+    className: undefined;
+};
+//# sourceMappingURL=SudokuGridEntry.testHelpers.d.ts.map

package/lib/test/unit/components/SudokuGridEntry.testHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SudokuGridEntry.testHelpers.d.ts","sourceRoot":"","sources":["../../../../src/test/unit/components/SudokuGridEntry.testHelpers.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAU,YAAY,EAAE,aAAa,EAAO,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAG/E,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAGlC,wBAAgB,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CAE1F;AAGD,wBAAgB,kBAAkB,CAAC,EAAE,GAAE,MAAY,GAAG,IAAI,CAIzD;AAGD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAWvE;AAGD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,KAAK,CAAC,YAAY,EAC7B,OAAO,CAAC,EAAE,aAAa,GACtB,YAAY,CAGd;AAGD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CAGtG;AAGD,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,cAW9C,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,iBAQnC,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,iBAQpC,CAAC;AAEH,eAAO,MAAM,wBAAwB,EAAE,iBAQrC,CAAC;AAEH,eAAO,MAAM,wBAAwB,EAAE,iBAQrC,CAAC;AAEH,eAAO,MAAM,YAAY,EAAE;IACzB,wBAAwB,EAAE,SAAS,CAAC;IACpC,aAAa,EAAE,SAAS,CAAC;IACzB,kBAAkB,EAAE,SAAS,CAAC;IAC9B,SAAS,EAAE,SAAS,CAAC;CAMtB,CAAC"}

package/lib/test/unit/components/SudokuGridEntry.testHelpers.js

@@ -0,0 +1,116 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2023 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { render, act } from '@testing-library/react';
+import { createPuzzleDefinition } from '../../../utils/puzzleDefinitionHelper';
+export { createPuzzleDefinition };
+// Custom render function - just use standard render
+export function customRender(ui, options) {
+    return render(ui, options);
+}
+// Helper function to simulate long press delay using fake timers
+export function advanceByLongPress(ms = 600) {
+    act(() => {
+        jest.advanceTimersByTime(ms);
+    });
+}
+// Helper to set window dimensions for different device types
+export function setWindowDimensions(width, height) {
+    Object.defineProperty(window, 'innerWidth', {
+        writable: true,
+        configurable: true,
+        value: width
+    });
+    Object.defineProperty(window, 'innerHeight', {
+        writable: true,
+        configurable: true,
+        value: height
+    });
+}
+// Helper to render with mobile portrait layout (side-by-side keypads)
+export function renderWithMobilePortrait(component, options) {
+    setWindowDimensions(375, 667);
+    return customRender(component, options);
+}
+// Helper to render with desktop layout (hidden/overlay keypads)
+export function renderWithDesktop(component, options) {
+    setWindowDimensions(1024, 768);
+    return customRender(component, options);
+}
+// Mock window.matchMedia for responsive layout tests
+export const mockMatchMedia = (query) => {
+    return {
+        matches: false,
+        media: query,
+        onchange: null,
+        addListener: jest.fn(),
+        removeListener: jest.fn(),
+        addEventListener: jest.fn(),
+        removeEventListener: jest.fn(),
+        dispatchEvent: jest.fn()
+    };
+};
+// Test puzzle definitions
+export const validPuzzleDescription = createPuzzleDefinition({
+    id: 'test-puzzle',
+    description: 'Test Puzzle',
+    type: 'sudoku',
+    level: 1,
+    totalRows: 9,
+    totalColumns: 9,
+    cells: '123456789456789123789123456234567891567891234891234567345678912678912345912345678'
+});
+export const simplePuzzleDescription = createPuzzleDefinition({
+    id: 'simple-puzzle',
+    description: 'Simple Test Puzzle',
+    type: 'sudoku',
+    level: 1,
+    totalRows: 9,
+    totalColumns: 9,
+    cells: '1' + '.'.repeat(80) // 81 total characters
+});
+export const sudokuXPuzzleDescription = createPuzzleDefinition({
+    id: 'sudoku-x-puzzle',
+    description: 'Sudoku-X Test Puzzle',
+    type: 'sudoku-x',
+    level: 1,
+    totalRows: 9,
+    totalColumns: 9,
+    cells: '.'.repeat(81)
+});
+export const invalidPuzzleDescription = createPuzzleDefinition({
+    id: 'invalid-puzzle',
+    description: 'Invalid Puzzle',
+    type: 'sudoku',
+    level: 1,
+    totalRows: 9,
+    totalColumns: 9,
+    cells: 'invalid' // Too short
+});
+export const defaultProps = {
+    initialPuzzleDescription: undefined,
+    onStateChange: undefined,
+    onValidationErrors: undefined,
+    className: undefined
+};
+//# sourceMappingURL=SudokuGridEntry.testHelpers.js.map

package/lib/test/unit/components/SudokuGridEntry.testHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SudokuGridEntry.testHelpers.js","sourceRoot":"","sources":["../../../../src/test/unit/components/SudokuGridEntry.testHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * MIT License\n *\n * Copyright (c) 2023 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { render, RenderResult, RenderOptions, act } from '@testing-library/react';\nimport { IPuzzleDefinition } from '@fgv/ts-sudoku-lib';\nimport { createPuzzleDefinition } from '../../../utils/puzzleDefinitionHelper';\n\n// Re-export for use in test files\nexport type { IPuzzleDefinition };\nexport { createPuzzleDefinition };\n\n// Custom render function - just use standard render\nexport function customRender(ui: React.ReactElement, options?: RenderOptions): RenderResult {\n  return render(ui, options);\n}\n\n// Helper function to simulate long press delay using fake timers\nexport function advanceByLongPress(ms: number = 600): void {\n  act(() => {\n    jest.advanceTimersByTime(ms);\n  });\n}\n\n// Helper to set window dimensions for different device types\nexport function setWindowDimensions(width: number, height: number): void {\n  Object.defineProperty(window, 'innerWidth', {\n    writable: true,\n    configurable: true,\n    value: width\n  });\n  Object.defineProperty(window, 'innerHeight', {\n    writable: true,\n    configurable: true,\n    value: height\n  });\n}\n\n// Helper to render with mobile portrait layout (side-by-side keypads)\nexport function renderWithMobilePortrait(\n  component: React.ReactElement,\n  options?: RenderOptions\n): RenderResult {\n  setWindowDimensions(375, 667);\n  return customRender(component, options);\n}\n\n// Helper to render with desktop layout (hidden/overlay keypads)\nexport function renderWithDesktop(component: React.ReactElement, options?: RenderOptions): RenderResult {\n  setWindowDimensions(1024, 768);\n  return customRender(component, options);\n}\n\n// Mock window.matchMedia for responsive layout tests\nexport const mockMatchMedia = (query: string): MediaQueryList => {\n  return {\n    matches: false,\n    media: query,\n    onchange: null,\n    addListener: jest.fn(),\n    removeListener: jest.fn(),\n    addEventListener: jest.fn(),\n    removeEventListener: jest.fn(),\n    dispatchEvent: jest.fn()\n  } as unknown as MediaQueryList;\n};\n\n// Test puzzle definitions\nexport const validPuzzleDescription: IPuzzleDefinition = createPuzzleDefinition({\n  id: 'test-puzzle',\n  description: 'Test Puzzle',\n  type: 'sudoku',\n  level: 1,\n  totalRows: 9,\n  totalColumns: 9,\n  cells: '123456789456789123789123456234567891567891234891234567345678912678912345912345678'\n});\n\nexport const simplePuzzleDescription: IPuzzleDefinition = createPuzzleDefinition({\n  id: 'simple-puzzle',\n  description: 'Simple Test Puzzle',\n  type: 'sudoku',\n  level: 1,\n  totalRows: 9,\n  totalColumns: 9,\n  cells: '1' + '.'.repeat(80) // 81 total characters\n});\n\nexport const sudokuXPuzzleDescription: IPuzzleDefinition = createPuzzleDefinition({\n  id: 'sudoku-x-puzzle',\n  description: 'Sudoku-X Test Puzzle',\n  type: 'sudoku-x',\n  level: 1,\n  totalRows: 9,\n  totalColumns: 9,\n  cells: '.'.repeat(81)\n});\n\nexport const invalidPuzzleDescription: IPuzzleDefinition = createPuzzleDefinition({\n  id: 'invalid-puzzle',\n  description: 'Invalid Puzzle',\n  type: 'sudoku',\n  level: 1,\n  totalRows: 9,\n  totalColumns: 9,\n  cells: 'invalid' // Too short\n});\n\nexport const defaultProps: {\n  initialPuzzleDescription: undefined;\n  onStateChange: undefined;\n  onValidationErrors: undefined;\n  className: undefined;\n} = {\n  initialPuzzleDescription: undefined,\n  onStateChange: undefined,\n  onValidationErrors: undefined,\n  className: undefined\n};\n"]}

package/lib/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.52.12"
+    }
+  ]
+}