@homecode/ui 5.1.15 → 5.1.17

package/dist/esm/index.js

@@ -88,6 +88,7 @@ import * as resizeObserver from './src/tools/resizeObserver.js';
 export { resizeObserver };
 import * as queryParams from './src/tools/queryParams.js';
 export { queryParams };
+export { useAwake } from './src/hooks/useAwake.js';
 export { useThrottle, useThrottleCallback } from './src/hooks/useThrottle.js';
 export { useDebounce, useDebounceCallback } from './src/hooks/useDebounce.js';
 import 'react';

package/dist/esm/src/hooks/useAwake.js

@@ -0,0 +1,65 @@
+import { useRef, useEffect } from 'react';
+
+function getWakeLockNavigator() {
+    if (typeof navigator === 'undefined' || !('wakeLock' in navigator)) {
+        return null;
+    }
+    return navigator;
+}
+function useAwake(isActive) {
+    const isActiveRef = useRef(isActive);
+    isActiveRef.current = isActive;
+    const sentinelRef = useRef(null);
+    useEffect(() => {
+        const wakeLockNavigator = getWakeLockNavigator();
+        if (!wakeLockNavigator?.wakeLock)
+            return;
+        const release = async () => {
+            const sentinel = sentinelRef.current;
+            sentinelRef.current = null;
+            if (!sentinel || sentinel.released)
+                return;
+            try {
+                await sentinel.release();
+            }
+            catch {
+                // already released or unsupported
+            }
+        };
+        const request = async () => {
+            if (!isActiveRef.current || document.visibilityState !== 'visible')
+                return;
+            await release();
+            try {
+                const sentinel = await wakeLockNavigator.wakeLock.request('screen');
+                sentinelRef.current = sentinel;
+                sentinel.addEventListener('release', () => {
+                    if (sentinelRef.current === sentinel) {
+                        sentinelRef.current = null;
+                    }
+                });
+            }
+            catch {
+                // NotAllowedError, etc.
+            }
+        };
+        const onVisibilityChange = () => {
+            if (document.visibilityState === 'visible') {
+                void request();
+            }
+        };
+        if (isActive) {
+            void request();
+        }
+        else {
+            void release();
+        }
+        document.addEventListener('visibilitychange', onVisibilityChange);
+        return () => {
+            document.removeEventListener('visibilitychange', onVisibilityChange);
+            void release();
+        };
+    }, [isActive]);
+}
+
+export { useAwake };

package/dist/esm/types/src/hooks/index.d.ts

@@ -1,3 +1,4 @@
+export * from './useAwake';
 export * from './useThrottle';
 export * from './useDebounce';
 export * from './useEvent';

package/dist/esm/types/src/hooks/useAwake.d.ts

@@ -0,0 +1 @@
+export declare function useAwake(isActive: boolean): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homecode/ui",
-  "version": "5.1.15",
+  "version": "5.1.17",
   "description": "React UI components library",
   "scripts": {
     "tests": "jest",