@wopjs/cast 0.1.0

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 wopjs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# @wopjs/cast
+
+[![Docs](https://img.shields.io/badge/Docs-read-%23fdf9f5)](https://wopjs.github.io/cast)
+[![Build Status](https://github.com/wopjs/cast/actions/workflows/build.yml/badge.svg)](https://github.com/wopjs/cast/actions/workflows/build.yml)
+[![npm-version](https://img.shields.io/npm/v/@wopjs/cast.svg)](https://www.npmjs.com/package/@wopjs/cast)
+[![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
+
+## Install
+
+```
+npm add @wopjs/cast
+```
+
+## Publish New Version
+
+You can use [npm version](https://docs.npmjs.com/cli/v10/commands/npm-version) to bump version.
+
+```
+npm version patch
+```
+
+Push the tag to remote and CI will publish the new version to npm.
+
+```
+git push --follow-tags
+```
+
+### CI Publish
+
+If you want to publish the package in CI, you need to set the `NPM_TOKEN` secrets [in GitHub repository settings](https://docs.github.com/en/actions/security-for-github-actions/security-guides/using-secrets-in-github-actions#creating-secrets-for-a-repository). See how to [create a NPM access token](https://docs.npmjs.com/creating-and-viewing-access-tokens).

package/dist/index.d.mts

@@ -0,0 +1,54 @@
+type _ = undefined;
+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;
+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 | _;
+/** Returns `true` if `x` is a number, returns `false` if `x` is `NaN` or other value. */
+declare const isNumber: (x: unknown) => x is number;
+/** Returns `x` if `x` is a number, `NaN` and other value will be coerced to `undefined`. */
+declare const toNumber: (x: unknown) => number | _;
+/** Returns `x` if `x` is a number, `NaN` and other value will be coerced to `0`. */
+declare const asNumber: (x: unknown) => number;
+/** Returns `true` if `x` is a string. */
+declare const isString: (x: unknown) => x is string;
+/** Returns `x` if `x` is a string, otherwise returns `undefined`. */
+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;
+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 `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 `x` if `x` is a plain object and has at least one key. */
+declare const toNonEmptyPlainObject: <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`.
+ */
+declare const toPlainObjectOf: <T>(x: unknown, f: (v: unknown) => v is T) => {
+    [key: PropertyKey]: T;
+} | _;
+/** Filter props from object `x` whose values are `true`. */
+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 };

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+type _ = undefined;
+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;
+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 | _;
+/** Returns `true` if `x` is a number, returns `false` if `x` is `NaN` or other value. */
+declare const isNumber: (x: unknown) => x is number;
+/** Returns `x` if `x` is a number, `NaN` and other value will be coerced to `undefined`. */
+declare const toNumber: (x: unknown) => number | _;
+/** Returns `x` if `x` is a number, `NaN` and other value will be coerced to `0`. */
+declare const asNumber: (x: unknown) => number;
+/** Returns `true` if `x` is a string. */
+declare const isString: (x: unknown) => x is string;
+/** Returns `x` if `x` is a string, otherwise returns `undefined`. */
+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;
+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 `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 `x` if `x` is a plain object and has at least one key. */
+declare const toNonEmptyPlainObject: <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`.
+ */
+declare const toPlainObjectOf: <T>(x: unknown, f: (v: unknown) => v is T) => {
+    [key: PropertyKey]: T;
+} | _;
+/** Filter props from object `x` whose values are `true`. */
+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 };

package/dist/index.js

@@ -0,0 +1,70 @@
+'use strict';
+
+// src/primitive.ts
+var _ = void 0;
+var isTrue = (x) => x === true;
+var toTrue = (x) => x === true ? true : _;
+var asTrue = (x) => x === true ? x : false;
+var isBoolean = (x) => x === true || x === false;
+var toBoolean = (x) => isBoolean(x) ? x : _;
+var isNumber = (x) => typeof x === "number" && x === x;
+var toNumber = (x) => isNumber(x) ? x : _;
+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 isArray = Array.isArray;
+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 toPlainObjectOf = (x, f) => {
+  if (isPlainObject(x)) {
+    let index = -1;
+    let props = Object.keys(x);
+    let length = props.length;
+    let result;
+    while (++index < length) {
+      let key = props[index];
+      let value = x[key];
+      if (f(value)) {
+        (result ??= {})[key] = value;
+      }
+    }
+    return result;
+  }
+};
+var toPlainObjectOfTrue = (x) => toPlainObjectOf(x, isTrue);
+
+exports.asNumber = asNumber;
+exports.asPlainObject = asPlainObject;
+exports.asString = asString;
+exports.asTrue = asTrue;
+exports.isArray = isArray;
+exports.isBoolean = isBoolean;
+exports.isNumber = isNumber;
+exports.isObject = isObject;
+exports.isPlainObject = isPlainObject;
+exports.isString = isString;
+exports.isTrue = isTrue;
+exports.show = show;
+exports.toBoolean = toBoolean;
+exports.toNonEmptyPlainObject = toNonEmptyPlainObject;
+exports.toNumber = toNumber;
+exports.toPlainObject = toPlainObject;
+exports.toPlainObjectOf = toPlainObjectOf;
+exports.toPlainObjectOfTrue = toPlainObjectOfTrue;
+exports.toString = toString;
+exports.toTrue = toTrue;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/index.mjs

@@ -0,0 +1,49 @@
+// src/primitive.ts
+var _ = void 0;
+var isTrue = (x) => x === true;
+var toTrue = (x) => x === true ? true : _;
+var asTrue = (x) => x === true ? x : false;
+var isBoolean = (x) => x === true || x === false;
+var toBoolean = (x) => isBoolean(x) ? x : _;
+var isNumber = (x) => typeof x === "number" && x === x;
+var toNumber = (x) => isNumber(x) ? x : _;
+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 isArray = Array.isArray;
+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 toPlainObjectOf = (x, f) => {
+  if (isPlainObject(x)) {
+    let index = -1;
+    let props = Object.keys(x);
+    let length = props.length;
+    let result;
+    while (++index < length) {
+      let key = props[index];
+      let value = x[key];
+      if (f(value)) {
+        (result ??= {})[key] = value;
+      }
+    }
+    return result;
+  }
+};
+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 };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@wopjs/cast",
+  "version": "0.1.0",
+  "description": "Filter types from unknown",
+  "repository": "wopjs/cast",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "src",
+    "dist"
+  ],
+  "scripts": {
+    "prepublishOnly": "npm run build",
+    "lint": "eslint && prettier --check .",
+    "docs": "typedoc --options typedoc.json",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage --coverage.include=src/**",
+    "test:ci": "tsc --noEmit && vitest --coverage --coverage.reporter=lcov --coverage.include=src/**",
+    "build": "tsup",
+    "build:min": "MINIFY=true tsup && node scripts/gzip.mjs",
+    "release": "commit-and-tag-version"
+  },
+  "keywords": [
+    "typescript",
+    "coerce"
+  ],
+  "maintainers": [
+    {
+      "name": "CRIMX",
+      "email": "straybugs@gmail.com",
+      "url": "https://github.com/crimx/"
+    },
+    {
+      "name": "hyrious",
+      "email": "hyrious@outlook.com",
+      "url": "https://github.com/hyrious/"
+    }
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@eslint/js": "^9.15.0",
+    "@types/node": "^22.9.0",
+    "@vitest/coverage-v8": "^2.1.5",
+    "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-plugin-import": "^2.31.0",
+    "gzip-size": "^7.0.0",
+    "prettier": "^3.3.3",
+    "pretty-bytes": "^6.1.1",
+    "tsup": "^8.3.5",
+    "typedoc": "^0.26.11",
+    "typescript": "^5.6.3",
+    "typescript-eslint": "^8.14.0",
+    "vitest": "^2.1.5",
+    "yoctocolors": "^2.1.1"
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from "./primitive";

package/src/primitive.ts

@@ -0,0 +1,97 @@
+const _ = undefined;
+export type _ = undefined;
+
+export const isTrue = (x: unknown): x is true => x === true;
+
+/** Returns `true` if `x` is `true`, otherwise returns `undefined`. */
+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 const isBoolean = (x: unknown): x is boolean => x === true || x === false;
+
+/** Returns `x` if `x` is `true` or `false`, otherwise returns `undefined`. */
+export const toBoolean = (x: unknown): boolean | _ => (isBoolean(x) ? x : _);
+
+/** Returns `true` if `x` is a number, returns `false` if `x` is `NaN` or other value. */
+export const isNumber = (x: unknown): x is number => typeof x === "number" && x === x;
+
+/** Returns `x` if `x` is a number, `NaN` and other value will be coerced to `undefined`. */
+export const toNumber = (x: unknown): number | _ => (isNumber(x) ? x : _);
+
+/** Returns `x` if `x` is a number, `NaN` and other value will be coerced to `0`. */
+export const asNumber = (x: unknown): number => (isNumber(x) ? x : 0);
+
+/** Returns `true` if `x` is a string. */
+export const isString = (x: unknown): x is string => typeof x === "string";
+
+/** Returns `x` if `x` is a string, otherwise returns `undefined`. */
+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 + "";
+  }
+};
+
+export interface PlainObject {
+  [key: PropertyKey]: unknown;
+}
+
+/** 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 `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);
+
+/** Returns `x` if `x` is a plain object. */
+export const toPlainObject = (x: unknown): PlainObject | _ => (isPlainObject(x) ? x : _);
+
+/** Returns `x` if `x` is a plain object, otherwise returns `{}` (empty object). */
+export const asPlainObject = (x: unknown): PlainObject => (isPlainObject(x) ? x : {});
+
+/** 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 : _;
+
+/**
+ * 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`.
+ */
+export const toPlainObjectOf = <T>(x: unknown, f: (v: unknown) => v is T): { [key: PropertyKey]: T } | _ => {
+  if (isPlainObject(x)) {
+    let index = -1;
+    let props = Object.keys(x);
+    let length = props.length;
+    let result: { [key: PropertyKey]: T } | _;
+
+    while (++index < length) {
+      let key = props[index];
+      let value = x[key];
+      if (f(value)) {
+        (result ??= {})[key] = value;
+      }
+    }
+
+    return result;
+  }
+};
+
+/** Filter props from object `x` whose values are `true`. */
+export const toPlainObjectOfTrue = (x: unknown): { [key: PropertyKey]: true } | _ => toPlainObjectOf(x, isTrue);