mithril-materialized 3.14.4 → 3.14.5

package/dist/index.esm.js

@@ -8869,10 +8869,26 @@ const defaultI18n$1 = {
  * Theme switching utilities and component
  */
 class ThemeManager {
+    /**
+     * Configure whether ThemeManager should use localStorage for persistence.
+     * When disabled, you can manage theme state externally and pass it via component attrs.
+     * @param enabled - Whether to use localStorage (default: true)
+     */
+    static setUseLocalStorage(enabled) {
+        this.useLocalStorage = enabled;
+    }
+    /**
+     * Check if localStorage persistence is enabled
+     */
+    static isUsingLocalStorage() {
+        return this.useLocalStorage;
+    }
     /**
      * Set the theme for the entire application
+     * @param theme - The theme to set
+     * @param persist - Override localStorage behavior for this call (optional)
      */
-    static setTheme(theme) {
+    static setTheme(theme, persist) {
         this.currentTheme = theme;
         const root = document.documentElement;
         if (theme === 'auto') {
@@ -8883,12 +8899,15 @@ class ThemeManager {
             // Set explicit theme
             root.setAttribute('data-theme', theme);
         }
-        // Store preference in localStorage
-        try {
-            localStorage.setItem('mm-theme', theme);
-        }
-        catch (e) {
-            // localStorage might not be available
+        // Store preference in localStorage if enabled
+        const shouldPersist = persist !== null && persist !== void 0 ? persist : this.useLocalStorage;
+        if (shouldPersist) {
+            try {
+                localStorage.setItem('mm-theme', theme);
+            }
+            catch (e) {
+                // localStorage might not be available
+            }
         }
     }
     /**
@@ -8911,18 +8930,22 @@ class ThemeManager {
         return 'light';
     }
     /**
-     * Initialize theme from localStorage or system preference
+     * Initialize theme from localStorage or system preference.
+     * If localStorage is disabled, initializes to the provided default or 'auto'.
+     * @param defaultTheme - Default theme to use when localStorage is disabled or empty
      */
-    static initialize() {
-        let savedTheme = 'auto';
-        try {
-            const stored = localStorage.getItem('mm-theme');
-            if (stored && ['light', 'dark', 'auto'].includes(stored)) {
-                savedTheme = stored;
+    static initialize(defaultTheme = 'auto') {
+        let savedTheme = defaultTheme;
+        if (this.useLocalStorage) {
+            try {
+                const stored = localStorage.getItem('mm-theme');
+                if (stored && ['light', 'dark', 'auto'].includes(stored)) {
+                    savedTheme = stored;
+                }
+            }
+            catch (e) {
+                // localStorage might not be available
             }
-        }
-        catch (e) {
-            // localStorage might not be available
         }
         this.setTheme(savedTheme);
     }
@@ -8933,8 +8956,20 @@ class ThemeManager {
         const current = this.getEffectiveTheme();
         this.setTheme(current === 'light' ? 'dark' : 'light');
     }
+    /**
+     * Clear the stored theme from localStorage
+     */
+    static clearStoredTheme() {
+        try {
+            localStorage.removeItem('mm-theme');
+        }
+        catch (e) {
+            // localStorage might not be available
+        }
+    }
 }
 ThemeManager.currentTheme = 'auto';
+ThemeManager.useLocalStorage = true;
 /**
  * Theme Switcher Component
  * Provides UI controls for changing themes

package/dist/index.js

@@ -8871,10 +8871,26 @@ const defaultI18n$1 = {
  * Theme switching utilities and component
  */
 class ThemeManager {
+    /**
+     * Configure whether ThemeManager should use localStorage for persistence.
+     * When disabled, you can manage theme state externally and pass it via component attrs.
+     * @param enabled - Whether to use localStorage (default: true)
+     */
+    static setUseLocalStorage(enabled) {
+        this.useLocalStorage = enabled;
+    }
+    /**
+     * Check if localStorage persistence is enabled
+     */
+    static isUsingLocalStorage() {
+        return this.useLocalStorage;
+    }
     /**
      * Set the theme for the entire application
+     * @param theme - The theme to set
+     * @param persist - Override localStorage behavior for this call (optional)
      */
-    static setTheme(theme) {
+    static setTheme(theme, persist) {
         this.currentTheme = theme;
         const root = document.documentElement;
         if (theme === 'auto') {
@@ -8885,12 +8901,15 @@ class ThemeManager {
             // Set explicit theme
             root.setAttribute('data-theme', theme);
         }
-        // Store preference in localStorage
-        try {
-            localStorage.setItem('mm-theme', theme);
-        }
-        catch (e) {
-            // localStorage might not be available
+        // Store preference in localStorage if enabled
+        const shouldPersist = persist !== null && persist !== void 0 ? persist : this.useLocalStorage;
+        if (shouldPersist) {
+            try {
+                localStorage.setItem('mm-theme', theme);
+            }
+            catch (e) {
+                // localStorage might not be available
+            }
         }
     }
     /**
@@ -8913,18 +8932,22 @@ class ThemeManager {
         return 'light';
     }
     /**
-     * Initialize theme from localStorage or system preference
+     * Initialize theme from localStorage or system preference.
+     * If localStorage is disabled, initializes to the provided default or 'auto'.
+     * @param defaultTheme - Default theme to use when localStorage is disabled or empty
      */
-    static initialize() {
-        let savedTheme = 'auto';
-        try {
-            const stored = localStorage.getItem('mm-theme');
-            if (stored && ['light', 'dark', 'auto'].includes(stored)) {
-                savedTheme = stored;
+    static initialize(defaultTheme = 'auto') {
+        let savedTheme = defaultTheme;
+        if (this.useLocalStorage) {
+            try {
+                const stored = localStorage.getItem('mm-theme');
+                if (stored && ['light', 'dark', 'auto'].includes(stored)) {
+                    savedTheme = stored;
+                }
+            }
+            catch (e) {
+                // localStorage might not be available
             }
-        }
-        catch (e) {
-            // localStorage might not be available
         }
         this.setTheme(savedTheme);
     }
@@ -8935,8 +8958,20 @@ class ThemeManager {
         const current = this.getEffectiveTheme();
         this.setTheme(current === 'light' ? 'dark' : 'light');
     }
+    /**
+     * Clear the stored theme from localStorage
+     */
+    static clearStoredTheme() {
+        try {
+            localStorage.removeItem('mm-theme');
+        }
+        catch (e) {
+            // localStorage might not be available
+        }
+    }
 }
 ThemeManager.currentTheme = 'auto';
+ThemeManager.useLocalStorage = true;
 /**
  * Theme Switcher Component
  * Provides UI controls for changing themes

package/dist/index.umd.js

@@ -8873,10 +8873,26 @@
      * Theme switching utilities and component
      */
     class ThemeManager {
+        /**
+         * Configure whether ThemeManager should use localStorage for persistence.
+         * When disabled, you can manage theme state externally and pass it via component attrs.
+         * @param enabled - Whether to use localStorage (default: true)
+         */
+        static setUseLocalStorage(enabled) {
+            this.useLocalStorage = enabled;
+        }
+        /**
+         * Check if localStorage persistence is enabled
+         */
+        static isUsingLocalStorage() {
+            return this.useLocalStorage;
+        }
         /**
          * Set the theme for the entire application
+         * @param theme - The theme to set
+         * @param persist - Override localStorage behavior for this call (optional)
          */
-        static setTheme(theme) {
+        static setTheme(theme, persist) {
             this.currentTheme = theme;
             const root = document.documentElement;
             if (theme === 'auto') {
@@ -8887,12 +8903,15 @@
                 // Set explicit theme
                 root.setAttribute('data-theme', theme);
             }
-            // Store preference in localStorage
-            try {
-                localStorage.setItem('mm-theme', theme);
-            }
-            catch (e) {
-                // localStorage might not be available
+            // Store preference in localStorage if enabled
+            const shouldPersist = persist !== null && persist !== void 0 ? persist : this.useLocalStorage;
+            if (shouldPersist) {
+                try {
+                    localStorage.setItem('mm-theme', theme);
+                }
+                catch (e) {
+                    // localStorage might not be available
+                }
             }
         }
         /**
@@ -8915,18 +8934,22 @@
             return 'light';
         }
         /**
-         * Initialize theme from localStorage or system preference
+         * Initialize theme from localStorage or system preference.
+         * If localStorage is disabled, initializes to the provided default or 'auto'.
+         * @param defaultTheme - Default theme to use when localStorage is disabled or empty
          */
-        static initialize() {
-            let savedTheme = 'auto';
-            try {
-                const stored = localStorage.getItem('mm-theme');
-                if (stored && ['light', 'dark', 'auto'].includes(stored)) {
-                    savedTheme = stored;
+        static initialize(defaultTheme = 'auto') {
+            let savedTheme = defaultTheme;
+            if (this.useLocalStorage) {
+                try {
+                    const stored = localStorage.getItem('mm-theme');
+                    if (stored && ['light', 'dark', 'auto'].includes(stored)) {
+                        savedTheme = stored;
+                    }
+                }
+                catch (e) {
+                    // localStorage might not be available
                 }
-            }
-            catch (e) {
-                // localStorage might not be available
             }
             this.setTheme(savedTheme);
         }
@@ -8937,8 +8960,20 @@
             const current = this.getEffectiveTheme();
             this.setTheme(current === 'light' ? 'dark' : 'light');
         }
+        /**
+         * Clear the stored theme from localStorage
+         */
+        static clearStoredTheme() {
+            try {
+                localStorage.removeItem('mm-theme');
+            }
+            catch (e) {
+                // localStorage might not be available
+            }
+        }
     }
     ThemeManager.currentTheme = 'auto';
+    ThemeManager.useLocalStorage = true;
     /**
      * Theme Switcher Component
      * Provides UI controls for changing themes

package/dist/theme-switcher.d.ts

@@ -37,10 +37,23 @@ export interface ThemeSwitcherAttrs {
  */
 export declare class ThemeManager {
     private static currentTheme;
+    private static useLocalStorage;
+    /**
+     * Configure whether ThemeManager should use localStorage for persistence.
+     * When disabled, you can manage theme state externally and pass it via component attrs.
+     * @param enabled - Whether to use localStorage (default: true)
+     */
+    static setUseLocalStorage(enabled: boolean): void;
+    /**
+     * Check if localStorage persistence is enabled
+     */
+    static isUsingLocalStorage(): boolean;
     /**
      * Set the theme for the entire application
+     * @param theme - The theme to set
+     * @param persist - Override localStorage behavior for this call (optional)
      */
-    static setTheme(theme: Theme): void;
+    static setTheme(theme: Theme, persist?: boolean): void;
     /**
      * Get the current theme
      */
@@ -50,13 +63,19 @@ export declare class ThemeManager {
      */
     static getEffectiveTheme(): 'light' | 'dark';
     /**
-     * Initialize theme from localStorage or system preference
+     * Initialize theme from localStorage or system preference.
+     * If localStorage is disabled, initializes to the provided default or 'auto'.
+     * @param defaultTheme - Default theme to use when localStorage is disabled or empty
      */
-    static initialize(): void;
+    static initialize(defaultTheme?: Theme): void;
     /**
      * Toggle between light and dark themes
      */
     static toggle(): void;
+    /**
+     * Clear the stored theme from localStorage
+     */
+    static clearStoredTheme(): void;
 }
 /**
  * Theme Switcher Component

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mithril-materialized",
-  "version": "3.14.4",
+  "version": "3.14.5",
   "description": "A materialize library for mithril.",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",