@lumjs/core 1.13.0 → 1.14.0

package/lib/context.js

@@ -6,18 +6,42 @@
  * describing the current JS environment and execution context.
  * 
  * @module @lumjs/core/context
- * @property {boolean} AMD - AMD (*RequireJS*) module loading detected.
- * @property {boolean} CJS - CommonJS environment detected.
+ * @property {boolean} hasDefine - A global `define()` function was found.
  * @property {boolean} hasRequire - A global `require()` function was found.
- * @property {boolean} hasExports - A global `exports` object was found.
+ * @property {boolean} hasExports - A global `exports` variable was found.
  * @property {boolean} hasModule - A global `module` object was found.
- * @property {boolean} isNode - Is likely *Node.js*, *Electron*, etc.
+ * @property {boolean} hasModuleExports - A `module.exports` exists.
+ * @property {boolean} hasSyncedExports - `exports === module.exports`
+ * @property {boolean} isNode - An alias to `Node.ok`.
  * @property {boolean} isBrowser - A web-browser environment detected.
  * @property {boolean} isWindow - Is a browser `Window` context.
  * @property {boolean} isWorker - Is a browser `Worker` (sub-types below.)
  * @property {boolean} isServiceWorker - Is a `ServiceWorker` context.
  * @property {boolean} isDedicatedWorker - Is a `DedicatedWorker` context.
  * @property {boolean} isSharedWorker - Is a `SharedWorker` context.
+ * @property {object} AMD - Asynchronous Module Definition detection.
+ * @property {boolean} AMD.isSupported - The `define.amd` property is set.
+ * @property {boolean} AMD.isRequireJS - A global `requirejs` was found.
+ * @property {object} CJS - CommonJS detection.
+ * @property {boolean} CJS.standard - `hasDefine && hasRequire`
+ * @property {boolean} CJS.nodeLike - `CJS.standard && hasExports`
+ * @property {boolean} CJS.isLumV5 - Lum.js browser bundler detected.
+ * @property {boolean} CJS.isWebpack - Webpack bundler detected.
+ * @property {boolean} CJS.inBrowser - `CJS.isLumV5 || CJS.isWebpack`
+ * @property {object} Node - Node.js detection.
+ * @property {boolean} Node.isSane - `CJS.nodeLike && !CJS.inBrowser`
+ * @property {boolean} Node.hasProcess - A global `process` object exists.
+ * @property {boolean} Node.ok - `Node.isSane && Node.hasProcess`
+ * @property {?string} Node.ver - `process.versions.node ?? null`
+ * @property {?object} Node.versions - `process.versions ?? null`
+ * @property {Array} Node.args - Command line arguments.
+ * @property {string} Node.script - Command line script name.
+ * @property {object} Electron - Electron detection.
+ * @property {boolean} ok - Electron environment detected.
+ * @property {boolean} isDefault - Is this the default app?
+ * @property {boolean} isBundled - Is this a bundled app?
+ * @property {boolean} isMain - Is this the main renderer frame?
+ * @property {?string} type - `process.type`
  * @property {object} root - See {@link module:@lumjs/core/types.root}
  */
 
@@ -28,37 +52,72 @@ const rootHas = what => typeof root[what] !== U;
 const cd = def(ctx, true);
 const CJS = {};
 const AMD = {};
+const Node = {};
+const Elec = {};
 const cjs = def(CJS, true);
 const amd = def(AMD, true);
+const node = def(Node, true);
+const elec = def(Elec, true);
 const isLumV5 = typeof module.$lib === O && module.$lib.$cached === module;
 
 cd('hasDefine', typeof define === F)
   ('hasRequire', typeof require === F)
-  ('hasExports', typeof exports !== U)
+  ('hasExports', typeof exports !== U && isComplex(exports))
   ('hasModule', typeof module === O && module !== null)
-  ('hasModuleExports', isComplex(module.exports))
-  ;
+  ('hasModuleExports', ctx.hasModule && isComplex(module.exports))
+  ('hasSyncedExports', ctx.hasExports && ctx.hasModuleExports 
+    && exports === module.exports)
 
 cjs('standard', ctx.hasModule && ctx.hasRequire)
    ('nodeLike', CJS.standard && ctx.hasExports)
    ('isLumV5', CJS.nodeLike && isLumV5)
    ('isWebpack', CJS.nodeLike && require.resolve === require)
    ('inBrowser', CJS.isLumV5 || CJS.isWebpack)
-   ;
+
+node('isSane', CJS.nodeLike && !CJS.inBrowser)
+    ('hasProcess', typeof process === O && process !== null)
+    ('ok', Node.isSane && Node.hasProcess)
+    ('versions', Node.hasProcess ? process.versions : null)
+    ('ver', Node.hasProcess ? process.versions.node : null)
+    ('args', {get: function()
+    { // Inspired by yargs hideBin() function.
+      if (Node.ok)
+      {
+        const o = (Elec.isBundled) ? 1 : 2;
+        return process.argv.slice(o);
+      }
+      return [];
+    }})
+    ('script', {get: function()
+    { // Inspired by yargs getProcessArgvBin() function.
+      if (Node.ok)
+      {
+        const i = (Elec.isBundled) ? 0 : 1;
+        return process.argv[i];
+      }
+      return '';
+    }})
+
+elec('ok', Node.ok && !!Node.versions.electron)
+    ('isDefault', Elec.ok && !!process.defaultApp)
+    ('isBundled', Elec.ok && !process.defaultApp)
+    ('isMain', Elec.ok && !!process.isMainFrame)
+    ('type', Elec.ok && process.type)
 
 amd('isSupported', ctx.hasDefine && isObj(define.amd))
    ('isRequireJS', AMD.isSupported && typeof requirejs === F)
 
 cd('CJS', CJS)
   ('AMD', AMD)
-  ('isNode', CJS.nodeLike && !CJS.inBrowser)
-  ('isWindow', rootHas('window'))
+  ('Node', Node)
+  ('Electron', Elec)
+  ('isNode', Node.ok)
+  ('isWindow', typeof Window === F && rootHas(window))
   ('isWorker', rootHas('WorkerGlobalScope'))
   ('isServiceWorker', rootHas('ServiceWorkerGlobalScope'))
   ('isDedicatedWorker', rootHas('DedicatedWorkerGlobalScope'))
   ('isSharedWorker', rootHas('SharedWorkerGlobalScope'))
   ('isBrowser', !ctx.isNode && (ctx.isWindow || ctx.isWorker))
-  ;
 
 /**
  * See if a root-level name is defined.

package/package.json

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