import 'package:device_plugin_interface/device_plugin_interface.dart';
import 'package:flutter/material.dart';
import 'package:get/get.dart';

import '../data/models/agent_module.dart';
export '../data/models/assistant_directive.dart' show DirectiveHandler;
import '../data/models/assistant_directive.dart';

/// Agent 能力模块的描述符——**模块自带行为**，不再靠中心 switch。
///
/// 一个模块 = `lib/modules/<name>/module.dart` 里导出的一个描述符，
/// 在 [ModuleRegistry] 里登记一行即可：
/// - 卡片元数据（沿用 [AgentModule]：标题/副标题/图标/渐变）
/// - [pages]：模块自带的路由，`AppPages` 会把它们拼进总表
/// - [entryRoute] / [onLaunch]：卡片点击去哪（二选一，优先 onLaunch）
/// - [requiredCapabilities]：需要在线设备具备的能力，空 = 不依赖设备
/// - [directives]：本模块能落地的端侧指令
/// - [translations]：模块自带的文案（按 locale，如 `zh_CN` / `en_US`），
///   与全局语言文件合并；新模块不必再去改 41 个语言文件
/// - [registerServices]：需要常驻服务时在这里 `Get.put`
///
/// `test/module_registry_test.dart` 守着：id 唯一、entryRoute 已注册、
/// 标题文案有落点。
class AgentModuleDescriptor extends AgentModule {
  AgentModuleDescriptor({
    required super.id,
    required super.title,
    super.subtitle,
    required super.icon,
    required super.gradient,
    this.requiredCapabilities = const {},
    super.comingSoon = false,
    this.pages = const [],
    this.entryRoute,
    this.onLaunch,
    this.directives = const {},
    this.translations = const {},
    this.registerServices,
    super.bailianAppId,
  }) : super(requiresDevice: requiredCapabilities.isNotEmpty);

  /// 需要在线设备具备的能力；空集合 = 手机自己就能用
  final Set<DeviceCapability> requiredCapabilities;

  /// 模块自带的页面
  final List<GetPage> pages;

  /// 卡片点击跳转的路由（无 [onLaunch] 时用）
  final String? entryRoute;

  /// 卡片点击的自定义动作（带闸门/提示逻辑的模块用它）
  final VoidCallback? onLaunch;

  /// 端侧指令 → 处理器
  final Map<String, DirectiveHandler> directives;

  /// 模块自带文案：`{'zh_CN': {...}, 'en_US': {...}}`
  final Map<String, Map<String, String>> translations;

  /// 常驻服务注册钩子（InitialBinding 之后调用一次）
  final void Function()? registerServices;

  /// 卡片点击：优先 [onLaunch]，其次 [entryRoute]；都没有返回 false 让调用方兜底
  bool launch() {
    if (onLaunch != null) {
      onLaunch!();
      return true;
    }
    if (entryRoute != null) {
      Get.toNamed(entryRoute!);
      return true;
    }
    return false;
  }
}