npm - ngx-theme-stack - Versions diffs - 1.0.0 → 2.0.0 - Mend

ngx-theme-stack 1.0.0 → 2.0.0

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 (27) hide show

package/README.md +39 -22
package/fesm2022/ngx-theme-stack.mjs +203 -39
package/fesm2022/ngx-theme-stack.mjs.map +1 -1
package/package.json +1 -1
package/schematics/collection.json +6 -1
package/schematics/ng-add/anti-flash.d.ts +24 -0
package/schematics/ng-add/anti-flash.js +98 -0
package/schematics/ng-add/anti-flash.js.map +1 -0
package/schematics/ng-add/app-config.d.ts +3 -3
package/schematics/ng-add/app-config.js +4 -4
package/schematics/ng-add/app-config.js.map +1 -1
package/schematics/ng-add/constants.d.ts +4 -5
package/schematics/ng-add/constants.js +4 -5
package/schematics/ng-add/constants.js.map +1 -1
package/schematics/ng-add/index.js +35 -12
package/schematics/ng-add/index.js.map +1 -1
package/schematics/ng-add/utils.d.ts +1 -1
package/schematics/ng-add/utils.js +6 -6
package/schematics/ng-add/utils.js.map +1 -1
package/schematics/sync/index.d.ts +12 -0
package/schematics/sync/index.js +153 -0
package/schematics/sync/index.js.map +1 -0
package/schematics/sync/schema.d.ts +4 -0
package/schematics/sync/schema.js +3 -0
package/schematics/sync/schema.js.map +1 -0
package/schematics/sync/schema.json +16 -0
package/types/ngx-theme-stack.d.ts +168 -33

package/README.md CHANGED Viewed

@@ -1,6 +1,8 @@
 # ngx-theme-stack 🎨
-A complete and lightweight solution for managing themes (light, dark, system, and custom) in **Angular** applications. Built with performance, accessibility, and SSR (Server-Side Rendering) support in mind.
+![ngx-theme-stack banner](./banner.png)
+A simple and powerful headless theme manager for **Angular**. Built for performance and SSR support.
 ## 🚀 Features
@@ -10,6 +12,7 @@ A complete and lightweight solution for managing themes (light, dark, system, an
 - 🛠️ **Highly Customizable**: Support for custom themes, class prefixes, and configurable storage.
 - 🧱 **Modern Architecture**: Powered by Angular Signals for maximum reactivity and performance.
 - 🌍 **SSR Ready**: Safe to use in Server-Side Rendering environments.
+- 🚫 **Zero Flicker**: Includes an optimized anti-flash script to prevent theme jumps on load.
 ## 📦 Installation
@@ -23,7 +26,7 @@ ng add ngx-theme-stack
 When running `ng add`, you will be presented with two configuration options:
-1.  **Quick Mode**:
+1.  **Quick Mode**:
     - Applies default configuration instantly.
     - Initial theme: `system`.
     - Apply mode: `class` (adds the theme class to the `<html>` element).
@@ -39,10 +42,11 @@ When running `ng add`, you will be presented with two configuration options:
 The library is designed to be flexible. The **`CoreThemeService`** is the foundation:
--   **Solid Base:** Manages state (`Signal`), persistence (`localStorage`), system detection (`matchMedia`), and safe DOM manipulation (SSR compatible).
--   **Extensibility:** You can inject `CoreThemeService` to build your own custom services or components with specific business logic.
+- **Solid Base:** Manages state (`Signal`), persistence (`localStorage`), system detection (`matchMedia`), and safe DOM manipulation (SSR compatible).
+- **Extensibility:** You can inject `CoreThemeService` to build your own custom services or components with specific business logic.
 ### Utility Services (Ready to Use)
 For common use cases, we include three services with predefined logic:
 1.  **`ThemeToggleService`**: A simple binary switch between `light` and `dark`.
@@ -53,18 +57,18 @@ For common use cases, we include three services with predefined logic:
 ## ⚙️ Supported Versions
-| Angular Version | Support |
-| :--- | :--- |
-| **Angular 21** | ✅ Stable |
-| **Angular 20** | ✅ Stable |
-| **Angular 19** | ✅ Stable |
-| **Angular 18** | ✅ Stable |
+| Angular Version | Support   |
+| :-------------- | :-------- |
+| **Angular 21**  | ✅ Stable |
+| **Angular 20**  | ✅ Stable |
+| **Angular 19**  | ✅ Stable |
+| **Angular 18**  | ✅ Stable |
 ## 🛠️ Basic Usage
-### CoreThemeService
+### CoreThemeService API
-This is the main service managing the theme state.
+The foundational service managing the theme state. It exposes pure Angular Signals and a solid minimal API.
 ```typescript
 import { inject } from '@angular/core';
@@ -72,14 +76,29 @@ import { CoreThemeService } from 'ngx-theme-stack';
 @Component({ ... })
 export class MyComponent {
-  private themeService = inject(CoreThemeService);
+  themeService = inject(CoreThemeService);
+  /* --- 📊 Reactive Signals --- */
+  // The exact theme chosen by the user ('dark', 'light', 'system', etc.)
+  selectedTheme = this.themeService.selectedTheme;
+  // The theme finally applied to the DOM (resolves 'system' to 'dark' or 'light')
+  resolvedTheme = this.themeService.resolvedTheme;
+  // Helper boolean signals evaluating the applied theme
+  isDark = this.themeService.isDark;
+  isLight = this.themeService.isLight;
+  isSystem = this.themeService.isSystem;
+  // True after the first browser render. Great for preventing SSR flickering!
+  isHydrated = this.themeService.isHydrated;
-  // Reactive signals
-  isDark = this.themeService.isDark; // boolean (true/false)
-  selectedTheme = this.themeService.selectedTheme; // 'light' | 'dark' | 'system' | ...
+  /* --- 🛠️ Methods --- */
-  changeTheme(theme: string) {
-    this.themeService.setTheme(theme);
+  changeTheme(newTheme: string) {
+    // Validates, applies to the DOM, and saves to localStorage
+    this.themeService.setTheme(newTheme);
   }
 }
 ```
@@ -94,10 +113,8 @@ import { ThemeToggleService } from 'ngx-theme-stack';
 @Component({
   selector: 'app-theme-toggle',
   template: `
-    <button (click)="toggle.toggle()">
-      Switch to {{ toggle.isDark() ? 'Light' : 'Dark' }}
-    </button>
-  `
+    <button (click)="toggle.toggle()">Switch to {{ toggle.isDark() ? 'Light' : 'Dark' }}</button>
+  `,
 })
 export class ThemeToggleComponent {
   protected toggle = inject(ThemeToggleService);

package/fesm2022/ngx-theme-stack.mjs CHANGED Viewed

@@ -1,37 +1,129 @@
 import { isPlatformBrowser } from '@angular/common';
 import * as i0 from '@angular/core';
-import { InjectionToken, inject, DestroyRef, DOCUMENT, PLATFORM_ID, signal, computed, effect, Injectable } from '@angular/core';
+import { InjectionToken, inject, DestroyRef, DOCUMENT, PLATFORM_ID, signal, computed, effect, afterNextRender, Injectable } from '@angular/core';
-/** Built-in themes. All other values are considered custom themes. */
+/**
+ * Base error class for `ngx-theme-stack`.
+ *
+ * Thrown when the library configuration is invalid.
+ * Consumers can use `instanceof NgxThemeStackError` to catch only
+ * errors originating from this library.
+ *
+ * @example
+ * try {
+ *   bootstrapApplication(AppComponent, appConfig);
+ * } catch (e) {
+ *   if (e instanceof NgxThemeStackError) {
+ *     console.error('Bad ngx-theme-stack config:', e.message);
+ *   }
+ * }
+ */
+class NgxThemeStackError extends Error {
+    name = 'NgxThemeStackError';
+    constructor(message) {
+        super(`[ngx-theme-stack] ${message}`);
+        // Restore prototype chain (required when targeting ES5 or older)
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Runtime list of built-in themes.
+ *
+ * Lives here (and not in config/index.ts) because it defines a type:
+ * config/index.ts already imports from types.ts, so placing DEFAULT_THEMES
+ * here avoids any circular dependency.
+ *
+ * ⚠ KEEP IN SYNC with the duplicate in:
+ * projects/ngx-theme-stack/schematics/ng-add/constants.ts → DEFAULT_THEMES
+ *
+ * Schematics compile to CommonJS and cannot import from this ESM file,
+ * so the values are intentionally duplicated. Change both at the same time.
+ */
 const DEFAULT_THEMES = ['system', 'light', 'dark'];
 /**
  * ⚠ ATTENTION: SHARED CONFIGURATION VALUES
  *
- * These values MUST match the schematic defaults in:
- * projects/ngx-theme-stack/schematics/ng-add/index.ts
+ * These defaults MUST match the schematic defaults in:
+ * projects/ngx-theme-stack/schematics/ng-add/constants.ts → DEFAULTS
  *
- * If you change any of these, you MUST also update the schematic's DEFAULTS
- * constant so 'ng add' continues to provide correct hints and clean code.
+ * Schematics compile to CommonJS and cannot import from this ESM file,
+ * so the values are intentionally duplicated. Change both at the same time.
+ *
+ * If you change defaults here, also update:
+ * schematics/ng-add/constants.ts → DEFAULTS + DEFAULT_THEMES
  */
 const DEFAULT_NG_CONFIG = {
-    theme: 'system',
+    defaultTheme: 'system',
     storageKey: 'ngx-theme-stack-theme',
     mode: 'class',
     themes: [...DEFAULT_THEMES],
 };
+// The token uses NgConfig<string> because Angular DI resolves types at runtime
+// and cannot carry generic parameters. Type-safety is enforced at the
+// provideThemeStack() call site instead.
 const NGX_THEME_STACK_CONFIG = new InjectionToken('NGX_THEME_STACK_CONFIG', {
     factory: () => DEFAULT_NG_CONFIG,
 });
 /**
- * Helper function to provide Theme Stack configuration.
+ * Provides Theme Stack configuration to Angular's DI system.
+ *
+ * Custom `themes` are **merged** with the built-in defaults
+ * (`'light'`, `'dark'`, `'system'`), so you never lose the base themes.
+ *
+ * The type parameter `T` is **inferred automatically** from the `themes` array
+ * when passed as a `const` — no need to specify it manually.
+ *
+ * @typeParam T - Custom theme string literals, inferred from the `themes` option.
+ *
+ * @param config - Optional partial configuration. Omitted fields fall back to
+ *   {@link DEFAULT_NG_CONFIG}.
+ *
+ * @throws {@link NgxThemeStackError}
+ *   - If any entry in `themes` is an empty or whitespace-only string.
+ *   - If `defaultTheme` is not present in the resolved (merged) themes array.
+ *   - If `storageKey` is an empty or whitespace-only string.
+ *
+ * @example
+ * // Default — uses built-in themes and sensible defaults
+ * provideThemeStack()
+ *
+ * @example
+ * // Closed union: TypeScript infers 'sepia' | 'ocean' from the array
+ * provideThemeStack({
+ *   themes: ['sepia', 'ocean'] as const,
+ *   defaultTheme: 'sepia',   // ✅ in resolved themes
+ *   // defaultTheme: 'nope', // ❌ throws NgxThemeStackError at runtime
+ * })
+ *
+ * @example
+ * // Custom storage key and mode
+ * provideThemeStack({
+ *   storageKey: 'my-app-theme',
+ *   mode: 'class',
+ * })
  */
 function provideThemeStack(config = {}) {
+    config.themes?.forEach((t) => {
+        if (t.trim() === '')
+            throw new NgxThemeStackError('Theme cannot be empty or whitespace.');
+    });
+    const themes = config.themes
+        ? Array.from(new Set([...DEFAULT_NG_CONFIG.themes, ...config.themes]))
+        : DEFAULT_NG_CONFIG.themes;
+    if (config.defaultTheme && !themes.includes(config.defaultTheme)) {
+        throw new NgxThemeStackError(`"defaultTheme" must be one of the resolved themes: [${themes.join(', ')}].`);
+    }
+    if (config.storageKey !== undefined && config.storageKey.trim() === '') {
+        throw new NgxThemeStackError('"storageKey" cannot be empty or whitespace.');
+    }
     return {
         provide: NGX_THEME_STACK_CONFIG,
         useValue: {
             ...DEFAULT_NG_CONFIG,
             ...config,
+            themes,
         },
     };
 }
@@ -49,10 +141,17 @@ class CoreThemeService {
     #document = inject(DOCUMENT);
     #isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
     // ── Theme configuration ───────────────────────────────────────────────────
-    /** List of available themes for Select/Cycle services. Defaults to ['light', 'dark', 'system']. */
+    /**
+     * The initial stored theme read from localStorage.
+     * This is used to determine the initial theme of the application.
+     */
+    #initialStoredTheme = this.readStoredTheme();
+    /** List of available themes for Select/Cycle services. Defaults to ['system', 'light', 'dark']. */
     availableThemes = this.#config.themes;
     /** Internal Set for O(1) existence checks. */
     #validThemes = new Set(this.availableThemes);
+    /** The anti-flash class to remove from the host element. */
+    #antiFlashClass = null;
     // ── System preference ─────────────────────────────────────────────────────
     /** MediaQueryList for OS color scheme, created once and reused. Null in SSR. */
     #mediaQuery = this.#isBrowser
@@ -64,22 +163,44 @@ class CoreThemeService {
     /** The theme explicitly selected by the user. May be `'system'`. */
     selectedTheme = this.#selectedTheme.asReadonly();
     /** Resolved theme applied to the DOM. Always `'dark'` or `'light'` (or custom) — never `'system'`. */
-    userTheme = computed(() => {
+    resolvedTheme = computed(() => {
         const theme = this.#selectedTheme();
         return theme === 'system' ? this.#systemPreference() : theme;
-    }, ...(ngDevMode ? [{ debugName: "userTheme" }] : /* istanbul ignore next */ []));
+    }, ...(ngDevMode ? [{ debugName: "resolvedTheme" }] : /* istanbul ignore next */ []));
     /** Whether the currently applied theme is dark. */
-    isDark = computed(() => this.userTheme() === 'dark', ...(ngDevMode ? [{ debugName: "isDark" }] : /* istanbul ignore next */ []));
+    isDark = computed(() => this.resolvedTheme() === 'dark', ...(ngDevMode ? [{ debugName: "isDark" }] : /* istanbul ignore next */ []));
     /** Whether the currently applied theme is light. */
-    isLight = computed(() => this.userTheme() === 'light', ...(ngDevMode ? [{ debugName: "isLight" }] : /* istanbul ignore next */ []));
+    isLight = computed(() => this.resolvedTheme() === 'light', ...(ngDevMode ? [{ debugName: "isLight" }] : /* istanbul ignore next */ []));
+    /** Whether the currently applied theme is system. */
+    isSystem = computed(() => this.selectedTheme() === 'system', ...(ngDevMode ? [{ debugName: "isSystem" }] : /* istanbul ignore next */ []));
+    /**
+     * Whether the service has completed client-side initialization.
+     *
+     * `false` during SSR and on the very first render pass. Becomes `true`
+     * immediately after the first browser render, once the real persisted theme
+     * has been read from `localStorage`.
+     *
+     * Use this to guard any template logic that depends on `selectedTheme` or
+     * `resolvedTheme` to avoid an SSR hydration-mismatch flash: the server
+     * renders the default (`'system'`) while the browser may have a different
+     * value stored.
+     *
+     * @example
+     * ```html
+     * {{ themeService.isHydrated() ? selectedTheme() : '—' }}
+     * ```
+     */
+    isHydrated = signal(false, ...(ngDevMode ? [{ debugName: "isHydrated" }] : /* istanbul ignore next */ []));
     // ── Event handler ─────────────────────────────────────────────────────────
     #onSystemPreferenceChange = () => this.#systemPreference.set(this.resolveSystemPreference());
     // ── Lifecycle ─────────────────────────────────────────────────────────────
     constructor() {
+        this.captureAntiFlashClass();
         if (this.#isBrowser && this.#selectedTheme() === 'system') {
             this.startSystemThemeListener();
         }
-        effect(() => this.applyThemeToDOM(this.userTheme()));
+        effect(() => this.applyThemeToDOM(this.resolvedTheme()));
+        afterNextRender(() => this.isHydrated.set(true));
         this.#destroyRef.onDestroy(() => this.stopSystemThemeListener());
     }
     // ── Public API ────────────────────────────────────────────────────────────
@@ -87,18 +208,20 @@ class CoreThemeService {
      * Changes the active theme.
      *
      * Persists the choice explicitly so that switching e.g. from `'system'` to
-     * `'light'` is saved even when the resolved `userTheme` did not change
+     * `'light'` is saved even when the resolved theme did not change
      * (system preference was already `'light'`).
      *
      * @param theme - The theme to apply: `'dark'`, `'light'`, `'system'`, or a custom theme name.
      * @throws If `theme` is not a valid theme according to library configuration.
      */
     setTheme(theme) {
-        if (!this.#isBrowser)
-            return;
         if (!this.#validThemes.has(theme)) {
-            throw new Error(`[ngx-theme-stack] Invalid theme: "${theme}". Valid values are: ${[...this.#validThemes].join(', ')}.`);
+            throw new NgxThemeStackError(`Invalid theme: "${theme}". Valid values are: ${[...this.#validThemes].join(', ')}.`);
         }
+        if (!this.#isBrowser)
+            return;
+        if (theme === this.#selectedTheme())
+            return;
         if (theme === 'system') {
             this.#systemPreference.set(this.resolveSystemPreference());
             this.startSystemThemeListener();
@@ -114,9 +237,11 @@ class CoreThemeService {
         return this.#mediaQuery?.matches ? 'dark' : 'light';
     }
     resolveInitialTheme() {
-        if (!this.#isBrowser)
-            return this.#config.theme;
-        return this.readStoredTheme() ?? this.#config.theme;
+        const theme = this.#initialStoredTheme;
+        if (theme && this.#validThemes.has(theme)) {
+            return theme;
+        }
+        return this.#config.defaultTheme;
     }
     startSystemThemeListener() {
         if (!this.#mediaQuery)
@@ -127,26 +252,28 @@ class CoreThemeService {
     stopSystemThemeListener() {
         this.#mediaQuery?.removeEventListener('change', this.#onSystemPreferenceChange);
     }
-    applyThemeToDOM(userTheme) {
+    applyThemeToDOM(theme) {
         if (!this.#isBrowser)
             return;
         const host = this.#document.documentElement;
+        if (this.#antiFlashClass) {
+            host.classList.remove(this.#antiFlashClass);
+            this.#antiFlashClass = null;
+        }
         const { mode } = this.#config;
         if (mode === 'attribute' || mode === 'both') {
-            this.applyThemeAttribute(host, userTheme);
+            this.applyThemeAttribute(host, theme);
         }
         if (mode === 'class' || mode === 'both') {
-            this.applyThemeClasses(host, userTheme);
+            this.applyThemeClasses(host, theme);
         }
-        this.applyColorSchemeHint(host, userTheme);
+        this.applyColorSchemeHint(host, theme);
     }
     applyThemeAttribute(host, theme) {
         host.setAttribute('data-theme', theme);
     }
     applyThemeClasses(host, theme) {
-        for (const t of this.availableThemes) {
-            host.classList.remove(t);
-        }
+        host.classList.remove(...this.availableThemes);
         host.classList.add(theme);
     }
     applyColorSchemeHint(host, theme) {
@@ -156,13 +283,24 @@ class CoreThemeService {
         }
         host.style.removeProperty('color-scheme');
     }
+    captureAntiFlashClass() {
+        if (!this.#isBrowser || !this.#initialStoredTheme)
+            return;
+        if (!/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(this.#initialStoredTheme)) {
+            this.#antiFlashClass = null;
+            return;
+        }
+        if (this.#initialStoredTheme === 'system') {
+            this.#antiFlashClass = this.resolveSystemPreference();
+            return;
+        }
+        this.#antiFlashClass = this.#initialStoredTheme;
+    }
     readStoredTheme() {
-        try {
-            const stored = localStorage.getItem(this.#config.storageKey);
-            if (stored && this.#validThemes.has(stored)) {
-                return stored;
-            }
+        if (!this.#isBrowser)
             return null;
+        try {
+            return localStorage.getItem(this.#config.storageKey);
         }
         catch (e) {
             console.warn('[ngx-theme-stack] Could not read theme from localStorage.', e);
@@ -170,6 +308,8 @@ class CoreThemeService {
         }
     }
     saveTheme(theme) {
+        if (!this.#isBrowser)
+            return;
         try {
             localStorage.setItem(this.#config.storageKey, theme);
         }
@@ -188,7 +328,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.7", ngImpor
 /**
  * Convenience service for cycling through themes in a fixed order.
  *
- * Default cycle: `'light'` → `'dark'` → `'system'` → `'light'` → ...
+ * Default cycle: `'system'` → `'light'` → `'dark'` → `'system'` → ...
  *
  * Use this when you want to offer users a single button that rotates
  * through all available theme options.
@@ -200,11 +340,18 @@ class ThemeCycleService {
     /** The theme explicitly selected by the user. May be `'system'`. */
     selectedTheme = this.#core.selectedTheme;
     /** Resolved theme applied to the DOM. Always concrete — never `'system'`. */
-    userTheme = this.#core.userTheme;
+    resolvedTheme = this.#core.resolvedTheme;
     /** Whether the currently applied theme is dark. */
     isDark = this.#core.isDark;
     /** Whether the currently applied theme is light. */
     isLight = this.#core.isLight;
+    /** Whether the currently applied theme is system. */
+    isSystem = this.#core.isSystem;
+    /**
+     * Whether the service has completed client-side initialization.
+     * `false` during SSR. Becomes `true` after the first browser render.
+     */
+    isHydrated = this.#core.isHydrated.asReadonly();
     /**
      * Advances to the next theme in the cycle.
      *
@@ -240,11 +387,18 @@ class ThemeSelectService {
     /** The theme explicitly selected by the user. May be `'system'`. */
     selectedTheme = this.#core.selectedTheme;
     /** Resolved theme applied to the DOM. Always concrete — never `'system'`. */
-    userTheme = this.#core.userTheme;
+    resolvedTheme = this.#core.resolvedTheme;
     /** Whether the currently applied theme is dark. */
     isDark = this.#core.isDark;
     /** Whether the currently applied theme is light. */
     isLight = this.#core.isLight;
+    /** Whether the currently applied theme is system. */
+    isSystem = this.#core.isSystem;
+    /**
+     * Whether the service has completed client-side initialization.
+     * `false` during SSR. Becomes `true` after the first browser render.
+     */
+    isHydrated = this.#core.isHydrated.asReadonly();
     /**
      * Applies the given theme.
      *
@@ -271,11 +425,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.7", ngImpor
 class ThemeToggleService {
     #core = inject(CoreThemeService);
     /** Resolved theme applied to the DOM. Always concrete — never `'system'`. */
-    userTheme = this.#core.userTheme;
+    resolvedTheme = this.#core.resolvedTheme;
+    selectedTheme = this.#core.selectedTheme;
     /** Whether the currently applied theme is dark. */
     isDark = this.#core.isDark;
     /** Whether the currently applied theme is light. */
     isLight = this.#core.isLight;
+    /** Whether the currently applied theme is system. */
+    isSystem = this.#core.isSystem;
+    /**
+     * Whether the service has completed client-side initialization.
+     * `false` during SSR. Becomes `true` after the first browser render.
+     * Guard any template logic that shows `selectedTheme` or `resolvedTheme`
+     * behind this signal to avoid a hydration-mismatch flash.
+     */
+    isHydrated = this.#core.isHydrated.asReadonly();
     /**
      * Toggles between `'dark'` and `'light'`.
      *
@@ -283,7 +447,7 @@ class ThemeToggleService {
      * Otherwise (including `'system'`), switches to `'dark'`.
      */
     toggle() {
-        const next = this.#core.selectedTheme() === 'dark' ? 'light' : 'dark';
+        const next = this.#core.resolvedTheme() === 'dark' ? 'light' : 'dark';
         this.#core.setTheme(next);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.7", ngImport: i0, type: ThemeToggleService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
@@ -302,5 +466,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.7", ngImpor
  * Generated bundle index. Do not edit.
  */
-export { CoreThemeService, DEFAULT_NG_CONFIG, DEFAULT_THEMES, NGX_THEME_STACK_CONFIG, ThemeCycleService, ThemeSelectService, ThemeToggleService, provideThemeStack };
+export { CoreThemeService, DEFAULT_NG_CONFIG, DEFAULT_THEMES, NGX_THEME_STACK_CONFIG, NgxThemeStackError, ThemeCycleService, ThemeSelectService, ThemeToggleService, provideThemeStack };
 //# sourceMappingURL=ngx-theme-stack.mjs.map

package/fesm2022/ngx-theme-stack.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ngx-theme-stack.mjs","sources":["../../../projects/ngx-theme-stack/src/lib/types.ts","../../../projects/ngx-theme-stack/src/lib/services/theme-stack.config.ts","../../../projects/ngx-theme-stack/src/lib/core/core-theme.service.ts","../../../projects/ngx-theme-stack/src/lib/services/theme-cycle.service.ts","../../../projects/ngx-theme-stack/src/lib/services/theme-select.service.ts","../../../projects/ngx-theme-stack/src/lib/services/theme-toggle.service.ts","../../../projects/ngx-theme-stack/src/public-api.ts","../../../projects/ngx-theme-stack/src/ngx-theme-stack.ts"],"sourcesContent":["/** Built-in themes. All other values are considered custom themes. /\nexport const DEFAULT_THEMES = ['system', 'light', 'dark'] as const;\n\n/* String union with autocompletion for defaults + any string support for customization. /\nexport type NgTheme = (typeof DEFAULT_THEMES)[number] \| (string & {});\n\nexport type NgSystemTheme = Exclude<NgTheme, 'system'>;\nexport type NgMode = 'attribute' \| 'class' \| 'both';\n\nexport interface NgConfig {\n theme: NgTheme;\n storageKey: string;\n mode: NgMode;\n themes: NgTheme[];\n}\n","import { InjectionToken } from '@angular/core';\nimport { DEFAULT_THEMES, NgConfig } from '../types';\n\n/\n ⚠ ATTENTION: SHARED CONFIGURATION VALUES\n \n These values MUST match the schematic defaults in:\n * projects/ngx-theme-stack/schematics/ng-add/index.ts\n \n If you change any of these, you MUST also update the schematic's DEFAULTS\n * constant so 'ng add' continues to provide correct hints and clean code.\n /\nexport const DEFAULT_NG_CONFIG = {\n theme: 'system',\n storageKey: 'ngx-theme-stack-theme',\n mode: 'class',\n themes: [...DEFAULT_THEMES],\n} satisfies NgConfig;\n\nexport const NGX_THEME_STACK_CONFIG = new InjectionToken<NgConfig>('NGX_THEME_STACK_CONFIG', {\n factory: () => DEFAULT_NG_CONFIG,\n});\n\n/\n Helper function to provide Theme Stack configuration.\n /\nexport function provideThemeStack(config: Partial<NgConfig> = {}) {\n return {\n provide: NGX_THEME_STACK_CONFIG,\n useValue: {\n ...DEFAULT_NG_CONFIG,\n ...config,\n } satisfies NgConfig,\n };\n}\n","import { isPlatformBrowser } from '@angular/common';\nimport {\n computed,\n DestroyRef,\n DOCUMENT,\n effect,\n inject,\n Injectable,\n PLATFORM_ID,\n signal,\n} from '@angular/core';\nimport { NGX_THEME_STACK_CONFIG } from '../services/theme-stack.config';\nimport { NgTheme, NgSystemTheme } from '../types';\n\n\n/\n Core service for managing the application's color theme.\n \n Handles theme persistence, system preference detection, and DOM updates.\n * Supports built-in themes ('dark', 'light', 'system') and custom extensions.\n /\n@Injectable({ providedIn: 'root' })\nexport class CoreThemeService {\n // ── Dependencies ──────────────────────────────────────────────────────────\n\n readonly #config = inject(NGX_THEME_STACK_CONFIG);\n readonly #destroyRef = inject(DestroyRef);\n readonly #document = inject(DOCUMENT);\n readonly #isBrowser = isPlatformBrowser(inject(PLATFORM_ID));\n\n // ── Theme configuration ───────────────────────────────────────────────────\n\n /* List of available themes for Select/Cycle services. Defaults to ['light', 'dark', 'system']. /\n readonly availableThemes = this.#config.themes;\n\n /* Internal Set for O(1) existence checks. /\n readonly #validThemes = new Set<NgTheme>(this.availableThemes);\n\n // ── System preference ─────────────────────────────────────────────────────\n\n /* MediaQueryList for OS color scheme, created once and reused. Null in SSR. /\n readonly #mediaQuery: MediaQueryList \| null = this.#isBrowser\n ? (this.#document.defaultView?.matchMedia('(prefers-color-scheme: dark)') ?? null)\n : null;\n\n readonly #systemPreference = signal<NgSystemTheme>(this.resolveSystemPreference());\n\n // ── Theme state ───────────────────────────────────────────────────────────\n\n readonly #selectedTheme = signal<NgTheme>(this.resolveInitialTheme());\n\n /* The theme explicitly selected by the user. May be `'system'`. /\n readonly selectedTheme = this.#selectedTheme.asReadonly();\n\n /* Resolved theme applied to the DOM. Always `'dark'` or `'light'` (or custom) — never `'system'`. /\n readonly userTheme = computed(() => {\n const theme = this.#selectedTheme();\n return theme === 'system' ? this.#systemPreference() : theme;\n });\n\n /* Whether the currently applied theme is dark. /\n readonly isDark = computed(() => this.userTheme() === 'dark');\n\n /* Whether the currently applied theme is light. /\n readonly isLight = computed(() => this.userTheme() === 'light');\n\n // ── Event handler ─────────────────────────────────────────────────────────\n\n readonly #onSystemPreferenceChange = () =>\n this.#systemPreference.set(this.resolveSystemPreference());\n\n // ── Lifecycle ─────────────────────────────────────────────────────────────\n\n constructor() {\n if (this.#isBrowser && this.#selectedTheme() === 'system') {\n this.startSystemThemeListener();\n }\n\n effect(() => this.applyThemeToDOM(this.userTheme()));\n\n this.#destroyRef.onDestroy(() => this.stopSystemThemeListener());\n }\n\n // ── Public API ────────────────────────────────────────────────────────────\n\n /\n Changes the active theme.\n \n Persists the choice explicitly so that switching e.g. from `'system'` to\n * `'light'` is saved even when the resolved `userTheme` did not change\n * (system preference was already `'light'`).\n \n @param theme - The theme to apply: `'dark'`, `'light'`, `'system'`, or a custom theme name.\n * @throws If `theme` is not a valid theme according to library configuration.\n /\n public setTheme(theme: NgTheme): void {\n if (!this.#isBrowser) return;\n\n if (!this.#validThemes.has(theme)) {\n throw new Error(\n `[ngx-theme-stack] Invalid theme: \"${theme}\". Valid values are: ${[...this.#validThemes].join(', ')}.`,\n );\n }\n\n if (theme === 'system') {\n this.#systemPreference.set(this.resolveSystemPreference());\n this.startSystemThemeListener();\n } else {\n this.stopSystemThemeListener();\n }\n\n this.#selectedTheme.set(theme);\n this.saveTheme(theme);\n }\n\n // ── Private ───────────────────────────────────────────────────────────────\n\n private resolveSystemPreference(): NgSystemTheme {\n return this.#mediaQuery?.matches ? 'dark' : 'light';\n }\n\n private resolveInitialTheme(): NgTheme {\n if (!this.#isBrowser) return this.#config.theme;\n return this.readStoredTheme() ?? this.#config.theme;\n }\n\n private startSystemThemeListener(): void {\n if (!this.#mediaQuery) return;\n this.stopSystemThemeListener();\n this.#mediaQuery.addEventListener('change', this.#onSystemPreferenceChange);\n }\n\n private stopSystemThemeListener(): void {\n this.#mediaQuery?.removeEventListener('change', this.#onSystemPreferenceChange);\n }\n\n private applyThemeToDOM(userTheme: NgTheme): void {\n if (!this.#isBrowser) return;\n\n const host = this.#document.documentElement;\n const { mode } = this.#config;\n\n if (mode === 'attribute' \|\| mode === 'both') {\n this.applyThemeAttribute(host, userTheme);\n }\n\n if (mode === 'class' \|\| mode === 'both') {\n this.applyThemeClasses(host, userTheme);\n }\n\n this.applyColorSchemeHint(host, userTheme);\n }\n\n private applyThemeAttribute(host: HTMLElement, theme: NgTheme): void {\n host.setAttribute('data-theme', theme);\n }\n\n private applyThemeClasses(host: HTMLElement, theme: NgTheme): void {\n for (const t of this.availableThemes) {\n host.classList.remove(t);\n }\n\n host.classList.add(theme);\n }\n\n private applyColorSchemeHint(host: HTMLElement, theme: NgTheme): void {\n if (theme === 'dark' \|\| theme === 'light') {\n host.style.setProperty('color-scheme', theme);\n return;\n }\n\n host.style.removeProperty('color-scheme');\n }\n\n private readStoredTheme(): NgTheme \| null {\n try {\n const stored = localStorage.getItem(this.#config.storageKey);\n if (stored && this.#validThemes.has(stored as NgTheme)) {\n return stored as NgTheme;\n }\n return null;\n } catch (e) {\n console.warn('[ngx-theme-stack] Could not read theme from localStorage.', e);\n return null;\n }\n }\n\n private saveTheme(theme: NgTheme): void {\n try {\n localStorage.setItem(this.#config.storageKey, theme);\n } catch (e) {\n console.warn('[ngx-theme-stack] Could not save theme to localStorage.', e);\n }\n }\n}\n","import { inject, Injectable } from '@angular/core';\nimport { CoreThemeService } from '../core/core-theme.service';\n\n/\n Convenience service for cycling through themes in a fixed order.\n \n Default cycle: `'light'` → `'dark'` → `'system'` → `'light'` → ...\n \n Use this when you want to offer users a single button that rotates\n * through all available theme options.\n /\n@Injectable({ providedIn: 'root' })\nexport class ThemeCycleService {\n\n readonly #core = inject(CoreThemeService);\n\n /* List of all configured themes for cycling. Defaults to ['light', 'dark', 'system']. /\n readonly #cycle = this.#core.availableThemes;\n\n /* The theme explicitly selected by the user. May be `'system'`. /\n readonly selectedTheme = this.#core.selectedTheme;\n\n /* Resolved theme applied to the DOM. Always concrete — never `'system'`. /\n readonly userTheme = this.#core.userTheme;\n\n /* Whether the currently applied theme is dark. /\n readonly isDark = this.#core.isDark;\n\n /* Whether the currently applied theme is light. /\n readonly isLight = this.#core.isLight;\n\n /\n Advances to the next theme in the cycle.\n \n Cycle order is determined by the configured `themes` property in `NgConfig`.\n \n If the current theme is not found in the cycle (e.g. set externally),\n * the cycle restarts from the first theme.\n /\n cycle(): void {\n const current = this.#core.selectedTheme();\n const index = this.#cycle.indexOf(current);\n const next = this.#cycle[(index + 1) % this.#cycle.length];\n this.#core.setTheme(next);\n }\n}\n","import { inject, Injectable } from '@angular/core';\nimport { CoreThemeService } from '../core/core-theme.service';\nimport { NgTheme } from '../types';\n\n\n/\n Convenience service for selecting a theme from a list.\n \n Use this when you want to bind a `<select>` or a group of radio/tab\n * buttons to the full set of available themes.\n /\n@Injectable({ providedIn: 'root' })\nexport class ThemeSelectService {\n\n readonly #core = inject(CoreThemeService);\n\n /* List of all configured themes. Defaults to ['light', 'dark', 'system']. /\n readonly availableThemes = this.#core.availableThemes;\n\n /* The theme explicitly selected by the user. May be `'system'`. /\n readonly selectedTheme = this.#core.selectedTheme;\n\n /* Resolved theme applied to the DOM. Always concrete — never `'system'`. /\n readonly userTheme = this.#core.userTheme;\n\n /* Whether the currently applied theme is dark. /\n readonly isDark = this.#core.isDark;\n\n /* Whether the currently applied theme is light. /\n readonly isLight = this.#core.isLight;\n\n /\n Applies the given theme.\n \n @param theme - The theme to apply: `'dark'`, `'light'`, `'system'`, or custom.\n * @throws If `theme` is not a valid theme according to library configuration.\n /\n select(theme: NgTheme): void {\n this.#core.setTheme(theme);\n }\n}\n","import { inject, Injectable } from '@angular/core';\nimport { CoreThemeService } from '../core/core-theme.service';\n\n/\n Convenience service for toggling between `'dark'` and `'light'`.\n \n Use this when you only need a simple on/off switch and do not\n * need to manage `'system'` or cycle through themes.\n /\n@Injectable({ providedIn: 'root' })\nexport class ThemeToggleService {\n\n readonly #core = inject(CoreThemeService);\n\n /* Resolved theme applied to the DOM. Always concrete — never `'system'`. /\n readonly userTheme = this.#core.userTheme;\n\n /* Whether the currently applied theme is dark. /\n readonly isDark = this.#core.isDark;\n\n /* Whether the currently applied theme is light. /\n readonly isLight = this.#core.isLight;\n\n /\n Toggles between `'dark'` and `'light'`.\n \n If the selected theme is explicitly `'dark'`, switches to `'light'`.\n * Otherwise (including `'system'`), switches to `'dark'`.\n /\n toggle(): void {\n const next = this.#core.selectedTheme() === 'dark' ? 'light' : 'dark';\n this.#core.setTheme(next);\n }\n}\n","/\n * Public API Surface of ngx-theme-stack\n /\n\nexport from './lib/core/core-theme.service';\nexport * from './lib/services/theme-stack.config';\nexport * from './lib/services/theme-cycle.service';\nexport * from './lib/services/theme-select.service';\nexport * from './lib/services/theme-toggle.service';\nexport * from './lib/types';\n","/*\n Generated bundle index. Do not edit.\n /\n\nexport from './public-api';\n"],"names":[],"mappings":"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"}
1	+ {"version":3,"file":"ngx-theme-stack.mjs","sources":["../../../projects/ngx-theme-stack/src/lib/errors.ts","../../../projects/ngx-theme-stack/src/lib/types.ts","../../../projects/ngx-theme-stack/src/lib/config/index.ts","../../../projects/ngx-theme-stack/src/lib/core/core-theme.service.ts","../../../projects/ngx-theme-stack/src/lib/services/theme-cycle.service.ts","../../../projects/ngx-theme-stack/src/lib/services/theme-select.service.ts","../../../projects/ngx-theme-stack/src/lib/services/theme-toggle.service.ts","../../../projects/ngx-theme-stack/src/public-api.ts","../../../projects/ngx-theme-stack/src/ngx-theme-stack.ts"],"sourcesContent":["/*\n Base error class for `ngx-theme-stack`.\n \n Thrown when the library configuration is invalid.\n * Consumers can use `instanceof NgxThemeStackError` to catch only\n * errors originating from this library.\n \n @example\n * try {\n * bootstrapApplication(AppComponent, appConfig);\n * } catch (e) {\n * if (e instanceof NgxThemeStackError) {\n * console.error('Bad ngx-theme-stack config:', e.message);\n * }\n * }\n /\nexport class NgxThemeStackError extends Error {\n override readonly name = 'NgxThemeStackError';\n\n constructor(message: string) {\n super(`[ngx-theme-stack] ${message}`);\n // Restore prototype chain (required when targeting ES5 or older)\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n","/\n Runtime list of built-in themes.\n \n Lives here (and not in config/index.ts) because it defines a type:\n * config/index.ts already imports from types.ts, so placing DEFAULT_THEMES\n * here avoids any circular dependency.\n \n ⚠ KEEP IN SYNC with the duplicate in:\n * projects/ngx-theme-stack/schematics/ng-add/constants.ts → DEFAULT_THEMES\n \n Schematics compile to CommonJS and cannot import from this ESM file,\n * so the values are intentionally duplicated. Change both at the same time.\n /\nexport const DEFAULT_THEMES = ['system', 'light', 'dark'] as const;\n\n/* Literal union of built-in themes: `'system' \| 'light' \| 'dark'`. /\nexport type DefaultNgTheme = (typeof DEFAULT_THEMES)[number];\n\n/\n Theme type.\n \n - Without `T`: open union — accepts any `string` with IDE autocomplete\n * hints for the built-in themes (`'system' \| 'light' \| 'dark'`).\n * - With `T`: closed union — exactly `DefaultNgTheme \| T`, enabling\n * full type-safety for custom theme sets.\n \n @example\n * NgTheme // 'system' \| 'light' \| 'dark' \| (string & {})\n * NgTheme<'sepia'> // 'system' \| 'light' \| 'dark' \| 'sepia'\n /\nexport type NgTheme<T extends string = string & {}> = DefaultNgTheme \| T;\n\n/\n Resolved theme — always `'light'` or `'dark'`, never `'system'`.\n * Represents the value that comes from `matchMedia`, not user selection.\n /\nexport type NgSystemTheme = Exclude<DefaultNgTheme, 'system'>;\n\nexport type NgMode = 'attribute' \| 'class' \| 'both';\n\n/\n Library configuration.\n \n @typeParam T - Custom theme literals. Defaults to open `string`, preserving\n * backwards compatibility. Pass specific literals (e.g. `'sepia' \| 'ocean'`)\n * via {@link provideThemeStack} to get a closed, type-safe theme union.\n /\nexport interface NgConfig<T extends string = string & {}> {\n defaultTheme: NgTheme<T>;\n storageKey: string;\n mode: NgMode;\n themes: NgTheme<T>[];\n}\n","import { InjectionToken } from '@angular/core';\nimport { NgxThemeStackError } from '../errors';\nimport { DEFAULT_THEMES, DefaultNgTheme, NgConfig } from '../types';\n\n/\n ⚠ ATTENTION: SHARED CONFIGURATION VALUES\n \n These defaults MUST match the schematic defaults in:\n * projects/ngx-theme-stack/schematics/ng-add/constants.ts → DEFAULTS\n \n Schematics compile to CommonJS and cannot import from this ESM file,\n * so the values are intentionally duplicated. Change both at the same time.\n \n If you change defaults here, also update:\n * schematics/ng-add/constants.ts → DEFAULTS + DEFAULT_THEMES\n /\n\nexport const DEFAULT_NG_CONFIG = {\n defaultTheme: 'system',\n storageKey: 'ngx-theme-stack-theme',\n mode: 'class',\n themes: [...DEFAULT_THEMES],\n} satisfies NgConfig;\n\n// The token uses NgConfig<string> because Angular DI resolves types at runtime\n// and cannot carry generic parameters. Type-safety is enforced at the\n// provideThemeStack() call site instead.\nexport const NGX_THEME_STACK_CONFIG = new InjectionToken<NgConfig<string>>(\n 'NGX_THEME_STACK_CONFIG',\n {\n factory: () => DEFAULT_NG_CONFIG,\n },\n);\n\n/\n Provides Theme Stack configuration to Angular's DI system.\n \n Custom `themes` are merged with the built-in defaults\n * (`'light'`, `'dark'`, `'system'`), so you never lose the base themes.\n \n The type parameter `T` is inferred automatically from the `themes` array\n * when passed as a `const` — no need to specify it manually.\n \n @typeParam T - Custom theme string literals, inferred from the `themes` option.\n \n @param config - Optional partial configuration. Omitted fields fall back to\n * {@link DEFAULT_NG_CONFIG}.\n \n @throws {@link NgxThemeStackError}\n * - If any entry in `themes` is an empty or whitespace-only string.\n * - If `defaultTheme` is not present in the resolved (merged) themes array.\n * - If `storageKey` is an empty or whitespace-only string.\n \n @example\n * // Default — uses built-in themes and sensible defaults\n * provideThemeStack()\n \n @example\n * // Closed union: TypeScript infers 'sepia' \| 'ocean' from the array\n * provideThemeStack({\n * themes: ['sepia', 'ocean'] as const,\n * defaultTheme: 'sepia', // ✅ in resolved themes\n * // defaultTheme: 'nope', // ❌ throws NgxThemeStackError at runtime\n * })\n \n @example\n * // Custom storage key and mode\n * provideThemeStack({\n * storageKey: 'my-app-theme',\n * mode: 'class',\n * })\n /\nexport function provideThemeStack<const T extends string = DefaultNgTheme>(\n config: Partial<NgConfig<T>> = {},\n) {\n config.themes?.forEach((t) => {\n if (t.trim() === '') throw new NgxThemeStackError('Theme cannot be empty or whitespace.');\n });\n\n const themes = config.themes\n ? Array.from(new Set([...DEFAULT_NG_CONFIG.themes, ...config.themes]))\n : DEFAULT_NG_CONFIG.themes;\n\n if (config.defaultTheme && !(themes as string[]).includes(config.defaultTheme as string)) {\n throw new NgxThemeStackError(\n `\"defaultTheme\" must be one of the resolved themes: [${themes.join(', ')}].`,\n );\n }\n\n if (config.storageKey !== undefined && config.storageKey.trim() === '') {\n throw new NgxThemeStackError('\"storageKey\" cannot be empty or whitespace.');\n }\n\n return {\n provide: NGX_THEME_STACK_CONFIG,\n useValue: {\n ...DEFAULT_NG_CONFIG,\n ...config,\n themes,\n } as NgConfig<string>,\n };\n}\n","import { isPlatformBrowser } from '@angular/common';\nimport {\n afterNextRender,\n computed,\n DestroyRef,\n DOCUMENT,\n effect,\n inject,\n Injectable,\n PLATFORM_ID,\n signal,\n} from '@angular/core';\nimport { NGX_THEME_STACK_CONFIG } from '../config';\nimport { NgxThemeStackError } from '../errors';\nimport { NgSystemTheme, NgTheme } from '../types';\n\n/\n Core service for managing the application's color theme.\n \n Handles theme persistence, system preference detection, and DOM updates.\n * Supports built-in themes ('dark', 'light', 'system') and custom extensions.\n /\n@Injectable({ providedIn: 'root' })\nexport class CoreThemeService {\n // ── Dependencies ──────────────────────────────────────────────────────────\n\n readonly #config = inject(NGX_THEME_STACK_CONFIG);\n readonly #destroyRef = inject(DestroyRef);\n readonly #document = inject(DOCUMENT);\n readonly #isBrowser = isPlatformBrowser(inject(PLATFORM_ID));\n\n // ── Theme configuration ───────────────────────────────────────────────────\n\n /\n The initial stored theme read from localStorage.\n * This is used to determine the initial theme of the application.\n /\n readonly #initialStoredTheme = this.readStoredTheme();\n\n /* List of available themes for Select/Cycle services. Defaults to ['system', 'light', 'dark']. /\n readonly availableThemes = this.#config.themes;\n\n /* Internal Set for O(1) existence checks. /\n readonly #validThemes = new Set<NgTheme>(this.availableThemes);\n\n /* The anti-flash class to remove from the host element. /\n #antiFlashClass: string \| null = null;\n\n // ── System preference ─────────────────────────────────────────────────────\n\n /* MediaQueryList for OS color scheme, created once and reused. Null in SSR. /\n readonly #mediaQuery: MediaQueryList \| null = this.#isBrowser\n ? (this.#document.defaultView?.matchMedia('(prefers-color-scheme: dark)') ?? null)\n : null;\n\n readonly #systemPreference = signal<NgSystemTheme>(this.resolveSystemPreference());\n\n // ── Theme state ───────────────────────────────────────────────────────────\n\n readonly #selectedTheme = signal<NgTheme>(this.resolveInitialTheme());\n\n /* The theme explicitly selected by the user. May be `'system'`. /\n readonly selectedTheme = this.#selectedTheme.asReadonly();\n\n /* Resolved theme applied to the DOM. Always `'dark'` or `'light'` (or custom) — never `'system'`. /\n readonly resolvedTheme = computed(() => {\n const theme = this.#selectedTheme();\n return theme === 'system' ? this.#systemPreference() : theme;\n });\n\n /* Whether the currently applied theme is dark. /\n readonly isDark = computed(() => this.resolvedTheme() === 'dark');\n\n /* Whether the currently applied theme is light. /\n readonly isLight = computed(() => this.resolvedTheme() === 'light');\n\n /* Whether the currently applied theme is system. /\n readonly isSystem = computed(() => this.selectedTheme() === 'system');\n\n /\n Whether the service has completed client-side initialization.\n \n `false` during SSR and on the very first render pass. Becomes `true`\n * immediately after the first browser render, once the real persisted theme\n * has been read from `localStorage`.\n \n Use this to guard any template logic that depends on `selectedTheme` or\n * `resolvedTheme` to avoid an SSR hydration-mismatch flash: the server\n * renders the default (`'system'`) while the browser may have a different\n * value stored.\n \n @example\n * ```html\n * {{ themeService.isHydrated() ? selectedTheme() : '—' }}\n * ```\n /\n readonly isHydrated = signal(false);\n\n // ── Event handler ─────────────────────────────────────────────────────────\n\n readonly #onSystemPreferenceChange = () =>\n this.#systemPreference.set(this.resolveSystemPreference());\n\n // ── Lifecycle ─────────────────────────────────────────────────────────────\n\n constructor() {\n this.captureAntiFlashClass();\n\n if (this.#isBrowser && this.#selectedTheme() === 'system') {\n this.startSystemThemeListener();\n }\n\n effect(() => this.applyThemeToDOM(this.resolvedTheme()));\n afterNextRender(() => this.isHydrated.set(true));\n this.#destroyRef.onDestroy(() => this.stopSystemThemeListener());\n }\n\n // ── Public API ────────────────────────────────────────────────────────────\n\n /\n Changes the active theme.\n \n Persists the choice explicitly so that switching e.g. from `'system'` to\n * `'light'` is saved even when the resolved theme did not change\n * (system preference was already `'light'`).\n \n @param theme - The theme to apply: `'dark'`, `'light'`, `'system'`, or a custom theme name.\n * @throws If `theme` is not a valid theme according to library configuration.\n /\n public setTheme(theme: NgTheme): void {\n if (!this.#validThemes.has(theme)) {\n throw new NgxThemeStackError(\n `Invalid theme: \"${theme}\". Valid values are: ${[...this.#validThemes].join(', ')}.`,\n );\n }\n if (!this.#isBrowser) return;\n if (theme === this.#selectedTheme()) return;\n if (theme === 'system') {\n this.#systemPreference.set(this.resolveSystemPreference());\n this.startSystemThemeListener();\n } else {\n this.stopSystemThemeListener();\n }\n\n this.#selectedTheme.set(theme);\n this.saveTheme(theme);\n }\n\n // ── Private ───────────────────────────────────────────────────────────────\n\n private resolveSystemPreference(): NgSystemTheme {\n return this.#mediaQuery?.matches ? 'dark' : 'light';\n }\n\n private resolveInitialTheme(): NgTheme {\n const theme = this.#initialStoredTheme;\n if (theme && this.#validThemes.has(theme as NgTheme)) {\n return theme as NgTheme;\n }\n return this.#config.defaultTheme;\n }\n\n private startSystemThemeListener(): void {\n if (!this.#mediaQuery) return;\n this.stopSystemThemeListener();\n this.#mediaQuery.addEventListener('change', this.#onSystemPreferenceChange);\n }\n\n private stopSystemThemeListener(): void {\n this.#mediaQuery?.removeEventListener('change', this.#onSystemPreferenceChange);\n }\n\n private applyThemeToDOM(theme: NgTheme): void {\n if (!this.#isBrowser) return;\n\n const host = this.#document.documentElement;\n\n if (this.#antiFlashClass) {\n host.classList.remove(this.#antiFlashClass);\n this.#antiFlashClass = null;\n }\n\n const { mode } = this.#config;\n\n if (mode === 'attribute' \|\| mode === 'both') {\n this.applyThemeAttribute(host, theme);\n }\n\n if (mode === 'class' \|\| mode === 'both') {\n this.applyThemeClasses(host, theme);\n }\n\n this.applyColorSchemeHint(host, theme);\n }\n\n private applyThemeAttribute(host: HTMLElement, theme: NgTheme): void {\n host.setAttribute('data-theme', theme);\n }\n\n private applyThemeClasses(host: HTMLElement, theme: NgTheme): void {\n host.classList.remove(...this.availableThemes);\n host.classList.add(theme);\n }\n\n private applyColorSchemeHint(host: HTMLElement, theme: NgTheme): void {\n if (theme === 'dark' \|\| theme === 'light') {\n host.style.setProperty('color-scheme', theme);\n return;\n }\n\n host.style.removeProperty('color-scheme');\n }\n\n private captureAntiFlashClass(): void {\n if (!this.#isBrowser \|\| !this.#initialStoredTheme) return;\n\n if (!/^[a-zA-Z][a-zA-Z0-9_-]$/.test(this.#initialStoredTheme)) {\n this.#antiFlashClass = null;\n return;\n }\n\n if (this.#initialStoredTheme === 'system') {\n this.#antiFlashClass = this.resolveSystemPreference();\n return;\n }\n\n this.#antiFlashClass = this.#initialStoredTheme;\n }\n\n private readStoredTheme(): string \| null {\n if (!this.#isBrowser) return null;\n\n try {\n return localStorage.getItem(this.#config.storageKey);\n } catch (e) {\n console.warn('[ngx-theme-stack] Could not read theme from localStorage.', e);\n return null;\n }\n }\n\n private saveTheme(theme: NgTheme): void {\n if (!this.#isBrowser) return;\n\n try {\n localStorage.setItem(this.#config.storageKey, theme);\n } catch (e) {\n console.warn('[ngx-theme-stack] Could not save theme to localStorage.', e);\n }\n }\n}\n","import { inject, Injectable } from '@angular/core';\nimport { CoreThemeService } from '../core/core-theme.service';\n\n/*\n Convenience service for cycling through themes in a fixed order.\n \n Default cycle: `'system'` → `'light'` → `'dark'` → `'system'` → ...\n \n Use this when you want to offer users a single button that rotates\n * through all available theme options.\n /\n@Injectable({ providedIn: 'root' })\nexport class ThemeCycleService {\n readonly #core = inject(CoreThemeService);\n\n /* List of all configured themes for cycling. Defaults to ['light', 'dark', 'system']. /\n readonly #cycle = this.#core.availableThemes;\n\n /* The theme explicitly selected by the user. May be `'system'`. /\n readonly selectedTheme = this.#core.selectedTheme;\n\n /* Resolved theme applied to the DOM. Always concrete — never `'system'`. /\n readonly resolvedTheme = this.#core.resolvedTheme;\n\n /* Whether the currently applied theme is dark. /\n readonly isDark = this.#core.isDark;\n\n /* Whether the currently applied theme is light. /\n readonly isLight = this.#core.isLight;\n\n /* Whether the currently applied theme is system. /\n readonly isSystem = this.#core.isSystem;\n\n /\n Whether the service has completed client-side initialization.\n * `false` during SSR. Becomes `true` after the first browser render.\n /\n readonly isHydrated = this.#core.isHydrated.asReadonly();\n\n /\n Advances to the next theme in the cycle.\n \n Cycle order is determined by the configured `themes` property in `NgConfig`.\n \n If the current theme is not found in the cycle (e.g. set externally),\n * the cycle restarts from the first theme.\n /\n cycle(): void {\n const current = this.#core.selectedTheme();\n const index = this.#cycle.indexOf(current);\n const next = this.#cycle[(index + 1) % this.#cycle.length];\n this.#core.setTheme(next);\n }\n}\n","import { inject, Injectable } from '@angular/core';\nimport { CoreThemeService } from '../core/core-theme.service';\nimport { NgTheme } from '../types';\n\n/\n Convenience service for selecting a theme from a list.\n \n Use this when you want to bind a `<select>` or a group of radio/tab\n * buttons to the full set of available themes.\n /\n@Injectable({ providedIn: 'root' })\nexport class ThemeSelectService {\n readonly #core = inject(CoreThemeService);\n\n /* List of all configured themes. Defaults to ['light', 'dark', 'system']. /\n readonly availableThemes = this.#core.availableThemes;\n\n /* The theme explicitly selected by the user. May be `'system'`. /\n readonly selectedTheme = this.#core.selectedTheme;\n\n /* Resolved theme applied to the DOM. Always concrete — never `'system'`. /\n readonly resolvedTheme = this.#core.resolvedTheme;\n\n /* Whether the currently applied theme is dark. /\n readonly isDark = this.#core.isDark;\n\n /* Whether the currently applied theme is light. /\n readonly isLight = this.#core.isLight;\n\n /* Whether the currently applied theme is system. /\n readonly isSystem = this.#core.isSystem;\n\n /\n Whether the service has completed client-side initialization.\n * `false` during SSR. Becomes `true` after the first browser render.\n /\n readonly isHydrated = this.#core.isHydrated.asReadonly();\n\n /\n Applies the given theme.\n \n @param theme - The theme to apply: `'dark'`, `'light'`, `'system'`, or custom.\n * @throws If `theme` is not a valid theme according to library configuration.\n /\n select(theme: NgTheme): void {\n this.#core.setTheme(theme);\n }\n}\n","import { inject, Injectable } from '@angular/core';\nimport { CoreThemeService } from '../core/core-theme.service';\n\n/\n Convenience service for toggling between `'dark'` and `'light'`.\n \n Use this when you only need a simple on/off switch and do not\n * need to manage `'system'` or cycle through themes.\n /\n@Injectable({ providedIn: 'root' })\nexport class ThemeToggleService {\n readonly #core = inject(CoreThemeService);\n\n /* Resolved theme applied to the DOM. Always concrete — never `'system'`. /\n readonly resolvedTheme = this.#core.resolvedTheme;\n\n readonly selectedTheme = this.#core.selectedTheme;\n\n /* Whether the currently applied theme is dark. /\n readonly isDark = this.#core.isDark;\n\n /* Whether the currently applied theme is light. /\n readonly isLight = this.#core.isLight;\n\n /* Whether the currently applied theme is system. /\n readonly isSystem = this.#core.isSystem;\n\n /\n Whether the service has completed client-side initialization.\n * `false` during SSR. Becomes `true` after the first browser render.\n * Guard any template logic that shows `selectedTheme` or `resolvedTheme`\n * behind this signal to avoid a hydration-mismatch flash.\n /\n readonly isHydrated = this.#core.isHydrated.asReadonly();\n\n /\n Toggles between `'dark'` and `'light'`.\n \n If the selected theme is explicitly `'dark'`, switches to `'light'`.\n * Otherwise (including `'system'`), switches to `'dark'`.\n /\n toggle(): void {\n const next = this.#core.resolvedTheme() === 'dark' ? 'light' : 'dark';\n this.#core.setTheme(next);\n }\n}\n","/\n * Public API Surface of ngx-theme-stack\n /\n\nexport from './lib/core/core-theme.service';\nexport * from './lib/config';\nexport * from './lib/services/theme-cycle.service';\nexport * from './lib/services/theme-select.service';\nexport * from './lib/services/theme-toggle.service';\nexport * from './lib/types';\nexport * from './lib/errors';\n","/*\n Generated bundle index. Do not edit.\n /\n\nexport from './public-api';\n"],"names":[],"mappings":"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"}