typof 1.0.4 → 1.0.6

package/README.md

@@ -2,7 +2,6 @@
 [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
 [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
 [Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise
@@ -58,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
 ```
 
@@ -109,17 +108,23 @@ import { typof } from 'typof';
 
 `typof(value)`
 
-Infers types.
+Infer types.
 
-> | Parameter | Default | Description                         |
-> | --------- | ------- | ----------------------------------- |
-> | value     |         | Unknown<br/>Value to extract types. |
+> | Parameter | Type    | Default | Description           |
+> | --------- | ------- | ------- | --------------------- |
+> | value     | Unknown |         | Value to infer types. |
 >
 > returns [Types]\[]
 >
 > Example:
 >
 > ```typescript
+> // Tests are as follows. (Is this 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.5')[0] === 'string') console.log('This is a string.');
+>
 > typof('test'); // [ "string" ]
 >
 > typof('0'); // [ "string", "number", "integer" ]
@@ -131,7 +136,7 @@ Infers types.
 > typof('true'); // [ "string", "boolean" ]
 > typof(true); // [ "boolean" ]
 >
-> typof('{"key": "value"}'); // [ "string", "object" ]
+> typof('{"key":"value"}'); // [ "string", "object" ]
 > typof({ key: 'value' }); // [ "object" ]
 >
 > typof('["test"]'); // [ "string", "array" ]
@@ -145,9 +150,6 @@ Infers types.
 >
 > typof('undefined'); // [ "string", "undefined" ]
 > typof(undefined); // [ "undefined" ]
->
-> // Tests are as follows. (Is this an integer?)
-> if (typof(0).includes('integer')) console.log('This is an integer!');
 > ```
 
 <br/>
@@ -156,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]
 >
@@ -180,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]
 >
@@ -190,6 +192,8 @@ Convert to number.
 >
 > ```typescript
 > number('0.5'); // 0.5
+> number(0.5); // 0.5
+> number('test'); // NaN
 > ```
 
 <br/>
@@ -198,9 +202,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]
 >
@@ -209,6 +213,7 @@ Convert to integer.
 > ```typescript
 > integer('0.5'); // 0
 > integer(0.5); // 0
+> integer('test'); // NaN
 > ```
 
 <br/>
@@ -217,9 +222,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
 >
@@ -237,9 +242,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
 >
@@ -256,11 +261,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:
 >
@@ -275,9 +280,9 @@ 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 [Date] | Value
 >
@@ -285,6 +290,7 @@ Convert to date.
 >
 > ```typescript
 > date('2025-01-01'); // 2025-01-01T00:00:00.000Z
+> date(new Date('2025-01-01')); // 2025-01-01T00:00:00.000Z
 > date('test'); // "test"
 > ```
 
@@ -294,9 +300,9 @@ Convert to date.
 
 Convert to null.
 
-> | Parameter | Default | Description                   |
-> | --------- | ------- | ----------------------------- |
-> | value     |         | Unknown<br/>Value to convert. |
+> | Parameter | Type    | Default | Description       |
+> | --------- | ------- | ------- | ----------------- |
+> | value     | Unknown |         | Value to convert. |
 >
 > returns [Null] | Value
 >
@@ -314,9 +320,9 @@ Convert to null.
 
 Convert to undefined.
 
-> | Parameter | Default | Description                   |
-> | --------- | ------- | ----------------------------- |
-> | value     |         | Unknown<br/>Value to convert. |
+> | Parameter | Type    | Default | Description       |
+> | --------- | ------- | ------- | ----------------- |
+> | value     | Unknown |         | Value to convert. |
 >
 > returns [Undefined] | Value
 >

package/dist/main.d.mts

@@ -7,7 +7,7 @@ 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;
 

package/dist/main.d.ts

@@ -7,7 +7,7 @@ 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;
 

package/dist/main.js

@@ -93,13 +93,12 @@ 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) => {
-  return typof(value).includes("object") || typof(value).includes("array") ? JSON.stringify(value) : String(value);
+  const types = typof(value);
+  return types.includes("object") || types.includes("array") ? JSON.stringify(value) : String(value);
 };
 var number = (value) => {
   return typof(value).includes("number") ? Number(value) : NaN;
@@ -108,7 +107,8 @@ var integer = (value) => {
   return typof(value).includes("number") ? Math.trunc(Number(value)) : NaN;
 };
 var boolean = (value) => {
-  if (typof(value).includes("boolean") && typof(value).includes("string")) {
+  const types = typof(value);
+  if (types.includes("boolean") && types.includes("string")) {
     if (value === "true") {
       return true;
     } else if (value === "false") {
@@ -117,17 +117,15 @@ var boolean = (value) => {
   } else return value;
 };
 var object = (value) => {
-  if (typof(value).includes("object") && typof(value).includes("string")) {
-    return JSON.parse(value);
-  } else return value;
+  const types = typof(value);
+  return types.includes("object") && types.includes("string") ? JSON.parse(value) : value;
 };
 var array = (value) => {
-  if (typof(value).includes("array") && typof(value).includes("string")) {
-    return JSON.parse(value);
-  } else return value;
+  const types = typof(value);
+  return types.includes("array") && types.includes("string") ? JSON.parse(value) : value;
 };
 var date = (value) => {
-  return new Date(value);
+  return typof(value).includes("date") ? new Date(value) : value;
 };
 var _null = (value) => {
   return typof(value).includes("null") ? null : value;

package/dist/main.mjs

@@ -58,13 +58,12 @@ 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) => {
-  return typof(value).includes("object") || typof(value).includes("array") ? JSON.stringify(value) : String(value);
+  const types = typof(value);
+  return types.includes("object") || types.includes("array") ? JSON.stringify(value) : String(value);
 };
 var number = (value) => {
   return typof(value).includes("number") ? Number(value) : NaN;
@@ -73,7 +72,8 @@ var integer = (value) => {
   return typof(value).includes("number") ? Math.trunc(Number(value)) : NaN;
 };
 var boolean = (value) => {
-  if (typof(value).includes("boolean") && typof(value).includes("string")) {
+  const types = typof(value);
+  if (types.includes("boolean") && types.includes("string")) {
     if (value === "true") {
       return true;
     } else if (value === "false") {
@@ -82,17 +82,15 @@ var boolean = (value) => {
   } else return value;
 };
 var object = (value) => {
-  if (typof(value).includes("object") && typof(value).includes("string")) {
-    return JSON.parse(value);
-  } else return value;
+  const types = typof(value);
+  return types.includes("object") && types.includes("string") ? JSON.parse(value) : value;
 };
 var array = (value) => {
-  if (typof(value).includes("array") && typof(value).includes("string")) {
-    return JSON.parse(value);
-  } else return value;
+  const types = typof(value);
+  return types.includes("array") && types.includes("string") ? JSON.parse(value) : value;
 };
 var date = (value) => {
-  return new Date(value);
+  return typof(value).includes("date") ? new Date(value) : value;
 };
 var _null = (value) => {
   return typof(value).includes("null") ? null : value;

package/package.json

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