typof 1.0.2 → 1.0.4

package/README.md

@@ -1,13 +1,17 @@
 [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">
@@ -40,13 +44,13 @@
 
 ## About
 
-Extract the valid types.
+Infer types.
 
 ## Features
 
-- Extract multiple types
-- Extracts integer and float types
-- It infers the type from a string
+- Infers multiple types
+- Infers integer and float types
+- Infers the type from a string
 - There are simple type converters
 
 ## Installation
@@ -77,17 +81,18 @@ deno add typof
 Briefly as follows.
 
 ```typescript
-typof
+Typof
 │
 ├── typof(value)
 ├── string(value)
 ├── number(value)
 ├── integer(value)
-├── float(value)
 ├── boolean(value)
 ├── object(value)
 ├── array(value)
 ├── date(value)
+├── _null(value)
+├── _undefined(value)
 │
 └── type Types
 ```
@@ -104,7 +109,7 @@ import { typof } from 'typof';
 
 `typof(value)`
 
-Extract the valid types.
+Infers types.
 
 > | Parameter | Default | Description                         |
 > | --------- | ------- | ----------------------------------- |
@@ -115,36 +120,214 @@ Extract the valid types.
 > Example:
 >
 > ```typescript
-> typof('test'); // [ 'string' ]
+> typof('test'); // [ "string" ]
 >
-> typof('0'); // [ 'string', 'number', 'integer' ]
-> typof(0); // [ 'number', 'integer' ]
+> typof('0'); // [ "string", "number", "integer" ]
+> typof(0); // [ "number", "integer" ]
 >
-> typof('0.5'); // [ 'string', 'number', 'float' ]
-> typof(0.5); // [ 'number', 'float' ]
+> typof('0.5'); // [ "string", "number", "float" ]
+> typof(0.5); // [ "number", "float" ]
 >
-> typof('true'); // [ 'string', 'boolean' ]
-> typof(true); // [ 'boolean' ]
+> typof('true'); // [ "string", "boolean" ]
+> typof(true); // [ "boolean" ]
 >
-> typof('{"key": "value"}'); // [ 'string', 'object' ]
-> typof({ key: 'value' }); // [ 'object' ]
+> typof('{"key": "value"}'); // [ "string", "object" ]
+> typof({ key: 'value' }); // [ "object" ]
 >
-> typof('["test"]'); // [ 'string', 'array' ]
-> typof(['test']); // [ 'array' ]
+> typof('["test"]'); // [ "string", "array" ]
+> typof(['test']); // [ "array" ]
 >
-> typof('2025-01-01'); // [ 'string', 'date' ]
-> typof(new Date('2025-01-01')); // [ 'object', 'date' ]
+> typof('2025-01-01'); // [ "string", "date" ]
+> typof(new Date('2025-01-01')); // [ "object", "date" ]
 >
-> typof('null'); // [ 'string, 'null' ]
-> typof(null); // [ 'null' ]
+> typof('null'); // [ "string", "null" ]
+> typof(null); // [ "null" ]
 >
-> typof('undefined'); // [ 'string, 'undefined' ]
-> typof(undefined); // [ 'undefined' ]
+> 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/>
+
+`string(value)`
+
+Convert to string.
+
+> | Parameter | Default | Description                   |
+> | --------- | ------- | ----------------------------- |
+> | value     |         | Unknown<br/>Value to convert. |
+>
+> returns [String]
+>
+> Example:
+>
+> ```typescript
+> string(0.5); // "0.5"
+> string(true); // "true"
+> string({ key: 'value' }); // '{"key":"value"}'
+> string(['test']); // '["test"]'
+> string(new Date('2025-01-01')); // "2025-01-01T00:00:00.000Z"
+> string(null); // "null"
+> string(undefined); // "undefined"
+> ```
+
+<br/>
+
+`number(value)`
+
+Convert to number.
+
+> | Parameter | Default | Description                   |
+> | --------- | ------- | ----------------------------- |
+> | value     |         | Unknown<br/>Value to convert. |
+>
+> returns [Number]
+>
+> Example:
+>
+> ```typescript
+> number('0.5'); // 0.5
+> ```
+
+<br/>
+
+`integer(value)`
+
+Convert to integer.
+
+> | Parameter | Default | Description                   |
+> | --------- | ------- | ----------------------------- |
+> | value     |         | Unknown<br/>Value to convert. |
+>
+> returns [Number]
+>
+> Example:
+>
+> ```typescript
+> integer('0.5'); // 0
+> integer(0.5); // 0
+> ```
+
+<br/>
+
+`boolean(value)`
+
+Convert to boolean.
+
+> | Parameter | Default | Description                   |
+> | --------- | ------- | ----------------------------- |
+> | value     |         | Unknown<br/>Value to convert. |
+>
+> returns [Boolean] | Value
+>
+> Example:
+>
+> ```typescript
+> boolean('true'); // true
+> boolean(true); // true
+> boolean('test'); // "test"
+> ```
+
+<br/>
+
+`object(value)`
+
+Convert to object.
+
+> | Parameter | Default | Description                   |
+> | --------- | ------- | ----------------------------- |
+> | value     |         | Unknown<br/>Value to convert. |
+>
+> returns [Object] | Value
+>
+> Example:
+>
+> ```typescript
+> object('{"key":"value"}'); // { key: "value" }
+> object('["test"]'); // '["test"]'
+> ```
+
+<br/>
+
+`array(value)`
+
+Convert to array.
+
+> | Parameter | Default | Description                   |
+> | --------- | ------- | ----------------------------- |
+> | value     |         | Unknown<br/>Value to convert. |
+>
+> returns [Array] | Value
+>
+> Example:
+>
+> ```typescript
+> array('["test"]'); // [ "test" ]
+> array('{"key":"value"}'); // '{"key":"value"}'
+> ```
+
+<br/>
+
+`date(value)`
+
+Convert to date.
+
+> | Parameter | Default | Description                   |
+> | --------- | ------- | ----------------------------- |
+> | value     |         | Unknown<br/>Value to convert. |
+>
+> 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 | Default | Description                   |
+> | --------- | ------- | ----------------------------- |
+> | value     |         | Unknown<br/>Value to convert. |
+>
+> returns [Null] | Value
+>
+> Example:
+>
+> ```typescript
+> _null('null'); // null
+> _null(null); // null
+> _null('test'); // "test"
+> ```
+
+<br/>
+
+`_undefined(value)`
+
+Convert to undefined.
+
+> | Parameter | Default | Description                   |
+> | --------- | ------- | ----------------------------- |
+> | value     |         | Unknown<br/>Value to convert. |
+>
+> returns [Undefined] | Value
+>
+> Example:
+>
+> ```typescript
+> _undefined('undefined'); // undefined
+> _undefined(undefined); // undefined
+> _undefined('test'); // "test"
+> ```
+
 ### Types
 
 | Type    |

package/dist/main.d.mts

@@ -4,10 +4,11 @@ declare const typof: (value: unknown) => Types[];
 declare const string: (value: unknown) => string;
 declare const number: (value: unknown) => number;
 declare const integer: (value: unknown) => number;
-declare const float: (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 _null: <Value>(value: Value) => null | Value;
+declare const _undefined: <Value>(value: Value) => undefined | Value;
 
-export { type Types, array, boolean, date, float, integer, number, object, string, typof };
+export { type Types, _null, _undefined, array, boolean, date, integer, number, object, string, typof };

package/dist/main.d.ts

@@ -4,10 +4,11 @@ declare const typof: (value: unknown) => Types[];
 declare const string: (value: unknown) => string;
 declare const number: (value: unknown) => number;
 declare const integer: (value: unknown) => number;
-declare const float: (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 _null: <Value>(value: Value) => null | Value;
+declare const _undefined: <Value>(value: Value) => undefined | Value;
 
-export { type Types, array, boolean, date, float, integer, number, object, string, typof };
+export { type Types, _null, _undefined, array, boolean, date, integer, number, object, string, typof };

package/dist/main.js

@@ -20,10 +20,11 @@ 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,
-  float: () => float,
   integer: () => integer,
   number: () => number,
   object: () => object,
@@ -104,9 +105,8 @@ var number = (value) => {
   return typof(value).includes("number") ? Number(value) : NaN;
 };
 var integer = (value) => {
-  return typof(value).includes("number") ? Number.parseInt(string(value)) : NaN;
+  return typof(value).includes("number") ? Math.trunc(Number(value)) : NaN;
 };
-var float = number;
 var boolean = (value) => {
   if (typof(value).includes("boolean") && typof(value).includes("string")) {
     if (value === "true") {
@@ -129,12 +129,19 @@ var array = (value) => {
 var date = (value) => {
   return new Date(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,
-  float,
   integer,
   number,
   object,

package/dist/main.mjs

@@ -70,9 +70,8 @@ var number = (value) => {
   return typof(value).includes("number") ? Number(value) : NaN;
 };
 var integer = (value) => {
-  return typof(value).includes("number") ? Number.parseInt(string(value)) : NaN;
+  return typof(value).includes("number") ? Math.trunc(Number(value)) : NaN;
 };
-var float = number;
 var boolean = (value) => {
   if (typof(value).includes("boolean") && typof(value).includes("string")) {
     if (value === "true") {
@@ -95,11 +94,18 @@ var array = (value) => {
 var date = (value) => {
   return new Date(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,
-  float,
   integer,
   number,
   object,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "typof",
-  "version": "1.0.2",
-  "description": "Extract the valid types.",
+  "version": "1.0.4",
+  "description": "Infer types.",
   "license": "MIT",
   "homepage": "https://github.com/keift/typof",
   "bugs": "https://github.com/keift/typof/issues",
@@ -29,7 +29,13 @@
   "keywords": [
     "type",
     "typeof",
+    "string",
+    "number",
     "integer",
-    "float"
+    "float",
+    "boolean",
+    "object",
+    "array",
+    "date"
   ]
 }