@lumjs/core 1.25.1 → 1.25.2

package/lib/traits.js

@@ -9,9 +9,9 @@ const getProp = require('./obj/getproperty');
 
 const 
 {
-  def,F,B,
+  def,F,B,S,
   isObj,isArray,isConstructor,isProperty,
-  needObj,
+  needObj,needType,
 } = require('./types');
 
 // Symbol for private storage of composed traits.
@@ -693,10 +693,64 @@ class CoreTrait
 
 } // CoreTrait class
 
+/**
+ * Build a Trait registry.
+ * 
+ * @param {object} registry - Object for the registry.
+ * 
+ * Generally the `exports` from a Node.js module would be good here.
+ * 
+ * It will have a `Trait` property added, which is an alias to
+ * the `Trait` class constructor.
+ * 
+ * It will also have a `registerTrait(name, value)` function added.
+ * This function will add new traits to the registry, using
+ * the `name` as its property key. The `value` is either the
+ * Trait sub-class constructor `function` itself, or a _lazy-loading_
+ * closure `function` that must load and return the actual sub-class
+ * constructor when executed. The registry DOES NOT support `object`
+ * type traits, or any class that doesn't extend the `Trait` class.
+ * 
+ * @returns {function} The `registerTrait()` function created above.
+ * @alias module:@lumjs/core/traits.makeRegistry
+ */
+function makeTraitRegistry(registry)
+{
+  needObj(registry, false, 'invalid trait registry object');
+
+  def(registry, 'Trait', CoreTrait);
+
+  function registerTrait(name, value)
+  {
+    needType(S, name,  'invalid trait name');
+    needType(F, value, 'invalid trait loader value');
+
+    if (registry[name] !== undefined)
+    {
+      console.error("trait already registered", {name,value,registry});
+      return;
+    }
+
+    if (CoreTrait.isPrototypeOf(value))
+    { // Make it available directly.
+      def(registry, name, value, def.e);
+    }
+    else
+    { // Lazy-loading engaged.
+      def.lazy(registry, name, value, def.e);
+    }
+  }
+
+  def(registry, 'registerTrait', registerTrait);
+
+  return registerTrait;
+}
+
 module.exports = 
 {
   compose, composeFully, getComposed, decompose,
   Trait: CoreTrait, IGNORE_STATIC, ensureProto,
+  makeRegistry: makeTraitRegistry,
 
   // Undocumented:
   hasOwn,

package/package.json

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