//
//  RDEPUBNavigatorState.swift
//  RDReaderView
//
//  EPUBCore 层导航状态机定义文件。
//  定义了阅读器导航器的状态枚举，状态流转遵循：
//  initializing → loading → idle ↔ jumping/moving/repaginating
//  由 RDEPUBReadingSession 管理状态跃迁，控制分页快照的应用时机。
//

import Foundation

/// 导航状态枚举，描述阅读器的当前操作状态
/// 状态机流转：initializing → loading → idle ↔ jumping/moving/repaginating
public enum RDEPUBNavigatorState: String, Codable {
    /// 初始化状态，刚打开书籍，等待初始恢复位置
    case initializing
    /// 加载状态，正在生成首轮分页模型
    case loading
    /// 空闲状态，显示稳定，可接受用户操作和快照应用
    case idle
    /// 跳转状态，正在执行目录/内部链接跳转
    case jumping
    /// 翻页状态，用户正在翻页操作中
    case moving
    /// 重排状态，正在重新分页（字号/横竖屏变化触发）
    case repaginating

    /// 是否处于可应用分页快照的稳定状态
    /// 只有 idle 状态才允许消费 staged snapshot
    public var isStableForSnapshotApplication: Bool {
        self == .idle
    }
}