@lumjs/core 1.7.0 → 1.7.1

package/lib/index.js

@@ -111,7 +111,7 @@ can('strings');
 can('flags');
 
 /**
- * Functions for manipulating objects
+ * Functions for manipulating objects «Lazy»
  * @name module:@lumjs/core.obj
  * @type {module:@lumjs/core/obj}
  */
@@ -165,12 +165,12 @@ from('objectid', 'randomNumber', 'InternalObjectId');
 from('meta', 'stacktrace', 'AbstractClass', 'Functions', 'NYI');
 
 /**
- * Create a magic *Enum* object
+ * Create a magic *Enum* object «Lazy»
  * @name module:@lumjs/core.Enum
  * @function
  * @see module:@lumjs/core/enum
  */
-can('Enum', {module: 'enum'});
+can('Enum', true);
 
 /**
  * Make an object support the *Observable* API «Lazy»

package/lib/modulebuilder.js

@@ -11,6 +11,9 @@ const clone = require('./obj/copyall').duplicateOne;
 // Methods we want to export in the functional API.
 const BUILD_METHODS = ['has', 'can', 'from', 'set'];
 
+// Fallback locale
+const DLOC = 'en-US';
+
 /**
  * A class to make building modules easier.
  * 
@@ -50,6 +53,16 @@ class ModuleBuilder
    * It's always possible to set the `conf.module` parameter manually as well,
    * which avoids the need to generate a separate parameter name.
    * 
+   * @param {(string|boolean)} [opts.withLocale=false] Use locales?
+   * 
+   * If this is a `string` it's the name of the locale (e.g. `en-US`).
+   * 
+   * If this is `true` we'll use the default locale as determined by
+   * [getLocale()]{@link module:@lumjs/core/strings.getLocale}.
+   * 
+   * If this is `false` we won't use locales (unless the `NESTED_CAMEL`
+   * mode is in use, in which case we'll use the default locale.)
+   * 
    */
   constructor(targetModule, opts={})
   {
@@ -66,14 +79,24 @@ class ModuleBuilder
 
     this.nested = opts.nested ?? ModuleBuilder.NESTED_ERROR;
 
-    this.strings = opts.strings;
-    this.locale = opts.locale;
+    if (opts.withLocale)
+    { // Initialize the strings here.
+      this.withLocale(opts.locale);
+    }
   }
 
   // Get a descriptor for a module export.
   requireDescriptor(name, conf={})
   {
-    if (typeof conf.getter === F || typeof conf.setter === F)
+    if (typeof conf === S)
+    { // A quick shortcut for setting module name.
+      conf = {module: conf};
+    }
+    else if (conf === true)
+    { // Use the lowercase name as the module.
+      conf = {module: this.$lc(name)};
+    }
+    else if (typeof conf.getter === F || typeof conf.setter === F)
     { // It's an accessor-style descriptor already.
       return conf;
     }
@@ -102,6 +125,11 @@ class ModuleBuilder
     return {configurable, enumerable, writable, value};
   }
 
+  $lc(name)
+  {
+    return name.toLocaleLowerCase(this.locale ?? DLOC);
+  }
+ 
   // Normalize a property name.
   $normalizeProperty(name)
   {
@@ -134,16 +162,29 @@ class ModuleBuilder
     return name;
   }
 
-  $normalizeWithCamelCase(names)
+  withLocale(loc)
   {
     if (this.strings === undefined)
-    {
+    { // Load the strings library.
       this.strings = require('./strings');
     }
+
     if (this.locale === undefined)
-    {
-      this.locale = this.strings.getLocale();
+    { // Set the locale.
+      if (typeof loc === S)
+      { // Use an explicitly passed value.
+        this.locale = loc;
+      }
+      else 
+      { // Use the default locale.
+        this.locale = this.strings.getLocale();
+      }
     }
+  }
+
+  $normalizeWithCamelCase(names)
+  {
+    this.withLocale();
     let name = names.shift().toLocaleLowerCase(this.locale);
     for (const path in names)
     {
@@ -157,7 +198,14 @@ class ModuleBuilder
    * 
    * @param {string} name - The property name to export.
    *
-   * @param {object} [conf] Additional export configuration options.
+   * @param {(object|string|true)} [conf] Additional export configuration options.
+   * 
+   * If this is a `string` instead of an `object`, it's assumed to be the
+   * `conf.module` value.
+   * 
+   * If this is `true` then the `conf` will be set with `module` being the
+   * lowercase version of `name`.
+   * 
    * @param {string} [conf.module=`./${name}`] The module to `require()`.
    * @param {string} [conf.prop] If set, we want an exported property
    * of this name from the loaded module.
@@ -193,7 +241,7 @@ class ModuleBuilder
    * @param {object} [conf] Additional export configuration options.
    * 
    * In addition to all the options supported by 
-   * [has()]{@link module:@lumjs/core/modules.has}
+   * [has()]{@link module:@lumjs/core/modules#has}
    * this also supports one further option.
    * 
    * @param {object} [conf.lazy] Advanced options for the `lazy()` call.

package/package.json

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