@jeniex/utils 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/browser/index.cjs +17 -2
  2. package/browser/index.d.ts +8 -2
  3. package/browser/index.mjs +14 -3
  4. package/node/index.cjs +17 -2
  5. package/node/index.d.ts +8 -2
  6. package/node/index.mjs +14 -3
  7. package/package.json +1 -1
package/browser/index.cjs CHANGED
@@ -13,14 +13,25 @@ function ensureJoin(object, separator = ',') {
13
13
  return object.join(separator);
14
14
  }
15
15
 
16
+ function noop() { }
17
+
16
18
  function asserted(object) {
17
19
  if (object === null || object === undefined) {
18
- throw new Error('Value is either null or undefined');
20
+ throw new Error('Value is either null or undefined.');
19
21
  }
20
22
  return object;
21
23
  }
22
24
  function isTruthy(object) {
23
- return Boolean(object);
25
+ return Boolean(object) === true;
26
+ }
27
+ function isFalsy(object) {
28
+ return Boolean(object) === false;
29
+ }
30
+ function isNullish(object) {
31
+ return object === null || object === undefined;
32
+ }
33
+ function isNotNullish(object) {
34
+ return object !== null && object !== undefined;
24
35
  }
25
36
 
26
37
  async function sleep(milliSeconds) {
@@ -48,6 +59,10 @@ exports.$ = $;
48
59
  exports.$$ = $$;
49
60
  exports.asserted = asserted;
50
61
  exports.ensureJoin = ensureJoin;
62
+ exports.isFalsy = isFalsy;
63
+ exports.isNotNullish = isNotNullish;
64
+ exports.isNullish = isNullish;
51
65
  exports.isString = isString;
52
66
  exports.isTruthy = isTruthy;
67
+ exports.noop = noop;
53
68
  exports.sleep = sleep;
package/browser/index.d.ts CHANGED
@@ -1,17 +1,23 @@
1
1
  declare function ensureJoin(object: string[] | string, separator?: string): string;
2
2
 
3
+ declare function noop(): void;
4
+
3
5
  declare function asserted<T>(object: T | null | undefined): T;
4
- declare function isTruthy<T>(object: T): object is NonNullable<T>;
6
+ declare function isTruthy<T>(object: T): object is Exclude<T, '' | 0 | false | null | undefined>;
7
+ declare function isFalsy(object: unknown): object is '' | 0 | false | null | undefined;
8
+ declare function isNullish(object: unknown): object is null | undefined;
9
+ declare function isNotNullish<T>(object: T): object is Exclude<T, null | undefined>;
5
10
 
6
11
  declare function isString(object: unknown): object is string;
7
12
 
8
13
  declare function sleep(milliSeconds: number): Promise<void>;
9
14
 
10
15
  type Nullable<T> = T | null | undefined;
16
+ type Fn<T = any, U = void> = (param: T) => U;
11
17
 
12
18
  type Parent = Document | HTMLElement;
13
19
  type Selectors = string[] | string;
14
20
  declare function $<T = HTMLElement>(selectors: Selectors, parent?: Parent): T;
15
21
  declare function $$<T extends Element = HTMLElement>(selectors: Selectors, parent?: Parent): NodeListOf<T>;
16
22
 
17
- export { $, $$, Nullable, asserted, ensureJoin, isString, isTruthy, sleep };
23
+ export { $, $$, Fn, Nullable, asserted, ensureJoin, isFalsy, isNotNullish, isNullish, isString, isTruthy, noop, sleep };
package/browser/index.mjs CHANGED
@@ -11,14 +11,25 @@ function ensureJoin(object, separator = ',') {
11
11
  return object.join(separator);
12
12
  }
13
13
 
14
+ function noop() { }
15
+
14
16
  function asserted(object) {
15
17
  if (object === null || object === undefined) {
16
- throw new Error('Value is either null or undefined');
18
+ throw new Error('Value is either null or undefined.');
17
19
  }
18
20
  return object;
19
21
  }
20
22
  function isTruthy(object) {
21
- return Boolean(object);
23
+ return Boolean(object) === true;
24
+ }
25
+ function isFalsy(object) {
26
+ return Boolean(object) === false;
27
+ }
28
+ function isNullish(object) {
29
+ return object === null || object === undefined;
30
+ }
31
+ function isNotNullish(object) {
32
+ return object !== null && object !== undefined;
22
33
  }
23
34
 
24
35
  async function sleep(milliSeconds) {
@@ -42,4 +53,4 @@ function $$(selectors, parent) {
42
53
  return elements;
43
54
  }
44
55
 
45
- export { $, $$, asserted, ensureJoin, isString, isTruthy, sleep };
56
+ export { $, $$, asserted, ensureJoin, isFalsy, isNotNullish, isNullish, isString, isTruthy, noop, sleep };
package/node/index.cjs CHANGED
@@ -17,14 +17,25 @@ function ensureJoin(object, separator = ',') {
17
17
  return object.join(separator);
18
18
  }
19
19
 
20
+ function noop() { }
21
+
20
22
  function asserted(object) {
21
23
  if (object === null || object === undefined) {
22
- throw new Error('Value is either null or undefined');
24
+ throw new Error('Value is either null or undefined.');
23
25
  }
24
26
  return object;
25
27
  }
26
28
  function isTruthy(object) {
27
- return Boolean(object);
29
+ return Boolean(object) === true;
30
+ }
31
+ function isFalsy(object) {
32
+ return Boolean(object) === false;
33
+ }
34
+ function isNullish(object) {
35
+ return object === null || object === undefined;
36
+ }
37
+ function isNotNullish(object) {
38
+ return object !== null && object !== undefined;
28
39
  }
29
40
 
30
41
  async function sleep(milliSeconds) {
@@ -53,7 +64,11 @@ async function listFolders({ folderPath, getFullPath }) {
53
64
 
54
65
  exports.asserted = asserted;
55
66
  exports.ensureJoin = ensureJoin;
67
+ exports.isFalsy = isFalsy;
68
+ exports.isNotNullish = isNotNullish;
69
+ exports.isNullish = isNullish;
56
70
  exports.isString = isString;
57
71
  exports.isTruthy = isTruthy;
58
72
  exports.listFolders = listFolders;
73
+ exports.noop = noop;
59
74
  exports.sleep = sleep;
package/node/index.d.ts CHANGED
@@ -1,13 +1,19 @@
1
1
  declare function ensureJoin(object: string[] | string, separator?: string): string;
2
2
 
3
+ declare function noop(): void;
4
+
3
5
  declare function asserted<T>(object: T | null | undefined): T;
4
- declare function isTruthy<T>(object: T): object is NonNullable<T>;
6
+ declare function isTruthy<T>(object: T): object is Exclude<T, '' | 0 | false | null | undefined>;
7
+ declare function isFalsy(object: unknown): object is '' | 0 | false | null | undefined;
8
+ declare function isNullish(object: unknown): object is null | undefined;
9
+ declare function isNotNullish<T>(object: T): object is Exclude<T, null | undefined>;
5
10
 
6
11
  declare function isString(object: unknown): object is string;
7
12
 
8
13
  declare function sleep(milliSeconds: number): Promise<void>;
9
14
 
10
15
  type Nullable<T> = T | null | undefined;
16
+ type Fn<T = any, U = void> = (param: T) => U;
11
17
 
12
18
  interface ListFoldersOpt {
13
19
  folderPath: string;
@@ -15,4 +21,4 @@ interface ListFoldersOpt {
15
21
  }
16
22
  declare function listFolders({ folderPath, getFullPath }: ListFoldersOpt): Promise<string[]>;
17
23
 
18
- export { Nullable, asserted, ensureJoin, isString, isTruthy, listFolders, sleep };
24
+ export { Fn, Nullable, asserted, ensureJoin, isFalsy, isNotNullish, isNullish, isString, isTruthy, listFolders, noop, sleep };
package/node/index.mjs CHANGED
@@ -15,14 +15,25 @@ function ensureJoin(object, separator = ',') {
15
15
  return object.join(separator);
16
16
  }
17
17
 
18
+ function noop() { }
19
+
18
20
  function asserted(object) {
19
21
  if (object === null || object === undefined) {
20
- throw new Error('Value is either null or undefined');
22
+ throw new Error('Value is either null or undefined.');
21
23
  }
22
24
  return object;
23
25
  }
24
26
  function isTruthy(object) {
25
- return Boolean(object);
27
+ return Boolean(object) === true;
28
+ }
29
+ function isFalsy(object) {
30
+ return Boolean(object) === false;
31
+ }
32
+ function isNullish(object) {
33
+ return object === null || object === undefined;
34
+ }
35
+ function isNotNullish(object) {
36
+ return object !== null && object !== undefined;
26
37
  }
27
38
 
28
39
  async function sleep(milliSeconds) {
@@ -49,4 +60,4 @@ async function listFolders({ folderPath, getFullPath }) {
49
60
  return folders;
50
61
  }
51
62
 
52
- export { asserted, ensureJoin, isString, isTruthy, listFolders, sleep };
63
+ export { asserted, ensureJoin, isFalsy, isNotNullish, isNullish, isString, isTruthy, listFolders, noop, sleep };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jeniex/utils",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "author": "JenieX",
5
5
  "homepage": "https://github.com/JenieX/utils",
6
6
  "type": "module",