@hypernym/utils 0.3.0 → 1.0.0

package/LICENSE.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) Hypernym Studio
+Copyright (c) 2023 Hypernym Studio, Ivo Dolenc
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,4 +1,4 @@
-# Utils
+# @hypernym/utils
 
 A collection of reusable utilities.
 
@@ -6,40 +6,30 @@ A collection of reusable utilities.
 
 ## Features
 
+- Supports CJS & ESM
 - TypeScript friendly
-- Zero dependencies
+- Fully tree-shakeable
+- No dependencies
 
 ## Installation
 
 ```sh
-npm i @hypernym/utils
+npm i -D @hypernym/utils
 ```
 
-## Imports
+## Usage
 
 ```ts
+// CJS
+const { isNull, isString, ... } = require('@hypernym/utils')
+
 // ESM & TS
-import { util } from '@hypernym/utils'
+import { isNull, isString, ... } from '@hypernym/utils'
 
 // Types
-import type { Util } from '@hypernym/utils'
+import type { IsAny, RequiredDeep, ... } from '@hypernym/utils'
 ```
 
-## API
-
-- [`generic`](./src/generic.ts) - Useful common utilities.
-- [`is`](./src/is.ts) - Simple conditional utilities.
-
-### Types
-
-- [`Primitive`](./src/types/primitive.ts) - Matches any primitive value.
-- [`BuiltIn`](./src/types/built-in.ts) - Matches any `Primitive`, `Date` or `RegExp` value.
-- [`PartialDeep`](./src/types/partial-deep.ts) - Constructs a type by recursively setting all properties as optional.
-- [`RequiredDeep`](./src/types/required-deep.ts) - Constructs a type by recursively setting all properties as required.
-- [`IsNull`](./src/types/is.ts) - Returns a boolean if the given type is a `null`.
-- [`IsAny`](./src/types/is.ts) - Returns a boolean if the given type is a `any`.
-- [`IsNever`](./src/types/is.ts) - Returns a boolean if the given type is a `never`.
-
 ## Community
 
 Feel free to use the official [discussions](https://github.com/hypernym-studio/utils/discussions) for any additional questions.

package/dist/utils.cjs

@@ -0,0 +1,65 @@
+'use strict';
+
+const noop = () => {
+};
+const toString = (v) => Object.prototype.toString.call(v).slice(8, -1);
+
+const isBrowser = typeof window !== "undefined";
+const isNull = (v) => v === null;
+const isUndefined = (v) => typeof v === "undefined";
+const isString = (v) => typeof v === "string";
+const isStringEmpty = (v) => isString(v) && v.trim().length === 0;
+const isBoolean = (v) => typeof v === "boolean";
+const isNumber = (v) => typeof v === "number" && !isNaN(v);
+const isArray = (v) => Array.isArray(v);
+const isArrayEmpty = (v) => isArray(v) && v.length === 0;
+const isObject = (v) => toString(v) === "Object";
+const isObjectEmpty = (v) => isObject(v) && Object.keys(v).length === 0;
+const isFunction = (v) => v instanceof Function;
+const isNaNValue = (v) => typeof v === "number" && isNaN(v);
+const isRegExp = (v) => v instanceof RegExp;
+const isMap = (v) => v instanceof Map;
+const isSet = (v) => v instanceof Set;
+const isSymbol = (v) => toString(v) === "Symbol";
+const isDate = (v) => v instanceof Date && !isNaN(v.valueOf());
+const isBigint = (v) => typeof v === "bigint";
+const isInfinity = (v) => v === Infinity || v === -Infinity;
+const isURL = (v) => v instanceof URL;
+const isError = (v) => v instanceof Error;
+const isPrimitive = (v) => isString(v) || isNumber(v) || isBigint(v) || isBoolean(v) || isSymbol(v) || isNull(v) || isUndefined(v);
+const isElement = (v) => v instanceof Element;
+const isNodeList = (v) => v instanceof NodeList;
+const isNodeListEmpty = (v) => isNodeList(v) && v.length === 0;
+const isHtmlCollection = (v) => v instanceof HTMLCollection;
+const isHtmlCollectionEmpty = (v) => isHtmlCollection(v) && v.length === 0;
+
+exports.isArray = isArray;
+exports.isArrayEmpty = isArrayEmpty;
+exports.isBigint = isBigint;
+exports.isBoolean = isBoolean;
+exports.isBrowser = isBrowser;
+exports.isDate = isDate;
+exports.isElement = isElement;
+exports.isError = isError;
+exports.isFunction = isFunction;
+exports.isHtmlCollection = isHtmlCollection;
+exports.isHtmlCollectionEmpty = isHtmlCollectionEmpty;
+exports.isInfinity = isInfinity;
+exports.isMap = isMap;
+exports.isNaNValue = isNaNValue;
+exports.isNodeList = isNodeList;
+exports.isNodeListEmpty = isNodeListEmpty;
+exports.isNull = isNull;
+exports.isNumber = isNumber;
+exports.isObject = isObject;
+exports.isObjectEmpty = isObjectEmpty;
+exports.isPrimitive = isPrimitive;
+exports.isRegExp = isRegExp;
+exports.isSet = isSet;
+exports.isString = isString;
+exports.isStringEmpty = isStringEmpty;
+exports.isSymbol = isSymbol;
+exports.isURL = isURL;
+exports.isUndefined = isUndefined;
+exports.noop = noop;
+exports.toString = toString;

package/dist/utils.d.ts

@@ -11,7 +11,7 @@ type BuiltIn = Primitive | Date | RegExp;
 /**
  * Checks if the code is running in the browser.
  */
-declare const isClient: boolean;
+declare const isBrowser: boolean;
 /**
  * Returns a boolean if the given value is a `null`.
  */
@@ -171,13 +171,13 @@ type RequiredObjectDeep<T extends object, Options extends OptionsDeep = {
     [K in keyof T]-?: RequiredDeep<T[K], Options>;
 };
 
-/**
- * Returns a high resolution timestamp in milliseconds using the `performance.now()` method.
- */
-declare const now: number;
 /**
  * An empty arrow function that performs no operation.
  */
 declare const noop: () => void;
+/**
+ * Returns a string representing the object.
+ */
+declare const toString: (v: any) => string;
 
-export { BuiltIn, IsAny, IsNever, IsNull, PartialDeep, Primitive, RequiredDeep, isArray, isArrayEmpty, isBigint, isBoolean, isClient, isDate, isElement, isError, isFunction, isHtmlCollection, isHtmlCollectionEmpty, isInfinity, isMap, isNaNValue, isNodeList, isNodeListEmpty, isNull, isNumber, isObject, isObjectEmpty, isPrimitive, isRegExp, isSet, isString, isStringEmpty, isSymbol, isURL, isUndefined, noop, now };
+export { BuiltIn, IsAny, IsNever, IsNull, PartialDeep, Primitive, RequiredDeep, isArray, isArrayEmpty, isBigint, isBoolean, isBrowser, isDate, isElement, isError, isFunction, isHtmlCollection, isHtmlCollectionEmpty, isInfinity, isMap, isNaNValue, isNodeList, isNodeListEmpty, isNull, isNumber, isObject, isObjectEmpty, isPrimitive, isRegExp, isSet, isString, isStringEmpty, isSymbol, isURL, isUndefined, noop, toString };

package/dist/utils.mjs

@@ -1,9 +1,8 @@
-const now = performance.now();
 const noop = () => {
 };
+const toString = (v) => Object.prototype.toString.call(v).slice(8, -1);
 
-const getType = (v) => Object.prototype.toString.call(v).slice(8, -1);
-const isClient = typeof window !== "undefined";
+const isBrowser = typeof window !== "undefined";
 const isNull = (v) => v === null;
 const isUndefined = (v) => typeof v === "undefined";
 const isString = (v) => typeof v === "string";
@@ -12,14 +11,14 @@ const isBoolean = (v) => typeof v === "boolean";
 const isNumber = (v) => typeof v === "number" && !isNaN(v);
 const isArray = (v) => Array.isArray(v);
 const isArrayEmpty = (v) => isArray(v) && v.length === 0;
-const isObject = (v) => getType(v) === "Object";
+const isObject = (v) => toString(v) === "Object";
 const isObjectEmpty = (v) => isObject(v) && Object.keys(v).length === 0;
 const isFunction = (v) => v instanceof Function;
 const isNaNValue = (v) => typeof v === "number" && isNaN(v);
 const isRegExp = (v) => v instanceof RegExp;
 const isMap = (v) => v instanceof Map;
 const isSet = (v) => v instanceof Set;
-const isSymbol = (v) => getType(v) === "Symbol";
+const isSymbol = (v) => toString(v) === "Symbol";
 const isDate = (v) => v instanceof Date && !isNaN(v.valueOf());
 const isBigint = (v) => typeof v === "bigint";
 const isInfinity = (v) => v === Infinity || v === -Infinity;
@@ -32,4 +31,4 @@ const isNodeListEmpty = (v) => isNodeList(v) && v.length === 0;
 const isHtmlCollection = (v) => v instanceof HTMLCollection;
 const isHtmlCollectionEmpty = (v) => isHtmlCollection(v) && v.length === 0;
 
-export { isArray, isArrayEmpty, isBigint, isBoolean, isClient, isDate, isElement, isError, isFunction, isHtmlCollection, isHtmlCollectionEmpty, isInfinity, isMap, isNaNValue, isNodeList, isNodeListEmpty, isNull, isNumber, isObject, isObjectEmpty, isPrimitive, isRegExp, isSet, isString, isStringEmpty, isSymbol, isURL, isUndefined, noop, now };
+export { isArray, isArrayEmpty, isBigint, isBoolean, isBrowser, isDate, isElement, isError, isFunction, isHtmlCollection, isHtmlCollectionEmpty, isInfinity, isMap, isNaNValue, isNodeList, isNodeListEmpty, isNull, isNumber, isObject, isObjectEmpty, isPrimitive, isRegExp, isSet, isString, isStringEmpty, isSymbol, isURL, isUndefined, noop, toString };

package/package.json

@@ -1,18 +1,24 @@
 {
   "name": "@hypernym/utils",
-  "version": "0.3.0",
+  "version": "1.0.0",
   "author": "Hypernym Studio",
+  "maintainers": [
+    "Ivo Dolenc (https://github.com/ivodolenc)"
+  ],
   "description": "A collection of reusable utilities.",
   "license": "MIT",
+  "funding": "https://github.com/sponsors/ivodolenc",
   "repository": "hypernym-studio/utils",
   "homepage": "https://github.com/hypernym-studio/utils",
   "type": "module",
+  "main": "./dist/utils.cjs",
   "module": "./dist/utils.mjs",
   "types": "./dist/utils.d.ts",
   "exports": {
     ".": {
       "types": "./dist/utils.d.ts",
-      "import": "./dist/utils.mjs"
+      "import": "./dist/utils.mjs",
+      "require": "./dist/utils.cjs"
     }
   },
   "files": [
@@ -30,26 +36,26 @@
   "scripts": {
     "dev": "vite playgrounds/client",
     "dev:node": "vite-node -w playgrounds/node/main.ts",
-    "build": "rollup -c",
+    "build": "rollup -c ./.config/rollup.config.js",
+    "test:types": "vitest -c ./.config/vitest.config.ts typecheck",
     "prepublishOnly": "npm run build",
     "format": "prettier --write .",
     "lint": "eslint .",
     "fix": "eslint --fix ."
   },
   "devDependencies": {
-    "@types/node": "^20.2.5",
-    "@typescript-eslint/eslint-plugin": "^5.59.8",
-    "@typescript-eslint/parser": "^5.59.8",
-    "eslint": "^8.41.0",
-    "eslint-config-prettier": "^8.8.0",
-    "expect-type": "^0.16.0",
+    "@hypernym/eslint-config": "^1.0.1",
+    "@hypernym/prettier-config": "^1.0.1",
+    "@types/node": "^20.3.3",
+    "eslint": "^8.44.0",
     "prettier": "^2.8.8",
-    "rollup": "^3.23.0",
+    "rollup": "^3.26.0",
     "rollup-plugin-dts": "^5.3.0",
     "rollup-plugin-esbuild": "^5.0.0",
     "typescript": "^5.0.4",
     "vite": "^4.3.9",
-    "vite-node": "^0.31.4"
+    "vite-node": "^0.32.2",
+    "vitest": "^0.32.2"
   },
   "publishConfig": {
     "access": "public"
@@ -57,5 +63,5 @@
   "eslintConfig": {
     "extends": "./.config/eslint.config.cjs"
   },
-  "prettier": "./.config/prettier.config.cjs"
+  "prettier": "@hypernym/prettier-config"
 }