///|
/// MoonDES 通用离散事件仿真引擎
///
/// 基于 MoonBit 构建的通用离散事件仿真底座，提供五层模块化架构：
/// - Core 仿真内核层：事件队列、仿真环境、主循环
/// - Process 协程进程调度层：进程创建、延时、等待
/// - Resource 资源管理层：独占/容量/抢占三类资源
/// - Experiment 实验管理层：批量仿真、快照、参数遍历
/// - Plugin 插件接口层：标准化扩展接口
///
/// # Example
/// ```mbt check
/// test {
///   let env = @core.new_env(until=10.0)
///   let log : Array[String] = []
///   ignore(env.schedule(time=2.0, callback=fn() { log.push("hello") }))
///   env.run()
///   assert_eq(log.length(), 1)
/// }
/// ```
pub fn version() -> String {
  "0.1.0"
}

///|
/// 创建仿真环境（便捷入口，转发至 core 层）
pub fn new_env(until~ : Double) -> @core.SimulationEnv {
  @core.new_env(until~)
}

///|
/// 创建实验配置（便捷入口，转发至 experiment 层）
pub fn new_config(until~ : Double, seed? : Int = 0) -> @experiment.ExpConfig {
  @experiment.new_config(until~, seed~)
}

///|
/// 创建独占式资源（便捷入口，转发至 resource 层）
pub fn new_exclusive(name~ : String) -> @resource.Resource {
  @resource.new_exclusive(name~)
}

///|
/// 创建进程（便捷入口，转发至 process 层）
///
/// behavior 返回 `ProcessAction` 描述进程的下一步行为：
/// - `Done`：进程完成
/// - `Timeout(duration=, next=)`：延时后执行 next
/// - `WaitEvent(event=, next=)`：等待事件后执行 next
/// - `Terminate`：立即终止
pub fn process(
  env : @core.SimulationEnv,
  name? : String = "anonymous",
  behavior~ : (@process.Process) -> @process.ProcessAction,
) -> @process.Process {
  @process.process(env, name~, behavior~)
}

///|
/// 创建插件管理器（便捷入口，转发至 plugin 层）
pub fn new_plugin_manager() -> @plugin.PluginManager {
  @plugin.new_manager()
}