@wopjs/cast 0.1.1 → 0.1.3

package/dist/index.d.mts

@@ -1,9 +1,22 @@
 type _ = undefined;
+/** Returns `true` if `x` is not `undefined`. */
+declare const isDefined: <T>(x: T | undefined) => x is T;
 declare const isTrue: (x: unknown) => x is true;
 /** Returns `true` if `x` is `true`, otherwise returns `undefined`. */
 declare const toTrue: (x: unknown) => true | _;
 /** Returns `true` if `x` is `true`, otherwise returns `false`. */
 declare const asTrue: (x: unknown) => boolean;
+type Falsy = false | null | undefined | 0 | "";
+interface IsFalsy {
+    (x: unknown): x is Falsy;
+    <T>(x: T): x is Extract<T, Falsy>;
+}
+/** Returns `true` if `Boolean(x)` is `false`. */
+declare const isFalsy: IsFalsy;
+/** Returns `true` if `Boolean(x)` is `true`. */
+declare const isTruthy: <T>(x: T) => x is Exclude<T, Falsy>;
+/** Returns `x` if `Boolean(x)` is `true`, otherwise returns `undefined`. */
+declare const toTruthy: <T>(x: T) => Exclude<T, Falsy> | _;
 declare const isBoolean: (x: unknown) => x is boolean;
 /** Returns `x` if `x` is `true` or `false`, otherwise returns `undefined`. */
 declare const toBoolean: (x: unknown) => boolean | _;
@@ -19,12 +32,17 @@ declare const isString: (x: unknown) => x is string;
 declare const toString: (x: unknown) => string | _;
 /** Returns `x` if `x` is a string, otherwise returns `''` (empty string). */
 declare const asString: (x: unknown) => string;
-/**
- * Returns `x` if `x` is string, otherwise returns `''` (empty string) if
- * `x` is `null` or `undefined`, otherwise returns `JSON.stringify(x)`.
- * This is very useful to show a value inside a React component.
- */
-declare const print: (x: unknown) => string;
+/** Returns `true` if `x` is a string and not `''`. */
+declare const isNonEmptyString: (x: unknown) => x is string;
+/** Returns `x` if `x` is a string and not empty, otherwise returns `undefined`. */
+declare const toNonEmptyString: (x: unknown) => string | _;
+declare const isArray: (arg: any) => arg is any[];
+/** Returns `x` if `x` is an array. */
+declare const toArray: (x: unknown) => unknown[] | undefined;
+/** Returns `x` if `x` is an array and has at least one element, otherwise returns `undefined`. */
+declare const toNonEmptyArray: <T>(x: T[]) => T[] | _;
+/** Returns `x` if `x` is an array, otherwise returns `[]` (empty array). */
+declare const asArray: (x: unknown) => unknown[];
 interface PlainObject {
     [key: PropertyKey]: unknown;
 }
@@ -32,19 +50,20 @@ interface PlainObject {
 declare const isObject: (x: unknown) => x is object;
 /** Returns `x` if `x` is an object (including array), otherwise returns `{}` (empty object). */
 declare const asObject: (x: unknown) => object;
-declare const isArray: (arg: any) => arg is any[];
-/** Returns `true` if `x` is an array. */
-declare const toArray: (x: unknown) => unknown[] | undefined;
-/** Returns `x` if `x` is an array, otherwise returns `[]` (empty array). */
-declare const asArray: (x: unknown) => unknown[];
 /** Returns `true` if `x` is a plain object (shallow test), not `null` or array. */
 declare const isPlainObject: (x: unknown) => x is PlainObject;
 /** Returns `x` if `x` is a plain object. */
 declare const toPlainObject: (x: unknown) => PlainObject | _;
 /** Returns `x` if `x` is a plain object, otherwise returns `{}` (empty object). */
 declare const asPlainObject: (x: unknown) => PlainObject;
+/** Returns `true` if `x` is a plain object and has at least one key. */
+declare const isNonEmptyPlainObject: (x: unknown) => x is PlainObject;
 /** Returns `x` if `x` is a plain object and has at least one key. */
 declare const toNonEmptyPlainObject: <T extends PlainObject>(x: T) => T | _;
+/** Returns `true` if `x` is a plain object and has at least one key with non-undefined value. */
+declare const isNonEmptyJSONObject: (x: unknown) => x is PlainObject;
+/** Returns `x` if `x` is a plain object and has at least one key with non-undefined value, otherwise returns `undefined`. */
+declare const toNonEmptyJSONObject: <T extends PlainObject>(x: T) => T | _;
 /**
  * Creates an object from `x` with keys `k` if `f(x[k])` returns `true`.
  * If `x` is not a plain object, or there's no passed props, returns `undefined`.
@@ -56,5 +75,18 @@ declare const toPlainObjectOf: <T>(x: unknown, f: (v: unknown) => v is T) => {
 declare const toPlainObjectOfTrue: (x: unknown) => {
     [key: PropertyKey]: true;
 } | _;
+/**
+ * Returns `x` if `x` is string, otherwise returns `''` (empty string) if
+ * `x` is `null` or `undefined`, otherwise returns `JSON.stringify(x)`.
+ * This is very useful to show a value inside a React component.
+ */
+declare const print: (x: unknown) => string;
+
+declare const noop: () => void;
+declare const returnsUndefined: () => undefined;
+declare const returnsNull: () => null;
+declare const returnsFalse: () => false;
+declare const returnsTrue: () => true;
+declare const returnsEmptyString: () => string;
 
-export { type PlainObject, type _, asArray, asNumber, asObject, asPlainObject, asString, asTrue, isArray, isBoolean, isNumber, isObject, isPlainObject, isString, isTrue, print, toArray, toBoolean, toNonEmptyPlainObject, toNumber, toPlainObject, toPlainObjectOf, toPlainObjectOfTrue, toString, toTrue };
+export { type Falsy, type IsFalsy, type PlainObject, type _, asArray, asNumber, asObject, asPlainObject, asString, asTrue, isArray, isBoolean, isDefined, isFalsy, isNonEmptyJSONObject, isNonEmptyPlainObject, isNonEmptyString, isNumber, isObject, isPlainObject, isString, isTrue, isTruthy, noop, print, returnsEmptyString, returnsFalse, returnsNull, returnsTrue, returnsUndefined, toArray, toBoolean, toNonEmptyArray, toNonEmptyJSONObject, toNonEmptyPlainObject, toNonEmptyString, toNumber, toPlainObject, toPlainObjectOf, toPlainObjectOfTrue, toString, toTrue, toTruthy };

package/dist/index.d.ts

@@ -1,9 +1,22 @@
 type _ = undefined;
+/** Returns `true` if `x` is not `undefined`. */
+declare const isDefined: <T>(x: T | undefined) => x is T;
 declare const isTrue: (x: unknown) => x is true;
 /** Returns `true` if `x` is `true`, otherwise returns `undefined`. */
 declare const toTrue: (x: unknown) => true | _;
 /** Returns `true` if `x` is `true`, otherwise returns `false`. */
 declare const asTrue: (x: unknown) => boolean;
+type Falsy = false | null | undefined | 0 | "";
+interface IsFalsy {
+    (x: unknown): x is Falsy;
+    <T>(x: T): x is Extract<T, Falsy>;
+}
+/** Returns `true` if `Boolean(x)` is `false`. */
+declare const isFalsy: IsFalsy;
+/** Returns `true` if `Boolean(x)` is `true`. */
+declare const isTruthy: <T>(x: T) => x is Exclude<T, Falsy>;
+/** Returns `x` if `Boolean(x)` is `true`, otherwise returns `undefined`. */
+declare const toTruthy: <T>(x: T) => Exclude<T, Falsy> | _;
 declare const isBoolean: (x: unknown) => x is boolean;
 /** Returns `x` if `x` is `true` or `false`, otherwise returns `undefined`. */
 declare const toBoolean: (x: unknown) => boolean | _;
@@ -19,12 +32,17 @@ declare const isString: (x: unknown) => x is string;
 declare const toString: (x: unknown) => string | _;
 /** Returns `x` if `x` is a string, otherwise returns `''` (empty string). */
 declare const asString: (x: unknown) => string;
-/**
- * Returns `x` if `x` is string, otherwise returns `''` (empty string) if
- * `x` is `null` or `undefined`, otherwise returns `JSON.stringify(x)`.
- * This is very useful to show a value inside a React component.
- */
-declare const print: (x: unknown) => string;
+/** Returns `true` if `x` is a string and not `''`. */
+declare const isNonEmptyString: (x: unknown) => x is string;
+/** Returns `x` if `x` is a string and not empty, otherwise returns `undefined`. */
+declare const toNonEmptyString: (x: unknown) => string | _;
+declare const isArray: (arg: any) => arg is any[];
+/** Returns `x` if `x` is an array. */
+declare const toArray: (x: unknown) => unknown[] | undefined;
+/** Returns `x` if `x` is an array and has at least one element, otherwise returns `undefined`. */
+declare const toNonEmptyArray: <T>(x: T[]) => T[] | _;
+/** Returns `x` if `x` is an array, otherwise returns `[]` (empty array). */
+declare const asArray: (x: unknown) => unknown[];
 interface PlainObject {
     [key: PropertyKey]: unknown;
 }
@@ -32,19 +50,20 @@ interface PlainObject {
 declare const isObject: (x: unknown) => x is object;
 /** Returns `x` if `x` is an object (including array), otherwise returns `{}` (empty object). */
 declare const asObject: (x: unknown) => object;
-declare const isArray: (arg: any) => arg is any[];
-/** Returns `true` if `x` is an array. */
-declare const toArray: (x: unknown) => unknown[] | undefined;
-/** Returns `x` if `x` is an array, otherwise returns `[]` (empty array). */
-declare const asArray: (x: unknown) => unknown[];
 /** Returns `true` if `x` is a plain object (shallow test), not `null` or array. */
 declare const isPlainObject: (x: unknown) => x is PlainObject;
 /** Returns `x` if `x` is a plain object. */
 declare const toPlainObject: (x: unknown) => PlainObject | _;
 /** Returns `x` if `x` is a plain object, otherwise returns `{}` (empty object). */
 declare const asPlainObject: (x: unknown) => PlainObject;
+/** Returns `true` if `x` is a plain object and has at least one key. */
+declare const isNonEmptyPlainObject: (x: unknown) => x is PlainObject;
 /** Returns `x` if `x` is a plain object and has at least one key. */
 declare const toNonEmptyPlainObject: <T extends PlainObject>(x: T) => T | _;
+/** Returns `true` if `x` is a plain object and has at least one key with non-undefined value. */
+declare const isNonEmptyJSONObject: (x: unknown) => x is PlainObject;
+/** Returns `x` if `x` is a plain object and has at least one key with non-undefined value, otherwise returns `undefined`. */
+declare const toNonEmptyJSONObject: <T extends PlainObject>(x: T) => T | _;
 /**
  * Creates an object from `x` with keys `k` if `f(x[k])` returns `true`.
  * If `x` is not a plain object, or there's no passed props, returns `undefined`.
@@ -56,5 +75,18 @@ declare const toPlainObjectOf: <T>(x: unknown, f: (v: unknown) => v is T) => {
 declare const toPlainObjectOfTrue: (x: unknown) => {
     [key: PropertyKey]: true;
 } | _;
+/**
+ * Returns `x` if `x` is string, otherwise returns `''` (empty string) if
+ * `x` is `null` or `undefined`, otherwise returns `JSON.stringify(x)`.
+ * This is very useful to show a value inside a React component.
+ */
+declare const print: (x: unknown) => string;
+
+declare const noop: () => void;
+declare const returnsUndefined: () => undefined;
+declare const returnsNull: () => null;
+declare const returnsFalse: () => false;
+declare const returnsTrue: () => true;
+declare const returnsEmptyString: () => string;
 
-export { type PlainObject, type _, asArray, asNumber, asObject, asPlainObject, asString, asTrue, isArray, isBoolean, isNumber, isObject, isPlainObject, isString, isTrue, print, toArray, toBoolean, toNonEmptyPlainObject, toNumber, toPlainObject, toPlainObjectOf, toPlainObjectOfTrue, toString, toTrue };
+export { type Falsy, type IsFalsy, type PlainObject, type _, asArray, asNumber, asObject, asPlainObject, asString, asTrue, isArray, isBoolean, isDefined, isFalsy, isNonEmptyJSONObject, isNonEmptyPlainObject, isNonEmptyString, isNumber, isObject, isPlainObject, isString, isTrue, isTruthy, noop, print, returnsEmptyString, returnsFalse, returnsNull, returnsTrue, returnsUndefined, toArray, toBoolean, toNonEmptyArray, toNonEmptyJSONObject, toNonEmptyPlainObject, toNonEmptyString, toNumber, toPlainObject, toPlainObjectOf, toPlainObjectOfTrue, toString, toTrue, toTruthy };

package/dist/index.js

@@ -1,10 +1,14 @@
 'use strict';
 
-// src/primitive.ts
+// src/is-to-as.ts
 var _ = void 0;
+var isDefined = (x) => x !== _;
 var isTrue = (x) => x === true;
 var toTrue = (x) => x === true ? true : _;
 var asTrue = (x) => x === true ? x : false;
+var isFalsy = (x) => !x;
+var isTruthy = (x) => !!x;
+var toTruthy = (x) => isTruthy(x) ? x : _;
 var isBoolean = (x) => x === true || x === false;
 var toBoolean = (x) => isBoolean(x) ? x : _;
 var isNumber = (x) => typeof x === "number" && x === x;
@@ -13,24 +17,21 @@ var asNumber = (x) => isNumber(x) ? x : 0;
 var isString = (x) => typeof x === "string";
 var toString = (x) => isString(x) ? x : _;
 var asString = (x) => isString(x) ? x : "";
-var print = (x) => {
-  if (isString(x)) return x;
-  if (x == null) return "";
-  try {
-    return JSON.stringify(x, null, 2);
-  } catch {
-    return x + "";
-  }
-};
-var isObject = (x) => x !== null && typeof x === "object";
-var asObject = (x) => isObject(x) ? x : {};
+var isNonEmptyString = (x) => isString(x) && x !== "";
+var toNonEmptyString = (x) => isNonEmptyString(x) ? x : _;
 var isArray = Array.isArray;
 var toArray = (x) => isArray(x) ? x : _;
+var toNonEmptyArray = (x) => x.length > 0 ? x : _;
 var asArray = (x) => isArray(x) ? x : [];
+var isObject = (x) => x !== null && typeof x === "object";
+var asObject = (x) => isObject(x) ? x : {};
 var isPlainObject = (x) => isObject(x) && !isArray(x);
 var toPlainObject = (x) => isPlainObject(x) ? x : _;
 var asPlainObject = (x) => isPlainObject(x) ? x : {};
-var toNonEmptyPlainObject = (x) => isPlainObject(x) && Object.keys(x).length > 0 ? x : _;
+var isNonEmptyPlainObject = (x) => isPlainObject(x) && Object.keys(x).length > 0;
+var toNonEmptyPlainObject = (x) => isNonEmptyPlainObject(x) ? x : _;
+var isNonEmptyJSONObject = (x) => isPlainObject(x) && Object.values(x).some(isDefined);
+var toNonEmptyJSONObject = (x) => isNonEmptyJSONObject(x) ? x : _;
 var toPlainObjectOf = (x, f) => {
   if (isPlainObject(x)) {
     let index = -1;
@@ -48,6 +49,24 @@ var toPlainObjectOf = (x, f) => {
   }
 };
 var toPlainObjectOfTrue = (x) => toPlainObjectOf(x, isTrue);
+var print = (x) => {
+  if (isString(x)) return x;
+  if (x == null) return "";
+  try {
+    return JSON.stringify(x, null, 2);
+  } catch {
+    return x + "";
+  }
+};
+
+// src/returns.ts
+var noop = () => {
+};
+var returnsUndefined = noop;
+var returnsNull = () => null;
+var returnsFalse = () => false;
+var returnsTrue = () => true;
+var returnsEmptyString = () => "";
 
 exports.asArray = asArray;
 exports.asNumber = asNumber;
@@ -57,20 +76,36 @@ exports.asString = asString;
 exports.asTrue = asTrue;
 exports.isArray = isArray;
 exports.isBoolean = isBoolean;
+exports.isDefined = isDefined;
+exports.isFalsy = isFalsy;
+exports.isNonEmptyJSONObject = isNonEmptyJSONObject;
+exports.isNonEmptyPlainObject = isNonEmptyPlainObject;
+exports.isNonEmptyString = isNonEmptyString;
 exports.isNumber = isNumber;
 exports.isObject = isObject;
 exports.isPlainObject = isPlainObject;
 exports.isString = isString;
 exports.isTrue = isTrue;
+exports.isTruthy = isTruthy;
+exports.noop = noop;
 exports.print = print;
+exports.returnsEmptyString = returnsEmptyString;
+exports.returnsFalse = returnsFalse;
+exports.returnsNull = returnsNull;
+exports.returnsTrue = returnsTrue;
+exports.returnsUndefined = returnsUndefined;
 exports.toArray = toArray;
 exports.toBoolean = toBoolean;
+exports.toNonEmptyArray = toNonEmptyArray;
+exports.toNonEmptyJSONObject = toNonEmptyJSONObject;
 exports.toNonEmptyPlainObject = toNonEmptyPlainObject;
+exports.toNonEmptyString = toNonEmptyString;
 exports.toNumber = toNumber;
 exports.toPlainObject = toPlainObject;
 exports.toPlainObjectOf = toPlainObjectOf;
 exports.toPlainObjectOfTrue = toPlainObjectOfTrue;
 exports.toString = toString;
 exports.toTrue = toTrue;
+exports.toTruthy = toTruthy;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/primitive.ts"],"names":[],"mappings":"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","file":"index.js"}
+{"version":3,"sources":["../src/is-to-as.ts","../src/returns.ts"],"names":[],"mappings":"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","file":"index.js"}

package/dist/index.mjs

@@ -1,8 +1,12 @@
-// src/primitive.ts
+// src/is-to-as.ts
 var _ = void 0;
+var isDefined = (x) => x !== _;
 var isTrue = (x) => x === true;
 var toTrue = (x) => x === true ? true : _;
 var asTrue = (x) => x === true ? x : false;
+var isFalsy = (x) => !x;
+var isTruthy = (x) => !!x;
+var toTruthy = (x) => isTruthy(x) ? x : _;
 var isBoolean = (x) => x === true || x === false;
 var toBoolean = (x) => isBoolean(x) ? x : _;
 var isNumber = (x) => typeof x === "number" && x === x;
@@ -11,24 +15,21 @@ var asNumber = (x) => isNumber(x) ? x : 0;
 var isString = (x) => typeof x === "string";
 var toString = (x) => isString(x) ? x : _;
 var asString = (x) => isString(x) ? x : "";
-var print = (x) => {
-  if (isString(x)) return x;
-  if (x == null) return "";
-  try {
-    return JSON.stringify(x, null, 2);
-  } catch {
-    return x + "";
-  }
-};
-var isObject = (x) => x !== null && typeof x === "object";
-var asObject = (x) => isObject(x) ? x : {};
+var isNonEmptyString = (x) => isString(x) && x !== "";
+var toNonEmptyString = (x) => isNonEmptyString(x) ? x : _;
 var isArray = Array.isArray;
 var toArray = (x) => isArray(x) ? x : _;
+var toNonEmptyArray = (x) => x.length > 0 ? x : _;
 var asArray = (x) => isArray(x) ? x : [];
+var isObject = (x) => x !== null && typeof x === "object";
+var asObject = (x) => isObject(x) ? x : {};
 var isPlainObject = (x) => isObject(x) && !isArray(x);
 var toPlainObject = (x) => isPlainObject(x) ? x : _;
 var asPlainObject = (x) => isPlainObject(x) ? x : {};
-var toNonEmptyPlainObject = (x) => isPlainObject(x) && Object.keys(x).length > 0 ? x : _;
+var isNonEmptyPlainObject = (x) => isPlainObject(x) && Object.keys(x).length > 0;
+var toNonEmptyPlainObject = (x) => isNonEmptyPlainObject(x) ? x : _;
+var isNonEmptyJSONObject = (x) => isPlainObject(x) && Object.values(x).some(isDefined);
+var toNonEmptyJSONObject = (x) => isNonEmptyJSONObject(x) ? x : _;
 var toPlainObjectOf = (x, f) => {
   if (isPlainObject(x)) {
     let index = -1;
@@ -46,7 +47,25 @@ var toPlainObjectOf = (x, f) => {
   }
 };
 var toPlainObjectOfTrue = (x) => toPlainObjectOf(x, isTrue);
+var print = (x) => {
+  if (isString(x)) return x;
+  if (x == null) return "";
+  try {
+    return JSON.stringify(x, null, 2);
+  } catch {
+    return x + "";
+  }
+};
+
+// src/returns.ts
+var noop = () => {
+};
+var returnsUndefined = noop;
+var returnsNull = () => null;
+var returnsFalse = () => false;
+var returnsTrue = () => true;
+var returnsEmptyString = () => "";
 
-export { asArray, asNumber, asObject, asPlainObject, asString, asTrue, isArray, isBoolean, isNumber, isObject, isPlainObject, isString, isTrue, print, toArray, toBoolean, toNonEmptyPlainObject, toNumber, toPlainObject, toPlainObjectOf, toPlainObjectOfTrue, toString, toTrue };
+export { asArray, asNumber, asObject, asPlainObject, asString, asTrue, isArray, isBoolean, isDefined, isFalsy, isNonEmptyJSONObject, isNonEmptyPlainObject, isNonEmptyString, isNumber, isObject, isPlainObject, isString, isTrue, isTruthy, noop, print, returnsEmptyString, returnsFalse, returnsNull, returnsTrue, returnsUndefined, toArray, toBoolean, toNonEmptyArray, toNonEmptyJSONObject, toNonEmptyPlainObject, toNonEmptyString, toNumber, toPlainObject, toPlainObjectOf, toPlainObjectOfTrue, toString, toTrue, toTruthy };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/primitive.ts"],"names":[],"mappings":"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","file":"index.mjs"}
+{"version":3,"sources":["../src/is-to-as.ts","../src/returns.ts"],"names":[],"mappings":"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","file":"index.mjs"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wopjs/cast",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Filter types from unknown",
   "repository": "wopjs/cast",
   "main": "./dist/index.js",
@@ -41,21 +41,21 @@
   "license": "MIT",
   "devDependencies": {
     "@eslint/js": "^9.15.0",
-    "@types/node": "^22.9.0",
-    "@vitest/coverage-v8": "^2.1.5",
+    "@types/node": "^24.9.1",
+    "@vitest/coverage-v8": "^4.0.4",
     "commit-and-tag-version": "^12.5.0",
     "eslint": "^9.15.0",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-import-resolver-typescript": "^3.6.3",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.31.0",
     "gzip-size": "^7.0.0",
     "prettier": "^3.3.3",
-    "pretty-bytes": "^6.1.1",
+    "pretty-bytes": "^7.1.0",
     "tsup": "^8.3.5",
-    "typedoc": "^0.26.11",
+    "typedoc": "^0.28.14",
     "typescript": "^5.6.3",
-    "typescript-eslint": "^8.14.0",
-    "vitest": "^2.1.5",
+    "typescript-eslint": "^8.15.0",
+    "vitest": "^4.0.4",
     "yoctocolors": "^2.1.1"
   }
 }

package/src/index.ts

@@ -1 +1,2 @@
-export * from "./primitive";
+export * from "./is-to-as";
+export * from "./returns";

package/src/{primitive.test.ts → is-to-as.test.ts}

@@ -1,9 +1,12 @@
 import { describe, it, expect } from "vitest";
 
 import {
+  isDefined,
   isTrue,
   toTrue,
   asTrue,
+  isTruthy,
+  isFalsy,
   isBoolean,
   toBoolean,
   isNumber,
@@ -12,18 +15,33 @@ import {
   isString,
   toString,
   asString,
+  isNonEmptyString,
+  toNonEmptyString,
   print,
-  isObject,
   isArray,
+  toArray,
+  asArray,
+  toNonEmptyArray,
+  isObject,
+  asObject,
   isPlainObject,
   toPlainObject,
   asPlainObject,
+  isNonEmptyPlainObject,
   toNonEmptyPlainObject,
+  isNonEmptyJSONObject,
+  toNonEmptyJSONObject,
   toPlainObjectOf,
   toPlainObjectOfTrue,
+  toTruthy,
 } from ".";
 
 describe("primitive.ts", () => {
+  it("isDefined", () => {
+    expect(isDefined(1)).toBe(true);
+    expect(isDefined(undefined)).toBe(false);
+  });
+
   it("isTrue", () => {
     expect(isTrue(true)).toBe(true);
     expect(isTrue(false)).toBe(false);
@@ -42,6 +60,34 @@ describe("primitive.ts", () => {
     expect(asTrue(1)).toBe(false);
   });
 
+  it("isTruthy", () => {
+    expect(isTruthy(true)).toBe(true);
+    expect(isTruthy(false)).toBe(false);
+    expect(isTruthy(1)).toBe(true);
+  });
+
+  it("toTruthy", () => {
+    const expectTruthy = (o: unknown) => expect(toTruthy(o)).toBe(o);
+    expectTruthy({});
+    expectTruthy([]);
+    expectTruthy("string");
+    expectTruthy(Symbol());
+    expectTruthy(1);
+    expectTruthy(true);
+
+    expect(toTruthy(false)).toBe(undefined);
+    expect(toTruthy(0)).toBe(undefined);
+    expect(toTruthy(NaN)).toBe(undefined);
+    expect(toTruthy(null)).toBe(undefined);
+    expect(toTruthy(undefined)).toBe(undefined);
+  });
+
+  it("isFalsy", () => {
+    expect(isFalsy(true)).toBe(false);
+    expect(isFalsy(false)).toBe(true);
+    expect(isFalsy(1)).toBe(false);
+  });
+
   it("isBoolean", () => {
     expect(isBoolean(true)).toBe(true);
     expect(isBoolean(false)).toBe(true);
@@ -90,20 +136,36 @@ describe("primitive.ts", () => {
     expect(asString(true)).toBe("");
   });
 
-  it("show", () => {
-    expect(print("hello")).toBe("hello");
-    expect(print(null)).toBe("");
-    expect(print({ a: 1 })).toBe(JSON.stringify({ a: 1 }, null, 2));
-    expect(
-      print({
-        toJSON() {
-          throw new Error("x");
-        },
-        toString() {
-          return "str";
-        },
-      })
-    ).toBe("str");
+  it("isNonEmptyString", () => {
+    expect(isNonEmptyString("hello")).toBe(true);
+    expect(isNonEmptyString("")).toBe(false);
+    expect(isNonEmptyString(1)).toBe(false);
+  });
+
+  it("toNonEmptyString", () => {
+    expect(toNonEmptyString("hello")).toBe("hello");
+    expect(toNonEmptyString("")).toBe(undefined);
+    expect(toNonEmptyString(1)).toBe(undefined);
+  });
+
+  it("isArray", () => {
+    expect(isArray([])).toBe(true);
+    expect(isArray({})).toBe(false);
+  });
+
+  it("toArray", () => {
+    expect(toArray([])).toEqual([]);
+    expect(toArray({})).toBe(undefined);
+  });
+
+  it("asArray", () => {
+    expect(asArray([])).toEqual([]);
+    expect(asArray({})).toEqual([]);
+  });
+
+  it("toNonEmptyArray", () => {
+    expect(toNonEmptyArray([1])).toEqual([1]);
+    expect(toNonEmptyArray([])).toBe(undefined);
   });
 
   it("isObject", () => {
@@ -112,9 +174,10 @@ describe("primitive.ts", () => {
     expect(isObject(null)).toBe(false);
   });
 
-  it("isArray", () => {
-    expect(isArray([])).toBe(true);
-    expect(isArray({})).toBe(false);
+  it("asObject", () => {
+    expect(asObject({})).toEqual({});
+    expect(asObject([])).toEqual([]);
+    expect(asObject(null)).toEqual({});
   });
 
   it("isPlainObject", () => {
@@ -135,11 +198,28 @@ describe("primitive.ts", () => {
     expect(asPlainObject(null)).toEqual({});
   });
 
+  it("isNonEmptyPlainObject", () => {
+    expect(isNonEmptyPlainObject({ a: 1 })).toBe(true);
+    expect(isNonEmptyPlainObject({})).toBe(false);
+    expect(isNonEmptyPlainObject([])).toBe(false);
+  });
+
   it("toNonEmptyPlainObject", () => {
     expect(toNonEmptyPlainObject({ a: 1 })).toEqual({ a: 1 });
     expect(toNonEmptyPlainObject({})).toBe(undefined);
   });
 
+  it("isNonEmptyJSONObject", () => {
+    expect(isNonEmptyJSONObject({ a: 1 })).toBe(true);
+    expect(isNonEmptyJSONObject({})).toBe(false);
+    expect(isNonEmptyJSONObject([])).toBe(false);
+  });
+
+  it("toNonEmptyJSONObject", () => {
+    expect(toNonEmptyJSONObject({ a: 1 })).toEqual({ a: 1 });
+    expect(toNonEmptyJSONObject({})).toBe(undefined);
+  });
+
   it("toPlainObjectOf", () => {
     expect(toPlainObjectOf({ a: true, b: false }, isTrue)).toEqual({ a: true });
     expect(toPlainObjectOf({ a: 1, b: 2 }, isTrue)).toBe(undefined);
@@ -149,4 +229,20 @@ describe("primitive.ts", () => {
     expect(toPlainObjectOfTrue({ a: true, b: false })).toEqual({ a: true });
     expect(toPlainObjectOfTrue({ a: 1, b: 2 })).toBe(undefined);
   });
+
+  it("show", () => {
+    expect(print("hello")).toBe("hello");
+    expect(print(null)).toBe("");
+    expect(print({ a: 1 })).toBe(JSON.stringify({ a: 1 }, null, 2));
+    expect(
+      print({
+        toJSON() {
+          throw new Error("x");
+        },
+        toString() {
+          return "str";
+        },
+      })
+    ).toBe("str");
+  });
 });

package/src/{primitive.ts → is-to-as.ts}

@@ -1,6 +1,9 @@
 const _ = undefined;
 export type _ = undefined;
 
+/** Returns `true` if `x` is not `undefined`. */
+export const isDefined = <T>(x: T | undefined): x is T => x !== _;
+
 export const isTrue = (x: unknown): x is true => x === true;
 
 /** Returns `true` if `x` is `true`, otherwise returns `undefined`. */
@@ -9,6 +12,22 @@ export const toTrue = (x: unknown): true | _ => (x === true ? true : _);
 /** Returns `true` if `x` is `true`, otherwise returns `false`. */
 export const asTrue = (x: unknown): boolean => (x === true ? x : false);
 
+export type Falsy = false | null | undefined | 0 | "";
+
+export interface IsFalsy {
+  (x: unknown): x is Falsy;
+  <T>(x: T): x is Extract<T, Falsy>;
+}
+
+/** Returns `true` if `Boolean(x)` is `false`. */
+export const isFalsy: IsFalsy = (x: unknown): x is Falsy => !x;
+
+/** Returns `true` if `Boolean(x)` is `true`. */
+export const isTruthy = <T>(x: T): x is Exclude<T, Falsy> => !!x;
+
+/** Returns `x` if `Boolean(x)` is `true`, otherwise returns `undefined`. */
+export const toTruthy = <T>(x: T): Exclude<T, Falsy> | _ => (isTruthy(x) ? x : _);
+
 export const isBoolean = (x: unknown): x is boolean => x === true || x === false;
 
 /** Returns `x` if `x` is `true` or `false`, otherwise returns `undefined`. */
@@ -32,21 +51,22 @@ export const toString = (x: unknown): string | _ => (isString(x) ? x : _);
 /** Returns `x` if `x` is a string, otherwise returns `''` (empty string). */
 export const asString = (x: unknown): string => (isString(x) ? x : "");
 
-/**
- * Returns `x` if `x` is string, otherwise returns `''` (empty string) if
- * `x` is `null` or `undefined`, otherwise returns `JSON.stringify(x)`.
- * This is very useful to show a value inside a React component.
- */
-export const print = (x: unknown): string => {
-  if (isString(x)) return x;
-  if (x == null) return "";
-  try {
-    return JSON.stringify(x, null, 2);
-  } catch {
-    // Insane case is not handled: x = { toString: () => { throw x } }
-    return x + "";
-  }
-};
+/** Returns `true` if `x` is a string and not `''`. */
+export const isNonEmptyString = (x: unknown): x is string => isString(x) && x !== "";
+
+/** Returns `x` if `x` is a string and not empty, otherwise returns `undefined`. */
+export const toNonEmptyString = (x: unknown): string | _ => (isNonEmptyString(x) ? x : _);
+
+export const isArray = Array.isArray;
+
+/** Returns `x` if `x` is an array. */
+export const toArray = (x: unknown): unknown[] | undefined => (isArray(x) ? x : _);
+
+/** Returns `x` if `x` is an array and has at least one element, otherwise returns `undefined`. */
+export const toNonEmptyArray = <T>(x: T[]): T[] | _ => (x.length > 0 ? x : _);
+
+/** Returns `x` if `x` is an array, otherwise returns `[]` (empty array). */
+export const asArray = (x: unknown): unknown[] => (isArray(x) ? x : []);
 
 export interface PlainObject {
   [key: PropertyKey]: unknown;
@@ -58,14 +78,6 @@ export const isObject = (x: unknown): x is object => x !== null && typeof x ===
 /** Returns `x` if `x` is an object (including array), otherwise returns `{}` (empty object). */
 export const asObject = (x: unknown): object => (isObject(x) ? x : {});
 
-export const isArray = Array.isArray;
-
-/** Returns `true` if `x` is an array. */
-export const toArray = (x: unknown): unknown[] | undefined => (isArray(x) ? x : _);
-
-/** Returns `x` if `x` is an array, otherwise returns `[]` (empty array). */
-export const asArray = (x: unknown): unknown[] => (isArray(x) ? x : []);
-
 /** Returns `true` if `x` is a plain object (shallow test), not `null` or array. */
 export const isPlainObject = (x: unknown): x is PlainObject => isObject(x) && !isArray(x);
 
@@ -75,9 +87,18 @@ export const toPlainObject = (x: unknown): PlainObject | _ => (isPlainObject(x)
 /** Returns `x` if `x` is a plain object, otherwise returns `{}` (empty object). */
 export const asPlainObject = (x: unknown): PlainObject => (isPlainObject(x) ? x : {});
 
+/** Returns `true` if `x` is a plain object and has at least one key. */
+export const isNonEmptyPlainObject = (x: unknown): x is PlainObject => isPlainObject(x) && Object.keys(x).length > 0;
+
 /** Returns `x` if `x` is a plain object and has at least one key. */
-export const toNonEmptyPlainObject = <T extends PlainObject>(x: T): T | _ =>
-  isPlainObject(x) && Object.keys(x).length > 0 ? x : _;
+export const toNonEmptyPlainObject = <T extends PlainObject>(x: T): T | _ => (isNonEmptyPlainObject(x) ? x : _);
+
+/** Returns `true` if `x` is a plain object and has at least one key with non-undefined value. */
+export const isNonEmptyJSONObject = (x: unknown): x is PlainObject =>
+  isPlainObject(x) && Object.values(x).some(isDefined);
+
+/** Returns `x` if `x` is a plain object and has at least one key with non-undefined value, otherwise returns `undefined`. */
+export const toNonEmptyJSONObject = <T extends PlainObject>(x: T): T | _ => (isNonEmptyJSONObject(x) ? x : _);
 
 /**
  * Creates an object from `x` with keys `k` if `f(x[k])` returns `true`.
@@ -104,3 +125,19 @@ export const toPlainObjectOf = <T>(x: unknown, f: (v: unknown) => v is T): { [ke
 
 /** Filter props from object `x` whose values are `true`. */
 export const toPlainObjectOfTrue = (x: unknown): { [key: PropertyKey]: true } | _ => toPlainObjectOf(x, isTrue);
+
+/**
+ * Returns `x` if `x` is string, otherwise returns `''` (empty string) if
+ * `x` is `null` or `undefined`, otherwise returns `JSON.stringify(x)`.
+ * This is very useful to show a value inside a React component.
+ */
+export const print = (x: unknown): string => {
+  if (isString(x)) return x;
+  if (x == null) return "";
+  try {
+    return JSON.stringify(x, null, 2);
+  } catch {
+    // Insane case is not handled: x = { toString: () => { throw x } }
+    return x + "";
+  }
+};

package/src/returns.test.ts

@@ -0,0 +1,29 @@
+import { describe, it, expect } from "vitest";
+
+import { noop, returnsUndefined, returnsNull, returnsFalse, returnsTrue, returnsEmptyString } from "./returns";
+
+describe("returns functions", () => {
+  it("noop should return undefined", () => {
+    expect(noop()).toBeUndefined();
+  });
+
+  it("returnsUndefined should return undefined", () => {
+    expect(returnsUndefined()).toBeUndefined();
+  });
+
+  it("returnsNull should return null", () => {
+    expect(returnsNull()).toBeNull();
+  });
+
+  it("returnsFalse should return false", () => {
+    expect(returnsFalse()).toBe(false);
+  });
+
+  it("returnsTrue should return true", () => {
+    expect(returnsTrue()).toBe(true);
+  });
+
+  it("returnsEmptyString should return an empty string", () => {
+    expect(returnsEmptyString()).toBe("");
+  });
+});

package/src/returns.ts

@@ -0,0 +1,11 @@
+export const noop = (): void => {};
+
+export const returnsUndefined = noop as () => undefined;
+
+export const returnsNull = (): null => null;
+
+export const returnsFalse = (): false => false;
+
+export const returnsTrue = (): true => true;
+
+export const returnsEmptyString = (): string => "";