type-czech-require-dev.js

/* 

Development TypeCzech.js REQUIRED code for Node.js CJS

When in development, this large file replaces type-czech-require.js, 
providing all the type checking functions without any changes to the source code.

Used thus:
  const { TypeCzech_obj } = require("./node_modules/type-czech/type-czech-require.js");
  const { TypeCzech } = TypeCzech_obj;
  const type_czech = TypeCzech(["CONSOLE-COUNT", "LOG-ERRORS"]);

*/

/* eslint-disable max-len */
/* eslint-disable block-scoped-var */
const VERS_NUM = "version 1.7.5 2024-01-17";

/*
    TypeCzech contains:
      - Douglas Crockford's Cycle.js for working with cyclic variables
        https://github.com/douglascrockford/JSON-js/blob/master/cycle.js

      - Evgeny Poberezkin and James Hallidays fast-json-stable-stringify
        https://github.com/epoberezkin/fast-json-stable-stringify

    These two packages make mutation checking possible, and are included
    directly in this code to make it easier to use.
*/

/*
    This software is released under the MIT license:

   @license Copyright (c) 2021 Steen Hansen

    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.
*/

let the_exports;
if (typeof window !== "undefined") {
  the_exports = window; // for browser environment
} else if (typeof exports !== "undefined") {
  the_exports = exports; // for Node environment
} else {
  the_exports = {}; // for JSX environment
}

// TYPE_CZECH_current_test_number is set by every test, so can find out which test is crashing in a certain function
// eslint-disable-next-line block-scoped-var, no-use-before-define
if (typeof TYPE_CZECH_current_test_number === "undefined") {
  // eslint-disable-next-line no-var, vars-on-top
  var TYPE_CZECH_current_test_number = "not-in-test-yet"; // global variable assigned in the test
}

// eslint-disable-next-line func-names
(function (export_tech_czech) {
  // TypeCzech object, browser or Node.Js
  // eslint-disable-next-line func-names,no-param-reassign
  export_tech_czech.TypeCzech = function () {
    if (arguments.length > 0) {
      // eslint-disable-next-line no-use-before-define, prefer-rest-params, no-param-reassign
      export_tech_czech.type_czech = _TypeCzech(...arguments);
    } else if (typeof export_tech_czech.TYPE_CZECH_COMMANDS !== "undefined" && export_tech_czech.TYPE_CZECH_COMMANDS.length > 0) {
      // eslint-disable-next-line no-use-before-define, no-param-reassign
      export_tech_czech.type_czech = _TypeCzech(export_tech_czech.TYPE_CZECH_COMMANDS); // for examples
    } else {
      // eslint-disable-next-line no-param-reassign, no-unused-vars
      export_tech_czech.type_czech = {
        linkUp: (nop) => nop,
        isActive: (x) => false,
        isPruned: (y) => false,
        _from: "type-czech-require-dev",
      };
    }
    return export_tech_czech.type_czech;

    function _TypeCzech(...the_parameters) {
      // type_czech = TypeCzech('LOG-ERRORS')
      // start TypeCzech variables
      let last_shape_method = ["", ""]; // the shape of parameters and method name of the last check
      let t_param_check_func; // reference to _ParametersCheck()
      let t_check_events = false; // sometimes set to TYPE_CZECH_EVENTS
      let t_do_param_checking = false; // look for errors?
      let t_debug_indent = 0; // debugSignature() indent
      const t_reference_stacks = {}; // JSON copies of possible mutations
      const t_proxy_targets = new WeakSet(); // list of proxied things
      // end TypeCzech variables

      const PRE_FUNCTION_NO_THIS = "PRE-FUNC:"; //         'PRE-FUNC-NO-THIS :: ';  information about this type was too much
      const PRE_FUNCTION_WITH_THIS = "PRE-FUNC:"; //       'PRE-FUNC-THIS :: ';     but kept here in case
      const POST_FUNCTION_NO_THIS = "POST-FUNC:"; //       'POST-FUNC-NO-THIS :: ';
      const POST_FUNCTION_WITH_THIS = "POST-FUNC:"; //     'POST-FUNC-THIS :: ';
      const PRE_CONST_CLASS_NO_THIS = "PRE-CLASS:"; //     'PRE-CLASS-NO-THIS :: ';
      const POST_CONST_CLASS_WITH_THIS = "POST-CLASS:"; // 'POST-CLASS-THIS :: ';
      const PRE_OBJECT_NO_THIS = "PRE-OBJ:"; //            'PRE-OBJ-NO-THIS :: ';
      const PRE_OBJECT_WITH_THIS = "PRE-OBJ:"; //          'PRE-OBJ-THIS :: ';
      const POST_CONST_OBJECT_NO_THIS = "POST-OBJ:"; //    'POST-OBJ-NO-THIS :: ';
      const POST_CONST_OBJECT_WITH_THIS = "POST-OBJ:"; //  'POST-OBJ-THIS :: ';

      const OPT_THROW_EXCEPTIONS = "THROW-EXCEPTIONS";
      const OPT_LOG_ERRORS = "LOG-ERRORS";

      // The checkParam_type options to TypeCzech

      let OP_THROW_EXCEPTIONS = false; // 'THROW-EXCEPTIONS'
      let OP_NO_ERROR_MESSAGES = false; // 'NO-ERROR-MESSAGES'
      let OP_LOG_ERRORS = false; //       'LOG-ERRORS'          'NO-CHECKING' stops checking

      // 'UNDEF-OK' only affects checkParam_type(), checkParam_typeExtra(), checkParam_typeEither(), and checkParam_typeExtra()
      let OP_UNDEF_OK = false; //            'UNDEF-OK'

      let OP_CONSOLE_COUNT = false; //       'CONSOLE-COUNT'
      let OP_DEBUG_ERROR_TAGS = false; //     'DEBUG-ERROR-TAGS' show "TC@123" for fast finding of bugs
      let OP_DEBUG_CONSOLE_TRACE = false; // 'DEBUG-CONSOLE-TRACE' shows all function entries and exits
      let OP_HIDE_INIT_MESSAGE = false; //       'HIDE-INIT-MESSAGE'

      const DIFF_BEGIN_LEN = 100;
      const DIFF_END_LEN = 50;
      const DIFF_BREAK_MIN = DIFF_BEGIN_LEN + DIFF_END_LEN + 10;
      const DIFF_SEPARATOR = "<<<~~~>>>"; // hides tonnes of diff text

      const MESS_TYPE_VARIADIC = "checkArgs_typeEach()";
      const MESS_EMPTY_VARIADIC = "checkArgs_emptyEach()";

      const MESS_OBJ_INTERFACE = "check_interface()";
      const MESS_MUTATED = "check_mutatedSnapshot()"; // which function call caused error

      const MESS_SNAPSHOT = "check_buildSnapshot()";
      const MESS_TYPE_VERIFY = "checkParam_type()";

      const MESS_TYPE_OBJ_ARRAY = "checkArray_objType()";
      const MESS_EMPTY_OBJ_ARRAY = "checkArray_objEmpty()";

      const MESS_TYPE_EXTRAS = "checkParam_typeExtra()";
      const MESS_TYPE_ONE_OF = "checkParam_typeEither()";

      const MESS_EMPTY_VERIFY = "checkParam_empty()";
      const MESS_EMPTY_EXTRAS = "checkParam_emptyExtra()";
      const MESS_EMPTY_ONE_OF = "checkParam_emptyEither()";

      const MESS_CHECK_ASSERT = "check_assert()";

      const TRACE_COLORS = "background: #ee0; color: #00F";
      const ERROR_COLORS = "background: #ee0; color: #F00"; // background colors on check events
      const START_COLORS = "background: #cc0; color: #080";

      const BLANK_STR_D_QUOTE = '""';
      const BLANK_STR_S_QUOTE = "''";
      const CZECH_ERROR_INDENT = "\n\t\t";
      const PARAMS_OF_FUNCTION = /([^(]*\()([^)]*)/;

      const START_OF_FUNCTION_LEN = 30;

      const EMPTY_REGEXP = "/(?:)/"; // same as new RegExp("")
      // const EMPTY_DATE = new Date("");

      const EMPTY_OK = "EMPTY-OK";
      const EMPTY_ER = "EMPTY-ERROR";
      const EMPTY_IG = "EMPTY-IGNORE";

      // Short empty types:  'OK',         'ER',         'IG'
      const SHORT_EMPTIES = { OK: EMPTY_OK, ER: EMPTY_ER, IG: EMPTY_IG };

      const TYPE_EXTRAS = "TYPE-EXTRAS";
      const TYPE_VERIFY = "TYPE-VERIFY";
      const EMPTY_EXTRAS = "EMPTY-EXTRAS";
      const EMPTY_VERIFY = "EMPTY-VERIFY";

      const CONSTRUCTOR_PROTOTYPES = ["Array", "BigInt", "Boolean", "Date", "Function", "Number", "Object", "RegExp", "String", "Symbol"]; // Promise ?

      const TYPE_OF_TO_PROTO = {
        array: "Array",
        bigint: "BigInt",
        boolean: "Boolean",
        date: "Date",
        function: "Function",
        number: "Number",
        object: "Object",
        regexp: "RegExp",
        string: "String",
        symbol: "Symbol",
      };

      const SCALAR_TYPE_OFS = ["array", "bigint", "boolean", "date", "function", "number", "object", "regexp", "string", "symbol"];

      const TYPE_SET_SCALAR = new Set(SCALAR_TYPE_OFS);

      const UNDEFINED_AS_STR = "undefined";
      const NULL_AS_STR = "null";
      const NAN_AS_STR = "NaN";
      const INFINITY_AS_STR = "Infinity";

      const PLAIN_UNDEFINED_STR_VALUE = "Str_ify_100057_100193:und_200087";
      const QUOTED_UNDEFINED_STR_VALUE = `"${PLAIN_UNDEFINED_STR_VALUE}"`; // temporary values

      const PLAIN_NULL_STR_VALUE = "Str_ify_100333_100417:null_200227";
      const QUOTED_NULL_STR_VALUE = `"${PLAIN_NULL_STR_VALUE}"`;

      const PLAIN_NAN_STR_VALUE = "Str_ify_100523_100669:NaN_200351"; // Not perfect, but good enough for me
      const QUOTED_NAN_STR_VALUE = `"${PLAIN_NAN_STR_VALUE}"`;

      const PLAIN_INFINITY_STR_VALUE = "Str_ify_100799_100931:Inf_200461";
      const QUOTED_INFINITY_STR_VALUE = `"${PLAIN_INFINITY_STR_VALUE}"`;

      const START_CHECK_COLOR = "green";
      const DO_CHECK_COLOR = "blue";
      const FAIL_CHECK_COLOR = "red";

      const NO_PARAMS_FOUND = "There are no params to match array signature.";
      const IS_INIT_CONSOLE = "TypeCzech-init";

      const TYPE_CHECK_NOP = {
        linkUp: (nop) => nop,
        isActive: (x) => false,
        isPruned: (y) => false,
        _from: "type-czech-require-dev",
      };

      const TYPE_CZECH_EVENTS = {
        bBlink: (back_color) => {
          document.body.style.background = back_color;
          setTimeout(() => {
            document.body.style.background = "white";
          }, 100);
        },
        onStart: () => TYPE_CZECH_EVENTS.bBlink(START_CHECK_COLOR),
        onCheck: () => TYPE_CZECH_EVENTS.bBlink(DO_CHECK_COLOR),
        onError: () => TYPE_CZECH_EVENTS.bBlink(FAIL_CHECK_COLOR),
      };

      function consolelog(...args) {
        // for complete debug tracing
        if (OP_DEBUG_CONSOLE_TRACE) {
          // eslint-disable-next-line no-console
          console.log(args);
        }
      }

      /*
type_czech._coloredConsole("_my colored text+", 'background: #000; color: #fff');
//my colored text
*/
      function _coloredConsole(the_args, the_css) {
        // eslint-disable-next-line no-use-before-define
        const args_str = _jsonStr(the_args);
        const the_text = args_str.substring(1, args_str.length - 1);
        // eslint-disable-next-line no-console
        if (typeof window !== "undefined") {
          console.log(`%c ${the_text}`, the_css);
        } else {
          // https://gist.github.com/abritinthebay/d80eb99b2726c83feb0d97eab95206c4
          //          yellow-back  red-text
          console.log("\x1b[43m" + "\x1b[31m" + the_text + "\x1b[0m"); // node.jsx
        }
      }

      /*
type_czech._doubleToSingleQuotes(` ['number','string",{"a":'number','B':"number"}]`);
//['number','string',{'a':'number','B':'number'}]
*/
      function _doubleToSingleQuotes(double_quotes) {
        consolelog("^^^ _doubleToSingleQuotes ENTER", double_quotes, TYPE_CZECH_current_test_number);
        const single_quotes = double_quotes.replace(/"/g, "'");
        consolelog("^^^ _doubleToSingleQuotes EXIT", single_quotes);
        return single_quotes;
      }

      /*
type_czech._isCollection([]);
//true
type_czech._isCollection({});
//true
type_czech._isCollection('');
//false
type_czech._isCollection(12);
//false
*/
      function _isCollection(a_variable) {
        consolelog("^^^ _isCollection ENTER", a_variable, TYPE_CZECH_current_test_number);
        // eslint-disable-next-line no-use-before-define
        const a_type = _aTypeOf(a_variable);
        const a_collection = a_type === "array" ? true : a_type === "object"; // only [] and {}
        consolelog("^^^ _isCollection EXIT", a_collection);
        return a_collection;
      }

      /*
type_czech._isArgumentsObject('a-string');
//false

type_czech._isArgumentsObject([1]);
//false

type_czech._isArgumentsObject({abc:17, length:0});
//false

type_czech._isArgumentsObject({def:18, length:1});
//false

type_czech._isArgumentsObject({ghi:19, length:2});
//false

function test_a_1901(a_var){
  console.log('true', type_czech._isArgumentsObject(arguments));
}
test_a_1901(1901)
//true, true

function test_c_1903(a_var){
  console.log('true', type_czech._isArgumentsObject(arguments));
}
test_c_1903(1903, 1904)
//true, true
*/
      function _isArgumentsObject(the_params) {
        consolelog("^^^ _isArgumentsObject ENTER", the_params, TYPE_CZECH_current_test_number);
        if (_isCollection(the_params)) {
          if (!Array.isArray(the_params)) {
            if (typeof the_params.length === "number") {
              const param_length = the_params.length;
              const the_keys = Object.keys(the_params);
              if (the_keys.length === param_length) {
                for (let number_id = 0; number_id < param_length; number_id += 1) {
                  if (!(number_id in the_params)) {
                    return false;
                  }
                }
                return true;
              }
            }
          }
        }
        return false;
      }

      /*
type_czech._isScalar([]);
//false
type_czech._isScalar(12);
//true
*/
      function _isScalar(a_variable) {
        return !_isCollection(a_variable);
      }

      /*
type_czech._toStr(Infinity);
//Infinity
type_czech._toStr(NaN);
//NaN
type_czech._toStr(234n);
//234n
type_czech._toStr(undefined);
//undefined
type_czech._toStr(' my "double" quotes');
//my \"double\" quotes
type_czech._toStr({a:` ' " `});
//{a:\" ' \" \"}
type_czech._toStr({B:''});
//{B:\"\"}
type_czech._toStr([ "super", 'man' ]);
//[\"super\",\"man\"]
type_czech._toStr([186n]);
//[186n]
type_czech._toStr({big_int:187n});
//{big_int:187n}
type_czech._toStr([[[[[188n]]]]]);
//[[[[[188n]]]]]
type_czech._toStr({big_int:{big_int:{big_int:{big_int:{big_int:{big_int:{big_int:189n}}}}}}});
//{big_int:{big_int:{big_int:{big_int:{big_int:{big_int:{big_int:189n}}}}}}}
type_czech._toStr(Symbol('sym'))
//Symbol('sym')
type_czech._toStr({a:1, "b b":22, c:33});
//{a:1,\"b b\":22,c:33}
type_czech._toStr("")
//''
*/

      function _toStr(maybe_undef, collection_newline = "") {
        consolelog("^^^ _toStr ENTER", maybe_undef, collection_newline, TYPE_CZECH_current_test_number);
        let to_str;
        if (_isCollection(maybe_undef)) {
          let collection_indent = "";
          if (collection_newline) {
            const indent_spaces = " ".repeat(t_debug_indent);
            collection_indent = `${collection_newline}${indent_spaces}`;
            t_debug_indent += 1;
          }
          // eslint-disable-next-line no-use-before-define
          to_str = collection_indent + _collectionToStr(maybe_undef, collection_newline);
        } else if (typeof maybe_undef === "undefined") {
          to_str = UNDEFINED_AS_STR;
        } else if (typeof maybe_undef === "bigint") {
          to_str = `${maybe_undef}n`;
        } else if (typeof maybe_undef === "string") {
          if (maybe_undef === QUOTED_NULL_STR_VALUE) {
            to_str = NULL_AS_STR;
          } else if (maybe_undef === QUOTED_UNDEFINED_STR_VALUE) {
            to_str = UNDEFINED_AS_STR;
          } else if (maybe_undef === QUOTED_NAN_STR_VALUE) {
            to_str = NAN_AS_STR;
          } else if (maybe_undef === QUOTED_INFINITY_STR_VALUE) {
            to_str = INFINITY_AS_STR;
          } else {
            let no_string_postfix = maybe_undef.replace(/"/g, '"');
            if (no_string_postfix.startsWith('"{') && no_string_postfix.endsWith('}"')) {
              const bracket_end = no_string_postfix.length - 1;
              to_str = no_string_postfix.substring(1, bracket_end);
            } else {
              no_string_postfix = no_string_postfix.replace(/"$/g, "");
              no_string_postfix = no_string_postfix.replace(/^"/g, "");
              if (no_string_postfix.length === 0) {
                no_string_postfix = BLANK_STR_S_QUOTE;
              }
              to_str = no_string_postfix;
            }
          }
        } else if (typeof maybe_undef === "symbol") {
          to_str = maybe_undef.toString();
          to_str = to_str.replace(/\(/g, "('");
          to_str = to_str.replace(/\)/g, "')");
        } else {
          // eslint-disable-next-line no-use-before-define
          const double_quotes = _jsonStr(maybe_undef);
          if (typeof maybe_undef === "object") {
            const single_quotes = _doubleToSingleQuotes(double_quotes);
            to_str = single_quotes;
          } else {
            to_str = double_quotes;
          }
        }
        consolelog("^^^ _toStr EXIT", to_str);
        return to_str;
      }

      function debugSignature(a_signature) {
        t_debug_indent = 0;
        const debug_pyramid = _toStr(a_signature, "\n");
        return debug_pyramid;
      }

      /*
type_czech._stringifyReplacer('not-used', Infinity);    // todo fix this one day
//Str_ify_100799_100931:Inf_200461
type_czech._stringifyReplacer('not-used', 12n);
//12n
type_czech._stringifyReplacer('not-used', undefined);
//Str_ify_100057_100193:und_200087
type_czech._stringifyReplacer('not-used', NaN);
//Str_ify_100523_100669:NaN_200351
type_czech._stringifyReplacer('not-used', function(x,y,z){console.log(x,y,z)});
//function(x,y,z){console.log(x, ~~~function~~~
type_czech._stringifyReplacer('not-used', Symbol("sym"));
//Symbol('sym')
*/
      function _stringifyReplacer(_key, value) {
        consolelog("^^^ _stringifyReplacer ENTER", _key, value, TYPE_CZECH_current_test_number);
        let replaced_value;
        if (typeof value === "bigint") {
          replaced_value = `${value}n`;
        } else if (value === null) {
          replaced_value = PLAIN_NULL_STR_VALUE;
        } else if (typeof value === "undefined") {
          replaced_value = PLAIN_UNDEFINED_STR_VALUE;
        } else if (Number.isNaN(value)) {
          replaced_value = PLAIN_NAN_STR_VALUE;
        } else if (typeof value === "number" && !Number.isFinite(value)) {
          replaced_value = PLAIN_INFINITY_STR_VALUE;
        } else if (typeof value === "function") {
          const func_text = String(value);
          const no_new_lines = func_text.replace(/\s+/g, " ");
          const func_start = no_new_lines.substring(0, START_OF_FUNCTION_LEN); // shorten function for display
          replaced_value = `${func_start} ~~~function~~~`;
        } else if (value && value.constructor === RegExp) {
          // NB mutations not shortened
          const regex_text = String(value);
          const regex_start = regex_text.substring(0, START_OF_FUNCTION_LEN); // shorten regex for display
          replaced_value = `${regex_start} ~~~regex~~~`;
        } else if (typeof value === "string") {
          replaced_value = value;
        } else if (typeof value === "symbol") {
          replaced_value = _toStr(value);
        } else {
          replaced_value = value;
        }
        consolelog("^^^ _stringifyReplacer EXIT", replaced_value);
        return replaced_value;
      }

      /*
type_czech._jsonStr(234n);
//234n
type_czech._jsonStr(Infinity);
//Infinity
type_czech._jsonStr(undefined);
//undefined
type_czech._jsonStr({a:1, b:22n, c:undefined, d:{e:'f', g:'h'}});
//{\"a\":1,\"b\":\"22n\",\"c\":\"Str_ify_100057_100193:und_200087\",\"d\":{\"e\":\"f\",\"g\":\"h\"}}
type_czech._jsonStr([1n,[2n,[3n,[4n]]]]);
//[\"1n\",[\"2n\",[\"3n\",[\"4n\"]]]]
type_czech._jsonStr(Symbol("sym"))
//Symbol('sym')
type_czech._jsonStr("")
//''
type_czech._jsonStr({Infinity:Infinity, NaN: NaN, null:null, undefined:undefined})
//{\"Infinity\":\"Str_ify_100799_100931:Inf_200461\",\"NaN\":\"Str_ify_100523_100669:NaN_200351\",\"null\":\"Str_ify_100333_100417:null_200227\",\"undefined\":\"Str_ify_100057_100193:und_200087\"}
type_czech._jsonStr([Infinity, NaN, null, undefined])
//[\"Str_ify_100799_100931:Inf_200461\",\"Str_ify_100523_100669:NaN_200351\",\"Str_ify_100333_100417:null_200227\",\"Str_ify_100057_100193:und_200087\"]
*/
      function _jsonStr(an_object) {
        consolelog("^^^ _jsonStr ENTER", an_object, TYPE_CZECH_current_test_number);
        let obj_str = "";
        try {
          const json_str = JSON.stringify(an_object, _stringifyReplacer);
          obj_str = _toStr(json_str);
        } catch (e) {
          //console.log('XXXXXXXXXXXXXXXXXXXXXX', an_object)

          //  type_czech._jsonStr(window)
          obj_str = typeFinal(an_object);
          //obj_str ='Circular JSON found in error message'
        }
        consolelog("^^^ _jsonStr EXIT", obj_str);
        return obj_str;
      }

      /*
class Person {  constructor(){}  };
type_czech._className(Person);
//Person
class Car {  constructor(){}  };
a_car = Car;
type_czech._className(a_car);
//Car
type_czech._className(Object);
//''
*/
      function _className(a_var) {
        consolelog("^^^ _className ENTER", a_var, TYPE_CZECH_current_test_number);
        let class_name = "";
        const class_string = a_var.toString();
        if (class_string.startsWith("class ") && class_string.includes(" constructor(")) {
          class_name = a_var.name;
        }
        consolelog("^^^ _className EXIT", class_name);
        return class_name;
      }

      /*
function is_not_class(){};
type_czech._isAClass(is_not_class);
//false
is_class_func= (x) => x;
type_czech._isAClass(is_class_func);
//false
class SomeKlass{ constructor() {} }
type_czech._isAClass(SomeKlass);
//true
class First{ constructor() {} }
class Second extends First{ constructor() { super(...args) } }
type_czech._isAClass(Second);
//true
type_czech._isAClass([]);
//false
type_czech._isAClass({});
//false
type_czech._isAClass('a-string');
//false
type_czech._isAClass(77);
//false
type_czech._isAClass(123n);
//false
*/
      function _isAClass(a_var) {
        consolelog("^^^ _isAClass ENTER", a_var, TYPE_CZECH_current_test_number);
        let is_class = false;
        if (a_var !== null && typeof a_var !== "undefined") {
          const vars_prototype = Object.getPrototypeOf(a_var);
          const type_prototype = typeof vars_prototype;
          if (type_prototype === "function") {
            const a_var_prototype_type = typeof a_var.prototype;
            if (a_var_prototype_type === "object") {
              const class_name = _className(a_var);
              if (class_name) {
                is_class = true;
              }
            }
          }
        }
        consolelog("^^^ _isAClass EXIT", is_class);
        return is_class;
      }

      /*
type_czech._functionName(x=>x);
//""
type_czech._functionName(function aFunction(){});
//aFunction
*/
      function _functionName(a_var) {
        consolelog("^^^ _functionName ENTER", a_var, TYPE_CZECH_current_test_number);
        let function_name = "";
        const function_string = a_var.toString();
        if (function_string.startsWith("function ")) {
          function_name = a_var.name;
        }
        consolelog("^^^ _functionName EXIT", function_name);
        return function_name;
      }

      /*
type_czech._isBuiltInClass(85n);
//false
type_czech._isBuiltInClass('BigInt');
//true
type_czech._isBuiltInClass('bigint');
//false
type_czech._isBuiltInClass('Object');
//true
type_czech._isBuiltInClass('Array');
//true
type_czech._isBuiltInClass('Yojimbo');
//false
type_czech._isBuiltInClass([]);
//false
*/
      function _isBuiltInClass(a_type) {
        consolelog("^^^ _isBuiltInClass ENTER", a_type, TYPE_CZECH_current_test_number);
        let is_built_in = false;
        if (typeof a_type === "string") {
          if (CONSTRUCTOR_PROTOTYPES.includes(a_type)) {
            is_built_in = true;
          }
        }
        consolelog("^^^ _isBuiltInClass EXIT", is_built_in);
        return is_built_in;
      }

      /*
type_czech._anObjectsType('a-string');
//string
type_czech._anObjectsType(x=>x);
//false
type_czech._anObjectsType({});
//object
type_czech._anObjectsType(function aFunction(){});
//false
class First{ constructor() {} }
type_czech._anObjectsType(First);
//false
class First{ constructor() {} }
var a_first = new First()
type_czech._anObjectsType(a_first);
//First
class TheFirst{ constructor() {} }
class TheSecond extends TheFirst{ constructor() { super() } }
var a_second = new TheSecond()
type_czech._anObjectsType(a_second);
//TheSecond
*/
      function _anObjectsType(a_var) {
        consolelog("^^^ _anObjectsType ENTER", a_var, TYPE_CZECH_current_test_number);
        let is_a_class_type = false;
        if (a_var !== null && typeof a_var !== "undefined") {
          const vars_prototype = Object.getPrototypeOf(a_var);
          const type_prototype = typeof vars_prototype;
          if (type_prototype === "object") {
            const variable_constructor = a_var.constructor;
            const class_name = _className(variable_constructor);
            if (class_name) {
              is_a_class_type = class_name;
            } else {
              const function_name = _functionName(variable_constructor);
              is_a_class_type = function_name;
            }
          }
        }
        if (_isBuiltInClass(is_a_class_type)) {
          is_a_class_type = is_a_class_type.toLowerCase();
        }
        consolelog("^^^ _anObjectsType EXIT", is_a_class_type);
        return is_a_class_type;
      }

      /*
type_czech._isaTypeOf('Number');
//false
type_czech._isaTypeOf('number');
//true
type_czech._isaTypeOf('object');
//true
*/
      function _isaTypeOf(lower_case_type_of) {
        consolelog("^^^ _isaTypeOf ENTER", lower_case_type_of, TYPE_CZECH_current_test_number);
        let is_type_of = false;
        if (typeof lower_case_type_of === "string") {
          if (SCALAR_TYPE_OFS.includes(lower_case_type_of)) {
            is_type_of = true;
          }
        }
        consolelog("^^^ _isaTypeOf EXIT", is_type_of);
        return is_type_of;
      }

      /*
type_czech.typeProtos(null);
//["null"]
type_czech.typeProtos(123);
//["Number"]
type_czech.typeProtos(new Date('1999-12-31'));
//["Date"]
type_czech.typeProtos(document.createElement('div'));
//[ "HTMLDivElement", "HTMLElement", "Element", "Node", "EventTarget", "object" ]
type_czech.typeProtos(new Object());
//[ "Object" ]
{ class First { constructor() { } }
  class Last extends First { constructor() { super() } }
  type_czech.typeProtos(new Last()); }
//[ "Last", "First", "Object" ]
*/
      function typeProtos(a_var) {
        consolelog("^^^ typeProtos ENTER", a_var, TYPE_CZECH_current_test_number);
        let the_prototypes = false;
        if (a_var !== null && typeof a_var !== "undefined") {
          const proto_sequence = [];

          // eslint-disable-next-line no-inner-declarations
          function nextPrototype(an_object) {
            const current_proto = Object.getPrototypeOf(an_object);
            if (current_proto !== null) {
              const proto_type = current_proto.constructor.name;
              proto_sequence.push(proto_type);
              nextPrototype(current_proto); // recursive
            }
          }

          const first_proto = Object.getPrototypeOf(a_var);
          const first_type = first_proto.constructor.name;
          if (first_type !== "object" && CONSTRUCTOR_PROTOTYPES.includes(first_type)) {
            the_prototypes = [first_type];
          } else {
            nextPrototype(a_var);
            the_prototypes = proto_sequence;
          }
        } else if (a_var === null) {
          the_prototypes = [NULL_AS_STR];
        } else {
          the_prototypes = [UNDEFINED_AS_STR];
        }
        consolelog("^^^ typeProtos EXIT", the_prototypes);
        return the_prototypes;
      }

      function isNode() {
        let is_node = false;
        if (typeof process === "object") {
          if (typeof process.versions === "object") {
            if (typeof process.versions.node !== "undefined") {
              is_node = true;
            }
          }
        }
        return is_node;
      }

      function isBrowser() {
        return !isNode();
      }

      /*
      NB, used to make plain objects without any prototypes from objects like a Mongoose result.
      { 
        class First { constructor() { } }
        const a_first = new First()
        const class_type = type_czech.typeFinal(a_first);
        console.log('Final type of "class_type" is First===', class_type)
      
        const de_classify = type_czech.deClassify(a_first);
        const no_class_type = type_czech.typeFinal(de_classify);
        console.log('Final type of "no_class_type" is Object===', no_class_type)
       }

       */
      function deClassify(classified_object) {
        if (typeof classified_object !== "object") {
          return classified_object;
        }
        if (classified_object && classified_object.constructor === RegExp) {
          return classified_object;
        }
        if (classified_object instanceof Date) {
          return classified_object;
        }
        let classless_object;
        if (Array.isArray(classified_object)) {
          classless_object = [];
          for (let array_index = 0; array_index < classified_object.length; array_index++) {
            const class_value = classified_object[array_index];
            classless_object[array_index] = deClassify(class_value);
          }
        } else {
          classless_object = classified_object;
          if (typeFinal(classified_object) !== "object") {
            const string_class = JSON.stringify(classified_object);
            classless_object = JSON.parse(string_class);
          }
        }
        return classless_object;
      }

      /*
type_czech.typeFinal(1999);
//number
type_czech.typeFinal(new Date('1999-12-31'));
//date
type_czech.typeFinal(document.createElement('div'));
//HTMLDivElement
{ class First { constructor() { } }
  class Last extends First { constructor() { super() } }
  type_czech.typeFinal(new Last()); 
}
//Last
*/
      function typeFinal(a_var) {
        consolelog("^^^ typeFinal ENTER", a_var, TYPE_CZECH_current_test_number);
        // eslint-disable-next-line no-unused-vars
        const the_prototypes = typeProtos(a_var);
        let child_type = false;
        if (the_prototypes) {
          child_type = the_prototypes.shift();
          if (_isBuiltInClass(child_type)) {
            child_type = child_type.toLowerCase();
          }
        }
        if (!child_type) {
          if (typeof a_var === "undefined") {
            child_type = UNDEFINED_AS_STR;
          } else {
            child_type = NULL_AS_STR;
          }
        }
        consolelog("^^^ typeFinal EXIT", child_type);
        return child_type;
      }

      /*
type_czech.typeIsA(null, 'null');
//true
type_czech.typeIsA(undefined, 'undefined');
//true
type_czech.typeIsA(undefined, 'undefined');
//true
type_czech.typeIsA(NaN, 'number');
//true
type_czech.typeIsA(12, 'number');
//true
type_czech.typeIsA(11, 'Number');
//true
type_czech.typeIsA(11, 'NUMBER');
//false
type_czech.typeIsA(new Promise(x=>x), 'Promise');
//true
type_czech.typeIsA(new Promise(x=>x), 'promise');
//false
type_czech.typeIsA([], 'array');
//true
type_czech.typeIsA([], 'Array');
//true
type_czech.typeIsA([], 'ARRAY');
//false
type_czech.typeIsA({}, 'object');
//true
type_czech.typeIsA({}, 'Object');
//true
type_czech.typeIsA(null, 'object');
//false
type_czech.typeIsA(null, 'Object');
//false
type_czech.typeIsA(document.createElement('div'), "HTMLDivElement");
//true
type_czech.typeIsA(document.createElement('div'), "EventTarget");
//true
*/
      function typeIsA(a_var, object_type) {
        consolelog("^^^ typeIsA ENTER", a_var, object_type, TYPE_CZECH_current_test_number);
        // eslint-disable-next-line no-unused-vars
        const the_prototypes = typeProtos(a_var);
        let object_is_a = false;
        if (the_prototypes) {
          if (_isaTypeOf(object_type)) {
            // eslint-disable-next-line no-param-reassign
            object_type = TYPE_OF_TO_PROTO[object_type];
          }
          object_is_a = the_prototypes.includes(object_type);
        }
        consolelog("^^^ typeIsA EXIT", object_is_a);
        return object_is_a;
      }

      /*
type_czech._aTypeOf(new Date('1999-12-31'));
//date
type_czech._aTypeOf(x=>x);
//function
type_czech._aTypeOf([]);
//array
type_czech._aTypeOf({});
//object
type_czech._aTypeOf(59n);
//bigint
type_czech._aTypeOf(NaN);
//number
type_czech._aTypeOf(Infinity);
//number
type_czech._aTypeOf(/d/);
//regexp
type_czech._aTypeOf(null);
//null
type_czech._aTypeOf(document.createElement('div'));
//"HTMLDivElement"
*/
      function _aTypeOf(a_variable) {
        consolelog("^^^ _aTypeOf ENTER", a_variable, TYPE_CZECH_current_test_number);
        let a_type_of = "";
        const is_html_var = typeFinal(a_variable);
        if (is_html_var) {
          a_type_of = is_html_var;
        } else if (a_variable === null) {
          a_type_of = "null";
        } else if (a_variable instanceof Date) {
          a_type_of = "date";
        } else if (a_variable instanceof RegExp) {
          a_type_of = "regexp";
        } else if (Array.isArray(a_variable)) {
          a_type_of = "array";
        } else {
          a_type_of = typeof a_variable;
        }
        consolelog("^^^ _aTypeOf EXIT", a_type_of);
        return a_type_of;
      }

      /*
type_czech._isPlainJsType("boolean");
//true
type_czech._isPlainJsType("Boolean");
//false
type_czech._isPlainJsType("Snuffleupagus");
//false
type_czech._isPlainJsType('bigint');
//true
type_czech._isPlainJsType('BigInt');
//false
type_czech._isPlainJsType('array');
//true
type_czech._isPlainJsType('object');
//true
type_czech._isPlainJsType([]);
//false
type_czech._isPlainJsType({});
//false
type_czech._isPlainJsType(document.createElement('div'));
//false
*/
      function _isPlainJsType(a_type) {
        consolelog("^^^ _isPlainJsType ENTER", a_type, TYPE_CZECH_current_test_number);
        let is_plain_js_type = false;
        if (TYPE_SET_SCALAR.has(a_type)) {
          is_plain_js_type = true; // date, string..... not null, not undef
        }
        consolelog("^^^ _isPlainJsType EXIT", is_plain_js_type);
        return is_plain_js_type;
      }

      /*
type_czech._shortToLongEmpty("OK");
//EMPTY-OK
type_czech._shortToLongEmpty("EMPTY-ER");
//EMPTY-ER
type_czech._shortToLongEmpty("x-ray-delta");
//x-ray-delta
*/
      function _shortToLongEmpty(an_empty) {
        if (SHORT_EMPTIES[an_empty]) {
          return SHORT_EMPTIES[an_empty];
        }
        return an_empty;
      }

      /*
type_czech._collectionToStr({a_key: 'a-string'});
//{a_key:\"a-string\"}
type_czech._collectionToStr([199n]);
//[199n]
its_complicated = [ {arr_1:[      {k_2:[3n,   {k_4:['number']}   ] }
                                , {k_5:[6n,   {k_7:['number']}  ] }] },
                    [ ['string', 'array'], { k_8: 9n, k_10 :{k_11:2n, K_12:'object'}}]    ]
type_czech._collectionToStr(its_complicated);
//[{arr_1:[{k_2:[3n,{k_4:[\"number\"]}]},{k_5:[6n,{k_7:[\"number\"]}]}]},[[\"string\",\"array\"],{k_8:9n,k_10:{k_11:2n,K_12:\"object\"}}]]
type_czech._collectionToStr([1,2,3]);
//[1,2,3]
type_czech._collectionToStr({ 'a"a': 1});
//{'a\"a':1}
type_czech._collectionToStr({ "b b": 2});
//{\"b b\":1}
type_czech._collectionToStr({ "3c": 3});
//{\"3c\":3}
type_czech._collectionToStr({ 4: 4});
//{4:4}
type_czech._collectionToStr({ e: 5});
//{e:5}
type_czech._collectionToStr({ "f'f": 1});
//{"f'f":1}
*/
      function _collectionToStr(a_collection, collection_newline = "") {
        consolelog("^^^ _collectionToStr ENTER", a_collection, collection_newline, TYPE_CZECH_current_test_number);
        let collection_str;
        const collection_elems = [];
        if (Array.isArray(a_collection)) {
          // array to string
          a_collection.forEach((an_element) => {
            const array_json = _toStr(an_element, collection_newline);
            if (_aTypeOf(an_element) === "string") {
              if (array_json === BLANK_STR_S_QUOTE) {
                collection_elems.push(BLANK_STR_D_QUOTE);
              } else {
                collection_elems.push(`"${array_json}"`);
              }
            } else {
              collection_elems.push(array_json);
            }
          });
          collection_str = `[${collection_elems.join()}]`;
        } else {
          // eslint-disable-next-line no-restricted-syntax
          for (const [key, value] of Object.entries(a_collection)) {
            // an object to string
            let out_key;
            if (key.match(/[^a-z\d_]/gi)) {
              // key has annoying chars
              if (key.match(/"/g)) {
                out_key = `'${key}'`; // has double quote
              } else {
                out_key = `"${key}"`; // no double quote
              }
            } else if (key.match(/^\d+[a-z_]/i)) {
              out_key = `"${key}"`; // starts with a digit - https://mothereff.in/js-properties
            } else {
              out_key = key;
            }
            const value_json = _toStr(value, collection_newline); // now for value
            let object_as_str;
            if (_aTypeOf(value) === "string") {
              if (value_json === BLANK_STR_S_QUOTE) {
                object_as_str = `${out_key}:""`;
              } else {
                object_as_str = `${out_key}:"${value_json}"`;
              }
            } else {
              object_as_str = `${out_key}:${value_json}`;
            }
            collection_elems.push(object_as_str);
          }
          collection_str = `{${collection_elems.join()}}`;
        }
        consolelog("^^^ _collectionToStr EXIT", collection_str);
        return collection_str;
      }

      /*
type_czech._consoleError("errorText", 'TheTAG');
//TheTAG - errorText
*/
      function _consoleError(error_text, error_tag) {
        if (OP_DEBUG_ERROR_TAGS && error_tag) {
          const debug_error = `${error_tag} - ${error_text}`;
          if (OP_DEBUG_CONSOLE_TRACE) {
            _coloredConsole(debug_error, ERROR_COLORS);
          }
          return debug_error;
        }
        return error_text;
      }

      /*
type_czech._looksLikeType("ARRAY");
//TE@205 - Type 'ARRAY' is not a typeof(), but looks like 'array'
type_czech._looksLikeType("Object");
//TE@205 - Type 'Object' is not a typeof(), but looks like 'object'
type_czech._looksLikeType("date");
//''
*/
      function _looksLikeType(possible_badcase) {
        consolelog("^^^ _looksLikeType ENTER", possible_badcase, TYPE_CZECH_current_test_number);
        let error_string = "";
        const is_type_of = _isaTypeOf(possible_badcase);
        if (!is_type_of) {
          if (typeof possible_badcase === "string") {
            const pos_lower_type = possible_badcase.toLowerCase(); // 'Number' should be 'number'
            if (TYPE_OF_TO_PROTO[pos_lower_type]) {
              const error_205 = `Type '${possible_badcase}' is not a typeof(), but looks like '${pos_lower_type}'`;
              error_string = _consoleError(error_205, "TE@205");
            }
          }
        }
        consolelog("^^^ _looksLikeType EXIT", error_string);
        return error_string;
      }

      /*
type_czech._missingKey({z:"symbol"});
//TE@216 -  Key 'z', which has a type of 'symbol', is missing in the checked object
*/
      function _missingKey(extra_keys) {
        consolelog("^^^ _missingKey ENTER", extra_keys, TYPE_CZECH_current_test_number);
        let missing_key;
        if (Object.keys(extra_keys).length > 0) {
          const [share_key, share_type] = Object.entries(extra_keys)[0];
          missing_key = _looksLikeType(share_type);
          if (!missing_key) {
            const share_type_str = _toStr(share_type);
            const error_216 = ` Key '${share_key}', which has a type of '${share_type_str}', is missing in the checked object`;
            missing_key = _consoleError(error_216, "TE@216");
          }
        } else {
          missing_key = "";
        }
        consolelog("^^^ _missingKey EXIT", missing_key);
        return missing_key;
      }

      /*
type_czech._isEmpty(new Date(''));
//true
type_czech._isEmpty('');
//true
type_czech._isEmpty(' ');
//false
type_czech._isEmpty(0);
//false
type_czech._isEmpty(NaN);
//true
type_czech._isEmpty(Infinity);
//true
type_czech._isEmpty(null);
//true
type_czech._isEmpty(undefined);
//true
type_czech._isEmpty([]);
//true
type_czech._isEmpty([7]);
//false
type_czech._isEmpty({});
//true
type_czech._isEmpty({seven:11});
//false
type_czech._isEmpty(85n);
//false
*/
      function _isEmpty(a_variable) {
        consolelog("^^^ _isEmpty ENTER", a_variable, TYPE_CZECH_current_test_number);
        let is_empty;
        if (a_variable instanceof Date) {
          // eslint-disable-next-line eqeqeq
          is_empty = a_variable == "Invalid Date"; // [], {}, NaN, Infinity, '', new Date(''), EMPTY_REGEXP, null, undefined
        } else if (a_variable instanceof RegExp) {
          const regExp_str = a_variable.toString();
          is_empty = regExp_str === EMPTY_REGEXP;
        } else if (Number.isNaN(a_variable)) {
          is_empty = true; // NaN is an empty number, 0 is NOT-EMPTY!
        } else if (typeof a_variable === "number" && !Number.isFinite(a_variable)) {
          is_empty = true; // Infinity is empty
        } else if (a_variable == null) {
          is_empty = true;
        } else {
          const empty_str_array = a_variable.length === 0;
          const empty_object = typeof a_variable === "object" && Object.keys(a_variable).length === 0;
          is_empty = empty_str_array || empty_object;
        }
        consolelog("^^^ _isEmpty EXIT", is_empty);
        return is_empty;
      }

      /*
type_czech._canBeEmpty('array')
//true
type_czech._canBeEmpty('object')
//true
type_czech._canBeEmpty('string')
//true
type_czech._canBeEmpty(/ab+c/i)
//false
type_czech._canBeEmpty(85n)
//false
type_czech._canBeEmpty('boolean')
//false
*/
      const _canBeEmpty = (variable_type) =>
        variable_type === "array"
          ? true // [] -- string types checked, not values
          : variable_type === "object"
          ? true // {}
          : variable_type === "string"
          ? true // ''
          : variable_type === "regexp"
          ? true // new RegExp()
          : variable_type === "date"
          ? true // new Date("")
          : variable_type === "number"; // NaN or Infinity

      /*
type_czech._typeFromArray(['jj'], 99);
//jj
type_czech._typeFromArray([1,'uu'], 1);
//uu
type_czech._typeFromArray([0, 0, 2222], 2);
//2222
*/
      function _typeFromArray(shallow_array, element_index) {
        consolelog("^^^ _typeFromArray ENTER", shallow_array, element_index, TYPE_CZECH_current_test_number);
        const shape_length = shallow_array.length;
        let element_type;
        if (shape_length === 1) {
          [element_type] = shallow_array;
        } else {
          element_type = shallow_array[element_index];
        }
        consolelog("^^^ _typeFromArray EXIT", element_type);
        return element_type;
      }

      /*
type_czech._getParameters(null);
//[null, false, true]
type_czech._getParameters(undefined);
//[undefined, false, true]
type_czech._getParameters('a-string');
//["a-string", false, true]
type_czech._getParameters(x=>y);
//[ (x), false, true ]
type_czech._getParameters({0:'a', 1:'b', length:2});
//[ ["a","b"], false, false]
type_czech._getParameters([1]);
//[ 1, false, true]
type_czech._getParameters([1,2,3,4]);
//[ [1,2,3,4], false, false]
type_czech._getParameters();
//[undefined, false, true]
type_czech._getParameters({0:'zero', length:1});
//["zero", false, true]
type_czech._getParameters({length:0});
//[ [], true, true]
*/
      function _getParameters(parameters_obj) {
        // this does both PRE_check() and POST_check()s
        consolelog("^^^ _getParameters ENTER", parameters_obj, TYPE_CZECH_current_test_number);
        let the_params;
        const odd_parameters =
          parameters_obj === null ||
          parameters_obj === undefined ||
          typeof parameters_obj.length === "undefined" ||
          typeof parameters_obj === "string" ||
          typeof parameters_obj === "function";
        let no_parameters = false;
        let one_param = true;
        if (odd_parameters) {
          the_params = parameters_obj;
        } else if (parameters_obj.length === 0) {
          if (!Array.isArray(parameters_obj)) {
            no_parameters = true;
            // this is most likely an incoming PRE parameter check
          } else {
            // this is an outgoing post result check
          }
          the_params = [];
        } else if (parameters_obj.length === 1) {
          if (!Array.isArray(parameters_obj)) {
            // eslint-disable-next-line prefer-destructuring
            the_params = parameters_obj[0];
            // this is most likely an incoming PRE parameter check
          } else {
            the_params = parameters_obj;
            // this is an outgoing post result check
          }
        } else {
          the_params = Array.from(parameters_obj); // a function with more than 1 arg
          consolelog("not 1 the_params", the_params, the_params.length);
          consolelog("not 1 parameters_obj", parameters_obj);
          if (the_params.length !== 1) {
            one_param = false;
          }
        }
        const params_flags = [the_params, no_parameters, one_param];
        consolelog("^^^ _getParameters EXIT", params_flags);
        return params_flags;
      }

      /*
variable={bob:17, show:_=>_};
interface={bob:'number', show:'function'};
type_czech.check_interface(variable, interface);
//''

variable={bob:['number'], show:_=>_};
interface={bob:'number', show:'function'};
type_czech.check_interface(variable, interface);
//Actual type of 'bob' is 'array', with a value of '[\"number\"]', not the expected 'number' type

variable={bob:{}, show:_=>_};
interface={bob:'object', show:'function'};
type_czech.check_interface(variable, interface);
//Try checkParam_type('{bob:{},show:_=>_ ~~~function~~~}', '{bob:\"object\",show:\"function\"}') for nested objects

variable={bob:{}, show:_=>_};
interface={bob:{}, show:'function'};
type_czech.check_interface(variable, interface);
//Try checkParam_type('{bob:{},show:_=>_ ~~~function~~~}', '{bob:{},show:\"function\"}') for nested objects

variable={bob:[], show:_=>_};
interface={bob:'array', show:'function'};
type_czech.check_interface(variable, interface);
//''

variable={bob:[], show:_=>_};
interface={bob:[], show:'function'};
type_czech.check_interface(variable, interface);
//Actual type of 'bob' is 'array', with a value of '[]', not the expected '[]' type

variable={bob:{a:12}, show:_=>_};
interface={bob:'object', show:'function'};
type_czech.check_interface(variable, interface);
//Try checkParam_type('{bob:{a:12},show:_=>_ ~~~function~~~}', '{bob:\"object\",show:\"function\"}') for nested objects

variable={ Matryoshka: {Russia:  'doll'} };
interface={ Matryoshka: {Russia:'string'} };
type_czech.check_interface(variable, interface);
//Try checkParam_type('{Matryoshka:{Russia:\"doll\"}}', '{Matryoshka:{Russia:\"string\"}}') as has nested objects

variable={ Matryoshka: {Russia:  'doll'} };
interface={ Matryoshka: {Russia:'string'} };
type_czech.checkParam_type(variable, interface);
//''
*/
      // eslint-disable-next-line consistent-return
      function check_interface(introspect_object, expected_interface) {
        // Not like Java methods only, can be anything
        if (t_param_check_func.p_call_traps) {
          consolelog("^^^ check_interface ENTER", introspect_object, expected_interface, TYPE_CZECH_current_test_number);
          // eslint-disable-next-line no-unused-vars
          const [interface_object, _no_parameters, _one_param] = _getParameters(introspect_object);
          consolelog("^^^ _objectEntries interface_object", interface_object);
          const signature_type = _aTypeOf(expected_interface);
          let error_mess = "";
          const is_not_object = !typeIsA(interface_object, "Object");
          if (is_not_object) {
            error_mess = _consoleError("Function argument is not an object.", "IE@505");
          } else if (signature_type !== "object") {
            error_mess = _consoleError("Signature is not an object.", "IE@504");
          } else if (Object.keys(expected_interface).length === 0) {
            error_mess = _consoleError("Signature is empty object.", "IE@503");
          } else {
            const intro_object_str = _toStr(introspect_object);
            const interface_str = _toStr(expected_interface);
            // eslint-disable-next-line guard-for-in, no-restricted-syntax
            for (const test_key in expected_interface) {
              if (!error_mess) {
                const expected_type = expected_interface[test_key];
                const introspect_value = interface_object[test_key];
                const introspect_type = _aTypeOf(introspect_value);
                if (typeof introspect_value === "undefined") {
                  const error_501 = `Interface, ${interface_str}, has extra key '${test_key}' that is in not in checked object of ${intro_object_str}`;
                  error_mess = _consoleError(error_501, "IE@501");
                } else if (introspect_type === "object") {
                  const error_506 = `Try checkParam_type('${intro_object_str}', '${interface_str}') for nested objects`;
                  error_mess = _consoleError(error_506, "IE@506");
                } else if (expected_type !== introspect_type) {
                  const str_intro_value = _toStr(introspect_value);
                  const str_expt_type = _toStr(expected_type);
                  const error_502 =
                    `Actual type of '${test_key}' is '${introspect_type}', with a value ` + `of '${str_intro_value}', not the expected '${str_expt_type}' type`;
                  error_mess = _consoleError(error_502, "IE@502");
                }
              }
            }
          }
          consolelog("^^^ check_interface EXIT", error_mess);
          last_shape_method = [expected_interface, MESS_OBJ_INTERFACE];
          return error_mess;
        }
      }

      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

      /*
type_czech._ParametersCheck(false);
//check_assert_: function check_assert_(error_mess, err_call, actual_value, expected_outcome))
//confirmParameters: function realConfirmParams(target_proxy, pre_checks, post_checks)
//countFails_: function countFails_()
//countTally_: function countTally_()
//countZero_: function countZero_()
//disableTests_: function disableTests_()
//enableTests_: function enableTests_()
//newCheck: function newCheck()
//newFail: function newFail()
//p_call_traps: true

type_czech._ParametersCheck(type_czech.TYPE_CZECH_EVENTS);
//check_assert_: function check_assert_(error_mess, where_from, actual_value, expected_outcome)
//confirmParameters: function realConfirmParams(target_proxy, pre_checks, post_checks)
//countFails_: function countFails_()
//countTally_: function countTally_()
//countZero_: function countZero_()
//disableTests_: function disableTests_()
//enableTests_: function enableTests_()
//newCheck: function newCheck()
//newFail: function newFail()
//p_call_traps: true
*/
      function _ParametersCheck(arg_check_events) {
        consolelog("^^^ _ParametersCheck ENTER", arg_check_events, TYPE_CZECH_current_test_number);
        const num_parameters = arguments.length;
        if (num_parameters > 1) {
          const error_407 = `_ParametersCheck() needs 0 or 1 params, not ${num_parameters}`;
          const internal_error_407 = _consoleError(error_407, "ME@407");
          throw internal_error_407;
        }
        let onParamCheck = () => ""; // console.log('default onParamCheck');
        let onParamError = () => ""; // console.log('default onParamError');

        // start _ParametersCheck variables
        let p_check_count = 0; //     count number of parameter checks
        let p_failure_count = 0; //   count errors so far
        let p_call_traps = false; //  turn parameter checking on/off
        // end _ParametersCheck variables

        function init_ParametersCheck() {
          if (t_do_param_checking) {
            if (arg_check_events && _aTypeOf(arg_check_events) !== "object") {
              const events_sentence = "_ParametersCheck - arg_check_events is not an Object" + " with onStart(), onCheck(), onError() ";
              _coloredConsole([events_sentence, arg_check_events], ERROR_COLORS);
            }
            if (!OP_HIDE_INIT_MESSAGE) {
              const throw_except = OP_THROW_EXCEPTIONS ? OPT_THROW_EXCEPTIONS : "";
              const log_errors = OP_LOG_ERRORS ? OPT_LOG_ERRORS : "";
              const no_error_mess = OP_NO_ERROR_MESSAGES ? OPT_LOG_ERRORS : "";
              const undef_ok = OP_UNDEF_OK ? "UNDEF-OK" : "";
              const console_count = OP_CONSOLE_COUNT ? "CONSOLE-COUNT" : "";
              const EVENTS = arg_check_events;
              const options_array = [IS_INIT_CONSOLE, VERS_NUM, throw_except, log_errors, no_error_mess, undef_ok, console_count, EVENTS];
              _coloredConsole(options_array, START_COLORS);
            }
            if (arg_check_events.onStart !== undefined) {
              arg_check_events.onStart("Start");
            }
            if (arg_check_events.onCheck !== undefined) {
              onParamCheck = arg_check_events.onCheck;
            }
            if (arg_check_events.onError !== undefined) {
              onParamError = arg_check_events.onError;
            }
            p_call_traps = true; // default parameter checking is on
          }
        }

        function getCheckFailureCount() {
          return `${p_check_count} : ${p_failure_count}`;
        }

        function getHtmlTypes(list_of_parameters) {
          consolelog("^^^ getHtmlTypes ENTER", list_of_parameters); // check for DOM types
          const real_types = [];
          if (Array.isArray(list_of_parameters)) {
            list_of_parameters.forEach((a_variable) => {
              const is_html_type = typeFinal(a_variable);
              if (is_html_type) {
                real_types.push(`'${is_html_type}'`);
              } else {
                const json_form = _jsonStr(a_variable);
                real_types.push(json_form);
              }
            });
          }
          consolelog("^^^ getHtmlTypes EXIT", real_types);
          return real_types;
        }

        function actualExpectedText(list_of_parameters, num_params, expected_shape) {
          consolelog("^^^ actualExpectedText ENTER", list_of_parameters, num_params, expected_shape);
          let param_values;
          let arg_list;
          let new_expected;
          if (list_of_parameters.length < num_params) {
            consolelog("^^^ actualExpectedText vars short", list_of_parameters.length, num_params);
            arg_list = getHtmlTypes(list_of_parameters);
            if (arg_list.length > 1) {
              arg_list = `[${arg_list}]`;
            }
            const param_with_brackets = _toStr(list_of_parameters);
            param_values = param_with_brackets.substring(1, param_with_brackets.length - 1);
            new_expected = expected_shape;
          } else if (list_of_parameters.length > num_params) {
            consolelog("^^^ actualExpectedText vars more", list_of_parameters.length, num_params);
            arg_list = getHtmlTypes(list_of_parameters);
            const param_with_brackets = _toStr(list_of_parameters);
            param_values = param_with_brackets.substring(1, param_with_brackets.length - 1);
            new_expected = expected_shape;
          } else {
            consolelog("^^^ actualExpectedText vars same", list_of_parameters.length, num_params);
            arg_list = getHtmlTypes(list_of_parameters);
            if (arg_list.length > 1) {
              arg_list = `[${arg_list}]`;
              param_values = _toStr(list_of_parameters);
            } else {
              const param_with_brackets = _toStr(list_of_parameters);
              param_values = param_with_brackets.substring(1, param_with_brackets.length - 1);
            }
            new_expected = expected_shape;
          }
          consolelog("^^^ actualExpectedText EXIT", arg_list, param_values, new_expected);
          return [arg_list, param_values, new_expected];
        }

        function reviveUndefNullNanInfin(shape_str) {
          //  https://www.npmjs.com/package/replaceall
          function replaceall(replaceThis, withThis, inThis) {
            withThis = withThis.replace(/\$/g, "$$$$");
            return inThis.replace(new RegExp(replaceThis.replace(/([\/\,\!\\\^\$\{\}\[\]\(\)\.\*\+\?\|<>\-\&])/g, "\\$&"), "g"), withThis);
          }

          const shape_str_1 = replaceall(PLAIN_UNDEFINED_STR_VALUE, UNDEFINED_AS_STR, shape_str);
          const shape_str_2 = replaceall(PLAIN_NULL_STR_VALUE, NULL_AS_STR, shape_str_1);
          const shape_str_3 = replaceall(PLAIN_NAN_STR_VALUE, NAN_AS_STR, shape_str_2);
          const shape_str_4 = replaceall(PLAIN_INFINITY_STR_VALUE, INFINITY_AS_STR, shape_str_3);
          return shape_str_4;
        }

        // The error message generator
        function actualVsExpected(
          list_of_parameters,
          exception_str,
          type_of_error,
          func_name_params,
          num_params,
          checking_name,
          check_signature,
          check_caller
        ) {
          consolelog("^^^ actualVsExpected list_of_parameters", list_of_parameters);
          consolelog("^^^ actualVsExpected exception_str", exception_str);
          consolelog("^^^ actualVsExpected any_errors", type_of_error);
          consolelog("^^^ actualVsExpected func_name_params", func_name_params);
          consolelog("^^^ actualVsExpected num_params", num_params);
          consolelog("^^^ actualVsExpected checking_name", checking_name);
          const shape_check = check_caller;
          const check_sig_str = _jsonStr(check_signature);
          const [arg_list, param_values, new_expected] = actualExpectedText(list_of_parameters, num_params, check_sig_str);
          const new_expected_str = reviveUndefNullNanInfin(new_expected);
          consolelog("^^^ actualVsExpected new_expected", new_expected, new_expected_str);
          let new_exception = exception_str + type_of_error;
          new_exception += `${CZECH_ERROR_INDENT}         CHECKER ${shape_check}`;
          const actual_types = "     ACTUAL TYPE";
          const actual_text = "          VALUES";
          let expected_text = " EMPTY ASSERTION";
          if (
            shape_check === MESS_TYPE_VERIFY ||
            shape_check === MESS_TYPE_VARIADIC ||
            shape_check === MESS_TYPE_EXTRAS ||
            shape_check === MESS_OBJ_INTERFACE ||
            shape_check === MESS_TYPE_ONE_OF
          ) {
            expected_text = "   EXPECTED TYPE";
          } else if (shape_check === MESS_MUTATED) {
            expected_text = "MUTATED VARIABLE";
          } else if (shape_check === MESS_CHECK_ASSERT) {
            expected_text = "        EXPECTED";
          }
          new_exception += `${CZECH_ERROR_INDENT}${actual_types} ${arg_list}`;
          new_exception += `${CZECH_ERROR_INDENT}${actual_text} ${param_values}`;
          if (new_expected_str !== BLANK_STR_S_QUOTE) {
            new_exception += `${CZECH_ERROR_INDENT}${expected_text} ${new_expected_str}`;
          }
          if (func_name_params === MESS_CHECK_ASSERT) {
            // eslint-disable-next-line no-param-reassign
            func_name_params = "";
          }
          new_exception += `${CZECH_ERROR_INDENT}          ORIGIN ${checking_name}${func_name_params}`;
          new_exception += CZECH_ERROR_INDENT;
          consolelog("^^^ actualVsExpected EXIT", new_exception);
          return new_exception;
        }

        function newFail() {
          consolelog("^^^ newFail ENTER ", p_failure_count);
          p_failure_count += 1;
          consolelog("^^^ newFail EXIT ", p_failure_count);
        }

        function newCheck() {
          consolelog("^^^ newCheck ENTER ", p_check_count);
          p_check_count += 1;
          consolelog("^^^ newCheck EXIT ", p_check_count);
        }

        function outputCheck(current_errors, target_name, pre_or_post, list_of_parameters, func_name_params, num_params, checking_name) {
          consolelog("^^^ outputCheck ENTER A", current_errors, checking_name, target_name, list_of_parameters);
          consolelog("^^^ outputCheck ENTER B", func_name_params, num_params, TYPE_CZECH_current_test_number);
          newCheck();
          if (OP_CONSOLE_COUNT) {
            _coloredConsole([p_check_count, checking_name], TRACE_COLORS);
          }
          consolelog("^^^ outputCheck current_errors", current_errors);
          consolelog("^^^ outputCheck checking_name", checking_name);
          consolelog("^^^ outputCheck target_name", target_name);
          consolelog("^^^ outputCheck pre_or_post", pre_or_post);

          consolelog("^^^ outputCheck list_of_parameters", list_of_parameters);
          consolelog("^^^ outputCheck func_name_params", func_name_params);
          consolelog("^^^ outputCheck num_params", num_params);
          let any_errors = current_errors;
          const [check_signature, check_caller] = last_shape_method;
          last_shape_method = ["", ""];
          const param_count_must_match_signature =
            check_caller === MESS_TYPE_VERIFY || check_caller === MESS_EMPTY_VERIFY || check_caller === MESS_TYPE_ONE_OF || check_caller === MESS_EMPTY_ONE_OF;
          if (param_count_must_match_signature) {
            if (!current_errors && num_params !== list_of_parameters.length) {
              any_errors = `${num_params} Parameter element count !== check signature element ${list_of_parameters} count ${list_of_parameters.length}`;
            }
          }

          const is_promise = any_errors instanceof Promise;
          if (!is_promise && any_errors) {
            p_failure_count += 1;
            onParamError(getCheckFailureCount());
            let exception_str;
            if (func_name_params === MESS_CHECK_ASSERT) {
              exception_str = "";
            } else {
              exception_str = ` ${checking_name}() ${pre_or_post} `;
            }
            exception_str = actualVsExpected(
              list_of_parameters,
              exception_str,
              any_errors,
              func_name_params,
              num_params,
              target_name,
              check_signature,
              check_caller
            );
            if (OP_THROW_EXCEPTIONS) {
              throw new Error(exception_str);
            } else if (OP_LOG_ERRORS) {
              // eslint-disable-next-line no-console
              console.log(exception_str);
            } else {
              // OP_NO_ERROR_MESSAGES to stop error spamming of console during testing, keep showing exceptions
            }
          }
        }

        function argumentsParamWarn(check_function) {
          consolelog("^^^ argumentsParamWarn ENTER", check_function, TYPE_CZECH_current_test_number);
          const func_str = check_function.toString();
          const func_parts = func_str.match(PARAMS_OF_FUNCTION);
          const func_name_params = `${func_parts[0]})`;
          const funct_params = func_name_params.replace(/^function [^(]*/, "");
          const param_names = func_parts[2];
          const param_array = param_names.split(","); // NB^2 was ", " but when rolled-up, no space !
          if (param_array.includes("arguments")) {
            const arguments_error = `Param 'arguments' shadows arguments object : ${func_parts[0]})`;
            _coloredConsole(arguments_error, TRACE_COLORS);
          }
          consolelog("^^^ argumentsParamWarn EXIT", funct_params, param_array.length);
          return [funct_params, param_array.length];
        }

        // Closures and functions have no this
        function applyNoThis(target_name, pre_or_post, list_of_parameters, the_check) {
          consolelog("^^^ applyNoThis ENTER", target_name, list_of_parameters, the_check, TYPE_CZECH_current_test_number);
          const [funct_params, num_params] = argumentsParamWarn(the_check);
          // eslint-disable-next-line prefer-spread
          const the_errors = the_check.apply(null, list_of_parameters);
          outputCheck(the_errors, target_name, pre_or_post, list_of_parameters, funct_params, num_params, the_check.name);
        }

        // Only classes and prototypes have a this
        function applyWithThis(target_name, pre_or_post, this_arg, list_of_parameters, the_check) {
          consolelog("^^^ applyWithThis ENTER", target_name, this_arg, list_of_parameters, the_check, TYPE_CZECH_current_test_number);
          const [funct_params, num_params] = argumentsParamWarn(the_check);
          const the_errors = the_check.apply(this_arg, list_of_parameters);
          outputCheck(the_errors, target_name, pre_or_post, list_of_parameters, funct_params, num_params, the_check.name);
        }

        function countTally_() {
          return p_check_count;
        }

        function countFails_() {
          return p_failure_count;
        }

        function countZero_() {
          p_check_count = 0;
          p_failure_count = 0;
        }

        function enableTests_() {
          p_call_traps = true;
          t_do_param_checking = true;
          p_check_count = 0;
          p_failure_count = 0;
        }

        function disableTests_() {
          p_call_traps = false;
          t_do_param_checking = false;
        }

        /*
check_error=type_czech.checkParam_typeEither(false,['number','string'])
error_location = 'thirdParty call'
actual_value = false
type_czech.check_assert(check_error, error_location, actual_value, 'not-used')
//         MESSAGE The value 'false', which is a 'boolean', is not a 'number', The value 'false', which is a 'boolean', is not a 'string'
//         CHECKER check_assert()
//     ACTUAL TYPE 'boolean'
//          VALUES false
//        EXPECTED not-used
//          ORIGIN thirdParty call

test_1999 = new Date('1999-12-12')
test_1999.setFullYear(2000);
test_year = test_1999.getFullYear()
if (type_czech.isActive()) {
  if (test_year !== 1999) {
    check_error = `TEST ERROR A-17, year was not 1999 but incorrectly ${test_year}`
    error_location = 'TESTING test_1999.getFullYear()'
    expected_outcome = 'Year should have been 1999'
    type_czech.check_assert(check_error, error_location, test_year, expected_outcome)
  }
}
//MESSAGE TEST ERROR A-17, year was not 1999 but incorrectly 2000
//         CHECKER check_assert()
//     ACTUAL TYPE 'number'
//          VALUES 2000
//        EXPECTED Year should have been 1999
//          ORIGIN TESTING test_1999.getFullYear()

test_1999 = new Date('1999-12-12')
test_1999.setFullYear(2000);
test_year = test_1999.getFullYear()
if (type_czech.isActive()) {
  if (test_year !== 1999) {
    check_error = `TEST ERROR A-17, year was not 1999 but incorrectly ${test_year}`
    error_location = 'TESTING test_1999.getFullYear()'
    type_czech.check_assert(check_error, error_location, test_year)
  }
}
//         MESSAGE TEST ERROR A-17, year was not 1999 but incorrectly 2000
//         CHECKER check_assert()
//     ACTUAL TYPE 'number'
//          VALUES 2000
//          ORIGIN TESTING test_1999.getFullYear()

error_mess= "a-clarifying-error-message"
err_call =  "myBadFunction()"
actual_value = {"the-causal":"error-value"}
expected_outcome = "expected-world-peace"
type_czech.check_assert(error_mess, err_call, actual_value, expected_outcome)
//         MESSAGE a-clarifying-error-message
//         CHECKER check_assert()
//     ACTUAL TYPE 'object'
//          VALUES {"the-causal":"error-value"}
//        EXPECTED expected-world-peace
//          ORIGIN myBadFunction()
*/
        // This flows into the TypeCzech error messages without being linkUp(), for promises
        function check_assert_(error_mess, err_call, actual_value, expected_outcome) {
          if (t_param_check_func.p_call_traps) {
            consolelog("~~~regex~~~ check_assert_ 1", error_mess);
            consolelog("~~~regex~~~ check_assert_ 2", err_call);
            consolelog("~~~regex~~~ check_assert_ 3", actual_value);
            consolelog("~~~regex~~~ check_assert_ 4", expected_outcome);
            consolelog("^^^ check_assert_ ENTER", error_mess, err_call, actual_value, expected_outcome);
            let expected_outcome_str = "";
            if (typeof expected_outcome !== "undefined") {
              expected_outcome_str = _toStr(expected_outcome);
            }
            let new_message_error = _toStr(error_mess);
            new_message_error = `\n                         MESSAGE ${error_mess} `;
            const list_of_parameters = [actual_value];
            consolelog("^^^ check_assert_ 1", new_message_error);
            consolelog("^^^ check_assert_ 2", "_");
            consolelog("^^^ check_assert_ 3", err_call);
            consolelog("^^^ check_assert_ 4", list_of_parameters);
            consolelog("^^^ check_assert_ 5", [actual_value]);
            last_shape_method = [expected_outcome_str, MESS_CHECK_ASSERT];
            outputCheck(new_message_error, err_call, list_of_parameters, [actual_value], MESS_CHECK_ASSERT, 0, "");
          }
        }

        function checkFuncAsStr(the_check) {
          consolelog("^^^ checkFuncAsStr ENTER", the_check, TYPE_CZECH_current_test_number);
          let check_as_str;
          if (typeof the_check === "object") {
            const func_name = (x) => `${x}()`;
            const func_list = (accum, cur) => `${accum}, ${cur}`;
            const object_methods = Object.keys(the_check).map(func_name).reduce(func_list);
            check_as_str = `{ ${object_methods} }`;
          } else {
            check_as_str = `${the_check.name}()`;
          }
          consolelog("^^^ checkFuncAsStr EXIT", check_as_str);
          return check_as_str;
        }

        function funcObjChecksOnly(the_check, whence_error, error_id) {
          if (typeof the_check !== "function" && typeof the_check !== "object") {
            const check_str = _toStr(the_check);
            const error_101_or_115 = `${whence_error}, is a not a function or an object that has a value of '${check_str}'`;
            const exception_101_or_115 = _consoleError(error_101_or_115, error_id);
            throw exception_101_or_115;
          }
        }

        function proxyUsed(target_proxy, the_check) {
          consolelog("^^^ proxyUsed ENTER", target_proxy, the_check, TYPE_CZECH_current_test_number);
          const check_as_str = checkFuncAsStr(the_check);
          if (target_proxy === undefined) {
            const error_102 = `Function to be checked by ${check_as_str} is 'undefined', maybe namespace issue`;
            const exception_102 = _consoleError(error_102, "EX@102");
            throw exception_102;
          }
          if (target_proxy === the_check) {
            const error_103 = `_ParametersCheck you cannot use ${target_proxy.name}() to test` + `${the_check.name}(), they must be different`;
            const exception_103 = _consoleError(error_103, "EX@103");
            throw exception_103;
          }
          consolelog("^^^ proxyUsed EXIT");
        }

        function proxyApprove(target_proxy, pre_check, post_check) {
          consolelog("^^^ proxyApprove ENTER", target_proxy, pre_check, post_check, TYPE_CZECH_current_test_number);
          if (t_proxy_targets.has(target_proxy)) {
            const error_104 = `${target_proxy.name}() is already proxied with ${target_proxy.name}`;
            const exception_104 = _consoleError(error_104, "EX@104");
            throw exception_104;
          }
          if (typeof target_proxy !== "function") {
            const target_str = _toStr(target_proxy);
            const error_105 = `1st param to linkUp(), target_proxy is not a function, but is instead ${target_str}`;
            const exception_105 = _consoleError(error_105, "EX@105");
            throw exception_105;
          }
          if (pre_check) {
            // eslint-disable-next-line guard-for-in, no-restricted-syntax
            for (const pre_key in pre_check) {
              const a_pre_check = pre_check[pre_key];
              proxyUsed(target_proxy, a_pre_check);
              funcObjChecksOnly(a_pre_check, "linkUp() 2nd param, PRE-CHECK()", "EX@101");
            }
          }
          if (post_check) {
            // eslint-disable-next-line guard-for-in, no-restricted-syntax
            for (const post_key in post_check) {
              const a_post_check = post_check[post_key];
              proxyUsed(target_proxy, a_post_check);
              funcObjChecksOnly(a_post_check, "linkUp() 3rd param, POST-CHECK()", "EX@115");
            }
          }
          consolelog("^^^ proxyApprove EXIT");
        }

        function proxyFunction(target_proxy, pre_check, post_check) {
          consolelog("^^^ proxyFunction ENTER", target_proxy, pre_check, post_check, TYPE_CZECH_current_test_number);
          const function_name = target_proxy.name;
          const proxy_handler = {
            apply(target_function, this_arg, parameter_list) {
              onParamCheck(getCheckFailureCount());
              if (p_call_traps && pre_check) {
                if (typeof this_arg === "undefined") {
                  applyNoThis(function_name, PRE_FUNCTION_NO_THIS, parameter_list, pre_check);
                } else {
                  applyWithThis(function_name, PRE_FUNCTION_WITH_THIS, this_arg, parameter_list, pre_check);
                }
              }
              const function_result = target_function.apply(this_arg, parameter_list);
              if (p_call_traps && post_check) {
                if (typeof this_arg === "undefined") {
                  applyNoThis(function_name, POST_FUNCTION_NO_THIS, [function_result], post_check);
                } else {
                  applyWithThis(function_name, POST_FUNCTION_WITH_THIS, this_arg, [function_result], post_check);
                }
              }
              return function_result;
            },
          };
          consolelog("^^^ proxyFunction EXIT", proxy_handler);
          return new Proxy(target_proxy, proxy_handler);
        }

        // This is where a bunch of methods gets all linked up
        function proxyMethods(class_name, class_object, pre_checks, post_checks) {
          consolelog("^^^ proxyMethods ENTER", class_name, class_object, pre_checks, post_checks, TYPE_CZECH_current_test_number);
          const proxied_methods = new Set();
          if (pre_checks) {
            Object.keys(pre_checks).forEach((pre_method) => proxied_methods.add(pre_method));
          }
          if (post_checks) {
            Object.keys(post_checks).forEach((post_method) => proxied_methods.add(post_method));
          }
          let was_frozen = false;
          if (Object.isFrozen(class_object)) {
            was_frozen = true;
            // eslint-disable-next-line no-param-reassign, prefer-object-spread
            class_object = Object.assign({}, class_object);
          }
          proxied_methods.forEach((method_name) => {
            if (method_name !== class_name) {
              let pre_check = false;
              if (pre_checks) {
                pre_check = pre_checks[method_name] || false;
              }
              let post_check = false;
              if (post_checks) {
                post_check = post_checks[method_name] || false;
              }
              if (class_object[method_name]) {
                // eslint-disable-next-line no-param-reassign
                class_object[method_name] = proxyFunction(class_object[method_name], pre_check, post_check);
              }
            }
          });
          if (was_frozen) {
            Object.freeze(class_object);
          }
          consolelog("^^^ proxyMethods EXIT", class_object);
          return class_object;
        }

        function getPrePostCheck(pre_post_checks, class_name) {
          consolelog("^^^ getPrePostCheck ENTER", pre_post_checks, class_name, TYPE_CZECH_current_test_number);
          let the_check;
          if (typeof pre_post_checks === "function") {
            the_check = pre_post_checks;
          } else if (typeof pre_post_checks === "undefined") {
            the_check = false; // NB, no checks from an empty undefined PRE_check()
          } else {
            the_check = pre_post_checks[class_name];
          }
          consolelog("^^^ getPrePostCheck EXIT", the_check);
          return the_check;
        }

        function proxyClass(class_proxy, pre_checks, post_checks) {
          consolelog("^^^ proxyClass ENTER", class_proxy, pre_checks, post_checks, TYPE_CZECH_current_test_number);
          const class_name = class_proxy.name;
          const class_pre = getPrePostCheck(pre_checks, class_name);
          const class_post = getPrePostCheck(post_checks, class_name);
          const proxy_handler = {
            apply() {}, // NB, class will not use apply
            construct(Target_class, parameter_list, new_target) {
              let class_object;
              onParamCheck(getCheckFailureCount());
              if (p_call_traps && class_pre) {
                applyNoThis(class_name, PRE_CONST_CLASS_NO_THIS, parameter_list, class_pre);
              }
              class_object = Reflect.construct(Target_class, parameter_list, new_target);
              class_object = proxyMethods(class_name, class_object, pre_checks, post_checks);
              if (p_call_traps && class_post) {
                applyWithThis(class_name, POST_CONST_CLASS_WITH_THIS, class_object, [class_object], class_post);
              }
              return class_object;
            },
          };
          const new_proxy = new Proxy(class_proxy, proxy_handler);
          consolelog("^^^ proxyClass EXIT", new_proxy);
          return new_proxy;
        }

        function proxyObject(target_proxy, pre_checks, post_checks) {
          consolelog("^^^ proxyObject ENTER", target_proxy, pre_checks, post_checks, TYPE_CZECH_current_test_number);
          const object_name = target_proxy.name;
          const object_pre = getPrePostCheck(pre_checks, object_name);
          const object_post = getPrePostCheck(post_checks, object_name);
          const proxy_handler = {
            apply(target_closure, this_arg, parameter_list) {
              onParamCheck(getCheckFailureCount());
              if (p_call_traps && object_pre) {
                applyNoThis(object_name, PRE_OBJECT_NO_THIS, parameter_list, object_pre);
              }
              let closure_object = target_closure.apply(this_arg, parameter_list);
              closure_object = proxyMethods(object_name, closure_object, pre_checks, post_checks);
              if (p_call_traps && object_post) {
                applyNoThis(object_name, PRE_OBJECT_WITH_THIS, [closure_object], post_checks[object_name]);
              }
              return closure_object;
            },
            construct(Target_class, parameter_list) {
              onParamCheck(getCheckFailureCount());
              if (p_call_traps && object_pre) {
                applyNoThis(object_name, POST_CONST_OBJECT_NO_THIS, parameter_list, object_pre);
              }
              let class_object = new Target_class(...parameter_list);
              class_object = proxyMethods(object_name, class_object, pre_checks, post_checks);
              if (p_call_traps && object_post) {
                applyWithThis(object_name, POST_CONST_OBJECT_WITH_THIS, class_object, [class_object], object_post);
              }
              return class_object;
            },
          };
          consolelog("^^^ proxyObject proxy_handler", proxy_handler);
          const new_proxy = new Proxy(target_proxy, proxy_handler);
          consolelog("^^^ proxyObject EXIT", new_proxy);
          return new_proxy;
        }

        function realConfirmParams(target_proxy, pre_checks, post_checks) {
          consolelog("^^^ realConfirmParams ENTER", target_proxy, pre_checks, post_checks, TYPE_CZECH_current_test_number);
          const num_params = arguments.length;
          if (num_params !== 2 && num_params !== 3) {
            const error_106 = `linkUp() needs 2 or 3 params, not ${num_params}`;
            const exception_106 = _consoleError(error_106, "EX@106");
            throw exception_106;
          }
          proxyApprove(target_proxy, pre_checks, post_checks);
          let proxied_thing;
          const is_class = _isAClass(target_proxy);
          if (is_class) {
            proxied_thing = proxyClass(target_proxy, pre_checks, post_checks);
          } else {
            const pre_checkParam_type = _aTypeOf(pre_checks);
            const post_checkParam_type = _aTypeOf(post_checks);
            if (pre_checkParam_type === "object" || post_checkParam_type === "object") {
              proxied_thing = proxyObject(target_proxy, pre_checks, post_checks);
            } else {
              proxied_thing = proxyFunction(target_proxy, pre_checks, post_checks);
            }
          }
          t_proxy_targets.add(proxied_thing);
          consolelog("^^^ realConfirmParams EXIT", proxied_thing);
          return proxied_thing;
        }

        // eslint-disable-next-line no-unused-vars
        const nopCheck = (function_to_check, _pre_check, _post_check) => function_to_check;

        const confirmParameters = t_do_param_checking ? realConfirmParams : nopCheck;

        init_ParametersCheck();

        const public_methods = {
          check_assert_, // called by check_assert()
          confirmParameters,
          countFails_, // called by countFails()
          countTally_, // called by countTally()
          countZero_, // called by countZero()
          disableTests_, // called by disableTests()
          enableTests_, // called by enableTests()
          newCheck,
          newFail,
          p_call_traps, // call checking functions true or false
        };

        return public_methods;
      } // _ParametersCheck()

      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

      /* eslint-disable */

      /*
      https://github.com/douglascrockford/JSON-js/blob/master/cycle.js
  
      // commit 8e8b0407e475e35942f7e9461dab81929fcc7321
  
  var a = [];
  a[0] = a;
  type_czech._cycle_loops.decycle(a);
  //[{"$ref":"$"}]
  
  type_czech._cycle_loops.decycle({the_window:window});
  //Object { the_window: {…} }
  
  type_czech._cycle_loops.decycle(window);
  ///Object { close: close(), stop: stop(), focus: focus(), blur: blur(), open: open(), alert: alert(), confirm: confirm(), prompt: prompt(), print: print(), postMessage: postMessage(), … }
  
  var a = ['loop', 2n, 3n];
  a[0] = a;
  type_czech._cycle_loops.decycle(a);
  //[{"$ref":"$"}, 2n, 3n]
  
      cycle.js
      2021-05-31
  
      Public Domain.
  
      NO WARRANTY EXPRESSED OR IMPLIED. USE AT YOUR OWN RISK.
  
      This code should be minified before deployment.
      See https://www.crockford.com/jsmin.html
  
      USE YOUR OWN COPY. IT IS EXTREMELY UNWISE TO LOAD CODE FROM SERVERS YOU DO
      NOT CONTROL.
  */

      // The file uses the WeakMap feature of ES6.

      /*jslint eval */

      /*property
          $ref, decycle, forEach, get, indexOf, isArray, keys, length, push,
          retrocycle, set, stringify, test
      */

      const _cycle_loops = {};

      ////////////////////////////////////////////////////////////////////////////////if (typeof JSON.decycle !== "function") {
      _cycle_loops.decycle = function decycle(object, replacer) {
        "use strict";
        // Make a deep copy of an object or array, assuring that there is at most
        // one instance of each object or array in the resulting structure. The
        // duplicate references (which might be forming cycles) are replaced with
        // an object of the form

        //      {"$ref": PATH}

        // where the PATH is a JSONPath string that locates the first occurance.

        // So,

        //      var a = [];
        //      a[0] = a;
        //      return JSON.stringify(_cycle_loops.decycle(a));

        // produces the string '[{"$ref":"$"}]'.

        // If a replacer function is provided, then it will be called for each value.
        // A replacer function receives a value and returns a replacement value.

        // JSONPath is used to locate the unique object. $ indicates the top level of
        // the object or array. [NUMBER] or [STRING] indicates a child element or
        // property.

        var objects = new WeakMap(); // object to path mappings

        return (function derez(value, path) {
          // The derez function recurses through the object, producing the deep copy.

          var old_path; // The path of an earlier occurance of value
          var nu; // The new object or array

          // If a replacer function was provided, then call it to get a replacement value.

          if (replacer !== undefined) {
            value = replacer(value);
          }

          // typeof null === "object", so go on if this value is really an object but not
          // one of the weird builtin objects.

          if (
            typeof value === "object" &&
            value !== null &&
            !(value instanceof Boolean) &&
            !(value instanceof Date) &&
            !(value instanceof Number) &&
            !(value instanceof RegExp) &&
            !(value instanceof String)
          ) {
            // If the value is an object or array, look to see if we have already
            // encountered it. If so, return a {"$ref":PATH} object. This uses an
            // ES6 WeakMap.

            old_path = objects.get(value);
            if (old_path !== undefined) {
              return { $ref: old_path };
            }

            // Otherwise, accumulate the unique value and its path.

            objects.set(value, path);

            // If it is an array, replicate the array.

            if (Array.isArray(value)) {
              nu = [];
              value.forEach(function (element, i) {
                nu[i] = derez(element, path + "[" + i + "]");
              });
            } else {
              // If it is an object, replicate the object.

              nu = {};
              Object.keys(value).forEach(function (name) {
                nu[name] = derez(value[name], path + "[" + JSON.stringify(name) + "]");
              });
            }
            return nu;
          }
          return value;
        })(object, "$");
      };
      ////////////////////////////////////////////////////////////////////////////////}

      //////////////////// Never used so commented out /////////if (typeof JSON.retrocycle !== "function") {
      //   _cycle_loops.retrocycle = function retrocycle($) {
      //       "use strict";

      // // Restore an object that was reduced by decycle. Members whose values are
      // // objects of the form
      // //      {$ref: PATH}
      // // are replaced with references to the value found by the PATH. This will
      // // restore cycles. The object will be mutated.

      // // The eval function is used to locate the values described by a PATH. The
      // // root object is kept in a $ variable. A regular expression is used to
      // // assure that the PATH is extremely well formed. The regexp contains nested
      // // * quantifiers. That has been known to have extremely bad performance
      // // problems on some browsers for very long strings. A PATH is expected to be
      // // reasonably short. A PATH is allowed to belong to a very restricted subset of
      // // Goessner's JSONPath.

      // // So,
      // //      var s = '[{"$ref":"$"}]';
      // //      return _cycle_loops.retrocycle(JSON.parse(s));
      // // produces an array containing a single element which is the array itself.

      //       var px = /^\$(?:\[(?:\d+|"(?:[^\\"\u0000-\u001f]|\\(?:[\\"\/bfnrt]|u[0-9a-zA-Z]{4}))*")\])*$/;

      //       (function rez(value) {

      // // The rez function walks recursively through the object looking for $ref
      // // properties. When it finds one that has a value that is a path, then it
      // // replaces the $ref object with a reference to the value that is found by
      // // the path.

      //           if (value && typeof value === "object") {
      //               if (Array.isArray(value)) {
      //                   value.forEach(function (element, i) {
      //                       if (typeof element === "object" && element !== null) {
      //                           var path = element.$ref;
      //                           if (typeof path === "string" && px.test(path)) {
      //                               value[i] = eval(path);
      //                           } else {
      //                               rez(element);
      //                           }
      //                       }
      //                   });
      //               } else {
      //                   Object.keys(value).forEach(function (name) {
      //                       var item = value[name];
      //                       if (typeof item === "object" && item !== null) {
      //                           var path = item.$ref;
      //                           if (typeof path === "string" && px.test(path)) {
      //                               value[name] = eval(path);
      //                           } else {
      //                               rez(item);
      //                           }
      //                       }
      //                   });
      //               }
      //           }
      //       }($));
      //       return $;
      //   };
      ////////////////////////////////////////////////////////////////////////////////}

      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

      /*
  type_czech._fast_json_stable_stringify({c:2, a:1, b:123n});
  //{'a':1,'b':'123n','c':2}
  
  type_czech._fast_json_stable_stringify({c:Infinity, a:NaN, e: Symbol('Y'), f:undefined, g:null, b:123n});
  //{'a':NaN, 'b':'123n', 'c':Infinity, 'e':Symbol(Y), 'function':undefined, 'g':null} 
  
  a_regex = new RegExp(/\d\d\d\d\d\d\d\d\d\d\d\dabcdefghijklmnopqrstuvwxyz/);
  a_func = function (param_1,param_2,param_3) { return param_1 + param_2 + param_3; };
  type_czech._fast_json_stable_stringify([a_regex, a_func]);
  //[/\\d\\d\\d\\d\\d\\d\\d\\d\\d\\d\\d\\dabcdefghijklmnopqrstuvwxyz/,function (param_1,param_2,param_3) { return param_1 + param_2 + param_3; }]
      
      Used to check for mutation of function parameters in check_buildSnapshot() and check_mutatedSnapshot()
  
      https://github.com/epoberezkin/fast-json-stable-stringify
  
      https://github.com/epoberezkin/fast-json-stable-stringify/blob/master/index.js
  
      This software is released under the MIT license:
  
      @license Copyright (c) 2017 Evgeny Poberezkin
      @license Copyright (c) 2013 James Halliday
  
      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.
  
      */

      // commit 67f688f7441010cfef91a6147280cc501701e83b

      //module.exports = function (data, opts) {

      function _fast_json_stable_stringify(data, opts) {
        if (!opts) opts = {};
        if (typeof opts === "function") opts = { cmp: opts };
        var cycles = typeof opts.cycles === "boolean" ? opts.cycles : false;

        var cmp =
          opts.cmp &&
          (function (f) {
            return function (node) {
              return function (a, b) {
                var aobj = { key: a, value: node[a] };
                var bobj = { key: b, value: node[b] };
                return f(aobj, bobj);
              };
            };
          })(opts.cmp);

        var seen = [];
        return (function stringify(node) {
          if (node && node.toJSON && typeof node.toJSON === "function") {
            node = node.toJSON();
          }

          // start of modifications for check_buildSnapshot() and check_mutatedSnapshot()
          if (Number.isNaN(node)) return "NaN";
          if (typeof node === "number" && !Number.isFinite(node)) return "Infinity";
          if (node === undefined) return "undefined";
          if (typeof node === "bigint") return JSON.stringify(node + "n");
          if (typeof node === "symbol") return node.toString();
          if (typeof node === "function") return String(node);
          if (node && node.constructor === RegExp) return String(node);
          // end of modifications

          //if (node === undefined) return;
          if (typeof node == "number") return isFinite(node) ? "" + node : "null";
          if (typeof node !== "object") return JSON.stringify(node);

          var i, out;
          if (Array.isArray(node)) {
            out = "[";
            for (i = 0; i < node.length; i++) {
              if (i) out += ",";
              out += stringify(node[i]) || "null";
            }
            return out + "]";
          }

          if (node === null) return "null";

          if (seen.indexOf(node) !== -1) {
            if (cycles) return JSON.stringify("__cycle__");
            throw new TypeError("Converting circular structure to JSON");
          }

          var seenIndex = seen.push(node) - 1;
          var keys = Object.keys(node).sort(cmp && cmp(node));
          out = "";
          for (i = 0; i < keys.length; i++) {
            var key = keys[i];
            var value = stringify(node[key]);
            if (!value) continue;
            if (out) out += ",";
            out += JSON.stringify(key) + ":" + value;
          }
          seen.splice(seenIndex, 1);
          return "{" + out + "}";
        })(data);
      }

      /* eslint-enable */
      /* eslint-disable block-scoped-var */

      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

      /*
type_czech._errorClassName(17, 'NUMBER');
//TE@205 - Type 'NUMBER' is not a typeof(), but looks like 'number'
type_czech._errorClassName([], 'array');
//TE@202 - Type 'array' is unknown classname and not a scalar
type_czech._errorClassName({}, 'object');
//TE@202 - Type 'object' is unknown classname and not a scalar
type_czech._errorClassName(UnKnownClass, 'unknownClass');
//Type 'unknownClass' is unknown classname and not a scalar
*/
      function _errorClassName(actual_value, scalar_type) {
        consolelog("^^^ _errorClassName ENTER", actual_value, scalar_type, TYPE_CZECH_current_test_number);
        const no_spaces = scalar_type.replace(/\s+/g, "");
        let error_string = _looksLikeType(no_spaces);
        if (!error_string) {
          if (no_spaces === "[]") {
            const error_222 = "[] is a container, not a type/signature, try 'array' or ['string']";
            error_string = _consoleError(error_222, "TE@222");
          } else if (no_spaces === "{}") {
            const error_223 = "{} is a container, not a type/signature. Try 'object' or {a:'string'}";
            error_string = _consoleError(error_223, "TE@223");
          } else {
            if (scalar_type.endsWith("s")) {
              const non_plural_scalar = scalar_type.substring(0, scalar_type.length - 1);
              if (TYPE_SET_SCALAR.has(non_plural_scalar)) {
                const actual_val_str = _toStr(actual_value);
                const error_227 = `Type '${scalar_type}' is unknown classname and not a scalar. ` + `Try ['${scalar_type}'] to match ${actual_val_str}`;
                error_string = _consoleError(error_227, "TE@227");
              }
            }
            if (error_string === "") {
              const error_202 = `Type '${scalar_type}' is unknown classname and not a scalar`;
              error_string = _consoleError(error_202, "TE@202");
            }
          }
        }
        consolelog("^^^ _errorClassName EXIT", error_string);
        return error_string;
      }

      /*
type_czech._shapeErrorMess([, , "boolean"], ["super", "man"])
//TE@221 - Element '2' is supposed to be a 'boolean', but is missing : ["super","man"]
*/
      function _shapeErrorMess(shallow_array, check_array) {
        consolelog("^^^ _shapeErrorMess ENTER", shallow_array, check_array, TYPE_CZECH_current_test_number);
        const extra_shapes = Object.entries(shallow_array);
        const [extra_index, extra_type] = extra_shapes[0];
        const check_arr_str = _toStr(check_array);
        const error_221 = `Element '${extra_index}' is supposed to be a '${extra_type}', but is missing : ${check_arr_str}`;
        const error_string = _consoleError(error_221, "TE@221");
        consolelog("^^^ _shapeErrorMess EXIT", error_string);
        return error_string;
      }

      /*
type_czech._shapeContainer([456,789] , ["number"], 'TYPE-EXTRAS', 179);
//""
type_czech._shapeContainer([456,789] , ["is-bad"], 'TYPE-EXTRAS', 179);
//TE@214 -  ELEMENT '0' is assumed to be a 'is-bad', but is mistakenly a 'number' with a value of 456
type_czech._shapeContainer({X:33}, {r:'n'}, 'TYPE-EXTRAS', 179);
//TE@216 -  The key 'r', which has a type of 'n', is missing in the checked object
type_czech._shapeContainer({X:33}, {r:'number'}, 'TYPE-EXTRAS', 179);
//TE@216 -  Key 'r', which has a type of 'number', is missing in the checked object
type_czech._shapeContainer({X:33}, {X:'string'}, 'TYPE-EXTRAS', 179);
//TE@213 - Property 'X' is indicated to be a 'string', but is inaccurately a 'number' : 33
type_czech._shapeContainer({r:11}, ["number"], 'TYPE-VERIFY', 179);
//TE@207 - Param is meant to be 'array' but is of the wrong type of 'object':{"r":11}
type_czech._shapeContainer([456,789] , {X:'string'}, 'TYPE-VERIFY', 179);
//TE@207 - Param is meant to be 'object' but is of the wrong type of 'array':[456,789]
type_czech._shapeContainer([[456,789]] , [["number"]], 'TYPE-EXTRAS', 179);
//""
type_czech._shapeContainer( [456,789] , [["number"]], 'TYPE-EXTRAS', 179);
//''
type_czech._shapeContainer( [456,789] , [["number"], ['string']], 'TYPE-EXTRAS', 179);
//''
type_czech._shapeContainer( [[456,789], ['a','b'], 3] , [["number"], ['string'], "boolean"], 'TYPE-EXTRAS', 179);
//''
type_czech._shapeContainer( {a:1} , [["number"], ['string']], 'TYPE-EXTRAS', 179);
//''
type_czech._shapeContainer( [{a:1}, 'sdf'] , [{a:"number"}, ['string']], 'TYPE-EXTRAS', 179);
//''
type_czech._shapeContainer( [  [1], [2] ] , [["number"], ['number']], 'TYPE-EXTRAS', 179);
//''
type_czech._shapeContainer( [  [[1], [2]], [[1], ['a']] ] , [ [["number"]], [['number']] ], 'TYPE-EXTRAS', 179);
//''
type_czech._shapeContainer( [  [[1, false], [2, false]], [[1, false], [2, false]] ] , [ [["number", "boolean"]], [['number', "boolean"]] ], 'TYPE-EXTRAS', 179);
//''
type_czech._shapeContainer( [  [[1, false], [2, false]], [[1, false], [2, 2]] ] , [ [["number", "boolean"]], [['number', "boolean"]] ], 'TYPE-EXTRAS', 179);
//''
type_czech._shapeContainer({a:[1,2,3]}, {a:'object'}, 'TYPE-EXTRAS', 179);
//TE@207 - Param is meant to be 'object' but is of the wrong type of 'array':[1,2,3]
type_czech._shapeContainer([ 13, 14, 15 ], { r: "number" }, 'TYPE-EXTRAS', 179);
//TE@207 - Param is meant to be 'object' but is of the wrong type of 'array':[13,14,15]
*/
      function _shapeContainer(check_container, container_shape, verify_or_empty) {
        consolelog("^^^ _shapeContainer ENTER", check_container, container_shape, verify_or_empty, TYPE_CZECH_current_test_number);
        let error_string = "";
        const object_type = _aTypeOf(check_container);
        const shape_type = _aTypeOf(container_shape);
        if (container_shape === undefined) {
          error_string = "";
        } else if (object_type !== shape_type) {
          if (object_type === container_shape) {
            // Here is where we run into {} === 'object'
          } else if (verify_or_empty !== TYPE_EXTRAS || shape_type !== "array") {
            const check_str = _jsonStr(check_container);
            let print_type;
            if (_aTypeOf(container_shape) === "string") {
              print_type = container_shape;
            } else {
              print_type = shape_type;
            }
            const error_207 = `Param is meant to be '${print_type}' but is` + ` of the wrong type of '${object_type}':${check_str}`;
            error_string = _consoleError(error_207, "TE@207");
          }
        } else if (shape_type === "array") {
          // eslint-disable-next-line no-use-before-define
          error_string = _shapeArrayTypes(check_container, container_shape, verify_or_empty);
        } else if (shape_type === "object") {
          // eslint-disable-next-line no-use-before-define
          error_string = _shapeCollectionTypes(check_container, container_shape, verify_or_empty);
        }
        consolelog("^^^ _shapeContainer EXIT", error_string);
        return error_string;
      }

      /*
type_czech._arrayOfOneType([1,2,3], 'number', 'TYPE-EXTRAS');
//""
type_czech._arrayOfOneType([1,false,3], 'number', 'TYPE-VERIFY');
//TE@215 - ELEMENT '1' is asserted to be a 'number', but is fallaciously a 'boolean' : false
type_czech._arrayOfOneType(["as",false,3], 'string', 'TYPE-VERIFY');
//TE@215 - ELEMENT '1' is asserted to be a 'string', but is fallaciously a 'boolean' : false
type_czech._arrayOfOneType('an-str', 'number', 'TYPE-EXTRAS');
//"TE@215 - ELEMENT '0' is asserted to be a 'number', but is fallaciously a 'string' : an-str"
*/
      const _arrayOfOneType = (check_array, array_type, verify_or_empty) => {
        consolelog("^^^ _arrayOfOneType ENTER", check_array, array_type, verify_or_empty, TYPE_CZECH_current_test_number);
        let error_string = "";
        if (!Array.isArray(check_array)) {
          // eslint-disable-next-line no-param-reassign
          check_array = [check_array];
        }
        check_array.forEach((check_element, element_index) => {
          if (error_string === "") {
            const variable_type = _aTypeOf(check_element);
            if (_isCollection(array_type)) {
              // eslint-disable-next-line no-use-before-define
              error_string = _shapeVariable(check_element, array_type, verify_or_empty);
            } else if (array_type !== variable_type) {
              if (OP_UNDEF_OK && variable_type === "null") {
                // ingore nulls if OP_UNDEF_OK
              } else if (OP_UNDEF_OK && variable_type === "undefined") {
                // ingore undefined if OP_UNDEF_OK
              } else {
                let error_local = _looksLikeType(array_type);
                if (!error_local) {
                  const show_element = _toStr(check_element);
                  const error_215 =
                    `ELEMENT '${element_index}' is asserted to be a '${array_type}',` + ` but is fallaciously a '${variable_type}' : ${show_element}`;
                  error_local = _consoleError(error_215, "TE@215");
                }
                error_string = error_local;
              }
            }
          }
        });
        consolelog("^^^ _arrayOfOneType EXIT", error_string);
        return error_string;
      };

      /*
type_czech._wrongType('string', 0, 'date');
//TE@214 -  ELEMENT '0' is assumed to be a 'string', but is mistakenly a 'date' with a value of undefined
type_czech._wrongType('Noomber', 0, 'number');
//TE@214 -  ELEMENT '0' is assumed to be a 'Noomber', but is mistakenly a 'number' with a value of undefined
type_czech._wrongType(null, 2, 'number');
//TE@232 -  ELEMENT '2' type is not a valid string, like 'number', but instead null
type_czech._wrongType(undefined, 2, 'number');
//TE@232 -  ELEMENT '2' type is not a valid string, like 'number', but instead undefined
*/
      const _wrongType = (expected_type, element_index, real_type, actual_value) => {
        consolelog("^^^ _wrongType ENTER", expected_type, element_index, real_type, actual_value, TYPE_CZECH_current_test_number);
        let error_string = "";
        const actual_val_str = _toStr(actual_value);
        if (expected_type === "null") {
          const error_204 = ` ELEMENT '${element_index}' type is 'null'`;
          error_string = _consoleError(error_204, "TE@204");
        } else if (expected_type === "undefined") {
          const error_229 = ` ELEMENT '${element_index}' type is 'undefined'`;
          error_string = _consoleError(error_229, "TE@229");
        } else if (typeof expected_type !== "string") {
          const bad_type = _toStr(expected_type);
          const error_232 = ` ELEMENT '${element_index}' type is not a valid string, like 'number', but instead ${bad_type}`;
          error_string = _consoleError(error_232, "TE@232");
        }
        if (!error_string) {
          error_string = _looksLikeType(expected_type);
          if (!error_string) {
            if (real_type === "null" || real_type === "undefined") {
              if (!OP_UNDEF_OK) {
                const error_237 = ` ELEMENT '${element_index}' is assumed to be a '${expected_type}',` + ` but is mistakenly a '${real_type}'`;
                error_string = _consoleError(error_237, "TE@237");
              }
            } else {
              const error_214 =
                ` ELEMENT '${element_index}' is assumed to be a '${expected_type}',` + ` but is mistakenly a '${real_type}' with a value of ${actual_val_str}`;
              error_string = _consoleError(error_214, "TE@214");
            }
          }
        }
        consolelog("^^^ _wrongType EXIT", error_string);
        return error_string;
      };

      /*
type_czech._shapeArrayTypes([ 13, 14, 15 ], ['numbers'], 'TYPE-VERIFY',0);
//""
type_czech._shapeArrayTypes([ 13, 14, 15 ], ['number', 'boolean', 'date'], 'TYPE-EXTRAS');
//TE@214 -  ELEMENT '1' is assumed to be a 'boolean', but is mistakenly a 'number' with a value of 14
type_czech._shapeArrayTypes(["bob", "newheart", 1 , 2], ["string", "string"], 'TYPE-EXTRAS');
//""
type_czech._shapeArrayTypes([], ['number'], 'TYPE-VERIFY');
//TE@238 - Empty array has no types
*/

      function _isPluralType(a_shape) {
        consolelog("^^^ _isPluralType ENTER", a_shape, TYPE_CZECH_current_test_number);
        if (a_shape.endsWith("s")) {
          const type_of_array = a_shape.substring(0, a_shape.length - 1);
          if (SCALAR_TYPE_OFS.includes(type_of_array)) {
            return type_of_array;
          }
        }
        return false;
      }

      function _shapeArrayErrors(check_array, array_shape, verify_or_empty) {
        consolelog("^^^ _shapeArrayErrors ENTER", check_array, array_shape, verify_or_empty, TYPE_CZECH_current_test_number);
        let error_string = "";
        const arr_shape_str = _toStr(array_shape);
        const shape_elems = array_shape.length;
        if (typeof check_array === "undefined" || check_array.length === 0) {
          const error_238 = "Empty array has no types";
          error_string = _consoleError(error_238, "TE@238");
        } else if (verify_or_empty === TYPE_VERIFY && check_array.length > array_shape.length && _isaTypeOf(array_shape[0])) {
          const check_array_str = _toStr(check_array);
          const check_elems = check_array.length;
          const error_239 = `${check_elems} !== ${shape_elems}, array has more elements than types, ${check_array_str} !== ${arr_shape_str}`;
          error_string = _consoleError(error_239, "TE@239");
        } else if (shape_elems > 1) {
          let array_array_count = 0;
          array_shape.forEach((a_shape) => {
            if (a_shape === "arrays") {
              array_array_count += 1;
            }
          });
          if (array_array_count > 1) {
            const error_240 = `arrays must be the single type ['arrays'] not ${arr_shape_str}`;
            error_string = _consoleError(error_240, "TE@240");
          }
        }
        return error_string;
      }

      function _shapeArrayTypes(check_array, array_shape, verify_or_empty) {
        consolelog("^^^ _shapeArrayTypes ENTER", check_array, array_shape, verify_or_empty, TYPE_CZECH_current_test_number);
        let error_string = _shapeArrayErrors(check_array, array_shape, verify_or_empty);
        if (error_string === "") {
          const check_arr_len = check_array.length;
          const arr_shape_len = array_shape.length;
          const shape_copy = Array.from(array_shape);
          array_shape.forEach((a_shape, shape_index) => {
            if (error_string === "") {
              const check_value = _typeFromArray(check_array, shape_index);
              const check_shape = _aTypeOf(check_value);
              if (_isCollection(a_shape)) {
                error_string = _shapeContainer(check_value, a_shape, verify_or_empty);
                const doing_verify = verify_or_empty === TYPE_VERIFY || verify_or_empty === EMPTY_VERIFY;
                if (error_string === "" && check_arr_len !== arr_shape_len && doing_verify) {
                  const check_arr_str = _toStr(check_array);
                  const arr_shape_str = _toStr(array_shape);
                  const error_296 = `Collection sizes do not match ${check_arr_len} !== ${arr_shape_len} with ${check_arr_str} and ${arr_shape_str}`;
                  error_string = _consoleError(error_296, "TE@296");
                }
              } else if (a_shape && typeof a_shape === "string" && a_shape.endsWith("s")) {
                const an_array_type = _isPluralType(a_shape);
                if (an_array_type && shape_copy.length === 1) {
                  const match_real_array = Array(check_arr_len).fill(an_array_type);
                  error_string = _shapeArrayTypes(check_array, match_real_array, verify_or_empty);
                } else if (an_array_type && check_arr_len === arr_shape_len) {
                  const shape_to_array = [array_shape[shape_index]];
                  error_string = _shapeArrayTypes(check_array[shape_index], shape_to_array, verify_or_empty);
                } else if (an_array_type && check_arr_len > arr_shape_len) {
                  error_string = _consoleError("Not enough types to match values", "TE@299");
                } else if (an_array_type && check_arr_len < arr_shape_len) {
                  error_string = _consoleError("Not adequate values to match types", "TE@298");
                } else {
                  const error_297 = `bad - array type, not real - ${a_shape}`;
                  error_string = _consoleError(error_297, "TE@297");
                }
              } else if (check_shape !== a_shape) {
                const actual_value = check_array[shape_index];
                error_string = _wrongType(a_shape, shape_index, check_shape, actual_value);
              }
            }
            delete shape_copy[shape_index];
          });
          if (!error_string) {
            if (arr_shape_len !== 1 && check_arr_len < arr_shape_len) {
              error_string = _shapeErrorMess(array_shape, check_array);
            }
          }
        }
        consolelog("^^^ _shapeArrayTypes EXIT", error_string);
        return error_string;
      }

      /*
type_czech._shapePropertyType({r:"number"}, 'r', 11);
//""
type_czech._shapePropertyType({r:"not-real"}, 'r', 11);
//TE@210 - Type 'not-real' is not a real type
type_czech._shapePropertyType({r:"number"}, 'r', undefined);
//TE@211 - Key 'r' was given to be a 'number' but is 'undefined'
type_czech._shapePropertyType({r:"number"}, 'r', null);
//TE@212 - Key 'r' was determined to be a 'number' but is 'null'
type_czech._shapePropertyType({r:"number"}, 'r', 'a-string');
//TE@213 - Property 'r' is indicated to be a 'number', but is inaccurately a 'string' : a-string
*/
      const _shapePropertyType = (property_type, property_key, check_variable) => {
        consolelog("^^^ _shapePropertyType ENTER", property_type, property_key, check_variable, TYPE_CZECH_current_test_number);
        let error_string = "";
        const checkParam_type_type = property_type[property_key];
        if (!_isPlainJsType(checkParam_type_type)) {
          error_string = _looksLikeType(checkParam_type_type);
          if (!error_string) {
            const object_str = _jsonStr(checkParam_type_type);
            const error_210 = `Type '${object_str}' is not a real type`;
            error_string = _consoleError(error_210, "TE@210");
          }
        } else {
          const variable_type = _aTypeOf(check_variable);
          if (checkParam_type_type !== variable_type) {
            if (OP_UNDEF_OK && variable_type === "null") {
              // ingore nulls if OP_UNDEF_OK
            } else if (OP_UNDEF_OK && variable_type === "undefined") {
              // ingore undefined if OP_UNDEF_OK
            } else if (typeof check_variable === "undefined") {
              const error_211 = `Key '${property_key}' was given to be a '${checkParam_type_type}' but is 'undefined'`;
              error_string = _consoleError(error_211, "TE@211");
            } else if (variable_type === "null") {
              const error_212 = `Key '${property_key}' was determined to be a '${checkParam_type_type}' but is 'null'`;
              error_string = _consoleError(error_212, "TE@212");
            } else {
              const check_str = _toStr(check_variable);
              const error_213 =
                `Property '${property_key}' is indicated to be a '${checkParam_type_type}',` + ` but is inaccurately a '${variable_type}' : ${check_str}`;
              error_string = _consoleError(error_213, "TE@213");
            }
          }
        }
        consolelog("^^^ _shapePropertyType EXIT", error_string);
        return error_string;
      };

      /*
type_czech._shapeCollectionTypes({a:123},  {a:"number"}, 'TYPE-VERIFY');
//""
type_czech._shapeCollectionTypes({a:123, b:789},  {a:"number"}, 'TYPE-VERIFY');
//TE@209 - Extra key in checked object - (b:789)
type_czech._shapeCollectionTypes({a:[123], b:[789]},  {a:["number"]}, 'TYPE-VERIFY');
//""
type_czech._shapeCollectionTypes({a:[123], b:[789]},  {a:["string"]}, 'TYPE-VERIFY');
//TE@214 -  ELEMENT '0' is assumed to be a 'string', but is mistakenly a 'number' with a value of 123
type_czech._shapeCollectionTypes({ X: 33 }, { r: "number" }, 'TYPE-EXTRAS');
//TE@216 -  Key 'r', which has a type of 'number', is missing in the checked object
*/
      function _shapeCollectionTypes(check_object, object_shape, verify_or_empty) {
        consolelog("^^^ _shapeCollectionTypes ENTER", check_object, object_shape, verify_or_empty, TYPE_CZECH_current_test_number);
        let error_string = "";
        const checkParam_type_shallow = { ...object_shape };
        const check_entries = Object.entries(check_object);
        check_entries.forEach((shape_entry) => {
          if (error_string === "") {
            const [check_key, check_var_or_obj] = shape_entry;
            if (_isCollection(check_var_or_obj)) {
              const correct_shape = object_shape[check_key];
              error_string = _shapeContainer(check_object[check_key], correct_shape, verify_or_empty);
              delete checkParam_type_shallow[check_key];
            } else if (Object.prototype.hasOwnProperty.call(checkParam_type_shallow, check_key)) {
              error_string = _shapePropertyType(checkParam_type_shallow, check_key, check_var_or_obj);
              delete checkParam_type_shallow[check_key];
            } else if (verify_or_empty === TYPE_VERIFY) {
              let var_obj_str = _jsonStr(check_var_or_obj);
              if (_aTypeOf(check_var_or_obj) === "string") {
                var_obj_str = `'${var_obj_str}'`;
              }
              const error_209 = `Extra key in checked object - (${check_key}:${var_obj_str})`;
              error_string = _consoleError(error_209, "TE@209");
            }
          }
        });
        if (error_string === "") {
          error_string = _missingKey(checkParam_type_shallow);
        }
        consolelog("^^^ _shapeCollectionTypes EXIT", error_string);
        return error_string;
      }

      /*
type_czech._shapeScalar(17 ,"number");
//""
type_czech._shapeScalar(17 ,"string");
//TE@226 - The value '17', which is a 'number', is not a 'string'
type_czech._shapeScalar({} ,"object");
//""
type_czech._shapeScalar({} ,"capybara");
//TE@202 - Type 'capybara' is wrong classname or not a scalar
type_czech._shapeScalar(undefined, "number");
//TE@206 - The value 'undefined', is not a 'number'
type_czech._shapeScalar(null, "number");
//TE@226 - The value 'null', which is a 'null', is not a 'number'
type_czech._shapeScalar(4, 'null');
//TE@203 - The type 'null' is not a valid checkParam_type(), checkParam_typeEither(), or checkParam_typeExtra() 2nd parameter type
*/
      function _shapeScalar(actual_value, expected_type) {
        consolelog("^^^ _shapeScalar ENTER", actual_value, expected_type, TYPE_CZECH_current_test_number);
        let error_string = "";
        if (expected_type === "null" || expected_type === "undefined") {
          const error_203 =
            `The type '${expected_type}' is not a valid checkParam_type(), ` + "checkParam_typeEither(), or checkParam_typeExtra() 2nd parameter type";
          error_string = _consoleError(error_203, "TE@203");
        } else if (!_isPlainJsType(expected_type)) {
          const actual_type = _anObjectsType(actual_value);
          if (actual_type !== expected_type) {
            if (_aTypeOf(expected_type) === "string") {
              error_string = _errorClassName(actual_value, expected_type);
            } else {
              const incorrect_type = _toStr(expected_type);
              const error_230 = `The type '${incorrect_type}' is invalid`;
              error_string = _consoleError(error_230, "TE@230");
            }
          }
        } else {
          const variable_type = _aTypeOf(actual_value);
          consolelog("^^^ _shapeScalar _aTypeOf", variable_type, TYPE_CZECH_current_test_number);
          if (variable_type === expected_type) {
            error_string = "";
          } else if (variable_type === "array") {
            const error_225 = `The value [], an 'array', is not a '${expected_type}'`;
            error_string = _consoleError(error_225, "TE@225");
          } else if (variable_type === "object") {
            const error_208 = `The value {}, an 'object', is not a '${expected_type}'`;
            error_string = _consoleError(error_208, "TE@208");
          } else if (variable_type === "undefined") {
            const error_206 = `The value 'undefined', is not a '${expected_type}'`;
            error_string = _consoleError(error_206, "TE@206");
          } else {
            const variable_str = _toStr(actual_value);
            const error_226 = `The value '${variable_str}', which is a '${variable_type}', is not a '${expected_type}'`;
            error_string = _consoleError(error_226, "TE@226");
          }
        }
        consolelog("^^^ _shapeScalar EXIT", error_string);
        return error_string;
      }

      /*
type_czech._shapeVariable([456,789] , ["number"], 'TYPE-EXTRAS');
//""
type_czech._shapeVariable([[456,789]] , [["number"]], 'TYPE-EXTRAS');
//""
type_czech._shapeVariable(17 ,"number", 'TYPE-VERIFY');
//""
type_czech._shapeVariable(17 ,"string", 'TYPE-VERIFY');
//TE@226 - The variable '17', which is a 'number', is not a 'string'
type_czech._shapeVariable({a:123, b:456}, {a:"number", b:"string"}, 'TYPE-VERIFY');
//TE@213 - Property 'b' is indicated to be a 'string', but is inaccurately a 'number' : 456
type_czech._shapeVariable(['hello', 'there'] , ["strings"], 'TYPE-VERIFY');
//''
*/
      function _shapeVariable(check_variable, variable_type, verify_or_empty) {
        consolelog("^^^ _shapeVariable ENTER", check_variable, variable_type, verify_or_empty, TYPE_CZECH_current_test_number);
        let error_string;
        if (_isCollection(variable_type)) {
          error_string = _shapeContainer(check_variable, variable_type, verify_or_empty);
        } else {
          error_string = _shapeScalar(check_variable, variable_type);
        }
        consolelog("^^^ _shapeVariable EXIT", error_string);
        return error_string;
      }

      /*
type_czech._emptyErrorMess(['EMPTY-ERROR', 'EMPTY-OK'], ['first', 'middle', 'last']);
//EE@310 - ELEMENT '0' is promised to be a 'EMPTY-ERROR', but is missing : ["first","middle","last"]
*/
      function _emptyErrorMess(shallow_array, check_array) {
        consolelog("^^^ _emptyErrorMess ENTER", shallow_array, check_array, TYPE_CZECH_current_test_number);
        let error_string;
        if (shallow_array.length === 0) {
          const error_316 = "Array with no empty type elems, [], should have at least one, like ['EMPTY-ERROR']";
          error_string = _consoleError(error_316, "EE@316");
        } else {
          const extra_shapes = Object.entries(shallow_array);
          const [extra_index, extra_type] = extra_shapes[0];
          const check_str = _jsonStr(check_array);
          const error_310 = `ELEMENT '${extra_index}' is promised to be a '${extra_type}', but is missing : ${check_str}`;
          error_string = _consoleError(error_310, "EE@310");
        }
        consolelog("^^^ _emptyErrorMess EXIT", error_string);
        return error_string;
      }

      /*
type_czech._emptyError('EMPTY-ERROR', 'a-string', 0, ['a-string', 17], 'string', 'EMPTY-VERIFY');
//""
type_czech._emptyError('EMPTY-ERROR', '', 0, ['', 17], 'string', 'EMPTY-VERIFY');
//EE@311 - ELEMENT '0' is erroneously empty :
type_czech._emptyError('EMPTY-ERROR', false, 0, [false, 17], 'boolean', 'EMPTY-VERIFY');
//''
type_czech._emptyError('bad-EMPTY', 'a-string', 0, ['a-string', 17], 'string', 'EMPTY-VERIFY');
//EE@312 - ELEMENT '0' is incorrect type, 'bad-EMPTY', only [ER,EMPTY-ERROR,EMPTY-OK,OK,EMPTY-IGNORE,IG] allowed : ["a-string",17]
*/
      function _emptyError(empty_type, check_element, element_index, check_array, variable_type, verify_or_empty) {
        consolelog("^^^ _emptyError PART 1 ENTER", empty_type, check_element, element_index);
        consolelog("^^^ _emptyError PART 2 ENTER", check_array, variable_type, verify_or_empty, TYPE_CZECH_current_test_number);
        let error_string;
        const check_str = _jsonStr(check_array);
        if (empty_type === "EMPTY-ERROR" || empty_type === "ER") {
          if (_isEmpty(check_element)) {
            const error_311 = `ELEMENT '${element_index}' is erroneously empty :`;
            error_string = _consoleError(error_311, "EE@311");
          } else {
            error_string = "";
          }
        } else if (empty_type === "EMPTY-OK" || empty_type === "OK" || empty_type === "EMPTY-IGNORE" || empty_type === "IG") {
          // eslint-disable-next-line no-use-before-define
          error_string = _emptyContainer(check_array[element_index], empty_type, verify_or_empty);
        } else if (_aTypeOf(empty_type) === "string") {
          const error_312 =
            `ELEMENT '${element_index}' is incorrect type, '${empty_type}', only` + ` [ER,EMPTY-ERROR,EMPTY-OK,OK,EMPTY-IGNORE,IG] allowed : ${check_str}`;
          error_string = _consoleError(error_312, "EE@312");
        } else {
          // eslint-disable-next-line no-use-before-define
          error_string = _emptyContainer(check_array[element_index], empty_type, verify_or_empty);
        }
        consolelog("^^^ _emptyError EXIT", error_string);
        return error_string;
      }

      /*
type_czech._emptyArrayInArray([[11], [13], [17]], ["ER"], 'EMPTY-VERIFY');
//""
type_czech._emptyArrayInArray([[11], [NaN], [17]], ["ER","ER","ER"], 'EMPTY-VERIFY');
//''
type_czech._emptyArrayInArray([["a-s", "", "c-s"], ["x-s",  "y-s", "z-s"]],   ["ER", "ER", "ER"], 'EMPTY-VERIFY');
//""
type_czech._emptyArrayInArray([["a-s", "", "c-s"], ["x-s",  "y-s", "z-s"]],   [["ER", "ER", "ER"]], 'EMPTY-VERIFY');
//EE@311 - ELEMENT '1' is erroneously empty :
*/
      const _emptyArrayInArray = (check_array, array_type, verify_or_empty) => {
        consolelog("^^^ _emptyArrayInArray ENTER", check_array, array_type, verify_or_empty, TYPE_CZECH_current_test_number);
        let error_string = "";
        const check_array_type = _aTypeOf(check_array);
        if (check_array_type !== "array") {
          const check_str = _toStr(check_array);
          const error_314 = `Variable ${check_str} must be an array but is instead a '${check_array_type}', : ${check_str}`;
          error_string = _consoleError(error_314, "EE@314");
        } else {
          check_array.forEach((element, array_index) => {
            if (error_string === "") {
              // eslint-disable-next-line no-use-before-define
              error_string = _emptyContainer(element, array_type[array_index], verify_or_empty);
            }
          });
        }
        consolelog("^^^ _emptyArrayInArray EXIT", error_string);
        return error_string;
      };

      function emptyArrayElementsError(check_str, array_shape, check_length, shape_length) {
        const shape_str = _jsonStr(array_shape);
        const error_404 =
          `Param array ${check_str} does not have the same number of elems as ${shape_str}. ` + ` Different lengths ${check_length} !== ${shape_length}`;
        const error_string = _consoleError(error_404, "ME@404");
        return error_string;
      }

      function emptyArrayNotArrayError(check_array, check_array_type, check_str) {
        const error_313 = `Variable '${check_array}' must be an array but is a '${check_array_type}', : ${check_str}`;
        const error_string = _consoleError(error_313, "EE@313");
        return error_string;
      }

      /*
type_czech._arrayOfOneShape([1,2,3], 'EMPTY-ERROR', 'EMPTY-EXTRAS');
//""
type_czech._arrayOfOneShape([1, [ 1],3], 'EMPTY-ERROR', 'EMPTY-EXTRAS');
//""
type_czech._arrayOfOneShape([ [1,1], [2,2], [3,3] ], ['EMPTY-ERROR', 'EMPTY-OK'], 'EMPTY-EXTRAS');
//""
type_czech._arrayOfOneShape( [ [1,1], [2,2], ['', 3] ], ['EMPTY-ERROR', 'EMPTY-OK'], 'EMPTY-EXTRAS');
//EE@311 - ELEMENT '0' is erroneously empty :
*/
      const _arrayOfOneShape = (check_array, array_type, verify_or_empty) => {
        consolelog("^^^ _arrayOfOneShape ENTER", check_array, array_type, verify_or_empty, TYPE_CZECH_current_test_number);
        let error_string = "";
        const empty_of_array = _shortToLongEmpty(array_type);
        if (!Array.isArray(check_array)) {
          // eslint-disable-next-line no-param-reassign
          check_array = [check_array];
        }
        check_array.forEach((check_element, element_index) => {
          if (error_string === "") {
            const variable_empty = _isEmpty(check_element);
            if (_isCollection(empty_of_array)) {
              // eslint-disable-next-line no-use-before-define
              error_string = _emptyContainer(check_element, empty_of_array, verify_or_empty);
            } else if (variable_empty && empty_of_array === "EMPTY-ERROR") {
              if (OP_UNDEF_OK && variable_empty === "null") {
                // ingore nulls if OP_UNDEF_OK
              } else if (OP_UNDEF_OK && variable_empty === "undefined") {
                // ingore undefined if OP_UNDEF_OK
              } else {
                const show_element = _toStr(check_element);
                const error_306 = `ELEMENT '${element_index}' is asserted to be a '${empty_of_array}',` + ` but is really 'EMPTY' : ${show_element}`;
                error_string = _consoleError(error_306, "EE@306");
              }
            }
          }
        });
        consolelog("^^^ _arrayOfOneShape EXIT", error_string);
        return error_string;
      };

      function _emptyArrayErrors(check_array, array_shape, verify_or_empty) {
        consolelog("^^^ _emptyArrayErrors ENTER", check_array, array_shape, verify_or_empty, TYPE_CZECH_current_test_number);
        let error_string = "";
        const arr_shape_str = _toStr(array_shape);
        const check_elements = check_array.length;
        const shape_elements = array_shape.length;
        if (typeof check_array === "undefined" || check_elements === 0) {
          const error_321 = "Empty array has no types";
          error_string = _consoleError(error_321, "EE@321");
        } else if (verify_or_empty === EMPTY_VERIFY && check_elements > shape_elements) {
          const error_322 = `Array has more elements than types ${check_elements} !== ${shape_elements}`;
          error_string = _consoleError(error_322, "EE@322");
        } else if (shape_elements > 1) {
          let array_array_count = 0;
          array_shape.forEach((a_shape) => {
            if (a_shape === "arrays") {
              array_array_count += 1;
            }
          });
          if (array_array_count > 1) {
            const error_323 = `arrays must be the single type ['arrays'] not ${arr_shape_str}`;
            error_string = _consoleError(error_323, "EE@323");
          }
        }
        consolelog("^^^ _emptyArrayErrors EXIT", error_string);
        return error_string;
      }

      /*
type_czech._emptyArrayTypes([ 13, 14, 15 ], ['EMPTY-ERROR'], '_emptyArrayTypes');
//''
type_czech._emptyArrayTypes([ [13, [99]], 14, 15 ], ['EMPTY-ERROR'], '_emptyArrayTypes');
//''
type_czech._emptyArrayTypes([17], ['EMPTY-ERROR'], 'EMPTY-VERIFY');
//""
type_czech._emptyArrayTypes(['first', 'middle', ''], ['EMPTY-ERROR', 'EMPTY-OK', 'EMPTY-ERROR'], 'EMPTY-VERIFY');
//"EE@311 - ELEMENT '2' is erroneously empty :"
type_czech._emptyArrayTypes(['first', 'middle', 'last'], ['EMPTY-ERROR', "EMPTY-OK"], 'EMPTY-VERIFY');
//EE@322 - Array has more elements than types 3 !== 2
type_czech._emptyArrayTypes([''], ['EMPTY-OK', 'EMPTY-ERROR'], 'EMPTY-EXTRAS');
//""
type_czech._emptyArrayTypes(['', ''], ['EMPTY-OK', 'EMPTY-ERROR'], 'EMPTY-EXTRAS');
//EE@311 - ELEMENT '1' is erroneously empty :
type_czech._emptyArrayTypes(['an-str', 'an-str'], ['EMPTY-OK', 'EMPTY-ERROR'], 'EMPTY-EXTRAS');
//""
type_czech._emptyArrayTypes([],["EMPTY-ER"],"EMPTY-VERIFY");
//EE@321 - Empty array has no types
*/

      const _emptyArrayTypes = (check_array, array_shape, verify_or_empty) => {
        consolelog("^^^ _emptyArrayTypes ENTER", check_array, array_shape, verify_or_empty, TYPE_CZECH_current_test_number);
        const check_length = check_array.length;
        let error_string = _emptyArrayErrors(check_array, array_shape, verify_or_empty);
        if (error_string === "") {
          const shape_length = array_shape.length;
          const check_str = _jsonStr(check_array);
          if (verify_or_empty !== "EMPTY-EXTRAS" && shape_length > 1 && shape_length !== check_length) {
            error_string = emptyArrayElementsError(check_str, array_shape, check_length, shape_length);
          } else {
            const shallow_array = Array.from(array_shape);
            const shallow_length = shallow_array.length;
            const check_array_type = _aTypeOf(check_array);
            if (check_array_type !== "array") {
              error_string = emptyArrayNotArrayError(check_array, check_array_type, check_str);
            } else {
              check_array.forEach((check_element, element_index) => {
                if (error_string === "") {
                  const var_type = _aTypeOf(check_element);
                  const element_type = _typeFromArray(shallow_array, element_index);
                  if (_isCollection(element_type)) {
                    // eslint-disable-next-line no-use-before-define
                    error_string = _emptyContainer(check_array[element_index], element_type, verify_or_empty);
                  } else if (shallow_length !== 1) {
                    delete shallow_array[element_index];
                  }
                  const empty_err = _emptyError(element_type, check_element, element_index, check_array, var_type, verify_or_empty);
                  if (empty_err) {
                    error_string = empty_err;
                  }
                }
              });
            }
            if (shallow_length !== 1 && verify_or_empty !== EMPTY_EXTRAS && check_array.length !== shallow_length) {
              error_string = _emptyErrorMess(array_shape, check_array);
            }
          }
        }
        consolelog("^^^ _emptyArrayTypes EXIT", error_string);
        return error_string;
      };

      /*
type_czech._emptyKeysChecked('EMPTY-ERROR', 0, 'var-or-key-name');
//''
type_czech._emptyKeysChecked('EMPTY-ERROR', true, 'var-or-key-name');
//EE@302 - Type cannot be empty 'var-or-key-name' EMPTY-ERROR is a true :: boolean
type_czech._emptyKeysChecked('is_-RONG', true, 'var-or-key-name');
//EE@303 - Bad empty type key, 'is_-RONG', must be either 'EMPTY-OK','EMPTY-ER','EMPTY-IG','OK','ER','IG'
type_czech._emptyKeysChecked('EMPTY-ERROR', {}, 'var-or-key-name');
//EE@301 -  key 'var-or-key-name' is a 'object' which is reputed to be 'EMPTY-ERROR' but has a value of {}
*/
      const _emptyKeysChecked = (empty_choice, check_var_or_obj, check_key) => {
        consolelog("^^^ _emptyKeysChecked ENTER", empty_choice, check_var_or_obj, check_key, TYPE_CZECH_current_test_number);
        let error_string = "";
        const long_empty = _shortToLongEmpty(empty_choice);
        if (long_empty === EMPTY_ER) {
          const current_type = _aTypeOf(check_var_or_obj);
          const is_empty_able = _canBeEmpty(current_type);
          const var_str = _jsonStr(check_var_or_obj);
          if (is_empty_able) {
            const is_empty = _isEmpty(check_var_or_obj);
            if (is_empty) {
              const error_301 = ` key '${check_key}' is a '${current_type}' which is reputed ` + `to be '${long_empty}' but has a value of ${var_str}`;
              error_string = _consoleError(error_301, "EE@301");
            }
          } else {
            const error_302 = `Type cannot be empty '${check_key}' ${long_empty} is a ${var_str} :: ${current_type}`;
            error_string = _consoleError(error_302, "EE@302");
          }
        } else if (long_empty !== EMPTY_OK && long_empty !== EMPTY_IG) {
          const error_303 = `Bad empty type key, '${_toStr(long_empty)}', must be either 'EMPTY-OK','EMPTY-ER','EMPTY-IG','OK','ER','IG'`;
          error_string = _consoleError(error_303, "EE@303");
        }
        consolelog("^^^ _emptyKeysChecked EXIT", error_string);
        return error_string;
      };

      /*
type_czech._emptyCollectionTypes({ r: '' }, { r: 'ER' }, 'EMPTY-VERIFY');
//EE@301 -  key 'r' is a 'string' which is reputed to be 'EMPTY-ERROR' but has a value of ''
type_czech._emptyCollectionTypes({ r: 11 }, { r: 'ER' }, 'EMPTY-VERIFY');
//""
type_czech._emptyCollectionTypes([[]], [['ER']], 'EMPTY-VERIFY');
//EE@309 - Key '0' was understood to be 'EMPTY-ERROR' but was rather '[]'
type_czech._emptyCollectionTypes([1,2], ["ER"], 'EMPTY-VERIFY');
//EE@315 - Extra key in checked object - (1:2)
type_czech._emptyCollectionTypes([1,'2'], ["ER"], 'EMPTY-VERIFY');
//EE@315 - Extra key in checked object - (1:'2')
type_czech._emptyCollectionTypes([1,2], ["ER"], 'EMPTY-EXTRAS');
//""
*/
      const _emptyCollectionTypes = (check_object, object_shape, verify_or_empty) => {
        consolelog("^^^ _emptyCollectionTypes ENTER", check_object, object_shape, verify_or_empty, TYPE_CZECH_current_test_number);
        let error_string = "";
        const checkParam_type_shallow = { ...object_shape };
        if (_isCollection(check_object)) {
          const check_entries = Object.entries(check_object);
          check_entries.forEach((empty_entry) => {
            if (error_string === "") {
              const [check_key, check_var_or_obj] = empty_entry;
              let var_obj_str = _jsonStr(check_var_or_obj);
              const empty_choice = _shortToLongEmpty(checkParam_type_shallow[check_key]);
              if (_isCollection(check_var_or_obj)) {
                const correct_empty = object_shape[check_key];
                const long_empty = _shortToLongEmpty(correct_empty);
                if (_isEmpty(check_var_or_obj) && long_empty === "EMPTY-ERROR") {
                  const error_309 = `Key '${check_key}' was understood to be '${long_empty}' but was rather '${var_obj_str}'`;
                  error_string = _consoleError(error_309, "EE@309");
                } else {
                  // eslint-disable-next-line no-use-before-define
                  error_string += _emptyContainer(check_object[check_key], long_empty, verify_or_empty);
                }
                delete checkParam_type_shallow[check_key];
              } else if (Object.prototype.hasOwnProperty.call(checkParam_type_shallow, check_key)) {
                error_string = _emptyKeysChecked(empty_choice, check_var_or_obj, check_key);
                delete checkParam_type_shallow[check_key];
              } else if (verify_or_empty === EMPTY_VERIFY) {
                if (_aTypeOf(check_var_or_obj) === "string") {
                  var_obj_str = `'${var_obj_str}'`;
                }
                const error_315 = `Extra key in checked object - (${check_key}:${var_obj_str})`;
                error_string = _consoleError(error_315, "EE@315");
              }
            }
          });
        }
        if (error_string === "") {
          error_string = _missingKey(checkParam_type_shallow);
        }
        consolelog("^^^ _emptyCollectionTypes EXIT", error_string);
        return error_string;
      };

      /*
type_czech._emptyContainer(["a-string"], ['EMPTY-ERROR'], 'EMPTY-VERIFY');
//""
type_czech._emptyContainer([""], ['EMPTY-ERROR'], 'EMPTY-VERIFY');
//EE@311 - ELEMENT '0' is erroneously empty :
type_czech._emptyContainer({zero:0}, ['EMPTY-ERROR'], 'EMPTY-VERIFY');
//EE@314 - Variable {zero:0} must be an array but is instead a 'object', : {zero:0}
type_czech._emptyContainer([''], ['EMPTY-OK', 'EMPTY-ERROR'], 'EMPTY-EXTRAS');
//''
type_czech.checkParam_empty([''], ['EMPTY-OK', 'EMPTY-ERROR']);
//Param array [\"\"] does not have the same number of elems as [\"EMPTY-OK\",\"EMPTY-ERROR\"].  Different lengths 1 !== 2
*/
      function _emptyContainer(check_container, empty_type, verify_or_empty) {
        consolelog("^^^ _emptyContainer ENTER", check_container, empty_type, verify_or_empty, TYPE_CZECH_current_test_number);
        let error_string;
        const shape_type = _aTypeOf(empty_type);
        if (empty_type === undefined) {
          error_string = "";
        } else if (shape_type === "array") {
          if (_aTypeOf(empty_type[0]) === "array") {
            error_string = _emptyArrayInArray(check_container, empty_type, verify_or_empty);
          } else {
            const checkParam_type_container = _aTypeOf(check_container);
            if (checkParam_type_container === "array") {
              error_string = _emptyArrayTypes(check_container, empty_type, verify_or_empty);
            } else {
              error_string = _emptyArrayInArray(check_container, empty_type, verify_or_empty);
            }
          }
        } else if (shape_type === "object") {
          error_string = _emptyCollectionTypes(check_container, empty_type, verify_or_empty);
        } else {
          // eslint-disable-next-line no-use-before-define
          error_string = _emptyScalar(check_container, empty_type);
        }
        consolelog("^^^ _emptyContainer EXIT", error_string);
        return error_string;
      }

      /*
type_czech._emptyScalar(0, 'EMPTY-ERROR');
//''
type_czech._emptyScalar(true, 'EMPTY-ERROR');
//''
type_czech._emptyScalar(true, 'an-ERROR');
//EE@304 - Must 'EMPTY-OK' or 'EMPTY-ERROR' not 'an-ERROR'
*/
      function _emptyScalar(check_variable, empty_type) {
        consolelog("^^^ _emptyScalar ENTER", check_variable, empty_type, TYPE_CZECH_current_test_number);
        let error_string = "";
        const empty_long = _shortToLongEmpty(empty_type);
        const variable_type = _aTypeOf(check_variable);
        if (empty_long === EMPTY_ER) {
          const current_type = _aTypeOf(check_variable);
          const is_empty_able = _canBeEmpty(current_type);
          if (is_empty_able) {
            const is_empty = _isEmpty(check_variable);
            if (is_empty) {
              if (variable_type === "object") {
                // eslint-disable-next-line no-param-reassign
                check_variable = "{ }";
              }
              const variable_str = _toStr(check_variable);
              const error_307 = `${empty_long} states '${variable_type}' must not ` + `be empty for the value ${variable_str}`;
              error_string = _consoleError(error_307, "EE@307");
            }
          } else if (variable_type === "null" || variable_type === "undefined") {
            const error_308 = `A '${variable_type}' cannot be empty, so the state` + ` of '${empty_long}' is illegal for the value '${check_variable}'`;
            error_string = _consoleError(error_308, "EE@308");
          }
        } else if (empty_long !== EMPTY_OK && empty_long !== EMPTY_IG) {
          const error_304 = `Must 'EMPTY-OK' or 'EMPTY-ERROR' not '${empty_long}'`;
          error_string = _consoleError(error_304, "EE@304");
        }
        consolelog("^^^ _emptyScalar EXIT", error_string);
        return error_string;
      }

      /*
type_czech._emptyVariable(17, 'EMPTY-ERROR', 'EMPTY-VERIFY');
//""
type_czech._emptyVariable(0, 'EMPTY-ERROR', 'EMPTY-VERIFY');
//''
type_czech._emptyVariable(["a-string"], ['EMPTY-ERROR'], 'EMPTY-VERIFY');
//""
type_czech._emptyVariable([""], ['EMPTY-ERROR'], 'EMPTY-VERIFY');
//EE@311 - ELEMENT '0' is erroneously empty :
type_czech._emptyVariable({zero:0}, ['EMPTY-ERROR'], 'EMPTY-VERIFY');
//EE@314 - Variable {zero:0} must be an array but is instead a 'object', : {zero:0}
*/
      function _emptyVariable(check_variable, variable_type, verify_or_empty) {
        consolelog("^^^ _emptyVariable ENTER", check_variable, variable_type, verify_or_empty, TYPE_CZECH_current_test_number);
        let error_string;
        if (_isCollection(variable_type)) {
          error_string = _emptyContainer(check_variable, variable_type, verify_or_empty);
        } else {
          error_string = _emptyScalar(check_variable, variable_type);
        }
        consolelog("^^^ _emptyVariable EXIT", error_string);
        return error_string;
      }

      /*
type_czech._emptyCheck([12, false, 'a string'], ['EMPTY-OK'], 'EMPTY-VERIFY');
//EE@305 - Pointless as ['EMPTY-OK'] matches all
*/
      function _emptyCheck(check_variable, variable_type, verify_or_empty) {
        consolelog("^^^ _emptyCheck ENTER", check_variable, variable_type, verify_or_empty, TYPE_CZECH_current_test_number);
        let error_string;
        if (variable_type.length === 1 && (variable_type[0] === EMPTY_OK || variable_type[0] === "OK")) {
          const error_305 = "Pointless as ['EMPTY-OK'] matches all";
          error_string = _consoleError(error_305, "EE@305");
        } else {
          error_string = _emptyVariable(check_variable, variable_type, verify_or_empty);
        }
        consolelog("^^^ _emptyCheck EXIT", error_string);
        return error_string;
      }

      /*
type_czech._doEitherEmpty([[12, 0, 'not-checked'], [['ER','ER'],['ER','OK']]]);
//Array has more elements than types 3 !== 2
type_czech._doEitherEmpty([['',12], [['ER','ER'],['ER','OK']]]);
//ELEMENT '0' is erroneously empty :
*/

      function _doEitherEmpty(type_parameters) {
        consolelog("^^^ _doEitherEmpty ENTER", type_parameters, TYPE_CZECH_current_test_number);
        const [check_variable, empty_types] = type_parameters;
        let error_string = "";
        let empty_error = "";
        let found_empty = false;
        empty_types.forEach((empty_type) => {
          const possible_error = _emptyCheck(check_variable, empty_type, EMPTY_VERIFY);
          if (possible_error === "") {
            found_empty = true;
            consolelog("^^^ MATCH EitherEmpty", check_variable);
            consolelog("^^^ MATCH EitherEmpty", empty_type);
          } else {
            empty_error = possible_error;
          }
        });
        if (!found_empty) {
          error_string = empty_error;
        }
        consolelog("^^^ _doEitherEmpty EXIT", error_string);
        return error_string;
      }

      /*
type_czech._doEitherShape([  {"X":"an-str","Y":1234},   [{"X":"string","Y":"string"},{"X":"string","Y":"number"}]  ], "TYPE-VERIFY");
//""
type_czech._doEitherShape([  {"X":"an-str","Y":1234},   [{"X":"string","Y":"string"},{"X":"string","Y":"date"}]  ], "TYPE-VERIFY");
//TE@213 - Property 'Y' is indicated to be a 'string', but is inaccurately a 'number' : 1234, TE@213 - Property 'Y' is indicated to be a 'date', but is inaccurately a 'number' : 1234
type_czech._doEitherShape([ ["an-str"],   ["string", "number"]  ], "TYPE-VERIFY");
//The value [], an 'array', is not a 'string', The value [], an 'array', is not a 'number'
type_czech._doEitherShape([ [14],   ["string", "number"]  ], "TYPE-VERIFY");
//The value [], an 'array', is not a 'string', The value [], an 'array', is not a 'number'
type_czech._doEitherShape([ [14],   ["strings", "numbers"]  ], "TYPE-VERIFY");
//Type 'strings' is unknown classname and not a scalar. Try ['strings'] to match [14], Type 'numbers' is unknown classname and not a scalar. Try ['numbers'] to match [14]
*/
      function _doEitherShape(type_parameters) {
        consolelog("^^^ _doEitherShape ENTER", type_parameters, TYPE_CZECH_current_test_number);
        const [check_variable, var_types_shapes] = type_parameters;
        const shape_errors = [];
        let error_string;
        let found_shape = false;
        var_types_shapes.forEach((var_type) => {
          consolelog("^^^ MATCH check_variable", check_variable);
          consolelog("^^^ MATCH var_type", var_type);
          const possible_error = _shapeVariable(check_variable, var_type, TYPE_VERIFY);
          if (possible_error === "") {
            found_shape = true;
            consolelog("^^^ MATCH EitherShape", check_variable);
            consolelog("^^^ MATCH EitherShape", var_type);
          } else {
            shape_errors.push(possible_error);
          }
        });
        if (found_shape) {
          error_string = "";
        } else {
          const first_error = shape_errors.shift();
          const last_error = shape_errors.pop();
          if (shape_errors.length === 0) {
            error_string = `${first_error}, ${last_error}`;
          } else if (shape_errors.length === 1) {
            error_string = `${first_error}, ${last_error}, plus 1 more Either error`;
          } else {
            error_string = `${first_error}, ${last_error}, plus ${shape_errors.length} more Either errors`;
          }
        }
        consolelog("^^^ _doEitherShape EXIT", error_string);
        return error_string;
      }

      /*
type_czech._specParameters(["UNDEF-OK", "DEBUG-CONSOLE-TRACE", "what" ]);
//[ "^^^ _jsonStr ENTER", "what", "49002" ]
//[ "^^^ _stringifyReplacer ENTER", "", "what", "49002" ]
//           ...
//[ "^^^ _jsonStr EXIT", "EX@107 - Not THROW-EXCEPTIONS/LOG-ERRORS/UNDEF-OK/DEBUG-CONSOLE-TRACE/NO-CHECKING, unknown : what" ]
//X@107 - Not THROW-EXCEPTIONS/LOG-ERRORS/UNDEF-OK/DEBUG-CONSOLE-TRACE/NO-CHECKING, unknown : wha
//Uncaught EX@107 - Not THROW-EXCEPTIONS/LOG-ERRORS/UNDEF-OK/DEBUG-CONSOLE-TRACE/NO-CHECKING, unknown : what

// REFRESH browser as now everything will be traced
*/
      function _specParameters(the_commands) {
        consolelog("^^^ _specParameters ENTER 11", the_commands, TYPE_CZECH_current_test_number);
        let the_options = the_commands;
        const first_param = the_commands[0];
        if (Array.isArray(first_param)) {
          the_options = first_param;
        }
        the_options.forEach((a_parameter) => {
          // option order is not important
          if (typeof a_parameter === "object") {
            t_check_events = a_parameter;
          } else if (a_parameter === "UNDEF-OK") {
            OP_UNDEF_OK = a_parameter;
          } else if (a_parameter === "HIDE-INIT-MESSAGE") {
            OP_HIDE_INIT_MESSAGE = a_parameter;
          } else if (a_parameter === "DEBUG-CONSOLE-TRACE") {
            OP_DEBUG_CONSOLE_TRACE = a_parameter;
          } else if (a_parameter === OPT_THROW_EXCEPTIONS) {
            OP_THROW_EXCEPTIONS = a_parameter;
          } else if (a_parameter === "NO-ERROR-MESSAGES") {
            // for testing, so don't get a million error messages in console
            OP_NO_ERROR_MESSAGES = a_parameter;
          } else if (a_parameter === OPT_LOG_ERRORS) {
            OP_LOG_ERRORS = a_parameter;
          } else if (a_parameter === "CONSOLE-COUNT") {
            OP_CONSOLE_COUNT = a_parameter;
          } else if (a_parameter === "NO-CHECKING") {
            // this is the same as '', or nothing, but more informative
          } else if (a_parameter === "DEBUG-ERROR-TAGS") {
            OP_DEBUG_ERROR_TAGS = a_parameter;
          } else if (a_parameter !== "") {
            const arg_str = _jsonStr(a_parameter);
            const error_107 = `Not THROW-EXCEPTIONS/LOG-ERRORS/UNDEF-OK/DEBUG-CONSOLE-TRACE/NO-CHECKING, unknown : ${arg_str}`;
            const exception_107 = _consoleError(error_107, "EX@107");
            throw exception_107;
          }
        });
        t_do_param_checking = !!(OP_THROW_EXCEPTIONS || OP_LOG_ERRORS || OP_NO_ERROR_MESSAGES);
        const param_results = [
          OP_THROW_EXCEPTIONS,
          OP_LOG_ERRORS,
          OP_NO_ERROR_MESSAGES,
          OP_UNDEF_OK,
          OP_DEBUG_CONSOLE_TRACE,
          OP_CONSOLE_COUNT,
          OP_DEBUG_ERROR_TAGS,
        ];
        consolelog("^^^ _specParameters EXIT", param_results);
        return param_results;
      }

      /*
type_czech._twoArrays([ 'not-object', {an_object:'Boaty-McBoatFace'} ], 'fail-2');
//TE@201 - fail-2() called with '{}' against '!{}'. Contrasting a string type of value not-object, with '{\"an_object\":\"Boaty-McBoatFace\"}' an object !!! string <> object

type_czech._twoArrays([12, 'var-type-as-string'], 'ok-1');
//''
type_czech._twoArrays([['a-string'], 'string'], 'methodName');
//''

type_czech._twoArrays([ 'not-array', ['an-array'] ], 'fail-1');
//TE@217 - Comparing 'string' parameter, with a value of not-array, to expected shape of [\"an-array\"].

type_czech._twoArrays([       'a-string', ['string']            ], 'methodName');
//TE@217 - Comparing 'string' parameter, with a value of a-string, to expected shape of [\"string\"].
*/
      function notArrayShape(parameters_list, shape_str) {
        consolelog("^^^ notArrayShape ENTER", parameters_list, shape_str, TYPE_CZECH_current_test_number);
        const params_string = _toStr(parameters_list);
        const error_219 = `Comparing [] parameter, with a value of ${params_string}, against expected shape of ${shape_str}.`;
        consolelog("^^^ notArrayShape EXIT", error_219);
        return error_219;
      }

      function notArrayType(parameters_list, param_type, shape_str) {
        consolelog("^^^ notArrayType ENTER", parameters_list, param_type, shape_str, TYPE_CZECH_current_test_number);
        const params_string = _toStr(parameters_list);
        const error_217 = `Comparing '${param_type}' parameter, with a value of ${params_string}, to expected shape of ${shape_str}.`;
        consolelog("^^^ notArrayType EXIT", error_217);
        return error_217;
      }

      function undefOrNullShape(parameter_str, shape_list, method_name) {
        consolelog("^^^ undefOrNullShape ENTER", parameter_str, shape_list, method_name, TYPE_CZECH_current_test_number);
        let error_str_3arr = "";
        let err_mess = "";
        let error_label = "";
        if (typeof shape_list === "undefined") {
          err_mess = `${method_name}() called with 1st param of ${parameter_str} and 2nd shape param of undefined`;
          error_label = "TE@218";
        } else if (shape_list === null) {
          err_mess = `${method_name}() called with 1st param of ${parameter_str} and 2nd shape param of null`;
          error_label = "TE@220";
        }
        if (err_mess !== "") {
          error_str_3arr = _consoleError(err_mess, error_label);
        }
        consolelog("^^^ undefOrNullShape EXIT", error_str_3arr);
        return error_str_3arr;
      }

      function _twoArrays(list_of_2, method_name, no_parameters) {
        consolelog("^^^ _twoArrays ENTER", list_of_2, method_name, no_parameters, TYPE_CZECH_current_test_number);
        let error_str_3arr = "";
        if (list_of_2.length !== 2) {
          const error_401 = `${method_name}() has 2 argu-ments not ${list_of_2.length}`;
          error_str_3arr = _consoleError(error_401, "ME@401");
        } else {
          const [parameters_list, shape_list] = list_of_2;
          const parameter_type = _aTypeOf(parameters_list);
          const shape_type = _aTypeOf(shape_list);
          const parameter_str = _jsonStr(parameter_type);
          let shape_str;
          if (typeof shape_list === "string") {
            shape_str = shape_list;
          } else {
            shape_str = _jsonStr(shape_list);
          }
          error_str_3arr = undefOrNullShape(parameter_str, shape_list, method_name);
          if (error_str_3arr === "") {
            const param_value = _toStr(parameters_list);
            if (parameter_type === "array" && shape_type !== "array") {
              const not_empty_array = parameters_list.length > 1;
              const not_array_shape = shape_list !== "array" && shape_list !== "a";
              if (not_array_shape && not_empty_array) {
                const error_219 = notArrayShape(parameters_list, shape_str);
                error_str_3arr = _consoleError(error_219, "TE@219");
              } else if (no_parameters) {
                const error_408 = "There are no parameters.";
                error_str_3arr = _consoleError(error_408, "ME@408");
              }
            } else if (shape_type === "array" && parameter_type !== "array") {
              const error_217 = notArrayType(parameters_list, parameter_type, shape_str);
              error_str_3arr = _consoleError(error_217, "TE@217");
            } else if (shape_type === "array") {
              if (no_parameters) {
                const error_409 = NO_PARAMS_FOUND;
                error_str_3arr = _consoleError(error_409, "ME@409");
              }
              // no errors
            } else if (shape_type === "object") {
              if (parameter_type !== "object") {
                const error_201 =
                  `${method_name}() called with '{}' against '!{}'.` +
                  ` Contrasting a ${parameter_type} type of value ${param_value}, with '${shape_str}' an ${shape_type}` +
                  ` !!! ${parameter_type} <> ${shape_type}`;
                error_str_3arr = _consoleError(error_201, "TE@201");
              }
            } else if (shape_type !== "string") {
              const error_224 =
                `${method_name}() called with 2nd param not a string such as 'number'.` +
                ` Matching '${param_value}' with '${shape_str}'.` +
                ` Preferably try ${method_name}(12, 'number')`;
              error_str_3arr = _consoleError(error_224, "TE@224");
            }
          }
        }
        consolelog("^^^ _twoArrays EXIT", error_str_3arr);
        return error_str_3arr;
      }

      /*
type_czech._eitherChecks([1], 'fail-99');
//ME@406 - fail-99() needs 2 parameters, not 1
type_czech._eitherChecks([1, 2], 'fail-98');
//ME@402 - fail-98() called with a 2nd parameter as a non - array shape of 2
type_czech._eitherChecks([1, [2]], 'fail-97');
//UE@701 - fail-97()  needs at least 2 choices for an Either, not 1 of [2]
type_czech._eitherChecks([1, [2, 3]], 'pass-96');
//""
type_czech._eitherChecks(['a-str-or-num', ['string', 'number']], 'pass-95');
//""
type_czech._eitherChecks(['a-str-or-num-or-date', ['string', 'number', 'date']], 'pass-94');
//""
type_czech._eitherChecks([           ['a-str', 12345],   [  ['string','number'],['string','date']  ]              ], 'pass-93');
//""
type_czech._eitherChecks([   ['a-str', new Date('june 4, 1999')],   [  ['string','number'],['string','date']  ]              ], 'pass-92');
//""
*/
      function _eitherChecks(parameters_shapes, method_name) {
        consolelog("^^^ _eitherChecks ENTER", parameters_shapes, method_name, TYPE_CZECH_current_test_number);
        let error_string = "";
        if (parameters_shapes.length !== 2) {
          const error_406 = `${method_name}() needs 2 parameters, not ${parameters_shapes.length}`;
          error_string = _consoleError(error_406, "ME@406");
        } else {
          const shapes_lists = parameters_shapes[1];
          const exact_str = _jsonStr(shapes_lists);
          if (_aTypeOf(shapes_lists) !== "array") {
            const error_402 = `${method_name}() called with a 2nd parameter` + ` as a non - array shape of ${exact_str}`;
            error_string = _consoleError(error_402, "ME@402");
          } else if (shapes_lists.length < 2) {
            const shapes_lists_str = _toStr(shapes_lists);
            const error_701 = `${method_name}()  needs at least 2 choices for an Either, not ${shapes_lists.length} of ${shapes_lists_str}`;
            error_string = _consoleError(error_701, "UE@701");
          }
        }
        consolelog("^^^ _eitherChecks EXIT", error_string);
        return error_string;
      }

      function isVariadic(parameters_obj, shape_list, one_param) {
        consolelog("^^^ isVariadic ENTER", parameters_obj, shape_list, one_param, TYPE_CZECH_current_test_number);
        let is_variadic = false;
        if (!one_param) {
          if (!Array.isArray(parameters_obj)) {
            // NB not checkParam_type(arguments, ...) but checkParam_type([a,c], ...)
            if (Array.isArray(shape_list)) {
              if (shape_list.length === 1) {
                is_variadic = true;
              }
            }
          }
        }
        consolelog("^^^ isVariadic EXIT", is_variadic);
        return is_variadic;
      }

      function _unsafeArgs(method_name, parameters_obj) {
        consolelog("^^^ _unsafeArgs ENTER", method_name, parameters_obj, TYPE_CZECH_current_test_number);
        if (_isArgumentsObject(parameters_obj)) {
          const arg_error = `Used arguments object as first parameter to ${method_name}, this is unsafe, use parameters.`;
          return arg_error;
        }
        return "";
      }

      function _onlyArgs(method_name, parameters_obj) {
        consolelog("^^^ _onlyArgs ENTER", method_name, parameters_obj, TYPE_CZECH_current_test_number);
        if (!_isArgumentsObject(parameters_obj)) {
          const arg_error = `Used parameters as first parameter to ${method_name}, this is wrong, for variadics use arguments.`;
          return arg_error;
        }
        if (parameters_obj.length === 0) {
          const no_param_error = "There are no parameters.";
          return no_param_error;
        }
        return "";
      }

      /*
type_czech.checkParam_empty([12, 'a-string', false], ['EMPTY-ERROR', 'EMPTY-ERROR', 'EMPTY-ERROR']);
//''
type_czech.checkParam_empty(['a', 'b', 'c'], ['EMPTY-ERROR']);
//EE@322 - Array has more elements than types 3 !== 1
type_czech.checkParam_empty([12, [], 'a-string'], ['EMPTY-ERROR', 'EMPTY-OK', 'EMPTY-ERROR']);
//""
type_czech.checkParam_empty({}, 'EMPTY-OK');
//""
type_czech.checkParam_empty('a-string', 'EMPTY-ERROR');
//""
type_czech.checkParam_empty([12, [], 'a-string'], ['EMPTY-ERROR', 'EMPTY-ERROR', 'EMPTY-ERROR']);
//EE@311 - ELEMENT '1' is erroneously empty :
type_czech.checkParam_empty([], ['EMPTY-ERROR']);
//EE@321 - Empty array has no types
type_czech.checkParam_empty([], ['EMPTY-OK']);
//EE@305 - Pointless as ['EMPTY-OK'] matches all
type_czech.checkParam_empty(null, 'EMPTY-ERROR');
//EE@308 - A 'null' cannot be empty, so the state of 'EMPTY-ERROR' is illegal for the value 'null'
*/
      // eslint-disable-next-line consistent-return
      function checkParam_empty(parameters_obj, shape_list, func_name = MESS_EMPTY_VERIFY) {
        if (t_param_check_func.p_call_traps) {
          consolelog("^^^ checkParam_empty ENTER", parameters_obj, shape_list, TYPE_CZECH_current_test_number);
          const clean_param_obj = deClassify(parameters_obj);
          let error_str_3arr = _unsafeArgs(func_name, clean_param_obj);
          if (error_str_3arr === "") {
            const [parameters_array, no_parameters, one_param] = _getParameters(clean_param_obj);
            const parameters_str = _toStr(parameters_array);
            const shape_str = _toStr(shape_list);
            consolelog("^^^ checkParam_empty START", parameters_array, shape_list);
            error_str_3arr = _twoArrays([parameters_array, shape_list], "checkParam_empty", no_parameters);
            const is_variadic = isVariadic(clean_param_obj, shape_list, one_param);
            if (is_variadic) {
              return [func_name, `VE@606 - Use checkArgs_emptyEach([${parameters_str}], ['${shape_str}']') instead of checkParam_empty()`, shape_list];
            }
            if (error_str_3arr === "") {
              error_str_3arr = _emptyCheck(parameters_array, shape_list, EMPTY_VERIFY);
            }
          }
          consolelog("^^^ checkParam_empty EXIT", error_str_3arr);
          last_shape_method = [shape_list, func_name];
          return error_str_3arr;
        }
      }

      /*
type_czech.checkArgs_emptyEach('a', 'EMPTY-ERROR');
//Used parameters as first parameter to checkArgs_emptyEach(), this is wrong, for variadics use arguments.
*/
      // eslint-disable-next-line consistent-return
      function checkArgs_emptyEach(parameters_obj, shape_list) {
        if (t_param_check_func.p_call_traps) {
          consolelog("^^^ checkArgs_emptyEach ENTER", parameters_obj, shape_list, TYPE_CZECH_current_test_number);
          let error_str_3arr = _onlyArgs(MESS_EMPTY_VARIADIC, parameters_obj);
          if (shape_list !== EMPTY_ER && shape_list !== "ER") {
            const shapes_str = _toStr(shape_list);
            const error_607 = `Not allowed, ${shapes_str}, the only signature allowed with checkArgs_emptyEach() is 'EMPTY-ERROR' or 'ER'`;
            error_str_3arr = _consoleError(error_607, "VE@607");
          }
          if (error_str_3arr === "") {
            // eslint-disable-next-line no-unused-vars, prefer-const
            let [parameters_array, no_parameters, one_param] = _getParameters(parameters_obj);
            if (one_param) {
              // one param is not in an array !!!
              parameters_array = [parameters_array];
            }
            consolelog("^^^ checkArgs_emptyEach START", parameters_array, shape_list);
            const shapes_match_args = Array(parameters_array.length).fill(shape_list);
            error_str_3arr = _emptyCheck(parameters_array, shapes_match_args, EMPTY_VERIFY);
          }
          consolelog("^^^ checkArgs_emptyEach EXIT", error_str_3arr);
          last_shape_method = [shape_list, MESS_EMPTY_VARIADIC];
          return error_str_3arr;
        }
      }

      /*
type_czech.checkParam_type({}, 'an-object');
//TE@202 - Type 'an-object' is wrong classname or not a scalar
type_czech.checkParam_type({cyl:4, fuel:"gasoline", snuck:"extra"}, {cyl:"number", fuel:"string"});
//TE@209 - Extra key in checked object - (snuck:'extra')
type_czech.checkParam_type({cyl:4, fuel:"gasoline"}, {cyl:"number", fuel:"string", snuck:"boolean"});
//TE@216 - The key 'snuck', which has a type of 'boolean', is missing in the checked object
type_czech.checkParam_type([1,2,3], ["number", "number"]);
//TE@239 - 3 !== 2, array has more elements than types, [1,2,3] !== [\"number\",\"number\"]
type_czech.checkParam_type([1,2], ["number", "number", "number"]);
//TE@237 -  ELEMENT '2' is assumed to be a 'number', but is mistakenly a 'undefined'
type_czech.checkParam_type([[['array']]], [["number"]]);
//TE@214 -  ELEMENT '0' is assumed to be a 'number', but is mistakenly a 'array' with a value of [\"array\"]
type_czech.checkParam_type('a-string', ['string']);
//TE@217 - Comparing 'string' parameter, with a value of a-string, to expected shape of [\"string\"].
type_czech.checkParam_type([1,2,3], ["number", "number", "number"]);
//""
type_czech.checkParam_type({cyl:4, fuel:"gasoline"}, {cyl:"number", fuel:"string"});
//""
type_czech.checkParam_type([], 'array');
//""
type_czech.checkParam_type({}, 'object');
//""
type_czech.checkParam_type(['a', 'b', 'c'], ['string']);
//TE@239 - 3 !== 1, array has more elements than types, [\"a\",\"b\",\"c\"] !== [\"string\"]
type_czech.checkParam_type(['a','b','c'], ['string','string','string']);
//''
type_czech.checkParam_type(['a', 'c'], ['string','string']);
//''
type_czech.checkParam_type(['a'], ['string']);
//''
type_czech.checkParam_type('a', 'string');
//''
*/
      // eslint-disable-next-line consistent-return
      function checkParam_type(parameters_obj, shape_list, func_name = MESS_TYPE_VERIFY) {
        if (t_param_check_func.p_call_traps) {
          consolelog("^^^ checkParam_type ENTER", parameters_obj, shape_list, TYPE_CZECH_current_test_number);
          const final_type =  typeFinal(parameters_obj)
          if (parameters_obj!==undefined && parameters_obj!==null && !TYPE_SET_SCALAR.has(final_type)) {
            return '';  // a classname like 'Person_Class' or 'Person' or 'First'/'Last'/'Full'
          }
          consolelog("^^^ checkParam_type typeFinal", typeFinal);
          const clean_param_obj = deClassify(parameters_obj);              // here 'number', 'object', ['string', 'number', 'date']
          let error_str_3arr = _unsafeArgs(func_name, clean_param_obj);
          if (error_str_3arr === "") {
            const [parameters_array, no_parameters, one_param] = _getParameters(clean_param_obj);
            const parameters_str = _toStr(parameters_array);
            const shape_str = _toStr(shape_list);
            consolelog("^^^ checkParam_type START", parameters_array, no_parameters, one_param, shape_list);
            error_str_3arr = _twoArrays([parameters_array, shape_list], "checkParam_type", no_parameters);
            if (error_str_3arr === "") {
              const is_variadic = isVariadic(clean_param_obj, shape_list, one_param);
              if (is_variadic) {
                error_str_3arr = [func_name, `VE@605 - Use checkArgs_typeEach(${parameters_str}, ${shape_str}) instead of checkParam_type()`, shape_list];
              }
              if (error_str_3arr === "") {
                error_str_3arr = _shapeVariable(parameters_array, shape_list, TYPE_VERIFY);
              }
            }
          }
          consolelog("^^^ checkParam_type EXIT", error_str_3arr, shape_list);
          last_shape_method = [shape_list, func_name];
          return error_str_3arr;
        }
      }

      /*
type_czech.checkArgs_typeEach('a', 'string');
//Used parameters as first parameter to checkArgs_typeEach(), this is wrong, for variadics use arguments.
*/
      // eslint-disable-next-line consistent-return
      function checkArgs_typeEach(parameters_obj, shape_list) {
        if (t_param_check_func.p_call_traps) {
          consolelog("^^^ checkArgs_typeEach ENTER", parameters_obj, shape_list, TYPE_CZECH_current_test_number);
          let error_str_3arr = _onlyArgs(MESS_TYPE_VARIADIC, parameters_obj);
          if (Array.isArray(shape_list) || (typeof shape_list === "string" && shape_list.startsWith("array"))) {
            const shapes_str = _toStr(shape_list);
            const error_608 = `Signature ${shapes_str} is too complicated, try manually iterating over array and check each element with checkParams()`;
            error_str_3arr = _consoleError(error_608, "VE@608");
          }
          if (error_str_3arr === "") {
            // eslint-disable-next-line no-unused-vars, prefer-const
            let [parameters_array, no_parameters, one_param] = _getParameters(parameters_obj);
            const there_are_arrays = Array.isArray(parameters_array);
            let plural_type = false;
            if (typeof shape_list === "string") {
              plural_type = shape_list.endsWith("s");
            }
            const params_str = _toStr(parameters_array);
            let new_shape_list = shape_list;
            if (one_param) {
              if (there_are_arrays) {
                if (!plural_type) {
                  const error_601 = `Should be checkArgs_typeEach(arguments, '${new_shape_list}s'), plural for ${params_str}`;
                  error_str_3arr = _consoleError(error_601, "VE@601");
                }
                // eslint-disable-next-line no-param-reassign
                new_shape_list = [new_shape_list.substring(0, new_shape_list.length - 1)];
              } else if (plural_type) {
                const single_shape_str = new_shape_list.substring(0, new_shape_list.length - 1);
                const error_602 = `Should be checkArgs_typeEach(arguments, '${single_shape_str}'), singular for ${params_str}`;
                error_str_3arr = _consoleError(error_602, "VE@602");
              }
              parameters_array = [parameters_array];
            } else {
              const two_level_arrays = Array.isArray(parameters_array[0]);
              if (two_level_arrays) {
                if (!plural_type) {
                  const error_603 = `Should be checkArgs_typeEach(arguments, '${new_shape_list}s'), multiple for ${params_str}`;
                  error_str_3arr = _consoleError(error_603, "VE@603");
                }
              } else if (plural_type) {
                const single_shape_str = new_shape_list.substring(0, new_shape_list.length - 1);
                const error_604 = `Should be checkArgs_typeEach(arguments, '${single_shape_str}'), not plural for ${params_str}`;
                error_str_3arr = _consoleError(error_604, "VE@604");
              }
            }
            if (error_str_3arr === "") {
              const shapes_match_args = Array(parameters_array.length).fill(new_shape_list);
              consolelog("^^^ checkArgs_typeEach START", parameters_array, shapes_match_args);
              error_str_3arr = _twoArrays([parameters_array, shapes_match_args], "checkArgs_typeEach", no_parameters);
              if (error_str_3arr === "") {
                error_str_3arr = _shapeVariable(parameters_array, shapes_match_args, TYPE_VERIFY);
              } else if (error_str_3arr.endsWith(NO_PARAMS_FOUND)) {
                error_str_3arr = ""; // if no parameters for checkArgs_typeEach(), then ok, to match empty array type
              }
            }
          }
          consolelog("^^^ checkArgs_typeEach EXIT", error_str_3arr, shape_list);
          last_shape_method = [shape_list, MESS_TYPE_VARIADIC];
          return error_str_3arr;
        }
      }

      function extraEmptys(parameters_obj, shape_list) {
        consolelog("^^^ extraEmptys ENTER", parameters_obj, shape_list, TYPE_CZECH_current_test_number);
        // eslint-disable-next-line no-unused-vars
        const [parameters_array, _no_parameters, _one_param] = _getParameters(parameters_obj);
        consolelog("^^^ extraEmptys START", parameters_array, shape_list);
        const error_str_3arr = _emptyCheck(parameters_array, shape_list, EMPTY_EXTRAS);
        consolelog("^^^ extraEmptys EXIT", error_str_3arr);
        return error_str_3arr;
      }

      /*
type_czech.checkParam_emptyExtra([17], ['EMPTY-ERROR', 'EMPTY-ERROR']);
//EE@318 - checkParam_emptyExtra([17], [\"EMPTY-ERROR\",\"EMPTY-ERROR\"]) is missing empty types
type_czech.checkParam_emptyExtra([17, 'c'], 'EMPTY-ERROR');
//""
type_czech.checkParam_emptyExtra('a-string', 'EMPTY-ERROR');
//""
type_czech.checkParam_emptyExtra([17,""], "EMPTY-ERROR")
//''
type_czech.checkParam_emptyExtra(17, ['EMPTY-ERROR', 'EMPTY-ERROR']);
//EE@317 - checkParam_emptyExtra(17, [\"EMPTY-ERROR\",\"EMPTY-ERROR\"]) comparing scalar to empty array
type_czech.checkParam_emptyExtra({a:17}, {a:'EMPTY-ERROR'});
//''
type_czech.checkParam_emptyExtra([17, 'abc', true], ['EMPTY-ERROR', 'EMPTY-ERROR']);
//''
*/
      // eslint-disable-next-line consistent-return
      function checkParam_emptyExtra(parameters_obj, shape_list) {
        if (t_param_check_func.p_call_traps) {
          consolelog("^^^ checkParam_emptyExtra ENTER", parameters_obj, shape_list, TYPE_CZECH_current_test_number);
          const clean_param_obj = deClassify(parameters_obj);
          let error_str_3arr = _unsafeArgs(MESS_EMPTY_EXTRAS, clean_param_obj);
          if (error_str_3arr === "") {
            const params_collection = _isCollection(clean_param_obj);
            const shape_collection = _isCollection(shape_list);
            const shape_str = _toStr(shape_list);
            // eslint-disable-next-line no-unused-vars
            const [parameters_array, _no_parameters, _one_param] = _getParameters(clean_param_obj);
            const parameters_str = _toStr(parameters_array);
            if (params_collection && shape_collection) {
              consolelog("^^^ checkParam_emptyExtra START 1", parameters_array, clean_param_obj.length, shape_list.length);
              if (typeFinal(shape_list) === "string") {
                error_str_3arr = extraEmptys(clean_param_obj[0], shape_list);
              } else if (typeFinal(shape_list) === "object") {
                error_str_3arr = extraEmptys(clean_param_obj, shape_list);
              } else if (clean_param_obj.length < shape_list.length) {
                const error_318 = `checkParam_emptyExtra(${parameters_str}, ${shape_str}) is missing empty types`;
                error_str_3arr = _consoleError(error_318, "EE@318");
              } else {
                error_str_3arr = extraEmptys(clean_param_obj, shape_list);
              }
            } else {
              consolelog("^^^ checkParam_emptyExtra START 2", parameters_array, shape_list, TYPE_CZECH_current_test_number);
              const long_empty = _shortToLongEmpty(shape_list);
              let the_variable;
              if (Array.isArray(clean_param_obj)) {
                // eslint-disable-next-line prefer-destructuring
                the_variable = clean_param_obj[0];
              } else {
                if (Array.isArray(shape_list)) {
                  const error_317 = `checkParam_emptyExtra(${parameters_str}, ${shape_str}) comparing scalar to empty array`;
                  error_str_3arr = _consoleError(error_317, "EE@317");
                }
                the_variable = clean_param_obj;
              }
              if (long_empty === EMPTY_ER && _isEmpty(the_variable)) {
                const error_319 = `checkParam_emptyExtra(${parameters_str}, ${shape_str}) has first parameter empty`;
                error_str_3arr = _consoleError(error_319, "EE@319");
              }
            }
          }
          consolelog("^^^ checkParam_emptyExtra ENTER", error_str_3arr);
          last_shape_method = [shape_list, MESS_EMPTY_EXTRAS];
          return error_str_3arr;
        }
      }

      function extraTypes(parameters_obj, shape_list) {
        consolelog("^^^ extraTypes ENTER", parameters_obj, shape_list, TYPE_CZECH_current_test_number);
        // eslint-disable-next-line no-unused-vars
        const [parameters_array, _no_parameters, _one_param] = _getParameters(parameters_obj);
        const error_str_3arr = _shapeVariable(parameters_array, shape_list, TYPE_EXTRAS);
        consolelog("^^^ extraTypes EXIT", error_str_3arr);
        return error_str_3arr;
      }

      /*
type_czech.checkParam_typeExtra([17], ['number', 'number']);
//TE@221 - Element '1' is supposed to be a 'number', but is missing : [17]
type_czech.checkParam_typeExtra([17, 'abc'], ['number']);
//''
type_czech.checkParam_type([17, 'abc'], ['number']);
//TE@239 - 2 !== 1, array has more elements than types, [17,\"abc\"] !== [\"number\"]
type_czech.checkParam_typeExtra([1,2], ["number", "number", "number"]);
//TE@237 -  ELEMENT '2' is assumed to be a 'number', but is mistakenly a 'undefined'
type_czech.checkParam_typeExtra([17, 'abc'], ['number', 'string']);
//''
type_czech.checkParam_typeExtra(['a-string', 17, false], ['string', 'number']);
//''
type_czech.checkParam_typeExtra([1,2,3], ["number", "number"]);
//''
type_czech.checkParam_typeExtra([1,2,3], ["number", "number", "number"]);
//''
type_czech.checkParam_typeExtra({0:'a', 1:'b', 2:'c', length:3}, ["string", "string"]);
//""
type_czech.checkParam_typeExtra([ {funcOne: x=>x},2,3], [{ funcOne: 'function'}, "number"]);
//""
type_czech.checkParam_typeExtra([ {funcOne: x=>x},2], [{ funcOne: 'function'}, "number"]);
//""
type_czech.checkParam_typeExtra([ {funcOne: x=>x, funcTwo: y=>y},2], [{ funcOne: 'function'}, "number"]);
//""
type_czech.checkParam_typeExtra([17, 'abc', true], ['number', 'string']);
//''
type_czech.checkParam_typeExtra({a:17}, {a:'number'});
//''
type_czech.checkParam_typeExtra({a:17, b:false}, {a:'number'});
//''
type_czech.checkParam_typeExtra([17, 'c'], 'number');
//""
type_czech.checkParam_typeExtra(17, ['number','string']);
//EE@320 - checkParam_typeExtra(17, '[\"number\",\"string\"]') has the first param wrong. TE@230 - The type '[\"number\",\"s\"]' is invalid
type_czech.checkParam_typeExtra([17], ['number', 'string']);
//TE@214 -  ELEMENT '1' is assumed to be a 'string', but is mistakenly a 'number' with a value of undefined
type_czech.checkParam_typeExtra([17, 'c'], ['number', 'string']);
//''
type_czech.checkParam_typeExtra([17, 'c'], ['number']);
//''
type_czech.checkParam_typeExtra([17, 16,], 'number');
//''
type_czech.checkParam_typeExtra(['17', 'c'], 'number');
//EE@320 - checkParam_typeExtra([\"17\",\"c\"], 'number') has the first param wrong. TE@226 - The value '17', which is a 'string', is not a 'number'
type_czech.checkParam_typeExtra(17, 'number');
//''
*/
      // eslint-disable-next-line consistent-return
      function checkParam_typeExtra(parameters_obj, shape_list) {
        if (t_param_check_func.p_call_traps) {
          consolelog("^^^ checkParam_typeExtra ENTER", parameters_obj, shape_list, TYPE_CZECH_current_test_number);
          const clean_param_obj = deClassify(parameters_obj);
          let error_str_3arr = _unsafeArgs(MESS_TYPE_EXTRAS, clean_param_obj);
          if (error_str_3arr === "") {
            const params_collection = _isCollection(clean_param_obj);
            const shape_collection = _isCollection(shape_list);
            const shape_str = _toStr(shape_list);
            // eslint-disable-next-line no-unused-vars
            const [parameters_array, _no_parameters, _one_param] = _getParameters(clean_param_obj);
            let parameters_str = _toStr(parameters_array);
            if (params_collection && shape_collection) {
              consolelog("^^^ checkParam_typeExtra START", parameters_array, clean_param_obj.length, shape_list.length);
              if (typeFinal(shape_list) === "string") {
                error_str_3arr = extraTypes(clean_param_obj[0], shape_list);
              } else if (typeFinal(shape_list) === "object") {
                error_str_3arr = extraTypes(clean_param_obj, shape_list);
              } else {
                error_str_3arr = extraTypes(clean_param_obj, shape_list);
              }
            } else {
              let type_error;
              if (Array.isArray(parameters_array)) {
                if (parameters_array.length === 0) {
                  type_error = `The value [], which is an array, is not a ${shape_str}`; // type_czech.checkParam_typeExtra([], 'object');
                } else {
                  type_error = _shapeScalar(parameters_array[0], shape_list); // type_czech.checkParam_typeExtra([2], 'object');
                }
              } else {
                type_error = _shapeScalar(parameters_array, shape_list); // type_czech.checkParam_typeExtra('str', 'number');
              }
              if (type_error) {
                if (_aTypeOf(parameters_array) === "string") {
                  // eslint-disable-next-line no-const-assign
                  parameters_str = `'${parameters_str}'`;
                }
                const error_320 = `checkParam_typeExtra(${parameters_str}, '${shape_str}') has the first param wrong. ${type_error}`;
                error_str_3arr = _consoleError(error_320, "EE@320");
              }
            }
          }
          consolelog("^^^ checkParam_typeExtra EXIT", error_str_3arr);
          last_shape_method = [shape_list, MESS_TYPE_EXTRAS];
          return error_str_3arr;
        }
      }

      /*
type_czech.checkParam_emptyEither([12, false, 'a string'], 'EMPTY-OK');
//ME@402 - checkParam_emptyEither() called with a second parameter as a non - array shape of "EMPTY-OK"
type_czech.checkParam_emptyEither([12, false, 'a string'], ['EMPTY-OK']);
//UE@701 - checkParam_emptyEither()  needs at least 2 choices for an Either, not 1 ["EMPTY-OK"]
type_czech.checkParam_emptyEither( {a:0, b:12});
//ME@402 - checkParam_emptyEither() called with a 2nd parameter as a non - array shape of undefined
type_czech.checkParam_emptyEither([12, 0], [['ER','ER'],['ER','OK']]);
//""
type_czech.checkParam_emptyEither( {a:92, b:Infinity}, [ {a:'ER', b:'ER'}, {a:'ER', b:'OK'}]);
//
type_czech.checkParam_emptyEither('a-string', ['EMPTY-ERROR', 'EMPTY-OK']);
//""
type_czech.checkParam_emptyEither([12, 0, 'is-error'], [['ER','ER'],['ER','OK']]);
//EE@322 - Array has more elements than types 3 !== 2
type_czech.checkParam_emptyEither( {a:92, b:Infinity}, [ {a:'OK', b:'ER'}, {a:'OK', b:'ER'}]);
//EE@301 -  key 'b' is a 'number' which is reputed to be 'EMPTY-ERROR' but has a value of Infinity
*/
      // eslint-disable-next-line consistent-return
      function checkParam_emptyEither(parameters_obj, shapes_lists) {
        if (t_param_check_func.p_call_traps) {
          consolelog("^^^ checkParam_emptyEither ENTER", parameters_obj, shapes_lists, TYPE_CZECH_current_test_number);
          const clean_param_obj = deClassify(parameters_obj);
          let error_str_3arr = _unsafeArgs(MESS_EMPTY_ONE_OF, clean_param_obj);
          if (error_str_3arr === "") {
            // eslint-disable-next-line no-unused-vars
            const [parameters_array, _no_parameters, _one_param] = _getParameters(clean_param_obj);
            consolelog("^^^ checkParam_emptyEither START", parameters_array, shapes_lists);
            error_str_3arr = _eitherChecks([parameters_array, shapes_lists], "checkParam_emptyEither");
            if (error_str_3arr === "") {
              error_str_3arr = _doEitherEmpty([parameters_array, shapes_lists]);
            }
          }
          consolelog("^^^ checkParam_emptyEither EXIT", error_str_3arr);
          last_shape_method = [shapes_lists, MESS_EMPTY_ONE_OF];
          return error_str_3arr;
        }
      }

      /*
type_czech.checkParam_typeEither(17, [ "string", "number" ]);
//""
type_czech.checkParam_typeEither({a:17, b:false}, [{a:"number", b:"boolean"}, {a:"string"}]);
//''
type_czech.checkParam_typeEither({a:17, b:false}, [{a:"number"}, {a:"string"}]);
//TE@209 - Extra key in checked object - (b:'false'), TE@213 - Property 'a' is indicated to be a 'string', but is inaccurately a 'number' : 17
*/
      // eslint-disable-next-line consistent-return
      function checkParam_typeEither(parameters_obj, possible_shapes) {
        if (t_param_check_func.p_call_traps) {
          consolelog("^^^ checkParam_typeEither ENTER", parameters_obj, possible_shapes, TYPE_CZECH_current_test_number);
          const clean_param_obj = deClassify(parameters_obj);
          let error_str_3arr = _unsafeArgs(MESS_TYPE_ONE_OF, clean_param_obj);
          if (error_str_3arr === "") {
            // eslint-disable-next-line no-unused-vars
            const [parameters_array, _no_parameters, _one_param] = _getParameters(clean_param_obj);
            consolelog("^^^ checkParam_typeEither START", parameters_array, possible_shapes);
            error_str_3arr = _eitherChecks([parameters_array, possible_shapes], "checkParam_typeEither");
            if (error_str_3arr === "") {
              error_str_3arr = _doEitherShape([parameters_array, possible_shapes]);
            }
          }
          consolelog("^^^ checkParam_typeEither ENTER", error_str_3arr);
          last_shape_method = [possible_shapes, MESS_TYPE_ONE_OF];
          return error_str_3arr;
        }
      }

      /*
function check_func(a_num){ if (a_num>0) return 'only neg nums'}
function your_func(a_num){}
your_func = type_czech.linkUp(your_func, check_func);
your_func(54321)
//check_func() PRE-FUNC: only neg nums
//         CHECKER checkParam_typeEither()
//     ACTUAL TYPE 'number'
//          VALUES 54321
//   EXPECTED TYPE [{"a":"number"},{"a":"string"}]
//          ORIGIN your_func(a_num)

function check_func(a_num){return type_czech.checkParam_type(a_num, 'string') }
function your_func(a_num){}
your_func = type_czech.linkUp(your_func, check_func);
your_func(54321)
//check_func() PRE-FUNC: TE@226 - The value '54321', which is a 'number', is not a 'string'
//         CHECKER checkParam_type()
//     ACTUAL TYPE 'number'
//          VALUES 54321
//   EXPECTED TYPE string
//          ORIGIN your_func(a_num)

function check_func(){return type_czech.checkParam_type(arguments, 'string') }
function your_func(){}
your_func = type_czech.linkUp(your_func, check_func);
your_func(12345)
//check_func() PRE-FUNC: Used arguments object as first parameter to checkParam_type(), this is unsafe, use parameters.
//         CHECKER checkParam_type()
//     ACTUAL TYPE 'number'
//          VALUES 12345
//   EXPECTED TYPE string
//          ORIGIN your_func()
*/
      function linkUp(user_function, pre_check, post_check) {
        consolelog("^^^ check ENTER", user_function, pre_check, post_check, TYPE_CZECH_current_test_number);
        let check_result;
        if (typeof post_check === "undefined") {
          check_result = t_param_check_func.confirmParameters(user_function, pre_check, false);
        } else {
          check_result = t_param_check_func.confirmParameters(user_function, pre_check, post_check);
        }
        consolelog("^^^ check EXIT", check_result);
        return check_result;
      }

      function countTally() {
        return t_param_check_func.countTally_();
      }
      function enableTests() {
        return t_param_check_func.enableTests_();
      }
      function disableTests() {
        return t_param_check_func.disableTests_(); // t_param_check_func === _ParametersCheck() result
      }
      function countFails() {
        return t_param_check_func.countFails_();
      }

      function countZero() {
        return t_param_check_func.countZero_();
      }

      function check_assert(error_mess, where_from = "", actual_value = "", expected_mess = "") {
        if (t_param_check_func.p_call_traps && error_mess) {
          return t_param_check_func.check_assert_(error_mess, where_from, actual_value, expected_mess);
        }
        return ""; // No error, return nada
      }

      /*
long_str = '1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890'
         + '1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890';
type_czech._shrinkDiffs(long_str);
//"1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890 <<<<<<~~~>>>>>> 12345678901234567890123456789012345678901234567890"
*/
      function _shrinkDiffs(long_diff) {
        let short_diff;
        if (long_diff.length < DIFF_BREAK_MIN) {
          short_diff = long_diff;
        } else {
          const start_diff = long_diff.substring(0, DIFF_BEGIN_LEN);
          const end_diff = long_diff.substring(long_diff.length - DIFF_END_LEN);
          short_diff = `${start_diff} ${DIFF_SEPARATOR} ${end_diff}`;
        }
        return short_diff;
      }

      function diffMessage(same_text, pre_diff, post_diff) {
        const same_shrunk = _shrinkDiffs(same_text);
        const pre_shrunk = _shrinkDiffs(pre_diff);
        const post_shrunk = _shrinkDiffs(post_diff);
        const share_begin = _toStr(`${CZECH_ERROR_INDENT}START-SAME ~ ${same_shrunk}`);
        const pre_changed = _toStr(`${CZECH_ERROR_INDENT}  PRE-DIFF ~ ${pre_shrunk}`);
        const post_changed = _toStr(`${CZECH_ERROR_INDENT} POST-DIFF ~ ${post_shrunk}`);
        const first_difference = `${share_begin}${pre_changed}${post_changed}`;
        return first_difference;
      }

      function firstDiff(pre_str, post_str) {
        let start_same = 0;
        let hit_end = false;
        while (pre_str[start_same] === post_str[start_same]) {
          if (start_same === pre_str.length || start_same === post_str.length) {
            hit_end = true;
            break;
          }
          start_same += 1;
        }
        return [start_same, hit_end];
      }

      /*
type_czech._refDiff('', '')
//""

type_czech._refDiff('', '1')
//START-SAME ~ ''
//  PRE-DIFF ~ ''
// POST-DIFF ~ 1"

type_czech._refDiff('1', '')
//START-SAME ~ ''
//  PRE-DIFF ~ 1
// POST-DIFF ~ ''"

type_czech._refDiff('1', '1')
//""

type_czech._refDiff('123', '01234')
//START-SAME ~ ''
//  PRE-DIFF ~ 123
// POST-DIFF ~ 01234"

type_czech._refDiff('01234', '123')
//START-SAME ~ ''
//  PRE-DIFF ~ 01234
// POST-DIFF ~ 123"

type_czech._refDiff('[1,2,3]', '[1,X,3]');
//START-SAME ~ [1,
//  PRE-DIFF ~ 2,3]
// POST-DIFF ~ X,3]

type_czech._refDiff("{'3':3,'B':'B'}", "{'B':'B'}")
//START-SAME ~ {'
//  PRE-DIFF ~ 3':3,'B':'B'}
// POST-DIFF ~ B':'B'}"

type_czech._refDiff("{'B':'B'}", "{'3':3,'B':'B'}")
//START-SAME ~ {'
//  PRE-DIFF ~ B':'B'}
// POST-DIFF ~ 3':3,'B':'B'}"

type_czech._refDiff("{'B':'B','3':3}", "{'B':'B'}")
//START-SAME ~ {'B':'B'
//  PRE-DIFF ~ ,'3':3}
// POST-DIFF ~ }"

type_czech._refDiff("{'B':'B'}", "{'B':'B','3':3}")
//START-SAME ~ {'B':'B'
//  PRE-DIFF ~ }
// POST-DIFF ~ ,'3':3}"

type_czech._refDiff('123456789012345678901234567890123456789012345678901234567890',
                    '1234567890123456789012345678901234567_89012345678901234567890');
//START-SAME ~ 1234567890123456789012345678901234567
//  PRE-DIFF ~ 89012345678901234567890
// POST-DIFF ~ _89012345678901234567890"
*/
      function _refDiff(pre_str, post_str) {
        consolelog("^^^ refDiff ENTER", pre_str, post_str, TYPE_CZECH_current_test_number);
        let first_difference = "";
        if (pre_str !== post_str) {
          const [start_same, hit_end] = firstDiff(pre_str, post_str);
          const pre_len = pre_str.length;
          const post_len = post_str.length;
          let same_text;
          let pre_diff;
          let post_diff;
          if (hit_end) {
            if (pre_len > post_len) {
              same_text = post_len === 0 ? BLANK_STR_S_QUOTE : post_str;
              pre_diff = pre_str.substring(start_same);
              post_diff = BLANK_STR_S_QUOTE;
            } else {
              same_text = pre_len === 0 ? BLANK_STR_S_QUOTE : pre_str;
              pre_diff = BLANK_STR_S_QUOTE;
              post_diff = pre_str.substring(start_same);
            }
          } else {
            same_text = start_same === 0 ? BLANK_STR_S_QUOTE : pre_str.substring(0, start_same);
            pre_diff = pre_len === 0 ? BLANK_STR_S_QUOTE : pre_str.substring(start_same);
            post_diff = post_len === 0 ? BLANK_STR_S_QUOTE : post_str.substring(start_same);
          }
          first_difference = diffMessage(same_text, pre_diff, post_diff);
        }
        consolelog("^^^ refDiff EXIT", first_difference);
        return first_difference;
      }

      /*
type_czech.check_buildSnapshot('my-func', 'my_array', 12);
//Uncaught EX@109 - check_buildSnapshot()'s 3rd param not array/object but a 'number'

type_czech.check_buildSnapshot('my-func', 'my_array', [1,2,3]);
type_czech.check_buildSnapshot('my-func', 'my_array', [999,888,777]);
type_czech._mutateStacks();
//{"my-func-my_array":[
//  {"collection_ref":[1,2,3],      "func_name":"my-func","pre_collect_str":"[1,2,3]",      "var_name":"my_array"},
//  {"collection_ref":[999,888,777],"func_name":"my-func","pre_collect_str":"[999,888,777]","var_name":"my_array"}  ]}
*/
      // eslint-disable-next-line consistent-return
      function check_buildSnapshot(func_name, var_name, collection_ref) {
        if (t_param_check_func.p_call_traps) {
          consolelog("^^^ check_buildSnapshot ENTER", func_name, var_name, collection_ref, TYPE_CZECH_current_test_number);
          const num_parameters = arguments.length;
          if (num_parameters !== 3) {
            t_param_check_func.newFail();
            const error_108 = `check_buildSnapshot() needs 3 params, not ${num_parameters}`;
            const exception_108 = _consoleError(error_108, "EX@108");
            throw exception_108;
          } else if (!_isCollection(collection_ref)) {
            t_param_check_func.newFail();
            const collection_type = _aTypeOf(collection_ref);
            const error_109 = `check_buildSnapshot()'s 3rd param not array/object but a '${collection_type}'`;
            const exception_109 = _consoleError(error_109, "EX@109");
            throw exception_109;
          } else if (typeof func_name !== "string") {
            t_param_check_func.newFail();
            const error_110 = `1st check_buildSnapshot() param must be un-empty string, not ${_toStr(func_name)}`;
            const exception_110 = _consoleError(error_110, "EX@110");
            throw exception_110;
          } else if (typeof var_name !== "string") {
            t_param_check_func.newFail();
            const error_111 = `2nd check_buildSnapshot() param must be un-empty string, not ${_toStr(var_name)}`;
            const exception_111 = _consoleError(error_111, "EX@111");
            throw exception_111;
          }
          const func_varname = `${func_name}-${var_name}`;
          const no_cycles = _cycle_loops.decycle(collection_ref);
          const pre_collect_str = _fast_json_stable_stringify(no_cycles);
          const ref_instance = {
            func_name,
            var_name,
            collection_ref,
            pre_collect_str,
          };
          const have_varname = t_reference_stacks[func_varname];
          if (have_varname) {
            t_reference_stacks[func_varname].push(ref_instance);
          } else {
            t_reference_stacks[func_varname] = [ref_instance];
          }
          consolelog("^^^ check_buildSnapshot EXIT", ref_instance);
          last_shape_method = [var_name, MESS_SNAPSHOT];
          return "";
        }
      }

      // for debugging only, to view all the mutation states
      function _mutateStacks() {
        const ref_stacks_str = _fast_json_stable_stringify(t_reference_stacks);
        return ref_stacks_str;
      }

      /*
type_czech.check_mutatedSnapshot('func-name', 'var-name', 'error-param');
//Uncaught EX@112 - TypeCzech.check_mutatedSnapshot() needs 2 parameters, not 3
type_czech.check_mutatedSnapshot('noFunc', 'no_array');
//Uncaught EX@113 - No record of check_mutatedSnapshot('noFunc', 'no_array', a_var)

var my_array = [1,2,3];
type_czech.check_buildSnapshot('my-func', 'my_array', my_array);
my_array.push(4);
type_czech.check_mutatedSnapshot('my-func', 'my_array');
//ME@405 - Variable 'my_array' changed
//from [1,2,3]
//  to [1,2,3,4]
//
//START-SAME ~ [1,2,3
//  PRE-DIFF ~ ]
// POST-DIFF ~ ,4]

var my_obj = {a:1, b:2, c:3};
type_czech.check_buildSnapshot('my-func', 'my_obj', my_obj);
delete my_obj.b;
my_obj.b=7;
type_czech.check_mutatedSnapshot('my-func', 'my_obj');
//ME@405 - Variable 'my_obj' changed
//from {"a":1,"b":2,"c":3}
//  to {"a":1,"b":7,"c":3}
//
//START-SAME ~ {"a":1,"b":
//  PRE-DIFF ~ 2,"c":3}
// POST-DIFF ~ 7,"c":3}

var my_obj = {a:1n, b:2n, c:3n};
type_czech.check_buildSnapshot('my-func', 'my_obj', my_obj);
delete my_obj.b;
my_obj.b=7;
type_czech.check_mutatedSnapshot('my-func', 'my_obj');
//ME@405 - Variable 'my_obj' changed
//from {"a":"1n","b":"2n","c":"3n"}
//  to {"a":"1n","b":7,"c":"3n"}
//
//START-SAME ~ {"a":"1n","b":
//  PRE-DIFF ~ "2n","c":"3n"}
// POST-DIFF ~ 7,"c":"3n"}

let my_arr = [1];
type_czech.check_buildSnapshot('my-func', 'my_arr', my_arr); // re-assignment, not mutation
my_arr = [2];
type_czech.check_mutatedSnapshot('my-func', 'my_arr');
//''
*/
      // eslint-disable-next-line consistent-return
      function check_mutatedSnapshot(func_name, var_name) {
        if (t_param_check_func.p_call_traps) {
          consolelog("^^^ check_mutatedSnapshot ENTER", func_name, var_name, TYPE_CZECH_current_test_number);
          const func_str = _toStr(func_name);
          const var_str = _toStr(var_name);
          const func_varname = `${func_str}-${var_str}`;
          let error_mess = "";
          const have_varname = t_reference_stacks[func_varname];
          const num_parameters = arguments.length;
          if (num_parameters !== 2) {
            t_param_check_func.newFail();
            const error_112 = `check_mutatedSnapshot() needs 2 param, not ${num_parameters}`;
            const exception_112 = _consoleError(error_112, "EX@112");
            throw exception_112;
          } else if (!have_varname) {
            t_param_check_func.newFail();
            const error_113 = `No record of check_mutatedSnapshot('${func_str}', '${var_str}', a_var)`;
            const exception_113 = _consoleError(error_113, "EX@113");
            throw exception_113;
          } else {
            const newest_instance = t_reference_stacks[func_varname].pop();
            consolelog("^^^ check_mutatedSnapshot POP", newest_instance);
            if (typeof newest_instance === "undefined") {
              t_param_check_func.newFail();
              const error_114 = `check_mutatedSnapshot() has no matching entry for check_buildSnapshot('${func_str}', '${var_str}', a_var)`;
              const exception_114 = _consoleError(error_114, "EX@114");
              throw exception_114;
            }
            const { collection_ref, pre_collect_str } = newest_instance;
            const no_cycles = _cycle_loops.decycle(collection_ref);
            const post_collect_str = _fast_json_stable_stringify(no_cycles);

            if (pre_collect_str === post_collect_str) {
              consolelog("^^^ check_mutatedSnapshot EQUAL", pre_collect_str);
            } else {
              const pre_str_quotes = _toStr(pre_collect_str);
              const post_str_quotes = _toStr(post_collect_str);
              const ref_change = `Variable '${var_name}' changed`;
              const pre_shrunk = _shrinkDiffs(pre_str_quotes);
              const post_shrunk = _shrinkDiffs(post_str_quotes);
              const pre_val = `${CZECH_ERROR_INDENT}from ${pre_shrunk}`;
              const post_val = `${CZECH_ERROR_INDENT}  to ${post_shrunk} ${CZECH_ERROR_INDENT}`;
              const the_diffs = _refDiff(pre_collect_str, post_collect_str);
              const error_405 = `${ref_change}${pre_val}${post_val}${the_diffs}`;
              error_mess = _consoleError(error_405, "ME@405");
            }
          }
          const no_cycles_stacks = _cycle_loops.decycle(t_reference_stacks);
          const ref_stacks_str = _fast_json_stable_stringify(no_cycles_stacks);
          last_shape_method = [var_name, MESS_MUTATED];
          consolelog("^^^ check_mutatedSnapshot EXIT", error_mess, var_name, ref_stacks_str);
          return error_mess;
        }
      }

      function isActive() {
        return t_do_param_checking;
      }

      function isPruned() {
        return false;
      }

      /*

some command line stests


 { 
        const an_array = [ {a:5}, {a:6}];
        const sig_type = {a:'number'};
        const err_type = type_czech.checkArray_objType0n(an_array, sig_type);
    
        console.log(an_array, sig_type, err_type)
      
    
       }


       
 { 
        const an_array = [ {a:5}, {b:6}];
        const sig_type = {a:'number'};
        const err_type = type_czech.checkArray_objType0n(an_array, sig_type);
    
        console.log(an_array, sig_type, err_type)
      
    
       }


      */

      // empty object?????
      function _checkArray_objType(array_of_objects, obj_type_sig) {
        consolelog("^^^ _checkArray_objType ENTER", array_of_objects, obj_type_sig, TYPE_CZECH_current_test_number);
        if (!typeIsA(obj_type_sig, "object")) {
          return "not an object signature in _checkArray_objType = " + obj_type_sig;
        }
        const num_objects = array_of_objects.length;
        const array_types_signature = Array(num_objects).fill(obj_type_sig);
        //        const array_issue = checkParam_type(array_of_objects, array_types_signature);

        // so here we can overwrite the checkParam_type as below
        const array_issue = checkParam_type(array_of_objects, array_types_signature, MESS_TYPE_OBJ_ARRAY);
        consolelog("^^^ _checkArray_objType EXIT", array_issue);
        return array_issue;
      }

      function checkArray_objType0n(array_of_obj_0_n, obj_type_sig) {
        consolelog("^^^ checkArray_objType0n ENTER", array_of_obj_0_n, obj_type_sig, TYPE_CZECH_current_test_number);
        if (!Array.isArray(array_of_obj_0_n)) {
          return "not an object signature in checkArray_objType0n" + obj_type_sig;
        } else if (array_of_obj_0_n.length === 0) {
          return;
        }
        const array_issue_0_n = _checkArray_objType(array_of_obj_0_n, obj_type_sig);
        consolelog("^^^ checkArray_objType0n EXIT", array_issue_0_n);
        return array_issue_0_n;
      }

      function checkArray_objType1n(array_of_obj_1_n, obj_type_sig) {
        consolelog("^^^ checkArray_objType1n ENTER", array_of_obj_1_n, obj_type_sig, TYPE_CZECH_current_test_number);
        if (!Array.isArray(array_of_obj_1_n)) {
          return "not an array in checkArray_objType1n";
        } else if (array_of_obj_1_n.length === 0) {
          return "array is empty in checkArray_objType1n";
        }
        const array_issue_1_n = _checkArray_objType(array_of_obj_1_n, obj_type_sig);
        consolelog("^^^ checkArray_objType1n EXIT", array_issue_1_n);
        return array_issue_1_n;
      }
      ////////////////////////
      // empty object?????
      function _checkArray_objEmpty(array_of_objects, obj_empty_sig) {
        consolelog("^^^ _checkArray_objEmpty ENTER", array_of_objects, obj_empty_sig, TYPE_CZECH_current_test_number);
        if (!typeIsA(obj_empty_sig, "object")) {
          return "not an array in _checkArray_objEmpty";
        }
        const num_objects = array_of_objects.length;
        const array_empties_signature = Array(num_objects).fill(obj_empty_sig);
        const array_issue = checkParam_empty(array_of_objects, array_empties_signature, MESS_EMPTY_OBJ_ARRAY);
        consolelog("^^^ _checkArray_objEmpty EXIT", array_issue);
        return array_issue;
      }

      function checkArray_objEmpty0n(array_of_obj_0_n, obj_empty_sig) {
        consolelog("^^^ checkArray_objEmpty0n ENTER", array_of_obj_0_n, obj_empty_sig, TYPE_CZECH_current_test_number);
        if (!Array.isArray(array_of_obj_0_n)) {
          return "not an array in checkArray_objEmpty0n";
        } else if (array_of_obj_0_n.length === 0) {
          return;
        }
        const array_issue_0_n = _checkArray_objEmpty(array_of_obj_0_n, obj_empty_sig);
        consolelog("^^^ checkArray_objEmpty0n EXIT", array_issue_0_n);
        return array_issue_0_n;
      }

      function checkArray_objEmpty1n(array_of_obj_1_n, obj_empty_sig) {
        consolelog("^^^ checkArray_objEmpty1n ENTER", array_of_obj_1_n, obj_empty_sig, TYPE_CZECH_current_test_number);
        if (!Array.isArray(array_of_obj_1_n)) {
          return "not an array in checkArray_objEmpty1n";
        } else if (array_of_obj_1_n.length === 0) {
          return "array is empty in checkArray_objEmpty1n";
        }
        const array_issue_1_n = _checkArray_objEmpty(array_of_obj_1_n, obj_empty_sig);
        consolelog("^^^ checkArray_objEmpty1n EXIT", array_issue_1_n);
        return array_issue_1_n;
      }

      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
      // /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

      // This is where TypeCzech starts executing

      // eslint-disable-next-line no-unused-vars
      const parameter_settings = _specParameters(the_parameters);

      if (t_check_events) {
        t_param_check_func = _ParametersCheck(t_check_events);
      } else {
        t_param_check_func = _ParametersCheck(false);
      }
      consolelog("^^^ TypeCzech SETTINGS", parameter_settings);

      return {
        // START debugging access to internal functions, do not use
        _ParametersCheck, // The function that links functions/classes/objects to their PRE_check() and POST_check() functions

        _anObjectsType,
        _arrayOfOneShape,
        _arrayOfOneType,
        _aTypeOf,
        _canBeEmpty,

        _checkArray_objType,
        _checkArray_objEmpty,

        _className,
        _collectionToStr,
        _coloredConsole,
        _consoleError,
        _doEitherEmpty,
        _doEitherShape,
        _doubleToSingleQuotes,
        _eitherChecks,
        _emptyArrayInArray,
        _emptyArrayTypes,
        _emptyCheck,
        _emptyCollectionTypes,
        _emptyContainer,
        _emptyError,
        _emptyErrorMess,
        _emptyKeysChecked,
        _emptyScalar,
        _emptyVariable,
        _errorClassName,
        _functionName,
        _getParameters,
        _isAClass,
        _isArgumentsObject,
        _isBuiltInClass,
        _isCollection,
        _isEmpty,
        _isScalar,
        _isaTypeOf,
        _isPlainJsType,
        _jsonStr,
        _looksLikeType,
        _missingKey,
        _mutateStacks,
        _refDiff,
        _shapeArrayTypes,
        _shapeCollectionTypes,
        _shapeContainer,
        _shapeErrorMess,
        _shapePropertyType,
        _shapeScalar,
        _shapeVariable,
        _shortToLongEmpty,
        _shrinkDiffs,
        _specParameters,
        _stringifyReplacer,
        _toStr,
        _twoArrays,
        _typeFromArray,
        _wrongType,

        _cycle_loops, //                https://github.com/douglascrockford/JSON-js/blob/master/cycle.js
        _fast_json_stable_stringify, // https://github.com/epoberezkin/fast-json-stable-stringify

        // END debugging access to internal functions, do not use

        // START public usable functions
        TYPE_CHECK_NOP,
        TYPE_CZECH_EVENTS,

        check_assert, // type_czech.check_assert(  type_czech.checkParam_typeEither(str_or_num, ['number', 'string'])  , 'strOrNumAPI', str_or_num)
        check_buildSnapshot, //   type_czech.check_buildSnapshot('yourFunc', 'your_array', [1,2,3]);
        check_interface, // check_error = type_czech.check_interface({log:x=>x, show:y=>y}, {log:'function', show:'function'});
        check_mutatedSnapshot, // check_error = type_czech.check_mutatedSnapshot('Person-Obj-Arr', 'a_person');

        checkArgs_emptyEach, // check_error = type_czech.checkArgs_emptyEach(arguments, 'EMPTY-ERROR');
        checkArgs_typeEach, // check_error = type_czech.checkArgs_typeEach(arguments, 'string');

        checkParam_empty, //         check_error = type_czech.checkParam_empty(param_1, 'EMPTY-ERROR');
        checkParam_emptyEither, //   check_error = type_czech.checkParam_emptyEither(param_1, ['EMPTY-ERROR', 'EMPTY-OK']);
        checkParam_emptyExtra, //    check_error = type_czech.checkParam_emptyExtra(param_1, 'EMPTY-ERROR');

        checkParam_type, //         check_error = type_czech.checkParam_type(param_1, 'number');
        checkParam_typeEither, //   check_error = type_czech.checkParam_typeEither(param_1, ['number', 'string']);
        checkParam_typeExtra, //    check_error = type_czech.checkParam_typeExtra(param_1, 'number');

        checkArray_objType0n, //    check_error = type_czech.checkArray_objType0n([], {a:'number'});
        checkArray_objType1n, //    check_error = type_czech.checkArray_objType1n([{a:1},{a:2},{a:3}], {a:'number'});

        checkArray_objEmpty0n, //    check_error = type_czech.checkArray_objEmpty0n([], {a:'EMPTY-ERROR'});
        checkArray_objEmpty1n, //    check_error = type_czech.checkArray_objEmpty1n([{a:'a'},{a:'b'},{a:'c'}], {a:'EMPTY-ERROR'});

        countFails, // type_czech.countFails();
        countTally, // type_czech.countTally();
        countZero, // type_czech.countZero();

        enableTests, //  type_czech.enableTests();
        debugSignature, // console.log(type_czech.debugSignature(COMPLEX_SIGNATURE))
        disableTests, // type_czech.disableTests();

        isActive, // if(type_czech.isActive())
        isPruned, // if(type_czech.isPruned())
        linkUp, //   yourFunc = type_czech.linkUp(yourFunc, checkingFunc);

        isNode, // true if in Node.js environment
        isBrowser, // true if in browser environment
        deClassify,
        typeFinal, //  type_final = type_czech.typeFinal(document); // HTMLDocument
        typeIsA, //    if (type_czech.typeIsA(document, 'Node')) {};
        typeProtos, // type_protos = type_czech.typeProtos(window);  // [ "Window", "EventTarget", "EventTarget", "object" ]
      };
    } // _TypeCzech()
  };
})(the_exports);

module.exports.the_exports; // for CJS for NodeJs