@wopjs/cast 0.1.0 → 0.1.1

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

@@ -24,13 +24,19 @@ declare const asString: (x: unknown) => string;
  * `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;
+declare const print: (x: unknown) => string;
 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;
+/** 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. */
@@ -51,4 +57,4 @@ declare const toPlainObjectOfTrue: (x: unknown) => {
     [key: PropertyKey]: true;
 } | _;
 
-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 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 };

package/dist/index.d.ts

@@ -24,13 +24,19 @@ declare const asString: (x: unknown) => string;
  * `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;
+declare const print: (x: unknown) => string;
 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;
+/** 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. */
@@ -51,4 +57,4 @@ declare const toPlainObjectOfTrue: (x: unknown) => {
     [key: PropertyKey]: true;
 } | _;
 
-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 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 };

package/dist/index.js

@@ -13,7 +13,7 @@ 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) => {
+var print = (x) => {
   if (isString(x)) return x;
   if (x == null) return "";
   try {
@@ -23,7 +23,10 @@ var show = (x) => {
   }
 };
 var isObject = (x) => x !== null && typeof x === "object";
+var asObject = (x) => isObject(x) ? x : {};
 var isArray = Array.isArray;
+var toArray = (x) => isArray(x) ? x : _;
+var asArray = (x) => isArray(x) ? x : [];
 var isPlainObject = (x) => isObject(x) && !isArray(x);
 var toPlainObject = (x) => isPlainObject(x) ? x : _;
 var asPlainObject = (x) => isPlainObject(x) ? x : {};
@@ -46,7 +49,9 @@ var toPlainObjectOf = (x, f) => {
 };
 var toPlainObjectOfTrue = (x) => toPlainObjectOf(x, isTrue);
 
+exports.asArray = asArray;
 exports.asNumber = asNumber;
+exports.asObject = asObject;
 exports.asPlainObject = asPlainObject;
 exports.asString = asString;
 exports.asTrue = asTrue;
@@ -57,7 +62,8 @@ exports.isObject = isObject;
 exports.isPlainObject = isPlainObject;
 exports.isString = isString;
 exports.isTrue = isTrue;
-exports.show = show;
+exports.print = print;
+exports.toArray = toArray;
 exports.toBoolean = toBoolean;
 exports.toNonEmptyPlainObject = toNonEmptyPlainObject;
 exports.toNumber = toNumber;

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/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,KAAA,GAAQ,CAAC,CAAuB,KAAA;AAC3C,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;AAGzE,IAAM,WAAW,CAAC,CAAA,KAAwB,SAAS,CAAC,CAAA,GAAI,IAAI;AAE5D,IAAM,UAAU,KAAM,CAAA;AAGtB,IAAM,UAAU,CAAC,CAAA,KAAuC,OAAQ,CAAA,CAAC,IAAI,CAAI,GAAA;AAGzE,IAAM,UAAU,CAAC,CAAA,KAA2B,QAAQ,CAAC,CAAA,GAAI,IAAI;AAGvD,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"}

package/dist/index.mjs

@@ -11,7 +11,7 @@ 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) => {
+var print = (x) => {
   if (isString(x)) return x;
   if (x == null) return "";
   try {
@@ -21,7 +21,10 @@ var show = (x) => {
   }
 };
 var isObject = (x) => x !== null && typeof x === "object";
+var asObject = (x) => isObject(x) ? x : {};
 var isArray = Array.isArray;
+var toArray = (x) => isArray(x) ? x : _;
+var asArray = (x) => isArray(x) ? x : [];
 var isPlainObject = (x) => isObject(x) && !isArray(x);
 var toPlainObject = (x) => isPlainObject(x) ? x : _;
 var asPlainObject = (x) => isPlainObject(x) ? x : {};
@@ -44,6 +47,6 @@ var toPlainObjectOf = (x, f) => {
 };
 var toPlainObjectOfTrue = (x) => toPlainObjectOf(x, isTrue);
 
-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, isNumber, isObject, isPlainObject, isString, isTrue, print, toArray, toBoolean, toNonEmptyPlainObject, 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/primitive.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.1",
   "description": "Filter types from unknown",
   "repository": "wopjs/cast",
   "main": "./dist/index.js",

package/src/primitive.test.ts

@@ -0,0 +1,152 @@
+import { describe, it, expect } from "vitest";
+
+import {
+  isTrue,
+  toTrue,
+  asTrue,
+  isBoolean,
+  toBoolean,
+  isNumber,
+  toNumber,
+  asNumber,
+  isString,
+  toString,
+  asString,
+  print,
+  isObject,
+  isArray,
+  isPlainObject,
+  toPlainObject,
+  asPlainObject,
+  toNonEmptyPlainObject,
+  toPlainObjectOf,
+  toPlainObjectOfTrue,
+} from ".";
+
+describe("primitive.ts", () => {
+  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("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("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("isObject", () => {
+    expect(isObject({})).toBe(true);
+    expect(isObject([])).toBe(true);
+    expect(isObject(null)).toBe(false);
+  });
+
+  it("isArray", () => {
+    expect(isArray([])).toBe(true);
+    expect(isArray({})).toBe(false);
+  });
+
+  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("toNonEmptyPlainObject", () => {
+    expect(toNonEmptyPlainObject({ a: 1 })).toEqual({ a: 1 });
+    expect(toNonEmptyPlainObject({})).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);
+  });
+});

package/src/primitive.ts

@@ -37,7 +37,7 @@ export const asString = (x: unknown): string => (isString(x) ? x : "");
  * `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 => {
+export const print = (x: unknown): string => {
   if (isString(x)) return x;
   if (x == null) return "";
   try {
@@ -55,8 +55,17 @@ 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";
 
+/** 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);