<?php
// ============================================
// 文件: lib/theme.php
// 说明: 界面配色主题（5 套经典配色）。
//
//       主题是**每个账号自己的偏好**，存在 admins.theme 里（空 = 用默认主题）。
//       颜色本身全部定义在 css/themes.css 的 [data-theme="<key>"] 规则里，
//       本文件只负责「有哪些主题 / 当前用哪套 / 页面上怎么声明」，
//       不重复存一份色值（唯一例外是下面 themeCatalog() 里给选色卡片用的
//       一段渐变缩略图，那是纯装饰，不参与页面配色）。
//
//       页面接入方式（每个页面的 <html> 与样式表各加一处）：
//         1) <html lang="zh-CN"> 上紧跟着输出 themeAttr() 的返回值（它自带一个前导空格）；
//         2) css/style.css 的 link 之后，再输出一行 themesCssLink()。
//       themes.css 必须排在 style.css 之后 —— [data-theme] 与 style.css 里
//       作为兜底的 :root 优先级相同，靠「后出现者胜」来覆盖。
//
//       注意：上面两行说明里**故意不写 PHP 短标签**。PHP 的「问号 + 右尖括号」
//       在 // 注释里同样会关闭 PHP 模式，之后若再出现「左尖括号 + 问号 + 等号」
//       就会被真的执行 —— 注释里写出完整标签示例，本文件被 require 时会直接
//       Fatal error，而 php -l 是查不出来的（它只看语法，不看语义）。
// ============================================

// 主题注册表：key => [显示名, 一句话描述, 明暗]
// 想加主题：这里加一项，并在 css/themes.css 里补一个同 key 的 [data-theme] 规则块
// （规则块里那一组变量一个都不能少，缺哪个就会退回 style.css 的默认值）。
function themeCatalog() {
    static $catalog = null;
    if ($catalog === null) {
        $catalog = [
            'ticket' => [
                'name'   => '复古票根',
                'desc'   => '暖橙 · 默认配色',
                'scheme' => 'light',
            ],
            'indigo' => [
                'name'   => '靛蓝',
                'desc'   => '经典蓝 · 清爽利落',
                'scheme' => 'light',
            ],
            'forest' => [
                'name'   => '松林',
                'desc'   => '墨绿 · 沉静耐看',
                'scheme' => 'light',
            ],
            'wine' => [
                'name'   => '绛红',
                'desc'   => '酒红 · 复古胶片',
                'scheme' => 'light',
            ],
            'midnight' => [
                'name'   => '暗夜',
                'desc'   => '深色 · 靛紫点缀',
                'scheme' => 'dark',
            ],
        ];
    }
    return $catalog;
}

// 默认主题（没选过 / 选的 key 不认识了，都落到它上面）
function defaultThemeKey() {
    return 'ticket';
}

// key 是否有效
function isValidTheme($key) {
    return is_string($key) && isset(themeCatalog()[$key]);
}

// 取某套主题的元信息；非法 key 返回默认主题的（页面渲染不该因为脏数据而炸）
function themeInfo($key) {
    $catalog = themeCatalog();
    return isValidTheme($key) ? $catalog[$key] : $catalog[defaultThemeKey()];
}

// 当前生效的主题 key。
// 优先读 session（登录时/切换主题时写入），session 里还没有就回库里补一次 ——
// 这样「本次升级之前就已经登录着」的会话也能立刻用上自己账号存的主题。
function currentThemeKey() {
    if (!isset($_SESSION['admin_theme'])) {
        $theme = '';
        if (!empty($_SESSION['admin_id'])) {
            $db = getDB();
            $stmt = $db->prepare("SELECT theme FROM admins WHERE id = ?");
            $stmt->execute([(int)$_SESSION['admin_id']]);
            // 用 fetchAll 取：只取一行就放着不读完，游标会一直挂着共享读锁（本项目踩过）
            $rows = $stmt->fetchAll();
            if ($rows && isset($rows[0]['theme'])) {
                $theme = (string)$rows[0]['theme'];
            }
        }
        $_SESSION['admin_theme'] = $theme;
    }
    $key = (string)$_SESSION['admin_theme'];
    return isValidTheme($key) ? $key : defaultThemeKey();
}

// <html> 上要输出的主题属性。始终输出（默认主题也输出），
// 这样每个页面用的都是 themes.css 里那个明确的调色板，不用去猜 style.css 的兜底值。
function themeAttr() {
    return ' data-theme="' . h(currentThemeKey()) . '"';
}

// 主题样式表。必须放在 css/style.css 之后。
//
// 末尾**带一个换行符**：PHP 会吃掉「结束标签」后面紧跟的那一个换行。
// 模板里把这个返回值单独放一行再换行的话，渲染结果会变成这一行和下一行黏在一起
// （HTML 上无害，但会让 HTML 结构对比工具误判，也没必要）。这里补回来。
function themesCssLink() {
    return '<link rel="stylesheet" href="css/themes.css">' . "\n";
}