@wopjs/cast 0.1.0 → 0.1.2

package/README.md

@@ -6,7 +6,7 @@
 [![Coverage Status](https://img.shields.io/coverallsCoverage/github/wopjs/cast)](https://coveralls.io/github/wopjs/cast)
 [![minified-size](https://img.shields.io/bundlephobia/minzip/@wopjs/cast)](https://bundlephobia.com/package/@wopjs/cast)
 
-cast
+Filter types from unknown.
 
 ## Install
 
@@ -14,6 +14,24 @@ cast
 npm add @wopjs/cast
 ```
 
+## Usage
+
+```js
+import * as c from "@wopjs/cast";
+import { Option } from "@wopjs/tsur";
+
+const dataParser = {
+  width: c.toNumber,
+  position: a => Option.from(a, a => a && c.isNumber(a.x) && c.isNumber(a.y)),
+  metadata: c.toNonEmptyPlainObject,
+};
+
+function parseData(data) {
+  const d = c.asObject(data);
+  return Object.fromEntries(Object.keys(dataParser).map(k => [k, Option.unwrapOr(dataParser[k](d[k]))]));
+}
+```
+
 ## Publish New Version
 
 You can use [npm version](https://docs.npmjs.com/cli/v10/commands/npm-version) to bump version.

package/dist/index.d.mts

@@ -1,9 +1,20 @@
 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>;
 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,26 +30,38 @@ 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 show: (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;
 }
 /** Returns `true` if `x` is an object (including array) and not null. */
 declare const isObject: (x: unknown) => x is object;
-declare const isArray: (arg: any) => arg is any[];
+/** Returns `x` if `x` is an object (including array), otherwise returns `{}` (empty object). */
+declare const asObject: (x: unknown) => object;
 /** 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`.
@@ -50,5 +73,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 _, asNumber, asPlainObject, asString, asTrue, isArray, isBoolean, isNumber, isObject, isPlainObject, isString, isTrue, show, 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 };

package/dist/index.d.ts

@@ -1,9 +1,20 @@
 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>;
 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,26 +30,38 @@ 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 show: (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;
 }
 /** Returns `true` if `x` is an object (including array) and not null. */
 declare const isObject: (x: unknown) => x is object;
-declare const isArray: (arg: any) => arg is any[];
+/** Returns `x` if `x` is an object (including array), otherwise returns `{}` (empty object). */
+declare const asObject: (x: unknown) => object;
 /** 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`.
@@ -50,5 +73,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 _, asNumber, asPlainObject, asString, asTrue, isArray, isBoolean, isNumber, isObject, isPlainObject, isString, isTrue, show, 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 };

package/dist/index.js

@@ -1,10 +1,13 @@
 '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 isBoolean = (x) => x === true || x === false;
 var toBoolean = (x) => isBoolean(x) ? x : _;
 var isNumber = (x) => typeof x === "number" && x === x;
@@ -13,21 +16,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 show = (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 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;
@@ -45,21 +48,57 @@ 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;
+exports.asObject = asObject;
 exports.asPlainObject = asPlainObject;
 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.show = show;
+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;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/primitive.ts"],"names":[],"mappings":";;;AAAA,IAAM,CAAI,GAAA,KAAA,CAAA;AAGG,IAAA,MAAA,GAAS,CAAC,CAAA,KAA0B,CAAM,KAAA;AAGhD,IAAM,MAAS,GAAA,CAAC,CAA0B,KAAA,CAAA,KAAM,OAAO,IAAO,GAAA;AAG9D,IAAM,MAAS,GAAA,CAAC,CAAyB,KAAA,CAAA,KAAM,OAAO,CAAI,GAAA;AAE1D,IAAM,SAAY,GAAA,CAAC,CAA6B,KAAA,CAAA,KAAM,QAAQ,CAAM,KAAA;AAGpE,IAAM,YAAY,CAAC,CAAA,KAA6B,SAAU,CAAA,CAAC,IAAI,CAAI,GAAA;AAGnE,IAAM,WAAW,CAAC,CAAA,KAA4B,OAAO,CAAA,KAAM,YAAY,CAAM,KAAA;AAG7E,IAAM,WAAW,CAAC,CAAA,KAA4B,QAAS,CAAA,CAAC,IAAI,CAAI,GAAA;AAGhE,IAAM,WAAW,CAAC,CAAA,KAAwB,QAAS,CAAA,CAAC,IAAI,CAAI,GAAA;AAG5D,IAAM,QAAW,GAAA,CAAC,CAA4B,KAAA,OAAO,CAAM,KAAA;AAG3D,IAAM,WAAW,CAAC,CAAA,KAA4B,QAAS,CAAA,CAAC,IAAI,CAAI,GAAA;AAGhE,IAAM,WAAW,CAAC,CAAA,KAAwB,QAAS,CAAA,CAAC,IAAI,CAAI,GAAA;AAOtD,IAAA,IAAA,GAAO,CAAC,CAAuB,KAAA;AAC1C,EAAI,IAAA,QAAA,CAAS,CAAC,CAAA,EAAU,OAAA,CAAA;AACxB,EAAI,IAAA,CAAA,IAAK,MAAa,OAAA,EAAA;AACtB,EAAI,IAAA;AACF,IAAA,OAAO,IAAK,CAAA,SAAA,CAAU,CAAG,EAAA,IAAA,EAAM,CAAC,CAAA;AAAA,GAC1B,CAAA,MAAA;AAEN,IAAA,OAAO,CAAI,GAAA,EAAA;AAAA;AAEf;AAOO,IAAM,WAAW,CAAC,CAAA,KAA4B,CAAM,KAAA,IAAA,IAAQ,OAAO,CAAM,KAAA;AAEzE,IAAM,UAAU,KAAM,CAAA;AAGhB,IAAA,aAAA,GAAgB,CAAC,CAAiC,KAAA,QAAA,CAAS,CAAC,CAAK,IAAA,CAAC,QAAQ,CAAC;AAGjF,IAAM,gBAAgB,CAAC,CAAA,KAAiC,aAAc,CAAA,CAAC,IAAI,CAAI,GAAA;AAG/E,IAAM,gBAAgB,CAAC,CAAA,KAA6B,cAAc,CAAC,CAAA,GAAI,IAAI;AAG3E,IAAM,qBAAwB,GAAA,CAAwB,CAC3D,KAAA,aAAA,CAAc,CAAC,CAAA,IAAK,MAAO,CAAA,IAAA,CAAK,CAAC,CAAA,CAAE,MAAS,GAAA,CAAA,GAAI,CAAI,GAAA;AAMzC,IAAA,eAAA,GAAkB,CAAI,CAAA,EAAY,CAA6D,KAAA;AAC1G,EAAI,IAAA,aAAA,CAAc,CAAC,CAAG,EAAA;AACpB,IAAA,IAAI,KAAQ,GAAA,CAAA,CAAA;AACZ,IAAI,IAAA,KAAA,GAAQ,MAAO,CAAA,IAAA,CAAK,CAAC,CAAA;AACzB,IAAA,IAAI,SAAS,KAAM,CAAA,MAAA;AACnB,IAAI,IAAA,MAAA;AAEJ,IAAO,OAAA,EAAE,QAAQ,MAAQ,EAAA;AACvB,MAAI,IAAA,GAAA,GAAM,MAAM,KAAK,CAAA;AACrB,MAAI,IAAA,KAAA,GAAQ,EAAE,GAAG,CAAA;AACjB,MAAI,IAAA,CAAA,CAAE,KAAK,CAAG,EAAA;AACZ,QAAA,CAAC,MAAW,KAAA,EAAI,EAAA,GAAG,CAAI,GAAA,KAAA;AAAA;AACzB;AAGF,IAAO,OAAA,MAAA;AAAA;AAEX;AAGO,IAAM,mBAAsB,GAAA,CAAC,CAAiD,KAAA,eAAA,CAAgB,GAAG,MAAM","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,11 @@
-// 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 isBoolean = (x) => x === true || x === false;
 var toBoolean = (x) => isBoolean(x) ? x : _;
 var isNumber = (x) => typeof x === "number" && x === x;
@@ -11,21 +14,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 show = (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 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;
@@ -43,7 +46,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 { asNumber, asPlainObject, asString, asTrue, isArray, isBoolean, isNumber, isObject, isPlainObject, isString, isTrue, show, 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 };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/primitive.ts"],"names":[],"mappings":";AAAA,IAAM,CAAI,GAAA,KAAA,CAAA;AAGG,IAAA,MAAA,GAAS,CAAC,CAAA,KAA0B,CAAM,KAAA;AAGhD,IAAM,MAAS,GAAA,CAAC,CAA0B,KAAA,CAAA,KAAM,OAAO,IAAO,GAAA;AAG9D,IAAM,MAAS,GAAA,CAAC,CAAyB,KAAA,CAAA,KAAM,OAAO,CAAI,GAAA;AAE1D,IAAM,SAAY,GAAA,CAAC,CAA6B,KAAA,CAAA,KAAM,QAAQ,CAAM,KAAA;AAGpE,IAAM,YAAY,CAAC,CAAA,KAA6B,SAAU,CAAA,CAAC,IAAI,CAAI,GAAA;AAGnE,IAAM,WAAW,CAAC,CAAA,KAA4B,OAAO,CAAA,KAAM,YAAY,CAAM,KAAA;AAG7E,IAAM,WAAW,CAAC,CAAA,KAA4B,QAAS,CAAA,CAAC,IAAI,CAAI,GAAA;AAGhE,IAAM,WAAW,CAAC,CAAA,KAAwB,QAAS,CAAA,CAAC,IAAI,CAAI,GAAA;AAG5D,IAAM,QAAW,GAAA,CAAC,CAA4B,KAAA,OAAO,CAAM,KAAA;AAG3D,IAAM,WAAW,CAAC,CAAA,KAA4B,QAAS,CAAA,CAAC,IAAI,CAAI,GAAA;AAGhE,IAAM,WAAW,CAAC,CAAA,KAAwB,QAAS,CAAA,CAAC,IAAI,CAAI,GAAA;AAOtD,IAAA,IAAA,GAAO,CAAC,CAAuB,KAAA;AAC1C,EAAI,IAAA,QAAA,CAAS,CAAC,CAAA,EAAU,OAAA,CAAA;AACxB,EAAI,IAAA,CAAA,IAAK,MAAa,OAAA,EAAA;AACtB,EAAI,IAAA;AACF,IAAA,OAAO,IAAK,CAAA,SAAA,CAAU,CAAG,EAAA,IAAA,EAAM,CAAC,CAAA;AAAA,GAC1B,CAAA,MAAA;AAEN,IAAA,OAAO,CAAI,GAAA,EAAA;AAAA;AAEf;AAOO,IAAM,WAAW,CAAC,CAAA,KAA4B,CAAM,KAAA,IAAA,IAAQ,OAAO,CAAM,KAAA;AAEzE,IAAM,UAAU,KAAM,CAAA;AAGhB,IAAA,aAAA,GAAgB,CAAC,CAAiC,KAAA,QAAA,CAAS,CAAC,CAAK,IAAA,CAAC,QAAQ,CAAC;AAGjF,IAAM,gBAAgB,CAAC,CAAA,KAAiC,aAAc,CAAA,CAAC,IAAI,CAAI,GAAA;AAG/E,IAAM,gBAAgB,CAAC,CAAA,KAA6B,cAAc,CAAC,CAAA,GAAI,IAAI;AAG3E,IAAM,qBAAwB,GAAA,CAAwB,CAC3D,KAAA,aAAA,CAAc,CAAC,CAAA,IAAK,MAAO,CAAA,IAAA,CAAK,CAAC,CAAA,CAAE,MAAS,GAAA,CAAA,GAAI,CAAI,GAAA;AAMzC,IAAA,eAAA,GAAkB,CAAI,CAAA,EAAY,CAA6D,KAAA;AAC1G,EAAI,IAAA,aAAA,CAAc,CAAC,CAAG,EAAA;AACpB,IAAA,IAAI,KAAQ,GAAA,CAAA,CAAA;AACZ,IAAI,IAAA,KAAA,GAAQ,MAAO,CAAA,IAAA,CAAK,CAAC,CAAA;AACzB,IAAA,IAAI,SAAS,KAAM,CAAA,MAAA;AACnB,IAAI,IAAA,MAAA;AAEJ,IAAO,OAAA,EAAE,QAAQ,MAAQ,EAAA;AACvB,MAAI,IAAA,GAAA,GAAM,MAAM,KAAK,CAAA;AACrB,MAAI,IAAA,KAAA,GAAQ,EAAE,GAAG,CAAA;AACjB,MAAI,IAAA,CAAA,CAAE,KAAK,CAAG,EAAA;AACZ,QAAA,CAAC,MAAW,KAAA,EAAI,EAAA,GAAG,CAAI,GAAA,KAAA;AAAA;AACzB;AAGF,IAAO,OAAA,MAAA;AAAA;AAEX;AAGO,IAAM,mBAAsB,GAAA,CAAC,CAAiD,KAAA,eAAA,CAAgB,GAAG,MAAM","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.0",
+  "version": "0.1.2",
   "description": "Filter types from unknown",
   "repository": "wopjs/cast",
   "main": "./dist/index.js",
@@ -52,9 +52,9 @@
     "prettier": "^3.3.3",
     "pretty-bytes": "^6.1.1",
     "tsup": "^8.3.5",
-    "typedoc": "^0.26.11",
+    "typedoc": "^0.27.5",
     "typescript": "^5.6.3",
-    "typescript-eslint": "^8.14.0",
+    "typescript-eslint": "^8.15.0",
     "vitest": "^2.1.5",
     "yoctocolors": "^2.1.1"
   }

package/src/index.ts

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

package/src/is-to-as.test.ts

@@ -0,0 +1,231 @@
+import { describe, it, expect } from "vitest";
+
+import {
+  isDefined,
+  isTrue,
+  toTrue,
+  asTrue,
+  isTruthy,
+  isFalsy,
+  isBoolean,
+  toBoolean,
+  isNumber,
+  toNumber,
+  asNumber,
+  isString,
+  toString,
+  asString,
+  isNonEmptyString,
+  toNonEmptyString,
+  print,
+  isArray,
+  toArray,
+  asArray,
+  toNonEmptyArray,
+  isObject,
+  asObject,
+  isPlainObject,
+  toPlainObject,
+  asPlainObject,
+  isNonEmptyPlainObject,
+  toNonEmptyPlainObject,
+  isNonEmptyJSONObject,
+  toNonEmptyJSONObject,
+  toPlainObjectOf,
+  toPlainObjectOfTrue,
+} 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);
+    expect(isTrue(1)).toBe(false);
+  });
+
+  it("toTrue", () => {
+    expect(toTrue(true)).toBe(true);
+    expect(toTrue(false)).toBe(undefined);
+    expect(toTrue(1)).toBe(undefined);
+  });
+
+  it("asTrue", () => {
+    expect(asTrue(true)).toBe(true);
+    expect(asTrue(false)).toBe(false);
+    expect(asTrue(1)).toBe(false);
+  });
+
+  it("isTruthy", () => {
+    expect(isTruthy(true)).toBe(true);
+    expect(isTruthy(false)).toBe(false);
+    expect(isTruthy(1)).toBe(true);
+  });
+
+  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);
+    expect(isBoolean(1)).toBe(false);
+  });
+
+  it("toBoolean", () => {
+    expect(toBoolean(true)).toBe(true);
+    expect(toBoolean(false)).toBe(false);
+    expect(toBoolean(1)).toBe(undefined);
+  });
+
+  it("isNumber", () => {
+    expect(isNumber(1)).toBe(true);
+    expect(isNumber(NaN)).toBe(false);
+    expect(isNumber("1")).toBe(false);
+  });
+
+  it("toNumber", () => {
+    expect(toNumber(1)).toBe(1);
+    expect(toNumber(NaN)).toBe(undefined);
+    expect(toNumber("1")).toBe(undefined);
+  });
+
+  it("asNumber", () => {
+    expect(asNumber(1)).toBe(1);
+    expect(asNumber(NaN)).toBe(0);
+    expect(asNumber("1")).toBe(0);
+  });
+
+  it("isString", () => {
+    expect(isString("hello")).toBe(true);
+    expect(isString(1)).toBe(false);
+    expect(isString(true)).toBe(false);
+  });
+
+  it("toString", () => {
+    expect(toString("hello")).toBe("hello");
+    expect(toString(1)).toBe(undefined);
+    expect(toString(true)).toBe(undefined);
+  });
+
+  it("asString", () => {
+    expect(asString("hello")).toBe("hello");
+    expect(asString(1)).toBe("");
+    expect(asString(true)).toBe("");
+  });
+
+  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", () => {
+    expect(isObject({})).toBe(true);
+    expect(isObject([])).toBe(true);
+    expect(isObject(null)).toBe(false);
+  });
+
+  it("asObject", () => {
+    expect(asObject({})).toEqual({});
+    expect(asObject([])).toEqual([]);
+    expect(asObject(null)).toEqual({});
+  });
+
+  it("isPlainObject", () => {
+    expect(isPlainObject({})).toBe(true);
+    expect(isPlainObject([])).toBe(false);
+    expect(isPlainObject(null)).toBe(false);
+  });
+
+  it("toPlainObject", () => {
+    expect(toPlainObject({})).toEqual({});
+    expect(toPlainObject([])).toBe(undefined);
+    expect(toPlainObject(null)).toBe(undefined);
+  });
+
+  it("asPlainObject", () => {
+    expect(asPlainObject({})).toEqual({});
+    expect(asPlainObject([])).toEqual({});
+    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);
+  });
+
+  it("toPlainObjectOfTrue", () => {
+    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,19 @@ 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;
+
 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 +48,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 show = (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;
@@ -55,7 +72,8 @@ export interface PlainObject {
 /** Returns `true` if `x` is an object (including array) and not null. */
 export const isObject = (x: unknown): x is object => x !== null && typeof x === "object";
 
-export const isArray = Array.isArray;
+/** Returns `x` if `x` is an object (including array), otherwise returns `{}` (empty object). */
+export const asObject = (x: unknown): object => (isObject(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);
@@ -66,9 +84,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`.
@@ -95,3 +122,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 => "";