nhb-toolbox 3.1.0 → 3.1.1

package/dist/dom/utils.d.ts

@@ -4,11 +4,15 @@
  * @param offset Additional vertical offset in pixels (positive moves down, negative moves up).
  */
 export declare function smoothScrollTo(element: HTMLElement, offset?: number): void;
-/** * Toggle full-screen using browser API. */
-export declare function toggleFullScreen(): void;
 /**
- * * Copy text to clipboard.
- * @param text Text to copy in clipboard.
+ * * Toggles full-screen mode for a given element (or the `document` by default).
+ * @param element The element to toggle fullscreen mode for (default: document root).
+ */
+export declare function toggleFullScreen(element?: HTMLElement): void;
+/**
+ * * Copies text to the clipboard, falling back to legacy methods if needed.
+ * @param text - The text to copy.
+ * @returns A promise that resolves when the text is copied.
  */
 export declare function copyToClipboard(text: string): Promise<void>;
 //# sourceMappingURL=utils.d.ts.map

package/dist/dom/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/dom/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAI,QAQ9D;AAED,8CAA8C;AAC9C,wBAAgB,gBAAgB,SAM/B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,iBAMjD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/dom/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAI,QAQ9D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,cAA2B,QAuBlE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BjE"}

package/dist/dom/utils.js

@@ -11,24 +11,56 @@ export function smoothScrollTo(element, offset = 0) {
         }, 300); // Delay to ensure smooth scrolling effect
     }
 }
-/** * Toggle full-screen using browser API. */
-export function toggleFullScreen() {
-    if (!document.fullscreenElement) {
-        document.documentElement.requestFullscreen();
+/**
+ * * Toggles full-screen mode for a given element (or the `document` by default).
+ * @param element The element to toggle fullscreen mode for (default: document root).
+ */
+export function toggleFullScreen(element = document.documentElement) {
+    const doc = document;
+    const elem = element;
+    if (!doc.fullscreenElement && !doc.webkitFullscreenElement) {
+        if (elem.requestFullscreen) {
+            elem.requestFullscreen();
+        }
+        else if (elem.webkitRequestFullscreen) {
+            elem.webkitRequestFullscreen();
+        }
     }
-    else if (document.exitFullscreen) {
-        document.exitFullscreen();
+    else {
+        if (doc.exitFullscreen) {
+            doc.exitFullscreen();
+        }
+        else if (doc.webkitExitFullscreen) {
+            doc.webkitExitFullscreen();
+        }
     }
 }
 /**
- * * Copy text to clipboard.
- * @param text Text to copy in clipboard.
+ * * Copies text to the clipboard, falling back to legacy methods if needed.
+ * @param text - The text to copy.
+ * @returns A promise that resolves when the text is copied.
  */
 export async function copyToClipboard(text) {
     try {
-        await navigator.clipboard.writeText(text);
+        if (navigator?.clipboard?.writeText) {
+            await navigator.clipboard.writeText(text);
+        }
+        else {
+            const textArea = document.createElement('textarea');
+            textArea.value = text;
+            textArea.style.position = 'fixed';
+            textArea.style.opacity = '0';
+            document.body.appendChild(textArea);
+            textArea.select();
+            textArea.setSelectionRange(0, textArea.value.length);
+            const success = document.execCommand('copy');
+            document.body.removeChild(textArea);
+            if (!success) {
+                throw new Error('Cannot execute command in this environment!');
+            }
+        }
     }
-    catch (err) {
-        console.error('Failed to copy:', err);
+    catch (error) {
+        console.error('Failed to copy text:', error);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",