dsh-blue/blue--packages-api ↗★ 21

@dsh-blue/blue-api

Direct renderer-independent Cordis UI services for Blue plugins 适合开发Blue终端UI插件、需要注册面板、状态和弹窗服务的开发者。

패키지
@dsh-blue/blue-api
호환성
미검증
Cordis peer 범위
^4.0.2
버전
0.2.0-alpha.1
라이선스
MIT
최근 업데이트
2026. 9. 28.

설치

검증된 bundle이 없거나 호환성 검사에 실패했습니다. 먼저 저장소 설명을 읽어 주세요. 전체 README 읽기 ↗

@dsh-blue/blue-api

English | 中文

Renderer-neutral contracts and direct Cordis UI services for Blue 0.2.0-alpha.1.

Loading the package registers:

  • ctx.bluePanes
  • ctx.blueStatus
  • ctx.blueOverlays
  • ctx.blueEditorExtensions

Each registration belongs to the calling Cordis Fiber and disappears when that Fiber unloads. Definitions use BlueUiNode data; core owns validation and terminal rendering.

The full pane/overlay node union includes renderer-neutral document nodes for Markdown or Mermaid source and structured chart nodes for line, point, bar, sparkline, and heatmap data. These leaves are intentionally absent from the narrower status, notification, editor-extension, and BlueView contracts.

import type { Context } from '@deepseek-ai/cordis'
import type {} from '@dsh-blue/blue-api'

export const inject = ['bluePanes']

export function apply(ctx: Context): void {
  ctx.bluePanes.register({
    id: 'acme.summary',
    placement: 'right',
    render: () => ({ kind: 'text', content: 'ready' }),
  })
}

This package does not wrap dsh services. Plugins use ctx.commands, ctx.sessionProjections, ctx.tools, and other Harness services directly. There is no Blue manifest, capability host, adapter, or compatibility facade.