@shohojdhara/atomix 0.2.7 → 0.2.9

package/CHANGELOG.md

@@ -7,6 +7,64 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+#### Theme Manager System
+- **Theme Manager Class**: Core theme management for vanilla JavaScript applications
+  - Dynamic theme loading with CSS file management
+  - Theme persistence using localStorage
+  - Event system for theme changes (`themeChange`, `themeLoad`, `themeError`)
+  - Theme preloading for faster switching
+  - SSR-safe implementation
+  - Comprehensive error handling
+
+- **React Integration**:
+  - `ThemeProvider` component for React applications
+  - `useTheme` hook for accessing theme state
+  - `ThemeContext` for context-based state management
+  - Loading and error states
+  - Automatic cleanup on unmount
+
+- **TypeScript Support**:
+  - Complete type definitions for all theme utilities
+  - `ThemeMetadata`, `ThemeManagerConfig`, `ThemeChangeEvent` interfaces
+  - Type-safe event system
+  - Full IntelliSense support
+
+- **Package Exports**:
+  - `@shohojdhara/atomix/theme` - Theme manager utilities
+  - `@shohojdhara/atomix/themes/config` - Theme configuration
+
+- **Documentation**:
+  - Comprehensive theme manager guide (`docs/THEME_MANAGER.md`)
+  - React usage examples
+  - Vanilla JavaScript examples
+  - API reference
+  - Migration guide
+  - Troubleshooting section
+
+- **Runtime Configuration**:
+  - Added runtime section to `themes.config.js`
+  - Support for CDN paths
+  - Theme preloading configuration
+  - Theme dependencies mapping
+
+### Changed
+- Updated `README.md` with theme manager usage examples
+- Enhanced `themes.config.js` with runtime configuration options
+- Updated `src/lib/index.ts` to export theme utilities
+
+### Features
+- 🎨 Dynamic theme switching without page reload
+- 💾 Automatic theme persistence across sessions
+- ⚡ Theme preloading for instant switching
+- 🔒 Full TypeScript support
+- ♿ SSR compatible (Next.js, Remix, etc.)
+- 🎯 Works with React and vanilla JavaScript
+- 📦 Zero breaking changes to existing API
+
+## [0.2.8] - 2025-01-28
+
 ## [0.2.7] - 2025-01-27
 
 ## [0.1.25] - 2025-07-02

package/README.md

@@ -32,7 +32,6 @@ npm install @shohojdhara/atomix
 
 ### React
 
-```jsx
 import { Button } from '@shohojdhara/atomix';
 import '@shohojdhara/atomix/css';
 
@@ -41,6 +40,46 @@ function App() {
 }
 ```
 
+### Theme Management
+
+Atomix includes a powerful theme manager for dynamic theme switching:
+
+```jsx
+import { ThemeProvider, useTheme } from '@shohojdhara/atomix/theme';
+import { themesConfig } from '@shohojdhara/atomix/themes/config';
+
+function App() {
+  return (
+    <ThemeProvider themes={themesConfig.metadata} defaultTheme="shaj-default">
+      <YourApp />
+    </ThemeProvider>
+  );
+}
+
+function ThemeSwitcher() {
+  const { theme, setTheme, availableThemes } = useTheme();
+  
+  return (
+    <select value={theme} onChange={(e) => setTheme(e.target.value)}>
+      {availableThemes.map(t => (
+        <option key={t.class} value={t.class}>{t.name}</option>
+      ))}
+    </select>
+  );
+}
+```
+
+**Available Themes:**
+- `shaj-default` - Default theme (stable)
+- `flashtrade` - Crypto trading platform theme (stable)
+- `boomdevs` - BoomDevs theme (beta)
+- `esrar` - Esrar theme (beta)
+- `mashroom` - Mashroom theme (beta)
+- `applemix` - Apple-inspired glass morphism theme (experimental)
+
+For detailed theme manager documentation, see [Theme Manager Guide](docs/THEME_MANAGER.md).
+
+
 ## Styles
 
 Atomix provides comprehensive styling through CSS or SCSS: