kimu-core 0.4.1

package/.github/workflows/deploy-demo.yml

@@ -0,0 +1,39 @@
+name: Deploy Demo to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build project
+        run: npm run build
+
+      - name: Sposta i file in demo/
+        run: |
+          mkdir -p dist/demo
+          shopt -s extglob
+          mv dist/!(demo) dist/demo/
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./dist
+          publish_branch: gh-pages
+          user_name: 'github-actions[bot]'
+          user_email: 'github-actions[bot]@users.noreply.github.com'

package/AUTHORS.md

@@ -0,0 +1,20 @@
+# 👥 AUTHORS of KIMU – Keep It Minimal UI Framework
+
+This project is created and maintained by:
+
+- **Marco Di Pasquale** (alias *Hocram*)  
+  Founder of [UnicòVerso](https://unicoverso.com)  
+  [info@unicoverso.com](mailto:info@unicoverso.com)
+
+---
+
+## 🤝 Other Contributors
+
+We gratefully acknowledge all contributions — code, ideas, feedback, or design — that help KIMU evolve.
+
+If you have contributed and wish to be listed here, feel free to open a Pull Request or contact us directly.
+
+---
+
+> _“Each extension is a thought. Each interface is a gesture.”_
+> — The KIMU philosophy 🌱

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# 🧩 kimu-core Changelog
+> The modular runtime engine of the Keep It Minimal UI framework
+
+---
+
+## [0.1.0] - 2025-05-09
+🎉 **Initial public release of `kimu-core`**
+
+### Added
+- Initial implementation of the `kimu-core`, KIMU runtime engine
+- Dynamic extension system (HTML, JS, CSS auto-loading)
+- Local state and memory caching
+- Declarative UI using Web Components
+- Zero-dependency setup (pure JavaScript)
+- Extension manifest loader
+- Internal event dispatch system
+- Minimal UI philosophy embedded in structure and design
+- Licensed under [Mozilla Public License 2.0 (MPL-2.0)](./LICENSE)
+
+---

package/CODE_GUIDELINES.md

@@ -0,0 +1,165 @@
+# 🧩 KIMU Coding Guidelines
+
+## 🎯 Purpose
+
+This document provides guidelines and best practices for writing code and developing features within the **KIMU – Keep It Minimal UI Framework**.
+Its goal is to ensure consistency, readability, maintainability, and simplicity across the entire project.
+
+---
+
+## ✨ Core Principles
+
+* **Minimalism first**: Write only what is necessary. Avoid over-engineering.
+* **Clarity over cleverness**: Code should be easy to read and understand, even for new contributors.
+* **Consistency**: Follow established naming conventions, file structures, and component patterns.
+* **Composable and modular**: Keep components and functions focused on a single responsibility.
+* **Lightweight mindset**: Prefer simple solutions with minimal dependencies.
+
+---
+
+## 📝 Code Style
+
+* Use **camelCase** for variables and function names.
+* Use **PascalCase** for component names and classes.
+* Follow the existing folder structure and naming patterns.
+* Write **self-explanatory function and variable names**.
+* Keep functions **small and focused**.
+* Add comments where logic is non-trivial.
+* Use **whitespace and indentation** to enhance readability.
+
+---
+
+## 🏷️ Naming Conventions and Code Structure
+
+KIMU follows simple and consistent naming rules to ensure readability and predictability.
+
+### 🟢 Variables and Functions
+
+* Use **camelCase** for variable names and function names.
+
+  ```js
+  let userList = [];
+  function fetchData() { ... }
+  ```
+
+### 🟢 Classes and Components
+
+* Use **PascalCase** for component names and class declarations.
+
+  ```js
+  class KimuButton { ... }
+  export class UserProfileCard { ... }
+  ```
+
+### 🟢 Constants
+
+* Use **UPPER\_SNAKE\_CASE** for global constants.
+
+  ```js
+  const API_ENDPOINT = '/api/v1/data';
+  ```
+
+### 🟢 File and Folder Names
+
+* Use **kebab-case** for file and folder names.
+
+  ```bash
+  /user-profile-card/
+  user-profile-card.component.js
+  ```
+
+### 🟢 Methods inside Classes
+
+* Use **camelCase** for method names.
+
+  ```js
+  class KimuButton {
+    handleClick() { ... }
+  }
+  ```
+
+### 🟢 Events and Custom Attributes
+
+* Use **kebab-case** for custom events and HTML attributes.
+
+  ```html
+  <kimu-button @click="handleClick" data-user-id="123"></kimu-button>
+  ```
+
+### 🟢 Private Variables and Methods
+
+* Prefix with an underscore `_` for private-like semantics.
+
+  ```js
+  class UserProfile {
+    _validateData() { ... }
+  }
+  ```
+
+---
+
+## ✅ Why Naming Matters
+
+Consistent naming helps:
+
+* Understand code faster.
+* Reduce cognitive load.
+* Maintain a clean and professional codebase.
+
+KIMU values clarity and simplicity. Every name should tell a story of its purpose.
+
+---
+
+## 🧩 Components and Files
+
+* Each UI component should live in its **own folder**, with related styles and templates.
+* Reuse existing utilities and helpers where possible.
+* Avoid duplicating logic — prefer shared services and composable functions.
+
+---
+
+## 🧪 Testing and Validation
+
+* Ensure new features are tested, especially critical or shared functionalities.
+* Run existing tests before submitting a Pull Request.
+* Manual testing is encouraged for UI interactions and visual changes.
+
+---
+
+## 📖 Documentation
+
+* Update or create documentation for any new feature, component, or API.
+* Keep README files up to date in each module or component folder.
+
+---
+
+## ✅ Commit Guidelines
+
+* Use clear and concise commit messages.
+* Follow this format:
+
+  ```
+  [type]: short description
+
+  [optional body with more context]
+  ```
+
+  Examples of types: `fix`, `feature`, `refactor`, `docs`, `chore`
+
+---
+
+## 🙏 Why It Matters
+
+Following these guidelines ensures KIMU remains:
+
+* **Easy to understand** for new contributors.
+* **Simple to maintain** and extend.
+* **Consistent and reliable** across all modules.
+
+Thank you for writing code that reflects the KIMU philosophy of minimal, meaningful design.
+
+---
+
+For any questions or clarifications, please reach out via [GitHub Issues](https://github.com/unicoverso/kimu/issues) or contact the maintainer.
+
+Marco Di Pasquale - Hocram (UnicòVerso)

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,47 @@
+# Code of Conduct for KIMU
+
+All contributors are required to abide by this code of conduct.
+
+## 🌿 Our Commitment
+
+KIMU is a community built on respect, openness, and shared growth.
+We are committed to providing a welcoming and inclusive environment for everyone, regardless of background, experience or identity.
+
+## 🤝 Principles
+
+* Respect others, always.
+* No discrimination, racism, sexism, bullying or insults.
+* Communicate constructively, with kindness and openness to dialogue.
+* Assume good faith and be patient in discussions.
+* Value diversity of perspectives and experiences.
+* Be respectful, patient, and kind in all interactions.
+* Value diversity of opinions and perspectives.
+* Collaborate in good faith, assuming positive intent.
+* Use inclusive and professional language.
+* Provide constructive feedback and engage in healthy discussions.
+
+## 🚫 Unacceptable Behavior
+
+* Harassment, abuse, or discrimination of any kind.
+* Personal attacks, insults, or derogatory comments.
+* Dismissive or exclusionary behavior.
+* Sharing offensive or inappropriate content.
+* Any conduct that disrupts the community or project.
+
+## 📢 Reporting Issues
+
+If you experience or witness unacceptable behavior, please report it by contacting:
+
+**Marco Di Pasquale (UnicòVerso)**
+Email: [info@unicoverso.com](mailto:info@unicoverso.com)
+
+All reports will be handled confidentially and with utmost care.
+
+## ⚖️ Enforcement
+
+Violations of this Code of Conduct may result in warnings, removal from the community, or other appropriate actions, at the discretion of the maintainers.
+
+## 🙏 Thank You
+
+Thank you for helping us create a respectful and inclusive space.  
+Together, we can ensure KIMU remains a space for meaningful collaboration and innovation.

package/CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing to KIMU
+
+Thank you for your interest in contributing to **KIMU – Keep It Minimal UI - Framework**!
+We welcome all kinds of contributions: bug fixes, improvements, ideas, documentation updates, and more.
+
+This document outlines the basic guidelines for contributing to KIMU.
+
+## 📥 How to Contribute
+
+1. **Fork the repository**.
+
+2. **Create a new branch**
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+3. **Make your changes** in a clean and focused way.
+
+4. **Test your changes** to ensure they work as intended.
+
+5. **Submit a pull request (PR)** with a clear description of what you changed and why.
+
+6. Please be respectful and constructive in code reviews and discussions.
+
+## 🧪 Testing and Style
+
+- Follow existing style conventions.
+- Keep your code readable and well-commented.
+- Run tests if you change critical components.
+
+## 💡 Issues and Suggestions
+
+* Found a bug? Please open an [issue](https://github.com/unicoverso/kimu/issues) with a clear description and steps to reproduce it.
+* Have an idea or suggestion? We'd love to hear it!
+
+## 📝 Contribution Scope
+
+By contributing to this project (via pull request, issue, or otherwise), you agree that your contribution:
+
+* May become part of the evolving KIMU framework.
+* May be reused in different contexts or formats as KIMU continues to grow and adapt.
+* Will always be credited where appropriate and used with respect for your work.
+
+For details on attribution, naming, and usage, please refer to the [NOTICE](./NOTICE) file.
+
+## ⚖️ License Agreement
+
+All contributions are made under the same license as the project: [Mozilla Public License 2.0 (MPL-2.0)](./LICENSE).
+
+Please ensure your contributions are compatible with this license.
+
+## 🤝 Code of Conduct
+
+We are committed to fostering a welcoming and respectful community.
+Please read and follow our [Code of Conduct](./CODE_OF_CONDUCT.md).
+
+## 🙏 Thank You!
+
+Every contribution, no matter how small, helps make KIMU better.
+
+Thank you for making KIMU better!
+Thank you for being part of this vision!

package/FUNDING.md

@@ -0,0 +1,31 @@
+# Supporta KIMU-Core / Support KIMU-Core
+
+🇮🇹 **Vuoi sostenere lo sviluppo di KIMU-Core?**
+Il tuo contributo aiuta a mantenere il progetto open source, migliorarne le funzionalità e supportare la community!
+
+Puoi donare tramite:
+- [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)
+
+Ogni donazione, anche piccola, fa la differenza!
+
+---
+
+🇬🇧 **Want to support KIMU-Core development?**
+Your contribution helps keep the project open source, improve its features, and support the community!
+
+You can donate 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)
+
+Every donation, even small, makes a difference!

package/ISSUE_GUIDELINES.md

@@ -0,0 +1,74 @@
+# 🪶 Issue Guidelines for KIMU
+
+Welcome to the issue tracker for **KIMU – Keep It Minimal UI Framework**.  
+
+Thank you for helping improve this lightweight, poetic ecosystem. 🌱
+
+We appreciate your feedback, questions, bug reports and suggestions.  
+
+To keep everything clear and efficient for everyone, please follow these simple guidelines.
+
+---
+
+## 📝 Before Opening an Issue
+
+1. **Check for duplicates** – Please search the [existing issues](https://github.com/unicoverso/kimu-core/issues) before opening a new one.
+2. **Be concise, yet complete** – Describe the issue or idea clearly, including:
+   - What you expected to happen
+   - What actually happened
+   - Steps to reproduce (if it's a bug)
+   - Environment info (browser, OS, version, etc.)
+3. **Use a meaningful title** – A clear summary helps others understand the topic quickly.
+
+---
+
+## 🧭 Choose the Right Type
+
+When creating a new issue, please specify the type:
+
+- 🐞 **Bug** – Something isn’t working as expected.
+- 💡 **Feature request** – You’d like to see something new.
+- ❓ **Question** – You're unsure how something works.
+- 🧪 **Design/API discussion** – Suggestions on how to improve structure or usage.
+- 📚 **Docs** – Missing or unclear documentation.
+
+---
+
+## 🏷️ Labeling and Tagging
+
+- We’ll apply labels like `bug`, `enhancement`, `help wanted`, or `good first issue` as needed.
+- If you’re contributing regularly, feel free to propose labels as well.
+
+---
+
+## ⏳ Team Response
+
+- We aim to respond to issues within a few days.
+- We might ask follow-up questions to clarify the situation or request a reproduction.
+- Constructive tone is welcome — we're building something meaningful together.
+
+---
+
+## 🌟 Contributing Fixes
+
+If you’re reporting a bug **and** want to contribute a fix, that’s wonderful!  
+
+Please mention it in your issue or directly open a Pull Request referencing the issue number.
+
+---
+
+## 💬 Need Help?
+
+You can also reach out for clarifications via GitHub Discussions or contact the maintainer.  
+
+See the [README](./README.md) for contact details.
+
+---
+
+> _“Each extension is a thought. Each interface is a gesture.”_  
+Help us make those thoughts and gestures meaningful.  
+
+Thank you for being part of the KIMU journey. 🙏
+
+— The KIMU philosophy 🌱
+

package/LICENSE

@@ -0,0 +1,17 @@
+# Licenses of KIMU - Keep It Minimal UI Framework
+
+## Mozilla Public License Version 2.0
+
+KIMU is licensed under the **Mozilla Public License, Version 2.0 (MPL-2.0)**.
+
+This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
+You can redistribute and/or modify this software under the terms of the Mozilla Public License v. 2.0 (MPL-2.0).
+
+Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+
+You may read the full license text in the file [`MPL-2.0.txt`](./MPL-2.0.txt),  
+or online at: [https://www.mozilla.org/MPL/2.0/](https://www.mozilla.org/MPL/2.0/)
+
+See also [NOTICE](NOTICE) for attribution and trademark details.
+
+Copyright - © 2024–2025 Marco Di Pasquale (UnicòVerso)

package/LICENSE.it.md

@@ -0,0 +1,17 @@
+# Licenses of KIMU - Keep It Minimal UI Framework
+
+## Mozilla Public License Version 2.0
+
+KIMU è distribuito sotto  termini della **Mozilla Public License, Version 2.0 (MPL-2.0)**.
+
+Il presente codice sorgente è soggetto ai termini della Mozilla Public License, Versione 2.0.  
+È possibile redistribuire e/o modificare questo software nel rispetto dei termini della MPL v. 2.0.
+
+Salvo ove diversamente richiesto dalla legge o concordato per iscritto, il software distribuito sotto questa licenza è fornito "COSÌ COM'È", **senza garanzie o condizioni di alcun tipo**, esplicite o implicite.
+
+Puoi leggere il testo completo della licenza nel file [`MPL-2.0.txt`](./MPL-2.0.txt),  
+oppure online su: [https://www.mozilla.org/MPL/2.0/](https://www.mozilla.org/MPL/2.0/)
+
+Vedi anche [NOTICE](NOTICE) per i dettagli su attribuzione e marchi.
+
+Copyright - © 2024–2025 Marco Di Pasquale (UnicòVerso)