@twobirds/microcomponents 0.0.20 → 0.0.22

package/public/MC.js

@@ -0,0 +1,273 @@
+"use strict";
+import { McEvent } from './McEvent.js';
+var isBrowser = new Function("try {return this===window;}catch(e){ return false;}");
+let nativeEventNames = new Set();
+// HTMLElement native event names
+if (isBrowser()) {
+    Object.keys(HTMLElement.prototype).filter(key => /^on/.test(key)).forEach(eventName => nativeEventNames.add(eventName));
+}
+// get all microcomponents from a list of HTMLElements
+function getMicroComponents(elements, search) {
+    let mcValues = [];
+    elements.forEach(e => {
+        if (e) {
+            if (e instanceof HTMLElement) {
+                const _mc = e?._mc;
+                if (!search && _mc) {
+                    mcValues = mcValues.concat(Object.values(e._mc));
+                }
+                else if (search && _mc && _mc[search]) {
+                    mcValues.push(_mc[search]);
+                }
+            }
+        }
+    });
+    return mcValues;
+}
+// get all ancestor DOM nodes up to the document root
+function traverseNodes(node, search, firstonly = true) {
+    let mcValues = [];
+    while (node) {
+        if (node._mc) {
+            if (!search) {
+                mcValues = mcValues.concat(Object.values(node._mc));
+            }
+            else if (search && node._mc[search]) {
+                mcValues.push(node._mc[search]);
+            }
+            if (firstonly)
+                return mcValues;
+        }
+        node = node.parentNode;
+    }
+    return mcValues;
+}
+function isDOM(element) {
+    return element && element instanceof HTMLElement;
+}
+function addListener(domNode, eventName, handler, capture = false, once = false) {
+    let options = { once: false };
+    if (capture) {
+        options.capture = capture;
+    }
+    if (once) {
+        options.once = once;
+    }
+    //console.log( 'addEventListener', eventName, ( handler as Function ).name, options );
+    domNode.addEventListener(eventName, handler, options);
+}
+function removeListener(domNode, eventName, handler) {
+    domNode.removeEventListener(eventName, handler);
+}
+// add a microcomponent to a target DOM node
+function add(target, key, element = {}) {
+    let node = target;
+    // create the _mc property if necessary
+    if (!node._mc) {
+        let _MC = MC, debug = MC?.debug;
+        MC.debug = false;
+        node._mc = new MC(target);
+        MC.debug = debug;
+    }
+    const _mc = node._mc;
+    // add the element with the given property key to the _mc property
+    if (key.length && !_mc[key]) {
+        _mc[key] = element;
+        // add attribute if HTMLElement
+        if (target instanceof HTMLElement) {
+            target.setAttribute('_mc', '');
+        }
+    }
+    return element;
+}
+// remove a micro component from the DOM
+function remove(target, key) {
+    if (!key)
+        return; // silent fail
+    const _mc = target?._mc || {};
+    // delete the property from the HTMLElement _mc collection
+    if (_mc && _mc[key]) {
+        delete _mc[key];
+    }
+    // remove the _mc attribute if the DOM collection is empty
+    if (!Object.keys(_mc).length && target instanceof HTMLElement && target.hasAttribute('_mc')) {
+        target.removeAttribute('_mc');
+    }
+    return;
+}
+// trigger an event
+function trigger(target, ev, data = {}) {
+    let _mc = target?._mc;
+    if (!_mc)
+        return;
+    [...Object.values(_mc)].forEach((mc) => {
+        if (mc?.trigger && typeof mc?.trigger === 'function') {
+            mc?.trigger(ev, data);
+        }
+    });
+    return;
+}
+class McBase {
+    #target; // avoid circular reference
+    #_mc = {};
+    constructor(target) {
+        let that = this;
+        this.#target = new WeakRef(target);
+        if (this.constructor !== MC && this.constructor !== DC) {
+            Object.defineProperty(this, "_mc", {
+                get() {
+                    return this.#_mc;
+                }
+            });
+        }
+    }
+    get target() {
+        return this.#target.deref();
+    }
+}
+class MC extends McBase {
+    constructor(target) {
+        super(target);
+        let that = this;
+        if (that.constructor === MC || that.constructor === DC)
+            return;
+        setTimeout(() => {
+            that.trigger('init');
+        }, 0);
+    }
+    trigger(ev, data = {}, bubble) {
+        let that = this;
+        bubble = bubble || 'l';
+        // run all triggers
+        if (that.constructor === MC || that.constructor === DC) {
+            [...Object.getOwnPropertyNames(that)].forEach((mc) => {
+                if (that[mc]?.trigger && typeof that[mc]?.trigger === 'function') {
+                    that[mc]?.trigger(ev, data, bubble);
+                }
+            });
+            return; // must return here!
+        }
+        // only this instance
+        if (that instanceof MC || that instanceof DC) {
+            const that = this, mcEvent = typeof ev !== 'string' ? ev : new McEvent(ev, data, bubble), handlerName = 'on' + mcEvent.type[0].toUpperCase() + mcEvent.type.slice(1);
+            ;
+            // console.log('trigger', handlerName, mcEvent, data, bubble );
+            if (mcEvent.bubble.indexOf('l') > -1) {
+                if (!mcEvent.immediateStopped
+                    && typeof that[handlerName] === 'function') {
+                    // console.log( 'execute handler:', handlerName );
+                    that[handlerName](mcEvent);
+                    if (that.hasOwnProperty(handlerName)) { // it is a once handler
+                        delete that[handlerName]; // remove after first execution
+                    }
+                }
+            }
+            // if event stopped or local only, handling is cancelled
+            if (mcEvent.stopped || mcEvent.bubble === 'l') {
+                return that;
+            }
+            // at this point, either 'u' or 'd' bubbling should be indicated
+            // mcEvent bubbling is asynchronous, and the order of target MC execution in case of multiple matches is not guaranteed!
+            if (isBrowser() && /[ud]/.test(mcEvent.bubble) && that instanceof MC) {
+                setTimeout(() => {
+                    // bubbling must include 'l' for local, or else no handlers are executed'
+                    if (mcEvent.bubble.indexOf('l') === -1) {
+                        mcEvent.bubble += 'l';
+                    }
+                    // bubble up towards root
+                    if (mcEvent.bubble.indexOf('u') > -1) {
+                        that
+                            .parent()
+                            .forEach((mc) => {
+                            mc instanceof MC ? mc.trigger(mcEvent) : null;
+                        });
+                    }
+                    // bubble down
+                    if (mcEvent.bubble.indexOf('d') > -1) {
+                        that
+                            .children()
+                            .forEach((mc) => {
+                            mc instanceof MC ? mc.trigger(mcEvent) : null;
+                        });
+                    }
+                }, 0);
+            }
+        }
+    }
+}
+;
+class DC extends MC {
+    constructor(target) {
+        super(target);
+    }
+    static debug = false;
+    static add = add;
+    static remove = remove;
+    static trigger = trigger;
+    parent(search = '') {
+        let target = this.target;
+        if (!isDOM(target))
+            return [];
+        return traverseNodes(target.parentNode, search, true);
+    }
+    ancestors(search = '') {
+        let target = this?.target;
+        if (!isDOM(target))
+            return [];
+        return traverseNodes(this.target.parentNode, search, false);
+    }
+    children(search = '') {
+        let target = this?.target;
+        if (!isDOM(target))
+            return [];
+        const id = Math.random().toString().replace('.', '');
+        const selector = '[_mc]:not([temp_id="' + id + '"] [_mc] [_mc])';
+        target.setAttribute('temp_id', id);
+        const myDomElements = target.querySelectorAll(selector);
+        const mcValues = getMicroComponents([...myDomElements], search);
+        target.removeAttribute('temp_id');
+        return mcValues;
+    }
+    descendants(search = '') {
+        let target = this?.target;
+        if (!isDOM(target))
+            return [];
+        const myDomElements = target.querySelectorAll('*[_mc]');
+        return getMicroComponents([...myDomElements], search);
+    }
+    autoAttachListeners() {
+        if (!isBrowser())
+            return;
+        const target = this.target;
+        if (target instanceof HTMLElement) {
+            let that = this;
+            Object
+                .getOwnPropertyNames(that.constructor.prototype)
+                .filter(key => /^on[A-Z]|one[A-Z]/.test(key) && typeof that.constructor.prototype[key] === 'function')
+                .forEach(key => {
+                let once = /^one/.test(key), withoutOnOne = key.replace(/^on[e]{0,1}/, ''), // preserves upper/lowercase for non-native events
+                nativeEventName = withoutOnOne.toLowerCase(), listener = (ev) => { that.trigger(withoutOnOne, ev); };
+                ;
+                // console.log('autoAttach', nativeEventName, withoutOnOne, once, listener);
+                if (once) {
+                    // console.log( '...is only called once', that.constructor.prototype[key] );
+                    Object.defineProperty(this, 'on' + withoutOnOne, {
+                        configurable: true,
+                        enumerable: false,
+                        writable: true,
+                        value: (ev) => {
+                            // console.log( 'onceHandler execute:', that.constructor.prototype[key] );
+                            (that.constructor.prototype[key]).bind(that)(ev);
+                        }
+                    });
+                }
+                if (nativeEventNames.has('on' + nativeEventName)) { // native event defined in HTMLElement
+                    // console.log('added as native listener', target, nativeEventName );
+                    addListener(target, nativeEventName, listener, false, once);
+                }
+            });
+        }
+    }
+}
+;
+export { addListener, removeListener, McBase, MC, DC, McEvent };

package/public/MC.min.js

@@ -0,0 +1,414 @@
+(function webpackUniversalModuleDefinition(root, factory) {
+	if(typeof exports === 'object' && typeof module === 'object')
+		module.exports = factory();
+	else if(typeof define === 'function' && define.amd)
+		define([], factory);
+	else if(typeof exports === 'object')
+		exports["MC"] = factory();
+	else
+		root["MC"] = factory();
+})(this, () => {
+return /******/ (() => { // webpackBootstrap
+/******/ 	"use strict";
+/******/ 	// The require scope
+/******/ 	var __webpack_require__ = {};
+/******/ 	
+/************************************************************************/
+/******/ 	/* webpack/runtime/define property getters */
+/******/ 	(() => {
+/******/ 		// define getter functions for harmony exports
+/******/ 		__webpack_require__.d = (exports, definition) => {
+/******/ 			for(var key in definition) {
+/******/ 				if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {
+/******/ 					Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });
+/******/ 				}
+/******/ 			}
+/******/ 		};
+/******/ 	})();
+/******/ 	
+/******/ 	/* webpack/runtime/hasOwnProperty shorthand */
+/******/ 	(() => {
+/******/ 		__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))
+/******/ 	})();
+/******/ 	
+/******/ 	/* webpack/runtime/make namespace object */
+/******/ 	(() => {
+/******/ 		// define __esModule on exports
+/******/ 		__webpack_require__.r = (exports) => {
+/******/ 			if(typeof Symbol !== 'undefined' && Symbol.toStringTag) {
+/******/ 				Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+/******/ 			}
+/******/ 			Object.defineProperty(exports, '__esModule', { value: true });
+/******/ 		};
+/******/ 	})();
+/******/ 	
+/************************************************************************/
+var __webpack_exports__ = {};
+// ESM COMPAT FLAG
+__webpack_require__.r(__webpack_exports__);
+
+// EXPORTS
+__webpack_require__.d(__webpack_exports__, {
+  DC: () => (/* binding */ DC),
+  MC: () => (/* binding */ MC),
+  McBase: () => (/* binding */ McBase),
+  McEvent: () => (/* reexport */ McEvent),
+  addListener: () => (/* binding */ addListener),
+  removeListener: () => (/* binding */ removeListener)
+});
+
+;// ./build/McEvent.js
+
+var isBrowser = new Function("try {return this===window;}catch(e){ return false;}");
+let nativeEventNames = new Set();
+// HTMLElement native event names
+if (isBrowser()) {
+    Object.keys(HTMLElement.prototype).filter(key => /^on/.test(key)).forEach(eventName => nativeEventNames.add(eventName));
+}
+function isDOM(element) {
+    return element && element instanceof HTMLElement;
+}
+class McEvent {
+    #type;
+    #stopped = false;
+    #immediateStopped = false;
+    constructor(type, data = {}, bubble = 'l') {
+        // bubble standard = local only, options = any combination of'uld' characters: up to root, local, down
+        this.#type = type;
+        this.data = data;
+        this.bubble = bubble;
+    }
+    get type() {
+        return this.#type;
+    }
+    get stopped() {
+        return this.#stopped;
+    }
+    get immediateStopped() {
+        return this.#immediateStopped;
+    }
+    stopPropagation() {
+        this.#stopped = true;
+    }
+    stopImmediatePropagation() {
+        this.stopPropagation();
+        this.#immediateStopped = true;
+    }
+}
+// get all microcomponents from a list of HTMLElements
+function getMicroComponents(elements, search) {
+    let mcValues = [];
+    elements.forEach(e => {
+        if (e) {
+            if (e instanceof HTMLElement) {
+                const _mc = e?._mc;
+                if (!search && _mc) {
+                    mcValues = mcValues.concat(Object.values(e._mc));
+                }
+                else if (search && _mc && _mc[search]) {
+                    mcValues.push(_mc[search]);
+                }
+            }
+        }
+    });
+    return mcValues;
+}
+// get all ancestor DOM nodes up to the document root
+function traverseNodes(node, search, firstonly = true) {
+    let mcValues = [];
+    while (node) {
+        if (node._mc) {
+            if (!search) {
+                mcValues = mcValues.concat(Object.values(node._mc));
+            }
+            else if (search && node._mc[search]) {
+                mcValues.push(node._mc[search]);
+            }
+            if (firstonly)
+                return mcValues;
+        }
+        node = node.parentNode;
+    }
+    return mcValues;
+}
+
+
+;// ./build/MC.js
+
+
+var MC_isBrowser = new Function("try {return this===window;}catch(e){ return false;}");
+let MC_nativeEventNames = new Set();
+// HTMLElement native event names
+if (MC_isBrowser()) {
+    Object.keys(HTMLElement.prototype).filter(key => /^on/.test(key)).forEach(eventName => MC_nativeEventNames.add(eventName));
+}
+// get all microcomponents from a list of HTMLElements
+function MC_getMicroComponents(elements, search) {
+    let mcValues = [];
+    elements.forEach(e => {
+        if (e) {
+            if (e instanceof HTMLElement) {
+                const _mc = e?._mc;
+                if (!search && _mc) {
+                    mcValues = mcValues.concat(Object.values(e._mc));
+                }
+                else if (search && _mc && _mc[search]) {
+                    mcValues.push(_mc[search]);
+                }
+            }
+        }
+    });
+    return mcValues;
+}
+// get all ancestor DOM nodes up to the document root
+function MC_traverseNodes(node, search, firstonly = true) {
+    let mcValues = [];
+    while (node) {
+        if (node._mc) {
+            if (!search) {
+                mcValues = mcValues.concat(Object.values(node._mc));
+            }
+            else if (search && node._mc[search]) {
+                mcValues.push(node._mc[search]);
+            }
+            if (firstonly)
+                return mcValues;
+        }
+        node = node.parentNode;
+    }
+    return mcValues;
+}
+function MC_isDOM(element) {
+    return element && element instanceof HTMLElement;
+}
+function addListener(domNode, eventName, handler, capture = false, once = false) {
+    let options = { once: false };
+    if (capture) {
+        options.capture = capture;
+    }
+    if (once) {
+        options.once = once;
+    }
+    //console.log( 'addEventListener', eventName, ( handler as Function ).name, options );
+    domNode.addEventListener(eventName, handler, options);
+}
+function removeListener(domNode, eventName, handler) {
+    domNode.removeEventListener(eventName, handler);
+}
+// add a microcomponent to a target DOM node
+function add(target, key, element = {}) {
+    let node = target;
+    // create the _mc property if necessary
+    if (!node._mc) {
+        let _MC = MC, debug = MC?.debug;
+        MC.debug = false;
+        node._mc = new MC(target);
+        MC.debug = debug;
+    }
+    const _mc = node._mc;
+    // add the element with the given property key to the _mc property
+    if (key.length && !_mc[key]) {
+        _mc[key] = element;
+        // add attribute if HTMLElement
+        if (target instanceof HTMLElement) {
+            target.setAttribute('_mc', '');
+        }
+    }
+    return element;
+}
+// remove a micro component from the DOM
+function remove(target, key) {
+    if (!key)
+        return; // silent fail
+    const _mc = target?._mc || {};
+    // delete the property from the HTMLElement _mc collection
+    if (_mc && _mc[key]) {
+        delete _mc[key];
+    }
+    // remove the _mc attribute if the DOM collection is empty
+    if (!Object.keys(_mc).length && target instanceof HTMLElement && target.hasAttribute('_mc')) {
+        target.removeAttribute('_mc');
+    }
+    return;
+}
+// trigger an event
+function trigger(target, ev, data = {}) {
+    let _mc = target?._mc;
+    if (!_mc)
+        return;
+    [...Object.values(_mc)].forEach((mc) => {
+        if (mc?.trigger && typeof mc?.trigger === 'function') {
+            mc?.trigger(ev, data);
+        }
+    });
+    return;
+}
+class McBase {
+    #target; // avoid circular reference
+    #_mc = {};
+    constructor(target) {
+        let that = this;
+        this.#target = new WeakRef(target);
+        if (this.constructor !== MC && this.constructor !== DC) {
+            Object.defineProperty(this, "_mc", {
+                get() {
+                    return this.#_mc;
+                }
+            });
+        }
+    }
+    get target() {
+        return this.#target.deref();
+    }
+}
+class MC extends McBase {
+    constructor(target) {
+        super(target);
+        let that = this;
+        if (that.constructor === MC || that.constructor === DC)
+            return;
+        setTimeout(() => {
+            that.trigger('init');
+        }, 0);
+    }
+    trigger(ev, data = {}, bubble) {
+        let that = this;
+        bubble = bubble || 'l';
+        // run all triggers
+        if (that.constructor === MC || that.constructor === DC) {
+            [...Object.getOwnPropertyNames(that)].forEach((mc) => {
+                if (that[mc]?.trigger && typeof that[mc]?.trigger === 'function') {
+                    that[mc]?.trigger(ev, data, bubble);
+                }
+            });
+            return; // must return here!
+        }
+        // only this instance
+        if (that instanceof MC || that instanceof DC) {
+            const that = this, mcEvent = typeof ev !== 'string' ? ev : new McEvent(ev, data, bubble), handlerName = 'on' + mcEvent.type[0].toUpperCase() + mcEvent.type.slice(1);
+            ;
+            // console.log('trigger', handlerName, mcEvent, data, bubble );
+            if (mcEvent.bubble.indexOf('l') > -1) {
+                if (!mcEvent.immediateStopped
+                    && typeof that[handlerName] === 'function') {
+                    // console.log( 'execute handler:', handlerName );
+                    that[handlerName](mcEvent);
+                    if (that.hasOwnProperty(handlerName)) { // it is a once handler
+                        delete that[handlerName]; // remove after first execution
+                    }
+                }
+            }
+            // if event stopped or local only, handling is cancelled
+            if (mcEvent.stopped || mcEvent.bubble === 'l') {
+                return that;
+            }
+            // at this point, either 'u' or 'd' bubbling should be indicated
+            // mcEvent bubbling is asynchronous, and the order of target MC execution in case of multiple matches is not guaranteed!
+            if (MC_isBrowser() && /[ud]/.test(mcEvent.bubble) && that instanceof MC) {
+                setTimeout(() => {
+                    // bubbling must include 'l' for local, or else no handlers are executed'
+                    if (mcEvent.bubble.indexOf('l') === -1) {
+                        mcEvent.bubble += 'l';
+                    }
+                    // bubble up towards root
+                    if (mcEvent.bubble.indexOf('u') > -1) {
+                        that
+                            .parent()
+                            .forEach((mc) => {
+                            mc instanceof MC ? mc.trigger(mcEvent) : null;
+                        });
+                    }
+                    // bubble down
+                    if (mcEvent.bubble.indexOf('d') > -1) {
+                        that
+                            .children()
+                            .forEach((mc) => {
+                            mc instanceof MC ? mc.trigger(mcEvent) : null;
+                        });
+                    }
+                }, 0);
+            }
+        }
+    }
+}
+;
+class DC extends MC {
+    constructor(target) {
+        super(target);
+    }
+    static debug = false;
+    static add = add;
+    static remove = remove;
+    static trigger = trigger;
+    parent(search = '') {
+        let target = this.target;
+        if (!MC_isDOM(target))
+            return [];
+        return MC_traverseNodes(target.parentNode, search, true);
+    }
+    ancestors(search = '') {
+        let target = this?.target;
+        if (!MC_isDOM(target))
+            return [];
+        return MC_traverseNodes(this.target.parentNode, search, false);
+    }
+    children(search = '') {
+        let target = this?.target;
+        if (!MC_isDOM(target))
+            return [];
+        const id = Math.random().toString().replace('.', '');
+        const selector = '[_mc]:not([temp_id="' + id + '"] [_mc] [_mc])';
+        target.setAttribute('temp_id', id);
+        const myDomElements = target.querySelectorAll(selector);
+        const mcValues = MC_getMicroComponents([...myDomElements], search);
+        target.removeAttribute('temp_id');
+        return mcValues;
+    }
+    descendants(search = '') {
+        let target = this?.target;
+        if (!MC_isDOM(target))
+            return [];
+        const myDomElements = target.querySelectorAll('*[_mc]');
+        return MC_getMicroComponents([...myDomElements], search);
+    }
+    autoAttachListeners() {
+        if (!MC_isBrowser())
+            return;
+        const target = this.target;
+        if (target instanceof HTMLElement) {
+            let that = this;
+            Object
+                .getOwnPropertyNames(that.constructor.prototype)
+                .filter(key => /^on[A-Z]|one[A-Z]/.test(key) && typeof that.constructor.prototype[key] === 'function')
+                .forEach(key => {
+                let once = /^one/.test(key), withoutOnOne = key.replace(/^on[e]{0,1}/, ''), // preserves upper/lowercase for non-native events
+                nativeEventName = withoutOnOne.toLowerCase(), listener = (ev) => { that.trigger(withoutOnOne, ev); };
+                ;
+                // console.log('autoAttach', nativeEventName, withoutOnOne, once, listener);
+                if (once) {
+                    // console.log( '...is only called once', that.constructor.prototype[key] );
+                    Object.defineProperty(this, 'on' + withoutOnOne, {
+                        configurable: true,
+                        enumerable: false,
+                        writable: true,
+                        value: (ev) => {
+                            // console.log( 'onceHandler execute:', that.constructor.prototype[key] );
+                            (that.constructor.prototype[key]).bind(that)(ev);
+                        }
+                    });
+                }
+                if (MC_nativeEventNames.has('on' + nativeEventName)) { // native event defined in HTMLElement
+                    // console.log('added as native listener', target, nativeEventName );
+                    addListener(target, nativeEventName, listener, false, once);
+                }
+            });
+        }
+    }
+}
+;
+
+
+/******/ 	return __webpack_exports__;
+/******/ })()
+;
+});

package/public/MCbundle.js

@@ -0,0 +1,8 @@
+"use strict";
+export * from './helpers.js';
+export * from './MC.js';
+export * from './McEvent.js';
+export * from './customElements.js';
+export * from './customObservables.js';
+export * from './customSelectors.js';
+export * from './formValues.js';