@lumjs/core 1.5.0 → 1.5.1

package/docs/changelogs/1.x.md

@@ -6,6 +6,13 @@ See [Changelogs](index.md) for more information on the changelogs.
 
 ## [Unreleased]
 
+## [1.5.1] - 2022-09-29
+### Changed
+- Removed `constructor()` from `AbstractClass`.
+- Added `$needs()` to `AbstractClass`.
+### Fixed
+- `AbstractClass` actually works properly now.
+
 ## [1.5.0] - 2022-09-27
 ### Changed
 - Updated a few DocBlocks.
@@ -91,7 +98,8 @@ See [Changelogs](index.md) for more information on the changelogs.
 - See [1.0-beta.md](1.0-beta.md) for the beta versions of `1.0`
 - See [lum.js](https://github.com/supernovus/lum.js) for the original library set this is replacing.
 
-[Unreleased]: https://github.com/supernovus/lum.core.js/compare/v1.5.0...HEAD
+[Unreleased]: https://github.com/supernovus/lum.core.js/compare/v1.5.1...HEAD
+[1.5.1]: https://github.com/supernovus/lum.core.js/compare/v1.5.0...v1.5.1
 [1.5.0]: https://github.com/supernovus/lum.core.js/compare/v1.4.0...v1.5.0
 [1.4.0]: https://github.com/supernovus/lum.core.js/compare/v1.3.1...v1.4.0
 [1.3.1]: https://github.com/supernovus/lum.core.js/compare/v1.3.0...v1.3.1

package/lib/meta.js

@@ -3,6 +3,8 @@
  * @module @lumjs/core/meta
  */
 
+const {F,S,isArray,isa} = require('./types');
+
 /**
  * Get a stacktrace. Differs from browser to browser.
  *
@@ -30,20 +32,71 @@ exports.stacktrace = stacktrace;
 class AbstractClass
 {
   /**
-   * You must override the constructor.
+   * If you want to mark a method as abstract use this.
    */
-  constructor()
+  $abstract(name)
   {
-    const name = this.constructor.name;
-    throw new Error(`Cannot create instance of abstract class ${name}`);
+    if (name.indexOf('(') === -1)
+    { // Add empty method signature.
+      name += '()';
+    }
+    throw new Error(`Abstract method ${name} was not implemented`);
   }
 
   /**
-   * If you want to mark a method as abstract use this.
+   * Check for required properties
+   * 
+   * @param {...(string|Array)} needs - What is needed
+   * 
+   * If this is a `string` it should be in a format like:
+   * 
+   * - `methodName(arg1,arg2,arg3)`
+   * - `anotherMethod(number, string, object) : boolean`
+   * - `yetAnother (className) : resultClass`
+   * 
+   * The names are case sensitive, and we'll look for the method after 
+   * stripping off anything from the first *non-word* character.
+   * 
+   * If this is an `Array`, the first item must be the name of a property,
+   * and each other item should be a type checking value, or array of type 
+   * checking values from the [TYPES]{@link module:@lumjs/core/types.TYPES} 
+   * object, as used by [isa()]{@link module:@lumjs/core/types.isa}.
+   * 
+   * If you are calling this in an abstract class constructor, likely only 
+   * the method checks will be useful, as the `super()` call must be done 
+   * *before* any instance property assignments.
+   * 
    */
-  $abstract(name)
+  $needs(...needs)
   {
-    throw new Error(`Abstract method ${name}() was not implemented`);
+    const className = this.constructor.name;
+
+    const getName = fullName => fullName.replace(/\W.*/, '');
+    const missing = propName => 
+    { 
+      throw new Error(`${className} is missing ${propName}`); 
+    }
+
+    for (const need of needs)
+    {
+      if (typeof need === S)
+      { // A simple method
+        const meth = getName(need);
+        if (typeof this[meth] !== F)
+        {
+          missing(need);
+        }
+      }
+      else if (isArray(need))
+      {
+        const prop = getName(need[0]);
+        const types = need.slice(1);
+        if (!isa(this[prop], ...types))
+        {
+          missing(need);
+        }
+      }
+    }
   }
 
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumjs/core",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "main": "lib/index.js",
   "exports":
   {