@symbiotejs/symbiote 1.1.1

package/LICENSE

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

package/README.md

@@ -0,0 +1,115 @@
+# Symbi<span style="color:#f0f">ఠ</span>te.js
+
+## Ultralight and ultrapowerful library to create widgets, organize micro-frontends, build reusable embeddable components and libraries. Everything you need for your modern web application!
+
+### 🔥 Core benefits
+* Minimalistic but reach
+* No additional dependencies
+* Ultralight (2.7kb br/gzip for featurefull CDN version)
+* Blazing fast (faster than most of the other mainstream solutions. All of them.)
+* Memory friendly (no any redux-like immutables)
+* CSP friendly - good for enterprise usage
+* Highly extensible
+* Easy to learn - nothing completely new for experienced developers, nothing complicated for newbies
+* Works in all modern browsers. As is.
+* Easy to test
+* TypeScript friendly - use it in TS or JS projects from the common source code
+* Integration friendly: works with any modern development stack
+* Lifecycle control: no need to initiate something from outside
+* ESM friendly - native JavaScript modules are best!
+* Developer Experience on the mind: compact & convenient APIs, habitual syntax
+* Open source (MIT license)
+
+### 💎 Tech concept keypoints
+* Native `DocumentFragment` instead of expensive Virtual DOM sync
+* Shadow DOM is optional. Use it when you need it only
+* Styling approach: total freedom, from the old classics to the cutting age platforn abilities
+* Native HTML and DOM API instead of expensive custom template syntax processing
+* Templates are out of the component or render function context. It’s just a simple JavaScript template literals. So you can keep or process them wherever you want
+* No logical operators in templates. Logic and presentation is strictly separated.
+* Fast synchronous UI updates
+* Full data context access from the document structure
+* Full data context availability for template bindings
+* DOM API friendly approach for the most perfomant solutions
+* Convenient object model access instead of opaque abstractions
+* Custom Elements work strange sometimes. Don’t worry about that, we do (construction flow)
+
+### 🍏 Quick start
+Easiest way to try Symbiote.js is to create simple `html` file in your text editor and connect the Symbiote base class from web:
+
+```html
+<script type="module">
+  import { BaseComponent } from 'https://symbiotejs.github.io/symbiote.js/core/BaseComponent.js';
+
+  class MyComponent extends BaseComponent {
+    init$ = {
+      count: 0,
+      increment: () => {
+        this.$.count++;
+      },
+    }
+  }
+
+  MyComponent.template = /*html*/ `
+    <h2 set="textContent: count"></h2>
+    <button set="onclick: increment">Click me!</button>
+  `;
+
+  MyComponent.reg('my-component');
+</script>
+
+<my-component></my-component>
+```
+
+**This code can work directly in any modern browser, so you don't need to install anything to try it!**
+
+## 🧜‍♀️ Dive deeper
+* [Installation](https://github.com/symbiotejs/docsite/blob/main/md/Installation.md)
+* [Templates](https://github.com/symbiotejs/docsite/blob/main/md/Templates.md)
+* [Lifecycle](https://github.com/symbiotejs/docsite/blob/main/md/Lifecycle.md)
+* [Component data context](https://github.com/symbiotejs/docsite/blob/main/md/Component_data_context.md)
+* [Attribute binding](https://github.com/symbiotejs/docsite/blob/main/md/Attribute_binding.md)
+* [Extending](https://github.com/symbiotejs/docsite/blob/main/md/Extending.md)
+* [Naming collisions](https://github.com/symbiotejs/docsite/blob/main/md/Naming_collisions.md)
+* Data (pub/sub)
+* Routing
+* Domain specific data
+* DOM helpers
+* Indexed DB
+* [TypeScript](https://github.com/symbiotejs/docsite/blob/main/md/TypeScript.md)
+* Solution history
+* Playground
+
+## 🤖 Live examples
+Browser: https://symbiotejs.github.io/examples/ 
+> Use devtools to discover details 
+
+GitHub: https://github.com/symbiotejs/examples
+
+## ✅ Browser support
+Symbiote.js is supported and tested in all major modern desktop and mobile browsers: 
+* Chrome
+* Firefox
+* Safari
+* Edge
+* Opera
+* etc...
+
+**Internet Explorer** - is outdated and not supported anymore:
+
+https://uploadcare.com/blog/uploadcare-stops-internet-explorer-support/
+
+(But it's possible with polyfills: https://github.com/webcomponents/polyfills/tree/master/packages/webcomponentsjs)
+
+## 💰 General sponsor
+Big thanks to 🟡 **Uploadcare** for supporting this project!
+
+> https://uploadcare.com/
+
+### 🌎 Useful external links:
+* https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_custom_elements
+* https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_shadow_DOM
+* https://custom-elements-everywhere.com
+* https://open-wc.org/
+
+## If you have questions or proposals - welcome to [Symbiote Discussions](https://github.com/symbiotejs/symbiote.js/discussions)! ❤️