mirror of
https://github.com/duckietm/Nitro-V3.git
synced 2026-06-19 06:56:20 +00:00
8097344561
Runtime-loaded visual re-skin system (no client rebuild, real themes never hit git). A theme = a folder on the server (theme.base.url) with a manifest + CSS "pieces"; each piece is toggled from Settings > Themes (checkboxes). A broken/404 piece auto-falls back to the default (per piece). Hotel-wide default via ui-config theme.default (+ theme.default.pieces), per-user override in localStorage (same pattern as the catalog style toggle). - api/theme/ThemeManager: fetch index/manifest + inject/remove <link> + fallback - hooks/theme/useThemes: state + persist + default-from-config + live apply - components/theme/ThemeApplier: applies on boot (mounted in MainView) - UserSettings: General/Themes tabs with theme selector + per-piece checkboxes - custom-themes/: reference template (demo theme "Neon Viola" + README) - .gitignore: public/custom-themes/ (real themes are never committed)
109 lines
3.7 KiB
TypeScript
109 lines
3.7 KiB
TypeScript
import { useEffect, useMemo, useState } from 'react';
|
|
import { useBetween } from 'use-between';
|
|
import { ApplyThemePieces, ClearTheme, FetchThemeIndex, FetchThemeManifest, GetConfigurationValue, LocalStorageKeys, ThemeInfo, ThemeManifest } from '../../api';
|
|
import { useLocalStorage } from '../useLocalStorage';
|
|
|
|
// Per-user custom theme selection.
|
|
// - activeThemeId: '' = default (no custom theme). Default for new users comes
|
|
// from ui-config `theme.default` so the admin can set a hotel-wide default
|
|
// (like catalog.classic.style), while each user can override from Settings.
|
|
// - enabledPieces[themeId]: which graphic pieces of that theme are active
|
|
// (checkboxes). If absent, defaults to ui-config `theme.default.pieces`
|
|
// (when on the default theme) or ALL pieces.
|
|
const useThemesState = () =>
|
|
{
|
|
const [ activeThemeId, setActiveThemeId ] = useLocalStorage<string>(LocalStorageKeys.THEME_ACTIVE, GetConfigurationValue<string>('theme.default', ''));
|
|
const [ enabledPieces, setEnabledPieces ] = useLocalStorage<Record<string, string[]>>(LocalStorageKeys.THEME_PIECES, {});
|
|
const [ themes, setThemes ] = useState<ThemeInfo[]>([]);
|
|
const [ manifest, setManifest ] = useState<ThemeManifest>(null);
|
|
const [ loaded, setLoaded ] = useState(false);
|
|
|
|
// Load the theme index once.
|
|
useEffect(() =>
|
|
{
|
|
let alive = true;
|
|
|
|
FetchThemeIndex().then(list =>
|
|
{
|
|
if(alive) setThemes(list);
|
|
}).finally(() =>
|
|
{
|
|
if(alive) setLoaded(true);
|
|
});
|
|
|
|
return () => { alive = false; };
|
|
}, []);
|
|
|
|
// Load the manifest whenever the active theme changes.
|
|
useEffect(() =>
|
|
{
|
|
let alive = true;
|
|
|
|
if(!activeThemeId)
|
|
{
|
|
setManifest(null);
|
|
ClearTheme();
|
|
return;
|
|
}
|
|
|
|
FetchThemeManifest(activeThemeId).then(m =>
|
|
{
|
|
if(!alive) return;
|
|
|
|
setManifest(m);
|
|
|
|
if(!m) ClearTheme(); // broken/missing manifest -> full fallback to default
|
|
});
|
|
|
|
return () => { alive = false; };
|
|
}, [ activeThemeId ]);
|
|
|
|
// Which pieces are enabled for the current theme.
|
|
const activeEnabled = useMemo(() =>
|
|
{
|
|
if(!manifest) return [] as string[];
|
|
|
|
const stored = enabledPieces[activeThemeId];
|
|
|
|
if(stored) return stored;
|
|
|
|
const fromConfig = GetConfigurationValue<string[]>('theme.default.pieces', null);
|
|
|
|
// Default: config list (if this is the default theme) else every piece on.
|
|
if(fromConfig && activeThemeId === GetConfigurationValue<string>('theme.default', '')) return fromConfig;
|
|
|
|
return manifest.pieces.map(p => p.id);
|
|
}, [ manifest, enabledPieces, activeThemeId ]);
|
|
|
|
// Apply (inject/remove <link>s) whenever theme or enabled pieces change.
|
|
useEffect(() =>
|
|
{
|
|
if(!activeThemeId || !manifest)
|
|
{
|
|
ClearTheme();
|
|
return;
|
|
}
|
|
|
|
ApplyThemePieces(activeThemeId, manifest.pieces.filter(p => activeEnabled.includes(p.id)));
|
|
}, [ activeThemeId, manifest, activeEnabled ]);
|
|
|
|
const selectTheme = (id: string) => setActiveThemeId(id || '');
|
|
|
|
const togglePiece = (pieceId: string) =>
|
|
{
|
|
if(!activeThemeId || !manifest) return;
|
|
|
|
setEnabledPieces(prev =>
|
|
{
|
|
const current = prev[activeThemeId] ?? manifest.pieces.map(p => p.id);
|
|
const next = current.includes(pieceId) ? current.filter(x => x !== pieceId) : [ ...current, pieceId ];
|
|
|
|
return { ...prev, [activeThemeId]: next };
|
|
});
|
|
};
|
|
|
|
return { themes, activeThemeId, manifest, activeEnabled, loaded, selectTheme, togglePiece };
|
|
};
|
|
|
|
export const useThemes = () => useBetween(useThemesState);
|