/**
 * @file Window.h
 * @brief 跨模块窗口句柄对象与基础窗口操作接口。
 * @details
 * window 是平台层窗口对象的轻量包装，向上层提供：
 * - 全屏切换、标题设置、尺寸调整；
 * - 原生窗口句柄访问；
 * - 关闭状态与尺寸查询。
 * 具体平台行为由 PlatformWin32.cpp 等实现体完成。
 */
#pragma once
#include "CommonHeader.h"


namespace XEngine::platform {
/**
 * @brief 窗口强类型标识符。
 */
DEFINE_TYPED_ID(window_id);

/**
 * @brief 平台窗口句柄对象。
 */
class window
{
public:
	/**
	 * @brief 由窗口 ID 构造句柄。
	 * @param id 窗口 ID。
	 */
	constexpr explicit window(window_id id) : _id{ id } {}
	/**
	 * @brief 构造无效窗口句柄。
	 */
	constexpr window() = default;
	/**
	 * @brief 获取窗口 ID。
	 * @return 窗口 ID。
	 */
	constexpr window_id get_id() const { return _id; }
	/**
	 * @brief 判断窗口句柄是否有效。
	 * @return 有效返回 true。
	 */
	constexpr bool is_valid() const { return id::is_valid(_id); }


	/**
	 * @brief 设置全屏状态。
	 * @param is_fullscreen true 表示全屏。
	 */
	void set_fullscreen(bool is_fullscreen) const;
	/**
	 * @brief 查询是否全屏。
	 * @return 全屏返回 true。
	 */
	bool is_fullscreen() const;
	/**
	 * @brief 获取原生窗口句柄。
	 * @return 平台句柄指针。
	 */
	void* handle() const;
	/**
	 * @brief 设置窗口标题文本。
	 * @param caption 标题字符串。
	 */
	void set_caption(const wchar_t* caption) const;
	/**
	 * @brief 获取窗口矩形坐标。
	 * @return 左上右下坐标向量。
	 */
	math::u32v4 size() const;
	/**
	 * @brief 调整窗口大小。
	 * @param width 目标宽度。
	 * @param height 目标高度。
	 */
	void resize(u32 width, u32 height)const;
	/**
	 * @brief 获取窗口宽度。
	 * @return 宽度像素值。
	 */
	u32 width()const;
	/**
	 * @brief 获取窗口高度。
	 * @return 高度像素值。
	 */
	u32 height()const;
	/**
	 * @brief 查询窗口是否已关闭。
	 * @return 已关闭返回 true。
	 */
	bool is_closed()const;

private:
	window_id _id{ id::invalid_id };

};
}