typof 1.0.3 → 1.0.5

package/README.md

@@ -1,13 +1,16 @@
 [String]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String
 [Number]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number
 [Boolean]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean
-[Date]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date
 [Object]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object
-[Array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array
+[Date]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date
 [Buffer]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer
-[Function]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function
 [Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise
 [Void]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined
+[Null]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/null
+[Undefined]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined
+
+<!---->
+
 [Types]: ./src/types/Types.type.ts
 
 <div align="center">
@@ -54,19 +57,19 @@ Infer types.
 You can install it as follows.
 
 ```shell
-// NPM
+# NPM
 npm add typof
 
-// PNPM
+# PNPM
 pnpm add typof
 
-// Yarn
+# Yarn
 yarn add typof
 
-// Bun
+# Bun
 bun add typof
 
-// Deno
+# Deno
 deno add typof
 ```
 
@@ -77,7 +80,7 @@ deno add typof
 Briefly as follows.
 
 ```typescript
-typof
+Typof
 │
 ├── typof(value)
 ├── string(value)
@@ -87,6 +90,8 @@ typof
 ├── object(value)
 ├── array(value)
 ├── date(value)
+├── _null(value)
+├── _undefined(value)
 │
 └── type Types
 ```
@@ -105,9 +110,9 @@ import { typof } from 'typof';
 
 Infers types.
 
-> | Parameter | Default | Description                         |
-> | --------- | ------- | ----------------------------------- |
-> | value     |         | Unknown<br/>Value to extract types. |
+> | Parameter | Type    | Default | Description           |
+> | --------- | ------- | ------- | --------------------- |
+> | value     | Unknown |         | Value to infer types. |
 >
 > returns [Types]\[]
 >
@@ -141,7 +146,10 @@ Infers types.
 > typof(undefined); // [ "undefined" ]
 >
 > // Tests are as follows. (Is this an integer?)
-> if (typof(0).includes('integer')) console.log('This is an integer!');
+> if (typof(0).includes('integer')) console.log('This is an integer.');
+>
+> // Index zero always ensures reliable type checking. As the index increases, species depth also increases.
+> if (typof('0')[0] === 'string') console.log('This is a string.');
 > ```
 
 <br/>
@@ -150,9 +158,9 @@ Infers types.
 
 Convert to string.
 
-> | Parameter | Default | Description                   |
-> | --------- | ------- | ----------------------------- |
-> | value     |         | Unknown<br/>Value to convert. |
+> | Parameter | Type    | Default | Description       |
+> | --------- | ------- | ------- | ----------------- |
+> | value     | Unknown |         | Value to convert. |
 >
 > returns [String]
 >
@@ -174,9 +182,9 @@ Convert to string.
 
 Convert to number.
 
-> | Parameter | Default | Description                   |
-> | --------- | ------- | ----------------------------- |
-> | value     |         | Unknown<br/>Value to convert. |
+> | Parameter | Type    | Default | Description       |
+> | --------- | ------- | ------- | ----------------- |
+> | value     | Unknown |         | Value to convert. |
 >
 > returns [Number]
 >
@@ -192,9 +200,9 @@ Convert to number.
 
 Convert to integer.
 
-> | Parameter | Default | Description                   |
-> | --------- | ------- | ----------------------------- |
-> | value     |         | Unknown<br/>Value to convert. |
+> | Parameter | Type    | Default | Description       |
+> | --------- | ------- | ------- | ----------------- |
+> | value     | Unknown |         | Value to convert. |
 >
 > returns [Number]
 >
@@ -211,9 +219,9 @@ Convert to integer.
 
 Convert to boolean.
 
-> | Parameter | Default | Description                   |
-> | --------- | ------- | ----------------------------- |
-> | value     |         | Unknown<br/>Value to convert. |
+> | Parameter | Type    | Default | Description       |
+> | --------- | ------- | ------- | ----------------- |
+> | value     | Unknown |         | Value to convert. |
 >
 > returns [Boolean] | Value
 >
@@ -231,9 +239,9 @@ Convert to boolean.
 
 Convert to object.
 
-> | Parameter | Default | Description                   |
-> | --------- | ------- | ----------------------------- |
-> | value     |         | Unknown<br/>Value to convert. |
+> | Parameter | Type    | Default | Description       |
+> | --------- | ------- | ------- | ----------------- |
+> | value     | Unknown |         | Value to convert. |
 >
 > returns [Object] | Value
 >
@@ -250,11 +258,11 @@ Convert to object.
 
 Convert to array.
 
-> | Parameter | Default | Description                   |
-> | --------- | ------- | ----------------------------- |
-> | value     |         | Unknown<br/>Value to convert. |
+> | Parameter | Type    | Default | Description       |
+> | --------- | ------- | ------- | ----------------- |
+> | value     | Unknown |         | Value to convert. |
 >
-> returns [Array] | Value
+> returns Unknown\[] | Value
 >
 > Example:
 >
@@ -269,16 +277,57 @@ Convert to array.
 
 Convert to date.
 
-> | Parameter | Default | Description                   |
-> | --------- | ------- | ----------------------------- |
-> | value     |         | Unknown<br/>Value to convert. |
+> | Parameter | Type    | Default | Description       |
+> | --------- | ------- | ------- | ----------------- |
+> | value     | Unknown |         | Value to convert. |
 >
-> returns [Array] | Value
+> returns [Date] | Value
 >
 > Example:
 >
 > ```typescript
 > date('2025-01-01'); // 2025-01-01T00:00:00.000Z
+> date('test'); // "test"
+> ```
+
+<br/>
+
+`_null(value)`
+
+Convert to null.
+
+> | Parameter | Type    | Default | Description       |
+> | --------- | ------- | ------- | ----------------- |
+> | value     | Unknown |         | Value to convert. |
+>
+> returns [Null] | Value
+>
+> Example:
+>
+> ```typescript
+> _null('null'); // null
+> _null(null); // null
+> _null('test'); // "test"
+> ```
+
+<br/>
+
+`_undefined(value)`
+
+Convert to undefined.
+
+> | Parameter | Type    | Default | Description       |
+> | --------- | ------- | ------- | ----------------- |
+> | value     | Unknown |         | Value to convert. |
+>
+> returns [Undefined] | Value
+>
+> Example:
+>
+> ```typescript
+> _undefined('undefined'); // undefined
+> _undefined(undefined); // undefined
+> _undefined('test'); // "test"
 > ```
 
 ### Types

package/dist/main.d.mts

@@ -7,6 +7,8 @@ declare const integer: (value: unknown) => number;
 declare const boolean: <Value>(value: Value) => boolean | Value;
 declare const object: <Value>(value: Value) => object | Value;
 declare const array: <Value>(value: Value) => unknown[] | Value;
-declare const date: (value: unknown) => Date;
+declare const date: <Value>(value: Value) => Date | Value;
+declare const _null: <Value>(value: Value) => null | Value;
+declare const _undefined: <Value>(value: Value) => undefined | Value;
 
-export { type Types, array, boolean, date, integer, number, object, string, typof };
+export { type Types, _null, _undefined, array, boolean, date, integer, number, object, string, typof };

package/dist/main.d.ts

@@ -7,6 +7,8 @@ declare const integer: (value: unknown) => number;
 declare const boolean: <Value>(value: Value) => boolean | Value;
 declare const object: <Value>(value: Value) => object | Value;
 declare const array: <Value>(value: Value) => unknown[] | Value;
-declare const date: (value: unknown) => Date;
+declare const date: <Value>(value: Value) => Date | Value;
+declare const _null: <Value>(value: Value) => null | Value;
+declare const _undefined: <Value>(value: Value) => undefined | Value;
 
-export { type Types, array, boolean, date, integer, number, object, string, typof };
+export { type Types, _null, _undefined, array, boolean, date, integer, number, object, string, typof };

package/dist/main.js

@@ -20,6 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/main.ts
 var main_exports = {};
 __export(main_exports, {
+  _null: () => _null,
+  _undefined: () => _undefined,
   array: () => array,
   boolean: () => boolean,
   date: () => date,
@@ -91,9 +93,7 @@ var typof = (value) => {
     types.push("array");
   } else if (value === null) {
     types.push("null");
-  } else if (value === void 0) {
-    types.push("undefined");
-  }
+  } else if (value === void 0) types.push("undefined");
   return types;
 };
 var string = (value) => {
@@ -125,10 +125,20 @@ var array = (value) => {
   } else return value;
 };
 var date = (value) => {
-  return new Date(value);
+  if (typof(value).includes("date")) {
+    return new Date(value);
+  } else return value;
+};
+var _null = (value) => {
+  return typof(value).includes("null") ? null : value;
+};
+var _undefined = (value) => {
+  return typof(value).includes("undefined") ? void 0 : value;
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  _null,
+  _undefined,
   array,
   boolean,
   date,

package/dist/main.mjs

@@ -58,9 +58,7 @@ var typof = (value) => {
     types.push("array");
   } else if (value === null) {
     types.push("null");
-  } else if (value === void 0) {
-    types.push("undefined");
-  }
+  } else if (value === void 0) types.push("undefined");
   return types;
 };
 var string = (value) => {
@@ -92,9 +90,19 @@ var array = (value) => {
   } else return value;
 };
 var date = (value) => {
-  return new Date(value);
+  if (typof(value).includes("date")) {
+    return new Date(value);
+  } else return value;
+};
+var _null = (value) => {
+  return typof(value).includes("null") ? null : value;
+};
+var _undefined = (value) => {
+  return typof(value).includes("undefined") ? void 0 : value;
 };
 export {
+  _null,
+  _undefined,
   array,
   boolean,
   date,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typof",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Infer types.",
   "license": "MIT",
   "homepage": "https://github.com/keift/typof",