Files
slp-modular-cms/frontend/themes/resolveTheme.ts
T

56 lines
2.2 KiB
TypeScript

import fs from 'node:fs';
import path from 'node:path';
export interface ResolvedTheme {
/** Absolute path of the CSS file to import (the empty module when no theme is selected). */
css: string;
/** Absolute path of the theme favicon, or null when there is no theme or it ships none. */
favicon: string | null;
/**
* Brand logo files: one for light backgrounds (dark ink) and one for dark backgrounds (light
* ink), or null when the theme ships none. Both or neither: a logo that is invisible in one
* colour mode is worse than none.
*/
logo: { onLight: string; onDark: string } | null;
}
const THEMES_DIR = import.meta.dirname;
/** Theme folders available next to this file (each holds a theme.css). */
export function availableThemes(dir: string = THEMES_DIR): string[] {
return fs
.readdirSync(dir, { withFileTypes: true })
.filter((e) => e.isDirectory() && fs.existsSync(path.join(dir, e.name, 'theme.css')))
.map((e) => e.name)
.sort();
}
/**
* Resolves VITE_THEME to files. Unset or blank means "no theme": an empty CSS module, so the admin
* looks exactly as it always did. An unknown name is a build error, never a silent fallback, so a
* typo in the pipeline cannot ship an unthemed admin unnoticed.
*/
export function resolveTheme(name: string | undefined, dir: string = THEMES_DIR): ResolvedTheme {
const trimmed = (name ?? '').trim();
if (trimmed === '') {
return { css: path.join(dir, 'none.css'), favicon: null, logo: null };
}
// The name becomes a path segment: only known theme folders are accepted.
const known = availableThemes(dir);
if (!known.includes(trimmed)) {
throw new Error(
`Unknown VITE_THEME "${trimmed}". Available themes: ${known.length > 0 ? known.join(', ') : '(none)'}.`,
);
}
const favicon = path.join(dir, trimmed, 'favicon.png');
const onLight = path.join(dir, trimmed, 'logo-on-light.png');
const onDark = path.join(dir, trimmed, 'logo-on-dark.png');
return {
css: path.join(dir, trimmed, 'theme.css'),
favicon: fs.existsSync(favicon) ? favicon : null,
logo: fs.existsSync(onLight) && fs.existsSync(onDark) ? { onLight, onDark } : null,
};
}