4.1.0

package.json

@@ -1,45 +1,41 @@
 {
-  "name": "@angular-package/library",
-  "version": "1.0.0",
+  "name": "library",
+  "version": "0.0.0",
   "scripts": {
     "ng": "ng",
     "start": "ng serve",
-    "build": "ng build type --prod",
-    "test": "ng test",
-    "lint": "ng lint"
+    "build": "ng build",
+    "watch": "ng build --watch --configuration development",
+    "test": "ng test"
   },
   "private": true,
   "dependencies": {
-    "@angular/animations": "~11.2.8",
-    "@angular/common": "~11.2.8",
-    "@angular/compiler": "~11.2.8",
-    "@angular/core": "~11.2.8",
-    "@angular/forms": "~11.2.8",
-    "@angular/platform-browser": "~11.2.8",
-    "@angular/platform-browser-dynamic": "~11.2.8",
-    "@angular/router": "~11.2.8",
+    "@angular/animations": "~12.0.1",
+    "@angular/common": "~12.0.1",
+    "@angular/compiler": "~12.0.1",
+    "@angular/core": "~12.0.1",
+    "@angular/forms": "~12.0.1",
+    "@angular/platform-browser": "~12.0.1",
+    "@angular/platform-browser-dynamic": "~12.0.1",
+    "@angular/router": "~12.0.1",
     "rxjs": "~6.6.0",
-    "tslib": "^2.0.0",
-    "zone.js": "~0.11.3"
+    "tslib": "^2.1.0",
+    "zone.js": "~0.11.4"
   },
   "devDependencies": {
-    "@angular-devkit/build-angular": "~0.1102.7",
-    "@angular/cli": "~11.2.7",
-    "@angular/compiler-cli": "~11.2.8",
+    "@angular-devkit/build-angular": "~12.0.1",
+    "@angular/cli": "~12.0.1",
+    "@angular/compiler-cli": "~12.0.1",
     "@types/jasmine": "~3.6.0",
     "@types/node": "^12.11.1",
-    "codelyzer": "^6.0.0",
-    "jasmine-core": "~3.6.0",
-    "jasmine-spec-reporter": "~5.0.0",
-    "karma": "~6.1.0",
+    "ajv": "^6.12.6",
+    "jasmine-core": "~3.7.0",
+    "karma": "~6.3.0",
     "karma-chrome-launcher": "~3.1.0",
     "karma-coverage": "~2.0.3",
     "karma-jasmine": "~4.0.0",
     "karma-jasmine-html-reporter": "^1.5.0",
-    "ng-packagr": "^11.0.0",
-    "protractor": "~7.0.0",
-    "ts-node": "~8.3.0",
-    "tslint": "~6.1.0",
-    "typescript": "~4.1.5"
+    "ng-packagr": "^12.0.0",
+    "typescript": "~4.2.3"
   }
 }

packages/type/src/guard/index.ts

@@ -13,6 +13,7 @@ export { guardNumber } from './lib/guard-number.func';
 export { guardNull } from './lib/guard-null.func';
 export { guardObject } from './lib/guard-object.func';
 export { guardObjectKey } from './lib/guard-object-key.func';
+export { guardObjectKeys } from './lib/guard-object-keys.func';
 export { guardPrimitive } from './lib/guard-primitive.func';
 export { guardString } from './lib/guard-string.func';
 export { guardSymbol } from './lib/guard-symbol.func';

packages/type/src/guard/interface/guard-is.interface.ts

@@ -8,6 +8,7 @@ import { GuardKey } from '../type/guard-key.type';
 import { GuardNumber } from '../type/guard-number.type';
 import { GuardObject } from '../type/guard-object.type';
 import { GuardObjectKey } from '../type/guard-object-key.type';
+import { GuardObjectKeys } from '../type/guard-object-keys.type';
 import { GuardPrimitive } from '../type/guard-primitive.type';
 import { GuardString } from '../type/guard-string.type';
 import { GuardType } from '../type/guard-type.type';
@@ -29,6 +30,7 @@ export interface GuardIs {
   number: GuardNumber;
   object: GuardObject;
   objectKey: GuardObjectKey;
+  objectKeys: GuardObjectKeys,
   primitive: GuardPrimitive;
   string: GuardString;
   symbol: GuardSymbol;

packages/type/src/guard/lib/guard-array.func.ts

@@ -6,7 +6,7 @@ import { ResultCallback } from '../../type/result-callback.type';
 /**
  * Guard the `value` to be an `Array` of a generic `Type`.
  * @param value A generic `Type` `Array` `value` to guard.
- * @param callback Optional `ResultCallback` function to handle result before returns.
+ * @param callback An optional `ResultCallback` function to handle result before returns.
  * @returns A `boolean` indicating whether or not the `value` is an `Array` of a generic `Type`.
  */
 export const guardArray: GuardArray = <Type>(value: Array<Type>, callback?: ResultCallback): value is Array<Type> =>

packages/type/src/guard/lib/guard-boolean.func.ts

@@ -6,7 +6,7 @@ import { GuardBoolean } from '../type/guard-boolean.type';
 import { ResultCallback } from '../../type/result-callback.type';
 /**
  * Guard the `value` to be any type of a boolean.
- * @param value An `AnyBoolean` type `value` to guard.
+ * @param value An `AnyBoolean` type from the `value` to guard.
  * @param callback An optional `ResultCallback` function to handle result before returns.
  * @returns A `boolean` indicating whether or not the `value` is a `boolean` type or `Boolean` object.
  */

packages/type/src/guard/lib/guard-class.func.ts

@@ -5,9 +5,9 @@ import { GuardClass } from '../type/guard-class.type';
 import { ResultCallback } from '../../type/result-callback.type';
 /**
  * Guard the `value` to be a generic `Class` type of `class`.
- * @param value A generic `Class` type `value` to guard.
+ * @param value A generic `Class` type from the `value` to guard.
  * @param callback An Optional `ResultCallback` function to handle result before returns.
  * @returns A `boolean` indicating whether or not the `value` is a generic `class`.
  */
-export const guardClass: GuardClass = <Class>(value: Class, callback?: ResultCallback): value is Class =>
+export const guardClass: GuardClass = <Class extends Function>(value: Class, callback?: ResultCallback): value is Class =>
   isClass<Class>(value, callback);

packages/type/src/guard/lib/guard-defined.func.ts

@@ -5,10 +5,10 @@ import { Defined } from '../../type/defined.type';
 import { GuardDefined } from '../type/guard-defined.type';
 import { ResultCallback } from '../../type/result-callback.type';
 /**
- * Guard the `value` to be defined.
- * @param value A generic type `value` to guard.
+ * Guard the `value` to be defined, not `undefined`.
+ * @param value A generic `Type` type from the `value` to guard.
  * @param callback An optional `ResultCallback` function to handle result before returns.
  * @returns A `boolean` indicating whether or not the `value` is defined, if `undefined` then returns `never`.
  */
-export const guardDefined: GuardDefined = <Type>(value: Type, callback?: ResultCallback): value is Defined<Type> =>
+export const guardDefined: GuardDefined = <Type>(value: Defined<Type>, callback?: ResultCallback): value is Defined<Type> =>
   isDefined(value, callback);

packages/type/src/guard/lib/guard-instance.func.ts

@@ -11,5 +11,5 @@ import { ResultCallback } from '../../type/result-callback.type';
  * @param callback Optional `ResultCallback` function to handle result before returns.
  * @returns A `boolean` indicating whether or not the `value` is a `symbol`.
  */
-export const guardInstance: GuardInstance = <Obj>(value: Obj, instance: Constructor<Obj>, callback?: ResultCallback): value is Obj =>
+export const guardInstance: GuardInstance = <Obj extends object>(value: Obj, instance: Constructor<Obj>, callback?: ResultCallback): value is Obj =>
   isInstance<Obj>(value, instance, callback);

packages/type/src/guard/lib/guard-is.object.ts

@@ -11,6 +11,7 @@ import { guardNull } from './guard-null.func';
 import { guardNumber } from './guard-number.func';
 import { guardObject } from './guard-object.func';
 import { guardObjectKey } from './guard-object-key.func';
+import { guardObjectKeys } from './guard-object-keys.func';
 import { guardPrimitive } from './guard-primitive.func';
 import { guardString } from './guard-string.func';
 import { guardSymbol } from './guard-symbol.func';
@@ -32,6 +33,7 @@ export const guardIs: GuardIs = {
   number: guardNumber,
   object: guardObject,
   objectKey: guardObjectKey,
+  objectKeys: guardObjectKeys,
   primitive: guardPrimitive,
   string: guardString,
   symbol: guardSymbol,

packages/type/src/guard/lib/guard-object-key.func.ts

@@ -11,5 +11,5 @@ import { ResultCallback } from '../../type/result-callback.type';
  * @returns A `boolean` indicating whether or not the `value` is an `object` of a generic `Obj` containing the `key`.
  */
 export const guardObjectKey: GuardObjectKey =
-  <Obj>(value: Obj, key: keyof Obj | (keyof Obj)[], callback?: ResultCallback): value is Obj =>
+  <Obj extends object>(value: Obj, key: keyof Obj | (keyof Obj)[], callback?: ResultCallback): value is Obj =>
     isObjectKey<Obj>(value, key, callback);

packages/type/src/guard/lib/guard-object-keys.func.ts

@@ -0,0 +1,13 @@
+// Function.
+import { isObjectKeys } from '../../is/lib/is-object-keys.func';
+// Type.
+import { GuardObjectKeys } from '../type/guard-object-keys.type';
+/**
+ * Guard the value to be an `object` of a generic `Type` with some of its own specified `keys`.
+ * @param value A generic `Obj` type `value` that contains the `keys` to guard.
+ * @param keys A rest parameter single key of `Obj` or an array of keys of `Obj`, as the name of the property that the `value` contains.
+ * @returns A `boolean` indicating whether or not the `value` is an `object` with some of its own specified `keys`.
+ */
+export const guardObjectKeys: GuardObjectKeys =
+  <Obj extends object>(value: Obj, ...keys: (keyof Obj | Array<keyof Obj>)[]): value is Obj =>
+    isObjectKeys<Obj>(value, ...keys);

packages/type/src/guard/lib/guard-object.func.ts

@@ -9,5 +9,5 @@ import { ResultCallback } from '../../type/result-callback.type';
  * @param callback An optional `ResultCallback` function to handle result before returns.
  * @returns A `boolean` indicating whether or not the `value` is an `object` of a generic `Obj`.
  */
-export const guardObject: GuardObject = <Obj>(value: Obj, callback?: ResultCallback): value is Obj =>
+export const guardObject: GuardObject = <Obj extends object>(value: Obj, callback?: ResultCallback): value is Obj =>
   isObject<Obj>(value, callback);

packages/type/src/guard/test/guard-array.spec.ts

@@ -14,10 +14,12 @@ import {
   ARRAY_SYMBOL_NUMBER,
   ARRAY_SYMBOL_STRING,
   ARRAY_UNDEFINED
-} from './variables/array.const';
-import { Class } from './variables/class.const';
+} from '../../testing/variables/strict/array.const';
+import { Class } from '../../testing/variables/strict/class.const';
+// Type.
 import { Func } from '../../type/func.type';
-import { ObjectOne, ObjectTwo } from './variables/object.const';
+// Interface.
+import { ObjectOne, ObjectTwo } from '../../testing/interface';
 
 describe(guardArray.name, () => {
   // TRUE
@@ -40,5 +42,5 @@ describe(guardArray.name, () => {
     expect(guardArray<symbol>(ARRAY_SYMBOL_STRING)).toBeTruthy();
     expect(guardArray<symbol>(ARRAY_SYMBOL_NUMBER)).toBeTruthy();
   });
-  it('Array<undefined>', () => expect(guardArray<undefined>(ARRAY_UNDEFINED)).toBeTruthy());
+  it('Array<undefined>', () => expect(guardArray<undefined | unknown>(ARRAY_UNDEFINED)).toBeTruthy());
 });

packages/type/src/guard/test/guard-bigint.spec.ts

@@ -1,8 +1,8 @@
 // Function.
 import { guardBigInt } from '../lib/guard-big-int.func';
 // Variables.
-import { BIGINT, BIGINT_EXPECTATION, BIGINT_INSTANCE } from './variables/big-int.const';
-import { TRUE } from './variables/boolean.const';
+import { BIGINT, BIGINT_EXPECTATION, BIGINT_INSTANCE } from '../../testing/variables/strict/big-int.const';
+import { TRUE } from '../../testing/variables/strict/boolean.const';
 
 describe(guardBigInt.name, () => {
   // Defined.

packages/type/src/guard/test/guard-boolean.spec.ts

@@ -1,7 +1,7 @@
 // Function.
 import { guardBoolean } from '../lib/guard-boolean.func';
 // Variables.
-import { FALSE_EXPECTATION, TRUE, TRUE_EXPECTATION, FALSE, TRUE_INSTANCE, FALSE_INSTANCE } from './variables/boolean.const';
+import { FALSE_EXPECTATION, TRUE, TRUE_EXPECTATION, FALSE, TRUE_INSTANCE, FALSE_INSTANCE } from '../../testing/variables/strict/boolean.const';
 
 describe(guardBoolean.name, () => {
   // Defined.

packages/type/src/guard/test/guard-class.spec.ts

@@ -1,9 +1,10 @@
+// Object.
+import { guard } from '../lib/guard.object';
 // Function.
 import { guardClass } from '../lib/guard-class.func';
 // Variables.
-import { Person } from './variables/class.const';
-import { TRUE } from './variables/boolean.const';
-import { guard } from '../lib/guard.object';
+import { Person } from '../../testing/variables/strict/class.const';
+import { TRUE } from '../../testing/variables/strict/boolean.const';
 
 describe(guardClass.name, () => {
   // TRUE

packages/type/src/guard/test/guard-defined.spec.ts

@@ -1,8 +1,8 @@
 // Function.
 import { guardDefined } from '../lib/guard-defined.func';
 // Variables.
-import { FALSE } from './variables/boolean.const';
-import { UNDEFINED } from './variables/undefined.const';
+import { STRING } from '../../testing/variables/strict/string.const';
+import { TRUE } from '../../testing/variables/strict/boolean.const';
 
 describe(guardDefined.name, () => {
   // Defined.
@@ -11,13 +11,11 @@ describe(guardDefined.name, () => {
   // Checks ...
   describe(`guards`, () => {
     it('callback', () => {
-      guardDefined(UNDEFINED, (result: boolean, value: undefined) => {
-        expect(result).toBe(FALSE);
-        expect(value).toBeUndefined();
+      guardDefined(STRING, (result: boolean, value: any) => {
+        expect(result).toBe(TRUE);
+        expect(value).toEqual(STRING);
         return result;
       });
     });
-    // ... primitives.
-    describe(`primitive`, () => it(`${UNDEFINED}`, () => expect(guardDefined(UNDEFINED)).toEqual(FALSE)));
   });
 });

packages/type/src/guard/test/guard-function.spec.ts

@@ -1,7 +1,7 @@
 // Function.
 import { guardFunction } from '../lib/guard-function.func';
 // Variables.
-import { FUNCTION } from '../../is/test/variables/function.const';
+import { FUNCTION } from '../../testing/variables/function.const';
 
 describe(guardFunction.name, () => {
   // TRUE

packages/type/src/guard/test/guard-instance.spec.ts

@@ -1,13 +1,13 @@
 // Function.
 import { guardInstance } from '../lib/guard-instance.func';
 // Variables.
-import { CLASS, Class } from './variables/class.const';
-import { FALSE_EXPECTATION, TRUE_EXPECTATION } from './variables/boolean.const';
-import { NUMBER } from './variables/number.const';
-import { NUMBER_INSTANCE, NUMBER_NEW_INSTANCE } from './variables/number.const';
-import { STRING } from './variables/string.const';
-import { STRING_INSTANCE, STRING_NEW_INSTANCE } from './variables/string.const';
-import { TRUE, TRUE_INSTANCE, FALSE_INSTANCE, FALSE } from './variables/boolean.const';
+import { CLASS, Class } from '../../testing/variables/strict/class.const';
+import { FALSE_EXPECTATION, TRUE_EXPECTATION } from '../../testing/variables/strict/boolean.const';
+import { NUMBER } from '../../testing/variables/strict/number.const';
+import { NUMBER_INSTANCE, NUMBER_NEW_INSTANCE } from '../../testing/variables/strict/number.const';
+import { STRING } from '../../testing/variables/strict/string.const';
+import { STRING_INSTANCE, STRING_NEW_INSTANCE } from '../../testing/variables/strict/string.const';
+import { TRUE, TRUE_INSTANCE, FALSE_INSTANCE, FALSE } from '../../testing/variables/strict/boolean.const';
 
 describe(guardInstance.name , () => {
   // Defined.

packages/type/src/guard/test/guard-key.spec.ts

@@ -1,10 +1,10 @@
 // Function.
 import { guardKey } from '../lib/guard-key.func';
 // Variables.
-import { NUMBER } from './variables/number.const';
-import { STRING} from './variables/string.const';
-import { SYMBOL_NUMBER, SYMBOL_STRING } from './variables/symbol.const';
-import { TRUE } from './variables/boolean.const';
+import { NUMBER } from '../../testing/variables/strict/number.const';
+import { STRING} from '../../testing/variables/strict/string.const';
+import { SYMBOL_NUMBER, SYMBOL_STRING } from '../../testing/variables/strict/symbol.const';
+import { TRUE } from '../../testing/variables/strict/boolean.const';
 // Type.
 import { Key } from '../../type/key.type';
 

packages/type/src/guard/test/guard-null.spec.ts

@@ -1,8 +1,8 @@
 // Function.
 import { guardNull } from '../lib/guard-null.func';
 // Variables.
-import { NULL } from './variables/null.const';
-import { TRUE } from './variables/boolean.const';
+import { NULL } from '../../testing/variables/strict/null.const';
+import { TRUE } from '../../testing/variables/strict/boolean.const';
 
 describe(guardNull.name, () => {
   // Defined.

packages/type/src/guard/test/guard-number.spec.ts

@@ -1,8 +1,8 @@
 // Function.
 import { guardNumber } from '../lib/guard-number.func';
 // Variables.
-import { NUMBER, NUMBER_INSTANCE, NUMBER_NEW_INSTANCE } from './variables/number.const';
-import { TRUE } from './variables/boolean.const';
+import { NUMBER } from '../../testing/variables/strict/number.const';
+import { TRUE } from '../../testing/variables/strict/boolean.const';
 
 describe(guardNumber.name, () => {
   // Defined.

packages/type/src/guard/test/guard-object-key.spec.ts

@@ -1,11 +1,11 @@
 // Function.
 import { guardObjectKey } from '../lib/guard-object-key.func';
 // Variables.
-import { CLASS, TEST_CLASS, TestClass } from './variables/class.const';
-import { NUMBER } from './variables/number.const';
-import { OBJECT_ONE } from './variables/object.const';
-import { SYMBOL_NUMBER, SYMBOL_STRING } from './variables/symbol.const';
-import { TRUE, FALSE } from './variables/boolean.const';
+import { CLASS, TEST_CLASS, TestClass } from '../../testing/variables/strict/class.const';
+import { NUMBER } from '../../testing/variables/number.const';
+import { OBJECT_ONE } from '../../testing/variables/object.const';
+import { SYMBOL_NUMBER, SYMBOL_STRING } from '../../testing/variables/strict/symbol.const';
+import { TRUE, FALSE } from '../../testing/variables/strict/boolean.const';
 
 describe(guardObjectKey.name , () => {
   // Defined.