@merkur/plugin-router 0.27.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2020 Miroslav Jancarik jancarikmiroslav@gmail.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,56 @@
+<center>
+  <h1 style="font-family: Helvetica, Arial, sans-serif; font-size:60px;">Merkur</h1>
+</center>
+
+[![Build Status](https://github.com/mjancarik/merkur/workflows/CI/badge.svg)](https://travis-ci.com/mjancarik/merkur)
+[![NPM package version](https://img.shields.io/npm/v/@merkur/plugin-router/latest.svg)](https://www.npmjs.com/package/@merkur/core)
+![npm bundle size (scoped version)](https://img.shields.io/bundlephobia/minzip/@merkur/plugin-router/latest)
+[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
+
+# Merkur
+
+The [Merkur](https://merkur.js.org/) is tiny extensible javascript library for front-end microservices. It allows by default server side rendering for loading performance boost. You can connect it with other frameworks or languages because merkur defines easy API. You can use one of four predefined template's library [React](https://reactjs.org/), [Preact](https://preactjs.com/), [hyperHTML](https://viperhtml.js.org/hyper.html) and [µhtml](https://github.com/WebReflection/uhtml#readme) but you can easily extend for others.
+
+## Getting started
+
+```bash
+npx @merkur/create-widget <name>
+
+cd name
+
+npm run dev // Point your browser at http://localhost:4444/
+```
+<p align="center">
+  <img alt="Merkur example, hello widget" src="https://raw.githubusercontent.com/mjancarik/merkur/master/images/hello-widget.png" />
+</p>
+
+You can see live [demo](https://merkur.js.org/demo).
+
+## API
+
+Point your browser at `http://localhost:4444/widget`.
+
+```json
+{
+  "name":"my-widget",
+  "version":"0.0.1",
+  "props":{},
+  "state":{"counter":0},
+  "assets":[
+    {
+      "name": "widget.js",
+      "type": "script",
+      "source": {
+        "es9": "http://localhost:4444/static/es9/widget.6961af42bfa3596bb147.js",
+        "es5": "http://localhost:4444/static/es5/widget.31c5090d8c961e43fade.js"
+      }
+    },
+    {
+      "name": "widget.css",
+      "type": "stylesheet",
+      "source": "http://localhost:4444/static/es9/widget.814e0cb568c7ddc0725d.css"
+    }
+  ],
+  "html":"\n      <div class=\"merkur__page\">\n        <div class=\"merkur__headline\">\n          <div class=\"merkur__view\">\n            \n    <div class=\"merkur__icon\">\n      <img src=\"http://localhost:4444/static/merkur-icon.png\" alt=\"Merkur\">\n    </div>\n  \n            \n    <h1>Welcome to <a href=\"https://github.com/mjancarik/merkur\">MERKUR</a>,<br> a javascript library for front-end microservices.</h1>\n  \n            \n    <p>The widget's name is <strong>my-widget@0.0.1</strong>.</p>\n  \n          </div>\n        </div>\n        <div class=\"merkur__view\">\n          \n    <div>\n      <h2>Counter widget:</h2>\n      <p>Count: 0</p>\n      <button onclick=\"return ((...rest) =&gt; {\n        return originalFunction(widget, ...rest);\n      }).call(this, event)\">\n        increase counter\n      </button>\n      <button onclick=\"return ((...rest) =&gt; {\n        return originalFunction(widget, ...rest);\n      }).call(this, event)\">\n        reset counter\n      </button>\n    </div>\n  \n        </div>\n      </div>\n  "
+}
+```

package/jest.config.js

@@ -0,0 +1,5 @@
+const defaultConfig = require('../../jest.config.js');
+
+defaultConfig.testEnvironment = 'jsdom';
+
+module.exports = { ...defaultConfig };

package/lib/RouterEvents.cjs

@@ -0,0 +1,9 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var RouterEvents = Object.freeze({
+  REDIRECT: '@merkur/plugin-router.redirect',
+});
+
+exports['default'] = RouterEvents;

package/lib/RouterEvents.es5.js

@@ -0,0 +1 @@
+"use strict";require("core-js/modules/es.object.define-property.js"),require("core-js/modules/es.object.freeze.js"),Object.defineProperty(exports,"__esModule",{value:!0});var e=Object.freeze({REDIRECT:"@merkur/plugin-router.redirect"});exports.default=e;

package/lib/RouterEvents.es9.cjs

@@ -0,0 +1,9 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+var RouterEvents = Object.freeze({
+  REDIRECT: '@merkur/plugin-router.redirect'
+});
+exports['default'] = RouterEvents;

package/lib/RouterEvents.es9.mjs

@@ -0,0 +1,4 @@
+var RouterEvents = Object.freeze({
+  REDIRECT: '@merkur/plugin-router.redirect'
+});
+export { RouterEvents as default };

package/lib/RouterEvents.js

@@ -0,0 +1,9 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var RouterEvents = Object.freeze({
+  REDIRECT: '@merkur/plugin-router.redirect',
+});
+
+exports['default'] = RouterEvents;

package/lib/RouterEvents.mjs

@@ -0,0 +1,5 @@
+var RouterEvents = Object.freeze({
+  REDIRECT: '@merkur/plugin-router.redirect',
+});
+
+export { RouterEvents as default };

package/lib/index.cjs

@@ -0,0 +1,249 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var core = require('@merkur/core');
+var UniversalRouter = require('universal-router');
+var generateUrls = require('universal-router/generateUrls');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var UniversalRouter__default = /*#__PURE__*/_interopDefaultLegacy(UniversalRouter);
+var generateUrls__default = /*#__PURE__*/_interopDefaultLegacy(generateUrls);
+
+var RouterEvents = Object.freeze({
+  REDIRECT: '@merkur/plugin-router.redirect',
+});
+
+const DEV = 'development';
+const ENV =
+  typeof process !== 'undefined' && process && process.env
+    ? process.env.NODE_ENV
+    : DEV;
+
+function createRouter(widget, routes, options) {
+  widget.$dependencies.router = new UniversalRouter__default['default'](routes, options);
+  widget.$dependencies.link = generateUrls__default['default'](widget.$dependencies.router);
+}
+
+function routerPlugin() {
+  return {
+    async setup(widget) {
+      widget = {
+        ...routerAPI(),
+        ...widget,
+      };
+
+      widget.$in.router = {
+        route: null,
+        pathname: null,
+        isMounting: false,
+        isRouteActivated: false,
+        isBootstrapCalled: false,
+      };
+
+      core.bindWidgetToFunctions(widget, widget.router);
+
+      return widget;
+    },
+    async create(widget) {
+      if (ENV === DEV) {
+        if (!widget.$in.component) {
+          throw new Error(
+            'You must install missing plugin: npm i @merkur/plugin-component'
+          );
+        }
+
+        if (!widget.$in.eventEmitter) {
+          throw new Error(
+            'You must install missing plugin: npm i @merkur/plugin-event-emitter'
+          );
+        }
+      }
+
+      widget.$in.component.lifeCycle = core.setDefaultValueForUndefined(
+        widget.$in.component.lifeCycle,
+        ['load'],
+        () => {}
+      );
+      core.hookMethod(widget, '$in.component.lifeCycle.load', loadHook);
+      core.hookMethod(widget, 'bootstrap', bootstrapHook);
+      core.hookMethod(widget, 'mount', mountHook);
+      core.hookMethod(widget, 'unmount', unmountHook);
+      core.hookMethod(widget, 'update', updateHook);
+
+      return widget;
+    },
+  };
+}
+
+function routerAPI() {
+  return {
+    router: {
+      redirect(widget, url, data = {}) {
+        widget.emit(RouterEvents.REDIRECT, { url, ...data });
+      },
+      link(widget, routeName, data = {}) {
+        return widget.$dependencies.link(routeName, data);
+      },
+      getCurrentRoute(widget) {
+        return widget.$in.router.route;
+      },
+    },
+  };
+}
+
+async function bootstrapHook(widget, originalBootstrap, ...rest) {
+  if (widget.$in.router.isBootstrapCalled) {
+    return;
+  }
+
+  widget.$in.router.isBootstrapCalled = true;
+
+  return originalBootstrap(...rest);
+}
+
+// hook Component
+async function loadHook(widget, originalLoad, ...rest) {
+  const plugin = widget.$in.router;
+
+  if (!plugin.isMounting && widget.props.pathname !== plugin.pathname) {
+    await tearDownRouterCycle(widget, ...rest);
+
+    await setupRouterCycle(widget, ...rest);
+  }
+
+  if (!core.isFunction(plugin.route.load)) {
+    throw new Error('The load method is mandatory.');
+  }
+
+  const globalStatePromise = core.isFunction(originalLoad)
+    ? originalLoad(widget, ...rest)
+    : Promise.resolve({});
+  const routeStatePromise = plugin.route.load(widget, {
+    route: plugin.route,
+    args: rest,
+    globalState: globalStatePromise,
+  });
+
+  const [globalState, routeState] = await Promise.all([
+    globalStatePromise,
+    routeStatePromise,
+  ]);
+
+  return { ...globalState, ...routeState };
+}
+
+// hook Component
+async function mountHook(widget, originalMount, ...rest) {
+  await widget.bootstrap(...rest);
+
+  const plugin = widget.$in.router;
+  if (!plugin.route) {
+    await resolveRoute(widget);
+    plugin.isMounting = true;
+  }
+
+  const result = await originalMount(...rest);
+
+  if (plugin.isMounting && core.isFunction(plugin.route.init)) {
+    await plugin.route.init(widget, { route: plugin.route, args: rest });
+  }
+
+  if (
+    core.isFunction(plugin.route.activate) &&
+    isClient() &&
+    !plugin.isRouteActivated
+  ) {
+    plugin.isRouteActivated = true;
+    plugin.route.activate(widget, { route: plugin.route, args: rest });
+  }
+
+  plugin.isMounting = false;
+
+  return result;
+}
+
+// hook Component
+async function updateHook(widget, originalUpdate, ...rest) {
+  const result = await originalUpdate(...rest);
+
+  const plugin = widget.$in.router;
+
+  if (
+    core.isFunction(plugin.route.activate) &&
+    isClient() &&
+    !plugin.isRouteActivated
+  ) {
+    plugin.isRouteActivated = true;
+    plugin.route.activate(widget, { route: plugin.route, args: rest });
+  }
+
+  return result;
+}
+
+// hook Component
+async function unmountHook(widget, originalUnmount, ...rest) {
+  const result = await originalUnmount(...rest);
+
+  await tearDownRouterCycle(widget, ...rest);
+
+  return result;
+}
+
+async function resolveRoute(widget) {
+  if (ENV === DEV) {
+    if (!widget.props.pathname) {
+      throw new Error('The props pathname is not defined.');
+    }
+
+    if (!widget.$dependencies.router) {
+      throw new Error(
+        'You must add calling of createRouter(widget, routes, options) to widget.setup method.'
+      );
+    }
+  }
+
+  const route = await widget.$dependencies.router.resolve({
+    pathname: widget.props.pathname,
+    widget,
+  });
+
+  widget.$in.router.route = route;
+  widget.$in.router.pathname = widget.props.pathname;
+
+  return route;
+}
+
+async function setupRouterCycle(widget, ...rest) {
+  const route = await resolveRoute(widget);
+
+  if (core.isFunction(route.init)) {
+    await route.init(widget, { route, args: rest });
+  }
+}
+
+async function tearDownRouterCycle(widget, ...rest) {
+  const plugin = widget.$in.router;
+
+  const { route, isRouteActivated } = plugin;
+
+  if (route) {
+    if (core.isFunction(route.deactivate) && isRouteActivated === true) {
+      await route.deactivate(widget, { route, args: rest });
+    }
+
+    if (core.isFunction(route.destroy)) {
+      await route.destroy(widget, { route, args: rest });
+    }
+  }
+
+  plugin.isRouteActivated = false;
+}
+
+function isClient() {
+  return typeof window !== 'undefined';
+}
+
+exports.createRouter = createRouter;
+exports.routerPlugin = routerPlugin;

package/lib/index.es5.js

@@ -0,0 +1 @@
+"use strict";function e(e,t){return function(e){if(Array.isArray(e))return e}(e)||function(e,r){var t=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null==t)return;var n,o,u=[],i=!0,a=!1;try{for(t=t.call(e);!(i=(n=t.next()).done)&&(u.push(n.value),!r||u.length!==r);i=!0);}catch(e){a=!0,o=e}finally{try{i||null==t.return||t.return()}finally{if(a)throw o}}return u}(e,t)||function(e,t){if(!e)return;if("string"==typeof e)return r(e,t);var n=Object.prototype.toString.call(e).slice(8,-1);"Object"===n&&e.constructor&&(n=e.constructor.name);if("Map"===n||"Set"===n)return Array.from(e);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return r(e,t)}(e,t)||function(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function r(e,r){(null==r||r>e.length)&&(r=e.length);for(var t=0,n=new Array(r);t<r;t++)n[t]=e[t];return n}function t(e,r){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);r&&(n=n.filter((function(r){return Object.getOwnPropertyDescriptor(e,r).enumerable}))),t.push.apply(t,n)}return t}function n(e){for(var r=1;r<arguments.length;r++){var n=null!=arguments[r]?arguments[r]:{};r%2?t(Object(n),!0).forEach((function(r){o(e,r,n[r])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):t(Object(n)).forEach((function(r){Object.defineProperty(e,r,Object.getOwnPropertyDescriptor(n,r))}))}return e}function o(e,r,t){return r in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function u(e,r,t,n,o,u,i){try{var a=e[u](i),s=a.value}catch(e){return void t(e)}a.done?r(s):Promise.resolve(s).then(n,o)}function i(e){return function(){var r=this,t=arguments;return new Promise((function(n,o){var i=e.apply(r,t);function a(e){u(i,n,o,a,s,"next",e)}function s(e){u(i,n,o,a,s,"throw",e)}a(void 0)}))}}function a(e){return a="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},a(e)}require("regenerator-runtime/runtime.js"),require("core-js/modules/es.object.define-property.js"),require("core-js/modules/es.object.freeze.js"),require("core-js/modules/es.string.link.js"),require("core-js/modules/es.array.concat.js"),require("core-js/modules/es.object.to-string.js"),require("core-js/modules/es.promise.js"),require("core-js/modules/es.array.iterator.js"),require("core-js/modules/es.string.iterator.js"),require("core-js/modules/web.dom-collections.iterator.js"),require("core-js/modules/es.symbol.js"),require("core-js/modules/es.symbol.description.js"),require("core-js/modules/es.symbol.iterator.js"),require("core-js/modules/es.object.keys.js"),require("core-js/modules/es.array.filter.js"),require("core-js/modules/es.object.get-own-property-descriptor.js"),require("core-js/modules/es.array.for-each.js"),require("core-js/modules/web.dom-collections.for-each.js"),require("core-js/modules/es.object.get-own-property-descriptors.js"),require("core-js/modules/es.object.define-properties.js"),require("core-js/modules/es.array.is-array.js"),require("core-js/modules/es.array.slice.js"),require("core-js/modules/es.function.name.js"),require("core-js/modules/es.array.from.js"),Object.defineProperty(exports,"__esModule",{value:!0});var s=require("@merkur/core"),c=require("universal-router"),p=require("universal-router/generateUrls");function l(e){return e&&"object"===a(e)&&"default"in e?e:{default:e}}var f=l(c),d=l(p),m=Object.freeze({REDIRECT:"@merkur/plugin-router.redirect"}),y="development",h="undefined"!=typeof process&&process&&process.env?process.env.NODE_ENV:y;function b(e,r){return g.apply(this,arguments)}function g(){return g=i(regeneratorRuntime.mark((function e(r,t){var n,o,u,i=arguments;return regeneratorRuntime.wrap((function(e){for(;;)switch(e.prev=e.next){case 0:if(!r.$in.router.isBootstrapCalled){e.next=2;break}return e.abrupt("return");case 2:for(r.$in.router.isBootstrapCalled=!0,n=i.length,o=new Array(n>2?n-2:0),u=2;u<n;u++)o[u-2]=i[u];return e.abrupt("return",t.apply(void 0,o));case 5:case"end":return e.stop()}}),e)}))),g.apply(this,arguments)}function v(e,r){return j.apply(this,arguments)}function j(){return j=i(regeneratorRuntime.mark((function r(t,o){var u,i,a,c,p,l,f,d,m,y,h=arguments;return regeneratorRuntime.wrap((function(r){for(;;)switch(r.prev=r.next){case 0:for(u=t.$in.router,i=h.length,a=new Array(i>2?i-2:0),c=2;c<i;c++)a[c-2]=h[c];if(u.isMounting||t.props.pathname===u.pathname){r.next=7;break}return r.next=5,S.apply(void 0,[t].concat(a));case 5:return r.next=7,E.apply(void 0,[t].concat(a));case 7:if(s.isFunction(u.route.load)){r.next=9;break}throw new Error("The load method is mandatory.");case 9:return p=s.isFunction(o)?o.apply(void 0,[t].concat(a)):Promise.resolve({}),l=u.route.load(t,{route:u.route,args:a,globalState:p}),r.next=13,Promise.all([p,l]);case 13:return f=r.sent,d=e(f,2),m=d[0],y=d[1],r.abrupt("return",n(n({},m),y));case 18:case"end":return r.stop()}}),r)}))),j.apply(this,arguments)}function w(e,r){return x.apply(this,arguments)}function x(){return x=i(regeneratorRuntime.mark((function e(r,t){var n,o,u,i,a,c=arguments;return regeneratorRuntime.wrap((function(e){for(;;)switch(e.prev=e.next){case 0:for(n=c.length,o=new Array(n>2?n-2:0),u=2;u<n;u++)o[u-2]=c[u];return e.next=3,r.bootstrap.apply(r,o);case 3:if((i=r.$in.router).route){e.next=8;break}return e.next=7,$(r);case 7:i.isMounting=!0;case 8:return e.next=10,t.apply(void 0,o);case 10:if(a=e.sent,!i.isMounting||!s.isFunction(i.route.init)){e.next=14;break}return e.next=14,i.route.init(r,{route:i.route,args:o});case 14:return s.isFunction(i.route.activate)&&C()&&!i.isRouteActivated&&(i.isRouteActivated=!0,i.route.activate(r,{route:i.route,args:o})),i.isMounting=!1,e.abrupt("return",a);case 17:case"end":return e.stop()}}),e)}))),x.apply(this,arguments)}function k(e,r){return R.apply(this,arguments)}function R(){return R=i(regeneratorRuntime.mark((function e(r,t){var n,o,u,i,a,c=arguments;return regeneratorRuntime.wrap((function(e){for(;;)switch(e.prev=e.next){case 0:for(n=c.length,o=new Array(n>2?n-2:0),u=2;u<n;u++)o[u-2]=c[u];return e.next=3,t.apply(void 0,o);case 3:return i=e.sent,a=r.$in.router,s.isFunction(a.route.activate)&&C()&&!a.isRouteActivated&&(a.isRouteActivated=!0,a.route.activate(r,{route:a.route,args:o})),e.abrupt("return",i);case 7:case"end":return e.stop()}}),e)}))),R.apply(this,arguments)}function q(e,r){return O.apply(this,arguments)}function O(){return O=i(regeneratorRuntime.mark((function e(r,t){var n,o,u,i,a=arguments;return regeneratorRuntime.wrap((function(e){for(;;)switch(e.prev=e.next){case 0:for(n=a.length,o=new Array(n>2?n-2:0),u=2;u<n;u++)o[u-2]=a[u];return e.next=3,t.apply(void 0,o);case 3:return i=e.sent,e.next=6,S.apply(void 0,[r].concat(o));case 6:return e.abrupt("return",i);case 7:case"end":return e.stop()}}),e)}))),O.apply(this,arguments)}function $(e){return A.apply(this,arguments)}function A(){return(A=i(regeneratorRuntime.mark((function e(r){var t;return regeneratorRuntime.wrap((function(e){for(;;)switch(e.prev=e.next){case 0:if(h!==y){e.next=5;break}if(r.props.pathname){e.next=3;break}throw new Error("The props pathname is not defined.");case 3:if(r.$dependencies.router){e.next=5;break}throw new Error("You must add calling of createRouter(widget, routes, options) to widget.setup method.");case 5:return e.next=7,r.$dependencies.router.resolve({pathname:r.props.pathname,widget:r});case 7:return t=e.sent,r.$in.router.route=t,r.$in.router.pathname=r.props.pathname,e.abrupt("return",t);case 11:case"end":return e.stop()}}),e)})))).apply(this,arguments)}function E(e){return P.apply(this,arguments)}function P(){return P=i(regeneratorRuntime.mark((function e(r){var t,n,o,u,i=arguments;return regeneratorRuntime.wrap((function(e){for(;;)switch(e.prev=e.next){case 0:return e.next=2,$(r);case 2:if(t=e.sent,!s.isFunction(t.init)){e.next=7;break}for(n=i.length,o=new Array(n>1?n-1:0),u=1;u<n;u++)o[u-1]=i[u];return e.next=7,t.init(r,{route:t,args:o});case 7:case"end":return e.stop()}}),e)}))),P.apply(this,arguments)}function S(e){return M.apply(this,arguments)}function M(){return M=i(regeneratorRuntime.mark((function e(r){var t,n,o,u,i,a,c=arguments;return regeneratorRuntime.wrap((function(e){for(;;)switch(e.prev=e.next){case 0:if(t=r.$in.router,n=t.route,o=t.isRouteActivated,!n){e.next=10;break}for(u=c.length,i=new Array(u>1?u-1:0),a=1;a<u;a++)i[a-1]=c[a];if(!s.isFunction(n.deactivate)||!0!==o){e.next=7;break}return e.next=7,n.deactivate(r,{route:n,args:i});case 7:if(!s.isFunction(n.destroy)){e.next=10;break}return e.next=10,n.destroy(r,{route:n,args:i});case 10:t.isRouteActivated=!1;case 11:case"end":return e.stop()}}),e)}))),M.apply(this,arguments)}function C(){return"undefined"!=typeof window}exports.createRouter=function(e,r,t){e.$dependencies.router=new f.default(r,t),e.$dependencies.link=d.default(e.$dependencies.router)},exports.routerPlugin=function(){return{setup:function(e){return i(regeneratorRuntime.mark((function r(){return regeneratorRuntime.wrap((function(r){for(;;)switch(r.prev=r.next){case 0:return e=n(n({},{router:{redirect:function(e,r){var t=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{};e.emit(m.REDIRECT,n({url:r},t))},link:function(e,r){var t=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{};return e.$dependencies.link(r,t)},getCurrentRoute:function(e){return e.$in.router.route}}}),e),e.$in.router={route:null,pathname:null,isMounting:!1,isRouteActivated:!1,isBootstrapCalled:!1},s.bindWidgetToFunctions(e,e.router),r.abrupt("return",e);case 4:case"end":return r.stop()}}),r)})))()},create:function(e){return i(regeneratorRuntime.mark((function r(){return regeneratorRuntime.wrap((function(r){for(;;)switch(r.prev=r.next){case 0:if(h!==y){r.next=5;break}if(e.$in.component){r.next=3;break}throw new Error("You must install missing plugin: npm i @merkur/plugin-component");case 3:if(e.$in.eventEmitter){r.next=5;break}throw new Error("You must install missing plugin: npm i @merkur/plugin-event-emitter");case 5:return e.$in.component.lifeCycle=s.setDefaultValueForUndefined(e.$in.component.lifeCycle,["load"],(function(){})),s.hookMethod(e,"$in.component.lifeCycle.load",v),s.hookMethod(e,"bootstrap",b),s.hookMethod(e,"mount",w),s.hookMethod(e,"unmount",q),s.hookMethod(e,"update",k),r.abrupt("return",e);case 12:case"end":return r.stop()}}),r)})))()}}};

package/lib/index.es9.cjs

@@ -0,0 +1,246 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+
+var core = require('@merkur/core');
+
+var UniversalRouter = require('universal-router');
+
+var generateUrls = require('universal-router/generateUrls');
+
+function _interopDefaultLegacy(e) {
+  return e && typeof e === 'object' && 'default' in e ? e : {
+    'default': e
+  };
+}
+
+var UniversalRouter__default = /*#__PURE__*/_interopDefaultLegacy(UniversalRouter);
+
+var generateUrls__default = /*#__PURE__*/_interopDefaultLegacy(generateUrls);
+
+var RouterEvents = Object.freeze({
+  REDIRECT: '@merkur/plugin-router.redirect'
+});
+const DEV = 'development';
+const ENV = typeof process !== 'undefined' && process && process.env ? process.env.NODE_ENV : DEV;
+
+function createRouter(widget, routes, options) {
+  widget.$dependencies.router = new UniversalRouter__default['default'](routes, options);
+  widget.$dependencies.link = generateUrls__default['default'](widget.$dependencies.router);
+}
+
+function routerPlugin() {
+  return {
+    async setup(widget) {
+      widget = { ...routerAPI(),
+        ...widget
+      };
+      widget.$in.router = {
+        route: null,
+        pathname: null,
+        isMounting: false,
+        isRouteActivated: false,
+        isBootstrapCalled: false
+      };
+      core.bindWidgetToFunctions(widget, widget.router);
+      return widget;
+    },
+
+    async create(widget) {
+      if (ENV === DEV) {
+        if (!widget.$in.component) {
+          throw new Error('You must install missing plugin: npm i @merkur/plugin-component');
+        }
+
+        if (!widget.$in.eventEmitter) {
+          throw new Error('You must install missing plugin: npm i @merkur/plugin-event-emitter');
+        }
+      }
+
+      widget.$in.component.lifeCycle = core.setDefaultValueForUndefined(widget.$in.component.lifeCycle, ['load'], () => {});
+      core.hookMethod(widget, '$in.component.lifeCycle.load', loadHook);
+      core.hookMethod(widget, 'bootstrap', bootstrapHook);
+      core.hookMethod(widget, 'mount', mountHook);
+      core.hookMethod(widget, 'unmount', unmountHook);
+      core.hookMethod(widget, 'update', updateHook);
+      return widget;
+    }
+
+  };
+}
+
+function routerAPI() {
+  return {
+    router: {
+      redirect(widget, url, data = {}) {
+        widget.emit(RouterEvents.REDIRECT, {
+          url,
+          ...data
+        });
+      },
+
+      link(widget, routeName, data = {}) {
+        return widget.$dependencies.link(routeName, data);
+      },
+
+      getCurrentRoute(widget) {
+        return widget.$in.router.route;
+      }
+
+    }
+  };
+}
+
+async function bootstrapHook(widget, originalBootstrap, ...rest) {
+  if (widget.$in.router.isBootstrapCalled) {
+    return;
+  }
+
+  widget.$in.router.isBootstrapCalled = true;
+  return originalBootstrap(...rest);
+} // hook Component
+
+
+async function loadHook(widget, originalLoad, ...rest) {
+  const plugin = widget.$in.router;
+
+  if (!plugin.isMounting && widget.props.pathname !== plugin.pathname) {
+    await tearDownRouterCycle(widget, ...rest);
+    await setupRouterCycle(widget, ...rest);
+  }
+
+  if (!core.isFunction(plugin.route.load)) {
+    throw new Error('The load method is mandatory.');
+  }
+
+  const globalStatePromise = core.isFunction(originalLoad) ? originalLoad(widget, ...rest) : Promise.resolve({});
+  const routeStatePromise = plugin.route.load(widget, {
+    route: plugin.route,
+    args: rest,
+    globalState: globalStatePromise
+  });
+  const [globalState, routeState] = await Promise.all([globalStatePromise, routeStatePromise]);
+  return { ...globalState,
+    ...routeState
+  };
+} // hook Component
+
+
+async function mountHook(widget, originalMount, ...rest) {
+  await widget.bootstrap(...rest);
+  const plugin = widget.$in.router;
+
+  if (!plugin.route) {
+    await resolveRoute(widget);
+    plugin.isMounting = true;
+  }
+
+  const result = await originalMount(...rest);
+
+  if (plugin.isMounting && core.isFunction(plugin.route.init)) {
+    await plugin.route.init(widget, {
+      route: plugin.route,
+      args: rest
+    });
+  }
+
+  if (core.isFunction(plugin.route.activate) && isClient() && !plugin.isRouteActivated) {
+    plugin.isRouteActivated = true;
+    plugin.route.activate(widget, {
+      route: plugin.route,
+      args: rest
+    });
+  }
+
+  plugin.isMounting = false;
+  return result;
+} // hook Component
+
+
+async function updateHook(widget, originalUpdate, ...rest) {
+  const result = await originalUpdate(...rest);
+  const plugin = widget.$in.router;
+
+  if (core.isFunction(plugin.route.activate) && isClient() && !plugin.isRouteActivated) {
+    plugin.isRouteActivated = true;
+    plugin.route.activate(widget, {
+      route: plugin.route,
+      args: rest
+    });
+  }
+
+  return result;
+} // hook Component
+
+
+async function unmountHook(widget, originalUnmount, ...rest) {
+  const result = await originalUnmount(...rest);
+  await tearDownRouterCycle(widget, ...rest);
+  return result;
+}
+
+async function resolveRoute(widget) {
+  if (ENV === DEV) {
+    if (!widget.props.pathname) {
+      throw new Error('The props pathname is not defined.');
+    }
+
+    if (!widget.$dependencies.router) {
+      throw new Error('You must add calling of createRouter(widget, routes, options) to widget.setup method.');
+    }
+  }
+
+  const route = await widget.$dependencies.router.resolve({
+    pathname: widget.props.pathname,
+    widget
+  });
+  widget.$in.router.route = route;
+  widget.$in.router.pathname = widget.props.pathname;
+  return route;
+}
+
+async function setupRouterCycle(widget, ...rest) {
+  const route = await resolveRoute(widget);
+
+  if (core.isFunction(route.init)) {
+    await route.init(widget, {
+      route,
+      args: rest
+    });
+  }
+}
+
+async function tearDownRouterCycle(widget, ...rest) {
+  const plugin = widget.$in.router;
+  const {
+    route,
+    isRouteActivated
+  } = plugin;
+
+  if (route) {
+    if (core.isFunction(route.deactivate) && isRouteActivated === true) {
+      await route.deactivate(widget, {
+        route,
+        args: rest
+      });
+    }
+
+    if (core.isFunction(route.destroy)) {
+      await route.destroy(widget, {
+        route,
+        args: rest
+      });
+    }
+  }
+
+  plugin.isRouteActivated = false;
+}
+
+function isClient() {
+  return typeof window !== 'undefined';
+}
+
+exports.createRouter = createRouter;
+exports.routerPlugin = routerPlugin;