@merkur/core 0.27.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +7 -0
- package/README.md +47 -0
- package/jest.config.js +3 -0
- package/lib/index.cjs +208 -0
- package/lib/index.es5.js +1 -0
- package/lib/index.es9.cjs +202 -0
- package/lib/index.es9.mjs +189 -0
- package/lib/index.js +208 -0
- package/lib/index.mjs +197 -0
- package/lib/index.umd.js +1 -0
- package/package.json +58 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
Copyright 2020 Miroslav Jancarik jancarikmiroslav@gmail.com
|
|
2
|
+
|
|
3
|
+
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:
|
|
4
|
+
|
|
5
|
+
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
|
6
|
+
|
|
7
|
+
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
ADDED
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<a href="https://merkur.js.org/docs/getting-started" title="Getting started">
|
|
3
|
+
<img src="https://raw.githubusercontent.com/mjancarik/merkur/master/images/merkur-illustration.png" width="100px" height="100px" alt="Merkur illustration"/>
|
|
4
|
+
</a>
|
|
5
|
+
</p>
|
|
6
|
+
|
|
7
|
+
# Merkur
|
|
8
|
+
|
|
9
|
+
[](https://github.com/mjancarik/merkur/actions/workflows/ci.yml)
|
|
10
|
+
[](https://www.npmjs.com/package/@merkur/core)
|
|
11
|
+

|
|
12
|
+
[](https://github.com/prettier/prettier)
|
|
13
|
+
|
|
14
|
+
The [Merkur](https://merkur.js.org/) is tiny extensible javascript library for front-end microservices(micro frontends). 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 six predefined template's library [React](https://reactjs.org/), [Preact](https://preactjs.com/), [hyperHTML](https://viperhtml.js.org/hyper.html), [µhtml](https://github.com/WebReflection/uhtml#readme), [Svelte](https://svelte.dev/) and [vanilla](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals) but you can easily extend for others.
|
|
15
|
+
|
|
16
|
+
## Features
|
|
17
|
+
- Flexible templating engine
|
|
18
|
+
- Usable with all tech stacks
|
|
19
|
+
- SSR-ready by default
|
|
20
|
+
- Easy extensible with plugins
|
|
21
|
+
- Tiny - 1 KB minified + gzipped
|
|
22
|
+
|
|
23
|
+
## Getting started
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
npx @merkur/create-widget <name>
|
|
27
|
+
|
|
28
|
+
cd name
|
|
29
|
+
|
|
30
|
+
npm run dev // Point your browser at http://localhost:4444/
|
|
31
|
+
```
|
|
32
|
+

|
|
33
|
+
## Documentation
|
|
34
|
+
|
|
35
|
+
To check out [live demo](https://merkur.js.org/demo) and [docs](https://merkur.js.org/docs), visit [https://merkur.js.org](https://merkur.js.org).
|
|
36
|
+
|
|
37
|
+
## Contribution
|
|
38
|
+
|
|
39
|
+
Contribute to this project via [Pull-Requests](https://github.com/mjancarik/merkur/pulls).
|
|
40
|
+
|
|
41
|
+
We are following [Conventional Commits Specification](https://www.conventionalcommits.org/en/v1.0.0/#summary). To simplify the commit process, you can use `npm run commit` command. It opens an interactive interface, which should help you with commit message composition.
|
|
42
|
+
|
|
43
|
+
Thank you to all the people who already contributed to Merkur!
|
|
44
|
+
|
|
45
|
+
<a href="https://github.com/mjancarik/merkur/graphs/contributors">
|
|
46
|
+
<img src="https://contrib.rocks/image?repo=mjancarik/merkur" />
|
|
47
|
+
</a>
|
package/jest.config.js
ADDED
package/lib/index.cjs
ADDED
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
Object.defineProperty(exports, '__esModule', { value: true });
|
|
4
|
+
|
|
5
|
+
function createBoundedFunction(widget, originalFunction) {
|
|
6
|
+
return (...rest) => {
|
|
7
|
+
return originalFunction(widget, ...rest);
|
|
8
|
+
};
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
function setDefaultValueForUndefined(object, keys, value = {}) {
|
|
12
|
+
let objectClone = { ...object };
|
|
13
|
+
|
|
14
|
+
keys.forEach((key) => {
|
|
15
|
+
objectClone[key] = objectClone[key] || value;
|
|
16
|
+
});
|
|
17
|
+
|
|
18
|
+
return objectClone;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
function bindWidgetToFunctions(widget, target) {
|
|
22
|
+
target = target || widget;
|
|
23
|
+
Object.keys(target).forEach((key) => {
|
|
24
|
+
if (isFunction(target[key])) {
|
|
25
|
+
let originalFunction = target[key];
|
|
26
|
+
|
|
27
|
+
target[key] = createBoundedFunction(widget, originalFunction);
|
|
28
|
+
}
|
|
29
|
+
});
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
function hookMethod(widget, path, handler) {
|
|
33
|
+
const { target, methodName } = parsePath(widget, path);
|
|
34
|
+
const originalFunction = createBoundedFunction(widget, target[methodName]);
|
|
35
|
+
|
|
36
|
+
target[methodName] = function (widget, ...rest) {
|
|
37
|
+
return handler(widget, originalFunction, ...rest);
|
|
38
|
+
};
|
|
39
|
+
|
|
40
|
+
return originalFunction;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
function parsePath(widget, path = '') {
|
|
44
|
+
const paths = path.split('.');
|
|
45
|
+
const methodName = paths.pop();
|
|
46
|
+
const target = paths.reduce((target, path) => target[path] || {}, widget);
|
|
47
|
+
|
|
48
|
+
if (!isFunction(target[methodName])) {
|
|
49
|
+
throw new Error(
|
|
50
|
+
`Defined path '${path}' is incorrect. Check your widget structure.`
|
|
51
|
+
);
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
return { target, methodName };
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
function isFunction(value) {
|
|
58
|
+
return typeof value === 'function';
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
async function callPluginMethod(widget, method, args) {
|
|
62
|
+
for (const plugin of widget.$plugins) {
|
|
63
|
+
if (isFunction(plugin[method])) {
|
|
64
|
+
widget = await plugin[method](widget, ...args);
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
return widget;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
async function createMerkurWidget(widgetDefinition = {}) {
|
|
72
|
+
widgetDefinition = setDefaultValueForUndefined(widgetDefinition, [
|
|
73
|
+
'$dependencies',
|
|
74
|
+
'$external',
|
|
75
|
+
]);
|
|
76
|
+
widgetDefinition = setDefaultValueForUndefined(
|
|
77
|
+
widgetDefinition,
|
|
78
|
+
['setup', 'create'],
|
|
79
|
+
(widget) => widget
|
|
80
|
+
);
|
|
81
|
+
|
|
82
|
+
const { setup, create } = widgetDefinition;
|
|
83
|
+
|
|
84
|
+
let widget = {
|
|
85
|
+
async setup(widget, ...rest) {
|
|
86
|
+
widget = await callPluginMethod(widget, 'setup', rest);
|
|
87
|
+
|
|
88
|
+
return setup(widget, ...rest);
|
|
89
|
+
},
|
|
90
|
+
async create(widget, ...rest) {
|
|
91
|
+
widget = await callPluginMethod(widget, 'create', rest);
|
|
92
|
+
|
|
93
|
+
return create(widget, ...rest);
|
|
94
|
+
},
|
|
95
|
+
$plugins: (widgetDefinition.$plugins || []).map((pluginFactory) =>
|
|
96
|
+
pluginFactory()
|
|
97
|
+
),
|
|
98
|
+
};
|
|
99
|
+
|
|
100
|
+
// TODO refactoring
|
|
101
|
+
widget.name = widgetDefinition.name;
|
|
102
|
+
widget.version = widgetDefinition.version;
|
|
103
|
+
widget.$dependencies = widgetDefinition.$dependencies;
|
|
104
|
+
widget.$external = widgetDefinition.$external;
|
|
105
|
+
widget.$in = {};
|
|
106
|
+
|
|
107
|
+
delete widgetDefinition.name;
|
|
108
|
+
delete widgetDefinition.version;
|
|
109
|
+
delete widgetDefinition.$dependencies;
|
|
110
|
+
delete widgetDefinition.$external;
|
|
111
|
+
delete widgetDefinition.$plugins;
|
|
112
|
+
|
|
113
|
+
delete widgetDefinition.setup;
|
|
114
|
+
delete widgetDefinition.create;
|
|
115
|
+
|
|
116
|
+
widget = await widget.setup(widget, widgetDefinition);
|
|
117
|
+
widget = await widget.create(widget, widgetDefinition);
|
|
118
|
+
|
|
119
|
+
bindWidgetToFunctions(widget);
|
|
120
|
+
Object.seal(widget);
|
|
121
|
+
|
|
122
|
+
return widget;
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
function register({ name, version, createWidget }) {
|
|
126
|
+
const merkur = getMerkur();
|
|
127
|
+
|
|
128
|
+
merkur.$in.widgetFactory[name + version] = createWidget;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
function create(widgetProperties = {}) {
|
|
132
|
+
const merkur = getMerkur();
|
|
133
|
+
const { name, version } = widgetProperties;
|
|
134
|
+
const factory = merkur.$in.widgetFactory[name + version];
|
|
135
|
+
|
|
136
|
+
if (!isFunction(factory)) {
|
|
137
|
+
throw new Error(
|
|
138
|
+
`The widget with defined name and version "${
|
|
139
|
+
name + version
|
|
140
|
+
}" is not defined.`
|
|
141
|
+
);
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
return factory(widgetProperties);
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
function createMerkur({ $plugins = [] } = {}) {
|
|
148
|
+
const merkur = getMerkur();
|
|
149
|
+
|
|
150
|
+
$plugins.forEach((plugin) => {
|
|
151
|
+
if (plugin && isFunction(plugin.setup)) {
|
|
152
|
+
plugin.setup(merkur);
|
|
153
|
+
}
|
|
154
|
+
});
|
|
155
|
+
|
|
156
|
+
return merkur;
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
function removeMerkur() {
|
|
160
|
+
const globalContext = getGlobalContext();
|
|
161
|
+
|
|
162
|
+
delete globalContext.__merkur__;
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
function getMerkur() {
|
|
166
|
+
const globalContext = getGlobalContext();
|
|
167
|
+
|
|
168
|
+
if (!globalContext.__merkur__) {
|
|
169
|
+
globalContext.__merkur__ = {
|
|
170
|
+
$in: {
|
|
171
|
+
widgets: [],
|
|
172
|
+
widgetFactory: {},
|
|
173
|
+
},
|
|
174
|
+
$external: {},
|
|
175
|
+
$dependencies: {},
|
|
176
|
+
register,
|
|
177
|
+
create,
|
|
178
|
+
};
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
return globalContext.__merkur__;
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
function getGlobalContext() {
|
|
185
|
+
if (typeof globalThis !== 'undefined') {
|
|
186
|
+
return globalThis;
|
|
187
|
+
}
|
|
188
|
+
if (typeof self !== 'undefined') {
|
|
189
|
+
return self;
|
|
190
|
+
}
|
|
191
|
+
if (typeof window !== 'undefined') {
|
|
192
|
+
return window;
|
|
193
|
+
}
|
|
194
|
+
if (typeof global !== 'undefined') {
|
|
195
|
+
return global;
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
return {};
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
exports.bindWidgetToFunctions = bindWidgetToFunctions;
|
|
202
|
+
exports.createMerkur = createMerkur;
|
|
203
|
+
exports.createMerkurWidget = createMerkurWidget;
|
|
204
|
+
exports.getMerkur = getMerkur;
|
|
205
|
+
exports.hookMethod = hookMethod;
|
|
206
|
+
exports.isFunction = isFunction;
|
|
207
|
+
exports.removeMerkur = removeMerkur;
|
|
208
|
+
exports.setDefaultValueForUndefined = setDefaultValueForUndefined;
|
package/lib/index.es5.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"use strict";function e(e){return function(e){if(Array.isArray(e))return n(e)}(e)||function(e){if("undefined"!=typeof Symbol&&null!=e[Symbol.iterator]||null!=e["@@iterator"])return Array.from(e)}(e)||t(e)||function(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function r(e,r){var n="undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(!n){if(Array.isArray(e)||(n=t(e))||r&&e&&"number"==typeof e.length){n&&(e=n);var o=0,s=function(){};return{s:s,n:function(){return o>=e.length?{done:!0}:{done:!1,value:e[o++]}},e:function(e){throw e},f:s}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var u,i=!0,a=!1;return{s:function(){n=n.call(e)},n:function(){var e=n.next();return i=e.done,e},e:function(e){a=!0,u=e},f:function(){try{i||null==n.return||n.return()}finally{if(a)throw u}}}}function t(e,r){if(e){if("string"==typeof e)return n(e,r);var t=Object.prototype.toString.call(e).slice(8,-1);return"Object"===t&&e.constructor&&(t=e.constructor.name),"Map"===t||"Set"===t?Array.from(e):"Arguments"===t||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t)?n(e,r):void 0}}function n(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 o(e,r,t,n,o,s,u){try{var i=e[s](u),a=i.value}catch(e){return void t(e)}i.done?r(a):Promise.resolve(a).then(n,o)}function s(e){return function(){var r=this,t=arguments;return new Promise((function(n,s){var u=e.apply(r,t);function i(e){o(u,n,s,i,a,"next",e)}function a(e){o(u,n,s,i,a,"throw",e)}i(void 0)}))}}function u(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 i(e){for(var r=1;r<arguments.length;r++){var t=null!=arguments[r]?arguments[r]:{};r%2?u(Object(t),!0).forEach((function(r){a(e,r,t[r])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):u(Object(t)).forEach((function(r){Object.defineProperty(e,r,Object.getOwnPropertyDescriptor(t,r))}))}return e}function a(e,r,t){return r in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function c(e,r){return function(){for(var t=arguments.length,n=new Array(t),o=0;o<t;o++)n[o]=arguments[o];return r.apply(void 0,[e].concat(n))}}function l(e,r){var t=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{},n=i({},e);return r.forEach((function(e){n[e]=n[e]||t})),n}function f(e,r){r=r||e,Object.keys(r).forEach((function(t){if(d(r[t])){var n=r[t];r[t]=c(e,n)}}))}function d(e){return"function"==typeof e}function p(e,r,t){return m.apply(this,arguments)}function m(){return(m=s(regeneratorRuntime.mark((function t(n,o,s){var u,i,a;return regeneratorRuntime.wrap((function(t){for(;;)switch(t.prev=t.next){case 0:u=r(n.$plugins),t.prev=1,u.s();case 3:if((i=u.n()).done){t.next=11;break}if(!d((a=i.value)[o])){t.next=9;break}return t.next=8,a[o].apply(a,[n].concat(e(s)));case 8:n=t.sent;case 9:t.next=3;break;case 11:t.next=16;break;case 13:t.prev=13,t.t0=t.catch(1),u.e(t.t0);case 16:return t.prev=16,u.f(),t.finish(16);case 19:return t.abrupt("return",n);case 20:case"end":return t.stop()}}),t,null,[[1,13,16,19]])})))).apply(this,arguments)}function j(){return j=s(regeneratorRuntime.mark((function e(){var r,t,n,o,u,i=arguments;return regeneratorRuntime.wrap((function(e){for(;;)switch(e.prev=e.next){case 0:return r=l(r=i.length>0&&void 0!==i[0]?i[0]:{},["$dependencies","$external"]),r=l(r,["setup","create"],(function(e){return e})),n=(t=r).setup,o=t.create,u={setup:function(e){var r=arguments;return s(regeneratorRuntime.mark((function t(){var o,s,u;return regeneratorRuntime.wrap((function(t){for(;;)switch(t.prev=t.next){case 0:for(o=r.length,s=new Array(o>1?o-1:0),u=1;u<o;u++)s[u-1]=r[u];return t.next=3,p(e,"setup",s);case 3:return e=t.sent,t.abrupt("return",n.apply(void 0,[e].concat(s)));case 5:case"end":return t.stop()}}),t)})))()},create:function(e){var r=arguments;return s(regeneratorRuntime.mark((function t(){var n,s,u;return regeneratorRuntime.wrap((function(t){for(;;)switch(t.prev=t.next){case 0:for(n=r.length,s=new Array(n>1?n-1:0),u=1;u<n;u++)s[u-1]=r[u];return t.next=3,p(e,"create",s);case 3:return e=t.sent,t.abrupt("return",o.apply(void 0,[e].concat(s)));case 5:case"end":return t.stop()}}),t)})))()},$plugins:(r.$plugins||[]).map((function(e){return e()}))},u.name=r.name,u.version=r.version,u.$dependencies=r.$dependencies,u.$external=r.$external,u.$in={},delete r.name,delete r.version,delete r.$dependencies,delete r.$external,delete r.$plugins,delete r.setup,delete r.create,e.next=19,u.setup(u,r);case 19:return u=e.sent,e.next=22,u.create(u,r);case 22:return f(u=e.sent),Object.seal(u),e.abrupt("return",u);case 26:case"end":return e.stop()}}),e)}))),j.apply(this,arguments)}function y(e){var r=e.name,t=e.version,n=e.createWidget;b().$in.widgetFactory[r+t]=n}function v(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},r=b(),t=e.name,n=e.version,o=r.$in.widgetFactory[t+n];if(!d(o))throw new Error('The widget with defined name and version "'.concat(t+n,'" is not defined.'));return o(e)}function b(){var e=g();return e.__merkur__||(e.__merkur__={$in:{widgets:[],widgetFactory:{}},$external:{},$dependencies:{},register:y,create:v}),e.__merkur__}function g(){return"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:"undefined"!=typeof window?window:"undefined"!=typeof global?global:{}}require("regenerator-runtime/runtime.js"),require("core-js/modules/es.object.define-property.js"),require("core-js/modules/es.array.concat.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.keys.js"),require("core-js/modules/es.regexp.exec.js"),require("core-js/modules/es.string.split.js"),require("core-js/modules/es.array.reduce.js"),require("core-js/modules/es.function.name.js"),require("core-js/modules/esnext.global-this.js"),require("core-js/modules/es.array.map.js"),require("core-js/modules/es.object.seal.js"),require("core-js/modules/es.symbol.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.object.get-own-property-descriptors.js"),require("core-js/modules/es.object.define-properties.js"),require("core-js/modules/es.object.to-string.js"),require("core-js/modules/es.promise.js"),require("core-js/modules/es.array.slice.js"),require("core-js/modules/es.array.from.js"),require("core-js/modules/es.string.iterator.js"),require("core-js/modules/es.symbol.description.js"),require("core-js/modules/es.symbol.iterator.js"),require("core-js/modules/es.array.iterator.js"),require("core-js/modules/web.dom-collections.iterator.js"),require("core-js/modules/es.array.is-array.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.bindWidgetToFunctions=f,exports.createMerkur=function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},r=e.$plugins,t=void 0===r?[]:r,n=b();return t.forEach((function(e){e&&d(e.setup)&&e.setup(n)})),n},exports.createMerkurWidget=function(){return j.apply(this,arguments)},exports.getMerkur=b,exports.hookMethod=function(e,r,t){var n=function(e){var r=arguments.length>1&&void 0!==arguments[1]?arguments[1]:"",t=r.split("."),n=t.pop(),o=t.reduce((function(e,r){return e[r]||{}}),e);if(!d(o[n]))throw new Error("Defined path '".concat(r,"' is incorrect. Check your widget structure."));return{target:o,methodName:n}}(e,r),o=n.target,s=n.methodName,u=c(e,o[s]);return o[s]=function(e){for(var r=arguments.length,n=new Array(r>1?r-1:0),o=1;o<r;o++)n[o-1]=arguments[o];return t.apply(void 0,[e,u].concat(n))},u},exports.isFunction=d,exports.removeMerkur=function(){delete g().__merkur__},exports.setDefaultValueForUndefined=l;
|
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
Object.defineProperty(exports, '__esModule', {
|
|
4
|
+
value: true
|
|
5
|
+
});
|
|
6
|
+
|
|
7
|
+
function createBoundedFunction(widget, originalFunction) {
|
|
8
|
+
return (...rest) => {
|
|
9
|
+
return originalFunction(widget, ...rest);
|
|
10
|
+
};
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
function setDefaultValueForUndefined(object, keys, value = {}) {
|
|
14
|
+
let objectClone = { ...object
|
|
15
|
+
};
|
|
16
|
+
keys.forEach(key => {
|
|
17
|
+
objectClone[key] = objectClone[key] || value;
|
|
18
|
+
});
|
|
19
|
+
return objectClone;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
function bindWidgetToFunctions(widget, target) {
|
|
23
|
+
target = target || widget;
|
|
24
|
+
Object.keys(target).forEach(key => {
|
|
25
|
+
if (isFunction(target[key])) {
|
|
26
|
+
let originalFunction = target[key];
|
|
27
|
+
target[key] = createBoundedFunction(widget, originalFunction);
|
|
28
|
+
}
|
|
29
|
+
});
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
function hookMethod(widget, path, handler) {
|
|
33
|
+
const {
|
|
34
|
+
target,
|
|
35
|
+
methodName
|
|
36
|
+
} = parsePath(widget, path);
|
|
37
|
+
const originalFunction = createBoundedFunction(widget, target[methodName]);
|
|
38
|
+
|
|
39
|
+
target[methodName] = function (widget, ...rest) {
|
|
40
|
+
return handler(widget, originalFunction, ...rest);
|
|
41
|
+
};
|
|
42
|
+
|
|
43
|
+
return originalFunction;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
function parsePath(widget, path = '') {
|
|
47
|
+
const paths = path.split('.');
|
|
48
|
+
const methodName = paths.pop();
|
|
49
|
+
const target = paths.reduce((target, path) => target[path] || {}, widget);
|
|
50
|
+
|
|
51
|
+
if (!isFunction(target[methodName])) {
|
|
52
|
+
throw new Error(`Defined path '${path}' is incorrect. Check your widget structure.`);
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
return {
|
|
56
|
+
target,
|
|
57
|
+
methodName
|
|
58
|
+
};
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
function isFunction(value) {
|
|
62
|
+
return typeof value === 'function';
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
async function callPluginMethod(widget, method, args) {
|
|
66
|
+
for (const plugin of widget.$plugins) {
|
|
67
|
+
if (isFunction(plugin[method])) {
|
|
68
|
+
widget = await plugin[method](widget, ...args);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
return widget;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
async function createMerkurWidget(widgetDefinition = {}) {
|
|
76
|
+
widgetDefinition = setDefaultValueForUndefined(widgetDefinition, ['$dependencies', '$external']);
|
|
77
|
+
widgetDefinition = setDefaultValueForUndefined(widgetDefinition, ['setup', 'create'], widget => widget);
|
|
78
|
+
const {
|
|
79
|
+
setup,
|
|
80
|
+
create
|
|
81
|
+
} = widgetDefinition;
|
|
82
|
+
let widget = {
|
|
83
|
+
async setup(widget, ...rest) {
|
|
84
|
+
widget = await callPluginMethod(widget, 'setup', rest);
|
|
85
|
+
return setup(widget, ...rest);
|
|
86
|
+
},
|
|
87
|
+
|
|
88
|
+
async create(widget, ...rest) {
|
|
89
|
+
widget = await callPluginMethod(widget, 'create', rest);
|
|
90
|
+
return create(widget, ...rest);
|
|
91
|
+
},
|
|
92
|
+
|
|
93
|
+
$plugins: (widgetDefinition.$plugins || []).map(pluginFactory => pluginFactory())
|
|
94
|
+
}; // TODO refactoring
|
|
95
|
+
|
|
96
|
+
widget.name = widgetDefinition.name;
|
|
97
|
+
widget.version = widgetDefinition.version;
|
|
98
|
+
widget.$dependencies = widgetDefinition.$dependencies;
|
|
99
|
+
widget.$external = widgetDefinition.$external;
|
|
100
|
+
widget.$in = {};
|
|
101
|
+
delete widgetDefinition.name;
|
|
102
|
+
delete widgetDefinition.version;
|
|
103
|
+
delete widgetDefinition.$dependencies;
|
|
104
|
+
delete widgetDefinition.$external;
|
|
105
|
+
delete widgetDefinition.$plugins;
|
|
106
|
+
delete widgetDefinition.setup;
|
|
107
|
+
delete widgetDefinition.create;
|
|
108
|
+
widget = await widget.setup(widget, widgetDefinition);
|
|
109
|
+
widget = await widget.create(widget, widgetDefinition);
|
|
110
|
+
bindWidgetToFunctions(widget);
|
|
111
|
+
Object.seal(widget);
|
|
112
|
+
return widget;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
function register({
|
|
116
|
+
name,
|
|
117
|
+
version,
|
|
118
|
+
createWidget
|
|
119
|
+
}) {
|
|
120
|
+
const merkur = getMerkur();
|
|
121
|
+
merkur.$in.widgetFactory[name + version] = createWidget;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
function create(widgetProperties = {}) {
|
|
125
|
+
const merkur = getMerkur();
|
|
126
|
+
const {
|
|
127
|
+
name,
|
|
128
|
+
version
|
|
129
|
+
} = widgetProperties;
|
|
130
|
+
const factory = merkur.$in.widgetFactory[name + version];
|
|
131
|
+
|
|
132
|
+
if (!isFunction(factory)) {
|
|
133
|
+
throw new Error(`The widget with defined name and version "${name + version}" is not defined.`);
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
return factory(widgetProperties);
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
function createMerkur({
|
|
140
|
+
$plugins = []
|
|
141
|
+
} = {}) {
|
|
142
|
+
const merkur = getMerkur();
|
|
143
|
+
$plugins.forEach(plugin => {
|
|
144
|
+
if (plugin && isFunction(plugin.setup)) {
|
|
145
|
+
plugin.setup(merkur);
|
|
146
|
+
}
|
|
147
|
+
});
|
|
148
|
+
return merkur;
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
function removeMerkur() {
|
|
152
|
+
const globalContext = getGlobalContext();
|
|
153
|
+
delete globalContext.__merkur__;
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
function getMerkur() {
|
|
157
|
+
const globalContext = getGlobalContext();
|
|
158
|
+
|
|
159
|
+
if (!globalContext.__merkur__) {
|
|
160
|
+
globalContext.__merkur__ = {
|
|
161
|
+
$in: {
|
|
162
|
+
widgets: [],
|
|
163
|
+
widgetFactory: {}
|
|
164
|
+
},
|
|
165
|
+
$external: {},
|
|
166
|
+
$dependencies: {},
|
|
167
|
+
register,
|
|
168
|
+
create
|
|
169
|
+
};
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
return globalContext.__merkur__;
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
function getGlobalContext() {
|
|
176
|
+
if (typeof globalThis !== 'undefined') {
|
|
177
|
+
return globalThis;
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
if (typeof self !== 'undefined') {
|
|
181
|
+
return self;
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
if (typeof window !== 'undefined') {
|
|
185
|
+
return window;
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
if (typeof global !== 'undefined') {
|
|
189
|
+
return global;
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
return {};
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
exports.bindWidgetToFunctions = bindWidgetToFunctions;
|
|
196
|
+
exports.createMerkur = createMerkur;
|
|
197
|
+
exports.createMerkurWidget = createMerkurWidget;
|
|
198
|
+
exports.getMerkur = getMerkur;
|
|
199
|
+
exports.hookMethod = hookMethod;
|
|
200
|
+
exports.isFunction = isFunction;
|
|
201
|
+
exports.removeMerkur = removeMerkur;
|
|
202
|
+
exports.setDefaultValueForUndefined = setDefaultValueForUndefined;
|
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
function createBoundedFunction(widget, originalFunction) {
|
|
2
|
+
return (...rest) => {
|
|
3
|
+
return originalFunction(widget, ...rest);
|
|
4
|
+
};
|
|
5
|
+
}
|
|
6
|
+
|
|
7
|
+
function setDefaultValueForUndefined(object, keys, value = {}) {
|
|
8
|
+
let objectClone = { ...object
|
|
9
|
+
};
|
|
10
|
+
keys.forEach(key => {
|
|
11
|
+
objectClone[key] = objectClone[key] || value;
|
|
12
|
+
});
|
|
13
|
+
return objectClone;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
function bindWidgetToFunctions(widget, target) {
|
|
17
|
+
target = target || widget;
|
|
18
|
+
Object.keys(target).forEach(key => {
|
|
19
|
+
if (isFunction(target[key])) {
|
|
20
|
+
let originalFunction = target[key];
|
|
21
|
+
target[key] = createBoundedFunction(widget, originalFunction);
|
|
22
|
+
}
|
|
23
|
+
});
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
function hookMethod(widget, path, handler) {
|
|
27
|
+
const {
|
|
28
|
+
target,
|
|
29
|
+
methodName
|
|
30
|
+
} = parsePath(widget, path);
|
|
31
|
+
const originalFunction = createBoundedFunction(widget, target[methodName]);
|
|
32
|
+
|
|
33
|
+
target[methodName] = function (widget, ...rest) {
|
|
34
|
+
return handler(widget, originalFunction, ...rest);
|
|
35
|
+
};
|
|
36
|
+
|
|
37
|
+
return originalFunction;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
function parsePath(widget, path = '') {
|
|
41
|
+
const paths = path.split('.');
|
|
42
|
+
const methodName = paths.pop();
|
|
43
|
+
const target = paths.reduce((target, path) => target[path] || {}, widget);
|
|
44
|
+
|
|
45
|
+
if (!isFunction(target[methodName])) {
|
|
46
|
+
throw new Error(`Defined path '${path}' is incorrect. Check your widget structure.`);
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
return {
|
|
50
|
+
target,
|
|
51
|
+
methodName
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
function isFunction(value) {
|
|
56
|
+
return typeof value === 'function';
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
async function callPluginMethod(widget, method, args) {
|
|
60
|
+
for (const plugin of widget.$plugins) {
|
|
61
|
+
if (isFunction(plugin[method])) {
|
|
62
|
+
widget = await plugin[method](widget, ...args);
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
return widget;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
async function createMerkurWidget(widgetDefinition = {}) {
|
|
70
|
+
widgetDefinition = setDefaultValueForUndefined(widgetDefinition, ['$dependencies', '$external']);
|
|
71
|
+
widgetDefinition = setDefaultValueForUndefined(widgetDefinition, ['setup', 'create'], widget => widget);
|
|
72
|
+
const {
|
|
73
|
+
setup,
|
|
74
|
+
create
|
|
75
|
+
} = widgetDefinition;
|
|
76
|
+
let widget = {
|
|
77
|
+
async setup(widget, ...rest) {
|
|
78
|
+
widget = await callPluginMethod(widget, 'setup', rest);
|
|
79
|
+
return setup(widget, ...rest);
|
|
80
|
+
},
|
|
81
|
+
|
|
82
|
+
async create(widget, ...rest) {
|
|
83
|
+
widget = await callPluginMethod(widget, 'create', rest);
|
|
84
|
+
return create(widget, ...rest);
|
|
85
|
+
},
|
|
86
|
+
|
|
87
|
+
$plugins: (widgetDefinition.$plugins || []).map(pluginFactory => pluginFactory())
|
|
88
|
+
}; // TODO refactoring
|
|
89
|
+
|
|
90
|
+
widget.name = widgetDefinition.name;
|
|
91
|
+
widget.version = widgetDefinition.version;
|
|
92
|
+
widget.$dependencies = widgetDefinition.$dependencies;
|
|
93
|
+
widget.$external = widgetDefinition.$external;
|
|
94
|
+
widget.$in = {};
|
|
95
|
+
delete widgetDefinition.name;
|
|
96
|
+
delete widgetDefinition.version;
|
|
97
|
+
delete widgetDefinition.$dependencies;
|
|
98
|
+
delete widgetDefinition.$external;
|
|
99
|
+
delete widgetDefinition.$plugins;
|
|
100
|
+
delete widgetDefinition.setup;
|
|
101
|
+
delete widgetDefinition.create;
|
|
102
|
+
widget = await widget.setup(widget, widgetDefinition);
|
|
103
|
+
widget = await widget.create(widget, widgetDefinition);
|
|
104
|
+
bindWidgetToFunctions(widget);
|
|
105
|
+
Object.seal(widget);
|
|
106
|
+
return widget;
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
function register({
|
|
110
|
+
name,
|
|
111
|
+
version,
|
|
112
|
+
createWidget
|
|
113
|
+
}) {
|
|
114
|
+
const merkur = getMerkur();
|
|
115
|
+
merkur.$in.widgetFactory[name + version] = createWidget;
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
function create(widgetProperties = {}) {
|
|
119
|
+
const merkur = getMerkur();
|
|
120
|
+
const {
|
|
121
|
+
name,
|
|
122
|
+
version
|
|
123
|
+
} = widgetProperties;
|
|
124
|
+
const factory = merkur.$in.widgetFactory[name + version];
|
|
125
|
+
|
|
126
|
+
if (!isFunction(factory)) {
|
|
127
|
+
throw new Error(`The widget with defined name and version "${name + version}" is not defined.`);
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
return factory(widgetProperties);
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
function createMerkur({
|
|
134
|
+
$plugins = []
|
|
135
|
+
} = {}) {
|
|
136
|
+
const merkur = getMerkur();
|
|
137
|
+
$plugins.forEach(plugin => {
|
|
138
|
+
if (plugin && isFunction(plugin.setup)) {
|
|
139
|
+
plugin.setup(merkur);
|
|
140
|
+
}
|
|
141
|
+
});
|
|
142
|
+
return merkur;
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
function removeMerkur() {
|
|
146
|
+
const globalContext = getGlobalContext();
|
|
147
|
+
delete globalContext.__merkur__;
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
function getMerkur() {
|
|
151
|
+
const globalContext = getGlobalContext();
|
|
152
|
+
|
|
153
|
+
if (!globalContext.__merkur__) {
|
|
154
|
+
globalContext.__merkur__ = {
|
|
155
|
+
$in: {
|
|
156
|
+
widgets: [],
|
|
157
|
+
widgetFactory: {}
|
|
158
|
+
},
|
|
159
|
+
$external: {},
|
|
160
|
+
$dependencies: {},
|
|
161
|
+
register,
|
|
162
|
+
create
|
|
163
|
+
};
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
return globalContext.__merkur__;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
function getGlobalContext() {
|
|
170
|
+
if (typeof globalThis !== 'undefined') {
|
|
171
|
+
return globalThis;
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
if (typeof self !== 'undefined') {
|
|
175
|
+
return self;
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
if (typeof window !== 'undefined') {
|
|
179
|
+
return window;
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
if (typeof global !== 'undefined') {
|
|
183
|
+
return global;
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
return {};
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
export { bindWidgetToFunctions, createMerkur, createMerkurWidget, getMerkur, hookMethod, isFunction, removeMerkur, setDefaultValueForUndefined };
|
package/lib/index.js
ADDED
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
Object.defineProperty(exports, '__esModule', { value: true });
|
|
4
|
+
|
|
5
|
+
function createBoundedFunction(widget, originalFunction) {
|
|
6
|
+
return (...rest) => {
|
|
7
|
+
return originalFunction(widget, ...rest);
|
|
8
|
+
};
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
function setDefaultValueForUndefined(object, keys, value = {}) {
|
|
12
|
+
let objectClone = { ...object };
|
|
13
|
+
|
|
14
|
+
keys.forEach((key) => {
|
|
15
|
+
objectClone[key] = objectClone[key] || value;
|
|
16
|
+
});
|
|
17
|
+
|
|
18
|
+
return objectClone;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
function bindWidgetToFunctions(widget, target) {
|
|
22
|
+
target = target || widget;
|
|
23
|
+
Object.keys(target).forEach((key) => {
|
|
24
|
+
if (isFunction(target[key])) {
|
|
25
|
+
let originalFunction = target[key];
|
|
26
|
+
|
|
27
|
+
target[key] = createBoundedFunction(widget, originalFunction);
|
|
28
|
+
}
|
|
29
|
+
});
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
function hookMethod(widget, path, handler) {
|
|
33
|
+
const { target, methodName } = parsePath(widget, path);
|
|
34
|
+
const originalFunction = createBoundedFunction(widget, target[methodName]);
|
|
35
|
+
|
|
36
|
+
target[methodName] = function (widget, ...rest) {
|
|
37
|
+
return handler(widget, originalFunction, ...rest);
|
|
38
|
+
};
|
|
39
|
+
|
|
40
|
+
return originalFunction;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
function parsePath(widget, path = '') {
|
|
44
|
+
const paths = path.split('.');
|
|
45
|
+
const methodName = paths.pop();
|
|
46
|
+
const target = paths.reduce((target, path) => target[path] || {}, widget);
|
|
47
|
+
|
|
48
|
+
if (!isFunction(target[methodName])) {
|
|
49
|
+
throw new Error(
|
|
50
|
+
`Defined path '${path}' is incorrect. Check your widget structure.`
|
|
51
|
+
);
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
return { target, methodName };
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
function isFunction(value) {
|
|
58
|
+
return typeof value === 'function';
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
async function callPluginMethod(widget, method, args) {
|
|
62
|
+
for (const plugin of widget.$plugins) {
|
|
63
|
+
if (isFunction(plugin[method])) {
|
|
64
|
+
widget = await plugin[method](widget, ...args);
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
return widget;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
async function createMerkurWidget(widgetDefinition = {}) {
|
|
72
|
+
widgetDefinition = setDefaultValueForUndefined(widgetDefinition, [
|
|
73
|
+
'$dependencies',
|
|
74
|
+
'$external',
|
|
75
|
+
]);
|
|
76
|
+
widgetDefinition = setDefaultValueForUndefined(
|
|
77
|
+
widgetDefinition,
|
|
78
|
+
['setup', 'create'],
|
|
79
|
+
(widget) => widget
|
|
80
|
+
);
|
|
81
|
+
|
|
82
|
+
const { setup, create } = widgetDefinition;
|
|
83
|
+
|
|
84
|
+
let widget = {
|
|
85
|
+
async setup(widget, ...rest) {
|
|
86
|
+
widget = await callPluginMethod(widget, 'setup', rest);
|
|
87
|
+
|
|
88
|
+
return setup(widget, ...rest);
|
|
89
|
+
},
|
|
90
|
+
async create(widget, ...rest) {
|
|
91
|
+
widget = await callPluginMethod(widget, 'create', rest);
|
|
92
|
+
|
|
93
|
+
return create(widget, ...rest);
|
|
94
|
+
},
|
|
95
|
+
$plugins: (widgetDefinition.$plugins || []).map((pluginFactory) =>
|
|
96
|
+
pluginFactory()
|
|
97
|
+
),
|
|
98
|
+
};
|
|
99
|
+
|
|
100
|
+
// TODO refactoring
|
|
101
|
+
widget.name = widgetDefinition.name;
|
|
102
|
+
widget.version = widgetDefinition.version;
|
|
103
|
+
widget.$dependencies = widgetDefinition.$dependencies;
|
|
104
|
+
widget.$external = widgetDefinition.$external;
|
|
105
|
+
widget.$in = {};
|
|
106
|
+
|
|
107
|
+
delete widgetDefinition.name;
|
|
108
|
+
delete widgetDefinition.version;
|
|
109
|
+
delete widgetDefinition.$dependencies;
|
|
110
|
+
delete widgetDefinition.$external;
|
|
111
|
+
delete widgetDefinition.$plugins;
|
|
112
|
+
|
|
113
|
+
delete widgetDefinition.setup;
|
|
114
|
+
delete widgetDefinition.create;
|
|
115
|
+
|
|
116
|
+
widget = await widget.setup(widget, widgetDefinition);
|
|
117
|
+
widget = await widget.create(widget, widgetDefinition);
|
|
118
|
+
|
|
119
|
+
bindWidgetToFunctions(widget);
|
|
120
|
+
Object.seal(widget);
|
|
121
|
+
|
|
122
|
+
return widget;
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
function register({ name, version, createWidget }) {
|
|
126
|
+
const merkur = getMerkur();
|
|
127
|
+
|
|
128
|
+
merkur.$in.widgetFactory[name + version] = createWidget;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
function create(widgetProperties = {}) {
|
|
132
|
+
const merkur = getMerkur();
|
|
133
|
+
const { name, version } = widgetProperties;
|
|
134
|
+
const factory = merkur.$in.widgetFactory[name + version];
|
|
135
|
+
|
|
136
|
+
if (!isFunction(factory)) {
|
|
137
|
+
throw new Error(
|
|
138
|
+
`The widget with defined name and version "${
|
|
139
|
+
name + version
|
|
140
|
+
}" is not defined.`
|
|
141
|
+
);
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
return factory(widgetProperties);
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
function createMerkur({ $plugins = [] } = {}) {
|
|
148
|
+
const merkur = getMerkur();
|
|
149
|
+
|
|
150
|
+
$plugins.forEach((plugin) => {
|
|
151
|
+
if (plugin && isFunction(plugin.setup)) {
|
|
152
|
+
plugin.setup(merkur);
|
|
153
|
+
}
|
|
154
|
+
});
|
|
155
|
+
|
|
156
|
+
return merkur;
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
function removeMerkur() {
|
|
160
|
+
const globalContext = getGlobalContext();
|
|
161
|
+
|
|
162
|
+
delete globalContext.__merkur__;
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
function getMerkur() {
|
|
166
|
+
const globalContext = getGlobalContext();
|
|
167
|
+
|
|
168
|
+
if (!globalContext.__merkur__) {
|
|
169
|
+
globalContext.__merkur__ = {
|
|
170
|
+
$in: {
|
|
171
|
+
widgets: [],
|
|
172
|
+
widgetFactory: {},
|
|
173
|
+
},
|
|
174
|
+
$external: {},
|
|
175
|
+
$dependencies: {},
|
|
176
|
+
register,
|
|
177
|
+
create,
|
|
178
|
+
};
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
return globalContext.__merkur__;
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
function getGlobalContext() {
|
|
185
|
+
if (typeof globalThis !== 'undefined') {
|
|
186
|
+
return globalThis;
|
|
187
|
+
}
|
|
188
|
+
if (typeof self !== 'undefined') {
|
|
189
|
+
return self;
|
|
190
|
+
}
|
|
191
|
+
if (typeof window !== 'undefined') {
|
|
192
|
+
return window;
|
|
193
|
+
}
|
|
194
|
+
if (typeof global !== 'undefined') {
|
|
195
|
+
return global;
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
return {};
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
exports.bindWidgetToFunctions = bindWidgetToFunctions;
|
|
202
|
+
exports.createMerkur = createMerkur;
|
|
203
|
+
exports.createMerkurWidget = createMerkurWidget;
|
|
204
|
+
exports.getMerkur = getMerkur;
|
|
205
|
+
exports.hookMethod = hookMethod;
|
|
206
|
+
exports.isFunction = isFunction;
|
|
207
|
+
exports.removeMerkur = removeMerkur;
|
|
208
|
+
exports.setDefaultValueForUndefined = setDefaultValueForUndefined;
|
package/lib/index.mjs
ADDED
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
function createBoundedFunction(widget, originalFunction) {
|
|
2
|
+
return (...rest) => {
|
|
3
|
+
return originalFunction(widget, ...rest);
|
|
4
|
+
};
|
|
5
|
+
}
|
|
6
|
+
|
|
7
|
+
function setDefaultValueForUndefined(object, keys, value = {}) {
|
|
8
|
+
let objectClone = { ...object };
|
|
9
|
+
|
|
10
|
+
keys.forEach((key) => {
|
|
11
|
+
objectClone[key] = objectClone[key] || value;
|
|
12
|
+
});
|
|
13
|
+
|
|
14
|
+
return objectClone;
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
function bindWidgetToFunctions(widget, target) {
|
|
18
|
+
target = target || widget;
|
|
19
|
+
Object.keys(target).forEach((key) => {
|
|
20
|
+
if (isFunction(target[key])) {
|
|
21
|
+
let originalFunction = target[key];
|
|
22
|
+
|
|
23
|
+
target[key] = createBoundedFunction(widget, originalFunction);
|
|
24
|
+
}
|
|
25
|
+
});
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
function hookMethod(widget, path, handler) {
|
|
29
|
+
const { target, methodName } = parsePath(widget, path);
|
|
30
|
+
const originalFunction = createBoundedFunction(widget, target[methodName]);
|
|
31
|
+
|
|
32
|
+
target[methodName] = function (widget, ...rest) {
|
|
33
|
+
return handler(widget, originalFunction, ...rest);
|
|
34
|
+
};
|
|
35
|
+
|
|
36
|
+
return originalFunction;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
function parsePath(widget, path = '') {
|
|
40
|
+
const paths = path.split('.');
|
|
41
|
+
const methodName = paths.pop();
|
|
42
|
+
const target = paths.reduce((target, path) => target[path] || {}, widget);
|
|
43
|
+
|
|
44
|
+
if (!isFunction(target[methodName])) {
|
|
45
|
+
throw new Error(
|
|
46
|
+
`Defined path '${path}' is incorrect. Check your widget structure.`
|
|
47
|
+
);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
return { target, methodName };
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function isFunction(value) {
|
|
54
|
+
return typeof value === 'function';
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
async function callPluginMethod(widget, method, args) {
|
|
58
|
+
for (const plugin of widget.$plugins) {
|
|
59
|
+
if (isFunction(plugin[method])) {
|
|
60
|
+
widget = await plugin[method](widget, ...args);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
return widget;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
async function createMerkurWidget(widgetDefinition = {}) {
|
|
68
|
+
widgetDefinition = setDefaultValueForUndefined(widgetDefinition, [
|
|
69
|
+
'$dependencies',
|
|
70
|
+
'$external',
|
|
71
|
+
]);
|
|
72
|
+
widgetDefinition = setDefaultValueForUndefined(
|
|
73
|
+
widgetDefinition,
|
|
74
|
+
['setup', 'create'],
|
|
75
|
+
(widget) => widget
|
|
76
|
+
);
|
|
77
|
+
|
|
78
|
+
const { setup, create } = widgetDefinition;
|
|
79
|
+
|
|
80
|
+
let widget = {
|
|
81
|
+
async setup(widget, ...rest) {
|
|
82
|
+
widget = await callPluginMethod(widget, 'setup', rest);
|
|
83
|
+
|
|
84
|
+
return setup(widget, ...rest);
|
|
85
|
+
},
|
|
86
|
+
async create(widget, ...rest) {
|
|
87
|
+
widget = await callPluginMethod(widget, 'create', rest);
|
|
88
|
+
|
|
89
|
+
return create(widget, ...rest);
|
|
90
|
+
},
|
|
91
|
+
$plugins: (widgetDefinition.$plugins || []).map((pluginFactory) =>
|
|
92
|
+
pluginFactory()
|
|
93
|
+
),
|
|
94
|
+
};
|
|
95
|
+
|
|
96
|
+
// TODO refactoring
|
|
97
|
+
widget.name = widgetDefinition.name;
|
|
98
|
+
widget.version = widgetDefinition.version;
|
|
99
|
+
widget.$dependencies = widgetDefinition.$dependencies;
|
|
100
|
+
widget.$external = widgetDefinition.$external;
|
|
101
|
+
widget.$in = {};
|
|
102
|
+
|
|
103
|
+
delete widgetDefinition.name;
|
|
104
|
+
delete widgetDefinition.version;
|
|
105
|
+
delete widgetDefinition.$dependencies;
|
|
106
|
+
delete widgetDefinition.$external;
|
|
107
|
+
delete widgetDefinition.$plugins;
|
|
108
|
+
|
|
109
|
+
delete widgetDefinition.setup;
|
|
110
|
+
delete widgetDefinition.create;
|
|
111
|
+
|
|
112
|
+
widget = await widget.setup(widget, widgetDefinition);
|
|
113
|
+
widget = await widget.create(widget, widgetDefinition);
|
|
114
|
+
|
|
115
|
+
bindWidgetToFunctions(widget);
|
|
116
|
+
Object.seal(widget);
|
|
117
|
+
|
|
118
|
+
return widget;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
function register({ name, version, createWidget }) {
|
|
122
|
+
const merkur = getMerkur();
|
|
123
|
+
|
|
124
|
+
merkur.$in.widgetFactory[name + version] = createWidget;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
function create(widgetProperties = {}) {
|
|
128
|
+
const merkur = getMerkur();
|
|
129
|
+
const { name, version } = widgetProperties;
|
|
130
|
+
const factory = merkur.$in.widgetFactory[name + version];
|
|
131
|
+
|
|
132
|
+
if (!isFunction(factory)) {
|
|
133
|
+
throw new Error(
|
|
134
|
+
`The widget with defined name and version "${
|
|
135
|
+
name + version
|
|
136
|
+
}" is not defined.`
|
|
137
|
+
);
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
return factory(widgetProperties);
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
function createMerkur({ $plugins = [] } = {}) {
|
|
144
|
+
const merkur = getMerkur();
|
|
145
|
+
|
|
146
|
+
$plugins.forEach((plugin) => {
|
|
147
|
+
if (plugin && isFunction(plugin.setup)) {
|
|
148
|
+
plugin.setup(merkur);
|
|
149
|
+
}
|
|
150
|
+
});
|
|
151
|
+
|
|
152
|
+
return merkur;
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
function removeMerkur() {
|
|
156
|
+
const globalContext = getGlobalContext();
|
|
157
|
+
|
|
158
|
+
delete globalContext.__merkur__;
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
function getMerkur() {
|
|
162
|
+
const globalContext = getGlobalContext();
|
|
163
|
+
|
|
164
|
+
if (!globalContext.__merkur__) {
|
|
165
|
+
globalContext.__merkur__ = {
|
|
166
|
+
$in: {
|
|
167
|
+
widgets: [],
|
|
168
|
+
widgetFactory: {},
|
|
169
|
+
},
|
|
170
|
+
$external: {},
|
|
171
|
+
$dependencies: {},
|
|
172
|
+
register,
|
|
173
|
+
create,
|
|
174
|
+
};
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
return globalContext.__merkur__;
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
function getGlobalContext() {
|
|
181
|
+
if (typeof globalThis !== 'undefined') {
|
|
182
|
+
return globalThis;
|
|
183
|
+
}
|
|
184
|
+
if (typeof self !== 'undefined') {
|
|
185
|
+
return self;
|
|
186
|
+
}
|
|
187
|
+
if (typeof window !== 'undefined') {
|
|
188
|
+
return window;
|
|
189
|
+
}
|
|
190
|
+
if (typeof global !== 'undefined') {
|
|
191
|
+
return global;
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
return {};
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
export { bindWidgetToFunctions, createMerkur, createMerkurWidget, getMerkur, hookMethod, isFunction, removeMerkur, setDefaultValueForUndefined };
|
package/lib/index.umd.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
!function(e,n){if("function"==typeof define&&define.amd)define("@merkur/core",["exports"],n);else if("undefined"!=typeof exports)n(exports);else{var r={exports:{}};n(r.exports),e.Merkur=e.Merkur||{},e.Merkur.Core=r.exports}}("undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:this,(function(e){function n(e){return function(e){if(Array.isArray(e))return o(e)}(e)||function(e){if("undefined"!=typeof Symbol&&null!=e[Symbol.iterator]||null!=e["@@iterator"])return Array.from(e)}(e)||t(e)||function(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function r(e,n){var r="undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(!r){if(Array.isArray(e)||(r=t(e))||n&&e&&"number"==typeof e.length){r&&(e=r);var o=0,i=function(){};return{s:i,n:function(){return o>=e.length?{done:!0}:{done:!1,value:e[o++]}},e:function(e){throw e},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var u,a=!0,c=!1;return{s:function(){r=r.call(e)},n:function(){var e=r.next();return a=e.done,e},e:function(e){c=!0,u=e},f:function(){try{a||null==r.return||r.return()}finally{if(c)throw u}}}}function t(e,n){if(e){if("string"==typeof e)return o(e,n);var r=Object.prototype.toString.call(e).slice(8,-1);return"Object"===r&&e.constructor&&(r=e.constructor.name),"Map"===r||"Set"===r?Array.from(e):"Arguments"===r||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(r)?o(e,n):void 0}}function o(e,n){(null==n||n>e.length)&&(n=e.length);for(var r=0,t=new Array(n);r<n;r++)t[r]=e[r];return t}function i(e,n,r,t,o,i,u){try{var a=e[i](u),c=a.value}catch(e){return void r(e)}a.done?n(c):Promise.resolve(c).then(t,o)}function u(e){return function(){var n=this,r=arguments;return new Promise((function(t,o){var u=e.apply(n,r);function a(e){i(u,t,o,a,c,"next",e)}function c(e){i(u,t,o,a,c,"throw",e)}a(void 0)}))}}function a(e,n){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var t=Object.getOwnPropertySymbols(e);n&&(t=t.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),r.push.apply(r,t)}return r}function c(e){for(var n=1;n<arguments.length;n++){var r=null!=arguments[n]?arguments[n]:{};n%2?a(Object(r),!0).forEach((function(n){f(e,n,r[n])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):a(Object(r)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(r,n))}))}return e}function f(e,n,r){return n in e?Object.defineProperty(e,n,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[n]=r,e}function l(e,n){return function(){for(var r=arguments.length,t=new Array(r),o=0;o<r;o++)t[o]=arguments[o];return n.apply(void 0,[e].concat(t))}}function d(e,n){var r=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{},t=c({},e);return n.forEach((function(e){t[e]=t[e]||r})),t}function s(e,n){n=n||e,Object.keys(n).forEach((function(r){if(p(n[r])){var t=n[r];n[r]=l(e,t)}}))}function p(e){return"function"==typeof e}function y(e,n,r){return v.apply(this,arguments)}function v(){return(v=u((function*(e,t,o){var i,u=r(e.$plugins);try{for(u.s();!(i=u.n()).done;){var a=i.value;p(a[t])&&(e=yield a[t].apply(a,[e].concat(n(o))))}}catch(e){u.e(e)}finally{u.f()}return e}))).apply(this,arguments)}function h(){return h=u((function*(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};e=d(e,["$dependencies","$external"]),e=d(e,["setup","create"],(function(e){return e}));var n=e,r=n.setup,t=n.create,o={setup:function(e){var n=arguments;return u((function*(){for(var t=n.length,o=new Array(t>1?t-1:0),i=1;i<t;i++)o[i-1]=n[i];return e=yield y(e,"setup",o),r.apply(void 0,[e].concat(o))}))()},create:function(e){var n=arguments;return u((function*(){for(var r=n.length,o=new Array(r>1?r-1:0),i=1;i<r;i++)o[i-1]=n[i];return e=yield y(e,"create",o),t.apply(void 0,[e].concat(o))}))()},$plugins:(e.$plugins||[]).map((function(e){return e()}))};return o.name=e.name,o.version=e.version,o.$dependencies=e.$dependencies,o.$external=e.$external,o.$in={},delete e.name,delete e.version,delete e.$dependencies,delete e.$external,delete e.$plugins,delete e.setup,delete e.create,o=yield o.setup(o,e),s(o=yield o.create(o,e)),Object.seal(o),o})),h.apply(this,arguments)}function g(e){var n=e.name,r=e.version,t=e.createWidget;m().$in.widgetFactory[n+r]=t}function b(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},n=m(),r=e.name,t=e.version,o=n.$in.widgetFactory[r+t];if(!p(o))throw new Error('The widget with defined name and version "'.concat(r+t,'" is not defined.'));return o(e)}function m(){var e=w();return e.__merkur__||(e.__merkur__={$in:{widgets:[],widgetFactory:{}},$external:{},$dependencies:{},register:g,create:b}),e.__merkur__}function w(){return"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:"undefined"!=typeof window?window:"undefined"!=typeof global?global:{}}Object.defineProperty(e,"__esModule",{value:!0}),e.bindWidgetToFunctions=s,e.createMerkur=function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},n=e.$plugins,r=void 0===n?[]:n,t=m();return r.forEach((function(e){e&&p(e.setup)&&e.setup(t)})),t},e.createMerkurWidget=function(){return h.apply(this,arguments)},e.getMerkur=m,e.hookMethod=function(e,n,r){var t=function(e){var n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:"",r=n.split("."),t=r.pop(),o=r.reduce((function(e,n){return e[n]||{}}),e);if(!p(o[t]))throw new Error("Defined path '".concat(n,"' is incorrect. Check your widget structure."));return{target:o,methodName:t}}(e,n),o=t.target,i=t.methodName,u=l(e,o[i]);return o[i]=function(e){for(var n=arguments.length,t=new Array(n>1?n-1:0),o=1;o<n;o++)t[o-1]=arguments[o];return r.apply(void 0,[e,u].concat(t))},u},e.isFunction=p,e.removeMerkur=function(){delete w().__merkur__},e.setDefaultValueForUndefined=d}));
|
package/package.json
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@merkur/core",
|
|
3
|
+
"version": "0.27.0",
|
|
4
|
+
"description": "Merkur is tiny and extensible library for creating front-end microservices.",
|
|
5
|
+
"main": "lib/index",
|
|
6
|
+
"module": "lib/index",
|
|
7
|
+
"unpkg": "lib/index.umd.js",
|
|
8
|
+
"sideEffects": false,
|
|
9
|
+
"exports": {
|
|
10
|
+
".": {
|
|
11
|
+
"import": "./lib/index.mjs",
|
|
12
|
+
"require": "./lib/index.cjs"
|
|
13
|
+
},
|
|
14
|
+
"./lib/index.es9.mjs": "./lib/index.es9.mjs",
|
|
15
|
+
"./lib/index.es9.cjs": "./lib/index.es9.cjs"
|
|
16
|
+
},
|
|
17
|
+
"browser": {
|
|
18
|
+
"./lib/index.js": "./lib/index.es5.js",
|
|
19
|
+
"./lib/index.cjs": "./lib/index.es5.js",
|
|
20
|
+
"./lib/index.mjs": "./lib/index.mjs",
|
|
21
|
+
"./lib/index.es9.mjs": "./lib/index.es9.mjs"
|
|
22
|
+
},
|
|
23
|
+
"scripts": {
|
|
24
|
+
"preversion": "npm test",
|
|
25
|
+
"test": "../../node_modules/.bin/jest --no-watchman -c ./jest.config.js",
|
|
26
|
+
"test:es:version": "../../node_modules/.bin/es-check es5 ./lib/index.es5.js && ../../node_modules/.bin/es-check --module es11 ./lib/index.mjs && ../../node_modules/.bin/es-check --module es9 ./lib/index.es9.mjs && ../../node_modules/.bin/es-check --module es9 ./lib/index.es9.cjs",
|
|
27
|
+
"build": "node_modules/.bin/rollup -c",
|
|
28
|
+
"prepare": "npm run build"
|
|
29
|
+
},
|
|
30
|
+
"repository": {
|
|
31
|
+
"type": "git",
|
|
32
|
+
"url": "git+https://github.com/mjancarik/merkur.git"
|
|
33
|
+
},
|
|
34
|
+
"keywords": [
|
|
35
|
+
"microservices",
|
|
36
|
+
"microfrontends",
|
|
37
|
+
"SSR",
|
|
38
|
+
"merkur",
|
|
39
|
+
"widget",
|
|
40
|
+
"react",
|
|
41
|
+
"preact",
|
|
42
|
+
"svelte"
|
|
43
|
+
],
|
|
44
|
+
"author": "Miroslav Jancarik",
|
|
45
|
+
"license": "ISC",
|
|
46
|
+
"bugs": {
|
|
47
|
+
"url": "https://github.com/mjancarik/merkur/issues"
|
|
48
|
+
},
|
|
49
|
+
"publishConfig": {
|
|
50
|
+
"registry": "https://registry.npmjs.org/",
|
|
51
|
+
"access": "public"
|
|
52
|
+
},
|
|
53
|
+
"homepage": "https://merkur.js.org/",
|
|
54
|
+
"devDependencies": {
|
|
55
|
+
"rollup": "^2.56.2"
|
|
56
|
+
},
|
|
57
|
+
"gitHead": "355cec8cff98356d1ecda30e54957aef076ba7fb"
|
|
58
|
+
}
|