npm - kimu-core - Versions diffs - 0.4.1 - Mend

kimu-core 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (146) hide show

package/.editorconfig +30 -0
package/.gitattributes +11 -0
package/.github/FUNDING.yml +8 -0
package/.github/copilot-instructions.md +103 -0
package/.github/kimu-copilot-instructions.md +3779 -0
package/.github/workflows/deploy-demo.yml +39 -0
package/AUTHORS.md +20 -0
package/CHANGELOG.md +20 -0
package/CODE_GUIDELINES.md +165 -0
package/CODE_OF_CONDUCT.md +47 -0
package/CONTRIBUTING.md +62 -0
package/FUNDING.md +31 -0
package/ISSUE_GUIDELINES.md +74 -0
package/LICENSE +17 -0
package/LICENSE.it.md +17 -0
package/MPL-2.0.txt +373 -0
package/NOTICE +65 -0
package/README-KIMU.md +40 -0
package/README.it.md +208 -0
package/README.md +266 -0
package/SECURITY.md +64 -0
package/docs/get-started-en.md +207 -0
package/docs/images/icon.svg +64 -0
package/docs/images/logo_kimu.png +0 -0
package/docs/index.md +29 -0
package/env/dev.config.json +6 -0
package/env/local.config.json +6 -0
package/env/prod.config.json +6 -0
package/env/staging.config.json +6 -0
package/env/test.config.json +4 -0
package/icon.svg +10 -0
package/logo_kimu.png +0 -0
package/package.json +79 -0
package/public/favicon.svg +64 -0
package/public/logo_kimu.svg +1 -0
package/scripts/build-all-config.js +59 -0
package/scripts/build-all-core.js +65 -0
package/scripts/build-all-extensions.js +64 -0
package/scripts/build-all-modules.js +99 -0
package/scripts/build-extension.js +60 -0
package/scripts/clear-kimu-build.js +31 -0
package/scripts/generate-kimu-build-config.js +79 -0
package/scripts/install-module.js +162 -0
package/scripts/list-modules.js +109 -0
package/scripts/minify-css-assets.js +82 -0
package/scripts/remove-module.js +122 -0
package/scripts/utils/fix-imports.js +85 -0
package/src/assets/index.css +43 -0
package/src/assets/kimu-style.css +84 -0
package/src/assets/style.css +116 -0
package/src/config/kimu-base-config.json +5 -0
package/src/core/index.ts +47 -0
package/src/core/kimu-app.ts +76 -0
package/src/core/kimu-asset-manager.ts +167 -0
package/src/core/kimu-component-element.ts +325 -0
package/src/core/kimu-component.ts +33 -0
package/src/core/kimu-engine.ts +188 -0
package/src/core/kimu-extension-manager.ts +281 -0
package/src/core/kimu-global-styles.ts +136 -0
package/src/core/kimu-module-manager.ts +69 -0
package/src/core/kimu-module.ts +21 -0
package/src/core/kimu-path-config.ts +127 -0
package/src/core/kimu-reactive.ts +196 -0
package/src/core/kimu-render.ts +91 -0
package/src/core/kimu-store.ts +147 -0
package/src/core/kimu-types.ts +65 -0
package/src/extensions/.gitkeep +0 -0
package/src/extensions/extensions-manifest.json +13 -0
package/src/extensions/kimu-home/component.ts +80 -0
package/src/extensions/kimu-home/lang/en.json +5 -0
package/src/extensions/kimu-home/lang/it.json +5 -0
package/src/extensions/kimu-home/style.css +61 -0
package/src/extensions/kimu-home/view.html +51 -0
package/src/index.html +26 -0
package/src/main.ts +68 -0
package/src/modules/.gitkeep +0 -0
package/src/modules/README.md +79 -0
package/src/modules/i18n/README.it.md +63 -0
package/src/modules/i18n/README.md +63 -0
package/src/modules/i18n/kimu-global-lang.ts +26 -0
package/src/modules/i18n/kimu-i18n-service.ts +108 -0
package/src/modules/i18n/manifest.json +22 -0
package/src/modules/i18n/module.ts +39 -0
package/src/modules/modules-manifest.json +12 -0
package/src/modules-repository/README.md +108 -0
package/src/modules-repository/api-axios/CHANGELOG.md +48 -0
package/src/modules-repository/api-axios/QUICK-REFERENCE.md +178 -0
package/src/modules-repository/api-axios/README.md +304 -0
package/src/modules-repository/api-axios/api-axios-service.ts +355 -0
package/src/modules-repository/api-axios/examples.ts +293 -0
package/src/modules-repository/api-axios/index.ts +19 -0
package/src/modules-repository/api-axios/interfaces.ts +71 -0
package/src/modules-repository/api-axios/module.ts +41 -0
package/src/modules-repository/api-core/CHANGELOG.md +42 -0
package/src/modules-repository/api-core/QUICK-REFERENCE.md +192 -0
package/src/modules-repository/api-core/README.md +435 -0
package/src/modules-repository/api-core/api-core-service.ts +289 -0
package/src/modules-repository/api-core/examples.ts +432 -0
package/src/modules-repository/api-core/index.ts +8 -0
package/src/modules-repository/api-core/interfaces.ts +83 -0
package/src/modules-repository/api-core/module.ts +30 -0
package/src/modules-repository/event-bus/README.md +273 -0
package/src/modules-repository/event-bus/event-bus-service.ts +176 -0
package/src/modules-repository/event-bus/module.ts +30 -0
package/src/modules-repository/i18n/README.it.md +63 -0
package/src/modules-repository/i18n/README.md +63 -0
package/src/modules-repository/i18n/kimu-global-lang.ts +26 -0
package/src/modules-repository/i18n/kimu-i18n-service.ts +108 -0
package/src/modules-repository/i18n/manifest.json +22 -0
package/src/modules-repository/i18n/module.ts +39 -0
package/src/modules-repository/notification/README.md +423 -0
package/src/modules-repository/notification/module.ts +30 -0
package/src/modules-repository/notification/notification-service.ts +436 -0
package/src/modules-repository/router/README.it.md +39 -0
package/src/modules-repository/router/README.md +39 -0
package/src/modules-repository/router/manifest.json +21 -0
package/src/modules-repository/router/module.ts +23 -0
package/src/modules-repository/router/router.ts +144 -0
package/src/modules-repository/state/README.md +409 -0
package/src/modules-repository/state/module.ts +30 -0
package/src/modules-repository/state/state-service.ts +296 -0
package/src/modules-repository/theme/README.md +267 -0
package/src/modules-repository/theme/module.ts +30 -0
package/src/modules-repository/theme/pre-build.js +40 -0
package/src/modules-repository/theme/theme-service.ts +389 -0
package/src/modules-repository/theme/themes/theme-cherry-blossom.css +78 -0
package/src/modules-repository/theme/themes/theme-cozy.css +111 -0
package/src/modules-repository/theme/themes/theme-cyberpunk.css +150 -0
package/src/modules-repository/theme/themes/theme-dark.css +79 -0
package/src/modules-repository/theme/themes/theme-forest.css +171 -0
package/src/modules-repository/theme/themes/theme-gold.css +100 -0
package/src/modules-repository/theme/themes/theme-high-contrast.css +126 -0
package/src/modules-repository/theme/themes/theme-lava.css +101 -0
package/src/modules-repository/theme/themes/theme-lavender.css +90 -0
package/src/modules-repository/theme/themes/theme-light.css +79 -0
package/src/modules-repository/theme/themes/theme-matrix.css +103 -0
package/src/modules-repository/theme/themes/theme-midnight.css +81 -0
package/src/modules-repository/theme/themes/theme-nord.css +94 -0
package/src/modules-repository/theme/themes/theme-ocean.css +84 -0
package/src/modules-repository/theme/themes/theme-retro80s.css +343 -0
package/src/modules-repository/theme/themes/theme-sunset.css +62 -0
package/src/modules-repository/theme/themes-config.d.ts +27 -0
package/src/modules-repository/theme/themes-config.json +213 -0
package/src/vite-env.d.ts +1 -0
package/tsconfig.json +33 -0
package/vite.config.ts +99 -0

package/src/extensions/kimu-home/view.html ADDED Viewed

@@ -0,0 +1,51 @@
+<!--
+This file can be freely modified by developers.
+Changes made to this page are not subject to the publication requirement of the MPL framework license.
+-->
+<div class="container">
+    <div class="logo" >
+        <img src="/logo_kimu.svg" alt="KIMU logo" style="width: 256px;" />
+    </div>
+    <h2 class="slogan">${slogan}</h2>
+    <h1>KIMU Home</h1>
+    <p class="welcome">${translate('welcome') || 'Hello World!'}</p>
+    <p class="lang">
+        <span>${translate('selectedLanguage')}</span> <strong>${selectedLang}</strong>
+    </p>
+    <div class="btn-lang">
+        <button @click=${onLangIt}>🇮🇹 Italiano</button>
+        <button @click=${onLangEn}>🇬🇧 English</button>
+    </div>
+    <footer class="kimu-footer">
+        <small>
+            Made with
+            <img src="/favicon.svg" alt="favicon KIMU" width="18" height="18" style="vertical-align: middle; margin: 0 2px; filter: grayscale(1) brightness(0.7);" />
+            <a href="https://github.com/UnicoVerso/kimu-core" target="_blank" rel="noopener">KIMU Framework</a>
+            v${version}
+            &middot;
+            by
+            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg" style="vertical-align: middle; margin-right: 2px;">
+                <rect width="16" height="16" rx="3" fill="#fff"/>
+                <path d="M3 5.5V10.5C3 11.0523 3.44772 11.5 4 11.5H12C12.5523 11.5 13 11.0523 13 10.5V5.5C13 4.94772 12.5523 4.5 12 4.5H4C3.44772 4.5 3 4.94772 3 5.5ZM4 5.5L8 8.5L12 5.5"
+                stroke="#888" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"/>
+            </svg>
+            <a href="mailto:info@unicoverso.com" title="Email">Marco Di Pasquale</a>
+            &middot;
+            <svg width="12" height="12" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg" style="vertical-align: middle; margin-right: 4px;">
+                <rect width="16" height="16" rx="3" fill="#fff"/>
+                <circle cx="8" cy="8" r="7" fill="#f5f5f5" stroke="#888" stroke-width="1.2"/>
+                <ellipse cx="8" cy="8" rx="5.5" ry="7" stroke="#888" stroke-width="1" fill="none"/>
+                <ellipse cx="8" cy="8" rx="7" ry="3.5" stroke="#888" stroke-width="1" fill="none"/>
+                <path d="M8 1v14" stroke="#888" stroke-width="1" stroke-linecap="round"/>
+                <path d="M1 8h14" stroke="#888" stroke-width="1" stroke-linecap="round"/>
+            </svg>
+            <a href="https://unicoverso.com" target="_blank" rel="noopener">UnicòVerso</a>
+        </small>
+    </footer>
+</div>

package/src/index.html ADDED Viewed

@@ -0,0 +1,26 @@
+<!--
+This file can be freely modified by developers.
+Changes made to this page are not subject to the publication requirement of the MPL framework license.
+-->
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="stylesheet" href="/assets/style.css">
+    <link rel="stylesheet" href="/assets/kimu-style.css">
+    <script type="importmap">
+      {
+        "imports": {
+          "lit": "https://cdn.skypack.dev/lit@3.2.1"
+        }
+      }
+    </script>
+    <title>Kimu App</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/main.ts"></script>
+  </body>
+</html>

package/src/main.ts ADDED Viewed

@@ -0,0 +1,68 @@
+import { KimuExtensionManager } from './core/kimu-extension-manager';
+import { KimuApp } from './core/kimu-app';
+import { KimuPathConfig } from './core/kimu-path-config';
+/**
+ * This code initializes the Kimu framework and mounts the main application interface.
+ * It handles the setup of the core system, loads extensions, and dynamically mounts the main app component.
+ *
+ * Key functionalities:
+ * - Initializes the Kimu system and retrieves the global configuration.
+ * - Loads the list of available extensions and initializes the extension manager.
+ * - Dynamically mounts the main application component (`kimu-app`) to the DOM.
+ * - Handles errors during initialization and ensures the application is properly set up.
+ */
+async function main() {
+  try {
+    console.log('[MAIN] Starting KIMU-App interface');
+    // Initialize path configuration FIRST (before any resource loading)
+    KimuPathConfig.initialize();
+    // Make KimuPathConfig globally available for testing
+    (window as any).KimuPathConfig = KimuPathConfig;
+    // Initialize the Kimu system
+    let kimuApp = await KimuApp.getInstance();
+    console.log("[Kimu] version: ", kimuApp.version);
+    console.log("[Kimu] environment: ", kimuApp.environment);
+    console.log("[Kimu] base-path: ", KimuPathConfig.getBasePath());
+    // Initialize extension manager and the list of available extensions in /extensions
+    const kimuExtensionManager = KimuExtensionManager.getInstance();
+    await kimuExtensionManager.init();
+    // Mount the main app
+    const root = document.getElementById('app');
+    if (!root) {
+      console.error('[MAIN] ❌ Error initializing KIMU-App. Element #app not found in the DOM!');
+      return;
+    }
+    // Mount the extensions
+    // Load the main component of the Kimu application
+    // The main component is the one that has the tag name 'kimu-home'
+    console.log('[KIMU-MAIN] 🚀 Loading kimu-home extension...');
+    const mainAppExtensions = 'kimu-home';
+    try {
+      await kimuExtensionManager.load(mainAppExtensions);
+      // Create and mount the main component
+      const mainComponent = document.createElement(mainAppExtensions);
+      root.appendChild(mainComponent);
+      console.log('[KIMU-MAIN] ✅ Extension loaded and mounted successfully');
+    } catch (loadError) {
+      console.error('[KIMU-MAIN] ❌ Error loading extension:', loadError);
+      throw loadError;
+    }
+    console.log('[KIMU-MAIN] ✅ KIMU APP initialized successfully');
+  } catch (error) {
+    console.error('[KIMU-MAIN] ❌ Error during initialization:', error);
+  }
+}
+// Start the application
+main();

package/src/modules/.gitkeep ADDED Viewed

File without changes

package/src/modules/README.md ADDED Viewed

@@ -0,0 +1,79 @@
+# KIMU Active Modules
+This directory contains **installed modules** that are included in the build.
+## 📦 What's Here
+Only modules that have been explicitly installed using:
+```bash
+npm run install:module <module-name>
+```
+## Current Status
+Check installed modules:
+```bash
+npm run list:modules
+```
+## How It Works
+### Installation Process
+1. Module is **copied** from `src/modules-repository/<module-name>/`
+2. Files appear in this directory: `src/modules/<module-name>/`
+3. Module is registered in `modules-manifest.json`
+4. Module is included in next build
+### Removal Process
+1. Module directory is **deleted** from `src/modules/<module-name>/`
+2. Module is removed from `modules-manifest.json`
+3. Module is excluded from next build
+4. Module remains available in `modules-repository` for reinstallation
+## modules-manifest.json
+This file tracks all installed modules:
+```json
+{
+  "installedModules": [
+    {
+      "name": "i18n",
+      "version": "1.0.0",
+      "path": "i18n",
+      "installedAt": "2025-01-17T00:00:00.000Z"
+    }
+  ],
+  "availableModules": [],
+  "lastUpdate": "2025-01-17T00:00:00.000Z"
+}
+```
+## Best Practices
+- ✅ **Commit `modules-manifest.json`** to track which modules your project uses
+- ✅ **Install only needed modules** to keep build size minimal
+- ❌ **Don't manually edit module files** - changes will be lost on reinstall
+- ❌ **Don't manually modify `modules-manifest.json`** - use provided scripts
+## Commands
+```bash
+# List modules
+npm run list:modules
+# Install a module
+npm run install:module router
+# Remove a module
+npm run remove:module router
+# Build with current modules
+npm run build
+```
+## See Also
+- [Module Management Guide](../../docs/MODULE_MANAGEMENT.md)
+- [Available Modules](../modules-repository/README.md)
+- [Main Documentation](../../README.md)

package/src/modules/i18n/README.it.md ADDED Viewed

@@ -0,0 +1,63 @@
+# Kimu I18n Module
+Il modulo `i18n` di kimu-core fornisce un sistema di internazionalizzazione (internationalization) per applicazioni ed estensioni basate su kimu-core. Permette di gestire facilmente interfacce multilingua, traduzioni di stringhe e cambio dinamico della lingua.
+## Scopo
+- Abilitare la localizzazione di tutte le stringhe visibili all’utente.
+- Gestire più lingue in modo centralizzato e modulare.
+- Fornire API semplici per accedere alle traduzioni e cambiare lingua a runtime.
+## Struttura del modulo
+```
+src/modules/i18n/
+  ├── kimu-i18n-service.ts   # Servizio principale per traduzioni e gestione lingua
+  ├── kimu-global-lang.ts    # Definizione delle lingue globali e risorse
+  ├── module.ts              # Esportazione del modulo come KimuModule
+  └── README.md              # Questa documentazione
+```
+## Come funziona
+- Il servizio `KimuI18nService` gestisce la lingua corrente e fornisce il metodo `translate(key)` per ottenere la stringa tradotta.
+- Le risorse delle lingue sono definite in oggetti o file separati (es. `en`, `it`, ecc.).
+- È possibile cambiare lingua a runtime e aggiornare dinamicamente l’interfaccia.
+## Utilizzo base
+```typescript
+import I18nModule from 'src/modules/i18n/module';
+// Istanzia il modulo e imposta la lingua di default
+const i18nModule = new I18nModule('i18n', '1.0.0', { lang: 'it' });
+const i18n = i18nModule.getService();
+// Traduci una chiave
+console.log(i18n.translate('hello'));
+// Cambia lingua
+i18n.setLang('en');
+```
+## Integrazione in un’estensione
+```typescript
+// Nel componente
+getData() {
+  return {
+    translate: this.i18n.translate,
+    // ...altri dati
+  };
+}
+// Nel template HTML: <span>${translate('welcome')}</span>
+```
+## Best practice
+- Definisci tutte le stringhe utente tramite chiavi, mai testo hardcoded.
+- Mantieni le risorse delle lingue aggiornate e documentate.
+- Fornisci sempre l’inglese come fallback.
+- Documenta come aggiungere nuove lingue.
+## Vantaggi
+- UI multilingua pronta all’uso.
+- Cambi di lingua reattivi e centralizzati.
+- Facilmente estendibile per nuove lingue o domini.
+---
+Autore: UnicoVerso

package/src/modules/i18n/README.md ADDED Viewed

@@ -0,0 +1,63 @@
+# Kimu I18n Module
+The `i18n` module in kimu-core provides an internationalization system for kimu-core-based applications and extensions. It allows you to easily manage multilingual interfaces, string translations, and dynamic language switching.
+## Purpose
+- Enable localization of all user-visible strings.
+- Manage multiple languages in a centralized and modular way.
+- Provide simple APIs to access translations and change language at runtime.
+## Module Structure
+```
+src/modules/i18n/
+  ├── kimu-i18n-service.ts   # Main service for translations and language management
+  ├── kimu-global-lang.ts    # Definition of global languages and resources
+  ├── module.ts              # Module export as KimuModule
+  └── README.md              # This documentation
+```
+## How it works
+- The `KimuI18nService` manages the current language and provides the `translate(key)` method to get the translated string.
+- Language resources are defined in separate objects or files (e.g., `en`, `it`, etc.).
+- You can change language at runtime and dynamically update the interface.
+## Basic usage
+```typescript
+import I18nModule from 'src/modules/i18n/module';
+// Instantiate the module and set the default language
+const i18nModule = new I18nModule('i18n', '1.0.0', { lang: 'it' });
+const i18n = i18nModule.getService();
+// Translate a key
+console.log(i18n.translate('hello'));
+// Change language
+i18n.setLang('en');
+```
+## Integration in an extension
+```typescript
+// In the component
+getData() {
+  return {
+    translate: this.i18n.translate,
+    // ...other data
+  };
+}
+// In the HTML template: <span>${translate('welcome')}</span>
+```
+## Best practices
+- Define all user strings using keys, never hardcoded text.
+- Keep language resources updated and documented.
+- Always provide English as a fallback.
+- Document how to add new languages.
+## Advantages
+- Ready-to-use multilingual UI.
+- Reactive and centralized language changes.
+- Easily extendable for new languages or domains.
+---
+Author: UnicoVerso

package/src/modules/i18n/kimu-global-lang.ts ADDED Viewed

@@ -0,0 +1,26 @@
+export type LangChangeCallback = (lang: string) => void;
+export class KimuGlobalLang {
+  private static currentLang: string = 'it';
+  private static listeners: LangChangeCallback[] = [];
+  static set(lang: string) {
+    //console.log(`[KimuGlobalLang] set language: ${lang}`);
+    if (lang !== this.currentLang) {
+      this.currentLang = lang;
+      this.listeners.forEach(fn => fn(lang));
+    }
+  }
+  static get(): string {
+    return this.currentLang;
+  }
+  static onChange(cb: LangChangeCallback) {
+    this.listeners.push(cb);
+  }
+  static off(cb: LangChangeCallback) {
+    this.listeners = this.listeners.filter(fn => fn !== cb);
+  }
+}

package/src/modules/i18n/kimu-i18n-service.ts ADDED Viewed

@@ -0,0 +1,108 @@
+import { KimuExtensionLanguages } from '../../core/kimu-types';
+/**
+ * KimuI18nService provides internationalization support for Kimu extensions.
+ * It loads translation files, manages language switching, and supports parameterized translations.
+ */
+export class KimuI18nService {
+  private lang: string;
+  private translations: Record<string, string> = {};
+  private basePath: string;
+  private languages: KimuExtensionLanguages;
+  /**
+   * Creates a new I18n service instance.
+   * @param defaultLang The default language code (e.g. 'it').
+   * @param basePath The base path for language files.
+   * @param languages Optional: supported languages metadata. If not provided, fallback to default only.
+   */
+  constructor(defaultLang: string = 'it', basePath: string = './lang', languages?: KimuExtensionLanguages | null) {
+    this.lang = defaultLang;
+    this.basePath = basePath;
+    // If languages is not defined, fallback to only the initial language
+    this.languages = languages ?? {
+      default: defaultLang,
+      supported: {
+        [defaultLang]: { code: defaultLang },
+      },
+    };
+    // Use requested language only if supported, otherwise fallback to default
+    this.lang = this.resolveLang(defaultLang);
+    // Always bind translate to this instance
+    this.translate = this.translate.bind(this);
+  }
+  /**
+   * Returns the effective language to use (fallbacks to default if not supported).
+   * @param lang Requested language code.
+   */
+  private resolveLang(lang: string): string {
+    if (this.languages.supported[lang]) return lang;
+    return this.languages.default;
+  }
+  /**
+   * Changes the current language and loads the corresponding translation file.
+   * Returns a promise that resolves when the file is loaded.
+   * @param lang Language code to set.
+   */
+  async setLang(lang: string) {
+    this.lang = this.resolveLang(lang);
+    return await this.loadLang();
+  }
+  /**
+   * Returns the current language code for the extension.
+   */
+  getLang(): string {
+    return this.lang;
+  }
+  /**
+   * Loads the translation file for the current language.
+   * Uses the language metadata if available, otherwise defaults to <lang>.json.
+   * Returns a promise that resolves when the file is loaded.
+   */
+  async loadLang(): Promise<void> {
+    const langMeta = this.languages.supported[this.lang];
+    // Use custom file name if provided, otherwise default to <lang>.json
+    const file = langMeta.file || `${this.lang}.json`;
+    const url = `${this.basePath}/${file}`;
+    return await this.loadFromUrl(url);
+  }
+  /**
+   * Loads translations from a given URL (internal or external).
+   * If the file is not found or invalid, falls back to an empty translation object.
+   * @param url The URL to fetch the translation file from.
+   */
+  async loadFromUrl(url: string): Promise<void> {
+    try {
+      const res = await fetch(url);
+      if (!res.ok) {
+        throw new Error(`Lang file not found: ${url}`);
+      }
+      this.translations = await res.json();
+    } catch (err) {
+      console.warn(`[KimuI18nService] ERROR: ${err}`);
+      this.translations = {}; // fallback to empty translations
+    }
+  }
+  /**
+   * Translates a key using the loaded translations.
+   * Supports optional parameters identified by {{param}} in the translation string.
+   * If the key is not found, returns the key itself.
+   * @param key The translation key.
+   * @param params Optional: parameters to replace in the translation string.
+   */
+  translate(key: string, params?: Record<string, any>): string {
+    let value = this.translations[key] || key;
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        value = value.replace(new RegExp(`{{${k}}}`, 'g'), v);
+      }
+    }
+    return value;
+  }
+}

package/src/modules/i18n/manifest.json ADDED Viewed

@@ -0,0 +1,22 @@
+{
+  "name": "i18n",
+  "version": "1.0.0",
+  "description": "Internationalization module for KIMU applications with multi-language support and dynamic translation system",
+  "author": "KIMU Team",
+  "license": "MPL-2.0",
+  "dependencies": [],
+  "kimuCoreVersion": "^0.3.0",
+  "keywords": [
+    "i18n",
+    "internationalization",
+    "localization",
+    "translation",
+    "multilingual",
+    "language"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UnicoVerso/kimu-core",
+    "directory": "src/modules/i18n"
+  }
+}

package/src/modules/i18n/module.ts ADDED Viewed

@@ -0,0 +1,39 @@
+import { KimuModule } from '../../core/kimu-module';
+import { KimuModuleOptions } from '../../core/kimu-types';
+import { KimuGlobalLang } from './kimu-global-lang';
+import { KimuI18nService } from './kimu-i18n-service';
+export default class I18nModule extends KimuModule {
+  private static instance: I18nModule | null = null;
+  private globalLang: typeof KimuGlobalLang;
+  private service: KimuI18nService;
+  constructor(name: string, version: string, options?: KimuModuleOptions & { basePath?: string; languages?: any }) {
+    super(name, version, options);
+    this.singleton = true; // Marca come singleton
+    this.globalLang = KimuGlobalLang;
+    this.service = new KimuI18nService(
+      options?.lang || 'it',
+      options?.basePath || './lang',
+      options?.languages
+    );
+  }
+  static getInstance(options?: KimuModuleOptions & { basePath?: string; languages?: any }): I18nModule {
+    if (!I18nModule.instance) {
+      I18nModule.instance = new I18nModule('i18n', '1.0.0', options);
+    }
+    return I18nModule.instance;
+  }
+  getService(): KimuI18nService {
+    return this.service;
+  }
+  getGlobalLang(): typeof KimuGlobalLang {
+    return this.globalLang;
+  }
+}
+// Export direct access to services (for optimized extension usage)
+export { KimuGlobalLang, KimuI18nService };

package/src/modules/modules-manifest.json ADDED Viewed

@@ -0,0 +1,12 @@
+{
+  "installedModules": [
+    {
+      "name": "i18n",
+      "version": "1.0.0",
+      "path": "i18n",
+      "installedAt": "2025-01-17T00:00:00.000Z"
+    }
+  ],
+  "availableModules": [],
+  "lastUpdate": "2025-11-04T13:37:31.093Z"
+}

package/src/modules-repository/README.md ADDED Viewed

@@ -0,0 +1,108 @@
+# KIMU Modules Repository
+This directory contains **available modules** that can be installed in KIMU applications.
+## ⚠️ Important Rules
+1. **DO NOT modify files in this directory** - This is the central repository
+2. **DO NOT import from this directory** - Use `src/modules/` instead
+3. **To use a module**, install it first: `npm run install:module <module-name>`
+## 📁 Location
+This repository is located in `src/modules-repository/` to ensure:
+- ✅ Correct TypeScript import paths
+- ✅ IDE autocompletion and type checking
+- ✅ No compilation errors during module development
+- ✅ Automatic exclusion from build via tree-shaking
+## How it works
+### Installation
+When you install a module (e.g., `npm run install:module router`):
+1. The module is **copied** from `src/modules-repository/router/` to `src/modules/router/`
+2. The module becomes part of the build
+3. You can import and use it in your application
+### Uninstallation
+When you remove a module (e.g., `npm run remove:module router`):
+1. The module is **deleted** from `src/modules/router/`
+2. The module is excluded from the build
+3. It remains available in `src/modules-repository/` for future reinstallation
+### Repository Structure
+```
+src/modules-repository/
+├── router/
+│   ├── manifest.json       # Module metadata and dependencies
+│   ├── module.ts           # Module class (entry point)
+│   ├── router.ts           # Service implementation
+│   ├── README.md           # English documentation
+│   └── README.it.md        # Italian documentation
+└── i18n/
+    ├── manifest.json
+    ├── module.ts
+    ├── i18n-service.ts
+    ├── README.md
+    └── README.it.md
+```
+## Adding New Modules
+1. Create a folder with the module name in `src/modules-repository/`
+2. Add required files:
+   - `manifest.json` - Module metadata, dependencies, and compatibility
+   - `module.ts` - Main module class extending `KimuModule`
+   - Service implementation files
+   - `README.md` - English documentation
+   - `README.it.md` (optional) - Italian documentation
+3. Use standard import paths (they will work correctly from this location)
+## Available Modules
+### Router Module
+**Location:** `router/`
+**Version:** 1.0.0
+**Description:** Client-side routing module for KIMU applications with History API support
+**Install:**
+```bash
+npm run install:module router
+```
+**Usage after installation:**
+```typescript
+import RouterModule from './modules/router/module';
+const router = new RouterModule();
+const routerService = router.getService();
+routerService.addRoute('/', () => console.log('Home'));
+routerService.navigate('/');
+```
+## Commands Reference
+```bash
+# List all available and installed modules
+npm run list:modules
+# Install a module from repository
+npm run install:module <module-name>
+# Remove an installed module
+npm run remove:module <module-name>
+```
+## Build Behavior
+Modules in `src/modules-repository/` are **automatically excluded** from the build because:
+- They are never imported by the main application
+- Vite's tree-shaking removes unused code
+- Only modules in `src/modules/` (installed) are included in the final bundle
+## See Also
+- [Module Management Guide](../../docs/MODULE_MANAGEMENT.md)
+- [Creating Extensions](../../docs/EXTENSIONS.md)
+- [Main Documentation](../../README.md)