dsh-router-core 0.4.2 → 0.4.3

package/src/shared.ts

@@ -164,6 +164,40 @@ export interface RouterExtItem {
    * 「包含的组件」里占一行了，两处都列就是同一个东西显示两遍（与内置供应商同理）。
    */
   source?: 'builtin'
+  /**
+   * 扩展自带的子开关（如准则的每一条）。**由扩展自报**，核心只搬运。
+   *
+   * ⚠️ 与 `enabled`（总开关）不同：子开关**不改变扩展是否被加载**，只改它
+   *   自己的行为。总开关关时这些子开关一并失效（面板上禁用，不隐藏）。
+   */
+  controls?: ExtControlItem[]
+}
+
+/** `/router/api/ext` 里的一条子开关（与 `router.ext` 契约的 `ExtControl` 对应）。 */
+export interface ExtControlItem {
+  /** 稳定 id（持久化键；改名会丢用户已保存的选择）。 */
+  id: string
+  title: string
+  /** 当前是否开启（扩展自算：默认值 + 用户已存选择）。 */
+  on: boolean
+  /** 一句话说明（面板副行，可选）。 */
+  detail?: string
+  /** 原文（面板点开即可读到；不给出就是在盲切，见 `ExtControl.body`）。 */
+  body?: string
+  /** 文本可编辑（缺省 = 只读；见 `ExtControl.editable`）。 */
+  editable?: boolean
+  /**
+   * 自建条目（可删）还是内置（不可删、只有开关与还原）。
+   *
+   * ⚠️ **必填，不给可选**（2026-09-30 实测踩过）：曾声明成 `custom?: boolean`，
+   *   而服务端只在 `custom === true` 时才带这个字段 ⇒ 内置条目拿到的是
+   *   `undefined`，面板判 `c.custom === true` 为假，**恰好是对的** ——
+   *   但那条正确性建立在"缺省恰好等于 false"上，改任何一边的默认值都会翻转。
+   *   ⇒ 让服务端**总是**给显式布尔，两边不必猜。
+   */
+  custom: boolean
+  /** 文本被改过（决定「还原」是否可点）。必填，理由同 `custom`。 */
+  overridden: boolean
 }
 
 /** `/router/api/ext` response（扩展插件列表 + 开关）。 */