jsfunx 1.2.0 → 1.2.2

package/jsfunx.cjs

@@ -32,6 +32,10 @@ Author: Khiat Mohammed Abderrezzak <khiat.dev@gmail.com>
 
 const and = "and";
 
+/** @type {ArrayConstructor} */
+
+const Arr = Array;
+
 /** @type {string} */
 
 const bi = "bigint";
@@ -144,6 +148,132 @@ const symbol = "symbol";
 
 const undef = "undefined";
 
+/**
+ * Runtime-guarded, readonly constructor functions map (Object).
+ * Accessing an unknown key throws at runtime.
+ *
+ * @type {Readonly<{
+ *   Arr: Array;
+ *   Array: Array;
+ *   BI: BigInt;
+ *   BigInt: BigInt;
+ *   Bool: Boolean;
+ *   Boolean: Boolean;
+ *   Fn: Function;
+ *   Fun: Function;
+ *   Func: Function;
+ *   Function: Function;
+ *   Num: Number;
+ *   Number: Number;
+ *   Obj: Object;
+ *   Object: Object;
+ *   Str: String;
+ *   String: String;
+ *   Sym: Symbol;
+ *   Symbol: Symbol;
+ * }>}
+ */
+
+const C = new Proxy(
+  Object.freeze({
+    Arr: Array,
+    Array: Array,
+    BI: BigInt,
+    BigInt: BigInt,
+    Bool: Boolean,
+    Boolean: Boolean,
+    Fn: Function,
+    Fun: Function,
+    Func: Function,
+    Function: Function,
+    Num: Number,
+    Number: Number,
+    Obj: Object,
+    Object: Object,
+    Str: String,
+    String: String,
+    Sym: Symbol,
+    Symbol: Symbol,
+  }),
+
+  {
+    get(target, prop, receiver) {
+      if (typeof prop !== "string")
+        throw new TypeError("operation not allowed");
+
+      if (prop in target) return Reflect.get(target, prop, receiver);
+
+      throw new TypeError(`constructor function '${prop}' undefined !`);
+    },
+  }
+);
+
+/**
+ * Runtime-guarded, readonly type map (Object).
+ * Accessing an unknown key throws at runtime.
+ *
+ * @type {Readonly<{
+ *   bi: "bigint";
+ *   bigint: "bigint";
+ *   bool: "boolean";
+ *   boolean: "boolean";
+ *   fn: "function";
+ *   fun: "function";
+ *   func: "function";
+ *   function: "function";
+ *   nil: null;
+ *   none: null;
+ *   null: null;
+ *   num: "number";
+ *   number: "number";
+ *   obj: "object";
+ *   object: "object";
+ *   str: "string";
+ *   string: "string";
+ *   sym: "symbol";
+ *   symbol: "symbol";
+ *   undef: "undefined";
+ *   undefined: "undefined";
+ * }>}
+ */
+
+const T = new Proxy(
+  Object.freeze({
+    bi: "bigint",
+    bigint: "bigint",
+    bool: "boolean",
+    boolean: "boolean",
+    fn: "function",
+    fun: "function",
+    func: "function",
+    function: "function",
+    nil: null,
+    none: null,
+    null: null,
+    num: "number",
+    number: "number",
+    obj: "object",
+    object: "object",
+    str: "string",
+    string: "string",
+    sym: "symbol",
+    symbol: "symbol",
+    undef: "undefined",
+    undefined: "undefined",
+  }),
+
+  {
+    get(target, prop, receiver) {
+      if (typeof prop !== "string")
+        throw new TypeError("operation not allowed");
+
+      if (prop in target) return Reflect.get(target, prop, receiver);
+
+      throw new TypeError(`type '${prop}' undefined !`);
+    },
+  }
+);
+
 /**
  * Compares a value or a list of values against a given type (or list of types),
  * similar to using `typeof x === y`, but in a more flexible and readable way.
@@ -162,7 +292,7 @@ const undef = "undefined";
 function checkType(data, dataType, logic, match, strict) {
   /** @type {Set<string | null | undefined>} */
 
-  let setOfTypes = new Set([
+  const setOfTypes = new Set([
     and,
     bi,
     bool,
@@ -178,7 +308,8 @@ function checkType(data, dataType, logic, match, strict) {
   ]);
 
   if (!(dataType instanceof Array)) {
-    if (!setOfTypes.has(dataType)) throw new TypeError("type undefined !");
+    if (!setOfTypes.has(dataType))
+      throw new TypeError(`type '${String(dataType)}' undefined !`);
 
     if (!(data instanceof Array)) {
       if (data === null) return dataType === null;
@@ -252,7 +383,7 @@ function checkType(data, dataType, logic, match, strict) {
       // 1 step directly in all cases
 
       if (!setOfTypes.has(dtype))
-        throw new TypeError(`type ${dtype} undefined !`);
+        throw new TypeError(`type '${String(dtype)}' undefined !`);
 
       if (data === null) {
         if (dtype === null) return true;
@@ -284,7 +415,7 @@ function checkType(data, dataType, logic, match, strict) {
       outerLoop: for (let dt of data) {
         for (let dtype of dataType) {
           if (!setOfTypes.has(dtype))
-            throw new TypeError(`type ${dtype} undefined !`);
+            throw new TypeError(`type '${String(dtype)}' undefined !`);
 
           if (dt === null) {
             if (dtype === null) continue outerLoop;
@@ -330,7 +461,7 @@ function checkType(data, dataType, logic, match, strict) {
       //   //   // the same as this
 
       //   //   // if (!setOfTypes.has(dtype))
-      //   //   //   throw new TypeError(`type ${dtype} undefined !`);
+      //   //   //   throw new TypeError(`type '${String(dtype)}' undefined !`);
 
       //   //   // if (data[0] === null) {
       //   //   //   if (dtype === null) return true;
@@ -371,7 +502,7 @@ function checkType(data, dataType, logic, match, strict) {
       //   //   // the same as this
 
       //   //   // if (!setOfTypes.has(dataType[0]))
-      //   //   //   throw new TypeError("type undefined !");
+      //   //   //   throw new TypeError(`type '${String(dataType[0])}' undefined !`);
 
       //   //   // if (dt === null) {
       //   //   //   if (dataType[0] !== null) return false;
@@ -438,7 +569,7 @@ function checkType(data, dataType, logic, match, strict) {
       for (let dt of data) {
         for (let dtype of dataType) {
           if (!setOfTypes.has(dtype))
-            throw new TypeError(`type ${dtype} undefined !`);
+            throw new TypeError(`type '${String(dtype)}' undefined !`);
 
           if (dt === null) {
             if (dtype === null) return true;
@@ -480,7 +611,7 @@ function checkType(data, dataType, logic, match, strict) {
       //   //   // the same as this
 
       //   //   // if (!setOfTypes.has(dtype))
-      //   //   //   throw new TypeError(`type ${dtype} undefined !`);
+      //   //   //   throw new TypeError(`type '${String(dtype)}' undefined !`);
 
       //   //   // if (data[0] === null) {
       //   //   //   if (dtype === null) return true;
@@ -523,7 +654,7 @@ function checkType(data, dataType, logic, match, strict) {
       //   //   // the same as this
 
       //   //   // if (!setOfTypes.has(dataType[0]))
-      //   //   //   throw new TypeError("type undefined !");
+      //   //   //   throw new TypeError(`type '${dataType[0]}' undefined !`);
 
       //   //   // if (dt === null) {
       //   //   //   if (dataType[0] === null) return true;
@@ -642,7 +773,7 @@ function checkType(data, dataType, logic, match, strict) {
         // 1 step directly in all cases
 
         if (!setOfTypes.has(dataType[i]))
-          throw new TypeError(`type ${dataType[i]} undefined !`);
+          throw new TypeError(`type '${String(dataType[i])}' undefined !`);
 
         if (data[i] === null) {
           if (dataType[i] !== null) return false;
@@ -675,7 +806,7 @@ function checkType(data, dataType, logic, match, strict) {
         // 1 step directly in all cases
 
         if (!setOfTypes.has(dataType[i]))
-          throw new TypeError(`type ${dataType[i]} undefined !`);
+          throw new TypeError(`type '${String(dataType[i])}' undefined !`);
 
         if (data[i] === null) {
           if (dataType[i] === null) return true;
@@ -710,7 +841,7 @@ function checkType(data, dataType, logic, match, strict) {
       // 1 step directly in all cases
 
       if (!setOfTypes.has(dataType[i]))
-        throw new TypeError(`type ${dataType[i]} undefined !`);
+        throw new TypeError(`type '${String(dataType[i])}' undefined !`);
 
       if (data[i] === null) {
         if (dataType[i] !== null) return false;
@@ -742,7 +873,7 @@ function checkType(data, dataType, logic, match, strict) {
       // 1 step directly in all cases
 
       if (!setOfTypes.has(dataType[i]))
-        throw new TypeError(`type ${dataType[i]} undefined !`);
+        throw new TypeError(`type '${String(dataType[i])}' undefined !`);
 
       if (data[i] === null) {
         if (dataType[i] === null) return true;
@@ -798,7 +929,7 @@ function isinstancesof(objs, type, logic, match, strict) {
       // return objs instanceof type;
 
       throw new TypeError(
-        `instancesof expected at least : 2 objects as first argument 'objs' or 2 types as second argument 'type', got 1`
+        `instancesof expected at least : 2 objects as first argument 'objs' or 2 constructor functions as second argument 'type', got 1`
       );
 
     // comment this condition to enable the 1/4 of (one to one)
@@ -816,7 +947,7 @@ function isinstancesof(objs, type, logic, match, strict) {
           if (!(obj instanceof type)) return false;
         } catch (error) {
           throw new TypeError(
-            "second argument of 'instancesof' is not a type/class or array of types/classes"
+            "second argument of 'instancesof' is not a constructor function or array of constructor functions"
           );
         }
 
@@ -837,7 +968,7 @@ function isinstancesof(objs, type, logic, match, strict) {
           if (obj instanceof type) return true;
         } catch (error) {
           throw new TypeError(
-            "second argument of 'instancesof' is not a type/class or array of types/classes"
+            "second argument of 'instancesof' is not a constructor function or array of constructor functions"
           );
         }
 
@@ -858,7 +989,7 @@ function isinstancesof(objs, type, logic, match, strict) {
 
     if (type.length < 2)
       throw new TypeError(
-        `instancesof expected at least 2 types as second argument 'type', got 1`
+        `instancesof expected at least 2 constructor functions as second argument 'type', got 1`
       );
 
     for (let dt of type) {
@@ -868,7 +999,7 @@ function isinstancesof(objs, type, logic, match, strict) {
         if (objs instanceof dt) return true;
       } catch (error) {
         throw new TypeError(
-          "second argument of 'instancesof' is not a type/class or array of types/classes"
+          "second argument of 'instancesof' is not a constructor function or array of constructor functions"
         );
       }
 
@@ -885,7 +1016,7 @@ function isinstancesof(objs, type, logic, match, strict) {
 
   if (objs.length < 2 && type.length < 2)
     throw new TypeError(
-      `instancesof expected at least : 2 objects as first argument 'objs' or 2 types as second argument 'type', got 1`
+      `instancesof expected at least : 2 objects as first argument 'objs' or 2 constructor functions as second argument 'type', got 1`
     );
 
   if (not(match)) {
@@ -898,7 +1029,7 @@ function isinstancesof(objs, type, logic, match, strict) {
             if (obj instanceof dt) continue outerLoop;
           } catch (error) {
             throw new TypeError(
-              "second argument of 'instancesof' is not a type/class or array of types/classes"
+              "second argument of 'instancesof' is not a constructor function or array of constructor functions"
             );
           }
         }
@@ -1013,7 +1144,7 @@ function isinstancesof(objs, type, logic, match, strict) {
             if (obj instanceof dt) return true;
           } catch (error) {
             throw new TypeError(
-              "second argument of 'instancesof' is not a type/class or array of types/classes"
+              "second argument of 'instancesof' is not a constructor function or array of constructor functions"
             );
           }
         }
@@ -1157,7 +1288,7 @@ function isinstancesof(objs, type, logic, match, strict) {
   if (objs.length !== type.length) {
     if (strict)
       throw new TypeError(
-        "length of array of types must match number of objects"
+        "length of constructor functions array must match the number of objects"
       );
 
     /** @type {number} */
@@ -1178,7 +1309,7 @@ function isinstancesof(objs, type, logic, match, strict) {
           if (!(objs[i] instanceof type[i])) return false;
         } catch (error) {
           throw new TypeError(
-            "second argument of 'instancesof' is not a type/class or array of types/classes"
+            "second argument of 'instancesof' is not a constructor function or array of constructor functions"
           );
         }
 
@@ -1202,7 +1333,7 @@ function isinstancesof(objs, type, logic, match, strict) {
           if (objs[i] instanceof type[i]) return true;
         } catch (error) {
           throw new TypeError(
-            "second argument of 'instancesof' is not a type/class or array of types/classes"
+            "second argument of 'instancesof' is not a constructor function or array of constructor functions"
           );
         }
 
@@ -1228,7 +1359,7 @@ function isinstancesof(objs, type, logic, match, strict) {
         if (!(objs[i] instanceof type[i])) return false;
       } catch (error) {
         throw new TypeError(
-          "second argument of 'instancesof' is not a type/class or array of types/classes"
+          "second argument of 'instancesof' is not a constructor function or array of constructor functions"
         );
       }
 
@@ -1251,7 +1382,7 @@ function isinstancesof(objs, type, logic, match, strict) {
         if (objs[i] instanceof type[i]) return true;
       } catch (error) {
         throw new TypeError(
-          "second argument of 'instancesof' is not a type/class or array of types/classes"
+          "second argument of 'instancesof' is not a constructor function or array of constructor functions"
         );
       }
 
@@ -1307,7 +1438,7 @@ function instancesof(
 ) {
   /** @type {number} */
 
-  let len = arguments.length;
+  const len = arguments.length;
 
   // ================================================================
 
@@ -1409,7 +1540,7 @@ function isType(
 ) {
   /** @type {number} */
 
-  let len = arguments.length;
+  const len = arguments.length;
 
   // ================================================================
 
@@ -1481,7 +1612,7 @@ function lengths(...objs) {
 
   /** @type {Array<number>} */
 
-  let lens = [objs[0].length];
+  const lens = [objs[0].length];
 
   /** @type {boolean} */
 
@@ -1546,14 +1677,18 @@ function log(...data) {
 function not(obj) {
   /** @type {number} */
 
-  let len = arguments.length;
+  const len = arguments.length;
 
   if (len !== 1)
     throw new TypeError(`not() takes exactly one argument (${len} given)`);
 
-  if (obj instanceof Boolean) return obj.valueOf() === false;
+  /** @type {*} */
+
+  const val = obj?.valueOf();
+
+  if (!(val instanceof Object) || val instanceof Function) return !val;
 
-  return obj?.length === 0 || !obj; // handling the object case
+  return val.length === 0 || !val; // handling the true object case
 }
 
 /**
@@ -1579,7 +1714,7 @@ function print(...data) {
 function printf(data) {
   if (arguments.length > 1) throw new TypeError('unexpected token ","');
 
-  process.stdout.write(`${data}`);
+  process.stdout.write(`${String(data)}`);
 }
 
 /**
@@ -1741,7 +1876,7 @@ function typesof(...objs) {
 
   /** @type {Array<string>} */
 
-  let types = [typeof objs[0]];
+  const types = [typeof objs[0]];
 
   /** @type {boolean} */
 
@@ -1823,15 +1958,15 @@ function main() {
 
   /** @type {Number} */
 
-  let a = new Number(3);
+  const a = new Number(3);
 
   /** @type {Number} */
 
-  let b = new Number(7);
+  const b = new Number(7);
 
   /** @type {String} */
 
-  let c = new String("test");
+  const c = new String("test");
 
   // one to one (disabled)
 
@@ -1897,15 +2032,15 @@ function main() {
 
   /** @type {number} */
 
-  let x = 3; // or Number(3)
+  const x = 3; // or Number(3)
 
   /** @type {number} */
 
-  let y = 7; // or Number(7)
+  const y = 7; // or Number(7)
 
   /** @type {number} */
 
-  let z = "test"; // or String("test")
+  const z = "test"; // or String("test")
 
   // one to one
 
@@ -1977,7 +2112,7 @@ function main() {
   // two args +
 
   console.log(lengths([1, 2, 3], [1, 2, 3])); // [ 3, true ]
-  console.log(lengths([1, 2, 3], "hello")); // [ [3, 5], false ]
+  console.log(lengths([1, 2, 3], "test")); // [ [3, 4], false ]
 
   console.log("--------------!--------------");
 
@@ -2029,7 +2164,7 @@ function main() {
   // two args +
 
   console.log(typesof(1, 2)); // [ number, true ]
-  console.log(typesof(1, "hi")); // [ [number, string], false ]
+  console.log(typesof(1, "test")); // [ [number, string], false ]
 
   console.log("------------------------------");
 
@@ -2048,12 +2183,14 @@ if (require.main === module) {
 
 module.exports = {
   and,
+  Arr,
   bi,
   BI,
   bigint,
   bool,
   Bool,
   boolean,
+  C,
   fn,
   Fn,
   fun,
@@ -2075,6 +2212,7 @@ module.exports = {
   sym,
   Sym,
   symbol,
+  T,
   undef,
 
   echo,

package/jsfunx.mjs

@@ -36,6 +36,10 @@ import { fileURLToPath } from "url";
 
 export const and = "and";
 
+/** @type {ArrayConstructor} */
+
+export const Arr = Array;
+
 /** @type {string} */
 
 export const bi = "bigint";
@@ -148,6 +152,132 @@ export const symbol = "symbol";
 
 export const undef = "undefined";
 
+/**
+ * Runtime-guarded, readonly constructor functions map (Object).
+ * Accessing an unknown key throws at runtime.
+ *
+ * @type {Readonly<{
+ *   Arr: Array;
+ *   Array: Array;
+ *   BI: BigInt;
+ *   BigInt: BigInt;
+ *   Bool: Boolean;
+ *   Boolean: Boolean;
+ *   Fn: Function;
+ *   Fun: Function;
+ *   Func: Function;
+ *   Function: Function;
+ *   Num: Number;
+ *   Number: Number;
+ *   Obj: Object;
+ *   Object: Object;
+ *   Str: String;
+ *   String: String;
+ *   Sym: Symbol;
+ *   Symbol: Symbol;
+ * }>}
+ */
+
+export const C = new Proxy(
+  Object.freeze({
+    Arr: Array,
+    Array: Array,
+    BI: BigInt,
+    BigInt: BigInt,
+    Bool: Boolean,
+    Boolean: Boolean,
+    Fn: Function,
+    Fun: Function,
+    Func: Function,
+    Function: Function,
+    Num: Number,
+    Number: Number,
+    Obj: Object,
+    Object: Object,
+    Str: String,
+    String: String,
+    Sym: Symbol,
+    Symbol: Symbol,
+  }),
+
+  {
+    get(target, prop, receiver) {
+      if (typeof prop !== "string")
+        throw new TypeError("operation not allowed");
+
+      if (prop in target) return Reflect.get(target, prop, receiver);
+
+      throw new TypeError(`constructor function '${prop}' undefined !`);
+    },
+  }
+);
+
+/**
+ * Runtime-guarded, readonly type map (Object).
+ * Accessing an unknown key throws at runtime.
+ *
+ * @type {Readonly<{
+ *   bi: "bigint";
+ *   bigint: "bigint";
+ *   bool: "boolean";
+ *   boolean: "boolean";
+ *   fn: "function";
+ *   fun: "function";
+ *   func: "function";
+ *   function: "function";
+ *   nil: null;
+ *   none: null;
+ *   null: null;
+ *   num: "number";
+ *   number: "number";
+ *   obj: "object";
+ *   object: "object";
+ *   str: "string";
+ *   string: "string";
+ *   sym: "symbol";
+ *   symbol: "symbol";
+ *   undef: "undefined";
+ *   undefined: "undefined";
+ * }>}
+ */
+
+export const T = new Proxy(
+  Object.freeze({
+    bi: "bigint",
+    bigint: "bigint",
+    bool: "boolean",
+    boolean: "boolean",
+    fn: "function",
+    fun: "function",
+    func: "function",
+    function: "function",
+    nil: null,
+    none: null,
+    null: null,
+    num: "number",
+    number: "number",
+    obj: "object",
+    object: "object",
+    str: "string",
+    string: "string",
+    sym: "symbol",
+    symbol: "symbol",
+    undef: "undefined",
+    undefined: "undefined",
+  }),
+
+  {
+    get(target, prop, receiver) {
+      if (typeof prop !== "string")
+        throw new TypeError("operation not allowed");
+
+      if (prop in target) return Reflect.get(target, prop, receiver);
+
+      throw new TypeError(`type '${prop}' undefined !`);
+    },
+  }
+);
+
 /**
  * Compares a value or a list of values against a given type (or list of types),
  * similar to using `typeof x === y`, but in a more flexible and readable way.
@@ -166,7 +296,7 @@ export const undef = "undefined";
 function checkType(data, dataType, logic, match, strict) {
   /** @type {Set<string | null | undefined>} */
 
-  let setOfTypes = new Set([
+  const setOfTypes = new Set([
     and,
     bi,
     bool,
@@ -182,7 +312,8 @@ function checkType(data, dataType, logic, match, strict) {
   ]);
 
   if (!(dataType instanceof Array)) {
-    if (!setOfTypes.has(dataType)) throw new TypeError("type undefined !");
+    if (!setOfTypes.has(dataType))
+      throw new TypeError(`type '${String(dataType)}' undefined !`);
 
     if (!(data instanceof Array)) {
       if (data === null) return dataType === null;
@@ -256,7 +387,7 @@ function checkType(data, dataType, logic, match, strict) {
       // 1 step directly in all cases
 
       if (!setOfTypes.has(dtype))
-        throw new TypeError(`type ${dtype} undefined !`);
+        throw new TypeError(`type '${String(dtype)}' undefined !`);
 
       if (data === null) {
         if (dtype === null) return true;
@@ -288,7 +419,7 @@ function checkType(data, dataType, logic, match, strict) {
       outerLoop: for (let dt of data) {
         for (let dtype of dataType) {
           if (!setOfTypes.has(dtype))
-            throw new TypeError(`type ${dtype} undefined !`);
+            throw new TypeError(`type '${String(dtype)}' undefined !`);
 
           if (dt === null) {
             if (dtype === null) continue outerLoop;
@@ -334,7 +465,7 @@ function checkType(data, dataType, logic, match, strict) {
       //   //   // the same as this
 
       //   //   if (!setOfTypes.has(dtype))
-      //   //     throw new TypeError(`type ${dtype} undefined !`);
+      //   //     throw new TypeError(`type '${String(dtype)}' undefined !`);
 
       //   //   if (data[0] === null) {
       //   //     if (dtype === null) return true;
@@ -375,7 +506,7 @@ function checkType(data, dataType, logic, match, strict) {
       //   //   // the same as this
 
       //   //   // if (!setOfTypes.has(dataType[0]))
-      //   //   //   throw new TypeError("type undefined !");
+      //   //   //   throw new TypeError(`type '${String(dataType[0])}' undefined !`);
 
       //   //   // if (dt === null) {
       //   //   //   if (dataType[0] !== null) return false;
@@ -442,7 +573,7 @@ function checkType(data, dataType, logic, match, strict) {
       for (let dt of data) {
         for (let dtype of dataType) {
           if (!setOfTypes.has(dtype))
-            throw new TypeError(`type ${dtype} undefined !`);
+            throw new TypeError(`type '${String(dtype)}' undefined !`);
 
           if (dt === null) {
             if (dtype === null) return true;
@@ -484,7 +615,7 @@ function checkType(data, dataType, logic, match, strict) {
       //   //   // the same as this
 
       //   //   // if (!setOfTypes.has(dtype))
-      //   //   //   throw new TypeError(`type ${dtype} undefined !`);
+      //   //   //   throw new TypeError(`type '${String(dtype)}' undefined !`);
 
       //   //   // if (data[0] === null) {
       //   //   //   if (dtype === null) return true;
@@ -527,7 +658,7 @@ function checkType(data, dataType, logic, match, strict) {
       //   //   // the same as this
 
       //   //   // if (!setOfTypes.has(dataType[0]))
-      //   //   //   throw new TypeError("type undefined !");
+      //   //   //   throw new TypeError(`type '${String(dataType[0])}' undefined !`);
 
       //   //   // if (dt === null) {
       //   //   //   if (dataType[0] === null) return true;
@@ -646,7 +777,7 @@ function checkType(data, dataType, logic, match, strict) {
         // 1 step directly in all cases
 
         if (!setOfTypes.has(dataType[i]))
-          throw new TypeError(`type ${dataType[i]} undefined !`);
+          throw new TypeError(`type '${String(dataType[i])}' undefined !`);
 
         if (data[i] === null) {
           if (dataType[i] !== null) return false;
@@ -679,7 +810,7 @@ function checkType(data, dataType, logic, match, strict) {
         // 1 step directly in all cases
 
         if (!setOfTypes.has(dataType[i]))
-          throw new TypeError(`type ${dataType[i]} undefined !`);
+          throw new TypeError(`type '${String(dataType[i])}' undefined !`);
 
         if (data[i] === null) {
           if (dataType[i] === null) return true;
@@ -714,7 +845,7 @@ function checkType(data, dataType, logic, match, strict) {
       // 1 step directly in all cases
 
       if (!setOfTypes.has(dataType[i]))
-        throw new TypeError(`type ${dataType[i]} undefined !`);
+        throw new TypeError(`type '${String(dataType[i])}' undefined !`);
 
       if (data[i] === null) {
         if (dataType[i] !== null) return false;
@@ -746,7 +877,7 @@ function checkType(data, dataType, logic, match, strict) {
       // 1 step directly in all cases
 
       if (!setOfTypes.has(dataType[i]))
-        throw new TypeError(`type ${dataType[i]} undefined !`);
+        throw new TypeError(`type '${String(dataType[i])}' undefined !`);
 
       if (data[i] === null) {
         if (dataType[i] === null) return true;
@@ -802,7 +933,7 @@ function isinstancesof(objs, type, logic, match, strict) {
       // return objs instanceof type;
 
       throw new TypeError(
-        `instancesof expected at least : 2 objects as first argument 'objs' or 2 types as second argument 'type', got 1`
+        `instancesof expected at least : 2 objects as first argument 'objs' or 2 constructor functions as second argument 'type', got 1`
       );
 
     // comment this condition to enable the 1/4 of (one to one)
@@ -820,7 +951,7 @@ function isinstancesof(objs, type, logic, match, strict) {
           if (!(obj instanceof type)) return false;
         } catch (error) {
           throw new TypeError(
-            "second argument of 'instancesof' is not a type/class or array of types/classes"
+            "second argument of 'instancesof' is not a constructor function or array of constructor functions"
           );
         }
 
@@ -841,7 +972,7 @@ function isinstancesof(objs, type, logic, match, strict) {
           if (obj instanceof type) return true;
         } catch (error) {
           throw new TypeError(
-            "second argument of 'instancesof' is not a type/class or array of types/classes"
+            "second argument of 'instancesof' is not a constructor function or array of constructor functions"
           );
         }
 
@@ -862,7 +993,7 @@ function isinstancesof(objs, type, logic, match, strict) {
 
     if (type.length < 2)
       throw new TypeError(
-        `instancesof expected at least 2 types as second argument 'type', got 1`
+        `instancesof expected at least 2 constructor functions as second argument 'type', got 1`
       );
 
     for (let dt of type) {
@@ -872,7 +1003,7 @@ function isinstancesof(objs, type, logic, match, strict) {
         if (objs instanceof dt) return true;
       } catch (error) {
         throw new TypeError(
-          "second argument of 'instancesof' is not a type/class or array of types/classes"
+          "second argument of 'instancesof' is not a constructor function or array of constructor functions"
         );
       }
 
@@ -889,7 +1020,7 @@ function isinstancesof(objs, type, logic, match, strict) {
 
   if (objs.length < 2 && type.length < 2)
     throw new TypeError(
-      `instancesof expected at least : 2 objects as first argument 'objs' or 2 types as second argument 'type', got 1`
+      `instancesof expected at least : 2 objects as first argument 'objs' or 2 constructor functions as second argument 'type', got 1`
     );
 
   if (not(match)) {
@@ -902,7 +1033,7 @@ function isinstancesof(objs, type, logic, match, strict) {
             if (obj instanceof dt) continue outerLoop;
           } catch (error) {
             throw new TypeError(
-              "second argument of 'instancesof' is not a type/class or array of types/classes"
+              "second argument of 'instancesof' is not a constructor function or array of constructor functions"
             );
           }
         }
@@ -1017,7 +1148,7 @@ function isinstancesof(objs, type, logic, match, strict) {
             if (obj instanceof dt) return true;
           } catch (error) {
             throw new TypeError(
-              "second argument of 'instancesof' is not a type/class or array of types/classes"
+              "second argument of 'instancesof' is not a constructor function or array of constructor functions"
             );
           }
         }
@@ -1161,7 +1292,7 @@ function isinstancesof(objs, type, logic, match, strict) {
   if (objs.length !== type.length) {
     if (strict)
       throw new TypeError(
-        "length of array of types must match number of objects"
+        "length of constructor functions array must match the number of objects"
       );
 
     /** @type {number} */
@@ -1182,7 +1313,7 @@ function isinstancesof(objs, type, logic, match, strict) {
           if (!(objs[i] instanceof type[i])) return false;
         } catch (error) {
           throw new TypeError(
-            "second argument of 'instancesof' is not a type/class or array of types/classes"
+            "second argument of 'instancesof' is not a constructor function or array of constructor functions"
           );
         }
 
@@ -1206,7 +1337,7 @@ function isinstancesof(objs, type, logic, match, strict) {
           if (objs[i] instanceof type[i]) return true;
         } catch (error) {
           throw new TypeError(
-            "second argument of 'instancesof' is not a type/class or array of types/classes"
+            "second argument of 'instancesof' is not a constructor function or array of constructor functions"
           );
         }
 
@@ -1232,7 +1363,7 @@ function isinstancesof(objs, type, logic, match, strict) {
         if (!(objs[i] instanceof type[i])) return false;
       } catch (error) {
         throw new TypeError(
-          "second argument of 'instancesof' is not a type/class or array of types/classes"
+          "second argument of 'instancesof' is not a constructor function or array of constructor functions"
         );
       }
 
@@ -1255,7 +1386,7 @@ function isinstancesof(objs, type, logic, match, strict) {
         if (objs[i] instanceof type[i]) return true;
       } catch (error) {
         throw new TypeError(
-          "second argument of 'instancesof' is not a type/class or array of types/classes"
+          "second argument of 'instancesof' is not a constructor function or array of constructor functions"
         );
       }
 
@@ -1311,7 +1442,7 @@ export function instancesof(
 ) {
   /** @type {number} */
 
-  let len = arguments.length;
+  const len = arguments.length;
 
   // ================================================================
 
@@ -1413,7 +1544,7 @@ export function isType(
 ) {
   /** @type {number} */
 
-  let len = arguments.length;
+  const len = arguments.length;
 
   // ================================================================
 
@@ -1485,7 +1616,7 @@ export function lengths(...objs) {
 
   /** @type {Array<number>} */
 
-  let lens = [objs[0].length];
+  const lens = [objs[0].length];
 
   /** @type {boolean} */
 
@@ -1550,14 +1681,18 @@ export function log(...data) {
 export function not(obj) {
   /** @type {number} */
 
-  let len = arguments.length;
+  const len = arguments.length;
 
   if (len !== 1)
     throw new TypeError(`not() takes exactly one argument (${len} given)`);
 
-  if (obj instanceof Boolean) return obj.valueOf() === false;
+  /** @type {*} */
+
+  const val = obj?.valueOf();
+
+  if (!(val instanceof Object) || val instanceof Function) return !val;
 
-  return obj?.length === 0 || !obj; // handling the object case
+  return val.length === 0 || !val; // handling the true object case
 }
 
 /**
@@ -1583,7 +1718,7 @@ export function print(...data) {
 export function printf(data) {
   if (arguments.length > 1) throw new TypeError('unexpected token ","');
 
-  process.stdout.write(`${data}`);
+  process.stdout.write(`${String(data)}`);
 }
 
 /**
@@ -1745,7 +1880,7 @@ export function typesof(...objs) {
 
   /** @type {Array<string>} */
 
-  let types = [typeof objs[0]];
+  const types = [typeof objs[0]];
 
   /** @type {boolean} */
 
@@ -1832,15 +1967,15 @@ function main() {
 
   /** @type {Number} */
 
-  let a = new Number(3);
+  const a = new Number(3);
 
   /** @type {Number} */
 
-  let b = new Number(7);
+  const b = new Number(7);
 
   /** @type {String} */
 
-  let c = new String("test");
+  const c = new String("test");
 
   // one to one (disabled)
 
@@ -1906,15 +2041,15 @@ function main() {
 
   /** @type {number} */
 
-  let x = 3; // or Number(3)
+  const x = 3; // or Number(3)
 
   /** @type {number} */
 
-  let y = 7; // or Number(7)
+  const y = 7; // or Number(7)
 
   /** @type {number} */
 
-  let z = "test"; // or String("test")
+  const z = "test"; // or String("test")
 
   // one to one
 
@@ -1986,7 +2121,7 @@ function main() {
   // two args +
 
   console.log(lengths([1, 2, 3], [1, 2, 3])); // [ 3, true ]
-  console.log(lengths([1, 2, 3], "hello")); // [ [3, 5], false ]
+  console.log(lengths([1, 2, 3], "test")); // [ [3, 4], false ]
 
   console.log("--------------!--------------");
 
@@ -2038,7 +2173,7 @@ function main() {
   // two args +
 
   console.log(typesof(1, 2)); // [ number, true ]
-  console.log(typesof(1, "hi")); // [ [number, string], false ]
+  console.log(typesof(1, "test")); // [ [number, string], false ]
 
   console.log("------------------------------");
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsfunx",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "JavaScript utility functions for cleaner, more readable code",
   "main": "./jsfunx.cjs",
   "module": "./jsfunx.mjs",