@tx5dr/contracts 1.2.0

package/dist/schema/radio-capability.schema.d.ts

@@ -0,0 +1,625 @@
+import { z } from 'zod';
+/**
+ * 能力分类
+ * - antenna: 天线相关（天调等）
+ * - rf: 射频相关（发射功率、噪声抑制等）
+ * - audio: 音频相关（AF 增益、静噪、VOX 等）
+ * - operation: 操作过程相关（RIT/XIT、中继偏移、音调等）
+ * - system: 电台系统状态（锁定、电源等）
+ */
+export declare const CapabilityCategorySchema: z.ZodEnum<["antenna", "rf", "audio", "operation", "system"]>;
+export type CapabilityCategory = z.infer<typeof CapabilityCategorySchema>;
+/**
+ * 能力值类型
+ * - boolean: 布尔开关
+ * - number: 数值（滑块/输入框）
+ * - enum: 枚举（下拉选择）
+ * - action: 纯动作按钮（无持久值，如手动调谐）
+ */
+export declare const CapabilityValueTypeSchema: z.ZodEnum<["boolean", "number", "enum", "action"]>;
+export type CapabilityValueType = z.infer<typeof CapabilityValueTypeSchema>;
+/**
+ * 能力更新模式
+ * - polling: 服务端定时轮询检测变化
+ * - event: 由电台事件驱动（如连接时一次性读取）
+ * - none: 不主动更新（action 类或只写能力）
+ */
+export declare const CapabilityUpdateModeSchema: z.ZodEnum<["polling", "event", "none"]>;
+export type CapabilityUpdateMode = z.infer<typeof CapabilityUpdateModeSchema>;
+/**
+ * 枚举项可用值类型。
+ */
+export declare const CapabilityOptionValueSchema: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+export type CapabilityOptionValue = z.infer<typeof CapabilityOptionValueSchema>;
+/**
+ * 运行时能力值。
+ */
+export declare const CapabilityValueSchema: z.ZodUnion<[z.ZodBoolean, z.ZodNumber, z.ZodString]>;
+export type CapabilityValue = z.infer<typeof CapabilityValueSchema>;
+/**
+ * 枚举项定义。
+ */
+export declare const CapabilityOptionSchema: z.ZodObject<{
+    value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    label: z.ZodOptional<z.ZodString>;
+    labelI18nKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    value: string | number;
+    label?: string | undefined;
+    labelI18nKey?: string | undefined;
+}, {
+    value: string | number;
+    label?: string | undefined;
+    labelI18nKey?: string | undefined;
+}>;
+export type CapabilityOption = z.infer<typeof CapabilityOptionSchema>;
+/**
+ * 前端展示模式。
+ */
+export declare const CapabilityDisplayModeSchema: z.ZodEnum<["percent", "value"]>;
+export type CapabilityDisplayMode = z.infer<typeof CapabilityDisplayModeSchema>;
+export declare const CapabilityDisplayUnitSchema: z.ZodEnum<["Hz", "kHz", "toneHz", "code", "state"]>;
+export type CapabilityDisplayUnit = z.infer<typeof CapabilityDisplayUnitSchema>;
+/**
+ * 展示格式提示，由服务端下发给前端。
+ */
+export declare const CapabilityDisplaySchema: z.ZodObject<{
+    mode: z.ZodEnum<["percent", "value"]>;
+    unit: z.ZodOptional<z.ZodEnum<["Hz", "kHz", "toneHz", "code", "state"]>>;
+    decimals: z.ZodOptional<z.ZodNumber>;
+    signed: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    mode: "value" | "percent";
+    unit?: "code" | "state" | "Hz" | "kHz" | "toneHz" | undefined;
+    decimals?: number | undefined;
+    signed?: boolean | undefined;
+}, {
+    mode: "value" | "percent";
+    unit?: "code" | "state" | "Hz" | "kHz" | "toneHz" | undefined;
+    decimals?: number | undefined;
+    signed?: boolean | undefined;
+}>;
+export type CapabilityDisplay = z.infer<typeof CapabilityDisplaySchema>;
+/**
+ * 能力描述符
+ * 由服务端在运行时下发，作为当前连接会话的真源。
+ */
+export declare const CapabilityDescriptorSchema: z.ZodObject<{
+    /** 全局唯一能力 ID，如 'tuner_switch', 'rf_power', 'lock_mode' */
+    id: z.ZodString;
+    /** 能力分类，用于前端面板分组渲染 */
+    category: z.ZodEnum<["antenna", "rf", "audio", "operation", "system"]>;
+    /** 能力值类型 */
+    valueType: z.ZodEnum<["boolean", "number", "enum", "action"]>;
+    /**
+     * 数值范围（仅 valueType='number' 时有效）
+     * 值可以是归一化范围（如 0-1），也可以是实际范围（如 -9999~9999 Hz）
+     */
+    range: z.ZodOptional<z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+        step: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        min: number;
+        max: number;
+        step?: number | undefined;
+    }, {
+        min: number;
+        max: number;
+        step?: number | undefined;
+    }>>;
+    /**
+     * 数值能力的离散候选项（仅 valueType='number' 时有效）
+     * 例：RF 功率只允许若干固定挡位，但仍希望保留 slider 交互。
+     */
+    discreteOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        label: z.ZodOptional<z.ZodString>;
+        labelI18nKey: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string | number;
+        label?: string | undefined;
+        labelI18nKey?: string | undefined;
+    }, {
+        value: string | number;
+        label?: string | undefined;
+        labelI18nKey?: string | undefined;
+    }>, "many">>;
+    /** 枚举项（仅 valueType='enum' 时有效） */
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        label: z.ZodOptional<z.ZodString>;
+        labelI18nKey: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string | number;
+        label?: string | undefined;
+        labelI18nKey?: string | undefined;
+    }, {
+        value: string | number;
+        label?: string | undefined;
+        labelI18nKey?: string | undefined;
+    }>, "many">>;
+    /** 是否可读取当前值（false = 只写，UI 无初始值） */
+    readable: z.ZodBoolean;
+    /** 是否可写入（false = 只读展示） */
+    writable: z.ZodBoolean;
+    /** 服务端更新策略 */
+    updateMode: z.ZodEnum<["polling", "event", "none"]>;
+    /**
+     * 轮询间隔（ms），仅 updateMode='polling' 时有效。
+     */
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+    /**
+     * 复合能力分组 ID。
+     * 同一 group 的描述符在面板中合并为一张卡片（如天调开关和手动调谐按钮）
+     */
+    compoundGroup: z.ZodOptional<z.ZodString>;
+    /**
+     * 在复合能力组中的角色
+     * - switch: 布尔开关（主控制）
+     * - action: 动作按钮
+     */
+    compoundRole: z.ZodOptional<z.ZodEnum<["switch", "action"]>>;
+    /** 前端标签 i18n key，如 'radio:capability.tuner_switch.label' */
+    labelI18nKey: z.ZodString;
+    /** 前端描述文字 i18n key（可选） */
+    descriptionI18nKey: z.ZodOptional<z.ZodString>;
+    /** 展示格式提示 */
+    display: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodEnum<["percent", "value"]>;
+        unit: z.ZodOptional<z.ZodEnum<["Hz", "kHz", "toneHz", "code", "state"]>>;
+        decimals: z.ZodOptional<z.ZodNumber>;
+        signed: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "value" | "percent";
+        unit?: "code" | "state" | "Hz" | "kHz" | "toneHz" | undefined;
+        decimals?: number | undefined;
+        signed?: boolean | undefined;
+    }, {
+        mode: "value" | "percent";
+        unit?: "code" | "state" | "Hz" | "kHz" | "toneHz" | undefined;
+        decimals?: number | undefined;
+        signed?: boolean | undefined;
+    }>>;
+    /** 是否在 RadioControl 工具栏 surface 区域露出紧凑控件 */
+    hasSurfaceControl: z.ZodBoolean;
+    /**
+     * surface 控件的分组 ID。
+     * 同一 surfaceGroup 的控件聚合为一个 Popover（如天调开关和调谐按钮）
+     */
+    surfaceGroup: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    labelI18nKey: string;
+    category: "audio" | "system" | "antenna" | "rf" | "operation";
+    valueType: "number" | "boolean" | "action" | "enum";
+    readable: boolean;
+    writable: boolean;
+    updateMode: "none" | "polling" | "event";
+    hasSurfaceControl: boolean;
+    options?: {
+        value: string | number;
+        label?: string | undefined;
+        labelI18nKey?: string | undefined;
+    }[] | undefined;
+    range?: {
+        min: number;
+        max: number;
+        step?: number | undefined;
+    } | undefined;
+    discreteOptions?: {
+        value: string | number;
+        label?: string | undefined;
+        labelI18nKey?: string | undefined;
+    }[] | undefined;
+    pollIntervalMs?: number | undefined;
+    compoundGroup?: string | undefined;
+    compoundRole?: "action" | "switch" | undefined;
+    descriptionI18nKey?: string | undefined;
+    display?: {
+        mode: "value" | "percent";
+        unit?: "code" | "state" | "Hz" | "kHz" | "toneHz" | undefined;
+        decimals?: number | undefined;
+        signed?: boolean | undefined;
+    } | undefined;
+    surfaceGroup?: string | undefined;
+}, {
+    id: string;
+    labelI18nKey: string;
+    category: "audio" | "system" | "antenna" | "rf" | "operation";
+    valueType: "number" | "boolean" | "action" | "enum";
+    readable: boolean;
+    writable: boolean;
+    updateMode: "none" | "polling" | "event";
+    hasSurfaceControl: boolean;
+    options?: {
+        value: string | number;
+        label?: string | undefined;
+        labelI18nKey?: string | undefined;
+    }[] | undefined;
+    range?: {
+        min: number;
+        max: number;
+        step?: number | undefined;
+    } | undefined;
+    discreteOptions?: {
+        value: string | number;
+        label?: string | undefined;
+        labelI18nKey?: string | undefined;
+    }[] | undefined;
+    pollIntervalMs?: number | undefined;
+    compoundGroup?: string | undefined;
+    compoundRole?: "action" | "switch" | undefined;
+    descriptionI18nKey?: string | undefined;
+    display?: {
+        mode: "value" | "percent";
+        unit?: "code" | "state" | "Hz" | "kHz" | "toneHz" | undefined;
+        decimals?: number | undefined;
+        signed?: boolean | undefined;
+    } | undefined;
+    surfaceGroup?: string | undefined;
+}>;
+export type CapabilityDescriptor = z.infer<typeof CapabilityDescriptorSchema>;
+/**
+ * 能力运行时状态
+ * 动态数据，通过 WebSocket 实时同步到前端。
+ */
+export declare const CapabilityStateSchema: z.ZodObject<{
+    /** 能力 ID，与 CapabilityDescriptor.id 对应 */
+    id: z.ZodString;
+    /** 当前连接的电台是否支持此能力（探测结果） */
+    supported: z.ZodBoolean;
+    /**
+     * 当前值
+     * - boolean 类能力：true/false
+     * - number 类能力：数值（范围由 descriptor.range 定义）
+     * - enum 类能力：string/number（必须落在 descriptor.options 内）
+     * - action 类能力：始终为 null
+     */
+    value: z.ZodNullable<z.ZodUnion<[z.ZodBoolean, z.ZodNumber, z.ZodString]>>;
+    /**
+     * 附加元数据（能力特有信息）
+     * 例：tuner_switch 的 meta 可携带 { status: 'tuning' | 'idle' | 'success' | 'failed', swr?: number }
+     */
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** 最后更新时间戳（ms） */
+    updatedAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    value: string | number | boolean | null;
+    id: string;
+    supported: boolean;
+    updatedAt: number;
+    meta?: Record<string, unknown> | undefined;
+}, {
+    value: string | number | boolean | null;
+    id: string;
+    supported: boolean;
+    updatedAt: number;
+    meta?: Record<string, unknown> | undefined;
+}>;
+export type CapabilityState = z.infer<typeof CapabilityStateSchema>;
+/**
+ * 能力列表快照（radioCapabilityList WS 消息 / REST 响应的 data 部分）
+ */
+export declare const CapabilityListSchema: z.ZodObject<{
+    descriptors: z.ZodArray<z.ZodObject<{
+        /** 全局唯一能力 ID，如 'tuner_switch', 'rf_power', 'lock_mode' */
+        id: z.ZodString;
+        /** 能力分类，用于前端面板分组渲染 */
+        category: z.ZodEnum<["antenna", "rf", "audio", "operation", "system"]>;
+        /** 能力值类型 */
+        valueType: z.ZodEnum<["boolean", "number", "enum", "action"]>;
+        /**
+         * 数值范围（仅 valueType='number' 时有效）
+         * 值可以是归一化范围（如 0-1），也可以是实际范围（如 -9999~9999 Hz）
+         */
+        range: z.ZodOptional<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+            step: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            min: number;
+            max: number;
+            step?: number | undefined;
+        }, {
+            min: number;
+            max: number;
+            step?: number | undefined;
+        }>>;
+        /**
+         * 数值能力的离散候选项（仅 valueType='number' 时有效）
+         * 例：RF 功率只允许若干固定挡位，但仍希望保留 slider 交互。
+         */
+        discreteOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            label: z.ZodOptional<z.ZodString>;
+            labelI18nKey: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            value: string | number;
+            label?: string | undefined;
+            labelI18nKey?: string | undefined;
+        }, {
+            value: string | number;
+            label?: string | undefined;
+            labelI18nKey?: string | undefined;
+        }>, "many">>;
+        /** 枚举项（仅 valueType='enum' 时有效） */
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            label: z.ZodOptional<z.ZodString>;
+            labelI18nKey: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            value: string | number;
+            label?: string | undefined;
+            labelI18nKey?: string | undefined;
+        }, {
+            value: string | number;
+            label?: string | undefined;
+            labelI18nKey?: string | undefined;
+        }>, "many">>;
+        /** 是否可读取当前值（false = 只写，UI 无初始值） */
+        readable: z.ZodBoolean;
+        /** 是否可写入（false = 只读展示） */
+        writable: z.ZodBoolean;
+        /** 服务端更新策略 */
+        updateMode: z.ZodEnum<["polling", "event", "none"]>;
+        /**
+         * 轮询间隔（ms），仅 updateMode='polling' 时有效。
+         */
+        pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+        /**
+         * 复合能力分组 ID。
+         * 同一 group 的描述符在面板中合并为一张卡片（如天调开关和手动调谐按钮）
+         */
+        compoundGroup: z.ZodOptional<z.ZodString>;
+        /**
+         * 在复合能力组中的角色
+         * - switch: 布尔开关（主控制）
+         * - action: 动作按钮
+         */
+        compoundRole: z.ZodOptional<z.ZodEnum<["switch", "action"]>>;
+        /** 前端标签 i18n key，如 'radio:capability.tuner_switch.label' */
+        labelI18nKey: z.ZodString;
+        /** 前端描述文字 i18n key（可选） */
+        descriptionI18nKey: z.ZodOptional<z.ZodString>;
+        /** 展示格式提示 */
+        display: z.ZodOptional<z.ZodObject<{
+            mode: z.ZodEnum<["percent", "value"]>;
+            unit: z.ZodOptional<z.ZodEnum<["Hz", "kHz", "toneHz", "code", "state"]>>;
+            decimals: z.ZodOptional<z.ZodNumber>;
+            signed: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "value" | "percent";
+            unit?: "code" | "state" | "Hz" | "kHz" | "toneHz" | undefined;
+            decimals?: number | undefined;
+            signed?: boolean | undefined;
+        }, {
+            mode: "value" | "percent";
+            unit?: "code" | "state" | "Hz" | "kHz" | "toneHz" | undefined;
+            decimals?: number | undefined;
+            signed?: boolean | undefined;
+        }>>;
+        /** 是否在 RadioControl 工具栏 surface 区域露出紧凑控件 */
+        hasSurfaceControl: z.ZodBoolean;
+        /**
+         * surface 控件的分组 ID。
+         * 同一 surfaceGroup 的控件聚合为一个 Popover（如天调开关和调谐按钮）
+         */
+        surfaceGroup: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        labelI18nKey: string;
+        category: "audio" | "system" | "antenna" | "rf" | "operation";
+        valueType: "number" | "boolean" | "action" | "enum";
+        readable: boolean;
+        writable: boolean;
+        updateMode: "none" | "polling" | "event";
+        hasSurfaceControl: boolean;
+        options?: {
+            value: string | number;
+            label?: string | undefined;
+            labelI18nKey?: string | undefined;
+        }[] | undefined;
+        range?: {
+            min: number;
+            max: number;
+            step?: number | undefined;
+        } | undefined;
+        discreteOptions?: {
+            value: string | number;
+            label?: string | undefined;
+            labelI18nKey?: string | undefined;
+        }[] | undefined;
+        pollIntervalMs?: number | undefined;
+        compoundGroup?: string | undefined;
+        compoundRole?: "action" | "switch" | undefined;
+        descriptionI18nKey?: string | undefined;
+        display?: {
+            mode: "value" | "percent";
+            unit?: "code" | "state" | "Hz" | "kHz" | "toneHz" | undefined;
+            decimals?: number | undefined;
+            signed?: boolean | undefined;
+        } | undefined;
+        surfaceGroup?: string | undefined;
+    }, {
+        id: string;
+        labelI18nKey: string;
+        category: "audio" | "system" | "antenna" | "rf" | "operation";
+        valueType: "number" | "boolean" | "action" | "enum";
+        readable: boolean;
+        writable: boolean;
+        updateMode: "none" | "polling" | "event";
+        hasSurfaceControl: boolean;
+        options?: {
+            value: string | number;
+            label?: string | undefined;
+            labelI18nKey?: string | undefined;
+        }[] | undefined;
+        range?: {
+            min: number;
+            max: number;
+            step?: number | undefined;
+        } | undefined;
+        discreteOptions?: {
+            value: string | number;
+            label?: string | undefined;
+            labelI18nKey?: string | undefined;
+        }[] | undefined;
+        pollIntervalMs?: number | undefined;
+        compoundGroup?: string | undefined;
+        compoundRole?: "action" | "switch" | undefined;
+        descriptionI18nKey?: string | undefined;
+        display?: {
+            mode: "value" | "percent";
+            unit?: "code" | "state" | "Hz" | "kHz" | "toneHz" | undefined;
+            decimals?: number | undefined;
+            signed?: boolean | undefined;
+        } | undefined;
+        surfaceGroup?: string | undefined;
+    }>, "many">;
+    capabilities: z.ZodArray<z.ZodObject<{
+        /** 能力 ID，与 CapabilityDescriptor.id 对应 */
+        id: z.ZodString;
+        /** 当前连接的电台是否支持此能力（探测结果） */
+        supported: z.ZodBoolean;
+        /**
+         * 当前值
+         * - boolean 类能力：true/false
+         * - number 类能力：数值（范围由 descriptor.range 定义）
+         * - enum 类能力：string/number（必须落在 descriptor.options 内）
+         * - action 类能力：始终为 null
+         */
+        value: z.ZodNullable<z.ZodUnion<[z.ZodBoolean, z.ZodNumber, z.ZodString]>>;
+        /**
+         * 附加元数据（能力特有信息）
+         * 例：tuner_switch 的 meta 可携带 { status: 'tuning' | 'idle' | 'success' | 'failed', swr?: number }
+         */
+        meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /** 最后更新时间戳（ms） */
+        updatedAt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        value: string | number | boolean | null;
+        id: string;
+        supported: boolean;
+        updatedAt: number;
+        meta?: Record<string, unknown> | undefined;
+    }, {
+        value: string | number | boolean | null;
+        id: string;
+        supported: boolean;
+        updatedAt: number;
+        meta?: Record<string, unknown> | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    capabilities: {
+        value: string | number | boolean | null;
+        id: string;
+        supported: boolean;
+        updatedAt: number;
+        meta?: Record<string, unknown> | undefined;
+    }[];
+    descriptors: {
+        id: string;
+        labelI18nKey: string;
+        category: "audio" | "system" | "antenna" | "rf" | "operation";
+        valueType: "number" | "boolean" | "action" | "enum";
+        readable: boolean;
+        writable: boolean;
+        updateMode: "none" | "polling" | "event";
+        hasSurfaceControl: boolean;
+        options?: {
+            value: string | number;
+            label?: string | undefined;
+            labelI18nKey?: string | undefined;
+        }[] | undefined;
+        range?: {
+            min: number;
+            max: number;
+            step?: number | undefined;
+        } | undefined;
+        discreteOptions?: {
+            value: string | number;
+            label?: string | undefined;
+            labelI18nKey?: string | undefined;
+        }[] | undefined;
+        pollIntervalMs?: number | undefined;
+        compoundGroup?: string | undefined;
+        compoundRole?: "action" | "switch" | undefined;
+        descriptionI18nKey?: string | undefined;
+        display?: {
+            mode: "value" | "percent";
+            unit?: "code" | "state" | "Hz" | "kHz" | "toneHz" | undefined;
+            decimals?: number | undefined;
+            signed?: boolean | undefined;
+        } | undefined;
+        surfaceGroup?: string | undefined;
+    }[];
+}, {
+    capabilities: {
+        value: string | number | boolean | null;
+        id: string;
+        supported: boolean;
+        updatedAt: number;
+        meta?: Record<string, unknown> | undefined;
+    }[];
+    descriptors: {
+        id: string;
+        labelI18nKey: string;
+        category: "audio" | "system" | "antenna" | "rf" | "operation";
+        valueType: "number" | "boolean" | "action" | "enum";
+        readable: boolean;
+        writable: boolean;
+        updateMode: "none" | "polling" | "event";
+        hasSurfaceControl: boolean;
+        options?: {
+            value: string | number;
+            label?: string | undefined;
+            labelI18nKey?: string | undefined;
+        }[] | undefined;
+        range?: {
+            min: number;
+            max: number;
+            step?: number | undefined;
+        } | undefined;
+        discreteOptions?: {
+            value: string | number;
+            label?: string | undefined;
+            labelI18nKey?: string | undefined;
+        }[] | undefined;
+        pollIntervalMs?: number | undefined;
+        compoundGroup?: string | undefined;
+        compoundRole?: "action" | "switch" | undefined;
+        descriptionI18nKey?: string | undefined;
+        display?: {
+            mode: "value" | "percent";
+            unit?: "code" | "state" | "Hz" | "kHz" | "toneHz" | undefined;
+            decimals?: number | undefined;
+            signed?: boolean | undefined;
+        } | undefined;
+        surfaceGroup?: string | undefined;
+    }[];
+}>;
+export type CapabilityList = z.infer<typeof CapabilityListSchema>;
+/**
+ * 写命令负载（writeRadioCapability WS 命令的 data 部分）
+ */
+export declare const WriteCapabilityPayloadSchema: z.ZodObject<{
+    /** 能力 ID */
+    id: z.ZodString;
+    /** 写入值（boolean/number/enum 类能力） */
+    value: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber, z.ZodString]>>;
+    /** 触发动作（action 类能力，传 true） */
+    action: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    value?: string | number | boolean | undefined;
+    action?: boolean | undefined;
+}, {
+    id: string;
+    value?: string | number | boolean | undefined;
+    action?: boolean | undefined;
+}>;
+export type WriteCapabilityPayload = z.infer<typeof WriteCapabilityPayloadSchema>;
+export declare const CAPABILITY_IDS: readonly ["tuner_switch", "tuner_tune", "rf_power", "af_gain", "sql", "mic_gain", "compressor", "compressor_level", "monitor_gain", "nb", "nr", "lock_mode", "mute", "vox", "agc_mode", "preamp", "attenuator", "mode_bandwidth", "rit_offset", "xit_offset", "tuning_step", "repeater_shift", "repeater_offset", "ctcss_tone", "dcs_code"];
+export type CapabilityId = (typeof CAPABILITY_IDS)[number];
+//# sourceMappingURL=radio-capability.schema.d.ts.map

package/dist/schema/radio-capability.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio-capability.schema.d.ts","sourceRoot":"","sources":["../../src/schema/radio-capability.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,8DAA4D,CAAC;AAClG,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,oDAAkD,CAAC;AACzF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,yCAAuC,CAAC;AAC/E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,2BAA2B,wCAAoC,CAAC;AAC7E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,qBAAqB,sDAAiD,CAAC;AACpF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,2BAA2B,iCAA+B,CAAC;AACxE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,2BAA2B,qDAAmD,CAAC;AAC5F,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,0BAA0B;IACrC,0DAA0D;;IAG1D,sBAAsB;;IAGtB,YAAY;;IAGZ;;;OAGG;;;;;;;;;;;;;;IAOH;;;OAGG;;;;;;;;;;;;;;IAGH,kCAAkC;;;;;;;;;;;;;;IAGlC,mCAAmC;;IAGnC,0BAA0B;;IAG1B,cAAc;;IAGd;;OAEG;;IAGH;;;OAGG;;IAGH;;;;OAIG;;IAGH,4DAA4D;;IAG5D,0BAA0B;;IAG1B,aAAa;;;;;;;;;;;;;;;;;IAGb,4CAA4C;;IAG5C;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,qBAAqB;IAChC,yCAAyC;;IAGzC,2BAA2B;;IAG3B;;;;;;OAMG;;IAGH;;;OAGG;;IAGH,kBAAkB;;;;;;;;;;;;;;EAElB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;QA/G/B,0DAA0D;;QAG1D,sBAAsB;;QAGtB,YAAY;;QAGZ;;;WAGG;;;;;;;;;;;;;;QAOH;;;WAGG;;;;;;;;;;;;;;QAGH,kCAAkC;;;;;;;;;;;;;;QAGlC,mCAAmC;;QAGnC,0BAA0B;;QAG1B,cAAc;;QAGd;;WAEG;;QAGH;;;WAGG;;QAGH;;;;WAIG;;QAGH,4DAA4D;;QAG5D,0BAA0B;;QAG1B,aAAa;;;;;;;;;;;;;;;;;QAGb,4CAA4C;;QAG5C;;;WAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAWH,yCAAyC;;QAGzC,2BAA2B;;QAG3B;;;;;;WAMG;;QAGH;;;WAGG;;QAGH,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYlB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,4BAA4B;IACvC,YAAY;;IAEZ,mCAAmC;;IAEnC,8BAA8B;;;;;;;;;;EAE9B,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAMlF,eAAO,MAAM,cAAc,6UA0BjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC"}