@twobirds/microcomponents 0.0.33 → 0.0.37

package/public/helpers.js

@@ -1,115 +1,79 @@
-"use strict";
-export function isObject(value) {
-    return value != null && typeof value === 'object';
+'use strict';
+export function isNativeObject(value) {
+    return value && value['constructor'] && value.constructor === Object;
 }
-export function kebabToPascal(str) {
-    return str
-        .split('-') // Split by hyphens
-        .map(word => word.charAt(0).toUpperCase() + word.slice(1)) // Capitalize each part
-        .join(''); // Join without spaces
+export function sortObject(o) {
+    let result = {}, keys = [...Object.keys(o)].sort();
+    keys.forEach((key) => {
+        if (isNativeObject(o[key])) {
+            result[key] = sortObject(o[key]);
+        }
+        else {
+            result[key] = o[key];
+        }
+    });
+    return result;
 }
-export function debounce(func, milliseconds) {
-    let timeout;
-    return () => {
-        clearTimeout(timeout);
-        timeout = setTimeout(function () {
-            func(...arguments);
-        }, milliseconds);
-    };
+export function flattenObject(o, doSort = true) {
+    let result = {};
+    [...Object.getOwnPropertyNames(o)].forEach((propName) => {
+        if (o[propName] &&
+            o[propName]['constructor'] &&
+            o[propName].constructor === Object) {
+            const temp = flattenObject(o[propName], false);
+            for (const j in temp) {
+                result[propName + '.' + j] = temp[j];
+            }
+        }
+        else {
+            result[propName] = o[propName];
+        }
+    });
+    return doSort ? sortObject(result) : result;
 }
-;
 export function deepEqual(o1, o2) {
-    const k1 = Object.keys(o1);
-    const k2 = Object.keys(o2);
-    if (k1.length !== k2.length) {
-        return false;
-    }
-    for (const key of k1) {
-        const v1 = o1[key], v2 = o2[key], recurse = isObject(v1) && isObject(v2);
-        ;
-        if ((recurse && !deepEqual(v1, v2))
-            || (!recurse && v1 !== v2)) {
-            return false;
-        }
-    }
-    return true;
+    return (JSON.stringify(flattenObject(o1)) === JSON.stringify(flattenObject(o2)));
 }
-export function nameSpace(ns, obj, val = null, orig) {
-    let leftOver = ns.split('.');
-    if (!orig) {
-        orig = obj;
-    }
-    // console.log( 'start', ns, obj, val, leftOver );
-    let last = leftOver.shift(), // this property name
-    lns = leftOver.join('.') // the leftover namespace
-    ;
-    if (val !== null && last.length && obj[last] === undefined) { // extend if val given and ns leftover...
-        // console.log( 'add prop', last );
-        obj[last] = {};
-    }
-    let lob = obj[last] // the leftover value or obj
-    ;
-    // console.log( 'lob', lob, 'last:', last, 'lns:', lns, 'obj:', obj );
-    if (lns.length === 0) { // this should be the value to set or get
-        if (val !== null) {
-            obj[last] = val;
-            return orig;
-        }
-        return obj[last];
-    }
-    if (isObject(obj[last])) {
-        return nameSpace(lns, obj[last], val, orig);
+export function nameSpace(ns, obj = {}) {
+    let nsa = ns.constructor === String ? ns.split('.') : ns;
+    if (!obj || !nsa[0] || !obj[nsa[0]]) {
+        console.warn('ns', nsa[0], 'not in', obj);
+        return;
     }
-    else {
-        if (val) {
-            return orig;
-        }
-        return lob[last];
+    if (obj[nsa[0]].constructor === Object && nsa.length > 1) {
+        return nameSpace(nsa.splice(1), obj[nsa[0]]);
     }
+    return obj[nsa[0]];
 }
 export function parse(what, parseThis) {
     var args = Array.from(arguments);
-    if (!args.length) {
-        console.error('no arguments give to parse');
-        return;
-    }
-    if (args.length === 1) {
-        return args[1];
-    }
-    else if (args.length > 2) {
+    if (args.length > 2) {
         while (args.length > 1) {
             args[0] = parse(args[0], args[1]);
             args.splice(1, 1);
         }
         return args[0];
     }
-    // implicit else: exactly 2 arguments
     if (typeof what === 'string') {
-        var vars = what.match(/\{[^\{\}]*\}/g);
-        if (!!vars) {
-            vars
-                .forEach(function (pPropname) {
-                var propname = pPropname.substr(1, pPropname.length - 2), value = nameSpace(propname, parseThis);
-                if (typeof value !== 'undefined') {
-                    what = what.replace(pPropname, value);
-                }
-            });
-        }
+        what.match(/\{[^\{\}]*\}/g)?.forEach(function (pPropname) {
+            var propname = pPropname.substring(1, pPropname.length - 1), value = nameSpace(propname, parseThis);
+            //console.log(propname, value);
+            if (typeof value !== 'undefined') {
+                what = what.replace(pPropname, value);
+            }
+        });
     }
-    else if (isObject(what)) {
+    else if (isNativeObject(what)) {
         switch (what.constructor) {
             case Object:
-                Object
-                    .keys(what)
-                    .forEach(function (pKey) {
+                Object.keys(what).forEach(function (pKey) {
                     if (what.hasOwnProperty(pKey)) {
                         what[pKey] = parse(what[pKey], parseThis);
                     }
                 });
                 break;
             case Array:
-                what
-                    .forEach(function (pValue, pKey, original) {
+                what.forEach(function (pValue, pKey, original) {
                     original[pKey] = parse(what[pKey], parseThis);
                 });
                 break;
@@ -117,11 +81,24 @@ export function parse(what, parseThis) {
     }
     return what;
 }
-;
+export function kebabToPascal(str) {
+    return str
+        .split('-') // Split by hyphens
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1)) // Capitalize each part
+        .join(''); // Join without spaces
+}
+export function debounce(func, milliseconds) {
+    let timeout;
+    return () => {
+        clearTimeout(timeout);
+        timeout = setTimeout(function () {
+            func(...arguments);
+        }, milliseconds);
+    };
+}
 export function htmlToElements(html) {
     let template = document.createElement('template');
-    html = html
-        .replace(/<([A-Za-z0-9\-]*)([^>\/]*)(\/>)/gi, "<$1$2></$1>"); // replace XHTML closing tags by full closing tags
+    html = html.replace(/<([A-Za-z0-9\-]*)([^>\/]*)(\/>)/gi, '<$1$2></$1>'); // replace XHTML closing tags by full closing tags
     template.innerHTML = html;
     template.content.normalize();
     return Array.from(template.content.childNodes);

package/public/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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"}

package/public/index.html

@@ -12,49 +12,47 @@
 <div class="col-8 col-content">
 <div class="tsd-page-title">
 <h2>Micro Components</h2></div>
-<div class="tsd-panel tsd-typography">
+<div class="tsd-panel tsd-typography"><p><img src="./MicroComponents.svg" alt="logo"></p>
+
 <a href="#micro-components" id="micro-components" style="color: inherit; text-decoration: none;">
   <h2>MICRO COMPONENTS</h2>
 </a>
-<p><img src="https://gitlab.com/twoBirds/microcomponents/-/raw/main/MicroComponents.svg" alt="Micro Components Logo"></p>
 <p><strong>This code aims at improving Javascript modularity and encapsulation</strong>.</p>
 <p>Using micro components enforces <strong>DRY, KISS and SOLID</strong> principles in Javascript programming.</p>
 
+<a href="#think-building-blocks" id="think-building-blocks" style="color: inherit; text-decoration: none;">
+  <h2>Think <strong>Building Blocks</strong></h2>
+</a>
+<p>When coding with this system, you create classes that extend either the <strong><a href="https://gitlab.com/twoBirds/microcomponents/-/blob/main/assets/documentation/MC.md?ref_type=heads#mc-class-extends-mcbase">MC</a></strong> or <strong><a href="https://gitlab.com/twoBirds/microcomponents/-/blob/main/assets/documentation/MC.md?ref_type=heads#dc-class-extends-mcbase">DC</a></strong> superclasses provided here. These classes provide the structure you need to build your wonderland.</p>
+<p>In an almost literal sense they work like childrens building blocks, where a chest full of unassuming parts lets you compose whatever functionality lies in your imagination.</p>
+<p>This systems <strong>modular</strong> approach gives you full control over your software, without the need to rely on other frameworks. On the other hand, its <strong>minimalistic</strong> stance enables you to use the resulting functionality in any other framework, and makes the <strong>learning curve neglectable</strong>.</p>
+
 <a href="#status" id="status" style="color: inherit; text-decoration: none;">
   <h2>Status</h2>
 </a>
 <p><strong>WIP</strong>. Should be done soon. In <a href="http://twobirds.gitlab.io/microcomponents/test.html">manual testing</a>, also working a lot on the documentation.</p>
 
-<a href="#skippable-disclaimer" id="skippable-disclaimer" style="color: inherit; text-decoration: none;">
-  <h2>Skippable Disclaimer</h2>
-</a>
-<p>I decided to extract this functionality from the <a href="https://www.npmjs.com/package/twobirds-core">twoBirds framework</a>, because it is a useful tool in itself and it is framework agnostic. It relies solely on the standard DOM and native javascript or typescript.</p>
-<p>Later this will be backported into twoBirds as a dependency, and twoBirds will become completely modularized on the base of MCs.</p>
-<p>This is a massive undertaking. MCs are just the foundation of what I do. <strong>I am about to dump</strong> <a href="https://gitlab.com/twoBirds/microcomponents/-/blob/main/assets/documentation/magic.md?ref_type=heads#things-i-already-did-with-this-in-my-own-framework-twobirds-or-in-apps-that-i-developed-with-it">20+ years of javascript programming</a> <strong>into open source libraries</strong>, so feel free to <a href="https://www.gofundme.com/f/nachhaltige-programmierung">fund this</a>. The better this is funded, the faster it will be done. Given enough resources, I will start a crowdfunded company that will develop a new open source ecosystem for javascript/typescript programming. By <strong>&quot;Open Source&quot;</strong> I mean <strong>really free and open</strong>, as <strong>you get all my inner source code with it</strong>. Once you understand the Micro Component principle, you are back in command of your software, no matter what MC functionality you import in your system. Since <strong>Micro Components</strong> are encapsuled, off-shoring and near-shoring is no problem, and reusability is guaranteed. Your external coders do not need to access your code repository or your toolchain. They only need to understand MCs.</p>
-
 <a href="#general" id="general" style="color: inherit; text-decoration: none;">
   <h2>General</h2>
 </a>
-<p><strong>This is a low-level OOP approach to Javascript programming.</strong></p>
-<p>It aims at proving that strict OOP is a valid alternative to other frameworks functional approaches.</p>
-<p>You can use it in vanilla JS or Typescript coding environments. It has been used to create very complex single page applications.</p>
-<p>Also you can use it in any other framework to enhance it with missing functionality.</p>
-<p>This functionality is <strong>portable</strong>, so you can <strong>reuse your MCs</strong> - e.g. originally written in the context of an <strong>Angular</strong> project - in your next <strong>react</strong> project right away.</p>
-<p>In its core it consists of a two classes named <strong>MC</strong> and <strong>DC</strong>. Your class code extends from one of these classes.</p>
+<ul>
+<li><strong>This is a low-level OOP approach to Javascript programming.</strong> It aims at proving that strict OOP is a valid alternative to other frameworks functional approaches.</li>
+<li>You can use it in vanilla JS or Typescript coding environments.</li>
+</ul>
 <p>This repository exports 5 independent functionalities:</p>
 <ol>
-<li><strong><a href="https://gitlab.com/twoBirds/microcomponents/-/blob/main/assets/documentation/MicroComponents.md?ref_type=heads">Micro Components</a></strong> contains the <strong>MC</strong> and <strong>DC</strong> classes you can use as super classes.</li>
-<li><strong>Custom Elements</strong> lets you define and retrieve your own custom elements based on your DC instance code. Uses and re-exports (1).</li>
-<li><strong>Convenience Observables</strong> adds observability and run time type safety to object properties.</li>
-<li><strong>Form Values</strong> gives you 2-way binding between a HTML form and an observable.</li>
-<li>(tbd) <strong>Convenience Selectors</strong> provide jQuery like selectors for both the DOM and micro components.</li>
+<li><strong><a href="https://gitlab.com/twoBirds/microcomponents/-/blob/main/assets/documentation/MC.md?ref_type=heads">Micro Components</a></strong> contains the <strong>MC</strong> and <strong>DC</strong> classes you can use as super classes.</li>
+<li><strong><a href="https://gitlab.com/twoBirds/microcomponents/-/blob/main/assets/documentation/elements.md?ref_type=heads">Elements</a></strong> lets you define and use your own native web components. Uses (1).</li>
+<li>(wip) <strong>Observables</strong> add <strong>observability</strong> and <strong>run time type safety</strong> to object properties. Also they provide <strong>1-way binding</strong> to placeholders in your template HTML.</li>
+<li>(wip) <strong>FormValues</strong> gives you <strong>2-way binding</strong> between a HTML form and an observable object. Uses (3).</li>
+<li>(wip) <strong>Selectors</strong> provide chainable jQuery like selectors for both the DOM and micro components.</li>
 </ol>
 <p>Also there is a bundle file that contains all of the above.</p>
 <p>Check the <a href="https://twobirds.gitlab.io/microcomponents/modules.html">typedoc API reference</a> if you want to drill into the source code.</p>
 <p>To see what can be done, go to <a href="https://gitlab.com/twoBirds/microcomponents/-/blob/main/assets/documentation/magic.md?ref_type=heads">additional concepts</a> which shows what it already has been used for.</p>
 
-<a href="#simple-usage" id="simple-usage" style="color: inherit; text-decoration: none;">
-  <h2>Simple Usage:</h2>
+<a href="#simple-usage-example" id="simple-usage-example" style="color: inherit; text-decoration: none;">
+  <h2>Simple Usage Example</h2>
 </a>
 <p><strong>Micro Components</strong> can be added to to a DOM element like this:</p>
 <p>before:</p>
@@ -66,8 +64,29 @@
 <p>after:</p>
 <pre><code class="language-HTML"><span class="hl-0">&lt;</span><span class="hl-1">div</span><span class="hl-4"> </span><span class="hl-10">_mc</span><span class="hl-0">&gt;&lt;/</span><span class="hl-1">div</span><span class="hl-0">&gt;</span>
 </code></pre>
-<p>_mc indicates that this HTML element contains at least one micro component. This is needed for the selectors.</p>
-<p>The _mc attribute and properties are the only interference with the DOM, so every other system should be happy to work with this.</p>
+<p>The <code>_mc</code> <strong>attribute</strong> indicates that this <strong>HTML element contains at least one micro component</strong>. This is needed for the selectors.</p>
+<p>The <code>_mc</code> <strong>attribute</strong> and <strong>property</strong> are the only interference with the DOM, so any other system should be happy to work with this.</p>
+
+<a href="#disclaimer" id="disclaimer" style="color: inherit; text-decoration: none;">
+  <h2>Disclaimer</h2>
+</a>
+<p>I decided to extract this functionality from the <a href="https://www.npmjs.com/package/twobirds-core">twoBirds framework</a>, because it is a useful tool in itself and it is framework agnostic. It relies solely on the standard DOM and native javascript or typescript.</p>
+<p>Later this will be backported into twoBirds as a dependency, and twoBirds will become completely modularized on the base of MCs.</p>
+<p><strong>This is a massive undertaking.</strong> MCs are just the foundation of what I do. I am about to dump <a href="https://gitlab.com/twoBirds/microcomponents/-/blob/main/assets/documentation/magic.md?ref_type=heads#things-i-already-did-with-this-in-my-own-framework-twobirds-or-in-apps-that-i-developed-with-it">20+ years of javascript programming</a> into open source libraries, so feel free to <a href="https://www.gofundme.com/f/nachhaltige-programmierung">fund this</a>. The better this is funded, the faster it will be done. Given enough resources, I will start a crowdfunded company that will develop a new open source ecosystem for javascript/typescript programming. By <strong>&quot;Open Source&quot;</strong> I mean <strong>really free and open</strong>, as <strong>you get all my inner source code with it</strong>. Once you understand the Micro Component principle, you are back in command of your software, no matter what MC functionality you import in your system.</p>
+<p>Since <strong>Micro Components</strong> are encapsuled, off-shoring and near-shoring is no problem, and reusability is guaranteed. Your external coders do not need to access your code repository or your toolchain. They only need to understand MCs.</p>
+
+<a href="#distinct-differences-to-other-frameworks" id="distinct-differences-to-other-frameworks" style="color: inherit; text-decoration: none;">
+  <h2>Distinct differences to other frameworks</h2>
+</a>
+<p>There are a few potentially unique aspects of this micro components system that might differentiate it from other frameworks:</p>
+<ul>
+<li><strong>Pure OOP Approach</strong>: The system explicitly positions itself as a strict object-oriented alternative to the functional approaches that dominate many modern frameworks.</li>
+<li><strong>Minimal Interference</strong>: The system has minimal DOM interference (only adding _mc attribute and property). This makes it unusually compatible with other frameworks or libraries.</li>
+<li><strong>Hierarchical Component Traversal</strong>: The built-in parent/child/ancestor/descendant traversal methods provide a clean way to navigate component relationships.</li>
+<li><strong>Direct DOM Integration</strong>: Unlike virtual DOM-based frameworks, this approach works directly with the actual DOM while still providing component encapsulation.</li>
+<li><strong>Outsourcing Potential</strong>: Your external coders do not need to access your code repository or your toolchain.</li>
+</ul>
+<p>The strongest argument might be for developers who prefer OOP, want minimal framework lock-in, and need a lightweight solution that works well with existing code or other libraries.</p>
 
 <a href="#contact" id="contact" style="color: inherit; text-decoration: none;">
   <h2>Contact</h2>
@@ -96,16 +115,12 @@
 <div class="tsd-accordion-details">
 <ul>
 <li class="current selected"><a href="modules.html">Micro <wbr/>Components</a>
-<ul></ul></li></ul></div></details></nav>
-<nav class="tsd-navigation secondary menu-sticky">
 <ul>
-<li class="tsd-kind-class"><a href="classes/DC.html" class="tsd-index-link"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-class)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6" id="icon-128-path"></rect><path d="M11.898 16.1201C11.098 16.1201 10.466 15.8961 10.002 15.4481C9.53803 15.0001 9.30603 14.3841 9.30603 13.6001V9.64012C9.30603 8.85612 9.53803 8.24012 10.002 7.79212C10.466 7.34412 11.098 7.12012 11.898 7.12012C12.682 7.12012 13.306 7.34812 13.77 7.80412C14.234 8.25212 14.466 8.86412 14.466 9.64012H13.386C13.386 9.14412 13.254 8.76412 12.99 8.50012C12.734 8.22812 12.37 8.09212 11.898 8.09212C11.426 8.09212 11.054 8.22412 10.782 8.48812C10.518 8.75212 10.386 9.13212 10.386 9.62812V13.6001C10.386 14.0961 10.518 14.4801 10.782 14.7521C11.054 15.0161 11.426 15.1481 11.898 15.1481C12.37 15.1481 12.734 15.0161 12.99 14.7521C13.254 14.4801 13.386 14.0961 13.386 13.6001H14.466C14.466 14.3761 14.234 14.9921 13.77 15.4481C13.306 15.8961 12.682 16.1201 11.898 16.1201Z" fill="var(--color-text)" id="icon-128-text"></path></svg>DC</a></li>
-<li class="tsd-kind-class"><a href="classes/MC.html" class="tsd-index-link"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><use href="#icon-128-path"></use><use href="#icon-128-text"></use></svg>MC</a></li>
-<li class="tsd-kind-class"><a href="classes/McBase.html" class="tsd-index-link"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><use href="#icon-128-path"></use><use href="#icon-128-text"></use></svg>Mc<wbr/>Base</a></li>
-<li class="tsd-kind-class"><a href="classes/McEvent.html" class="tsd-index-link"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><use href="#icon-128-path"></use><use href="#icon-128-text"></use></svg>Mc<wbr/>Event</a></li>
-<li class="tsd-kind-interface"><a href="interfaces/HTMLMcElement.html" class="tsd-index-link"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-interface)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6" id="icon-256-path"></rect><path d="M9.51 16V15.016H11.298V8.224H9.51V7.24H14.19V8.224H12.402V15.016H14.19V16H9.51Z" fill="var(--color-text)" id="icon-256-text"></path></svg>HTMLMc<wbr/>Element</a></li>
-<li class="tsd-kind-function"><a href="functions/addListener.html" class="tsd-index-link"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-function)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6" id="icon-64-path"></rect><path d="M9.39 16V7.24H14.55V8.224H10.446V11.128H14.238V12.112H10.47V16H9.39Z" fill="var(--color-text)" id="icon-64-text"></path></svg>add<wbr/>Listener</a></li>
-<li class="tsd-kind-function"><a href="functions/removeListener.html" class="tsd-index-link"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><use href="#icon-64-path"></use><use href="#icon-64-text"></use></svg>remove<wbr/>Listener</a></li></ul></nav></div></div>
+<li class="tsd-kind-module"><a href="modules/MC.html">MC</a></li>
+<li class="tsd-kind-module"><a href="modules/elements.html">elements</a></li>
+<li class="tsd-kind-module"><a href="modules/formValues.html">form<wbr/>Values</a></li>
+<li class="tsd-kind-module"><a href="modules/observables.html">observables</a></li>
+<li class="tsd-kind-module"><a href="modules/selectors.html">selectors</a></li></ul></li></ul></div></details></nav></div></div>
 <div class="container tsd-generator">
 <p>Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></div>
 <div class="overlay"></div><script src="assets/main.js"></script></body></html>