@w3ux/utils 2.0.9 → 2.1.0

package/README.md

@@ -0,0 +1,60 @@
+# Base
+
+A collection of reusable utilities for manipulating data
+
+## Installation
+
+```bash
+npm install @w3ux/utils
+```
+
+or
+
+```bash
+yarn add @w3ux/utils
+```
+
+or
+
+```bash
+pnpm add @w3ux/utils
+```
+
+## Usage
+
+```typescript
+import { /* your imports */ } from '@w3ux/utils'
+```
+
+### Utility Functions
+
+This package provides utility functions that can be used in any JavaScript/TypeScript project:
+
+```typescript
+import { /* specific function */ } from '@w3ux/utils'
+
+// Use the utility functions
+const result = /* call your function */
+```
+
+## Documentation
+
+For comprehensive documentation and examples, visit the [w3ux documentation](https://w3ux.org/library/utils).
+
+## Keywords
+
+`w3ux`, `polkadot`, `web3`, `utilities`, `typescript`, `data-manipulation`
+
+## Repository
+
+- **Source**: [GitHub](https://github.com/w3ux/w3ux-library)
+- **Package**: [npm](https://www.npmjs.com/package/@w3ux/utils)
+- **Issues**: [GitHub Issues](https://github.com/w3ux/w3ux-library/issues)
+
+## License
+
+This package is licensed under the GPL-3.0-only.
+
+---
+
+Part of the [w3ux library](https://github.com/w3ux/w3ux-library) - A collection of packages for building Web3 applications.

package/base.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -78,7 +79,7 @@ var camelize = (str) => {
     return result;
   };
   const w = toWords(str)?.map((a) => a.toLowerCase());
-  return simpleCamelCase(w);
+  return simpleCamelCase(w || []);
 };
 var ellipsisFn = (str, amount = 6, position = "center") => {
   const half = str.length / 2;

package/base.d.cts

@@ -45,7 +45,7 @@ declare const rmCommas: (val: string) => string;
  * @name rmDecimals
  * @summary Removes the decimal point and decimals from a string.
  */
-declare const rmDecimals: (str: any) => any;
+declare const rmDecimals: (str: string) => string;
 /**
  * @name shuffle
  * @summary Shuffle a set of objects.

package/base.d.ts

@@ -45,7 +45,7 @@ declare const rmCommas: (val: string) => string;
  * @name rmDecimals
  * @summary Removes the decimal point and decimals from a string.
  */
-declare const rmDecimals: (str: any) => any;
+declare const rmDecimals: (str: string) => string;
 /**
  * @name shuffle
  * @summary Shuffle a set of objects.

package/base.js

@@ -39,7 +39,7 @@ var camelize = (str) => {
     return result;
   };
   const w = toWords(str)?.map((a) => a.toLowerCase());
-  return simpleCamelCase(w);
+  return simpleCamelCase(w || []);
 };
 var ellipsisFn = (str, amount = 6, position = "center") => {
   const half = str.length / 2;

package/convert.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;

package/index.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -103,7 +104,7 @@ var camelize = (str) => {
     return result;
   };
   const w = toWords(str)?.map((a) => a.toLowerCase());
-  return simpleCamelCase(w);
+  return simpleCamelCase(w || []);
 };
 var ellipsisFn = (str, amount = 6, position = "center") => {
   const half = str.length / 2;
@@ -301,6 +302,12 @@ var removeVarFromUrlHash = (key) => {
   window.location.hash = `${page}${paramsAsStr ? `?${paramsAsStr}` : ``}`;
 };
 var sortWithNull = (ascending) => (a, b) => {
+  if (typeof a === "undefined" && typeof b === "undefined") {
+    return 0;
+  }
+  if (typeof a === "undefined" || typeof b === "undefined") {
+    return typeof a === "undefined" ? 1 : -1;
+  }
   if (a === b) {
     return 0;
   }

package/index.js

@@ -39,7 +39,7 @@ var camelize = (str) => {
     return result;
   };
   const w = toWords(str)?.map((a) => a.toLowerCase());
-  return simpleCamelCase(w);
+  return simpleCamelCase(w || []);
 };
 var ellipsisFn = (str, amount = 6, position = "center") => {
   const half = str.length / 2;
@@ -237,6 +237,12 @@ var removeVarFromUrlHash = (key) => {
   window.location.hash = `${page}${paramsAsStr ? `?${paramsAsStr}` : ``}`;
 };
 var sortWithNull = (ascending) => (a, b) => {
+  if (typeof a === "undefined" && typeof b === "undefined") {
+    return 0;
+  }
+  if (typeof a === "undefined" || typeof b === "undefined") {
+    return typeof a === "undefined" ? 1 : -1;
+  }
   if (a === b) {
     return 0;
   }

package/package.json

@@ -1,16 +1,33 @@
 {
   "name": "@w3ux/utils",
-  "version": "2.0.9",
+  "version": "2.1.0",
   "license": "GPL-3.0-only",
-  "dependencies": {
-    "dedot": "^0.8.1"
+  "type": "module",
+  "description": "A collection of reusable utilities for manipulating data",
+  "keywords": [
+    "w3ux",
+    "polkadot",
+    "web3",
+    "utilities",
+    "typescript",
+    "data-manipulation"
+  ],
+  "homepage": "https://w3ux.org/library/utils",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/w3ux/w3ux-library.git",
+    "directory": "library/utils"
+  },
+  "bugs": {
+    "url": "https://github.com/w3ux/w3ux-library/issues"
   },
-  "main": "index.cjs",
-  "module": "index.js",
   "exports": {
     ".": {
       "import": "./index.js",
       "require": "./index.cjs"
     }
+  },
+  "dependencies": {
+    "dedot": "^0.13.0"
   }
 }

package/types.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;

package/unit.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -143,6 +144,12 @@ var removeVarFromUrlHash = (key) => {
   window.location.hash = `${page}${paramsAsStr ? `?${paramsAsStr}` : ``}`;
 };
 var sortWithNull = (ascending) => (a, b) => {
+  if (typeof a === "undefined" && typeof b === "undefined") {
+    return 0;
+  }
+  if (typeof a === "undefined" || typeof b === "undefined") {
+    return typeof a === "undefined" ? 1 : -1;
+  }
   if (a === b) {
     return 0;
   }

package/unit.d.cts

@@ -1,4 +1,4 @@
-import { MutableRefObject, RefObject } from 'react';
+import { RefObject } from 'react';
 import { AnyObject } from './types.cjs';
 
 /**
@@ -44,7 +44,7 @@ declare const snakeToCamel: (str: string) => string;
  * @name setStateWithRef
  * @summary Synchronize React state and its reference with the provided value.
  */
-declare const setStateWithRef: <T>(value: T, setState: (_state: T) => void, ref: MutableRefObject<T>) => void;
+declare const setStateWithRef: <T>(value: T, setState: (_state: T) => void, ref: RefObject<T>) => void;
 /**
  * @name localStorageOrDefault
  * @summary Retrieve the local stroage value with the key, return defult value if it is not
@@ -60,7 +60,7 @@ declare const isValidAddress: (address: string) => boolean;
  * @name extractUrlValue
  * @summary Extracts a URL value from a URL string.
  */
-declare const extractUrlValue: (key: string, url?: string) => string;
+declare const extractUrlValue: (key: string, url?: string) => string | null;
 /**
  * @name varToUrlHash
  * @summary Puts a variable into the URL hash as a param.

package/unit.d.ts

@@ -1,4 +1,4 @@
-import { MutableRefObject, RefObject } from 'react';
+import { RefObject } from 'react';
 import { AnyObject } from './types.js';
 
 /**
@@ -44,7 +44,7 @@ declare const snakeToCamel: (str: string) => string;
  * @name setStateWithRef
  * @summary Synchronize React state and its reference with the provided value.
  */
-declare const setStateWithRef: <T>(value: T, setState: (_state: T) => void, ref: MutableRefObject<T>) => void;
+declare const setStateWithRef: <T>(value: T, setState: (_state: T) => void, ref: RefObject<T>) => void;
 /**
  * @name localStorageOrDefault
  * @summary Retrieve the local stroage value with the key, return defult value if it is not
@@ -60,7 +60,7 @@ declare const isValidAddress: (address: string) => boolean;
  * @name extractUrlValue
  * @summary Extracts a URL value from a URL string.
  */
-declare const extractUrlValue: (key: string, url?: string) => string;
+declare const extractUrlValue: (key: string, url?: string) => string | null;
 /**
  * @name varToUrlHash
  * @summary Puts a variable into the URL hash as a param.

package/unit.js

@@ -99,6 +99,12 @@ var removeVarFromUrlHash = (key) => {
   window.location.hash = `${page}${paramsAsStr ? `?${paramsAsStr}` : ``}`;
 };
 var sortWithNull = (ascending) => (a, b) => {
+  if (typeof a === "undefined" && typeof b === "undefined") {
+    return 0;
+  }
+  if (typeof a === "undefined" || typeof b === "undefined") {
+    return typeof a === "undefined" ? 1 : -1;
+  }
   if (a === b) {
     return 0;
   }