@chill-sharp/create-app 1.1.12 → 1.1.15

package/template/angular.json

@@ -1,131 +1,131 @@
-{
-  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
-  "version": 1,
-  "newProjectRoot": "projects",
-  "projects": {
-    "chill-sharp-ui-template": {
-      "projectType": "application",
-      "schematics": {
-        "@schematics/angular:component": {
-          "style": "scss"
-        }
-      },
-      "root": "",
-      "sourceRoot": "src",
-      "prefix": "app",
-      "architect": {
-        "build": {
-          "builder": "@angular-devkit/build-angular:application",
-          "options": {
-            "outputPath": "dist/chill-sharp-ui-template",
-            "index": "src/index.html",
-            "browser": "src/main.ts",
-            "polyfills": [
-              "zone.js"
-            ],
-            "tsConfig": "tsconfig.app.json",
-            "inlineStyleLanguage": "scss",
-            "assets": [
-              {
-                "glob": "*.js",
-                "input": "node_modules/@chill-sharp/ui-core/service-worker",
-                "output": "/"
-              },
-              {
-                "glob": "**/*",
-                "input": "public"
-              },
-              {
-                "glob": "**/*",
-                "input": "src/assets",
-                "output": "assets"
-              }
-            ],
-            "styles": [
-              "src/styles.scss"
-            ],
-            "scripts": []
-          },
-          "configurations": {
-            "production": {
-              "fileReplacements": [
-                {
-                  "replace": "src/environments/environment.ts",
-                  "with": "src/environments/environment.prod.ts"
-                }
-              ],
-              "budgets": [
-                {
-                  "type": "initial",
-                  "maximumWarning": "500kB",
-                  "maximumError": "1.5MB"
-                },
-                {
-                  "type": "anyComponentStyle",
-                  "maximumWarning": "14kB",
-                  "maximumError": "20kB"
-                }
-              ],
-              "outputHashing": "all"
-            },
-            "development": {
-              "optimization": false,
-              "extractLicenses": false,
-              "sourceMap": true
-            }
-          },
-          "defaultConfiguration": "production"
-        },
-        "serve": {
-          "builder": "@angular-devkit/build-angular:dev-server",
-          "options": {
-            "port": 6202
-          },
-          "configurations": {
-            "production": {
-              "buildTarget": "chill-sharp-ui-template:build:production"
-            },
-            "development": {
-              "buildTarget": "chill-sharp-ui-template:build:development"
-            }
-          },
-          "defaultConfiguration": "development"
-        },
-        "extract-i18n": {
-          "builder": "@angular-devkit/build-angular:extract-i18n"
-        },
-        "test": {
-          "builder": "@angular-devkit/build-angular:karma",
-          "options": {
-            "polyfills": [
-              "zone.js",
-              "zone.js/testing"
-            ],
-            "tsConfig": "tsconfig.spec.json",
-            "inlineStyleLanguage": "scss",
-            "assets": [
-              {
-                "glob": "*.js",
-                "input": "node_modules/@chill-sharp/ui-core/service-worker",
-                "output": "/"
-              },
-              {
-                "glob": "**/*",
-                "input": "public"
-              },
-              {
-                "glob": "**/*",
-                "input": "src/assets",
-                "output": "assets"
-              }
-            ],
-            "styles": [
-              "src/styles.scss"
-            ],
-            "scripts": []
-          }
-        }
-      }
-    }
-  }
-}
+{
+  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
+  "version": 1,
+  "newProjectRoot": "projects",
+  "projects": {
+    "chill-sharp-ui-template": {
+      "projectType": "application",
+      "schematics": {
+        "@schematics/angular:component": {
+          "style": "scss"
+        }
+      },
+      "root": "",
+      "sourceRoot": "src",
+      "prefix": "app",
+      "architect": {
+        "build": {
+          "builder": "@angular-devkit/build-angular:application",
+          "options": {
+            "outputPath": "dist/chill-sharp-ui-template",
+            "index": "src/index.html",
+            "browser": "src/main.ts",
+            "polyfills": [
+              "zone.js"
+            ],
+            "tsConfig": "tsconfig.app.json",
+            "inlineStyleLanguage": "scss",
+            "assets": [
+              {
+                "glob": "*.js",
+                "input": "node_modules/@chill-sharp/ui-core/service-worker",
+                "output": "/"
+              },
+              {
+                "glob": "**/*",
+                "input": "public"
+              },
+              {
+                "glob": "**/*",
+                "input": "src/assets",
+                "output": "assets"
+              }
+            ],
+            "styles": [
+              "src/styles.scss"
+            ],
+            "scripts": []
+          },
+          "configurations": {
+            "production": {
+              "fileReplacements": [
+                {
+                  "replace": "src/environments/environment.ts",
+                  "with": "src/environments/environment.prod.ts"
+                }
+              ],
+              "budgets": [
+                {
+                  "type": "initial",
+                  "maximumWarning": "500kB",
+                  "maximumError": "1.5MB"
+                },
+                {
+                  "type": "anyComponentStyle",
+                  "maximumWarning": "14kB",
+                  "maximumError": "20kB"
+                }
+              ],
+              "outputHashing": "all"
+            },
+            "development": {
+              "optimization": false,
+              "extractLicenses": false,
+              "sourceMap": true
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "serve": {
+          "builder": "@angular-devkit/build-angular:dev-server",
+          "options": {
+            "port": 6202
+          },
+          "configurations": {
+            "production": {
+              "buildTarget": "chill-sharp-ui-template:build:production"
+            },
+            "development": {
+              "buildTarget": "chill-sharp-ui-template:build:development"
+            }
+          },
+          "defaultConfiguration": "development"
+        },
+        "extract-i18n": {
+          "builder": "@angular-devkit/build-angular:extract-i18n"
+        },
+        "test": {
+          "builder": "@angular-devkit/build-angular:karma",
+          "options": {
+            "polyfills": [
+              "zone.js",
+              "zone.js/testing"
+            ],
+            "tsConfig": "tsconfig.spec.json",
+            "inlineStyleLanguage": "scss",
+            "assets": [
+              {
+                "glob": "*.js",
+                "input": "node_modules/@chill-sharp/ui-core/service-worker",
+                "output": "/"
+              },
+              {
+                "glob": "**/*",
+                "input": "public"
+              },
+              {
+                "glob": "**/*",
+                "input": "src/assets",
+                "output": "assets"
+              }
+            ],
+            "styles": [
+              "src/styles.scss"
+            ],
+            "scripts": []
+          }
+        }
+      }
+    }
+  }
+}

package/template/doc/CurrentUserPreferences.md

@@ -1,106 +1,106 @@
-# Current User Preferences
-
-Versione italiana: [Italiano](./it/CurrentUserPreferences.md)
-
-`ChillSharp.Auth` can make the authenticated user's display preferences available to entity lifecycle hooks without querying `AuthUser` during every save.
-
-The immutable `ChillUserPreferences` snapshot contains:
-
-- `DisplayCultureName`
-- `DisplayTimeZone`
-- `DisplayDateFormat`
-- `DisplayNumberFormat`
-- `PreferredTheme`
-
-## Registration And Cache Lifecycle
-
-`AddChillAuthApi<TContext>()` registers a singleton `IChillAuthUserPreferencesCache` and scoped `IChillAuthUserPreferencesAccessor`.
-
-When the user logs in or refreshes a token, ChillSharp loads the matching `AuthUser` once and warms a snapshot keyed by its `ExternalId`. The accessor only reads that in-memory snapshot during requests; it does not query the user table.
-
-`ChillAuthService` refreshes the cached snapshot after creating or updating an `AuthUser`. It invalidates a deleted user's snapshot and both the previous and new keys when `ExternalId` changes.
-
-The cache stores scalar preference values, never a tracked EF Core `AuthUser` instance.
-
-## Current User Preferences API
-
-Authenticated clients can retrieve the same snapshot used by server-side code with:
-
-```http
-GET /api/chill-auth/current-user-preferences
-Authorization: Bearer <access token>
-```
-
-The response is a `ChillUserPreferences` JSON object:
-
-```json
-{
-  "displayCultureName": "it-IT",
-  "displayTimeZone": "Europe/Rome",
-  "displayDateFormat": "dd/MM/yyyy",
-  "displayNumberFormat": "N2",
-  "preferredTheme": "cini"
-}
-```
-
-Use this endpoint after login and when restoring an authenticated UI session. It is the source of truth for the language/culture, time zone, date format, and number format used by the API client and UI; do not derive those values from the browser, operating system, token claims, or an auth-management endpoint.
-
-The C# client exposes `GetCurrentUserPreferences()`. The Python client exposes `get_current_user_preferences()`, while the TypeScript client and Angular wrapper expose `getCurrentUserPreferences()`. The Vue and React packages additionally provide `useCurrentUserPreferences()`.
-
-In the Angular UI Core package, inject `ChillService` and consume its `userPreferences` signal or the individual `displayCultureName`, `displayTimeZone`, `displayDateFormat`, `displayNumberFormat`, and `preferredTheme` projections. `PreferredTheme` is an opaque server-stored string. UI Core uses browser `prefers-color-scheme` light/dark before login; client apps add selectable themes with `provideChillSharpUiCore({ additionalThemes: ['cini'] })`.
-
-## Host DbContext
-
-`IChillContext.GetCurrentUserPreferences()` returns `ChillUserPreferences.Empty` by default. In an auth-enabled custom host context, inject `IChillAuthUserPreferencesAccessor` and delegate to it:
-
-```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;
-    }
-}
-```
-
-The optional constructor parameter keeps design-time creation and tests that construct the context directly compatible. A normal dependency-injection-created context receives the accessor.
-
-`ChillAuthDbContext` already implements this pattern.
-
-## Entity Lifecycle Hooks
-
-Use the snapshot directly from the supplied `IChillContext`. No database access is required in the hook.
-
-```csharp
-public override void OnUpdate(IChillContext context)
-{
-    var preferences = context.GetCurrentUserPreferences();
-    var timeZone = preferences.DisplayTimeZone;
-
-    if (!string.IsNullOrWhiteSpace(timeZone))
-    {
-        // Apply application-specific time-zone behavior.
-    }
-}
-```
-
-All values can be empty for background jobs, unauthenticated calls, or a user without a matching `AuthUser`. Treat them as optional and choose an application fallback. Validate `DisplayTimeZone` before using it as a time-zone identifier.
+# Current User Preferences
+
+Versione italiana: [Italiano](./it/CurrentUserPreferences.md)
+
+`ChillSharp.Auth` can make the authenticated user's display preferences available to entity lifecycle hooks without querying `AuthUser` during every save.
+
+The immutable `ChillUserPreferences` snapshot contains:
+
+- `DisplayCultureName`
+- `DisplayTimeZone`
+- `DisplayDateFormat`
+- `DisplayNumberFormat`
+- `PreferredTheme`
+
+## Registration And Cache Lifecycle
+
+`AddChillAuthApi<TContext>()` registers a singleton `IChillAuthUserPreferencesCache` and scoped `IChillAuthUserPreferencesAccessor`.
+
+When the user logs in or refreshes a token, ChillSharp loads the matching `AuthUser` once and warms a snapshot keyed by its `ExternalId`. The accessor only reads that in-memory snapshot during requests; it does not query the user table.
+
+`ChillAuthService` refreshes the cached snapshot after creating or updating an `AuthUser`. It invalidates a deleted user's snapshot and both the previous and new keys when `ExternalId` changes.
+
+The cache stores scalar preference values, never a tracked EF Core `AuthUser` instance.
+
+## Current User Preferences API
+
+Authenticated clients can retrieve the same snapshot used by server-side code with:
+
+```http
+GET /api/chill-auth/current-user-preferences
+Authorization: Bearer <access token>
+```
+
+The response is a `ChillUserPreferences` JSON object:
+
+```json
+{
+  "displayCultureName": "it-IT",
+  "displayTimeZone": "Europe/Rome",
+  "displayDateFormat": "dd/MM/yyyy",
+  "displayNumberFormat": "N2",
+  "preferredTheme": "cini"
+}
+```
+
+Use this endpoint after login and when restoring an authenticated UI session. It is the source of truth for the language/culture, time zone, date format, and number format used by the API client and UI; do not derive those values from the browser, operating system, token claims, or an auth-management endpoint.
+
+The C# client exposes `GetCurrentUserPreferences()`. The Python client exposes `get_current_user_preferences()`, while the TypeScript client and Angular wrapper expose `getCurrentUserPreferences()`. The Vue and React packages additionally provide `useCurrentUserPreferences()`.
+
+In the Angular UI Core package, inject `ChillService` and consume its `userPreferences` signal or the individual `displayCultureName`, `displayTimeZone`, `displayDateFormat`, `displayNumberFormat`, and `preferredTheme` projections. `PreferredTheme` is an opaque server-stored string. UI Core uses browser `prefers-color-scheme` light/dark before login; client apps add selectable themes with `provideChillSharpUiCore({ additionalThemes: ['cini'] })`.
+
+## Host DbContext
+
+`IChillContext.GetCurrentUserPreferences()` returns `ChillUserPreferences.Empty` by default. In an auth-enabled custom host context, inject `IChillAuthUserPreferencesAccessor` and delegate to it:
+
+```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;
+    }
+}
+```
+
+The optional constructor parameter keeps design-time creation and tests that construct the context directly compatible. A normal dependency-injection-created context receives the accessor.
+
+`ChillAuthDbContext` already implements this pattern.
+
+## Entity Lifecycle Hooks
+
+Use the snapshot directly from the supplied `IChillContext`. No database access is required in the hook.
+
+```csharp
+public override void OnUpdate(IChillContext context)
+{
+    var preferences = context.GetCurrentUserPreferences();
+    var timeZone = preferences.DisplayTimeZone;
+
+    if (!string.IsNullOrWhiteSpace(timeZone))
+    {
+        // Apply application-specific time-zone behavior.
+    }
+}
+```
+
+All values can be empty for background jobs, unauthenticated calls, or a user without a matching `AuthUser`. Treat them as optional and choose an application fallback. Validate `DisplayTimeZone` before using it as a time-zone identifier.