驾驶舱模块化配置

interface CockpitConfig {
  modules?: {
    topBar?:      ModuleConfig & { features?: TopBarFeatures }
    mainLive?:    ModuleConfig & { features?: MainLiveFeatures }
    subLive?:     ModuleConfig & { features?: SubLiveFeatures }
    map?:         ModuleConfig & { features?: MapFeatures }
    deviceList?:  ModuleConfig & { features?: DeviceListFeatures }   // ⚠️ koc3 阶段默认隐藏，待后续放开
  }
  layout?:     LayoutConfig      // 布局配置
  theme?:      ThemeConfig       // 主题 token 覆盖（预留，当前版本未生效）
  extensions?: ExtensionConfig[] // 自定义插件扩展位（预留，当前版本未生效）
  liveScreen?: LiveScreenConfig  // N 路直播大屏（预留，当前版本未生效）
  waylinePlanUrl?: string   // 您的航线库/飞行任务创建页面地址（非必传）
  cameraAuthVerifyUrl?: string  // 您的外接摄像头验密页面地址（非必传）
}

interface ModuleConfig {
  visible?:  boolean   // 是否显示整个模块，默认 true
  gridCols?: number    // 网格列数（grid 布局时生效），默认 1
}

interface TopBarFeatures {
  deviceList?:    boolean                // 设备列表入口，默认 true ⚠️ koc3 阶段该入口默认隐藏（随 deviceList 模块一并后续放开），当前配置无可见效果
  alertRecord?:   boolean                // 告警记录，默认 true
  relayTask?:     boolean                // 任务接力，默认 true
  wayline?:       boolean                // 航线规划入口，默认 true
  droneStatus?:   boolean                // 飞机状态遥测条（延迟/图传/RTK/电量），默认 true
  layout?:        boolean                // 布局切换，默认 true（待实施）
  shortcutKey?:   boolean                // 快捷键说明，默认 true（待实施）
  settings?:      boolean                // 设置入口，默认 true（待实施）
  customButtons?: CockpitCustomButton[]  // 您的自定义按钮，渲染于顶栏右侧，默认 []
}

interface MainLiveFeatures {
  leftToolbar?:    FeatureToggle           // footer 竖向工具栏（云台/激光/AI/灯光，视觉最左），默认可见
  rightToolbar?:   FeatureToggle           // 相机参数/镜头/红外叠加层，默认可见
  flightControls?: FeatureToggle           // 飞行操控扩展区（右下角起飞/急停等），默认可见
  bottomLeftInfo?: FeatureToggle           // 左下角设备信息，默认可见
  overlay?:        FeatureToggle           // 画面叠加层（HUD 信息），默认可见
  gimbalTools?:    FeatureToggle           // 云台工具组（云台/变焦/激光/IR/AI/PSDK），默认可见（待实施）
  lightMode?:      FeatureToggle           // 灯光/特殊模式组（降落伞/爆闪灯等），默认可见（待实施）
  footerItems?: {                          // footer(leftToolbar 区) 逐项显隐；未配置的 key 默认全开
    gimbalSet?:       boolean              // 云台设置
    mouseFirstAngle?: boolean              // 鼠标优先角度
    spotOn?:          boolean              // 一键指点
    multiPayload?:    boolean              // 多负载控制
    laser?:           boolean              // 激光打点
    rng?:             boolean              // 激光测距（RNG）
    irThermometer?:   boolean              // 红外区域测温
    ai?:              boolean              // AI 目标识别 / 智能跟踪
    aiSearch?:        boolean              // AI 大模型搜索
    ea700?:           boolean              // 妙算 3（EA700）
    psdk?:            boolean              // PSDK 入口
    parachute?:       boolean              // 降落伞
    ar?:              boolean              // AR 投射
    flashLed?:        boolean              // 爆闪灯
    nightLight?:      boolean              // 夜航灯
    stealthMode?:     boolean              // 隐蔽模式
    fts?:             boolean              // 飞行终止系统（FTS）
    customButtons?:   CockpitCustomButton[] // 您的自定义按钮，渲染于 footer(leftToolbar 区)，默认 []
  }                                        // 最终可见 = 组开关(gimbalTools/lightMode) && 该 item && 设备能力
}

// FeatureToggle 类型
interface FeatureToggle {
  visible?: boolean   // 是否可见，默认 true
}

interface SubLiveFeatures {
  dockLive?:      boolean   // 机场直播 Tab，默认 true
  assistantLive?: boolean   // 遥控器直播 Tab，默认 true
  customTabs?:    Array<{   // 您的自定义 Tab（待实施）
    id:          string     // Tab 唯一标识
    label:       string     // Tab 显示名称
    componentId: string     // 组件 ID（与插件中心注册的组件名对应）
  }>
}

interface MapFeatures {
  drawTools?:   boolean   // 画点线面圆（待实施）
  search?:      boolean   // 地图搜索（待实施）
  layerSwitch?: boolean   // 图层切换（待实施）
  measure?:     boolean   // 测距（待实施）
  fullscreen?:  boolean   // 全屏（待实施）
}

interface DeviceListFeatures {
  deviceCard?:      boolean   // 设备卡片，默认 true
  addRemoveDevice?: boolean   // 添加/移除设备按钮，默认 true
  filter?:          boolean   // 过滤，默认 true（待实施）
  sort?:            boolean   // 排序，默认 true（待实施）
}

interface CockpitCustomButton {
  id:          string       // 必填。按钮唯一标识（同一区域 id 不可重复）
  name:        string       // 必填。按钮名称（显示于图标下方或 Tooltip 中）
  tips?:       string       // 可选。鼠标 hover 时的提示文字
  iconUrl?:    string       // 可选。图标图片 URL；缺省时显示 name 首字
  forwardUrl?: string       // 可选。点击后跳转的 URL（仅支持 http/https）
  cb?:         () => void   // 可选。点击回调函数
}

interface LayoutConfig {
  mode?:            'splitpanes' | 'grid'   // 布局模式，默认 'splitpanes'
  splitRatios?: {
    primary?:   number   // 主区域宽度比例（0-100），默认 70
    secondary?: number   // 辅区域宽度比例（0-100），默认 30
    map?:       number   // 地图高度比例（0-100），默认 55
    subLive?:   number   // 辅视频高度比例（0-100），默认 45
  }
  defaultMainView?: 'main' | 'map' | 'sub_live'   // 默认主视图，默认 'main'
}