context 3.0.3 → 3.0.5-dev-405df5

package/README.md

@@ -1,4 +1,6 @@
-# Context
+# Context 🪆
+
+[![Join Discord](https://badgen.net/discord/online-members/WmADZpJnSe?icon=discord&label=Discord)](https://discord.gg/WmADZpJnSe) [![Version](https://badgen.net/npm/v/vest?&icon=npm)](https://www.npmjs.com/package/context) [![Downloads](https://badgen.net/npm/dt/context?label=Downloads)](https://www.npmjs.com/package/context) [![bundlephobia](https://badgen.net/bundlephobia/minzip/context)](https://bundlephobia.com/package/context) [![Status](https://badgen.net/github/status/ealush/vest)](https://github.com/ealush/vest/actions)
 
 Simple utility for context propagation within Javascript applications and libraries. Loosely based on the ideas behind React's context, allows you to achieve the same goals (and more) without actually using react.
 It allows you to keep reference for shared variables, and access them down in your function call even if not declared in the same scope.

package/dist/cjs/context.development.js

@@ -4,14 +4,17 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var vestUtils = require('vest-utils');
 
-var USEX_DEFAULT_ERROR_MESSAGE = 'Not inside of a running context.';
-var EMPTY_CONTEXT = Symbol();
+const USEX_DEFAULT_ERROR_MESSAGE = 'Not inside of a running context.';
+const EMPTY_CONTEXT = Symbol();
+/**
+ * Base context interface.
+ */
 function createContext(defaultContextValue) {
-    var contextValue = EMPTY_CONTEXT;
+    let contextValue = EMPTY_CONTEXT;
     return {
-        run: run,
-        use: use,
-        useX: useX
+        run,
+        use,
+        useX,
     };
     function use() {
         return (isInsideContext() ? contextValue : defaultContextValue);
@@ -21,9 +24,9 @@ function createContext(defaultContextValue) {
         return contextValue;
     }
     function run(value, cb) {
-        var parentContext = isInsideContext() ? use() : EMPTY_CONTEXT;
+        const parentContext = isInsideContext() ? use() : EMPTY_CONTEXT;
         contextValue = value;
-        var res = cb();
+        const res = cb();
         contextValue = parentContext;
         return res;
     }
@@ -31,28 +34,28 @@ function createContext(defaultContextValue) {
         return contextValue !== EMPTY_CONTEXT;
     }
 }
+/**
+ * Cascading context - another implementation of context, that assumes the context value is an object.
+ * When nesting context runs, the the values of the current layer merges with the layers above it.
+ */
 function createCascade(init) {
-    var ctx = createContext();
+    const ctx = createContext();
     return {
-        bind: bind,
-        run: run,
+        bind,
+        run,
         use: ctx.use,
-        useX: ctx.useX
+        useX: ctx.useX,
     };
     function run(value, fn) {
         var _a;
-        var parentContext = ctx.use();
-        var out = vestUtils.assign({}, parentContext ? parentContext : {}, (_a = vestUtils.optionalFunctionValue(init, value, parentContext)) !== null && _a !== void 0 ? _a : value);
+        const parentContext = ctx.use();
+        const out = vestUtils.assign({}, parentContext ? parentContext : {}, (_a = vestUtils.optionalFunctionValue(init, value, parentContext)) !== null && _a !== void 0 ? _a : value);
         return ctx.run(Object.freeze(out), fn);
     }
     function bind(value, fn) {
-        return function () {
-            var runTimeArgs = [];
-            for (var _i = 0; _i < arguments.length; _i++) {
-                runTimeArgs[_i] = arguments[_i];
-            }
+        return function (...runTimeArgs) {
             return run(value, function () {
-                return fn.apply(void 0, runTimeArgs);
+                return fn(...runTimeArgs);
             });
         };
     }

package/dist/cjs/context.production.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var n=require("vest-utils"),e=Symbol();function r(r){var t=e;return{run:function(n,r){var i=o()?u():e;t=n;var a=r();return t=i,a},use:u,useX:function(e){return n.invariant(o(),n.defaultTo(e,"Not inside of a running context.")),t}};function u(){return o()?t:r}function o(){return t!==e}}exports.createCascade=function(e){var t=r();return{bind:function(n,e){return function(){for(var r=[],t=0;t<arguments.length;t++)r[t]=arguments[t];return u(n,(function(){return e.apply(void 0,r)}))}},run:u,use:t.use,useX:t.useX};function u(r,u){var o,i=t.use(),a=n.assign({},i||{},null!==(o=n.optionalFunctionValue(e,r,i))&&void 0!==o?o:r);return t.run(Object.freeze(a),u)}},exports.createContext=r;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var n=require("vest-utils");const t=Symbol();function e(e){let u=t;return{run:function(n,e){const i=o()?r():t;u=n;const s=e();return u=i,s},use:r,useX:function(t){return n.invariant(o(),n.defaultTo(t,"Not inside of a running context.")),u}};function r(){return o()?u:e}function o(){return u!==t}}exports.createCascade=function(t){const u=e();return{bind:function(n,t){return function(...e){return r(n,(function(){return t(...e)}))}},run:r,use:u.use,useX:u.useX};function r(e,r){var o;const i=u.use(),s=n.assign({},i||{},null!==(o=n.optionalFunctionValue(t,e,i))&&void 0!==o?o:e);return u.run(Object.freeze(s),r)}},exports.createContext=e;

package/dist/es/context.development.js

@@ -1,13 +1,16 @@
 import { invariant, defaultTo, assign, optionalFunctionValue } from 'vest-utils';
 
-var USEX_DEFAULT_ERROR_MESSAGE = 'Not inside of a running context.';
-var EMPTY_CONTEXT = Symbol();
+const USEX_DEFAULT_ERROR_MESSAGE = 'Not inside of a running context.';
+const EMPTY_CONTEXT = Symbol();
+/**
+ * Base context interface.
+ */
 function createContext(defaultContextValue) {
-    var contextValue = EMPTY_CONTEXT;
+    let contextValue = EMPTY_CONTEXT;
     return {
-        run: run,
-        use: use,
-        useX: useX
+        run,
+        use,
+        useX,
     };
     function use() {
         return (isInsideContext() ? contextValue : defaultContextValue);
@@ -17,9 +20,9 @@ function createContext(defaultContextValue) {
         return contextValue;
     }
     function run(value, cb) {
-        var parentContext = isInsideContext() ? use() : EMPTY_CONTEXT;
+        const parentContext = isInsideContext() ? use() : EMPTY_CONTEXT;
         contextValue = value;
-        var res = cb();
+        const res = cb();
         contextValue = parentContext;
         return res;
     }
@@ -27,28 +30,28 @@ function createContext(defaultContextValue) {
         return contextValue !== EMPTY_CONTEXT;
     }
 }
+/**
+ * Cascading context - another implementation of context, that assumes the context value is an object.
+ * When nesting context runs, the the values of the current layer merges with the layers above it.
+ */
 function createCascade(init) {
-    var ctx = createContext();
+    const ctx = createContext();
     return {
-        bind: bind,
-        run: run,
+        bind,
+        run,
         use: ctx.use,
-        useX: ctx.useX
+        useX: ctx.useX,
     };
     function run(value, fn) {
         var _a;
-        var parentContext = ctx.use();
-        var out = assign({}, parentContext ? parentContext : {}, (_a = optionalFunctionValue(init, value, parentContext)) !== null && _a !== void 0 ? _a : value);
+        const parentContext = ctx.use();
+        const out = assign({}, parentContext ? parentContext : {}, (_a = optionalFunctionValue(init, value, parentContext)) !== null && _a !== void 0 ? _a : value);
         return ctx.run(Object.freeze(out), fn);
     }
     function bind(value, fn) {
-        return function () {
-            var runTimeArgs = [];
-            for (var _i = 0; _i < arguments.length; _i++) {
-                runTimeArgs[_i] = arguments[_i];
-            }
+        return function (...runTimeArgs) {
             return run(value, function () {
-                return fn.apply(void 0, runTimeArgs);
+                return fn(...runTimeArgs);
             });
         };
     }

package/dist/es/context.production.js

@@ -1 +1 @@
-import{invariant as n,defaultTo as r,assign as u,optionalFunctionValue as t}from"vest-utils";var e=Symbol();function o(u){var t=e;return{run:function(n,r){var u=i()?o():e;t=n;var f=r();return t=u,f},use:o,useX:function(u){return n(i(),r(u,"Not inside of a running context.")),t}};function o(){return i()?t:u}function i(){return t!==e}}function i(n){var r=o();return{bind:function(n,r){return function(){for(var u=[],t=0;t<arguments.length;t++)u[t]=arguments[t];return e(n,(function(){return r.apply(void 0,u)}))}},run:e,use:r.use,useX:r.useX};function e(e,o){var i,f=r.use(),c=u({},f||{},null!==(i=t(n,e,f))&&void 0!==i?i:e);return r.run(Object.freeze(c),o)}}export{i as createCascade,o as createContext};
+import{invariant as n,defaultTo as t,assign as u,optionalFunctionValue as r}from"vest-utils";const e=Symbol();function o(u){let r=e;return{run:function(n,t){const u=c()?o():e;r=n;const i=t();return r=u,i},use:o,useX:function(u){return n(c(),t(u,"Not inside of a running context.")),r}};function o(){return c()?r:u}function c(){return r!==e}}function c(n){const t=o();return{bind:function(n,t){return function(...u){return e(n,(function(){return t(...u)}))}},run:e,use:t.use,useX:t.useX};function e(e,o){var c;const i=t.use(),s=u({},i||{},null!==(c=r(n,e,i))&&void 0!==c?c:e);return t.run(Object.freeze(s),o)}}export{c as createCascade,o as createContext};

package/dist/umd/context.development.js

@@ -4,14 +4,17 @@
   (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.context = {}, global["vest-utils"]));
 })(this, (function (exports, vestUtils) { 'use strict';
 
-  var USEX_DEFAULT_ERROR_MESSAGE = 'Not inside of a running context.';
-  var EMPTY_CONTEXT = Symbol();
+  const USEX_DEFAULT_ERROR_MESSAGE = 'Not inside of a running context.';
+  const EMPTY_CONTEXT = Symbol();
+  /**
+   * Base context interface.
+   */
   function createContext(defaultContextValue) {
-      var contextValue = EMPTY_CONTEXT;
+      let contextValue = EMPTY_CONTEXT;
       return {
-          run: run,
-          use: use,
-          useX: useX
+          run,
+          use,
+          useX,
       };
       function use() {
           return (isInsideContext() ? contextValue : defaultContextValue);
@@ -21,9 +24,9 @@
           return contextValue;
       }
       function run(value, cb) {
-          var parentContext = isInsideContext() ? use() : EMPTY_CONTEXT;
+          const parentContext = isInsideContext() ? use() : EMPTY_CONTEXT;
           contextValue = value;
-          var res = cb();
+          const res = cb();
           contextValue = parentContext;
           return res;
       }
@@ -31,28 +34,28 @@
           return contextValue !== EMPTY_CONTEXT;
       }
   }
+  /**
+   * Cascading context - another implementation of context, that assumes the context value is an object.
+   * When nesting context runs, the the values of the current layer merges with the layers above it.
+   */
   function createCascade(init) {
-      var ctx = createContext();
+      const ctx = createContext();
       return {
-          bind: bind,
-          run: run,
+          bind,
+          run,
           use: ctx.use,
-          useX: ctx.useX
+          useX: ctx.useX,
       };
       function run(value, fn) {
           var _a;
-          var parentContext = ctx.use();
-          var out = vestUtils.assign({}, parentContext ? parentContext : {}, (_a = vestUtils.optionalFunctionValue(init, value, parentContext)) !== null && _a !== void 0 ? _a : value);
+          const parentContext = ctx.use();
+          const out = vestUtils.assign({}, parentContext ? parentContext : {}, (_a = vestUtils.optionalFunctionValue(init, value, parentContext)) !== null && _a !== void 0 ? _a : value);
           return ctx.run(Object.freeze(out), fn);
       }
       function bind(value, fn) {
-          return function () {
-              var runTimeArgs = [];
-              for (var _i = 0; _i < arguments.length; _i++) {
-                  runTimeArgs[_i] = arguments[_i];
-              }
+          return function (...runTimeArgs) {
               return run(value, function () {
-                  return fn.apply(void 0, runTimeArgs);
+                  return fn(...runTimeArgs);
               });
           };
       }

package/dist/umd/context.production.js

@@ -1 +1 @@
-!function(e,n){"object"==typeof exports&&"undefined"!=typeof module?n(exports,require("vest-utils")):"function"==typeof define&&define.amd?define(["exports","vest-utils"],n):n((e="undefined"!=typeof globalThis?globalThis:e||self).context={},e["vest-utils"])}(this,(function(e,n){"use strict";var t=Symbol();function u(e){var u=t;return{run:function(e,n){var i=o()?r():t;u=e;var f=n();return u=i,f},use:r,useX:function(e){return n.invariant(o(),n.defaultTo(e,"Not inside of a running context.")),u}};function r(){return o()?u:e}function o(){return u!==t}}e.createCascade=function(e){var t=u();return{bind:function(e,n){return function(){for(var t=[],u=0;u<arguments.length;u++)t[u]=arguments[u];return r(e,(function(){return n.apply(void 0,t)}))}},run:r,use:t.use,useX:t.useX};function r(u,r){var o,i=t.use(),f=n.assign({},i||{},null!==(o=n.optionalFunctionValue(e,u,i))&&void 0!==o?o:u);return t.run(Object.freeze(f),r)}},e.createContext=u,Object.defineProperty(e,"__esModule",{value:!0})}));
+!function(n,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports,require("vest-utils")):"function"==typeof define&&define.amd?define(["exports","vest-utils"],e):e((n="undefined"!=typeof globalThis?globalThis:n||self).context={},n["vest-utils"])}(this,(function(n,e){"use strict";const t=Symbol();function u(n){let u=t;return{run:function(n,e){const r=i()?o():t;u=n;const s=e();return u=r,s},use:o,useX:function(n){return e.invariant(i(),e.defaultTo(n,"Not inside of a running context.")),u}};function o(){return i()?u:n}function i(){return u!==t}}n.createCascade=function(n){const t=u();return{bind:function(n,e){return function(...t){return o(n,(function(){return e(...t)}))}},run:o,use:t.use,useX:t.useX};function o(u,o){var i;const r=t.use(),s=e.assign({},r||{},null!==(i=e.optionalFunctionValue(n,u,r))&&void 0!==i?i:u);return t.run(Object.freeze(s),o)}},n.createContext=u,Object.defineProperty(n,"__esModule",{value:!0})}));

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.0.3",
+  "version": "3.0.5-dev-405df5",
   "license": "MIT",
   "main": "./dist/cjs/context.js",
   "types": "./types/context.d.ts",
@@ -11,7 +11,7 @@
     "release": "vx release"
   },
   "dependencies": {
-    "vest-utils": "^0.0.3"
+    "vest-utils": "^0.1.0-dev-405df5"
   },
   "module": "./dist/es/context.production.js",
   "exports": {
@@ -36,7 +36,7 @@
       "default": "./dist/cjs/context.production.js"
     },
     "./package.json": "./package.json",
-    "./": "./"
+    "./*": "./*"
   },
   "repository": {
     "type": "git",

package/types/context.d.ts

@@ -1,5 +1,12 @@
 import { CB } from 'vest-utils';
+/**
+ * Base context interface.
+ */
 declare function createContext<T extends unknown>(defaultContextValue?: T): CtxApi<T>;
+/**
+ * Cascading context - another implementation of context, that assumes the context value is an object.
+ * When nesting context runs, the the values of the current layer merges with the layers above it.
+ */
 declare function createCascade<T extends Record<string, unknown>>(init?: (value: Partial<T>, parentContext: T | void) => T | null): CtxCascadeApi<T>;
 type ContextConsumptionApi<T> = {
     use: () => T;

package/types/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,MAAW,MAAM,YAAY,CAAC;AAWrC,iBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,EAC7C,mBAAmB,CAAC,EAAE,CAAC,GACtB,MAAM,CAAC,CAAC,CAAC,CAmCX;AAED,iBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,IAAI,GAC9D,aAAa,CAAC,CAAC,CAAC,CA6BlB;AAED,KAAK,qBAAqB,CAAC,CAAC,IAAI;IAC9B,GAAG,EAAE,MAAM,CAAC,CAAC;IACb,IAAI,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,CAAC,CAAC;CACpC,CAAC;AAEF,KAAY,MAAM,CAAC,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC,GAAG;IACjD,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;CACtC,CAAC;AAEF,KAAY,aAAa,CAAC,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC,GAAG;IACxD,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;CACxD,CAAC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,MAAW,MAAM,YAAY,CAAC;AAWrC;;GAEG;AACH,iBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,EAC7C,mBAAmB,CAAC,EAAE,CAAC,GACtB,MAAM,CAAC,CAAC,CAAC,CAmCX;AAED;;;GAGG;AACH,iBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,IAAI,GAC9D,aAAa,CAAC,CAAC,CAAC,CA6BlB;AAED,KAAK,qBAAqB,CAAC,CAAC,IAAI;IAC9B,GAAG,EAAE,MAAM,CAAC,CAAC;IACb,IAAI,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,CAAC,CAAC;CACpC,CAAC;AAEF,KAAY,MAAM,CAAC,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC,GAAG;IACjD,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;CACtC,CAAC;AAEF,KAAY,aAAa,CAAC,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC,GAAG;IACxD,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;CACxD,CAAC"}