@twobirds/microcomponents 0.1.1 → 0.1.2

package/assets/documentation/tB_react.md

@@ -1,207 +0,0 @@
-# Discussing React Prop Drilling with ChatGPT
-
-This is an interesting read where I wanted ChatGPT to come up with a Micro Component solution for a React problem.
-
-To be honest, I knew MCs can solve it. But I wanted to know what ChatGPT can make of it. Spoiler: it got remarkably close on the first try. The second try was spot on.
-
-Please mind I have a trained session with a backlog. So you wont get the same answers.
-
-***( Cut outs and comments are in parentheses...)***
-
-## Start Session
-
-Me:
-**Do you remember our chat regarding Micro Components vs. existing frameworks?**
-
-ChatGPT:
-
-Yes, I remember our discussion! We talked about your approach to microcomponents as distinct from established frameworks, with a focus on smaller, modular, data-driven components that are stored in a hash attached to DOM elements (specifically in a _tb property in twoBirds or _mc for microcomponents). Your system emphasizes manual wiring, observability, and ease of interaction across components, making it different from React, Vue, or other component libraries that depend heavily on virtual DOMs, JSX, or hooks.
-
-Your components follow principles of separation of concerns and DRY by keeping interactions modular but flexible, and they use observables to trigger functions in other components, which can be linked in chains. Your approach allows a component-based design that integrates deeply into the DOM without the overhead of larger frameworks. And while existing frameworks typically follow a top-down data flow, your system allows bi-directional, observable properties that automatically update the DOM when data changes.
-
-Would you like to revisit any specific aspect, or compare further?
-
-
-## React
-
-Me:
-**There was something about React specifically?**
-
-
-ChatGPT:
-
-(...)
-
-### Manual Wiring vs. React’s Context and Hooks:
-React uses Context and hooks (like useState and useEffect) to manage data flow and lifecycle.
-
-Your approach leans on manual wiring for connecting data across microcomponents, avoiding the abstraction of hooks and allowing direct, observable-driven updates. This can make the flow of data more transparent and easier to trace in complex applications, whereas hooks can sometimes add complexity or obscurity when trying to understand data dependencies.
-
-### Component Reusability and Scaling:
-Both React and Micro Components support component-based architecture.
-
-However, Micro Components allows multiple microcomponents on a single DOM element, and each microcomponent is responsible for specific tasks, making scaling in large applications more modular and straightforward. React encourages separation at the component level, whereas Micro Components does so at the microcomponent level, with direct chaining possible between components.
-
-(...)
-
-Each of these aspects underlines Micro Components’ focus on minimalism, modularity, and developer control. These are different from React's abstraction and tooling-heavy approach, making your framework potentially more transparent and lightweight for specific use cases.
-
-Would you like to dive into any of these differences in more detail?
-
-
-## Prop Drilling
-
-Me:
-**In general there was a problem regarding carrying properties from a component close to the root of the document to a component that is much deeper into the DOM tree, do you remember that?**
-
-ChatGPT:
-
-Yes, I remember!
-
-We discussed the challenges in carrying properties or state from a root-level component down to deeply nested components. In React, this kind of deep property sharing can become cumbersome and often requires additional tools or patterns, such as:
-
-### Prop Drilling:
-React requires passing data through each level of components in the tree via props, a process known as prop drilling. This can lead to complex and hard-to-manage code, especially when the data isn’t relevant to every component in the chain.
-
-(...)
-
-In contrast, your Micro Components microcomponents have an alternative approach that makes it easier to pass properties throughout the DOM tree:
-
-### Direct Microcomponent Selectors:
-Micro Components includes selector methods (like .parents() and .descendants()) that allow components to access any microcomponent within the tree without explicit data passing. This capability enables deeply nested components to retrieve properties from higher-level components directly, bypassing the need to route data through intermediary components.
-
-(...)
-
-### Manual Wiring for Control:
-
-**Because Micro Components rely on manual wiring, you can set up specific connections between components as needed.** This gives you fine-grained control over where and how data flows through the app without involving a top-level state or intermediary components, making it more scalable for larger apps without the need for a Context API or state library.
-
-(...)
-
-This structure offers a highly flexible, context-free solution for deep property sharing, making it an efficient alternative to prop drilling or global state libraries in many scenarios. Would you like more details on how Micro Components selectors work with observables to achieve this?
-
-
-## Generate Code
-
-Me:
-**Can you give an example of 2 react components that interact with each other using micro components? Give me the code of both components, using microomponents to exchange data**
-
-***( it took some further hinting, but in the end ChatGPT came up with this: )***
-
-
-ChatGPT:
-
-Here's the updated code:
-Parent Micro Component
-
-This component will receive a target DOM node and set a value that propagates down to its descendants:
-
-```javascript
-import { MC } from '@twobirds/microcomponents';
-
-// Parent Micro Component
-class ParentMC extends MC {
-  constructor(targetNode) {
-    super(targetNode); // Receive and pass the target DOM node to the MC constructor
-  }
-
-  set value(newValue) {
-    // Send value to all descendants named "targetMC"
-    this.descendants("targetMC").forEach(descendant => descendant.data = newValue);
-  }
-}
-```
-
-Child Micro Component
-
-This component has a data setter that updates the internal React state in each child:
-
-```javascript
-import { MC } from '@twobirds/microcomponents';
-
-// Child Micro Component
-class ChildMC extends MC {
-  constructor(targetNode, setReactState) {
-    super(targetNode); // Receive the target DOM node to be managed by MC
-    this.setReactState = setReactState;
-  }
-
-  set data(newValue) {
-    this.setReactState(newValue); // Update React state when data is set
-  }
-}
-```
-
-React Components Using Micro Components
-
-The following React setup attaches ParentMC and ChildMC to their respective DOM elements, using the parent DOM node to instantiate the micro components.
-Parent Component
-
-The parent component attaches an instance of ParentMC to the DOM node and sets its value based on inputValue.
-
-```javascript
-
-import React, { useState, useRef, useEffect } from 'react';
-import { MC } from '@twobirds/microcomponents';
-import { ParentMC } from '@myCompany/ParentMC';
-
-const ParentComponent = () => {
-  const [inputValue, setInputValue] = useState("");
-  const parentRef = useRef(null);
-  const parentMC = new ParentMC( parentRef );
-  const sender = MC.add(parentRef.current, 'parentMC', parentMC);
-
-  useEffect(() => {
-    // Update value in ParentMC whenever inputValue changes
-    parentMC.value = inputValue;
-  }, [inputValue]);
-
-  return (
-    <div ref={parentRef}>
-      <input
-        type="text"
-        value={inputValue}
-        onChange={(e) => setInputValue( e.target.value )}
-        placeholder="Type to send data to children"
-      />
-      <ChildComponent />
-    </div>
-  );
-};
-```
-
-Child Component
-
-The child component attaches an instance of ChildMC, which updates its state whenever data is set.
-
-```javascript
-import React, { useState, useRef } from 'react';
-import { MC } from '@twobirds/microcomponents';
-import { ChildMC } from '@myCompany/ChildMC';
-
-
-const ChildComponent = () => {
-  const [childData, setChildData] = useState("");
-  const childRef = useRef(null);
-  const childMC = new ChildMC( childRef, setChildData );
-  const receiver = MC.add(childRef.current, 'childMC', childMC);
-
-  return (
-    <div ref={childRef}>
-      <h3>Received Data:</h3>
-      <p>childData</p>
-    </div>
-  );
-};
-```
-
-***( ... I cannot tell about the react part, but the micro coomponent code is spot on. Like WLAN on the DOM :-) )***
-
-
-**ChatGPT can produce errors. Check the information.**
-
-## ... yes I do :-)
-
-***( ... but it was right on the money in the end. I love AI, albeit with a healthy grain of sceptic salt. )***
-
-***( ... and I asked about MCs and Angular likewise, and it directly pointed me to a NG module problem that can also be solved. It even came up with sample code. )***

package/assets/documentation/usage.md

@@ -1,142 +0,0 @@
-# Micro Component Management
-
-This system allows you to attach, manage, and interact with micro components.
-
-**Micro Components** can literally be anything you can put into an object as a property.
-
-Also it has selectors to find micro components in the DOM. It consists of a single class `MC`.
-
-## Summary of MC() Methods
-
-- **Static Methods:**
-  - `MC.add( target, key, element)`: Attach a top level micro component to an HTMLElement.
-  - `MC.remove( target, key )`: Detach a top level micro component from an HTMLElement.
-  - `MC.siblings( target )`: get top level micro components from an HTMLElement.
-
-- **Instance Methods:**
-  - `add( key, element )`: Attach a private Micro Component to a Micro Component.
-  - `remove( key )`: Detach a private Micro Component from a Micro Component.
-  - `siblings(search?)`: Retrieve sibling micro components.
-  - `parent(search?)`: Get parent top level micro components.
-  - `parents(search?)`: Get all ancestor top level micro components.
-  - `children(search?)`: Retrieve child top level micro components.
-  - `descendants(search?)`: Get all descendant top level micro components.
-
-**Micro Components** will most likely be **class instances** that expose inner methods **or an observable collection** for data driven workflows, e.g. business process logic.
-
-## Typical Workflow
-
-1. **Attach micro components** to elements using `MC.add()`.
-2. **Access** micro components by their property key or navigating through DOM (e.g., `siblings()`, `parents()`, `children()`, etc.) **and use their inner functionality**.
-3. **Manipulate** micro components by adding or removing them as needed or change their properties/call their methods.
-
-
-## Hints
-
-- **All static methods handle top level Micro Components. These are PUBLIC, that is they are visible in the DOM elements _mc property and usually have an interface.**
-
-- **All MC instance methods handle inner Micro Components. These are PRIVATE, that is they are not visible in the DOM elements _mc property.**
-
-- **Micro Components can recursively contain Micro Components. Just like npm and the node_modules directory.**
-
-
-## Attaching a top level Micro Component to a DOM element
-
-To attach a micro component to an HTML element, use the `MC.add()` static function.
-
-### Example Usage:
-```javascript
-const myElement = document.getElementById('myDiv');
-
-// Attach a micro component (most often a class instance, here a simple object for simplicity) with a specific key
-MC.add( myElement, 'myComponent', { name: 'Mike' } );
-```
-
-- After you added a micro component using this function, the HTMLElement will contain a  property `_mc` which is a MC() class instance that offers some methods.
-- Also the HTMLElement then has an attribute _mc which will indicate that at least one micro component is attached to this dom element.
-
-## Removing a top level Micro Component from a DOM element
-
-Micro components can be removed using the `MC.remove()` static method.
-
-### Removing a Micro component:
-```javascript
-MC.remove( myDomElement, 'myComponent');
-```
-
-**When all micro components are removed** (the _mc object has no more properties), the `_mc` **attribute is also removed** from the HTML element. The `_mc` **property persists**.
-
-
-## Retrieve all top level Micro Components from a DOM element
-
-The `MC.siblings()` method retrieves all top level micro components attached to the same DOM element.
-
-### Example:
-```javascript
-const target = document.querySelector( 'div' );
-const siblings = MC.siblings( target );
-console.log(siblings);  // Logs an array of top level sibling micro components
-```
-
-To retrieve a specific micro component by its key:
-```javascript
-const target = document.querySelector( 'div' );
-const siblings = MC.siblings( target, 'myOtherComponent' );
-console.log(siblings);  // Logs an array containing a top level sibling micro component, if its key matches the search string
-```
-
-
-## Retrieving Sibling Micro components
-
-The `.siblings()` method retrieves all micro components attached to the same DOM element.
-
-### Example:
-```javascript
-const siblings = myElement._mc.siblings();
-console.log(siblings);  // Logs an array of sibling micro components
-```
-
-To retrieve a specific micro component by its key:
-```javascript
-const specificSibling = myElement._mc.siblings('anotherComponent');
-```
-
-
-- **The following methods hop over HTMLElements that contain no micro component.**
-
-
-## 4. Navigating Parent and Ancestor Micro components
-
-The `_mc.parent()` and `_mc.parents()` methods allow you to retrieve micro components attached to parent elements.
-
-### Example:
-```javascript
-const parentMc = myElement._mc.parent();
-console.log(parentMc);  // Logs micro components closest nachestor that has microcomponents
-
-const allAncestorsMc = myElement._mc.parents();
-console.log(allAncestorsMc);  // Logs all ancestor micro components up to document
-```
-
-To retrieve a specific micro component attached to the parent or ancestors:
-```javascript
-const specificAncestorMc = myElement._mc.parents('myComponent');
-```
-
-## 5. Retrieving Child and Descendant Micro components
-
-The `_mc.children()` and `_mc.descendants()` methods retrieve micro components attached to child elements or any descendants.
-
-### Example:
-```javascript
-const childMicro components = myElement._mc.children();
-console.log(childMicro components);  // Logs an array of nearest child micro components
-
-const descendantMicro components = myElement._mc.descendants();
-console.log(descendantMicro components);  // Logs micro components attached to all descendants
-```
-
-To search for a specific micro component by key:
-```javascript
-const specificMc = myElement._mc.<someComponent>;
-```

package/assets/documentation/why.md

@@ -1,25 +0,0 @@
-
-## Why would I give this a try?
-
-It is lightweight, proven and can yield positive results immediatly.
-
-
-### **As the CTO**:
-
-- **Reusability**: this works with every Javascript framework that allows for DOM access, and it will work as long as the DOM exists in browsers. That is, forever.
-- **Scalability**: scales perfectly by design.
-- **Interoperability**: where many teams in different projects should share specific business or UI logic, you want to have something that works in any JS framework you use.
-
-### **As a Project Manager**:
-
-- **Separation of Concerns**: since this is a modular approach you can **split UI logic from Business logic** and let diffent teams work on each.
-- using this, you can **work with external developers without the need to give them access to your projects code repository**.
-- you will find out that this allows your project to **become independent from the "tools hell"**. You tend to use **DIY** modules where you had tools before.
-
-### **As a Javascript Developer**:
-
-- The learning curve to use this is more than shallow. 1 hour should be enough.
-- This is based on **plain Javascript/Typescript, HTML and CSS**. There is no abstraction layer.
-- From the very start **it is fun to work with**. You are back in control of your code without bigger frameworks, but you are able to interact with them.
-- You can **work for any customer right away**. **No training on their system required**, just fulfill their micro component requirements.
-- Over time, you can **build your own framework or functional libraries** from scratch.

package/assets/fiddle/MicroComponents.svg

@@ -1,15 +0,0 @@
-<svg width="200" height="200" xmlns="http://www.w3.org/2000/svg" xmlns:svg="http://www.w3.org/2000/svg">
- <!-- Created with SVG-edit - http://svg-edit.googlecode.com/ -->
- <title>test</title>
- <rect fill="transparent" x="0" y="0" width="200" height="200" fill-opacity="1"/>
- <g style="fill:transparent">
-  <title>first bird</title>
-  <path fill="#18829c" d="
-    m15,160
-    a30,75 45 1 0 160,-150
-    a20,50 225 1 1 -110,100
-    a12,25 45 1 1 60,-50
-    a20,50 225 1 0 -110,100
-    " />
- </g>
-</svg>

package/assets/test/MicroComponents.svg

@@ -1,15 +0,0 @@
-<svg width="200" height="200" xmlns="http://www.w3.org/2000/svg" xmlns:svg="http://www.w3.org/2000/svg">
- <!-- Created with SVG-edit - http://svg-edit.googlecode.com/ -->
- <title>test</title>
- <rect fill="transparent" x="0" y="0" width="200" height="200" fill-opacity="1"/>
- <g style="fill:transparent">
-  <title>first bird</title>
-  <path fill="#18829c" d="
-    m15,160
-    a30,75 45 1 0 160,-150
-    a20,50 225 1 1 -110,100
-    a12,25 45 1 1 60,-50
-    a20,50 225 1 0 -110,100
-    " />
- </g>
-</svg>

package/assets/test/grandparent.css

@@ -1,16 +0,0 @@
-test-grandparent,
-test-parent,
-test-child,
-test-grandchild,
-test-greatgrandchild {
-	user-select: none;
-	caret-color: transparent;
-
-	display: inline-block;
-	padding: 2px;
-	margin: 1px;
-	border: 1px solid darkslategray;
-	border-radius: 2px;
-}
-
-/*# sourceMappingURL=GrandParent.css.map */

package/assets/test/myButton.css

@@ -1,19 +0,0 @@
-button.myButton {
-	border: 2px solid gray;
-	margin: 3px;
-	padding: 2px 5px;
-	display: inline-block;
-	width: 8em;
-}
-
-button.myButton.clicked {
-	border-color: blue;
-}
-
-button.myButton.overClicked {
-	border-color: orange;
-}
-
-button.myButton:hover {
-	border-color: red;
-}

package/assets/test/style.css

@@ -1,8 +0,0 @@
-body {
-    font-family: Arial, Helvetica, sans-serif;
-}
-
-label {
-    font-weight: bold;
-    color: gray;
-}

package/assets/test/test.html

@@ -1,29 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-	<head>
-		<meta charset="UTF-8" />
-		<meta name="viewport" content="width=device-width, initial-scale=1.0" />
-		<title>Micro Components Manual Test</title>
-		<link
-			rel="icon"
-			type="image/svg+xml"
-			sizes="any"
-			href="./MicroComponents.svg"
-		/>
-		<link href="style.css" rel="stylesheet" />
-		<link href="myButton.css" rel="stylesheet" />
-		<link href="grandparent.css" rel="stylesheet" /> 
-		<script>
-			import("./microcomponents.js").then((m) => {
-				m.autoload(true); // automatically load web components that are undefined
-				Object.assign(window, m);
-			});
-		</script>
-		<script type="module" src="test.js"></script>
-	</head>
-	<body>
-		<h3>Open debugger (F12), check console...</h3>
-		<test-grandparent></test-grandparent>
-		<test-testform data-mc="test-testmc"></test-testform>
-	</body>
-</html>

package/assets/test/testform.json

@@ -1,27 +0,0 @@
-{
-	"textInput":"Hello World",
-	"colorInput":"#eaf8f8",
-	"dateInput":"",
-	"dtlInput":"",
-	"email":"",
-	"hiddenInput":"",
-	"hiddenVal":"",
-	"month":"",
-	"number":"",
-	"passInput":"",
-	"rangeInput":"30",
-	"searchInput":"",
-	"telInput":"",
-	"timeInput":"",
-	"urlInput":"",
-	"weekInput":"",
-	"myRadio":"radio3",
-	"cb1":true,
-	"cb2":false,
-	"cb3":true,
-	"cb4":false,
-	"cb5":false,
-	"singleSelect":"1",
-	"multiSelect":["2","4"],
-	"textArea":"This is some example text\r..."
-}

package/public/.nojekyll

@@ -1 +0,0 @@
-TypeDoc added this file to prevent GitHub Pages from using Jekyll. You can turn off this behavior by setting the `githubPages` option to false.

package/public/MC.d.ts

@@ -1,39 +0,0 @@
-import { LooseObject } from './helpers.js';
-export interface HTMLMcElement extends HTMLElement {
-    _mc: LooseObject;
-}
-declare function off(domNode: Node, eventName: string, handler: EventListenerOrEventListenerObject): void;
-declare function on(domNode: Node, eventName: string, handler: EventListenerOrEventListenerObject, once?: boolean): EventListenerOrEventListenerObject;
-declare function one(domNode: Node, eventName: string, handler: EventListenerOrEventListenerObject): EventListenerOrEventListenerObject;
-declare class BubbleController {
-    stopped: boolean;
-    constructor();
-    stop(): void;
-}
-declare function trigger(domNode: HTMLElement, event: string, data?: any, bubble?: string, controller?: BubbleController): void;
-declare class McBase {
-    private _target;
-    constructor(target?: {
-        [key: string]: any;
-    });
-    get target(): any;
-}
-declare class MC extends McBase {
-    constructor(target?: any);
-}
-declare class DC extends McBase {
-    constructor(target: HTMLElement);
-    static add(target: HTMLElement, key: string, element?: any): HTMLMcElement;
-    static remove(target: HTMLElement, key: string): void;
-    off(eventName: string, handler: EventListenerOrEventListenerObject): void;
-    on(eventName: string, handler: EventListenerOrEventListenerObject): EventListenerOrEventListenerObject;
-    one(eventName: string, handler: EventListenerOrEventListenerObject): EventListenerOrEventListenerObject;
-    trigger(eventName: string, data?: any, bubble?: string, controller?: BubbleController): void;
-    ancestors(): DC[] | null;
-    closest(): DC | null;
-    children(): DC[] | null;
-    descendants(): DC[] | null;
-}
-declare function autoload(enable?: boolean): boolean;
-export { McBase, MC, DC, autoload, on, one, off, trigger };
-//# sourceMappingURL=MC.d.ts.map

package/public/MC.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MC.d.ts","sourceRoot":"","sources":["../src/MC.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAM3C,MAAM,WAAW,aAAc,SAAQ,WAAW;IACjD,GAAG,EAAE,WAAW,CAAC;CACjB;AAmED,iBAAS,GAAG,CAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kCAAkC,QAE1F;AAED,iBAAS,EAAE,CAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kCAAkC,EAAE,IAAI,GAAE,OAAe,GAAI,kCAAkC,CAGtJ;AAED,iBAAS,GAAG,CAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kCAAkC,GAAI,kCAAkC,CAGhI;AAED,cAAM,gBAAgB;IACrB,OAAO,UAAS;;IAGhB,IAAI;CAGJ;AAGD,iBAAS,OAAO,CACf,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,GAAQ,EACd,MAAM,GAAE,MAAY,EACpB,UAAU,CAAC,EAAE,gBAAgB,QA4C7B;AAiDD,cAAM,MAAM;IACX,OAAO,CAAC,OAAO,CAAe;gBAElB,MAAM,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE;IAU3C,IAAI,MAAM,IAAI,GAAG,CAEhB;CAED;AAED,cAAM,EAAG,SAAQ,MAAM;gBACV,MAAM,CAAC,EAAE,GAAG;CAGxB;AAED,cAAM,EAAG,SAAQ,MAAM;gBACV,MAAM,EAAE,WAAW;IAI/B,MAAM,CAAC,GAAG,CAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,GAAQ,GAAI,aAAa;IAIhF,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM;IAK9C,GAAG,CAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kCAAkC;IAInE,EAAE,CAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kCAAkC,GAAI,kCAAkC;IAIxG,GAAG,CAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kCAAkC,GAAI,kCAAkC;IAIzG,OAAO,CAAE,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,GAAQ,EAAE,MAAM,GAAE,MAAY,EAAE,UAAU,CAAC,EAAE,gBAAgB;IAK/F,SAAS,IAAI,EAAE,EAAE,GAAG,IAAI;IAgBxB,OAAO,IAAI,EAAE,GAAG,IAAI;IAOpB,QAAQ,IAAI,EAAE,EAAE,GAAG,IAAI;IAMvB,WAAW,IAAI,EAAE,EAAE,GAAG,IAAI;CAS1B;AAiHD,iBAAS,QAAQ,CAAC,MAAM,GAAE,OAAc,GAAG,OAAO,CAmBjD;AAID,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC"}