@lumjs/core 1.1.0 → 1.2.1

package/docs/changelogs/1.x.md

@@ -6,6 +6,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.1] - 2022-09-05
+### Added
+- `core.InternalObjectId#untag()`
+### Changed
+- Cleaned up the wording in a docblock, and updated a test to use `done()`.
+
+## [1.2.0] - 2022-08-10
+### Added
+- Moved the `array.powerset()` and `array.random()` methods from Lum.js v4 into `core.arrays`.
+- Added a new `core.context.isCommonJS()` method which is only used in certain circumstances.
+
+### Fixed 
+- A typo in one of the `package.json` exports.
+- Commented out a debugging line.
+
+## [1.1.1] - 2022-08-02
+### Fixed
+- A couple missing constants in some functions.
+
 ## [1.1.0] - 2022-07-29
 ### Added
 - `types.doesDescriptorTemplate()` method.
@@ -27,6 +46,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 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 this is replacing.
 
-[Unreleased]: https://github.com/supernovus/lum.core.js/compare/v1.0.0...HEAD
+[Unreleased]: https://github.com/supernovus/lum.core.js/compare/v1.2.1...HEAD
+[1.2.1]: https://github.com/supernovus/lum.core.js/compare/v1.2.0...v1.2.1
+[1.2.0]: https://github.com/supernovus/lum.core.js/compare/v1.1.1...v1.2.0
+[1.1.1]: https://github.com/supernovus/lum.core.js/compare/v1.1.0...v1.1.1
+[1.1.0]: https://github.com/supernovus/lum.core.js/compare/v1.0.0...v1.1.0
 [1.0.0]: https://github.com/supernovus/lum.core.js/releases/tag/v1.0.0
 

package/lib/arrays.js

@@ -76,3 +76,36 @@ function removeItems(array, ...items)
 }
 
 exports.removeItems = removeItems;
+
+/**
+ * Return a Powerset of values in the array.
+ * @param {Array} array  The array to make the powerset from.
+ * @returns {Array}  The powerset.
+ * @alias module:@lumjs/core/arrays.powerset
+ */
+function powerset(array) 
+{
+  var ps = [[]];
+  for (var i=0; i < array.length; i++) 
+  {
+    // we modify the ps array in the next loop,
+    // so can't use the ps.length property directly in the loop condition.
+    var current_length = ps.length;
+    for (var j = 0; j < current_length; j++) 
+    {
+      ps.push(ps[j].concat(array[i]));
+    }
+  }
+  return ps;
+}
+
+/**
+ * Get a random element from an array.
+ * @param {Array} array  The array to get an item from.
+ * @returns {mixed}  The randomly selected item.
+ * @alias module:@lumjs/core/arrays.random
+ */
+function random(array)
+{
+  return array[Math.floor(Math.random()*array.length)];
+}

package/lib/context.js

@@ -28,18 +28,31 @@ const ctx = {root};
 const rootHas = what => typeof root[what] !== U;
 const cd = def(ctx, true);
 
+function isCommonJS(module)
+{
+  if (typeof module !== O || module === null) return false;
+  if (!ctx.hasRequire) return false;
+  if (!isComplex(module.exports)) return false;
+  if (typeof module.$lib === O && typeof module.$lib.$cached === O) 
+    return false; // It's our fake CommonJS emulation layer.
+  // Okay, all tests are okay.
+  return true;
+}
+
 cd('AMD', typeof define === F && define.amd)
   ('hasRequire', typeof require === F)
   ('hasExports', typeof exports !== U)
   ('hasModule', typeof module === O && module !== null)
-  ('CJS', ctx.hasRequire && ctx.hasModule && isComplex(module.exports))
+  ('CJS', isCommonJS(module)) // Detected value at load time in *this* module.
+  ('isCommonJS', isCommonJS)  // Dynamically detect via a module *reference*.
   ('isNode', ctx.CJS && ctx.hasExports)
   ('isWindow', !ctx.CJS && rootHas('window'))
   ('isWorker', !ctx.CJS && rootHas('WorkerGlobalScope'))
   ('isServiceWorker', !ctx.CJS && rootHas('ServiceWorkerGlobalScope'))
   ('isDedicatedWorker', !ctx.CJS && rootHas('DedicatedWorkerGlobalScope'))
   ('isSharedWorker', !ctx.CJS && rootHas('SharedWorkerGlobalScope'))
-  ('isBrowser', ctx.isWindow || ctx.isWorker);
+  ('isBrowser', ctx.isWindow || ctx.isWorker)
+  ;
 
 /**
  * See if a root-level name is defined.

package/lib/obj/getproperty.js

@@ -4,9 +4,9 @@ const {isComplex,isObj} = types;
 /**
  * Get a property descriptor.
  * 
- * This is like `Object.getOwnPropertyDescriptor`, except that method
- * fails if the property is inhereted. This method will travel through
- * the entire prototype chain until it finds the descriptor.
+ * This is like `Object.getOwnPropertyDescriptor`, except unlike 
+ * that method, this will travel through the entire prototype chain 
+ * until it finds the descriptor.
  * 
  * @param {object|function} obj - Object to find a property in.
  * @param {string} prop - Name of the property we want the descriptor of.

package/lib/obj/ns.js

@@ -1,7 +1,8 @@
 // Import required bits here.
 const 
 {
-  B, root, isObj, needObj, def, nonEmptyArray, notNil,
+  B, S,
+  root, isObj, needObj, def, nonEmptyArray, notNil,
   doesDescriptorTemplate,
 } = require('../types');
 
@@ -168,7 +169,7 @@ function setObjectPath(obj, proppath, opts={})
   const nsc = proppath.length;
   const lastns = nsc - 1;
 
-  console.debug("setObjectPath", obj, proppath, opts, nsc, arguments);
+  //console.debug("setObjectPath", obj, proppath, opts, nsc, arguments);
 
   for (let n = 0; n < nsc; n++)
   {

package/lib/objectid.js

@@ -56,6 +56,20 @@ class InternalObjectId
     return def(obj, this.property, val);
   }
 
+  /**
+   * Remove the tag from a tagged object.
+   * 
+   * @param {*} obj 
+   */
+  untag(obj)
+  {
+    if (notNil(obj))
+    {
+      delete(obj[this.property]);
+    }
+    return obj;
+  }
+
   /**
    * Is the specified object tagged with this object id?
    * 

package/lib/opt.js

@@ -3,7 +3,7 @@
  * @module @lumjs/core/opt
  */
 
-const {U,needObj,needType} = require('./types');
+const {U,F,S,needObj,needType} = require('./types');
 
 /**
  * See if a value is *set*, and if not, return a default value.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumjs/core",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "main": "lib/index.js",
   "exports":
   {
@@ -12,7 +12,7 @@
     "./flags": "./lib/flags.js",
     "./obj": "./lib/obj/index.js",
     "./opt": "./lib/opt.js",
-    "./modules": "./lib/moduless.js",
+    "./modules": "./lib/modules.js",
     "./meta": "./lib/meta.js",
     "./enum": "./lib/enum.js",
     "./observable": "./lib/observable.js",

package/test/types.js

@@ -264,5 +264,5 @@ t.dies(function(){types.needType(TYP.O, null); return true}, "!needType('object'
 // TODO: stringify()
 
 // All done.
-t.output();
+t.done();