hydrogen-web/src/platform/web/ThemeLoader.ts

/*
Copyright 2020 The Matrix.org Foundation C.I.C.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

import type {ILogItem} from "../../logging/types.js";
import type {Platform} from "./Platform.js";

type NormalVariant = {
    id: string;
    cssLocation: string;
};

type DefaultVariant = {
    dark: {
        id: string;
        cssLocation: string;
        variantName: string;
    };
    light: {
        id: string;
        cssLocation: string;
        variantName: string;
    };
}

type ThemeInformation = NormalVariant | DefaultVariant; 

export enum ColorSchemePreference {
    Dark,
    Light
};

export class ThemeLoader {
    private _platform: Platform;
    private _themeMapping: Record<string, ThemeInformation>;

    constructor(platform: Platform) {
        this._platform = platform;
    }

    async init(manifestLocations: string[]): Promise<void> {
        this._themeMapping = {};
        for (const manifestLocation of manifestLocations) {
            const { body } = await this._platform
                .request(manifestLocation, {
                    method: "GET",
                    format: "json",
                    cache: true,
                })
                .response();
            this._populateThemeMap(body);
            /*
            After build has finished, the source section of each theme manifest
            contains `built-assets` which is a mapping from the theme-name to theme
            information which includes the location of the CSS file.
            (see type ThemeInformation above)
            */
            // Object.assign(this._themeMapping, body["source"]["built-assets"]);
            //Add the default-theme as an additional option to the mapping
            const defaultThemeId = this.getDefaultTheme();
            if (defaultThemeId) {
                const cssLocation = this._findThemeLocationFromId(defaultThemeId);
                if (cssLocation) {
                    this._themeMapping["Default"] = { id: "default", cssLocation };
                }
            }
        }
    }

    private _populateThemeMap(manifest) {
        const builtAssets: Record<string, string> = manifest.source?.["built-assets"];
        const themeName = manifest.name;
        let defaultDarkVariant: any = {}, defaultLightVariant: any = {};
        for (const [themeId, cssLocation] of Object.entries(builtAssets)) {
            const variant = themeId.match(/.+-(.+)/)?.[1];
            const { name: variantName, default: isDefault, dark } = manifest.values.variants[variant!];
            const themeDisplayName = `${themeName} ${variantName}`;
            if (isDefault) {
                /**
                 * This is a default variant!
                 * We'll add these to the themeMapping (separately) keyed with just the
                 * theme-name (i.e "Element" instead of "Element Dark").
                 * We need to be able to distinguish them from other variants!
                 * 
                 * This allows us to render radio-buttons with "dark" and
                 * "light" options.
                */
                const defaultVariant = dark ? defaultDarkVariant : defaultLightVariant;
                defaultVariant.variantName = variantName;
                defaultVariant.id = themeId
                defaultVariant.cssLocation = cssLocation;
                continue;
            }
            // Non-default variants are keyed in themeMapping with "theme_name variant_name"
            // eg: "Element Dark"
            this._themeMapping[themeDisplayName] = {
                cssLocation,
                id: themeId
            };
        }
        if (defaultDarkVariant.id && defaultLightVariant.id) {
            /**
             * As mentioned above, if there's both a default dark and a default light variant,
             * add them to themeMapping separately.
             */
            this._themeMapping[themeName] = { dark: defaultDarkVariant, light: defaultLightVariant };
        }
        else {
            /**
             * If only one default variant is found (i.e only dark default or light default but not both),
             * treat it like any other variant.
             */
            const variant = defaultDarkVariant.id ? defaultDarkVariant : defaultLightVariant;
            this._themeMapping[`${themeName} ${variant.variantName}`] = { id: variant.id, cssLocation: variant.cssLocation };
        }
    }

    setTheme(themeId: string, log?: ILogItem) {
        this._platform.logger.wrapOrRun(log, { l: "change theme", id: themeId }, () => {
            const themeLocation = this._findThemeLocationFromId(themeId);
            if (!themeLocation) {
                throw new Error(`Cannot find theme location for theme "${themeId}"!`);
            }
            this._platform.replaceStylesheet(themeLocation);
            this._platform.settingsStorage.setString("theme", themeId);
        });
    }

    get themeMapping(): Record<string, ThemeInformation> {
        return this._themeMapping;
    }

    async getActiveTheme(): Promise<string> {
        const theme = await this._platform.settingsStorage.getString("theme") ?? "default";
        if (theme) {
            return theme;
        }
        throw new Error("Cannot find active theme!");
    }

    getDefaultTheme(): string | undefined {
        switch (this.preferredColorScheme) {
            case ColorSchemePreference.Dark:
                return this._platform.config["defaultTheme"].dark;
            case ColorSchemePreference.Light:
                return this._platform.config["defaultTheme"].light;
        }
    }

    private _findThemeLocationFromId(themeId: string): string | undefined {
        for (const themeData of Object.values(this._themeMapping)) {
            if ("id" in themeData && themeData.id === themeId) {
                return themeData.cssLocation;
            }
            else if ("light" in themeData && themeData.light?.id === themeId) {
                return themeData.light.cssLocation;
            }
            else if ("dark" in themeData && themeData.dark?.id === themeId) {
                return themeData.dark.cssLocation;
            }
        }
    }

    get preferredColorScheme(): ColorSchemePreference {
        if (window.matchMedia("(prefers-color-scheme: dark)").matches) {
            return ColorSchemePreference.Dark;
        }
        else if (window.matchMedia("(prefers-color-scheme: light)").matches) {
            return ColorSchemePreference.Light;
        }
        throw new Error("Cannot find preferred colorscheme!");
    }

    async persistVariantToStorage(variant: string) {
        await this._platform.settingsStorage.setString("theme-variant", variant);
    }

    async getCurrentVariant(): Promise<string> {
        return await this._platform.settingsStorage.getString("theme-variant");
    }

    async removeVariantFromStorage(): Promise<void> {
        await this._platform.settingsStorage.remove("theme-variant");
    }
}