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

@dsh-blue/blue-api

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

Package
@dsh-blue/blue-api
Compatibility
Unverified
Cordis peer range
^4.0.2
Version
0.2.0-alpha.1
License
MIT
Last updated
Sep 28, 2026

Install

This plugin has no verified bundle, or compatibility checks failed. Read the repository notes first. Read the full 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.