@modesto_ma/dsh-channels 0.0.0-stage → 0.1.0

package/src/client/catalog.ts

@@ -0,0 +1,92 @@
+/**
+ * 浏览器半区的设置面板选择器目录折叠：把 Host 下发的字段描述与实时目录
+ * （`/dsh-channels/catalog`）合成通用表单需要的 select 描述。
+ *
+ * 拆成独立模块（不含 JSX/React）以便单测；`panel.tsx` 只负责串起状态与渲染。
+ *
+ * @module dsh-channels/client/catalog
+ */
+
+import { PANEL_COPY } from '../settings/contract.ts'
+import type {
+  CatalogWire,
+  EditableFieldWire,
+  EditableKey,
+  FieldOptionWire,
+  SelectCatalogWire,
+} from '../settings/contract.ts'
+
+/** Keys whose options come from the Host selector catalog. */
+export const CATALOG_KEYS = ['provider', 'model', 'reasoningEffort', 'agentPreset'] as const
+export type CatalogKey = (typeof CATALOG_KEYS)[number]
+
+export function isCatalogKey(key: EditableKey): key is CatalogKey {
+  return (CATALOG_KEYS as readonly string[]).includes(key)
+}
+
+/** Read one selector group back out of the Host-resolved panel fields. */
+export function selectorOf(field: EditableFieldWire | undefined): SelectCatalogWire {
+  if (field?.kind !== 'select') return { selectable: false, options: [] }
+  return {
+    selectable: true,
+    options: field.options === undefined ? [] : [...field.options],
+    ...(field.disabled === true ? { disabled: true } : {}),
+    ...(field.help === undefined ? {} : { help: field.help }),
+  }
+}
+
+/** Seed the client catalog from the options the Host already resolved for the panel. */
+export function catalogFromFields(fields: readonly EditableFieldWire[]): CatalogWire | null {
+  const byKey = new Map(fields.map(field => [field.key, field]))
+  const catalog: CatalogWire = {
+    provider: selectorOf(byKey.get('provider')),
+    model: selectorOf(byKey.get('model')),
+    reasoningEffort: selectorOf(byKey.get('reasoningEffort')),
+    agentPreset: selectorOf(byKey.get('agentPreset')),
+  }
+  return CATALOG_KEYS.every(key => !catalog[key].selectable) ? null : catalog
+}
+
+/** Current-value option kept when a saved value is missing from the live list. */
+function withCurrentOption(options: readonly FieldOptionWire[], value: string): FieldOptionWire[] {
+  const [inherit, ...rest] = options
+  const extra: FieldOptionWire = { value, label: `${value}（当前配置，不在宿主机列表中）` }
+  return inherit === undefined ? [extra] : [inherit, extra, ...rest]
+}
+
+/**
+ * Layer the live catalog over the Host panel fields. A group the Host cannot
+ * enumerate falls back to the free-text control; the rest render as selects.
+ *
+ * `disabled` must be cleared explicitly: the Host's initial panel descriptor
+ * carries `disabled: true` for dependent selectors (model without a provider,
+ * effort without a model), and a fetched catalog that resolved the dependency
+ * has to re-enable them. Forgetting this is exactly what made the model and
+ * reasoning selects permanently unusable after choosing a provider/model.
+ */
+export function applyCatalogFields(
+  fields: readonly EditableFieldWire[],
+  catalog: CatalogWire | null,
+  current: Partial<Record<CatalogKey, string | undefined>> = {},
+): EditableFieldWire[] {
+  if (catalog === null) return [...fields]
+  return fields.map((field) => {
+    if (!isCatalogKey(field.key)) return field
+    const selector = catalog[field.key]
+    if (!selector.selectable) {
+      return field.kind === 'select'
+        ? { ...field, kind: 'text', options: undefined, help: PANEL_COPY.catalogUnavailable, disabled: undefined }
+        : field
+    }
+    const value = current[field.key] ?? ''
+    const options = value !== '' && !selector.options.some(option => option.value === value)
+      ? withCurrentOption(selector.options, value)
+      : [...selector.options]
+    const next: EditableFieldWire = { ...field, kind: 'select', options }
+    if (selector.disabled === true) next.disabled = true
+    else delete next.disabled
+    if (selector.help === undefined) delete next.help
+    else next.help = selector.help
+    return next
+  })
+}

package/src/client/index.ts

@@ -0,0 +1,61 @@
+/**
+ * dsh-channels client half: 设置 →「飞书渠道」分区。
+ *
+ * 只依赖平台核心的 `slots` 服务与 react（bundle 里 react 走平台模块表，
+ * 其余全部内联）。页面数据来自 Host 半侧的 `/dsh-channels/*` 路由，因此
+ * 不需要 typert 契约，也不 import 任何 DSH 客户端包。
+ *
+ * @module dsh-channels/client
+ */
+
+import { PANEL_COPY } from '../settings/contract.ts'
+import { FeishuChannelsSection } from './panel.tsx'
+import { installStyles } from './styles.ts'
+
+// 平台 client runtime 的最小结构声明：只声明本 bundle 用到的两个能力。
+// 与安装的 DSH Web 版本（0.2.x）的 slots 运行时 API 一致。
+export interface ClientSlots {
+  inject(slot: string, contribution: () => unknown): void
+  register(
+    declaration: {
+      name: string
+      id: string
+      order?: number
+      label: () => string
+    },
+    component: (props: { close?: () => void }) => unknown,
+  ): () => void
+}
+
+export interface ClientContext {
+  slots: ClientSlots
+  effect?(callback: () => void | (() => void), label?: string): void
+}
+
+/** Cordis client plugin name. */
+export const name = 'dsh-channels'
+
+/** Required client services: the Slots registry is part of the web shell core. */
+export const inject = ['slots']
+
+/** Section id and nav order (built-ins: account -10, general 0, models 10, plugins 15, agent-presets 20). */
+export const SETTINGS_SECTION_ID = 'feishu-channels'
+export const SETTINGS_SECTION_ORDER = 40
+
+/**
+ * Mount the settings section and its stylesheet.
+ * @param ctx - client plugin context carrying the slots registry.
+ */
+export function apply(ctx: ClientContext): void {
+  if (typeof ctx.effect === 'function') {
+    ctx.effect(() => installStyles(), 'dsh-channels: settings styles')
+  } else {
+    installStyles()
+  }
+  ctx.slots.inject('settings.section', () => ctx.slots.register({
+    name: 'settings.section',
+    id: SETTINGS_SECTION_ID,
+    order: SETTINGS_SECTION_ORDER,
+    label: () => PANEL_COPY.title,
+  }, FeishuChannelsSection))
+}