@chill-sharp/create-app 1.1.12 → 1.1.15

package/template/doc/it/CurrentUserPreferences.md

@@ -1,106 +1,106 @@
-# Preferenze Dell'Utente Corrente
-
-English version: [English](../CurrentUserPreferences.md)
-
-`ChillSharp.Auth` puo rendere disponibili agli hook del ciclo di vita delle entita le preferenze di visualizzazione dell'utente autenticato senza interrogare `AuthUser` a ogni salvataggio.
-
-Lo snapshot immutabile `ChillUserPreferences` contiene:
-
-- `DisplayCultureName`
-- `DisplayTimeZone`
-- `DisplayDateFormat`
-- `DisplayNumberFormat`
-- `PreferredTheme`
-
-## Registrazione E Ciclo Di Vita Della Cache
-
-`AddChillAuthApi<TContext>()` registra il singleton `IChillAuthUserPreferencesCache` e lo scoped `IChillAuthUserPreferencesAccessor`.
-
-Quando l'utente esegue il login o rinnova un token, ChillSharp carica una volta l'`AuthUser` corrispondente e inizializza uno snapshot associato al suo `ExternalId`. L'accessor legge solo quello snapshot in memoria durante le richieste; non interroga la tabella utenti.
-
-`ChillAuthService` aggiorna lo snapshot in cache dopo la creazione o l'aggiornamento di un `AuthUser`. Invalida lo snapshot di un utente eliminato ed entrambe le chiavi, precedente e nuova, quando cambia `ExternalId`.
-
-La cache memorizza valori scalari delle preferenze, mai un'istanza EF Core tracciata di `AuthUser`.
-
-## API delle preferenze dell'utente corrente
-
-I client autenticati possono recuperare lo stesso snapshot utilizzato dal codice server con:
-
-```http
-GET /api/chill-auth/current-user-preferences
-Authorization: Bearer <access token>
-```
-
-La risposta e un oggetto JSON `ChillUserPreferences`:
-
-```json
-{
-  "displayCultureName": "it-IT",
-  "displayTimeZone": "Europe/Rome",
-  "displayDateFormat": "dd/MM/yyyy",
-  "displayNumberFormat": "N2",
-  "preferredTheme": "cini"
-}
-```
-
-Usa questo endpoint dopo il login e durante il ripristino di una sessione UI autenticata. E la fonte autorevole per lingua/cultura, fuso orario, formato data e formato numerico usati dal client API e dalla UI; non ricavare tali valori dal browser, dal sistema operativo, dalle claim del token o da un endpoint di gestione dell'autenticazione.
-
-Il client C# espone `GetCurrentUserPreferences()`. Il client Python espone `get_current_user_preferences()`, mentre il client TypeScript e il wrapper Angular espongono `getCurrentUserPreferences()`. I pacchetti Vue e React forniscono inoltre `useCurrentUserPreferences()`.
-
-Nel pacchetto Angular UI Core, inietta `ChillService` e usa il signal `userPreferences` oppure le singole proiezioni `displayCultureName`, `displayTimeZone`, `displayDateFormat`, `displayNumberFormat` e `preferredTheme`. `PreferredTheme` e una stringa opaca salvata dal server. UI Core usa `prefers-color-scheme` del browser prima del login; le app client aggiungono temi selezionabili con `provideChillSharpUiCore({ additionalThemes: ['cini'] })`.
-
-## DbContext Host
-
-Per impostazione predefinita `IChillContext.GetCurrentUserPreferences()` restituisce `ChillUserPreferences.Empty`. In un contesto host personalizzato con auth abilitata, inietta `IChillAuthUserPreferencesAccessor` e delega a esso:
-
-```csharp
-using ChillSharp;
-using ChillSharp.Auth.Services;
-
-public class AppDbContext : DbContext, IChillContext, IChillAuthDbContext
-{
-    private readonly IChillAuthUserPreferencesAccessor? _userPreferencesAccessor;
-
-    public AppDbContext(
-        DbContextOptions<AppDbContext> options,
-        IChillAuthUserPreferencesAccessor? userPreferencesAccessor = null)
-        : base(options)
-    {
-        _userPreferencesAccessor = userPreferencesAccessor;
-    }
-
-    public ChillUserPreferences GetCurrentUserPreferences() =>
-        _userPreferencesAccessor?.Current ?? ChillUserPreferences.Empty;
-
-    public string GetDefaultUserCultureName()
-    {
-        var cultureName = GetCurrentUserPreferences().DisplayCultureName;
-        return string.IsNullOrWhiteSpace(cultureName)
-            ? GetPrimaryCultureName()
-            : cultureName;
-    }
-}
-```
-
-Il parametro opzionale del costruttore mantiene compatibile la creazione a design-time e i test che costruiscono direttamente il contesto. Un contesto creato normalmente dalla dependency injection riceve l'accessor.
-
-`ChillAuthDbContext` implementa gia questo schema.
-
-## Hook Del Ciclo Di Vita Delle Entita
-
-Usa lo snapshot direttamente dall'`IChillContext` fornito. Nell'hook non e necessario alcun accesso al database.
-
-```csharp
-public override void OnUpdate(IChillContext context)
-{
-    var preferences = context.GetCurrentUserPreferences();
-    var timeZone = preferences.DisplayTimeZone;
-
-    if (!string.IsNullOrWhiteSpace(timeZone))
-    {
-        // Applica il comportamento relativo al fuso orario dell'applicazione.
-    }
-}
-```
-
-Tutti i valori possono essere vuoti per job in background, chiamate non autenticate o un utente senza un `AuthUser` corrispondente. Considerali opzionali e scegli un fallback dell'applicazione. Valida `DisplayTimeZone` prima di usarlo come identificatore di fuso orario.
+# Preferenze Dell'Utente Corrente
+
+English version: [English](../CurrentUserPreferences.md)
+
+`ChillSharp.Auth` puo rendere disponibili agli hook del ciclo di vita delle entita le preferenze di visualizzazione dell'utente autenticato senza interrogare `AuthUser` a ogni salvataggio.
+
+Lo snapshot immutabile `ChillUserPreferences` contiene:
+
+- `DisplayCultureName`
+- `DisplayTimeZone`
+- `DisplayDateFormat`
+- `DisplayNumberFormat`
+- `PreferredTheme`
+
+## Registrazione E Ciclo Di Vita Della Cache
+
+`AddChillAuthApi<TContext>()` registra il singleton `IChillAuthUserPreferencesCache` e lo scoped `IChillAuthUserPreferencesAccessor`.
+
+Quando l'utente esegue il login o rinnova un token, ChillSharp carica una volta l'`AuthUser` corrispondente e inizializza uno snapshot associato al suo `ExternalId`. L'accessor legge solo quello snapshot in memoria durante le richieste; non interroga la tabella utenti.
+
+`ChillAuthService` aggiorna lo snapshot in cache dopo la creazione o l'aggiornamento di un `AuthUser`. Invalida lo snapshot di un utente eliminato ed entrambe le chiavi, precedente e nuova, quando cambia `ExternalId`.
+
+La cache memorizza valori scalari delle preferenze, mai un'istanza EF Core tracciata di `AuthUser`.
+
+## API delle preferenze dell'utente corrente
+
+I client autenticati possono recuperare lo stesso snapshot utilizzato dal codice server con:
+
+```http
+GET /api/chill-auth/current-user-preferences
+Authorization: Bearer <access token>
+```
+
+La risposta e un oggetto JSON `ChillUserPreferences`:
+
+```json
+{
+  "displayCultureName": "it-IT",
+  "displayTimeZone": "Europe/Rome",
+  "displayDateFormat": "dd/MM/yyyy",
+  "displayNumberFormat": "N2",
+  "preferredTheme": "cini"
+}
+```
+
+Usa questo endpoint dopo il login e durante il ripristino di una sessione UI autenticata. E la fonte autorevole per lingua/cultura, fuso orario, formato data e formato numerico usati dal client API e dalla UI; non ricavare tali valori dal browser, dal sistema operativo, dalle claim del token o da un endpoint di gestione dell'autenticazione.
+
+Il client C# espone `GetCurrentUserPreferences()`. Il client Python espone `get_current_user_preferences()`, mentre il client TypeScript e il wrapper Angular espongono `getCurrentUserPreferences()`. I pacchetti Vue e React forniscono inoltre `useCurrentUserPreferences()`.
+
+Nel pacchetto Angular UI Core, inietta `ChillService` e usa il signal `userPreferences` oppure le singole proiezioni `displayCultureName`, `displayTimeZone`, `displayDateFormat`, `displayNumberFormat` e `preferredTheme`. `PreferredTheme` e una stringa opaca salvata dal server. UI Core usa `prefers-color-scheme` del browser prima del login; le app client aggiungono temi selezionabili con `provideChillSharpUiCore({ additionalThemes: ['cini'] })`.
+
+## DbContext Host
+
+Per impostazione predefinita `IChillContext.GetCurrentUserPreferences()` restituisce `ChillUserPreferences.Empty`. In un contesto host personalizzato con auth abilitata, inietta `IChillAuthUserPreferencesAccessor` e delega a esso:
+
+```csharp
+using ChillSharp;
+using ChillSharp.Auth.Services;
+
+public class AppDbContext : DbContext, IChillContext, IChillAuthDbContext
+{
+    private readonly IChillAuthUserPreferencesAccessor? _userPreferencesAccessor;
+
+    public AppDbContext(
+        DbContextOptions<AppDbContext> options,
+        IChillAuthUserPreferencesAccessor? userPreferencesAccessor = null)
+        : base(options)
+    {
+        _userPreferencesAccessor = userPreferencesAccessor;
+    }
+
+    public ChillUserPreferences GetCurrentUserPreferences() =>
+        _userPreferencesAccessor?.Current ?? ChillUserPreferences.Empty;
+
+    public string GetDefaultUserCultureName()
+    {
+        var cultureName = GetCurrentUserPreferences().DisplayCultureName;
+        return string.IsNullOrWhiteSpace(cultureName)
+            ? GetPrimaryCultureName()
+            : cultureName;
+    }
+}
+```
+
+Il parametro opzionale del costruttore mantiene compatibile la creazione a design-time e i test che costruiscono direttamente il contesto. Un contesto creato normalmente dalla dependency injection riceve l'accessor.
+
+`ChillAuthDbContext` implementa gia questo schema.
+
+## Hook Del Ciclo Di Vita Delle Entita
+
+Usa lo snapshot direttamente dall'`IChillContext` fornito. Nell'hook non e necessario alcun accesso al database.
+
+```csharp
+public override void OnUpdate(IChillContext context)
+{
+    var preferences = context.GetCurrentUserPreferences();
+    var timeZone = preferences.DisplayTimeZone;
+
+    if (!string.IsNullOrWhiteSpace(timeZone))
+    {
+        // Applica il comportamento relativo al fuso orario dell'applicazione.
+    }
+}
+```
+
+Tutti i valori possono essere vuoti per job in background, chiamate non autenticate o un utente senza un `AuthUser` corrispondente. Considerali opzionali e scegli un fallback dell'applicazione. Valida `DisplayTimeZone` prima di usarlo come identificatore di fuso orario.

package/template/gitignore

@@ -1,6 +1,6 @@
-/dist
-/tmp
-/out-tsc
-/coverage
-/node_modules
-/.angular
+/dist
+/tmp
+/out-tsc
+/coverage
+/node_modules
+/.angular

package/template/package.json

@@ -1,43 +1,43 @@
-{
-  "name": "chill-sharp-ui-template",
-  "version": "1.1.6",
-  "private": true,
-  "description": "Template Angular shell for ChillSharp UI client applications.",
-  "scripts": {
-    "ng": "ng",
-    "start": "ng serve",
-    "build": "ng build",
-    "watch": "ng build --watch --configuration development",
-    "test": "ng test --watch=false",
-    "lint": "tsc --noEmit -p tsconfig.app.json"
-  },
-  "dependencies": {
-    "@angular/cdk": "^19.2.19",
-    "@angular/common": "^19.2.0",
-    "@angular/compiler": "^19.2.0",
-    "@angular/core": "^19.2.0",
-    "@angular/forms": "^19.2.0",
-    "@angular/platform-browser": "^19.2.0",
-    "@angular/platform-browser-dynamic": "^19.2.0",
-    "@angular/router": "^19.2.0",
-    "@chill-sharp/ng-client": "file:packages/chill-sharp-ng-client-1.1.6.tgz",
-    "@chill-sharp/ts-client": "file:packages/chill-sharp-ts-client-1.1.6.tgz",
-    "@chill-sharp/ui-core": "file:packages/chill-sharp-ui-core-1.1.6.tgz",
-    "rxjs": "~7.8.0",
-    "tslib": "^2.3.0",
-    "zone.js": "~0.15.0"
-  },
-  "devDependencies": {
-    "@angular-devkit/build-angular": "^19.2.20",
-    "@angular/cli": "^19.2.20",
-    "@angular/compiler-cli": "^19.2.20",
-    "@types/jasmine": "~5.1.0",
-    "jasmine-core": "~5.6.0",
-    "karma": "~6.4.0",
-    "karma-chrome-launcher": "~3.2.0",
-    "karma-coverage": "~2.2.0",
-    "karma-jasmine": "~5.1.0",
-    "karma-jasmine-html-reporter": "~2.1.0",
-    "typescript": "~5.7.2"
-  }
-}
+{
+  "name": "chill-sharp-ui-template",
+  "version": "1.1.6",
+  "private": true,
+  "description": "Template Angular shell for ChillSharp UI client applications.",
+  "scripts": {
+    "ng": "ng",
+    "start": "ng serve",
+    "build": "ng build",
+    "watch": "ng build --watch --configuration development",
+    "test": "ng test --watch=false",
+    "lint": "tsc --noEmit -p tsconfig.app.json"
+  },
+  "dependencies": {
+    "@angular/cdk": "^19.2.19",
+    "@angular/common": "^19.2.0",
+    "@angular/compiler": "^19.2.0",
+    "@angular/core": "^19.2.0",
+    "@angular/forms": "^19.2.0",
+    "@angular/platform-browser": "^19.2.0",
+    "@angular/platform-browser-dynamic": "^19.2.0",
+    "@angular/router": "^19.2.0",
+    "@chill-sharp/ng-client": "file:packages/chill-sharp-ng-client-1.1.6.tgz",
+    "@chill-sharp/ts-client": "file:packages/chill-sharp-ts-client-1.1.6.tgz",
+    "@chill-sharp/ui-core": "file:packages/chill-sharp-ui-core-1.1.6.tgz",
+    "rxjs": "~7.8.0",
+    "tslib": "^2.3.0",
+    "zone.js": "~0.15.0"
+  },
+  "devDependencies": {
+    "@angular-devkit/build-angular": "^19.2.20",
+    "@angular/cli": "^19.2.20",
+    "@angular/compiler-cli": "^19.2.20",
+    "@types/jasmine": "~5.1.0",
+    "jasmine-core": "~5.6.0",
+    "karma": "~6.4.0",
+    "karma-chrome-launcher": "~3.2.0",
+    "karma-coverage": "~2.2.0",
+    "karma-jasmine": "~5.1.0",
+    "karma-jasmine-html-reporter": "~2.1.0",
+    "typescript": "~5.7.2"
+  }
+}

package/template/public/env.js

@@ -1,15 +1,15 @@
-(function () {
-  const DEBUG_CHILLSHARP_ENV = {
-    uiUrl: 'http://localhost:6202',
-    apiUrl: 'https://localhost:6002/api'
-  };
-
-  function readEnvValue(value, fallback) {
-    return value && !/^\$\{[^}]+\}$/.test(value)
-      ? value
-      : fallback;
-  }
-
-  globalThis.CHILLSHARP_UI_URL = readEnvValue('${CHILLSHARP_UI_URL}', DEBUG_CHILLSHARP_ENV.uiUrl);
-  globalThis.CHILLSHARP_API_URL = readEnvValue('${CHILLSHARP_API_URL}', DEBUG_CHILLSHARP_ENV.apiUrl);
-}());
+(function () {
+  const DEBUG_CHILLSHARP_ENV = {
+    uiUrl: 'http://localhost:6202',
+    apiUrl: 'https://localhost:6002/api'
+  };
+
+  function readEnvValue(value, fallback) {
+    return value && !/^\$\{[^}]+\}$/.test(value)
+      ? value
+      : fallback;
+  }
+
+  globalThis.CHILLSHARP_UI_URL = readEnvValue('${CHILLSHARP_UI_URL}', DEBUG_CHILLSHARP_ENV.uiUrl);
+  globalThis.CHILLSHARP_API_URL = readEnvValue('${CHILLSHARP_API_URL}', DEBUG_CHILLSHARP_ENV.apiUrl);
+}());

package/template/public/runtime-config.js

@@ -1,10 +1,10 @@
-globalThis.__clientUiTemplateRuntimeConfig__ = globalThis.__clientUiTemplateRuntimeConfig__ ?? {
-  tenantCode: 'template-client',
-  featureFlags: {
-    clientHomeEnabled: true
-  }
-};
-
-globalThis.__chillSharpUiRuntimeConfig__ = globalThis.__chillSharpUiRuntimeConfig__ ?? {
-  workspaceTaskSources: []
-};
+globalThis.__clientUiTemplateRuntimeConfig__ = globalThis.__clientUiTemplateRuntimeConfig__ ?? {
+  tenantCode: 'template-client',
+  featureFlags: {
+    clientHomeEnabled: true
+  }
+};
+
+globalThis.__chillSharpUiRuntimeConfig__ = globalThis.__chillSharpUiRuntimeConfig__ ?? {
+  workspaceTaskSources: []
+};

package/template/public/sw.js

@@ -1,8 +1,8 @@
-// Shared cache behavior is upgraded with @chill-sharp/ui-core.
-self.CHILL_SHARP_SW_OPTIONS = {
-  cachePrefix: 'chill-sharp-ui',
-  cacheVersion: 'v2',
-  cacheTimeoutMs: 10 * 60 * 1000,
-  appShell: ['/', '/index.html']
-};
-importScripts('./chill-sharp-service-worker.js');
+// Shared cache behavior is upgraded with @chill-sharp/ui-core.
+self.CHILL_SHARP_SW_OPTIONS = {
+  cachePrefix: 'chill-sharp-ui',
+  cacheVersion: 'v2',
+  cacheTimeoutMs: 10 * 60 * 1000,
+  appShell: ['/', '/index.html']
+};
+importScripts('./chill-sharp-service-worker.js');

package/template/src/app/app.component.spec.ts

@@ -1,15 +1,15 @@
-import { TestBed } from '@angular/core/testing';
-import { AppComponent } from './app.component';
-
-describe('AppComponent', () => {
-  beforeEach(async () => {
-    await TestBed.configureTestingModule({
-      imports: [AppComponent]
-    }).compileComponents();
-  });
-
-  it('creates the shell component', () => {
-    const fixture = TestBed.createComponent(AppComponent);
-    expect(fixture.componentInstance).toBeTruthy();
-  });
-});
+import { TestBed } from '@angular/core/testing';
+import { AppComponent } from './app.component';
+
+describe('AppComponent', () => {
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      imports: [AppComponent]
+    }).compileComponents();
+  });
+
+  it('creates the shell component', () => {
+    const fixture = TestBed.createComponent(AppComponent);
+    expect(fixture.componentInstance).toBeTruthy();
+  });
+});

package/template/src/app/app.component.ts

@@ -1,10 +1,10 @@
-import { Component } from '@angular/core';
-import { ChillSharpUiRootComponent } from '@chill-sharp/ui-core';
-
-@Component({
-  selector: 'app-root',
-  standalone: true,
-  imports: [ChillSharpUiRootComponent],
-  template: '<chill-sharp-ui-root />'
-})
-export class AppComponent {}
+import { Component } from '@angular/core';
+import { ChillSharpUiRootComponent } from '@chill-sharp/ui-core';
+
+@Component({
+  selector: 'app-root',
+  standalone: true,
+  imports: [ChillSharpUiRootComponent],
+  template: '<chill-sharp-ui-root />'
+})
+export class AppComponent {}

package/template/src/app/app.config.ts

@@ -1,22 +1,22 @@
-import { APP_INITIALIZER, ApplicationConfig, provideZoneChangeDetection } from '@angular/core';
-import { provideRouter } from '@angular/router';
-import { provideChillSharpUiCore } from '@chill-sharp/ui-core';
-import { appRoutes } from './app.routes';
-import { CLIENT_APP_CONFIG } from '../config/app-config';
-import { provideClientTemplateProviders } from './core/providers/client-template.providers';
-
-export const appConfig: ApplicationConfig = {
-  providers: [
-    provideZoneChangeDetection({ eventCoalescing: true }),
-    provideRouter(appRoutes),
-    ...provideChillSharpUiCore(),
-    ...provideClientTemplateProviders(),
-    {
-      provide: APP_INITIALIZER,
-      multi: true,
-      useFactory: () => () => {
-        globalThis.document.title = CLIENT_APP_CONFIG.appName;
-      }
-    }
-  ]
-};
+import { APP_INITIALIZER, ApplicationConfig, provideZoneChangeDetection } from '@angular/core';
+import { provideRouter } from '@angular/router';
+import { provideChillSharpUiCore } from '@chill-sharp/ui-core';
+import { appRoutes } from './app.routes';
+import { CLIENT_APP_CONFIG } from '../config/app-config';
+import { provideClientTemplateProviders } from './core/providers/client-template.providers';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideZoneChangeDetection({ eventCoalescing: true }),
+    provideRouter(appRoutes),
+    ...provideChillSharpUiCore(),
+    ...provideClientTemplateProviders(),
+    {
+      provide: APP_INITIALIZER,
+      multi: true,
+      useFactory: () => () => {
+        globalThis.document.title = CLIENT_APP_CONFIG.appName;
+      }
+    }
+  ]
+};

package/template/src/app/app.routes.ts

@@ -1,14 +1,14 @@
-import { Routes } from '@angular/router';
-import { CHILL_SHARP_UI_ROUTES } from '@chill-sharp/ui-core';
-import { getClientFeatureRoutes } from './core/plugins/register-client-plugins';
-
-const coreRoutes = CHILL_SHARP_UI_ROUTES.filter((route) => route.path !== '**');
-
-export const appRoutes: Routes = [
-  ...getClientFeatureRoutes(),
-  ...coreRoutes,
-  {
-    path: '**',
-    redirectTo: 'login'
-  }
-];
+import { Routes } from '@angular/router';
+import { CHILL_SHARP_UI_ROUTES } from '@chill-sharp/ui-core';
+import { getClientFeatureRoutes } from './core/plugins/register-client-plugins';
+
+const coreRoutes = CHILL_SHARP_UI_ROUTES.filter((route) => route.path !== '**');
+
+export const appRoutes: Routes = [
+  ...getClientFeatureRoutes(),
+  ...coreRoutes,
+  {
+    path: '**',
+    redirectTo: 'login'
+  }
+];

package/template/src/app/core/overrides/README.md

@@ -1,12 +1,12 @@
-# Client Overrides
-
-Use this folder for client-specific provider replacements and future override registrations exposed by `@chill-sharp/ui-core`.
-
-Typical examples:
-
-- branded header providers
-- custom page title strategy
-- specialized service implementations
-- feature-flag-driven replacements
-
-`register-client-overrides.ts` returns an empty provider array by default so each client repo can opt into overrides intentionally.
+# Client Overrides
+
+Use this folder for client-specific provider replacements and future override registrations exposed by `@chill-sharp/ui-core`.
+
+Typical examples:
+
+- branded header providers
+- custom page title strategy
+- specialized service implementations
+- feature-flag-driven replacements
+
+`register-client-overrides.ts` returns an empty provider array by default so each client repo can opt into overrides intentionally.

package/template/src/app/core/overrides/register-client-overrides.ts

@@ -1,5 +1,5 @@
-import { Provider } from '@angular/core';
-
-export function getClientOverrideProviders(): Provider[] {
-  return [];
-}
+import { Provider } from '@angular/core';
+
+export function getClientOverrideProviders(): Provider[] {
+  return [];
+}

package/template/src/app/core/plugins/README.md

@@ -1,17 +1,17 @@
-# Client Plugins
-
-Use this folder for client-owned extension registration.
-
-Typical examples:
-
-- client-only routes
-- extra menu integration when the core exposes plugin hooks
-- additional providers required by local features
-
-`register-client-plugins.ts` currently demonstrates the simplest template-owned extension: a client route.
-
-Included examples:
-
-- [`hello-plugin`](hello-plugin/README.md): route plugin that renders `Hello {{name}}` from `hello-plugin/:name`
-
-For plugin README guidance, see [`../../../../../HOW_TO_CREATE_UI_CORE_PLUGIN_README.md`](../../../../../HOW_TO_CREATE_UI_CORE_PLUGIN_README.md).
+# Client Plugins
+
+Use this folder for client-owned extension registration.
+
+Typical examples:
+
+- client-only routes
+- extra menu integration when the core exposes plugin hooks
+- additional providers required by local features
+
+`register-client-plugins.ts` currently demonstrates the simplest template-owned extension: a client route.
+
+Included examples:
+
+- [`hello-plugin`](hello-plugin/README.md): route plugin that renders `Hello {{name}}` from `hello-plugin/:name`
+
+For plugin README guidance, see [`../../../../../HOW_TO_CREATE_UI_CORE_PLUGIN_README.md`](../../../../../HOW_TO_CREATE_UI_CORE_PLUGIN_README.md).

package/template/src/app/core/plugins/hello-plugin/README.md

@@ -1,25 +1,25 @@
-# Hello Plugin
-
-## Purpose
-
-This is a simple template-owned route plugin. It renders:
-
-```text
-Hello {{name}}
-```
-
-where `name` is read from the route parameter.
-
-## Registration
-
-The plugin is registered by `src/app/core/plugins/register-client-plugins.ts` at:
-
-```text
-hello-plugin/:name
-```
-
-Example URL:
-
-```text
-/hello-plugin/Manu
-```
+# Hello Plugin
+
+## Purpose
+
+This is a simple template-owned route plugin. It renders:
+
+```text
+Hello {{name}}
+```
+
+where `name` is read from the route parameter.
+
+## Registration
+
+The plugin is registered by `src/app/core/plugins/register-client-plugins.ts` at:
+
+```text
+hello-plugin/:name
+```
+
+Example URL:
+
+```text
+/hello-plugin/Manu
+```