kimu-core 0.4.1 → 0.5.0

package/src/modules-repository/router/README.it.md

@@ -8,23 +8,74 @@ Questo modulo fornisce un servizio di routing per kimu-core, permettendo la gest
 - Callback sugli eventi di cambio rotta
 - API per registrare nuove rotte dinamicamente
 
-## Utilizzo
+## Configurazione Post-Installazione
+
+Dopo aver installato il modulo router, devi creare un file di configurazione delle rotte:
+
+### 1. Crea il file di configurazione routes
+
+Copia il file di esempio nella cartella config:
+```bash
+mkdir -p src/config/router
+cp src/modules/router/router-config.ts.example src/config/router/router-config.ts
+```
+
+Oppure crea `src/config/router/router-config.ts` manualmente:
+
+```typescript
+import { RouteConfig } from '../../modules/router/router';
+
+export const routes: RouteConfig[] = [
+  {
+    path: '/',
+    component: 'app-home',
+    name: 'home',
+    meta: { title: 'Home' }
+  },
+  {
+    path: '/about',
+    component: 'app-about',
+    name: 'about',
+    meta: { title: 'Chi Siamo' }
+  },
+  // Aggiungi le tue rotte qui...
+];
+```
+
+### 2. Inizializza il router in main.ts
 
 ```typescript
-import { KimuRouterService } from './src/modules/router/router';
+import { KimuModuleManager } from './core/kimu-module-manager';
+import RouterModule from './modules/router/module';
+import { routes } from './config/router/router-config';
 
-const router = KimuRouterService.getInstance();
-router.configure([
-  { path: '/', component: HomeComponent },
-  { path: '/about', component: AboutComponent },
-]);
+const moduleManager = KimuModuleManager.getInstance();
 
+// Opzione 1: Passa le rotte durante l'inizializzazione
+const routerModule = new RouterModule('router', '1.0.0', { routes });
+await moduleManager.loadModule(routerModule);
+
+// Opzione 2: Configura dopo l'inizializzazione
+const router = moduleManager.getModule('router').getService();
+router.configure(routes);
+```
+
+### 3. Naviga tra le rotte
+
+```typescript
+const router = moduleManager.getModule('router').getService();
+
+// Naviga verso una rotta
+router.navigate('/about');
+
+// Ascolta i cambiamenti di rotta
 router.onRouteChange((route) => {
-  // Logica per gestire il cambio rotta
+  console.log('Rotta cambiata:', route.path);
+  // Aggiorna UI, carica componenti, ecc.
 });
 
-// Per navigare
-router.navigate('/about');
+// Ottieni la rotta corrente
+const currentRoute = router.getCurrentRoute();
 ```
 
 ## Estensione

package/src/modules-repository/router/README.md

@@ -8,23 +8,74 @@ This module provides a routing service for kimu-core, allowing you to manage rou
 - Callback on route change events
 - API to register new routes dynamically
 
-## Usage
+## Post-Installation Setup
+
+After installing the router module, you need to create a routes configuration file:
+
+### 1. Create routes configuration file
+
+Copy the example file to your config folder:
+```bash
+mkdir -p src/config/router
+cp src/modules/router/router-config.ts.example src/config/router/router-config.ts
+```
+
+Or create `src/config/router/router-config.ts` manually:
+
+```typescript
+import { RouteConfig } from '../../modules/router/router';
+
+export const routes: RouteConfig[] = [
+  {
+    path: '/',
+    component: 'app-home',
+    name: 'home',
+    meta: { title: 'Home' }
+  },
+  {
+    path: '/about',
+    component: 'app-about',
+    name: 'about',
+    meta: { title: 'About' }
+  },
+  // Add your routes here...
+];
+```
+
+### 2. Initialize router in main.ts
 
 ```typescript
-import { KimuRouterService } from './src/modules/router/router';
+import { KimuModuleManager } from './core/kimu-module-manager';
+import RouterModule from './modules/router/module';
+import { routes } from './config/router/router-config';
 
-const router = KimuRouterService.getInstance();
-router.configure([
-  { path: '/', component: HomeComponent },
-  { path: '/about', component: AboutComponent },
-]);
+const moduleManager = KimuModuleManager.getInstance();
 
+// Option 1: Pass routes during initialization
+const routerModule = new RouterModule('router', '1.0.0', { routes });
+await moduleManager.loadModule(routerModule);
+
+// Option 2: Configure after initialization
+const router = moduleManager.getModule('router').getService();
+router.configure(routes);
+```
+
+### 3. Navigate between routes
+
+```typescript
+const router = moduleManager.getModule('router').getService();
+
+// Navigate to a route
+router.navigate('/about');
+
+// Listen for route changes
 router.onRouteChange((route) => {
-  // Logic to handle route change
+  console.log('Route changed to:', route.path);
+  // Update UI, load components, etc.
 });
 
-// To navigate
-router.navigate('/about');
+// Get current route
+const currentRoute = router.getCurrentRoute();
 ```
 
 ## Extension

package/src/modules-repository/router/router-config.ts.example

@@ -0,0 +1,61 @@
+// Router Configuration Example File
+// Copy this file to: src/config/router/router-config.ts
+//
+// Commands:
+//   mkdir -p src/config/router
+//   cp src/modules/router/router-config.ts.example src/config/router/router-config.ts
+//
+// Then import in your main.ts:
+//   import { routes } from './config/router/router-config';
+//
+// This file defines all routes for your KIMU application.
+// Each route maps a URL path to a component (extension).
+
+import { RouteConfig } from '../../modules/router/router';
+
+/**
+ * Application routes configuration
+ * 
+ * Define your routes here following this pattern:
+ * {
+ *   path: '/url-path',        // The URL path to match
+ *   component: ComponentName, // The component/extension to render
+ *   name: 'route-name',       // Optional: friendly name for the route
+ *   meta: { ... }             // Optional: custom metadata
+ * }
+ */
+export const routes: RouteConfig[] = [
+  {
+    path: '/',
+    component: 'app-home', // or import and use: HomeComponent
+    name: 'home',
+    meta: { title: 'Home' }
+  },
+  {
+    path: '/about',
+    component: 'app-about',
+    name: 'about',
+    meta: { title: 'About Us' }
+  },
+  {
+    path: '/contact',
+    component: 'app-contact',
+    name: 'contact',
+    meta: { title: 'Contact' }
+  },
+  // Add more routes here...
+];
+
+/**
+ * Usage in main.ts:
+ * 
+ * import RouterModule from './modules/router/module';
+ * import { routes } from './router-config';
+ * 
+ * const routerModule = new RouterModule('router', '1.0.0', { routes });
+ * await moduleManager.loadModule(routerModule);
+ * 
+ * // Or configure after initialization:
+ * const router = moduleManager.getModule('router').getService();
+ * router.configure(routes);
+ */

package/src/modules-repository/router/router.ts

@@ -70,8 +70,26 @@ export class KimuRouterService {
   /**
    * Configure the router with a set of routes.
    * @param routes Array of RouteConfig
+   * @throws Error if routes array is empty or undefined
    */
   public configure(routes: RouteConfig[]): void {
+    if (!routes || routes.length === 0) {
+      console.error(
+        '\n⚠️  KIMU Router: No routes configured!\n\n' +
+        'The router requires a configuration file with your application routes.\n\n' +
+        'Expected location: src/config/router/router-config.ts\n\n' +
+        'To create the configuration file:\n' +
+        '1. Create config folder: mkdir -p src/config/router\n' +
+        '2. Copy the example: cp src/modules/router/router-config.ts.example src/config/router/router-config.ts\n' +
+        '3. Edit src/config/router/router-config.ts to define your routes\n' +
+        '4. Import and pass routes to the router in main.ts\n\n' +
+        'Example:\n' +
+        '  import { routes } from \'./config/router/router-config\';\n' +
+        '  router.configure(routes);\n\n' +
+        'See: src/modules/router/router-config.ts.example for a complete example.\n'
+      );
+      throw new Error('Router configuration missing. Please create src/config/router/router-config.ts');
+    }
     this.routes = routes;
   }