openreader/src/contexts/ThemeContext.tsx
Richard R b7cc2436d2 feat(theme): add persistent custom theme with live color editing
Add support for a persistent "custom" theme that users can edit and preview in settings.

- add CustomThemeColors type and storage helpers (getCustomThemeColors, setCustomThemeColors)
- apply custom CSS variables at runtime and provide applyCustomColors to live-update variables
- include fallback CSS for html.custom to avoid flash before hydration
- add ColorPicker component with curated swatches for each color role
- extend SettingsModal to support editing, previewing, and persisting custom theme colors; exclude 'custom' from regular theme lists and read custom colors when rendering previews
- tighten theme detection logic to treat custom background luminance as light/dark when needed

This enables users to define, persist, and see live updates for custom color palettes.
2026-04-07 01:09:08 -06:00

189 lines
6.3 KiB
TypeScript

'use client';
import { createContext, useContext, useEffect, useState, ReactNode, useLayoutEffect } from 'react';
const THEMES = ['system', 'light', 'dark', 'ocean', 'forest', 'sunset', 'sea', 'mint', 'lavender', 'rose', 'sand', 'sky', 'slate', 'custom'] as const;
type Theme = (typeof THEMES)[number];
export interface CustomThemeColors {
background: string;
foreground: string;
base: string;
offbase: string;
accent: string;
secondaryAccent: string;
muted: string;
}
const CUSTOM_THEME_STORAGE_KEY = 'customThemeColors';
const DEFAULT_CUSTOM_COLORS: CustomThemeColors = {
background: '#1a1a2e',
foreground: '#e0e0e0',
base: '#16213e',
offbase: '#0f3460',
accent: '#e94560',
secondaryAccent: '#f78da7',
muted: '#7f8c8d',
};
export function getCustomThemeColors(): CustomThemeColors {
if (typeof window === 'undefined') return DEFAULT_CUSTOM_COLORS;
try {
const stored = localStorage.getItem(CUSTOM_THEME_STORAGE_KEY);
if (stored) return { ...DEFAULT_CUSTOM_COLORS, ...JSON.parse(stored) };
} catch { /* ignore */ }
return DEFAULT_CUSTOM_COLORS;
}
export function setCustomThemeColors(colors: CustomThemeColors): void {
localStorage.setItem(CUSTOM_THEME_STORAGE_KEY, JSON.stringify(colors));
}
function applyCustomThemeVariables(colors: CustomThemeColors): void {
const root = document.documentElement;
root.style.setProperty('--background', colors.background);
root.style.setProperty('--foreground', colors.foreground);
root.style.setProperty('--base', colors.base);
root.style.setProperty('--offbase', colors.offbase);
root.style.setProperty('--accent', colors.accent);
root.style.setProperty('--secondary-accent', colors.secondaryAccent);
root.style.setProperty('--muted', colors.muted);
root.style.setProperty('--prism-gradient', `linear-gradient(90deg, ${colors.accent}, ${colors.secondaryAccent}, ${colors.muted})`);
}
function clearCustomThemeVariables(): void {
const root = document.documentElement;
const vars = ['--background', '--foreground', '--base', '--offbase', '--accent', '--secondary-accent', '--muted', '--prism-gradient'];
vars.forEach(v => root.style.removeProperty(v));
}
/** Returns true if the hex color is perceptually light (luminance > 0.5) */
function isLightColor(hex: string): boolean {
const c = hex.replace('#', '');
const r = parseInt(c.substring(0, 2), 16) / 255;
const g = parseInt(c.substring(2, 4), 16) / 255;
const b = parseInt(c.substring(4, 6), 16) / 255;
const luminance = 0.299 * r + 0.587 * g + 0.114 * b;
return luminance > 0.5;
}
interface ThemeContextType {
theme: Theme;
setTheme: (theme: Theme) => void;
/** Call to live-update custom theme colors while the custom theme is active */
applyCustomColors: (colors: CustomThemeColors) => void;
}
const ThemeContext = createContext<ThemeContextType | undefined>(undefined);
const getSystemTheme = () => {
if (typeof window === 'undefined') return 'light';
return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
};
const STATIC_LIGHT_THEMES: ReadonlySet<string> = new Set(['light', 'lavender', 'rose', 'sand', 'sky', 'slate']);
const getEffectiveTheme = (theme: Theme): Theme => {
if (theme === 'system') {
return getSystemTheme();
}
return theme;
};
const getColorScheme = (theme: Theme): string => {
if (theme === 'custom') {
return isLightColor(getCustomThemeColors().background) ? 'light' : 'dark';
}
return STATIC_LIGHT_THEMES.has(theme) ? 'light' : 'dark';
};
export function ThemeProvider({ children }: { children: ReactNode }) {
const [theme, setTheme] = useState<Theme>('system');
const [mounted, setMounted] = useState(false);
// Initialize theme as early as possible to prevent flash
useLayoutEffect(() => {
const stored = localStorage.getItem('theme') as Theme;
const initialTheme = stored && THEMES.includes(stored) ? stored : 'system';
setTheme(initialTheme);
const effectiveTheme = getEffectiveTheme(initialTheme);
document.documentElement.classList.remove(...THEMES);
document.documentElement.classList.add(effectiveTheme);
document.documentElement.style.colorScheme = getColorScheme(effectiveTheme);
if (effectiveTheme === 'custom') {
applyCustomThemeVariables(getCustomThemeColors());
}
if (!stored) {
localStorage.setItem('theme', initialTheme);
}
setMounted(true);
}, []);
const handleThemeChange = (newTheme: Theme) => {
const root = window.document.documentElement;
const effectiveTheme = getEffectiveTheme(newTheme);
// Clear inline vars from a previous custom theme before switching
if (theme === 'custom' && effectiveTheme !== 'custom') {
clearCustomThemeVariables();
}
root.classList.remove(...THEMES);
root.classList.add(effectiveTheme);
root.style.colorScheme = getColorScheme(effectiveTheme);
if (effectiveTheme === 'custom') {
applyCustomThemeVariables(getCustomThemeColors());
}
localStorage.setItem('theme', newTheme);
setTheme(newTheme);
};
const handleApplyCustomColors = (colors: CustomThemeColors) => {
setCustomThemeColors(colors);
if (theme === 'custom') {
applyCustomThemeVariables(colors);
document.documentElement.style.colorScheme = isLightColor(colors.background) ? 'light' : 'dark';
}
};
useEffect(() => {
const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
const handleChange = () => {
if (theme === 'system') {
const effectiveTheme = getSystemTheme();
const root = window.document.documentElement;
root.classList.remove(...THEMES);
root.classList.add(effectiveTheme);
root.style.colorScheme = getColorScheme(effectiveTheme);
}
};
mediaQuery.addEventListener('change', handleChange);
return () => mediaQuery.removeEventListener('change', handleChange);
}, [theme]);
// Prevent flash during SSR
if (!mounted) {
return null;
}
return (
<ThemeContext.Provider value={{ theme, setTheme: handleThemeChange, applyCustomColors: handleApplyCustomColors }}>
{children}
</ThemeContext.Provider>
);
}
export function useTheme() {
const context = useContext(ThemeContext);
if (context === undefined) {
throw new Error('useTheme must be used within a ThemeProvider');
}
return context;
}
export { THEMES, isLightColor };