kimu-core 0.5.0 → 0.6.0

package/.github/kimu-copilot-instructions.md

@@ -1571,11 +1571,10 @@ import RouterModule from './modules/router/module';
 
 // Initialize router module
 const moduleManager = KimuModuleManager.getInstance();
-const routerModule = new RouterModule();
-await moduleManager.loadModule(routerModule);
+await moduleManager.loadModule('router');
 
 // Get router service
-const router = moduleManager.getRouterService();
+const router = moduleManager.getService('router');
 
 // Define routes
 router.addRoute('/', () => {
@@ -1604,7 +1603,8 @@ export class NavigationComponent extends KimuComponentElement {
 
   async onInit() {
     // Get router service from module manager
-    this.router = KimuModuleManager.getInstance().getRouterService();
+    const moduleManager = KimuModuleManager.getInstance();
+    this.router = moduleManager.getService('router');
   }
 
   navigateToHome() {
@@ -1710,7 +1710,8 @@ export class AppRouterComponent extends KimuComponentElement {
   private router: KimuRouterService;
 
   async onInit() {
-    this.router = KimuModuleManager.getInstance().getRouterService();
+    const moduleManager = KimuModuleManager.getInstance();
+    this.router = moduleManager.getService('router');
     
     // Setup application routes
     this.setupRoutes();
@@ -2511,10 +2512,9 @@ import { KimuModuleManager } from '@kimu/core';
 import RouterModule from './modules/router/module';
 
 const moduleManager = KimuModuleManager.getInstance();
-const routerModule = new RouterModule();
-await moduleManager.loadModule(routerModule);
+await moduleManager.loadModule('router');
 
-const router = moduleManager.getRouterService();
+const router = moduleManager.getService('router');
 ```
 
 #### 2. Define Routes
@@ -2631,7 +2631,8 @@ export class NavigationComponent extends KimuComponentElement {
   
   async onInit() {
     // Get router service
-    this.router = KimuModuleManager.getInstance().getRouterService();
+    const moduleManager = KimuModuleManager.getInstance();
+    this.router = moduleManager.getService('router');
     
     // Listen for route changes
     this.router.onRouteChange(this.handleRouteChange.bind(this));
@@ -2771,14 +2772,13 @@ import { KimuModuleManager } from '@kimu/core';
 import I18nModule from './modules/i18n/module';
 
 const moduleManager = KimuModuleManager.getInstance();
-const i18nModule = new I18nModule('i18n', '1.0.0', {
+await moduleManager.loadModule('i18n', {
   defaultLanguage: 'en',
   fallbackLanguage: 'en',
   supportedLanguages: ['en', 'it', 'fr']
 });
-await moduleManager.loadModule(i18nModule);
 
-const i18n = moduleManager.getI18nService();
+const i18n = moduleManager.getService('i18n');
 ```
 
 #### 3. Use Translations in Components
@@ -2788,7 +2788,8 @@ export class MyComponent extends KimuComponentElement {
   private i18n: any;
   
   onInit() {
-    this.i18n = KimuModuleManager.getInstance().getI18nService();
+    const moduleManager = KimuModuleManager.getInstance();
+    this.i18n = moduleManager.getService('i18n');
   }
   
   getData() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kimu-core",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": false,
   "type": "module",
   "license": "MPL-2.0",

package/src/core/kimu-module-manager.ts

@@ -32,6 +32,17 @@ export class KimuModuleManager {
     return instance;
   }
 
+  /**
+   * Register an already instantiated module
+   * Useful for manually created module instances
+   */
+  registerModule(name: string, instance: KimuModule): void {
+    if (this.modules.has(name)) {
+      console.warn(`[KimuModuleManager] Module '${name}' already registered, replacing...`);
+    }
+    this.modules.set(name, instance);
+  }
+
   getModule(name: string): KimuModule | undefined {
     return this.modules.get(name);
   }
@@ -46,24 +57,4 @@ export class KimuModuleManager {
     const mod = this.modules.get(name);
     return mod ? mod.getService() : undefined;
   }
-
-  // Convenience methods for commonly used modules
-  async getI18nService(options?: KimuModuleOptions): Promise<any> {
-    const module = await this.loadModule('i18n', options);
-    return module.getService();
-  }
-
-  async getRouterService(options?: KimuModuleOptions): Promise<any> {
-    const module = await this.loadModule('router', options);
-    return module.getService();
-  }
-
-  // Static convenience methods for global access
-  static async getI18nService(options?: KimuModuleOptions): Promise<any> {
-    return KimuModuleManager.getInstance().getI18nService(options);
-  }
-
-  static async getRouterService(options?: KimuModuleOptions): Promise<any> {
-    return KimuModuleManager.getInstance().getRouterService(options);
-  }
 }

package/src/modules-repository/api-axios/manifest.json

@@ -0,0 +1,25 @@
+{
+  "name": "api-axios",
+  "version": "1.0.0",
+  "description": "Axios-based API module for KIMU applications with advanced features including interceptors, cancellation and request/response transformations",
+  "author": "KIMU Team",
+  "license": "MPL-2.0",
+  "dependencies": [
+    "axios"
+  ],
+  "kimuCoreVersion": "^0.3.0",
+  "keywords": [
+    "api",
+    "axios",
+    "http",
+    "rest",
+    "client",
+    "ajax",
+    "request"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UnicoVerso/kimu-core",
+    "directory": "src/modules/api-axios"
+  }
+}

package/src/modules-repository/api-core/manifest.json

@@ -0,0 +1,23 @@
+{
+  "name": "api-core",
+  "version": "1.0.0",
+  "description": "Core API module for KIMU applications providing HTTP client with interceptors, retry logic and comprehensive error handling",
+  "author": "KIMU Team",
+  "license": "MPL-2.0",
+  "dependencies": [],
+  "kimuCoreVersion": "^0.3.0",
+  "keywords": [
+    "api",
+    "http",
+    "rest",
+    "fetch",
+    "client",
+    "ajax",
+    "request"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UnicoVerso/kimu-core",
+    "directory": "src/modules/api-core"
+  }
+}

package/src/modules-repository/event-bus/manifest.json

@@ -0,0 +1,22 @@
+{
+  "name": "event-bus",
+  "version": "1.0.0",
+  "description": "Event bus module for KIMU applications enabling decoupled component communication through publish-subscribe pattern",
+  "author": "KIMU Team",
+  "license": "MPL-2.0",
+  "dependencies": [],
+  "kimuCoreVersion": "^0.3.0",
+  "keywords": [
+    "event-bus",
+    "events",
+    "pub-sub",
+    "messaging",
+    "communication",
+    "decoupling"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UnicoVerso/kimu-core",
+    "directory": "src/modules/event-bus"
+  }
+}

package/src/modules-repository/notification/manifest.json

@@ -0,0 +1,22 @@
+{
+  "name": "notification",
+  "version": "1.0.0",
+  "description": "Notification module for KIMU applications with support for toast messages, alerts and customizable notification types",
+  "author": "KIMU Team",
+  "license": "MPL-2.0",
+  "dependencies": [],
+  "kimuCoreVersion": "^0.3.0",
+  "keywords": [
+    "notification",
+    "toast",
+    "alert",
+    "messages",
+    "user-feedback",
+    "ui"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UnicoVerso/kimu-core",
+    "directory": "src/modules/notification"
+  }
+}

package/src/modules-repository/state/manifest.json

@@ -0,0 +1,22 @@
+{
+  "name": "state",
+  "version": "1.0.0",
+  "description": "State management module for KIMU applications providing centralized reactive state with subscription support",
+  "author": "KIMU Team",
+  "license": "MPL-2.0",
+  "dependencies": [],
+  "kimuCoreVersion": "^0.3.0",
+  "keywords": [
+    "state",
+    "state-management",
+    "reactive",
+    "store",
+    "data-flow",
+    "centralized-state"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UnicoVerso/kimu-core",
+    "directory": "src/modules/state"
+  }
+}

package/src/modules-repository/theme/manifest.json

@@ -0,0 +1,22 @@
+{
+  "name": "theme",
+  "version": "1.0.0",
+  "description": "Theme management module for KIMU applications with dark/light mode support and customizable theme configurations",
+  "author": "KIMU Team",
+  "license": "MPL-2.0",
+  "dependencies": [],
+  "kimuCoreVersion": "^0.3.0",
+  "keywords": [
+    "theme",
+    "dark-mode",
+    "light-mode",
+    "styling",
+    "customization",
+    "ui"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UnicoVerso/kimu-core",
+    "directory": "src/modules/theme"
+  }
+}