@tx5dr/contracts 1.7.3 → 1.7.5

package/dist/schema/plugin.schema.d.ts

@@ -48,7 +48,7 @@ export type PluginPanelComponent = z.infer<typeof PluginPanelComponentSchema>;
  * These values control both validation expectations and default frontend
  * rendering in plugin settings UIs.
  */
-export declare const PluginSettingTypeSchema: z.ZodEnum<["boolean", "number", "string", "string[]", "object[]", "info"]>;
+export declare const PluginSettingTypeSchema: z.ZodEnum<["boolean", "number", "string", "string[]", "object[]", "keyedStringArrays", "info"]>;
 /**
  * Supported generated-form field types for plugin settings.
  */
@@ -93,6 +93,65 @@ export declare const PluginObjectArrayFieldSchema: z.ZodObject<{
     required?: boolean | undefined;
 }>;
 export type PluginObjectArrayField = z.infer<typeof PluginObjectArrayFieldSchema>;
+export declare const PluginKeyedStringArrayKeySchema: z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    key: string;
+    description?: string | undefined;
+}, {
+    label: string;
+    key: string;
+    description?: string | undefined;
+}>;
+export type PluginKeyedStringArrayKey = z.infer<typeof PluginKeyedStringArrayKeySchema>;
+export declare const PluginSettingConditionSchema: z.ZodObject<{
+    setting: z.ZodString;
+    equals: z.ZodOptional<z.ZodUnknown>;
+    notEquals: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    setting: string;
+    equals?: unknown;
+    notEquals?: unknown;
+}, {
+    setting: string;
+    equals?: unknown;
+    notEquals?: unknown;
+}>;
+export type PluginSettingCondition = z.infer<typeof PluginSettingConditionSchema>;
+export declare const PluginSettingConditionalDescriptionSchema: z.ZodObject<{
+    when: z.ZodObject<{
+        setting: z.ZodString;
+        equals: z.ZodOptional<z.ZodUnknown>;
+        notEquals: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        setting: string;
+        equals?: unknown;
+        notEquals?: unknown;
+    }, {
+        setting: string;
+        equals?: unknown;
+        notEquals?: unknown;
+    }>;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    when: {
+        setting: string;
+        equals?: unknown;
+        notEquals?: unknown;
+    };
+}, {
+    description: string;
+    when: {
+        setting: string;
+        equals?: unknown;
+        notEquals?: unknown;
+    };
+}>;
+export type PluginSettingConditionalDescription = z.infer<typeof PluginSettingConditionalDescriptionSchema>;
 /**
  * Persistence and UI scope for a plugin setting.
  *
@@ -113,7 +172,7 @@ export type PluginSettingScope = z.infer<typeof PluginSettingScopeSchema>;
  * and resolve default values before injecting them into `ctx.config`.
  */
 export declare const PluginSettingDescriptorSchema: z.ZodObject<{
-    type: z.ZodEnum<["boolean", "number", "string", "string[]", "object[]", "info"]>;
+    type: z.ZodEnum<["boolean", "number", "string", "string[]", "object[]", "keyedStringArrays", "info"]>;
     default: z.ZodUnknown;
     label: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
@@ -152,14 +211,78 @@ export declare const PluginSettingDescriptorSchema: z.ZodObject<{
         placeholder?: string | undefined;
         required?: boolean | undefined;
     }>, "many">>;
+    /** Fixed key list used by generated editors for `keyedStringArrays` settings. */
+    keys: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        key: string;
+        description?: string | undefined;
+    }, {
+        label: string;
+        key: string;
+        description?: string | undefined;
+    }>, "many">>;
+    /** Conditionally show the field based on another setting in the same form. */
+    visibleWhen: z.ZodOptional<z.ZodObject<{
+        setting: z.ZodString;
+        equals: z.ZodOptional<z.ZodUnknown>;
+        notEquals: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        setting: string;
+        equals?: unknown;
+        notEquals?: unknown;
+    }, {
+        setting: string;
+        equals?: unknown;
+        notEquals?: unknown;
+    }>>;
+    /** Conditionally override the field description based on another setting. */
+    descriptionWhen: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        when: z.ZodObject<{
+            setting: z.ZodString;
+            equals: z.ZodOptional<z.ZodUnknown>;
+            notEquals: z.ZodOptional<z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        }, {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        }>;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        when: {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        };
+    }, {
+        description: string;
+        when: {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        };
+    }>, "many">>;
     /** Internal settings are persisted/injected but hidden from generated UIs. */
     hidden: z.ZodOptional<z.ZodBoolean>;
     /** 设置作用域：global（所有操作员共享）或 operator（每操作员独立），默认 global */
     scope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["global", "operator"]>>>;
 }, "strip", z.ZodTypeAny, {
-    type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+    type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
     label: string;
     scope: "operator" | "global";
+    keys?: {
+        label: string;
+        key: string;
+        description?: string | undefined;
+    }[] | undefined;
     options?: {
         value: string;
         label: string;
@@ -176,10 +299,28 @@ export declare const PluginSettingDescriptorSchema: z.ZodObject<{
         placeholder?: string | undefined;
         required?: boolean | undefined;
     }[] | undefined;
+    visibleWhen?: {
+        setting: string;
+        equals?: unknown;
+        notEquals?: unknown;
+    } | undefined;
+    descriptionWhen?: {
+        description: string;
+        when: {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        };
+    }[] | undefined;
     hidden?: boolean | undefined;
 }, {
-    type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+    type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
     label: string;
+    keys?: {
+        label: string;
+        key: string;
+        description?: string | undefined;
+    }[] | undefined;
     options?: {
         value: string;
         label: string;
@@ -196,6 +337,19 @@ export declare const PluginSettingDescriptorSchema: z.ZodObject<{
         placeholder?: string | undefined;
         required?: boolean | undefined;
     }[] | undefined;
+    visibleWhen?: {
+        setting: string;
+        equals?: unknown;
+        notEquals?: unknown;
+    } | undefined;
+    descriptionWhen?: {
+        description: string;
+        when: {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        };
+    }[] | undefined;
     hidden?: boolean | undefined;
     scope?: "operator" | "global" | undefined;
 }>;
@@ -267,7 +421,7 @@ export type PluginCapability = z.infer<typeof PluginCapabilitySchema>;
  * - `voice-left-top`: shown above the voice frequency control card.
  * - `voice-right-top`: shown in the tabbed top area of the voice right panel.
  */
-export declare const PluginPanelSlotSchema: z.ZodEnum<["operator", "automation", "main-right", "voice-left-top", "voice-right-top"]>;
+export declare const PluginPanelSlotSchema: z.ZodEnum<["operator", "automation", "main-right", "voice-left-top", "voice-right-top", "cw-right-top", "radio-control-toolbar"]>;
 /**
  * Rendering slot that determines where a panel appears in the UI.
  */
@@ -284,6 +438,22 @@ export declare const PluginPanelWidthSchema: z.ZodEnum<["half", "full"]>;
  * Preferred width hint for plugin-owned panels.
  */
 export type PluginPanelWidth = z.infer<typeof PluginPanelWidthSchema>;
+/**
+ * How an iframe panel is opened when rendered as a toolbar entry.
+ */
+export declare const PluginPanelOpenModeSchema: z.ZodEnum<["popover", "modal"]>;
+/**
+ * How an iframe panel is opened when rendered as a toolbar entry.
+ */
+export type PluginPanelOpenMode = z.infer<typeof PluginPanelOpenModeSchema>;
+/**
+ * Controlled size hint for iframe panels rendered as popovers or modals.
+ */
+export declare const PluginPanelUISizeSchema: z.ZodEnum<["sm", "md", "lg"]>;
+/**
+ * Controlled size hint for iframe panels rendered as popovers or modals.
+ */
+export type PluginPanelUISize = z.infer<typeof PluginPanelUISizeSchema>;
 /**
  * Declarative definition of a plugin-owned panel in the frontend.
  *
@@ -292,7 +462,7 @@ export type PluginPanelWidth = z.infer<typeof PluginPanelWidthSchema>;
  * the panel renders a custom UI page inside a sandboxed iframe instead. Static
  * manifest panels and runtime UI contributions use this same descriptor.
  */
-export declare const PluginPanelDescriptorSchema: z.ZodObject<{
+export declare const PluginPanelDescriptorSchema: z.ZodEffects<z.ZodObject<{
     id: z.ZodString;
     title: z.ZodString;
     component: z.ZodEnum<["table", "key-value", "chart", "log", "iframe"]>;
@@ -301,25 +471,59 @@ export declare const PluginPanelDescriptorSchema: z.ZodObject<{
     /** Optional string params forwarded to iframe panels as URL/init params. */
     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     /** Where the panel renders. Defaults to `'operator'` (operator card live-panel area). */
-    slot: z.ZodOptional<z.ZodEnum<["operator", "automation", "main-right", "voice-left-top", "voice-right-top"]>>;
+    slot: z.ZodOptional<z.ZodEnum<["operator", "automation", "main-right", "voice-left-top", "voice-right-top", "cw-right-top", "radio-control-toolbar"]>>;
     /** Preferred width hint. Defaults to `'half'`. */
     width: z.ZodOptional<z.ZodEnum<["half", "full"]>>;
+    /** Optional FontAwesome Free icon name used by toolbar-style hosts. */
+    icon: z.ZodOptional<z.ZodString>;
+    /** Optional toolbar opening mode. Defaults to host-specific behavior, typically `'popover'`. */
+    openMode: z.ZodOptional<z.ZodEnum<["popover", "modal"]>>;
+    /** Optional controlled UI size hint for toolbar popovers/modals. */
+    uiSize: z.ZodOptional<z.ZodEnum<["sm", "md", "lg"]>>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     title: string;
     component: "table" | "key-value" | "chart" | "log" | "iframe";
     params?: Record<string, string> | undefined;
+    icon?: string | undefined;
+    pageId?: string | undefined;
+    slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
+    width?: "full" | "half" | undefined;
+    openMode?: "popover" | "modal" | undefined;
+    uiSize?: "sm" | "md" | "lg" | undefined;
+}, {
+    id: string;
+    title: string;
+    component: "table" | "key-value" | "chart" | "log" | "iframe";
+    params?: Record<string, string> | undefined;
+    icon?: string | undefined;
+    pageId?: string | undefined;
+    slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
+    width?: "full" | "half" | undefined;
+    openMode?: "popover" | "modal" | undefined;
+    uiSize?: "sm" | "md" | "lg" | undefined;
+}>, {
+    id: string;
+    title: string;
+    component: "table" | "key-value" | "chart" | "log" | "iframe";
+    params?: Record<string, string> | undefined;
+    icon?: string | undefined;
     pageId?: string | undefined;
-    slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+    slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
     width?: "full" | "half" | undefined;
+    openMode?: "popover" | "modal" | undefined;
+    uiSize?: "sm" | "md" | "lg" | undefined;
 }, {
     id: string;
     title: string;
     component: "table" | "key-value" | "chart" | "log" | "iframe";
     params?: Record<string, string> | undefined;
+    icon?: string | undefined;
     pageId?: string | undefined;
-    slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+    slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
     width?: "full" | "half" | undefined;
+    openMode?: "popover" | "modal" | undefined;
+    uiSize?: "sm" | "md" | "lg" | undefined;
 }>;
 /**
  * Declarative definition of a plugin-owned panel in the frontend.
@@ -370,7 +574,7 @@ export declare const PluginUIPanelContributionGroupSchema: z.ZodObject<{
         operatorId: string;
         kind: "operator";
     }>]>>;
-    panels: z.ZodArray<z.ZodObject<{
+    panels: z.ZodArray<z.ZodEffects<z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
         component: z.ZodEnum<["table", "key-value", "chart", "log", "iframe"]>;
@@ -379,25 +583,59 @@ export declare const PluginUIPanelContributionGroupSchema: z.ZodObject<{
         /** Optional string params forwarded to iframe panels as URL/init params. */
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         /** Where the panel renders. Defaults to `'operator'` (operator card live-panel area). */
-        slot: z.ZodOptional<z.ZodEnum<["operator", "automation", "main-right", "voice-left-top", "voice-right-top"]>>;
+        slot: z.ZodOptional<z.ZodEnum<["operator", "automation", "main-right", "voice-left-top", "voice-right-top", "cw-right-top", "radio-control-toolbar"]>>;
         /** Preferred width hint. Defaults to `'half'`. */
         width: z.ZodOptional<z.ZodEnum<["half", "full"]>>;
+        /** Optional FontAwesome Free icon name used by toolbar-style hosts. */
+        icon: z.ZodOptional<z.ZodString>;
+        /** Optional toolbar opening mode. Defaults to host-specific behavior, typically `'popover'`. */
+        openMode: z.ZodOptional<z.ZodEnum<["popover", "modal"]>>;
+        /** Optional controlled UI size hint for toolbar popovers/modals. */
+        uiSize: z.ZodOptional<z.ZodEnum<["sm", "md", "lg"]>>;
     }, "strip", z.ZodTypeAny, {
         id: string;
         title: string;
         component: "table" | "key-value" | "chart" | "log" | "iframe";
         params?: Record<string, string> | undefined;
+        icon?: string | undefined;
+        pageId?: string | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
+        width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
+    }, {
+        id: string;
+        title: string;
+        component: "table" | "key-value" | "chart" | "log" | "iframe";
+        params?: Record<string, string> | undefined;
+        icon?: string | undefined;
+        pageId?: string | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
+        width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
+    }>, {
+        id: string;
+        title: string;
+        component: "table" | "key-value" | "chart" | "log" | "iframe";
+        params?: Record<string, string> | undefined;
+        icon?: string | undefined;
         pageId?: string | undefined;
-        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
         width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
     }, {
         id: string;
         title: string;
         component: "table" | "key-value" | "chart" | "log" | "iframe";
         params?: Record<string, string> | undefined;
+        icon?: string | undefined;
         pageId?: string | undefined;
-        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
         width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     pluginName: string;
@@ -408,9 +646,12 @@ export declare const PluginUIPanelContributionGroupSchema: z.ZodObject<{
         title: string;
         component: "table" | "key-value" | "chart" | "log" | "iframe";
         params?: Record<string, string> | undefined;
+        icon?: string | undefined;
         pageId?: string | undefined;
-        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
         width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
     }[];
     instanceTarget?: {
         kind: "global";
@@ -427,9 +668,12 @@ export declare const PluginUIPanelContributionGroupSchema: z.ZodObject<{
         title: string;
         component: "table" | "key-value" | "chart" | "log" | "iframe";
         params?: Record<string, string> | undefined;
+        icon?: string | undefined;
         pageId?: string | undefined;
-        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
         width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
     }[];
     instanceTarget?: {
         kind: "global";
@@ -575,7 +819,7 @@ export declare const PluginManifestSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     permissions: z.ZodOptional<z.ZodArray<z.ZodEnum<["network", "radio:read", "radio:control", "radio:power", "settings:ft8", "settings:decode-windows", "settings:realtime", "settings:frequency-presets", "settings:station", "settings:psk-reporter", "settings:ntp"]>, "many">>;
     settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        type: z.ZodEnum<["boolean", "number", "string", "string[]", "object[]", "info"]>;
+        type: z.ZodEnum<["boolean", "number", "string", "string[]", "object[]", "keyedStringArrays", "info"]>;
         default: z.ZodUnknown;
         label: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
@@ -614,14 +858,78 @@ export declare const PluginManifestSchema: z.ZodObject<{
             placeholder?: string | undefined;
             required?: boolean | undefined;
         }>, "many">>;
+        /** Fixed key list used by generated editors for `keyedStringArrays` settings. */
+        keys: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            key: string;
+            description?: string | undefined;
+        }, {
+            label: string;
+            key: string;
+            description?: string | undefined;
+        }>, "many">>;
+        /** Conditionally show the field based on another setting in the same form. */
+        visibleWhen: z.ZodOptional<z.ZodObject<{
+            setting: z.ZodString;
+            equals: z.ZodOptional<z.ZodUnknown>;
+            notEquals: z.ZodOptional<z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        }, {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        }>>;
+        /** Conditionally override the field description based on another setting. */
+        descriptionWhen: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            when: z.ZodObject<{
+                setting: z.ZodString;
+                equals: z.ZodOptional<z.ZodUnknown>;
+                notEquals: z.ZodOptional<z.ZodUnknown>;
+            }, "strip", z.ZodTypeAny, {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            }, {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            }>;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            description: string;
+            when: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            };
+        }, {
+            description: string;
+            when: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            };
+        }>, "many">>;
         /** Internal settings are persisted/injected but hidden from generated UIs. */
         hidden: z.ZodOptional<z.ZodBoolean>;
         /** 设置作用域：global（所有操作员共享）或 operator（每操作员独立），默认 global */
         scope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["global", "operator"]>>>;
     }, "strip", z.ZodTypeAny, {
-        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
         label: string;
         scope: "operator" | "global";
+        keys?: {
+            label: string;
+            key: string;
+            description?: string | undefined;
+        }[] | undefined;
         options?: {
             value: string;
             label: string;
@@ -638,10 +946,28 @@ export declare const PluginManifestSchema: z.ZodObject<{
             placeholder?: string | undefined;
             required?: boolean | undefined;
         }[] | undefined;
+        visibleWhen?: {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        } | undefined;
+        descriptionWhen?: {
+            description: string;
+            when: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            };
+        }[] | undefined;
         hidden?: boolean | undefined;
     }, {
-        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
         label: string;
+        keys?: {
+            label: string;
+            key: string;
+            description?: string | undefined;
+        }[] | undefined;
         options?: {
             value: string;
             label: string;
@@ -658,6 +984,19 @@ export declare const PluginManifestSchema: z.ZodObject<{
             placeholder?: string | undefined;
             required?: boolean | undefined;
         }[] | undefined;
+        visibleWhen?: {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        } | undefined;
+        descriptionWhen?: {
+            description: string;
+            when: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            };
+        }[] | undefined;
         hidden?: boolean | undefined;
         scope?: "operator" | "global" | undefined;
     }>>>;
@@ -681,7 +1020,7 @@ export declare const PluginManifestSchema: z.ZodObject<{
     }, {
         settingKey: string;
     }>, "many">>;
-    panels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    panels: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
         component: z.ZodEnum<["table", "key-value", "chart", "log", "iframe"]>;
@@ -690,25 +1029,59 @@ export declare const PluginManifestSchema: z.ZodObject<{
         /** Optional string params forwarded to iframe panels as URL/init params. */
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         /** Where the panel renders. Defaults to `'operator'` (operator card live-panel area). */
-        slot: z.ZodOptional<z.ZodEnum<["operator", "automation", "main-right", "voice-left-top", "voice-right-top"]>>;
+        slot: z.ZodOptional<z.ZodEnum<["operator", "automation", "main-right", "voice-left-top", "voice-right-top", "cw-right-top", "radio-control-toolbar"]>>;
         /** Preferred width hint. Defaults to `'half'`. */
         width: z.ZodOptional<z.ZodEnum<["half", "full"]>>;
+        /** Optional FontAwesome Free icon name used by toolbar-style hosts. */
+        icon: z.ZodOptional<z.ZodString>;
+        /** Optional toolbar opening mode. Defaults to host-specific behavior, typically `'popover'`. */
+        openMode: z.ZodOptional<z.ZodEnum<["popover", "modal"]>>;
+        /** Optional controlled UI size hint for toolbar popovers/modals. */
+        uiSize: z.ZodOptional<z.ZodEnum<["sm", "md", "lg"]>>;
     }, "strip", z.ZodTypeAny, {
         id: string;
         title: string;
         component: "table" | "key-value" | "chart" | "log" | "iframe";
         params?: Record<string, string> | undefined;
+        icon?: string | undefined;
         pageId?: string | undefined;
-        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
         width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
     }, {
         id: string;
         title: string;
         component: "table" | "key-value" | "chart" | "log" | "iframe";
         params?: Record<string, string> | undefined;
+        icon?: string | undefined;
         pageId?: string | undefined;
-        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
         width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
+    }>, {
+        id: string;
+        title: string;
+        component: "table" | "key-value" | "chart" | "log" | "iframe";
+        params?: Record<string, string> | undefined;
+        icon?: string | undefined;
+        pageId?: string | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
+        width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
+    }, {
+        id: string;
+        title: string;
+        component: "table" | "key-value" | "chart" | "log" | "iframe";
+        params?: Record<string, string> | undefined;
+        icon?: string | undefined;
+        pageId?: string | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
+        width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
     }>, "many">>;
     storage: z.ZodOptional<z.ZodObject<{
         scopes: z.ZodArray<z.ZodEnum<["global", "operator"]>, "many">;
@@ -781,9 +1154,12 @@ export declare const PluginManifestSchema: z.ZodObject<{
         title: string;
         component: "table" | "key-value" | "chart" | "log" | "iframe";
         params?: Record<string, string> | undefined;
+        icon?: string | undefined;
         pageId?: string | undefined;
-        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
         width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
     }[] | undefined;
     ui?: {
         dir: string;
@@ -798,9 +1174,14 @@ export declare const PluginManifestSchema: z.ZodObject<{
     } | undefined;
     permissions?: ("network" | "radio:read" | "radio:control" | "radio:power" | "settings:ft8" | "settings:decode-windows" | "settings:realtime" | "settings:frequency-presets" | "settings:station" | "settings:psk-reporter" | "settings:ntp")[] | undefined;
     settings?: Record<string, {
-        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
         label: string;
         scope: "operator" | "global";
+        keys?: {
+            label: string;
+            key: string;
+            description?: string | undefined;
+        }[] | undefined;
         options?: {
             value: string;
             label: string;
@@ -817,6 +1198,19 @@ export declare const PluginManifestSchema: z.ZodObject<{
             placeholder?: string | undefined;
             required?: boolean | undefined;
         }[] | undefined;
+        visibleWhen?: {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        } | undefined;
+        descriptionWhen?: {
+            description: string;
+            when: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            };
+        }[] | undefined;
         hidden?: boolean | undefined;
     }> | undefined;
     quickActions?: {
@@ -840,9 +1234,12 @@ export declare const PluginManifestSchema: z.ZodObject<{
         title: string;
         component: "table" | "key-value" | "chart" | "log" | "iframe";
         params?: Record<string, string> | undefined;
+        icon?: string | undefined;
         pageId?: string | undefined;
-        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
         width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
     }[] | undefined;
     ui?: {
         dir?: string | undefined;
@@ -858,8 +1255,13 @@ export declare const PluginManifestSchema: z.ZodObject<{
     instanceScope?: "operator" | "global" | undefined;
     permissions?: ("network" | "radio:read" | "radio:control" | "radio:power" | "settings:ft8" | "settings:decode-windows" | "settings:realtime" | "settings:frequency-presets" | "settings:station" | "settings:psk-reporter" | "settings:ntp")[] | undefined;
     settings?: Record<string, {
-        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
         label: string;
+        keys?: {
+            label: string;
+            key: string;
+            description?: string | undefined;
+        }[] | undefined;
         options?: {
             value: string;
             label: string;
@@ -876,6 +1278,19 @@ export declare const PluginManifestSchema: z.ZodObject<{
             placeholder?: string | undefined;
             required?: boolean | undefined;
         }[] | undefined;
+        visibleWhen?: {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        } | undefined;
+        descriptionWhen?: {
+            description: string;
+            when: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            };
+        }[] | undefined;
         hidden?: boolean | undefined;
         scope?: "operator" | "global" | undefined;
     }> | undefined;
@@ -944,7 +1359,7 @@ export declare const PluginStatusSchema: z.ZodObject<{
     /** 仅对 strategy 插件有意义：当前被哪些 operator 选中 */
     assignedOperatorIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        type: z.ZodEnum<["boolean", "number", "string", "string[]", "object[]", "info"]>;
+        type: z.ZodEnum<["boolean", "number", "string", "string[]", "object[]", "keyedStringArrays", "info"]>;
         default: z.ZodUnknown;
         label: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
@@ -983,14 +1398,78 @@ export declare const PluginStatusSchema: z.ZodObject<{
             placeholder?: string | undefined;
             required?: boolean | undefined;
         }>, "many">>;
+        /** Fixed key list used by generated editors for `keyedStringArrays` settings. */
+        keys: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            key: string;
+            description?: string | undefined;
+        }, {
+            label: string;
+            key: string;
+            description?: string | undefined;
+        }>, "many">>;
+        /** Conditionally show the field based on another setting in the same form. */
+        visibleWhen: z.ZodOptional<z.ZodObject<{
+            setting: z.ZodString;
+            equals: z.ZodOptional<z.ZodUnknown>;
+            notEquals: z.ZodOptional<z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        }, {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        }>>;
+        /** Conditionally override the field description based on another setting. */
+        descriptionWhen: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            when: z.ZodObject<{
+                setting: z.ZodString;
+                equals: z.ZodOptional<z.ZodUnknown>;
+                notEquals: z.ZodOptional<z.ZodUnknown>;
+            }, "strip", z.ZodTypeAny, {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            }, {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            }>;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            description: string;
+            when: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            };
+        }, {
+            description: string;
+            when: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            };
+        }>, "many">>;
         /** Internal settings are persisted/injected but hidden from generated UIs. */
         hidden: z.ZodOptional<z.ZodBoolean>;
         /** 设置作用域：global（所有操作员共享）或 operator（每操作员独立），默认 global */
         scope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["global", "operator"]>>>;
     }, "strip", z.ZodTypeAny, {
-        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
         label: string;
         scope: "operator" | "global";
+        keys?: {
+            label: string;
+            key: string;
+            description?: string | undefined;
+        }[] | undefined;
         options?: {
             value: string;
             label: string;
@@ -1007,10 +1486,28 @@ export declare const PluginStatusSchema: z.ZodObject<{
             placeholder?: string | undefined;
             required?: boolean | undefined;
         }[] | undefined;
+        visibleWhen?: {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        } | undefined;
+        descriptionWhen?: {
+            description: string;
+            when: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            };
+        }[] | undefined;
         hidden?: boolean | undefined;
     }, {
-        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
         label: string;
+        keys?: {
+            label: string;
+            key: string;
+            description?: string | undefined;
+        }[] | undefined;
         options?: {
             value: string;
             label: string;
@@ -1027,6 +1524,19 @@ export declare const PluginStatusSchema: z.ZodObject<{
             placeholder?: string | undefined;
             required?: boolean | undefined;
         }[] | undefined;
+        visibleWhen?: {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        } | undefined;
+        descriptionWhen?: {
+            description: string;
+            when: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            };
+        }[] | undefined;
         hidden?: boolean | undefined;
         scope?: "operator" | "global" | undefined;
     }>>>;
@@ -1050,7 +1560,7 @@ export declare const PluginStatusSchema: z.ZodObject<{
     }, {
         settingKey: string;
     }>, "many">>;
-    panels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    panels: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
         component: z.ZodEnum<["table", "key-value", "chart", "log", "iframe"]>;
@@ -1059,25 +1569,59 @@ export declare const PluginStatusSchema: z.ZodObject<{
         /** Optional string params forwarded to iframe panels as URL/init params. */
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         /** Where the panel renders. Defaults to `'operator'` (operator card live-panel area). */
-        slot: z.ZodOptional<z.ZodEnum<["operator", "automation", "main-right", "voice-left-top", "voice-right-top"]>>;
+        slot: z.ZodOptional<z.ZodEnum<["operator", "automation", "main-right", "voice-left-top", "voice-right-top", "cw-right-top", "radio-control-toolbar"]>>;
         /** Preferred width hint. Defaults to `'half'`. */
         width: z.ZodOptional<z.ZodEnum<["half", "full"]>>;
+        /** Optional FontAwesome Free icon name used by toolbar-style hosts. */
+        icon: z.ZodOptional<z.ZodString>;
+        /** Optional toolbar opening mode. Defaults to host-specific behavior, typically `'popover'`. */
+        openMode: z.ZodOptional<z.ZodEnum<["popover", "modal"]>>;
+        /** Optional controlled UI size hint for toolbar popovers/modals. */
+        uiSize: z.ZodOptional<z.ZodEnum<["sm", "md", "lg"]>>;
     }, "strip", z.ZodTypeAny, {
         id: string;
         title: string;
         component: "table" | "key-value" | "chart" | "log" | "iframe";
         params?: Record<string, string> | undefined;
+        icon?: string | undefined;
+        pageId?: string | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
+        width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
+    }, {
+        id: string;
+        title: string;
+        component: "table" | "key-value" | "chart" | "log" | "iframe";
+        params?: Record<string, string> | undefined;
+        icon?: string | undefined;
         pageId?: string | undefined;
-        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
         width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
+    }>, {
+        id: string;
+        title: string;
+        component: "table" | "key-value" | "chart" | "log" | "iframe";
+        params?: Record<string, string> | undefined;
+        icon?: string | undefined;
+        pageId?: string | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
+        width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
     }, {
         id: string;
         title: string;
         component: "table" | "key-value" | "chart" | "log" | "iframe";
         params?: Record<string, string> | undefined;
+        icon?: string | undefined;
         pageId?: string | undefined;
-        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
         width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
     }>, "many">>;
     permissions: z.ZodOptional<z.ZodArray<z.ZodEnum<["network", "radio:read", "radio:control", "radio:power", "settings:ft8", "settings:decode-windows", "settings:realtime", "settings:frequency-presets", "settings:station", "settings:psk-reporter", "settings:ntp"]>, "many">>;
     capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<["auto_call_candidate", "auto_call_execution"]>, "many">>;
@@ -1181,9 +1725,12 @@ export declare const PluginStatusSchema: z.ZodObject<{
         title: string;
         component: "table" | "key-value" | "chart" | "log" | "iframe";
         params?: Record<string, string> | undefined;
+        icon?: string | undefined;
         pageId?: string | undefined;
-        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
         width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
     }[] | undefined;
     ui?: {
         dir: string;
@@ -1198,9 +1745,14 @@ export declare const PluginStatusSchema: z.ZodObject<{
     } | undefined;
     permissions?: ("network" | "radio:read" | "radio:control" | "radio:power" | "settings:ft8" | "settings:decode-windows" | "settings:realtime" | "settings:frequency-presets" | "settings:station" | "settings:psk-reporter" | "settings:ntp")[] | undefined;
     settings?: Record<string, {
-        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
         label: string;
         scope: "operator" | "global";
+        keys?: {
+            label: string;
+            key: string;
+            description?: string | undefined;
+        }[] | undefined;
         options?: {
             value: string;
             label: string;
@@ -1217,6 +1769,19 @@ export declare const PluginStatusSchema: z.ZodObject<{
             placeholder?: string | undefined;
             required?: boolean | undefined;
         }[] | undefined;
+        visibleWhen?: {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        } | undefined;
+        descriptionWhen?: {
+            description: string;
+            when: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            };
+        }[] | undefined;
         hidden?: boolean | undefined;
     }> | undefined;
     quickActions?: {
@@ -1252,9 +1817,12 @@ export declare const PluginStatusSchema: z.ZodObject<{
         title: string;
         component: "table" | "key-value" | "chart" | "log" | "iframe";
         params?: Record<string, string> | undefined;
+        icon?: string | undefined;
         pageId?: string | undefined;
-        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+        slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
         width?: "full" | "half" | undefined;
+        openMode?: "popover" | "modal" | undefined;
+        uiSize?: "sm" | "md" | "lg" | undefined;
     }[] | undefined;
     ui?: {
         dir?: string | undefined;
@@ -1270,8 +1838,13 @@ export declare const PluginStatusSchema: z.ZodObject<{
     instanceScope?: "operator" | "global" | undefined;
     permissions?: ("network" | "radio:read" | "radio:control" | "radio:power" | "settings:ft8" | "settings:decode-windows" | "settings:realtime" | "settings:frequency-presets" | "settings:station" | "settings:psk-reporter" | "settings:ntp")[] | undefined;
     settings?: Record<string, {
-        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+        type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
         label: string;
+        keys?: {
+            label: string;
+            key: string;
+            description?: string | undefined;
+        }[] | undefined;
         options?: {
             value: string;
             label: string;
@@ -1288,6 +1861,19 @@ export declare const PluginStatusSchema: z.ZodObject<{
             placeholder?: string | undefined;
             required?: boolean | undefined;
         }[] | undefined;
+        visibleWhen?: {
+            setting: string;
+            equals?: unknown;
+            notEquals?: unknown;
+        } | undefined;
+        descriptionWhen?: {
+            description: string;
+            when: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            };
+        }[] | undefined;
         hidden?: boolean | undefined;
         scope?: "operator" | "global" | undefined;
     }> | undefined;
@@ -1388,7 +1974,7 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
         /** 仅对 strategy 插件有意义：当前被哪些 operator 选中 */
         assignedOperatorIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-            type: z.ZodEnum<["boolean", "number", "string", "string[]", "object[]", "info"]>;
+            type: z.ZodEnum<["boolean", "number", "string", "string[]", "object[]", "keyedStringArrays", "info"]>;
             default: z.ZodUnknown;
             label: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
@@ -1427,14 +2013,78 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
                 placeholder?: string | undefined;
                 required?: boolean | undefined;
             }>, "many">>;
+            /** Fixed key list used by generated editors for `keyedStringArrays` settings. */
+            keys: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                label: string;
+                key: string;
+                description?: string | undefined;
+            }, {
+                label: string;
+                key: string;
+                description?: string | undefined;
+            }>, "many">>;
+            /** Conditionally show the field based on another setting in the same form. */
+            visibleWhen: z.ZodOptional<z.ZodObject<{
+                setting: z.ZodString;
+                equals: z.ZodOptional<z.ZodUnknown>;
+                notEquals: z.ZodOptional<z.ZodUnknown>;
+            }, "strip", z.ZodTypeAny, {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            }, {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            }>>;
+            /** Conditionally override the field description based on another setting. */
+            descriptionWhen: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                when: z.ZodObject<{
+                    setting: z.ZodString;
+                    equals: z.ZodOptional<z.ZodUnknown>;
+                    notEquals: z.ZodOptional<z.ZodUnknown>;
+                }, "strip", z.ZodTypeAny, {
+                    setting: string;
+                    equals?: unknown;
+                    notEquals?: unknown;
+                }, {
+                    setting: string;
+                    equals?: unknown;
+                    notEquals?: unknown;
+                }>;
+                description: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                description: string;
+                when: {
+                    setting: string;
+                    equals?: unknown;
+                    notEquals?: unknown;
+                };
+            }, {
+                description: string;
+                when: {
+                    setting: string;
+                    equals?: unknown;
+                    notEquals?: unknown;
+                };
+            }>, "many">>;
             /** Internal settings are persisted/injected but hidden from generated UIs. */
             hidden: z.ZodOptional<z.ZodBoolean>;
             /** 设置作用域：global（所有操作员共享）或 operator（每操作员独立），默认 global */
             scope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["global", "operator"]>>>;
         }, "strip", z.ZodTypeAny, {
-            type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+            type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
             label: string;
             scope: "operator" | "global";
+            keys?: {
+                label: string;
+                key: string;
+                description?: string | undefined;
+            }[] | undefined;
             options?: {
                 value: string;
                 label: string;
@@ -1451,10 +2101,28 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
                 placeholder?: string | undefined;
                 required?: boolean | undefined;
             }[] | undefined;
+            visibleWhen?: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            } | undefined;
+            descriptionWhen?: {
+                description: string;
+                when: {
+                    setting: string;
+                    equals?: unknown;
+                    notEquals?: unknown;
+                };
+            }[] | undefined;
             hidden?: boolean | undefined;
         }, {
-            type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+            type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
             label: string;
+            keys?: {
+                label: string;
+                key: string;
+                description?: string | undefined;
+            }[] | undefined;
             options?: {
                 value: string;
                 label: string;
@@ -1471,6 +2139,19 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
                 placeholder?: string | undefined;
                 required?: boolean | undefined;
             }[] | undefined;
+            visibleWhen?: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            } | undefined;
+            descriptionWhen?: {
+                description: string;
+                when: {
+                    setting: string;
+                    equals?: unknown;
+                    notEquals?: unknown;
+                };
+            }[] | undefined;
             hidden?: boolean | undefined;
             scope?: "operator" | "global" | undefined;
         }>>>;
@@ -1494,7 +2175,7 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
         }, {
             settingKey: string;
         }>, "many">>;
-        panels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        panels: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
             id: z.ZodString;
             title: z.ZodString;
             component: z.ZodEnum<["table", "key-value", "chart", "log", "iframe"]>;
@@ -1503,25 +2184,59 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
             /** Optional string params forwarded to iframe panels as URL/init params. */
             params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             /** Where the panel renders. Defaults to `'operator'` (operator card live-panel area). */
-            slot: z.ZodOptional<z.ZodEnum<["operator", "automation", "main-right", "voice-left-top", "voice-right-top"]>>;
+            slot: z.ZodOptional<z.ZodEnum<["operator", "automation", "main-right", "voice-left-top", "voice-right-top", "cw-right-top", "radio-control-toolbar"]>>;
             /** Preferred width hint. Defaults to `'half'`. */
             width: z.ZodOptional<z.ZodEnum<["half", "full"]>>;
+            /** Optional FontAwesome Free icon name used by toolbar-style hosts. */
+            icon: z.ZodOptional<z.ZodString>;
+            /** Optional toolbar opening mode. Defaults to host-specific behavior, typically `'popover'`. */
+            openMode: z.ZodOptional<z.ZodEnum<["popover", "modal"]>>;
+            /** Optional controlled UI size hint for toolbar popovers/modals. */
+            uiSize: z.ZodOptional<z.ZodEnum<["sm", "md", "lg"]>>;
         }, "strip", z.ZodTypeAny, {
             id: string;
             title: string;
             component: "table" | "key-value" | "chart" | "log" | "iframe";
             params?: Record<string, string> | undefined;
+            icon?: string | undefined;
             pageId?: string | undefined;
-            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
             width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
         }, {
             id: string;
             title: string;
             component: "table" | "key-value" | "chart" | "log" | "iframe";
             params?: Record<string, string> | undefined;
+            icon?: string | undefined;
             pageId?: string | undefined;
-            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
             width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
+        }>, {
+            id: string;
+            title: string;
+            component: "table" | "key-value" | "chart" | "log" | "iframe";
+            params?: Record<string, string> | undefined;
+            icon?: string | undefined;
+            pageId?: string | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
+            width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
+        }, {
+            id: string;
+            title: string;
+            component: "table" | "key-value" | "chart" | "log" | "iframe";
+            params?: Record<string, string> | undefined;
+            icon?: string | undefined;
+            pageId?: string | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
+            width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
         }>, "many">>;
         permissions: z.ZodOptional<z.ZodArray<z.ZodEnum<["network", "radio:read", "radio:control", "radio:power", "settings:ft8", "settings:decode-windows", "settings:realtime", "settings:frequency-presets", "settings:station", "settings:psk-reporter", "settings:ntp"]>, "many">>;
         capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<["auto_call_candidate", "auto_call_execution"]>, "many">>;
@@ -1625,9 +2340,12 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
             title: string;
             component: "table" | "key-value" | "chart" | "log" | "iframe";
             params?: Record<string, string> | undefined;
+            icon?: string | undefined;
             pageId?: string | undefined;
-            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
             width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
         }[] | undefined;
         ui?: {
             dir: string;
@@ -1642,9 +2360,14 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
         } | undefined;
         permissions?: ("network" | "radio:read" | "radio:control" | "radio:power" | "settings:ft8" | "settings:decode-windows" | "settings:realtime" | "settings:frequency-presets" | "settings:station" | "settings:psk-reporter" | "settings:ntp")[] | undefined;
         settings?: Record<string, {
-            type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+            type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
             label: string;
             scope: "operator" | "global";
+            keys?: {
+                label: string;
+                key: string;
+                description?: string | undefined;
+            }[] | undefined;
             options?: {
                 value: string;
                 label: string;
@@ -1661,6 +2384,19 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
                 placeholder?: string | undefined;
                 required?: boolean | undefined;
             }[] | undefined;
+            visibleWhen?: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            } | undefined;
+            descriptionWhen?: {
+                description: string;
+                when: {
+                    setting: string;
+                    equals?: unknown;
+                    notEquals?: unknown;
+                };
+            }[] | undefined;
             hidden?: boolean | undefined;
         }> | undefined;
         quickActions?: {
@@ -1696,9 +2432,12 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
             title: string;
             component: "table" | "key-value" | "chart" | "log" | "iframe";
             params?: Record<string, string> | undefined;
+            icon?: string | undefined;
             pageId?: string | undefined;
-            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
             width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
         }[] | undefined;
         ui?: {
             dir?: string | undefined;
@@ -1714,8 +2453,13 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
         instanceScope?: "operator" | "global" | undefined;
         permissions?: ("network" | "radio:read" | "radio:control" | "radio:power" | "settings:ft8" | "settings:decode-windows" | "settings:realtime" | "settings:frequency-presets" | "settings:station" | "settings:psk-reporter" | "settings:ntp")[] | undefined;
         settings?: Record<string, {
-            type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+            type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
             label: string;
+            keys?: {
+                label: string;
+                key: string;
+                description?: string | undefined;
+            }[] | undefined;
             options?: {
                 value: string;
                 label: string;
@@ -1732,6 +2476,19 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
                 placeholder?: string | undefined;
                 required?: boolean | undefined;
             }[] | undefined;
+            visibleWhen?: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            } | undefined;
+            descriptionWhen?: {
+                description: string;
+                when: {
+                    setting: string;
+                    equals?: unknown;
+                    notEquals?: unknown;
+                };
+            }[] | undefined;
             hidden?: boolean | undefined;
             scope?: "operator" | "global" | undefined;
         }> | undefined;
@@ -1806,7 +2563,7 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
             operatorId: string;
             kind: "operator";
         }>]>>;
-        panels: z.ZodArray<z.ZodObject<{
+        panels: z.ZodArray<z.ZodEffects<z.ZodObject<{
             id: z.ZodString;
             title: z.ZodString;
             component: z.ZodEnum<["table", "key-value", "chart", "log", "iframe"]>;
@@ -1815,25 +2572,59 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
             /** Optional string params forwarded to iframe panels as URL/init params. */
             params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             /** Where the panel renders. Defaults to `'operator'` (operator card live-panel area). */
-            slot: z.ZodOptional<z.ZodEnum<["operator", "automation", "main-right", "voice-left-top", "voice-right-top"]>>;
+            slot: z.ZodOptional<z.ZodEnum<["operator", "automation", "main-right", "voice-left-top", "voice-right-top", "cw-right-top", "radio-control-toolbar"]>>;
             /** Preferred width hint. Defaults to `'half'`. */
             width: z.ZodOptional<z.ZodEnum<["half", "full"]>>;
+            /** Optional FontAwesome Free icon name used by toolbar-style hosts. */
+            icon: z.ZodOptional<z.ZodString>;
+            /** Optional toolbar opening mode. Defaults to host-specific behavior, typically `'popover'`. */
+            openMode: z.ZodOptional<z.ZodEnum<["popover", "modal"]>>;
+            /** Optional controlled UI size hint for toolbar popovers/modals. */
+            uiSize: z.ZodOptional<z.ZodEnum<["sm", "md", "lg"]>>;
         }, "strip", z.ZodTypeAny, {
             id: string;
             title: string;
             component: "table" | "key-value" | "chart" | "log" | "iframe";
             params?: Record<string, string> | undefined;
+            icon?: string | undefined;
             pageId?: string | undefined;
-            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
             width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
         }, {
             id: string;
             title: string;
             component: "table" | "key-value" | "chart" | "log" | "iframe";
             params?: Record<string, string> | undefined;
+            icon?: string | undefined;
             pageId?: string | undefined;
-            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
             width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
+        }>, {
+            id: string;
+            title: string;
+            component: "table" | "key-value" | "chart" | "log" | "iframe";
+            params?: Record<string, string> | undefined;
+            icon?: string | undefined;
+            pageId?: string | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
+            width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
+        }, {
+            id: string;
+            title: string;
+            component: "table" | "key-value" | "chart" | "log" | "iframe";
+            params?: Record<string, string> | undefined;
+            icon?: string | undefined;
+            pageId?: string | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
+            width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         pluginName: string;
@@ -1844,9 +2635,12 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
             title: string;
             component: "table" | "key-value" | "chart" | "log" | "iframe";
             params?: Record<string, string> | undefined;
+            icon?: string | undefined;
             pageId?: string | undefined;
-            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
             width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
         }[];
         instanceTarget?: {
             kind: "global";
@@ -1863,9 +2657,12 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
             title: string;
             component: "table" | "key-value" | "chart" | "log" | "iframe";
             params?: Record<string, string> | undefined;
+            icon?: string | undefined;
             pageId?: string | undefined;
-            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
             width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
         }[];
         instanceTarget?: {
             kind: "global";
@@ -1902,9 +2699,12 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
             title: string;
             component: "table" | "key-value" | "chart" | "log" | "iframe";
             params?: Record<string, string> | undefined;
+            icon?: string | undefined;
             pageId?: string | undefined;
-            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
             width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
         }[] | undefined;
         ui?: {
             dir: string;
@@ -1919,9 +2719,14 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
         } | undefined;
         permissions?: ("network" | "radio:read" | "radio:control" | "radio:power" | "settings:ft8" | "settings:decode-windows" | "settings:realtime" | "settings:frequency-presets" | "settings:station" | "settings:psk-reporter" | "settings:ntp")[] | undefined;
         settings?: Record<string, {
-            type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+            type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
             label: string;
             scope: "operator" | "global";
+            keys?: {
+                label: string;
+                key: string;
+                description?: string | undefined;
+            }[] | undefined;
             options?: {
                 value: string;
                 label: string;
@@ -1938,6 +2743,19 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
                 placeholder?: string | undefined;
                 required?: boolean | undefined;
             }[] | undefined;
+            visibleWhen?: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            } | undefined;
+            descriptionWhen?: {
+                description: string;
+                when: {
+                    setting: string;
+                    equals?: unknown;
+                    notEquals?: unknown;
+                };
+            }[] | undefined;
             hidden?: boolean | undefined;
         }> | undefined;
         quickActions?: {
@@ -1972,9 +2790,12 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
             title: string;
             component: "table" | "key-value" | "chart" | "log" | "iframe";
             params?: Record<string, string> | undefined;
+            icon?: string | undefined;
             pageId?: string | undefined;
-            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
             width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
         }[];
         instanceTarget?: {
             kind: "global";
@@ -2008,9 +2829,12 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
             title: string;
             component: "table" | "key-value" | "chart" | "log" | "iframe";
             params?: Record<string, string> | undefined;
+            icon?: string | undefined;
             pageId?: string | undefined;
-            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
             width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
         }[] | undefined;
         ui?: {
             dir?: string | undefined;
@@ -2026,8 +2850,13 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
         instanceScope?: "operator" | "global" | undefined;
         permissions?: ("network" | "radio:read" | "radio:control" | "radio:power" | "settings:ft8" | "settings:decode-windows" | "settings:realtime" | "settings:frequency-presets" | "settings:station" | "settings:psk-reporter" | "settings:ntp")[] | undefined;
         settings?: Record<string, {
-            type: "string" | "number" | "boolean" | "string[]" | "object[]" | "info";
+            type: "string" | "number" | "boolean" | "string[]" | "object[]" | "keyedStringArrays" | "info";
             label: string;
+            keys?: {
+                label: string;
+                key: string;
+                description?: string | undefined;
+            }[] | undefined;
             options?: {
                 value: string;
                 label: string;
@@ -2044,6 +2873,19 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
                 placeholder?: string | undefined;
                 required?: boolean | undefined;
             }[] | undefined;
+            visibleWhen?: {
+                setting: string;
+                equals?: unknown;
+                notEquals?: unknown;
+            } | undefined;
+            descriptionWhen?: {
+                description: string;
+                when: {
+                    setting: string;
+                    equals?: unknown;
+                    notEquals?: unknown;
+                };
+            }[] | undefined;
             hidden?: boolean | undefined;
             scope?: "operator" | "global" | undefined;
         }> | undefined;
@@ -2082,9 +2924,12 @@ export declare const PluginSystemSnapshotSchema: z.ZodObject<{
             title: string;
             component: "table" | "key-value" | "chart" | "log" | "iframe";
             params?: Record<string, string> | undefined;
+            icon?: string | undefined;
             pageId?: string | undefined;
-            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | undefined;
+            slot?: "operator" | "automation" | "main-right" | "voice-left-top" | "voice-right-top" | "cw-right-top" | "radio-control-toolbar" | undefined;
             width?: "full" | "half" | undefined;
+            openMode?: "popover" | "modal" | undefined;
+            uiSize?: "sm" | "md" | "lg" | undefined;
         }[];
         instanceTarget?: {
             kind: "global";