add feature network, prevent-close, and vibration modules; implement online status checks and tab close warnings

Author: dev-aditya-lab

src/browser/index.ts

@@ -3,4 +3,7 @@ export * from './notify';
 export * from './battery';
 export * from './dark-mode'; 
 export * from "./tab-visibility"; 
-export * from "./idle-timer"; 
+export * from "./idle-timer"; 
+export * from "./prevent-close";
+export * from "./network";
+export * from "./vibration";

src/browser/network/index.ts

@@ -0,0 +1,18 @@
+/**
+ * Checks if the browser is currently online.
+ * @returns {boolean} True if online, false if offline.
+ */
+export function isOnline(): boolean {
+  return navigator.onLine;
+}
+
+/**
+ * Listen for changes in network status (online/offline).
+ * @param callback - A function that receives the current status.
+ */
+export function onNetworkChange(callback: (online: boolean) => void): void {
+  const updateStatus = () => callback(navigator.onLine);
+
+  window.addEventListener("online", updateStatus);
+  window.addEventListener("offline", updateStatus);
+}

src/browser/prevent-close/index.ts

@@ -0,0 +1,29 @@
+let listenerAttached = false;
+let currentMessage = "Are you sure you want to leave? Changes may not be saved.";
+
+/**
+ * Enables the tab close or refresh warning popup.
+ * @param message Optional custom message for the prompt.
+ */
+export function enablePreventClose(message?: string): void {
+  if (listenerAttached) return;
+  listenerAttached = true;
+
+  if (message) currentMessage = message;
+
+  window.addEventListener("beforeunload", beforeUnloadHandler);
+}
+
+function beforeUnloadHandler(e: BeforeUnloadEvent): void {
+  e.preventDefault();
+  e.returnValue = currentMessage; // Most browsers use this for legacy
+}
+
+/**
+ * Disables the warning popup and allows normal tab closing.
+ */
+export function disablePreventClose(): void {
+  if (!listenerAttached) return;
+  window.removeEventListener("beforeunload", beforeUnloadHandler);
+  listenerAttached = false;
+}

src/browser/vibration/index.ts

@@ -0,0 +1,20 @@
+/**
+ * Vibrates the device using the given pattern.
+ * @param pattern - A single duration or array of vibration timings in ms.
+ * @returns True if vibration was triggered successfully.
+ */
+export function vibrate(pattern: number | number[]): boolean {
+  if ("vibrate" in navigator) {
+    return navigator.vibrate(pattern);
+  }
+  return false;
+}
+
+/**
+ * Stops any ongoing vibration.
+ */
+export function stopVibration(): void {
+  if ("vibrate" in navigator) {
+    navigator.vibrate(0);
+  }
+}