nhb-toolbox 3.1.0 → 3.1.2

package/dist/array/sort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../src/array/sort.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAC1B,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,EAClD,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAyE3C"}
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../src/array/sort.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAC1B,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,EAClD,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAsE3C"}

package/dist/array/sort.js

@@ -34,14 +34,13 @@ export function sortAnArray(array, options) {
     // Handle array of objects
     if (isArrayOfType(array, isObject) && options && 'sortByField' in options) {
         return [...array].sort((a, b) => {
-            // const key = options.sortByField as keyof T;
-            // const keyA = (a as T)[key];
-            // const keyB = (b as T)[key];
-            const getKeyValue = (obj, path) => path
-                .split('.')
-                .reduce((acc, key) => acc?.[key], obj);
-            const keyA = getKeyValue(a, options?.sortByField);
-            const keyB = getKeyValue(b, options?.sortByField);
+            const _getKeyValue = (obj, path) => {
+                return path
+                    .split('.')
+                    .reduce((acc, key) => acc?.[key], obj);
+            };
+            const keyA = _getKeyValue(a, options?.sortByField);
+            const keyB = _getKeyValue(b, options?.sortByField);
             if (keyA == null || keyB == null) {
                 return keyA == null ? 1 : -1;
             }

package/dist/array/types.d.ts

@@ -7,7 +7,7 @@ import type { PrimitiveKey } from '../types';
  *  */
 export type Flattened<T> = T extends (infer U)[] ? Flattened<U> : T;
 /**
- * - Configuration for `createOptionsArray`.
+ * * Configuration for `createOptionsArray`.
  * - Defines the mapping between keys in the input objects and the keys in the output options.
  *
  * @typeParam T - The type of the objects in the input array.
@@ -52,5 +52,6 @@ export interface SortByOption<T extends GenericObject> extends OrderOption {
     /** The field by which to sort the objects in the array. */
     sortByField: NestedPrimitiveKey<T>;
 }
+/** * Options for sorting array. */
 export type SortOptions<T> = T extends GenericObject ? SortByOption<T> : OrderOption;
 //# sourceMappingURL=types.d.ts.map

package/dist/array/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/array/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;MAIM;AACN,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;IACvC;;;OAGG;IACH,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAE/B;;;OAGG;IACH,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAEhC;;;;OAIG;IACH,cAAc,CAAC,EAAE,EAAE,CAAC;IAEpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,EAAE,CAAC;CACrB;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,aAAa,CAAE,SAAQ,WAAW;IACzE,2DAA2D;IAC3D,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,IACxB,CAAC,SAAS,aAAa,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/array/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;MAIM;AACN,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;IACvC;;;OAGG;IACH,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAE/B;;;OAGG;IACH,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAEhC;;;;OAIG;IACH,cAAc,CAAC,EAAE,EAAE,CAAC;IAEpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,EAAE,CAAC;CACrB;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,aAAa,CAAE,SAAQ,WAAW;IACzE,2DAA2D;IAC3D,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CACnC;AAED,mCAAmC;AACnC,MAAM,MAAM,WAAW,CAAC,CAAC,IACxB,CAAC,SAAS,aAAa,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC"}

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.2",
   "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",