56 lines
2.2 KiB
TypeScript
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,
|
|
};
|
|
}
|