@superutils/core 1.0.1 → 1.0.4

package/README.md

@@ -2,6 +2,12 @@
 
 A collection of lightweight, dependency-free utility functions and types.
 
+<div v-if="false">
+
+For full API reference check out the [docs page](https://alien45.github.io/superutils/packages/@superutils/core/).
+
+</div>
+
 ## Table of Contents
 
 - [Installation](#installation)
@@ -9,8 +15,8 @@ A collection of lightweight, dependency-free utility functions and types.
     - [`is`](#is): Type checkers
     - [`deferred()`](#deferred): Debounce callbacks
     - [`throttle()`](#throttle): Throttle callbacks
-    - [`fallbackIfFails()`](#fallbackIfFails): Gracefully invoke functions
-    - [`objCopy()`](#objCopy): Deep-copy objects
+    - [`fallbackIfFails()`](#fallback-if-fails): Gracefully invoke functions
+    - [`objCopy()`](#obj-copy): Deep-copy objects
     - [`search()`](#search): Search iterable collections
 
 ## Installation
@@ -102,7 +108,7 @@ handleChange({ target: { value 2 } }) // will be ignored
 handleChange({ target: { value 3 } }) // will be ignored
 ```
 
-<div id="fallbackIfFails"></div>
+<div id="fallback-if-fails"></div>
 
 ### `fallbackIfFails(fn, args, fallback)`: gracefully invoke functions
 
@@ -145,7 +151,7 @@ fallbackIfFails(
 // Prints the result when request is successful or fallback value when request fails
 ```
 
-<div id="objCopy"></div>
+<div id="obj-copy"></div>
 
 ### `objCopy(source, dest, ignoreKeys, override)`: deep-copy objects
 

package/dist/index.d.ts

@@ -1282,12 +1282,14 @@ declare const randomInt: (min?: number, max?: number) => number;
 declare const clearClutter: (text: string, lineSeparator?: string) => string;
 
 /**
- * @summary Copies text to browser clipboard.
+ * Copies text to browser clipboard.
  *
  * CAUTION:
  * Based on browser security policy it may be required to invoke `copyToClipboard` from an user-generated event handler.
  *
- * This function first attempts to use the modern, asynchronous Clipboard API (`window.navigator.clipboard.writeText`).
+ * Invoking from non-browser environment will already resolve with `0`.
+ *
+ * This function first attempts to use the modern, asynchronous Clipboard API (`navigator.clipboard.writeText`).
  * If that fails or is unavailable, it falls back to the legacy `document.execCommand('copy')` method.
  *
  *

package/dist/index.js

@@ -102,17 +102,14 @@ var isEmptySafe = (x, numberableOnly = false) => {
 var isEmpty_default = isEmpty;
 
 // src/is/isEnv.ts
-var isEnvBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
+var isEnvBrowser = () => typeof window !== "undefined" && typeof (window == null ? void 0 : window.document) !== "undefined";
 var isEnvNode = () => {
   var _a;
   return typeof process !== "undefined" && ((_a = process == null ? void 0 : process.versions) == null ? void 0 : _a.node) != null;
 };
 var isEnvTouchable = () => {
-  try {
-    return "ontouchstart" in window.document.documentElement;
-  } catch (_) {
-    return false;
-  }
+  var _a, _b;
+  return typeof window !== "undefined" && "ontouchstart" in ((_b = (_a = window == null ? void 0 : window.document) == null ? void 0 : _a.documentElement) != null ? _b : {});
 };
 
 // src/noop.ts
@@ -198,17 +195,19 @@ var is = {
 // src/fallbackIfFails.ts
 var fallbackIfFails = (target, args, fallbackValue) => {
   let result;
+  let asPromise = false;
   try {
     result = !isFn(target) ? target : target(...isFn(args) ? args() : args);
     if (!isPromise(result)) return result;
-    result = result.catch(getAltValCb(fallbackValue));
+    asPromise = true;
+    return result.catch((err) => getAltValCb(err, fallbackValue));
   } catch (error) {
-    result = getAltValCb(fallbackValue)(error);
+    result = getAltValCb(error, fallbackValue);
+    return asPromise && !isPromise(result) ? Promise.resolve(result) : result;
   }
-  return result;
 };
 var fallbackIfFails_default = fallbackIfFails;
-var getAltValCb = (fallbackValue) => (error) => isFn(fallbackValue) ? fallbackValue(error) : fallbackValue;
+var getAltValCb = (error, fallbackValue) => isFn(fallbackValue) ? fallbackValue(error) : fallbackValue;
 
 // src/deferred.ts
 var deferred = (callback, delay = 50, config = {}) => {
@@ -783,22 +782,24 @@ var copyToClipboard = (str) => fallbackIfFails(
   () => navigator.clipboard.writeText(str).then(() => 1),
   [],
   // If clipboard API is not available or fails, use the fallback method
-  () => fallbackIfFails(
-    () => {
-      const el = document.createElement("textarea");
-      el.value = str;
-      el.setAttribute("readonly", "");
-      el.style.position = "absolute";
-      el.style.left = "-9999px";
-      document.body.appendChild(el);
-      el.select();
-      const result = document.execCommand("copy");
-      document.body.removeChild(el);
-      return Promise.resolve(result ? 2 : 0);
-    },
-    [],
-    () => Promise.resolve(0)
-  )
+  () => Promise.resolve(copyLegacy(str))
+);
+var copyLegacy = (str) => fallbackIfFails(
+  () => {
+    const el = document.createElement("textarea");
+    el.value = str;
+    el.setAttribute("readonly", "");
+    el.style.position = "absolute";
+    el.style.left = "-9999px";
+    document.body.appendChild(el);
+    el.select();
+    const success = document.execCommand("copy");
+    document.body.removeChild(el);
+    return success ? 2 : 0;
+  },
+  [],
+  0
+  // On error, resolve with 0
 );
 
 // src/str/getUrlParam.ts

package/package.json

@@ -3,14 +3,13 @@
 	"bugs": {
 		"url": "https://github.com/alien45/superutils/issues"
 	},
-	"description": "Utilities for TS/JS/Node.js environments.",
-	"devDependencies": {},
+	"description": "A collection of lightweight, dependency-free utility functions and types for Javascript/Typescript",
 	"files": [
 		"dist",
 		"README.md",
 		"LICENSE"
 	],
-	"homepage": "https://github.com/alien45/superutils/#readme",
+	"homepage": "https://alien45.github.io/superutils/packages/@superutils/core/",
 	"keywords": [
 		"javascript",
 		"rxjs",
@@ -25,7 +24,6 @@
 	"license": "MIT",
 	"main": "dist/index.js",
 	"name": "@superutils/core",
-	"peerDependencies": {},
 	"publishConfig": {
 		"access": "public"
 	},
@@ -38,10 +36,10 @@
 		"_watch": "tsc -p tsconfig.json --watch",
 		"build": "tsup src/index.ts --format esm --dts --clean --config ../../tsup.config.js",
 		"dev": "npm run build -- --watch",
-		"test": "vitest"
+		"test": "cd ../../ && npm run test promise"
 	},
 	"sideEffects": false,
 	"type": "module",
 	"types": "dist/index.d.ts",
-	"version": "1.0.1"
+	"version": "1.0.4"
 }