@tx5dr/contracts 1.2.0

package/dist/schema/radio-capability.schema.js

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

package/dist/schema/radio-capability.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio-capability.schema.js","sourceRoot":"","sources":["../../src/schema/radio-capability.schema.ts"],"names":[],"mappings":"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"}

package/dist/schema/radio-power-support.d.ts

@@ -0,0 +1,45 @@
+import type { HamlibConfig } from './radio.schema.js';
+/**
+ * Radios known to support `rig_set_powerstat(RIG_POWER_ON)` via Hamlib.
+ * Matching happens on mfgName + modelName (case-insensitive, substring/regex).
+ *
+ * Because node-hamlib does not expose `rig_get_caps`, we cannot introspect
+ * per-model powerstat support at runtime. Instead we maintain a conservative
+ * allow-list of radios for which powerstat is verified to work; UI only
+ * surfaces the "power on" button for these models. The server still falls
+ * back to the actual Hamlib return value — an unsupported model receives a
+ * user-friendly error if the allow-list is bypassed.
+ *
+ * To add a new model: add an entry with the mfgName returned by
+ * `HamLib.getSupportedRigs()` and a pattern that matches its modelName.
+ */
+export interface PowerCapableRigEntry {
+    mfg: string | RegExp;
+    model: string | RegExp;
+}
+export declare const POWER_CAPABLE_RIGS: ReadonlyArray<PowerCapableRigEntry>;
+export declare function isRigModelPowerCapable(mfgName: string, modelName: string): boolean;
+export type PowerSupportReason = 'model-unsupported' | 'network-mode-no-wake' | 'none-mode';
+export interface PowerSupportDecision {
+    /** Whether the UI should surface a "power on" control. */
+    canPowerOn: boolean;
+    /** Whether the UI should surface a "power off" control. */
+    canPowerOff: boolean;
+    /** Machine-readable reason when `canPowerOn` is false. */
+    reason?: PowerSupportReason;
+}
+/**
+ * Decide whether power control should be surfaced for a given Profile radio config.
+ *
+ * For serial mode, the caller must provide the rig's mfgName/modelName
+ * (resolved via `HamLib.getSupportedRigs()` server-side). For network mode
+ * the rig model is not known ahead of time (rigctld proxies any radio) —
+ * `power on` is never offered because a remote rigctld running on the radio
+ * is unreachable when the radio is powered off. `power off` is still offered
+ * in case the rigctld process runs on a separate host.
+ */
+export declare function decidePowerSupport(config: HamlibConfig, rigInfo?: {
+    mfgName: string;
+    modelName: string;
+}): PowerSupportDecision;
+//# sourceMappingURL=radio-power-support.d.ts.map

package/dist/schema/radio-power-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio-power-support.d.ts","sourceRoot":"","sources":["../../src/schema/radio-power-support.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,oBAAoB,CAoBlE,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAYlF;AAED,MAAM,MAAM,kBAAkB,GAC1B,mBAAmB,GACnB,sBAAsB,GACtB,WAAW,CAAC;AAEhB,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,UAAU,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,WAAW,EAAE,OAAO,CAAC;IACrB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/C,oBAAoB,CAsBtB"}

package/dist/schema/radio-power-support.js

@@ -0,0 +1,64 @@
+export const POWER_CAPABLE_RIGS = [
+    // Icom modern transceivers (CI-V 0x18 command)
+    { mfg: /^icom$/i, model: /^IC-?705$/i },
+    { mfg: /^icom$/i, model: /^IC-?7300$/i },
+    { mfg: /^icom$/i, model: /^IC-?7610$/i },
+    { mfg: /^icom$/i, model: /^IC-?7100$/i },
+    { mfg: /^icom$/i, model: /^IC-?7851$/i },
+    { mfg: /^icom$/i, model: /^IC-?9700$/i },
+    { mfg: /^icom$/i, model: /^IC-?R8600$/i },
+    // Kenwood
+    { mfg: /^kenwood$/i, model: /^TS-590SG?$/i },
+    { mfg: /^kenwood$/i, model: /^TS-890$/i },
+    { mfg: /^kenwood$/i, model: /^TS-990$/i },
+    // Yaesu
+    { mfg: /^yaesu$/i, model: /^FT-991A?$/i },
+    { mfg: /^yaesu$/i, model: /^FTDX-?10$/i },
+    { mfg: /^yaesu$/i, model: /^FTDX-?101(MP|D)?$/i },
+    { mfg: /^yaesu$/i, model: /^FT-?710$/i },
+];
+export function isRigModelPowerCapable(mfgName, modelName) {
+    return POWER_CAPABLE_RIGS.some((entry) => {
+        const mfgOk = typeof entry.mfg === 'string'
+            ? entry.mfg.toLowerCase() === mfgName.toLowerCase()
+            : entry.mfg.test(mfgName);
+        const modelOk = typeof entry.model === 'string'
+            ? entry.model.toLowerCase() === modelName.toLowerCase()
+            : entry.model.test(modelName);
+        return mfgOk && modelOk;
+    });
+}
+/**
+ * Decide whether power control should be surfaced for a given Profile radio config.
+ *
+ * For serial mode, the caller must provide the rig's mfgName/modelName
+ * (resolved via `HamLib.getSupportedRigs()` server-side). For network mode
+ * the rig model is not known ahead of time (rigctld proxies any radio) —
+ * `power on` is never offered because a remote rigctld running on the radio
+ * is unreachable when the radio is powered off. `power off` is still offered
+ * in case the rigctld process runs on a separate host.
+ */
+export function decidePowerSupport(config, rigInfo) {
+    switch (config.type) {
+        case 'none':
+            return { canPowerOn: false, canPowerOff: false, reason: 'none-mode' };
+        case 'network':
+            return { canPowerOn: false, canPowerOff: true, reason: 'network-mode-no-wake' };
+        case 'icom-wlan':
+            // ICOM WLAN 的 CI-V-over-UDP 通道在电台关机后无法维持；即便已连接
+            // 发送 powerstat(off) 也不能可靠恢复。整体不暴露电源控制。
+            return { canPowerOn: false, canPowerOff: false, reason: 'model-unsupported' };
+        case 'serial': {
+            if (!rigInfo) {
+                return { canPowerOn: false, canPowerOff: false, reason: 'model-unsupported' };
+            }
+            const supported = isRigModelPowerCapable(rigInfo.mfgName, rigInfo.modelName);
+            return supported
+                ? { canPowerOn: true, canPowerOff: true }
+                : { canPowerOn: false, canPowerOff: false, reason: 'model-unsupported' };
+        }
+        default:
+            return { canPowerOn: false, canPowerOff: false, reason: 'model-unsupported' };
+    }
+}
+//# sourceMappingURL=radio-power-support.js.map

package/dist/schema/radio-power-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio-power-support.js","sourceRoot":"","sources":["../../src/schema/radio-power-support.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAC,MAAM,kBAAkB,GAAwC;IACrE,+CAA+C;IAC/C,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE;IACvC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE;IACxC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE;IACxC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE;IACxC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE;IACxC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE;IACxC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE;IAEzC,UAAU;IACV,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE;IAC5C,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE;IACzC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE;IAEzC,QAAQ;IACR,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE;IACzC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE;IACzC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,qBAAqB,EAAE;IACjD,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE;CACzC,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,SAAiB;IACvE,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QACvC,MAAM,KAAK,GACT,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;YAC3B,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE;YACnD,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,MAAM,OAAO,GACX,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;YAC7B,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE;YACvD,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClC,OAAO,KAAK,IAAI,OAAO,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAgBD;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAoB,EACpB,OAAgD;IAEhD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QACxE,KAAK,SAAS;YACZ,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;QAClF,KAAK,WAAW;YACd,+CAA+C;YAC/C,uCAAuC;YACvC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QAChF,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;YAChF,CAAC;YACD,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAC7E,OAAO,SAAS;gBACd,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;gBACzC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QAC7E,CAAC;QACD;YACE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAClF,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,319 @@
+import { z } from 'zod';
+/**
+ * High-level runtime state tracked by the RadioPowerController.
+ *
+ * - `off`: radio is known to be off (or was never connected).
+ * - `waking`: power-on command sent, waiting for the radio to respond.
+ * - `awake`: radio is responding; the engine is being started (if autoEngine).
+ * - `shutting_down`: engine is stopping in preparation for a power-off command.
+ * - `entering_standby`: powerstat(2) sent, waiting for radio to drop CAT link.
+ * - `failed`: last transition failed; UI should show an error + retry.
+ */
+export declare const RadioPowerStateSchema: z.ZodEnum<["off", "waking", "awake", "shutting_down", "entering_standby", "failed"]>;
+export type RadioPowerState = z.infer<typeof RadioPowerStateSchema>;
+/**
+ * Finer-grained progress stage inside `waking` / `shutting_down`.
+ * UI uses this to show progress bar labels.
+ */
+export declare const RadioPowerStageSchema: z.ZodEnum<["idle", "sending_command", "waiting_ready", "waiting_standby_disconnect", "starting_engine", "stopping_engine", "disconnecting"]>;
+export type RadioPowerStage = z.infer<typeof RadioPowerStageSchema>;
+/**
+ * WS event payload: server → client.
+ */
+export declare const RadioPowerStateEventSchema: z.ZodObject<{
+    profileId: z.ZodOptional<z.ZodString>;
+    state: z.ZodEnum<["off", "waking", "awake", "shutting_down", "entering_standby", "failed"]>;
+    stage: z.ZodEnum<["idle", "sending_command", "waiting_ready", "waiting_standby_disconnect", "starting_engine", "stopping_engine", "disconnecting"]>;
+    /** Translation key reference for an inline error, e.g. 'radio:power.error.timeout'. */
+    errorKey: z.ZodOptional<z.ZodString>;
+    /** Free-form details for debugging; not user-facing. */
+    errorDetail: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    state: "failed" | "off" | "waking" | "awake" | "shutting_down" | "entering_standby";
+    stage: "idle" | "sending_command" | "waiting_ready" | "waiting_standby_disconnect" | "starting_engine" | "stopping_engine" | "disconnecting";
+    profileId?: string | undefined;
+    errorKey?: string | undefined;
+    errorDetail?: string | undefined;
+}, {
+    state: "failed" | "off" | "waking" | "awake" | "shutting_down" | "entering_standby";
+    stage: "idle" | "sending_command" | "waiting_ready" | "waiting_standby_disconnect" | "starting_engine" | "stopping_engine" | "disconnecting";
+    profileId?: string | undefined;
+    errorKey?: string | undefined;
+    errorDetail?: string | undefined;
+}>;
+export type RadioPowerStateEvent = z.infer<typeof RadioPowerStateEventSchema>;
+/**
+ * REST request body: POST /api/radio/power
+ */
+/** Allowed target states for a power request. */
+export declare const RadioPowerTargetSchema: z.ZodEnum<["on", "off", "standby", "operate"]>;
+export type RadioPowerTarget = z.infer<typeof RadioPowerTargetSchema>;
+export declare const RadioPowerRequestSchema: z.ZodObject<{
+    profileId: z.ZodString;
+    state: z.ZodEnum<["on", "off", "standby", "operate"]>;
+    /** Automatically start the engine after successful power-on. Defaults to true. */
+    autoEngine: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    state: "off" | "on" | "standby" | "operate";
+    profileId: string;
+    autoEngine: boolean;
+}, {
+    state: "off" | "on" | "standby" | "operate";
+    profileId: string;
+    autoEngine?: boolean | undefined;
+}>;
+export type RadioPowerRequest = z.infer<typeof RadioPowerRequestSchema>;
+/**
+ * REST response: POST /api/radio/power
+ */
+export declare const RadioPowerResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    state: z.ZodEnum<["off", "waking", "awake", "shutting_down", "entering_standby", "failed"]>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    state: "failed" | "off" | "waking" | "awake" | "shutting_down" | "entering_standby";
+}, {
+    success: boolean;
+    state: "failed" | "off" | "waking" | "awake" | "shutting_down" | "entering_standby";
+}>;
+export type RadioPowerResponse = z.infer<typeof RadioPowerResponseSchema>;
+/**
+ * REST response: GET /api/radio/power/support?profileId=xxx
+ * The server resolves mfgName/modelName internally via HamLib.getSupportedRigs().
+ */
+export declare const RadioPowerSupportInfoSchema: z.ZodObject<{
+    profileId: z.ZodString;
+    canPowerOn: z.ZodBoolean;
+    canPowerOff: z.ZodBoolean;
+    /**
+     * States the user is allowed to switch *between* while the radio is connected.
+     * Empty when the radio is unsupported or not connected (UI then renders no dropdown).
+     */
+    supportedStates: z.ZodDefault<z.ZodArray<z.ZodEnum<["operate", "standby", "off"]>, "many">>;
+    reason: z.ZodOptional<z.ZodEnum<["model-unsupported", "network-mode-no-wake", "none-mode"]>>;
+    rigInfo: z.ZodOptional<z.ZodObject<{
+        mfgName: z.ZodString;
+        modelName: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        mfgName: string;
+        modelName: string;
+    }, {
+        mfgName: string;
+        modelName: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    profileId: string;
+    canPowerOn: boolean;
+    canPowerOff: boolean;
+    supportedStates: ("off" | "standby" | "operate")[];
+    reason?: "model-unsupported" | "network-mode-no-wake" | "none-mode" | undefined;
+    rigInfo?: {
+        mfgName: string;
+        modelName: string;
+    } | undefined;
+}, {
+    profileId: string;
+    canPowerOn: boolean;
+    canPowerOff: boolean;
+    reason?: "model-unsupported" | "network-mode-no-wake" | "none-mode" | undefined;
+    supportedStates?: ("off" | "standby" | "operate")[] | undefined;
+    rigInfo?: {
+        mfgName: string;
+        modelName: string;
+    } | undefined;
+}>;
+export type RadioPowerSupportInfo = z.infer<typeof RadioPowerSupportInfoSchema>;
+/** Convenience re-export so callers can validate a full config blob. */
+export declare const RadioPowerProfileConfigSchema: z.ZodObject<{
+    type: z.ZodEnum<["none", "network", "serial", "icom-wlan"]>;
+    network: z.ZodOptional<z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        host: string;
+        port: number;
+    }, {
+        host: string;
+        port: number;
+    }>>;
+    icomWlan: z.ZodOptional<z.ZodObject<{
+        ip: z.ZodString;
+        port: z.ZodNumber;
+        userName: z.ZodOptional<z.ZodString>;
+        password: z.ZodOptional<z.ZodString>;
+        dataMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        ip: string;
+        port: number;
+        dataMode: boolean;
+        userName?: string | undefined;
+        password?: string | undefined;
+    }, {
+        ip: string;
+        port: number;
+        userName?: string | undefined;
+        password?: string | undefined;
+        dataMode?: boolean | undefined;
+    }>>;
+    serial: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        rigModel: z.ZodNumber;
+        serialConfig: z.ZodOptional<z.ZodObject<{
+            data_bits: z.ZodOptional<z.ZodEnum<["5", "6", "7", "8"]>>;
+            stop_bits: z.ZodOptional<z.ZodEnum<["1", "2"]>>;
+            serial_parity: z.ZodOptional<z.ZodEnum<["None", "Even", "Odd", "Mark", "Space"]>>;
+            serial_handshake: z.ZodOptional<z.ZodEnum<["None", "Hardware", "Software"]>>;
+            rts_state: z.ZodOptional<z.ZodEnum<["ON", "OFF", "UNSET"]>>;
+            dtr_state: z.ZodOptional<z.ZodEnum<["ON", "OFF", "UNSET"]>>;
+            rate: z.ZodOptional<z.ZodNumber>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            retry: z.ZodOptional<z.ZodNumber>;
+            write_delay: z.ZodOptional<z.ZodNumber>;
+            post_write_delay: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            data_bits?: "5" | "6" | "7" | "8" | undefined;
+            stop_bits?: "1" | "2" | undefined;
+            serial_parity?: "None" | "Even" | "Odd" | "Mark" | "Space" | undefined;
+            serial_handshake?: "None" | "Hardware" | "Software" | undefined;
+            rts_state?: "ON" | "OFF" | "UNSET" | undefined;
+            dtr_state?: "ON" | "OFF" | "UNSET" | undefined;
+            rate?: number | undefined;
+            timeout?: number | undefined;
+            retry?: number | undefined;
+            write_delay?: number | undefined;
+            post_write_delay?: number | undefined;
+        }, {
+            data_bits?: "5" | "6" | "7" | "8" | undefined;
+            stop_bits?: "1" | "2" | undefined;
+            serial_parity?: "None" | "Even" | "Odd" | "Mark" | "Space" | undefined;
+            serial_handshake?: "None" | "Hardware" | "Software" | undefined;
+            rts_state?: "ON" | "OFF" | "UNSET" | undefined;
+            dtr_state?: "ON" | "OFF" | "UNSET" | undefined;
+            rate?: number | undefined;
+            timeout?: number | undefined;
+            retry?: number | undefined;
+            write_delay?: number | undefined;
+            post_write_delay?: number | undefined;
+        }>>;
+        backendConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        rigModel: number;
+        serialConfig?: {
+            data_bits?: "5" | "6" | "7" | "8" | undefined;
+            stop_bits?: "1" | "2" | undefined;
+            serial_parity?: "None" | "Even" | "Odd" | "Mark" | "Space" | undefined;
+            serial_handshake?: "None" | "Hardware" | "Software" | undefined;
+            rts_state?: "ON" | "OFF" | "UNSET" | undefined;
+            dtr_state?: "ON" | "OFF" | "UNSET" | undefined;
+            rate?: number | undefined;
+            timeout?: number | undefined;
+            retry?: number | undefined;
+            write_delay?: number | undefined;
+            post_write_delay?: number | undefined;
+        } | undefined;
+        backendConfig?: Record<string, string> | undefined;
+    }, {
+        path: string;
+        rigModel: number;
+        serialConfig?: {
+            data_bits?: "5" | "6" | "7" | "8" | undefined;
+            stop_bits?: "1" | "2" | undefined;
+            serial_parity?: "None" | "Even" | "Odd" | "Mark" | "Space" | undefined;
+            serial_handshake?: "None" | "Hardware" | "Software" | undefined;
+            rts_state?: "ON" | "OFF" | "UNSET" | undefined;
+            dtr_state?: "ON" | "OFF" | "UNSET" | undefined;
+            rate?: number | undefined;
+            timeout?: number | undefined;
+            retry?: number | undefined;
+            write_delay?: number | undefined;
+            post_write_delay?: number | undefined;
+        } | undefined;
+        backendConfig?: Record<string, string> | undefined;
+    }>>;
+    spectrum: z.ZodOptional<z.ZodObject<{
+        speed: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        speed?: number | undefined;
+    }, {
+        speed?: number | undefined;
+    }>>;
+    transmitCompensationMs: z.ZodOptional<z.ZodNumber>;
+    pttMethod: z.ZodOptional<z.ZodEnum<["cat", "vox", "dtr", "rts"]>>;
+    pttPort: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "none" | "network" | "serial" | "icom-wlan";
+    spectrum?: {
+        speed?: number | undefined;
+    } | undefined;
+    network?: {
+        host: string;
+        port: number;
+    } | undefined;
+    serial?: {
+        path: string;
+        rigModel: number;
+        serialConfig?: {
+            data_bits?: "5" | "6" | "7" | "8" | undefined;
+            stop_bits?: "1" | "2" | undefined;
+            serial_parity?: "None" | "Even" | "Odd" | "Mark" | "Space" | undefined;
+            serial_handshake?: "None" | "Hardware" | "Software" | undefined;
+            rts_state?: "ON" | "OFF" | "UNSET" | undefined;
+            dtr_state?: "ON" | "OFF" | "UNSET" | undefined;
+            rate?: number | undefined;
+            timeout?: number | undefined;
+            retry?: number | undefined;
+            write_delay?: number | undefined;
+            post_write_delay?: number | undefined;
+        } | undefined;
+        backendConfig?: Record<string, string> | undefined;
+    } | undefined;
+    icomWlan?: {
+        ip: string;
+        port: number;
+        dataMode: boolean;
+        userName?: string | undefined;
+        password?: string | undefined;
+    } | undefined;
+    transmitCompensationMs?: number | undefined;
+    pttMethod?: "cat" | "vox" | "dtr" | "rts" | undefined;
+    pttPort?: string | undefined;
+}, {
+    type: "none" | "network" | "serial" | "icom-wlan";
+    spectrum?: {
+        speed?: number | undefined;
+    } | undefined;
+    network?: {
+        host: string;
+        port: number;
+    } | undefined;
+    serial?: {
+        path: string;
+        rigModel: number;
+        serialConfig?: {
+            data_bits?: "5" | "6" | "7" | "8" | undefined;
+            stop_bits?: "1" | "2" | undefined;
+            serial_parity?: "None" | "Even" | "Odd" | "Mark" | "Space" | undefined;
+            serial_handshake?: "None" | "Hardware" | "Software" | undefined;
+            rts_state?: "ON" | "OFF" | "UNSET" | undefined;
+            dtr_state?: "ON" | "OFF" | "UNSET" | undefined;
+            rate?: number | undefined;
+            timeout?: number | undefined;
+            retry?: number | undefined;
+            write_delay?: number | undefined;
+            post_write_delay?: number | undefined;
+        } | undefined;
+        backendConfig?: Record<string, string> | undefined;
+    } | undefined;
+    icomWlan?: {
+        ip: string;
+        port: number;
+        userName?: string | undefined;
+        password?: string | undefined;
+        dataMode?: boolean | undefined;
+    } | undefined;
+    transmitCompensationMs?: number | undefined;
+    pttMethod?: "cat" | "vox" | "dtr" | "rts" | undefined;
+    pttPort?: string | undefined;
+}>;
+//# sourceMappingURL=radio-power.schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"radio-power.schema.d.ts","sourceRoot":"","sources":["../../src/schema/radio-power.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,sFAOhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,8IAQhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;IAIrC,uFAAuF;;IAEvF,wDAAwD;;;;;;;;;;;;;;EAExD,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;GAEG;AACH,iDAAiD;AACjD,eAAO,MAAM,sBAAsB,gDAA8C,CAAC;AAClF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,uBAAuB;;;IAGlC,kFAAkF;;;;;;;;;;EAElF,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;EAGnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;IAItC;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASH,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,wEAAwE;AACxE,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAqB,CAAC"}