ngx-theme-stack 3.5.1 → 3.5.2

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 (2) hide show
  1. package/README.md +11 -3
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -25,7 +25,7 @@ Built for performance and SSR support.
25
25
  - [📦 Installation](#-installation)
26
26
  - [🤖 What does `ng add` do for you?](#-what-does-ng-add-do-for-you)
27
27
  - [🏗️ Architecture & Extensibility](#️-architecture--extensibility)
28
- - [⚙️ Supported Versions](#️-supported-versions)
28
+ - [📐 Supported Versions](#-supported-versions)
29
29
  - [⚙️ Configuration](#️-configuration)
30
30
  - [🛠️ Usage](#️-usage)
31
31
  - [🛡️ CoreThemeService API](#️-advanced-corethemeservice-api)
@@ -125,7 +125,7 @@ The **`CoreThemeService`** is the foundation — it manages state (Signals), per
125
125
 
126
126
  ---
127
127
 
128
- ## ⚙️ Supported Versions
128
+ ## 📐 Supported Versions
129
129
 
130
130
  | Angular Version | Status |
131
131
  | --------------- | --------- |
@@ -267,6 +267,14 @@ export class MyAdvancedComponent {
267
267
  > ```typescript
268
268
  > const isSunset = computed(() => themeService.resolvedTheme() === 'sunset');
269
269
  > ```
270
+ >
271
+ > Use `isHydrated()` to guard conditional content (icons, images) against SSR hydration mismatches:
272
+ >
273
+ > ```html
274
+ > @if (theme.isHydrated()) {
275
+ > <img [src]="theme.isDark() ? 'dark-logo.png' : 'light-logo.png'">
276
+ > }
277
+ > ```
270
278
 
271
279
  ---
272
280
 
@@ -360,7 +368,7 @@ Only needed if you want `dark:` utilities tied to ngx-theme-stack's toggle:
360
368
  | **Network requests** | Zero | One (then cached) |
361
369
  | **Flash risk** | None | None |
362
370
  | **Works with CSR** | ✅ | ✅ |
363
- | **Works with SSR/SSG** | ✅ | |
371
+ | **Works with SSR/SSG** | ✅ | ⚠️ May flash on SSG |
364
372
  | **Strict CSP compatible** | ❌ requires `unsafe-inline` | ✅ |
365
373
  | **Best for** | Most apps | Strict CSP, many themes |
366
374
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ngx-theme-stack",
3
- "version": "3.5.1",
3
+ "version": "3.5.2",
4
4
  "description": "A stack of themes for Angular applications.",
5
5
  "keywords": [
6
6
  "angular",