<?php

declare(strict_types=1);

namespace Glacier\Controllers;

use Glacier\Core\Logger;
use Glacier\Core\Response;
use Glacier\Core\View;

/**
 * 首页控制器（本期"开发中"占位；后期公司新闻 + 功能导航）。
 * 脚本只产出数据，渲染交给 Twig 模板（见 docs/architecture.md §3.3）。
 */
final class HomeController
{
    public function index(array $params = []): never
    {
        Response::html(View::render('home/index.html.twig'));
    }

    /** 参数路由演示（P1 验证用，后续移除）。 */
    public function demo(array $params = []): never
    {
        Logger::info('demo route hit', ['name' => $params['name'] ?? '']);
        Response::html(View::render('home/demo.html.twig', [
            'name' => $params['name'] ?? '',
        ]));
    }

    /** 可选段演示（P1 验证用，后续移除）。 */
    public function demoPage(array $params = []): never
    {
        Response::html(View::render('home/demo_page.html.twig', [
            'page' => $params['page'] ?? '1',
        ]));
    }

    /** 受保护页（P5 验证 auth 中间件挂载；登录体系 P7 实现）。 */
    public function protectedPage(array $params = []): never
    {
        Response::html(View::render('home/protected.html.twig'));
    }
}