kimu-core 0.4.1

package/README.md

@@ -0,0 +1,266 @@
+<p align="center">
+  <a href="https://unicoverso.com/kimu" target="_blank">
+    <img src="logo_kimu.png" alt="KIMU Logo" width="180" />
+  </a>
+</p>
+
+![License: MPL-2.0](https://img.shields.io/badge/license-MPL%202.0-brightgreen.svg)
+![Build size: <20kB](https://img.shields.io/badge/core%20build-<20kB-blue.svg)
+![Web Components](https://img.shields.io/badge/web--components-native-blueviolet)
+
+
+# KIMU-CORE — The modular heart of KIMU
+>**KIMU - Keep It Minimal UI Framework**
+
+**KIMU-CORE** is the lightweight, modular runtime of [KIMU](https://github.com/unicoverso/kimu) framework: a web-native, ultra-minimal front-end framework built entirely on **Web Components**, designed for **poetic**, **extensible**, and **living** user interfaces.
+
+
+--- 
+
+
+# 🌐 Available Translations
+
+- 🇬🇧 English – [README.md](./README.md)  
+- 🇮🇹 Italiano – [README.it.md](./README.it.md)
+
+
+--- 
+
+
+This package provides the **runtime engine** that powers the entire system, carefully crafted to be **small, elegant, and self-sufficient**.
+
+
+> “Each extension is a thought. Each interface is a gesture.”
+
+
+👉 This repository is the **heart of the KIMU framework**.
+To discover the philosophy, documentation, examples, other extensions, modules, demos, and the playground, visit the main project:
+
+
+> 🔗 **KIMU framework** : **[https://github.com/unicoverso/kimu](https://github.com/unicoverso/kimu)**
+
+> 🔗 **KIMU-core** : **[https://github.com/unicoverso/kimu-core](https://github.com/unicoverso/kimu-core)**
+
+> 🔗 **KIMU docs** : **[https://unicoverso.com/kimu/docs](https://unicoverso.com/kimu/docs)**
+
+> 🔗 **KIMU-docs repository** : **[https://github.com/unicoverso/kimu-docs](https://github.com/unicoverso/kimu-docs)**
+
+> 🔗 **KIMU webpage** : **[https://unicoverso.com/kimu](https://unicoverso.com/kimu)**
+
+
+Created by [UnicòVerso](https://unicoverso.com) (Marco Di Pasquale, a.k.a. *Hocram*), to build lightweight, elegant, and responsive web interfaces.
+
+
+---
+
+
+# 🔧 What is `KIMU-CORE`?
+
+`KIMU-CORE` is the **technical core** that starts, loads, and orchestrates extensions in the [KIMU](https://github.com/UnicoVerso/kimu) ecosystem.
+
+> "Minimal doesn't mean limited. It means intentional."
+
+It includes everything needed to:
+
+- 🧠 Register and manage modular extensions  
+- 🧩 Dynamically load HTML, JS, and CSS components  
+- 🖇️ Connect UI elements via events, shared context, and scoped styles  
+- 💾 Handle shared local state and memory caching  
+- 🧱 Support **declarative UI building** using only Web Components
+
+No bundlers. No virtual DOM. No dependencies. Just modern **vanilla JavaScript**, intentionally designed.
+
+> It’s the perfect foundation for modular ecosystems, creative interfaces, low-footprint apps, or poetic digital experiences.
+
+
+---
+
+
+# 🌱 What is KIMU?
+
+**KIMU** is a lightweight, modular, and flexible front-end framework designed to create elegant and efficient user interfaces with minimal effort and overhead.
+
+Built on native **web standards**, with no external dependencies,  
+`KIMU` embraces **declarative** and **modular** design.
+
+> _“Each extension is a thought. Each interface is a gesture.”_
+
+
+---
+
+
+## ⚙️ KIMU - Key Features
+
+- 🌿 **Ultra-lightweight architecture** - Minimal code and optimized performance from the very first byte  
+- 📦 **Modular components** - with zero overhead and no forced dependencies  
+- ✅ **Build Zero dependencies** – build in pure JS, ready to use, no external libraries  
+- 🔌 **Dynamic extension system** – extension independent, self-loading HTML+JS+CSS modules  
+- 🧩 **Radical modularity** – every part can be replaced or disabled  
+- ⚡ **Instant startup** – no heavy initialization process  
+- 🌐 **Web-native** – built entirely on browser standards (Web Components, Custom Elements)  
+- 🧱 **Declarative components** – apps are built as a sum of extensions, no third-party framework needed  
+- 🎯 **Composition-first** – apps are built from isolated, flexible modules  
+- 🚀 **Clean, Minimal UI and Focused Web Experiences** - Designed focused web applications, digital kiosks, dashboards and clean web interfaces  
+
+
+---
+
+
+## ❓ Why Choose KIMU
+
+KIMU is designed for creators who want to build **clean, minimal, and adaptive web interfaces** — without unnecessary complexity.  
+Whether you're crafting a light frontend, a kiosk, a dashboard, or a modular application, `KIMU-CORE` gives you a focused foundation to build on.
+
+- 🚀 A **frontend framework** that stays out of your way and supports your creative flow  
+- 🖥️ Create **ultralight dashboards**, **kiosk interfaces**, or **embedded UIs**  
+- 🧩 Build **self‑contained applications** with dynamically loaded extensions  
+- 🎛️ Prototype **modular, interactive experiences** — ideal for exhibitions, museums, or educational tools  
+- 🧠 Orchestrate **self‑configuring extensions** via manifest files and metadata  
+- 🧬 Build **customizable digital environments** with thematic digital environments  
+- 🌿 Embrace a philosophy where **performance and simplicity** matter more than feature‑bloat  
+- 🎨 Build digital spaces that feel **personalized, poetic, and purposeful**
+
+> A solid foundation for creative tools, low‑footprint apps, and modular ecosystems.
+
+
+---
+
+
+## 🌿 Philosophy
+
+> "Minimal doesn't mean lacking.  
+> It means focusing on what truly matters."
+
+KIMU encourages a design and development approach where every element has a reason to exist.  
+No bloat, no unnecessary complexity — just pure functionality, elegantly presented.
+
+KIMU follows the principle of essentialism:  
+- Every element exists because it has meaning.  
+- Every interaction is designed for clarity.  
+- Complexity is embraced only when it serves the user.
+
+> "No bloat.  
+> No distractions.  
+> Pure, meaningful interfaces."
+
+
+---
+
+
+## 🚀 Getting started
+
+👉 `KIMU-CORE` will soon be published on npm.  
+In the meantime, you can clone this repository or include its JS files directly in your project.
+
+Documentation and examples will be available at:  
+
+> 🔗 **KIMU get started** : [Get Started](./docs/index.md)
+
+> 🔗 **KIMU docs online** : [https://unicoverso.com/kimu/docs](https://unicoverso.com/kimu/docs)
+
+
+---
+
+
+## 📦 License
+
+All non-executable content of the `KIMU` project  
+(documentation, philosophy, structure) is licensed under  
+[Creative Commons Attribution 4.0 International](./LICENSE) (CC BY 4.0).  
+  
+You are free to use, modify, and redistribute the code, respecting the terms of this license, as long as changes to MPL-covered files remain public under the same license.
+
+For additional information on attribution, contributions, and naming, please refer to the [NOTICE file](./NOTICE).
+
+See the [`LICENSE`](./LICENSE) file for full details.
+
+
+---
+
+
+## 🏷️ Naming and Attribution
+
+"KIMU", "KIMU-CORE" and "UnicòVerso" are part of a creative ecosystem led by the original author.  
+Please refer to the [`NOTICE`](./NOTICE) for appropriate use of names and trademarks.
+
+
+---
+
+
+## 🤝 Contributions
+
+We welcome feedback, ideas, and contributions of any kind.  
+Bug fixes, new extensions, or even thoughtful suggestions help `KIMU` grow.
+
+By contributing, you accept the terms outlined in the [`NOTICE`](./NOTICE) and [`CONTRIBUTING.md`](./CONTRIBUTING.md).  
+Your contributions will always be acknowledged and respected.
+
+
+---
+
+
+## 💌 Share your thoughts
+
+`KIMU` framework is a project born from passion, grown with care, and carried forward with the passion to build something light, human and useful.  
+
+If you've used it, explored it, or even just glanced at it — say something.  
+A thought, a suggestion, a kind word, or a simple “hello”.
+
+Every message is a beam of light.  
+Every word might spark a new extension.  
+Every gesture helps fuel this journey.
+
+📬 Send me a message, even just to say *"I see you. Keep going."* 
+
+
+---
+
+
+## 🧑‍💻 Author and Contact
+
+Created and maintained by:  
+**Marco Di Pasquale** *(aka Hocram)*  
+on behalf of the collective **[UnicòVerso](https://unicoverso.com)**
+
+- 🌍 Website: [https://unicoverso.com/kimu](https://unicoverso.com/kimu)  
+- 🐙 GitHub: [https://github.com/unicoverso/kimu-core](https://github.com/unicoverso/kimu-core)  
+- 🚀 Framework Reference: [https://github.com/unicoverso/kimu](https://github.com/unicoverso/kimu)  
+- 📩 Email: [info@unicoverso.com](mailto:info@unicoverso.com)
+
+
+---
+
+
+## 💖 Support / Donate
+
+🇬🇧 **Want to support KIMU-Core?**
+Find all donation and support options in the [FUNDING.md](./FUNDING.md) file.
+
+You can contribute via:
+- [GitHub Sponsors](https://github.com/sponsors/hocram)
+- [OpenCollective](https://opencollective.com/unicoverso)
+- [Patreon](https://www.patreon.com/UnicoVerso)
+- [Ko-fi](https://ko-fi.com/marcodipasquale)
+- [PayPal](https://paypal.me/marcodipasquale)
+- [BuyMeACoffee](https://www.buymeacoffee.com/hocram)
+- [unicoverso.com/dona](https://unicoverso.com/dona)
+
+
+---
+
+
+<p align="center">
+  <a href="https://unicoverso.com/kimu" target="_blank">
+    <img src="icon.svg" alt="KIMU Logo" width="120" />
+  </a>
+</p>
+
+> _“KIMU is not just a framework.  
+> It’s a way to slow down,  
+> to listen to what matters,  
+> and to build with purpose. 🌱”_
+
+<p>
+  <img src="icon.svg" alt="KIMU Icon" width="24" style="vertical-align: middle; margin-right: 8px;" />
+  Happy coding. Play, create, stay light. Welcome to `KIMU`!
+</p>

package/SECURITY.md

@@ -0,0 +1,64 @@
+# 🔐 Security Policy for KIMU
+
+Thank you for helping keep **KIMU** safe.
+
+## 🛡️ Reporting Security Issues
+
+If you find a security vulnerability in the KIMU framework, please report it responsibly.  
+**Do not open a public issue.**
+
+Do not disclose security vulnerabilities publicly without giving us the opportunity to investigate and address the issue.
+
+To report a vulnerability, contact:
+
+**Marco Di Pasquale (UnicòVerso)**  
+📧 Email: [info@unicoverso.com](mailto:info@unicoverso.com)
+
+Please include as much detail as possible, such as:
+
+- A clear and concise description of the issue  
+- Steps to reproduce the vulnerability  
+- Any potential impact or severity assessment  
+
+We aim to respond to security reports within **5 business days** and will work with you to address the issue promptly and respectfully.
+
+---
+
+## 📝 Supported Versions
+
+We actively maintain and provide security updates for:
+
+- The latest **major version** of KIMU  
+- Minor versions that are currently under active development  
+
+Older versions may not receive security patches unless explicitly stated.
+
+---
+
+## 🤝 Responsible Disclosure
+
+We appreciate responsible disclosure and will credit contributors who report valid vulnerabilities (unless anonymity is requested).
+
+---
+
+## ✅ Best Practices for Developers
+
+While we strive to build secure software, we encourage all developers using KIMU to:
+
+- Keep dependencies up to date  
+- Follow secure coding practices  
+- Validate user input and sanitize all data  
+- Avoid exposing sensitive information  
+
+---
+
+## 🙏 Thank You
+
+Your efforts to improve KIMU’s security are greatly appreciated.  
+Thank you for your responsibility and cooperation.  
+Together, we can build a safer and more reliable framework.
+
+---
+
+For questions or concerns, visit the project:  
+🔗 [https://github.com/unicoverso/kimu](https://github.com/unicoverso/kimu)

package/docs/get-started-en.md

@@ -0,0 +1,207 @@
+<p align="center">
+  <a href="https://unicoverso.com/kimu" target="_blank">
+    <img src="images/logo_kimu.png" alt="KIMU Logo" width="180" />
+  </a>
+</p>
+
+# 🚀 Get Started with KIMU Core
+
+Welcome to **KIMU – Keep It Minimal UI Framework**!  
+
+This guide will walk you through the basic steps to download, install, and run the core-framework for the first time.
+
+## 🔧 Prerequisites
+
+Before you start, make sure the following tools are installed on your system:
+
+- [**Git**](https://git-scm.com/) – to clone the repository and manage code versions  
+  Recommended: version ≥ 2.30
+
+- [**Node.js**](https://nodejs.org/) – to install and run the project dependencies  
+  Recommended: **LTS version** (≥ 18.x)  
+  This also includes `npm`, the Node.js package manager
+
+- [**TypeScript**](https://www.typescriptlang.org/) – required for compiling `.ts` files  
+  Install localy with:  
+  ```bash
+  npm install --save-dev typescript
+  ```
+  Or install globally with: 
+  ```bash
+  npm install -g typescript
+  ```
+
+- (Optional) [**Python 3.x**](https://www.python.org/downloads/) – used in `py-server` script to start a quick static server for distribution files: 
+```bash
+python3 -m http.server 5173 --directory ./dist
+  ```
+  
+💡 You can verify the installation by running:  
+> ```bash
+> node -v
+> npm -v
+> git --version
+> ```
+
+If any of these commands fails, please install the corresponding tool from the links above before continuing.
+
+
+## 📦 1. Clone the Repository
+
+Use Git to clone the project from the official GitHub repository:
+
+```bash
+git clone https://github.com/unicoverso/kimu-core.git
+cd kimu-core
+```
+
+
+## 📥 2. Install Dependencies
+
+Install all necessary dependencies using `npm`:
+
+```bash
+npm install
+```
+
+
+## 🏗️ 3. Build the Project
+
+To generate the full distribution build (TypeScript compilation + configuration + Vite + extensions):
+
+```bash
+npm run build
+```
+
+This command performs:
+
+- TypeScript compilation
+- Configuration generation (for `dev` by default)
+- Vite bundling
+- Dynamic extension building
+
+You can also run the build with a specific environment:
+
+```bash
+npm run build:dev     # Development (default)
+npm run build:local   # Local development
+npm run build:prod    # Production
+```
+
+## ⚙️ 4. (Optional) Advanced Configuration Scripts
+
+If you want to generate the configuration manually without building, you can run:
+
+```bash
+npm run generate-config       # Default (development)
+```
+
+Other environment variants:
+
+```bash
+npm run generate-config:dev     # Development
+npm run generate-config:local   # Local
+npm run generate-config:test    # Test
+npm run generate-config:prod    # Production
+```
+
+
+## 🧹 5. (Optional) Clear Previous Builds
+
+To clean up previous build files:
+
+```bash
+npm run clear:build
+```
+
+
+## 🔧 6. Build All Extensions Only
+
+To build all extensions dynamically and prepare them for runtime:
+
+```bash
+npm run build:all-ext
+```
+
+
+## 🌐 7. Run the Local Development Server
+
+To preview the Hello App locally and start developing:
+
+```bash
+npm start
+```
+
+Then open your browser and visit:
+
+```
+http://localhost:5173/
+```
+
+You should see the **Hello App** running!
+
+
+## 📁 8. Output Location
+
+After the build process, all compiled files are available in the `dist/` directory.    
+This includes:
+- Pure JS files (no bundler required)
+- HTML, CSS and assets
+- Extension files and manifest
+
+These are ready to be served as static files or integrated into your own system.
+
+---
+
+## ✅ What’s Next?
+
+You can now explore:
+- How to create your own extension
+- How to use the KIMU runtime API
+- How to customize the experience
+
+See the full documentation in `docs/` for more.
+
+---
+
+## 📖 Available Documentation
+
+- [📚 KIMU Online docs](https://unicoverso.com/kimu/docs) – Learn how to use the framework
+
+---
+
+## 💌 Share your thoughts
+
+KIMU is a project built with care, shaped by intention, and carried forward with passion.
+
+If you've used it, explored it, or even just glanced at it — say something.  
+A thought, a suggestion, a kind word, or a simple “hello”.
+
+Every message is a beam of light.  
+Every word might spark a new extension.  
+Every gesture helps fuel this journey.
+
+📬 Send me a message, even just to say *"I see you. Keep going."* 
+
+---
+
+## 🧑‍💻 Author and Contact
+
+Created and maintained by:  
+**Marco Di Pasquale** *(aka Hocram)*  
+on behalf of the collective **[UnicòVerso](https://unicoverso.com)**
+
+- 🌍 Website: [https://unicoverso.com/kimu](https://unicoverso.com/kimu)  
+
+- 🐙 GitHub: [https://github.com/unicoverso/kimu-core](https://github.com/unicoverso/kimu-core)  
+
+- 🚀 Framework Reference: [https://github.com/unicoverso/kimu](https://github.com/unicoverso/kimu)  
+
+- 📩 Email: [info@unicoverso.com](mailto:info@unicoverso.com)
+
+---
+
+<p>
+  <img src="images/icon.svg" alt="KIMU Icon" width="24" style="vertical-align: middle; margin-right: 8px;" />
+  Happy coding. Play, create, stay light. Welcome to KIMU!
+</p>

package/docs/images/icon.svg

@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   id="Livello_2"
+   viewBox="0 0 128 128"
+   version="1.1"
+   sodipodi:docname="kimu-icon-128x128.svg"
+   width="128"
+   height="128"
+   inkscape:version="1.4 (e7c3feb1, 2024-10-09)"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <sodipodi:namedview
+     id="namedview4"
+     pagecolor="#ffffff"
+     bordercolor="#000000"
+     borderopacity="0.25"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     inkscape:zoom="1.5142353"
+     inkscape:cx="124.15507"
+     inkscape:cy="86.182112"
+     inkscape:window-width="1440"
+     inkscape:window-height="872"
+     inkscape:window-x="0"
+     inkscape:window-y="28"
+     inkscape:window-maximized="0"
+     inkscape:current-layer="Livello_2" />
+  <defs
+     id="defs1">
+    <style
+       id="style1">.cls-1{fill:#f45e32;}.cls-2{fill:#fff463;}.cls-3{fill:#88d1e2;}.cls-4{fill:#91d292;}</style>
+  </defs>
+  <g
+     id="g4"
+     transform="translate(0,-0.83295207)">
+    <g
+       id="Girandola"
+       transform="matrix(0.91533181,0,0,0.91533181,-1.552e-7,14)">
+      <g
+         id="Aste">
+        <path
+           class="cls-3"
+           d="m 57.47,111.07 c 18.74,0 33.94,-15.19 33.94,-33.94 0,-9.65 -4.03,-18.36 -10.49,-24.54 L 47.95,109.7 c 3.02,0.88 6.22,1.36 9.53,1.36 z"
+           id="path1" />
+        <path
+           class="cls-1"
+           d="M 82.48,0 C 63.74,0 48.54,15.19 48.54,33.94 c 0,9.65 4.03,18.36 10.49,24.54 L 92.01,1.36 C 88.99,0.48 85.79,0 82.48,0 Z"
+           id="path2" />
+        <path
+           class="cls-2"
+           d="m 3.59,71.31 c 9.37,16.23 30.13,21.79 46.36,12.42 8.36,-4.82 13.88,-12.67 16,-21.36 H 0 c 0.75,3.06 1.93,6.07 3.59,8.94 z"
+           id="path3" />
+        <path
+           class="cls-4"
+           d="M 136.25,39.58 C 126.88,23.35 106.12,17.79 89.89,27.16 c -8.36,4.82 -13.88,12.67 -16,21.36 h 65.95 c -0.75,-3.06 -1.93,-6.07 -3.59,-8.94 z"
+           id="path4" />
+      </g>
+    </g>
+  </g>
+</svg>

package/docs/index.md

@@ -0,0 +1,29 @@
+# 📚 KIMU Documentation Index
+
+Welcome to the official documentation for **KIMU** framework — *Keep It Minimal UI Framework*.
+
+This space is dedicated to help you understand, install, and build with the `kimu-core` runtime and the broader KIMU ecosystem.
+
+> "Minimal doesn't mean limited. It means intentional."
+
+
+## 💡 About KIMU
+
+KIMU is a minimal, web-native, modular framework built entirely on **Web Components**. It is designed for:
+
+* Building lightweight digital experiences
+* Creating poetic and expressive interfaces
+* Deploying fast, dependency-free applications
+
+Whether you're crafting a dashboard, a kiosk interface, or a creative digital project — KIMU keeps your front-end clean, clear, and powerful.
+
+> “Each extension is a thought. Each interface is a gesture.”
+
+Created by [UnicòVerso](https://unicoverso.com)
+
+
+## 📖 Available Documentation
+
+- [🌱 Get Started (EN)](get-started.md) – Learn how start to install and run the core framework
+
+- [📚 Online docs](https://unicoverso.com/kimu/docs) – Learn how to use the framework

package/env/dev.config.json

@@ -0,0 +1,6 @@
+{
+    "environment": "dev",
+    "api-url": "http://localhost:3000",
+    "web-url": "http://localhost:5173",
+    "base-path": "/"
+}

package/env/local.config.json

@@ -0,0 +1,6 @@
+{
+    "environment": "local",
+    "api-url": "http://localhost:3000",
+    "web-url": "http://localhost:5173",
+    "base-path": "/"
+}

package/env/prod.config.json

@@ -0,0 +1,6 @@
+{
+    "environment": "prod",
+    "api-url": "https://unicoverso.com/kimu/api",
+    "web-url": "https://unicoverso.com/kimu",
+    "base-path": "/dist/"
+}

package/env/staging.config.json

@@ -0,0 +1,6 @@
+{
+    "environment": "staging",
+    "api-url": "https://unicoverso.com/kimu/api",
+    "web-url": "https://unicoverso.com/kimu",
+    "base-path": "/"
+}

package/env/test.config.json

@@ -0,0 +1,4 @@
+{
+    "api-url": "http://localhost:3001",
+    "web-url": "http://localhost:5173"
+}

package/icon.svg

@@ -0,0 +1,10 @@
+<svg viewBox="0 0 128 128" xmlns="http://www.w3.org/2000/svg">
+  <g transform="translate(0,-0.83295207)">
+    <g transform="matrix(0.91533181,0,0,0.91533181,0,14)">
+      <path fill="#88d1e2" d="M57.47 111.07c18.74 0 33.94-15.19 33.94-33.94 0-9.65-4.03-18.36-10.49-24.54L47.95 109.7c3.02.88 6.22 1.36 9.53 1.36z"/>
+      <path fill="#f45e32" d="M82.48 0C63.74 0 48.54 15.19 48.54 33.94c0 9.65 4.03 18.36 10.49 24.54L92.01 1.36C88.99.48 85.79 0 82.48 0z"/>
+      <path fill="#fff463" d="M3.59 71.31c9.37 16.23 30.13 21.79 46.36 12.42 8.36-4.82 13.88-12.67 16-21.36H0c.75 3.06 1.93 6.07 3.59 8.94z"/>
+      <path fill="#91d292" d="M136.25 39.58c-9.37-16.23-30.13-21.79-46.36-12.42-8.36 4.82-13.88 12.67-16 21.36h65.95c-.75-3.06-1.93-6.07-3.59-8.94z"/>
+    </g>
+  </g>
+</svg>