jj 2.8.0 → 3.0.0-rc.3

package/README.md

@@ -4,8 +4,39 @@
 
 **JJ** is a lightweight, no-transpilation library for modern web development. What You Write Is What Is Run (WYWIWIR).
 
+JJ complements browser-native capabilities instead of replacing them with a thick abstraction layer.
+It is designed for moderate to advanced web developers and AI agents that want fluent DOM helpers while staying close to standards.
+
 ## ⚡ Quick Start
 
+CDN:
+
+[Import map](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script/type/importmap): Add this to your HTML:
+
+```html
+<script type="importmap">
+    {
+        "jj": "https://cdn.jsdelivr.net/npm/jj/lib/bundle.min.js"
+        // Or a specific version
+        "jj": "https://cdn.jsdelivr.net/npm/jj@2/lib/bundle.min.js
+    }
+</script>
+```
+
+And then:
+
+```js
+import { JJHE } from 'jj'
+```
+
+CDN:
+
+```js
+import { JJHE } from 'https://cdn.jsdelivr.net/npm/jj/lib/bundle.min.js'
+```
+
+NPM:
+
 ```bash
 npm i jj
 ```
@@ -19,12 +50,26 @@ JJHE.create('div')
     .on('click', () => console.log('Hi'))
 ```
 
+Use namespace-aware wrappers for non-HTML elements:
+
+```js
+import { JJSE, JJME } from 'jj'
+
+const icon = JJSE.create('svg').setAttr('viewBox', '0 0 24 24')
+const formula = JJME.create('math').addChild(JJME.create('mi').setText('x'))
+```
+
 ## 🚀 Why JJ?
 
 - **Zero Build** – Runs directly in modern browsers
+- **Zero Dependencies** – Integrated, efficient, and not vulnerable to supply chain attacks
 - **Native Speed** – Direct DOM manipulation, no VDOM overhead
 - **Web Standards** – First-class Web Components support
 - **Fluent API** – Chainable methods for cleaner code
+- **AI-Optimized** – Comes with up to date skills that are versioned with the lib
+- **Well documented** - Tutorials, guides, API docs and FAQs
+
+JJ is **not** a reactive framework, template compiler, or state-management system.
 
 ## 📚 Learn More
 
@@ -49,8 +94,8 @@ The skill definition (`SKILL.md`) is also included in the npm package at `node_m
 
 ## ✅ Testing
 
-The entire public API is tested thoroghly.
-Tests live in the `test/` folder and mirror the source filenames (e.g., `test/JJE.test.ts` for `src/JJE.ts`) while importing the target from `./src/index.js`.
+The entire public API is tested thoroughly.
+Tests live in the `test/` folder and mirror the source filenames (e.g., `test/JJE.test.ts` for `src/JJE.ts`, `test/JJME.test.ts` for `src/wrappers/JJME.ts`) while importing the target from `./src/index.js`.
 
 Run tests with:
 
@@ -63,3 +108,7 @@ npm test
 MIT
 
 _Made in Sweden 🇸🇪 by [Alex Ewerlöf](https://alexewerlof.com/)_
+
+```
+
+```