@changfenhuang/dsh-genui 0.9.1

package/lib/types/client/spec.d.ts

@@ -0,0 +1,610 @@
+/**
+ * GenUI spec language: the declarative component tree a model emits inside a
+ * ```dsh-ui fence in its reply, which GenuiBlock renders as real interactive
+ * UI inline in the conversation. The vocabulary is a white list — the renderer
+ * maps each node to DOM directly, with no arbitrary-HTML path (same
+ * untrusted-output stance as MarkdownText).
+ *
+ * v1 interactivity is client-side only: buttons, tabs, checkboxes, and inputs
+ * are operable, but events do NOT flow back to the model.
+ */
+/** One node in the component tree. */
+export type GenuiNode = GenuiText | GenuiRow | GenuiCol | GenuiGrid | GenuiCard | GenuiButton | GenuiInput | GenuiSelect | GenuiCheckbox | GenuiLink | GenuiAudio | GenuiVideo | GenuiBadge | GenuiStat | GenuiProgress | GenuiDivider | GenuiList | GenuiTable | GenuiChart | GenuiTabs | GenuiAvatar | GenuiSpacer | GenuiPlot | GenuiCallout | GenuiSteps | GenuiKeyValue | GenuiDiff | GenuiJson | GenuiCode | GenuiRadio | GenuiSubmit | GenuiSwitch | GenuiSlider | GenuiTextarea | GenuiAccordion | GenuiCopy | GenuiMermaid | GenuiScene3D | GenuiTimeline | GenuiFileTree | GenuiBreadcrumb | GenuiQuiz | GenuiDiagram | GenuiEChart;
+export interface GenuiSpec {
+    /** Short title shown as the card banner. */
+    title?: string;
+    /** Vertical gap between root items in px. */
+    gap?: number;
+    /** Panel-only flag: `true` routes the fence to the session panel dock
+     * instead of the message flow (rendered by the same block, updated in
+     * place on every publish). */
+    panel?: boolean;
+    /** Panel APPEND flag (meaningful only with `panel: true`): instead of
+     * replacing the session panel, merge this spec INTO the existing one —
+     * same-labelled tabs get their items appended, new tabs are added, plain
+     * item lists are appended to the tail. Lets the model grow a panel
+     * incrementally without resending (or truncating) the accumulated content.
+     * Applies only when the fence body is fully complete, so a streaming
+     * partial parse never double-merges. */
+    append?: boolean;
+    /** Root component list. */
+    items: GenuiNode[];
+}
+export interface GenuiText {
+    type: 'text';
+    size?: 'h1' | 'h2' | 'h3' | 'body' | 'muted' | 'caption';
+    content: string;
+    center?: boolean;
+}
+export interface GenuiButton {
+    type: 'button';
+    label: string;
+    tone?: 'primary' | 'danger' | 'success' | 'ghost';
+    full?: boolean;
+    small?: boolean;
+    icon?: string;
+    /** v2: when set, clicking sends this action back to the model. */
+    action?: string;
+}
+export interface GenuiInput {
+    type: 'input';
+    label?: string;
+    placeholder?: string;
+    value?: string;
+    inputType?: 'text' | 'email' | 'password';
+    /** v2: when set, interaction sends this action back to the model. */
+    action?: string;
+    /**
+     * v2.7: stable field id — the value is persisted across refresh/re-render
+     * and collected by a sibling `submit` node (`fields: {id: value}`).
+     */
+    id?: string;
+}
+export interface GenuiSelect {
+    type: 'select';
+    label?: string;
+    options: string[];
+    /** v2: when set, interaction sends this action back to the model. */
+    action?: string;
+    /**
+     * v2.8: default-selected option index (a placeholder option shows instead
+     * when absent, so nothing is silently pre-registered).
+     */
+    selected?: number;
+    /**
+     * v2.8: stable field id — the chosen option persists across refresh and is
+     * collected by a sibling `submit` node (`fields: {id: value}`), like
+     * input/textarea ids.
+     */
+    id?: string;
+}
+export interface GenuiCheckbox {
+    type: 'checkbox';
+    label: string;
+    checked?: boolean;
+    /** v2: when set, interaction sends this action back to the model. */
+    action?: string;
+}
+export interface GenuiLink {
+    type: 'link';
+    label: string;
+    /**
+     * Optional http(s)/mailto target. With `href` the node renders a REAL
+     * anchor (target=_blank + noopener); without it the node renders as plain
+     * styled text — never a dead clickable-looking control.
+     */
+    href?: string;
+}
+/** User-controlled audio from a browser-reachable URL. */
+export interface GenuiAudio {
+    type: 'audio';
+    src: string;
+    /** Visible caption and accessible player name. */
+    alt?: string;
+    loop?: boolean;
+}
+/** User-controlled video from a browser-reachable URL. */
+export interface GenuiVideo {
+    type: 'video';
+    src: string;
+    /** Visible caption and accessible player name. */
+    alt?: string;
+    poster?: string;
+    loop?: boolean;
+    muted?: boolean;
+    aspectRatio?: '16:9' | '4:3' | '1:1' | '9:16';
+}
+export interface GenuiBadge {
+    type: 'badge';
+    label: string;
+    tone?: 'success' | 'warn' | 'danger' | 'accent';
+    icon?: string;
+}
+export interface GenuiStat {
+    type: 'stat';
+    label: string;
+    value: string;
+    delta?: string;
+}
+export interface GenuiProgress {
+    type: 'progress';
+    label?: string;
+    /** 0..100 */
+    value: number;
+    valueLabel?: string;
+}
+export interface GenuiDivider {
+    type: 'divider';
+}
+export interface GenuiAvatar {
+    type: 'avatar';
+    name: string;
+    color?: string;
+}
+export interface GenuiSpacer {
+    type: 'spacer';
+}
+export interface GenuiRow {
+    type: 'row';
+    items: GenuiNode[];
+    wrap?: boolean;
+    spacer?: boolean;
+}
+export interface GenuiCol {
+    type: 'col';
+    items: GenuiNode[];
+    gap?: number;
+}
+export interface GenuiGrid {
+    type: 'grid';
+    cols: number;
+    items: GenuiNode[];
+}
+export interface GenuiCard {
+    type: 'card';
+    title?: string;
+    items: GenuiNode[];
+}
+export interface GenuiList {
+    type: 'list';
+    items: Array<string | {
+        title: string;
+        desc?: string;
+    } | GenuiNode>;
+}
+export interface GenuiTable {
+    type: 'table';
+    columns: string[];
+    rows: Array<Array<string | number>>;
+}
+export interface GenuiChartDatum {
+    label: string;
+    value: number;
+    color?: string;
+}
+export interface GenuiChart {
+    type: 'chart';
+    /** Chart shape: bars (default), line (trend), donut (share). */
+    kind?: 'bars' | 'line' | 'donut';
+    data: GenuiChartDatum[];
+    /** Multi-series grouped bars: one series of data per entry. */
+    series?: Array<{
+        label: string;
+        color?: string;
+        data: GenuiChartDatum[];
+    }>;
+}
+export interface GenuiTab {
+    label: string;
+    items: GenuiNode[];
+}
+export interface GenuiTabs {
+    type: 'tabs';
+    tabs: GenuiTab[];
+}
+export interface GenuiPlotSeries {
+    /** Math expression in x (safe evaluator: sin/cos/tan/pow/sqrt/log/exp/abs/floor/ceil/round/min/max/pi/e). */
+    expr: string;
+    /** Legend label; defaults to the expression. */
+    label?: string;
+    /** Stroke color. */
+    color?: string;
+    /** v2.9 draw shape: line (default), area (fill to the baseline), scatter
+     * (dots only). */
+    kind?: 'line' | 'area' | 'scatter';
+    /** v2: adjustable parameters (e.g. {a: 2} in "a*sin(x)") — one slider each, live re-render. */
+    params?: Array<{
+        name: string;
+        value: number;
+        min?: number;
+        max?: number;
+        step?: number;
+        /** v1.5: animate this parameter (auto-play) from `value` to `animateTo`. */
+        animateTo?: number;
+        /** Animation duration in ms (default 4000). */
+        durationMs?: number;
+        /** Loop the animation (default false). */
+        loop?: boolean;
+    }>;
+}
+export interface GenuiPlot {
+    type: 'plot';
+    /** Functions to draw, in draw order. */
+    series: GenuiPlotSeries[];
+    xMin?: number;
+    xMax?: number;
+    yMin?: number;
+    yMax?: number;
+    title?: string;
+}
+export interface GenuiCallout {
+    type: 'callout';
+    tone?: 'info' | 'success' | 'warning' | 'error';
+    /** Short heading above the body. */
+    title?: string;
+    content: string;
+}
+export interface GenuiStep {
+    title: string;
+    desc?: string;
+}
+export interface GenuiSteps {
+    type: 'steps';
+    /** Completed steps are rendered in the accent color, the rest muted. */
+    current?: number;
+    steps: GenuiStep[];
+}
+export interface GenuiKeyValue {
+    type: 'keyvalue';
+    pairs: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+/** 收编 dsh DiffBlock: file mutations as an inline diff. */
+export interface GenuiDiff {
+    type: 'diff';
+    diffs: Array<{
+        path: string;
+        oldText: string | null;
+        newText: string;
+    }>;
+}
+/** 收编 dsh JsonTree: a structured JSON value for inspection. */
+export interface GenuiJson {
+    type: 'json';
+    /** Any JSON value to render as a tree. */
+    value: unknown;
+}
+/** 收编 dsh CodeBlock: syntax-highlighted code with an explicit language. */
+export interface GenuiCode {
+    type: 'code';
+    lang?: string;
+    code: string;
+}
+export interface GenuiRadio {
+    type: 'radio';
+    label?: string;
+    options: string[];
+    /** Default-selected option index. */
+    selected?: number;
+    /** v2: when set, interaction sends this action back to the model. */
+    action?: string;
+    /**
+     * v2.5: aggregation group name. When set, the selection is recorded into
+     * the block-wide answers registry instead of firing a per-click action — a
+     * sibling `submit` node then collects ALL groups ("交卷" pattern). Without
+     * `group`, the legacy per-click behavior applies.
+     */
+    group?: string;
+    /**
+     * v2.6: correct option for LOCAL grading — the option index (number) or
+     * its label (string). When the group's radio carries this, the `submit`
+     * button grades IN PLACE on click (score + per-question right/wrong +
+     * explanations, zero model round trip).
+     */
+    answer?: number | string;
+    /** v2.6: per-question explanation shown after local grading. */
+    explanation?: string;
+}
+/** Submit node: collects the answers of sibling `radio` groups in this block.
+ * LOCAL-FIRST: when the questions carry `answer` data the click grades IN
+ * PLACE — score, per-question right/wrong, explanations — with no model
+ * round trip, and locks the questions until "重新作答" resets them. Only when
+ * NO question carries answers does it fall back to firing ONE action
+ * (`{type:'submit', answers, total, answered}`). */
+export interface GenuiSubmit {
+    type: 'submit';
+    label: string;
+    /**
+     * Optional action name. Local-first: when ANY question in scope carries
+     * `answer` data the click grades IN PLACE with zero model round trip, so
+     * no action is needed — the spec stays valid without one. Only when NO
+     * question has local answers does the submit need an action to collect
+     * `{type:'submit', answers, total, answered}`; without one the button
+     * renders disabled (honest affordance). Also fired as the reset hook if
+     * `resetAction` is absent.
+     */
+    action?: string;
+    /**
+     * v2.6: optional action fired when the user clicks "重新作答" after a
+     * local grading (e.g. to tell the model the paper was redone). Absent =
+     * reset stays fully local.
+     */
+    resetAction?: string;
+    /**
+     * Optional explicit group list to wait for; when absent the submit enables
+     * once at least one grouped radio has an answer. When present it stays
+     * disabled until EVERY listed group has a recorded answer (the hint shows
+     * the progress).
+     */
+    groups?: string[];
+}
+export interface GenuiSwitch {
+    type: 'switch';
+    label: string;
+    checked?: boolean;
+    /** v2: when set, interaction sends this action back to the model. */
+    action?: string;
+}
+/**
+ * Slider: a range input for numeric form values (v2.9). The current value
+ * shows next to the track; dragging fires the action (debounced by the
+ * block) and, with an `id`, persists across refresh and joins the sibling
+ * submit's `fields` collection (the value is the numeric string).
+ */
+export interface GenuiSlider {
+    type: 'slider';
+    label?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    /** Default value; defaults to `min` (or 0). */
+    value?: number;
+    /** v2: when set, interaction sends this action back to the model. */
+    action?: string;
+    /** v2.9: stable field id — durable value + submit collection. */
+    id?: string;
+}
+export interface GenuiTextarea {
+    type: 'textarea';
+    label?: string;
+    placeholder?: string;
+    rows?: number;
+    value?: string;
+    /** v2.5: when set, blurring the field sends this action with the value. */
+    action?: string;
+    /**
+     * v2.7: stable field id — the value is persisted across refresh/re-render
+     * and collected by a sibling `submit` node (`fields: {id: value}`).
+     */
+    id?: string;
+}
+export interface GenuiAccordionItem {
+    title: string;
+    items: GenuiNode[];
+}
+export interface GenuiAccordion {
+    type: 'accordion';
+    items: GenuiAccordionItem[];
+}
+export interface GenuiCopy {
+    type: 'copy';
+    label?: string;
+    text: string;
+}
+/** Mermaid diagram: flowchart/sequence/class/gantt source rendered lazily. */
+export interface GenuiMermaid {
+    type: 'mermaid';
+    /** Mermaid diagram source (whitelisted diagram kinds at render time). */
+    code: string;
+}
+/** One mesh in a 3D scene. */
+export interface GenuiMesh {
+    /** Primitive geometry, white-listed. */
+    shape: 'box' | 'sphere' | 'cone' | 'cylinder' | 'torus';
+    /** Mesh color. */
+    color?: string;
+    /** [x, y, z] position. */
+    position?: [number, number, number];
+    /** [x, y, z] rotation in radians. */
+    rotation?: [number, number, number];
+    /** Uniform scale, or [sx, sy, sz]. */
+    scale?: number | [number, number, number];
+    /** Box size [w, h, d] or sphere/cone/cylinder radius. */
+    size?: number | [number, number, number];
+}
+/** 3D scene rendered with three.js (lazily imported). */
+export interface GenuiScene3D {
+    type: 'scene3d';
+    title?: string;
+    meshes: GenuiMesh[];
+    /** Ambient light intensity (0..2). */
+    ambient?: number;
+    /** Background color; default transparent. */
+    background?: string;
+}
+export interface GenuiTimelineItem {
+    /** Title of the event. */
+    title: string;
+    /** Secondary description. */
+    desc?: string;
+    /** Optional timestamp label. */
+    time?: string;
+}
+export interface GenuiTimeline {
+    type: 'timeline';
+    items: GenuiTimelineItem[];
+}
+export interface GenuiFileTreeNode {
+    /** File or directory name. */
+    name: string;
+    /** Directory when true (collapsible children). */
+    type?: 'file' | 'dir';
+    /** Child nodes (dirs only). */
+    children?: GenuiFileTreeNode[];
+}
+export interface GenuiFileTree {
+    type: 'file-tree';
+    items: GenuiFileTreeNode[];
+}
+export interface GenuiBreadcrumb {
+    type: 'breadcrumb';
+    items: string[];
+}
+export interface GenuiQuizOption {
+    label: string;
+    /** True when this option is the correct answer. */
+    correct?: boolean;
+    /** Per-option feedback shown after selection. */
+    feedback?: string;
+}
+export interface GenuiQuiz {
+    type: 'quiz';
+    /** The question text. */
+    question: string;
+    /** Answer options; exactly one should be correct. */
+    options: GenuiQuizOption[];
+    /** Shown after answering (either way). */
+    explanation?: string;
+    /** Reset the quiz when this value changes (e.g. a question id). */
+    id?: string;
+    /** v2.5: when set, answering sends this action with the chosen answer
+     * (`{type:'quiz', question, answer, correct}`) so the model can collect
+     * or grade it. */
+    action?: string;
+}
+/** Editorial diagram kinds, ported from cathrynlavery/diagram-design (27 types). */
+export declare const DIAGRAM_KINDS: readonly ["architecture", "it-state", "flowchart", "sequence", "state", "er", "timeline", "swimlane", "quadrant", "radar", "loop", "nested", "tree", "org-chart", "layers", "venn", "pyramid", "bar", "line", "gantt", "scatter", "high-level", "process", "medallion", "data-flow", "dp-integration", "dp-security-matrix"];
+export type GenuiDiagramKind = typeof DIAGRAM_KINDS[number];
+/** Diagram surface variant: light / dark follow the host theme; editorial is the full skin. */
+export type GenuiDiagramVariant = 'light' | 'dark' | 'editorial';
+/** Node treatment classes (map to the diagram-design semantic fills/strokes). */
+export type GenuiDiagramNodeType = 'focal' | 'backend' | 'store' | 'external' | 'input' | 'optional' | 'security';
+/** One positioned node in a coordinate-mode diagram. */
+export interface GenuiDiagramNode {
+    /** Stable node id referenced by edges. */
+    id: string;
+    /** Human-readable label (Geist sans in the renderer). */
+    label: string;
+    /** Optional technical sublabel (Geist mono in the renderer). */
+    sub?: string;
+    /** Semantic treatment; `focal` is budgeted (max 2 per diagram). */
+    type?: GenuiDiagramNodeType;
+    /** Position / size (coordinate-mode kinds only). 4px grid is enforced at render. */
+    x?: number;
+    y?: number;
+    w?: number;
+    h?: number;
+    /** Optional rectangular type tag (e.g. `API`). */
+    tag?: string;
+}
+/** One connector between two nodes. */
+export interface GenuiDiagramEdge {
+    /** Source node id. */
+    from: string;
+    /** Target node id. */
+    to: string;
+    /** Optional edge label (all-caps, <=14 chars in the renderer). */
+    label?: string;
+    /** Stroke semantics: solid (default), dashed (optional/async), accent, link (HTTP/API). */
+    kind?: 'solid' | 'dashed' | 'accent' | 'link';
+    /** Route hint; `auto` (default) lets the renderer choose orthogonal routing. */
+    route?: 'auto' | 'orthogonal' | 'straight';
+}
+/** Optional brand override; every key maps to a diagram-design semantic token. */
+export interface GenuiDiagramTheme {
+    paper?: string;
+    'paper-2'?: string;
+    ink?: string;
+    muted?: string;
+    soft?: string;
+    rule?: string;
+    accent?: string;
+    'accent-tint'?: string;
+    link?: string;
+}
+/** Zone container: a labelled region grouping related nodes (max 3). */
+export interface GenuiDiagramZone {
+    /** Zone label (mono uppercase eyebrow in the renderer). */
+    label: string;
+    /** Bounding box in the same canvas space as the nodes. */
+    x?: number;
+    y?: number;
+    w?: number;
+    h?: number;
+}
+/**
+ * Editorial diagram (diagram-design port): a white-listed declarative diagram
+ * rendered as inline SVG by the browser. `kind` selects the layout grammar
+ * (coordinate kinds place nodes via x/y; rule kinds auto-layout from data),
+ * `variant` selects the skin, and `theme` overrides semantic tokens. The
+ * renderer enforces the editorial constraints — orthogonal connectors, 4px
+ * grid, complexity budget, focal accent budget — so the model cannot emit
+ * "AI slop" schematics.
+ */
+export interface GenuiDiagram {
+    type: 'diagram';
+    /** The 27-type editorial vocabulary. */
+    kind: GenuiDiagramKind;
+    /** Surface skin; default follows the host theme. */
+    variant?: GenuiDiagramVariant;
+    /** Optional diagram title (Instrument Serif in the renderer). */
+    title?: string;
+    /** Nodes (coordinate kinds use x/y/w/h; rule kinds may omit positions). */
+    nodes: GenuiDiagramNode[];
+    /** Connectors. */
+    edges?: GenuiDiagramEdge[];
+    /** Optional labelled regions grouping nodes (max 3). */
+    zones?: GenuiDiagramZone[];
+    /** Optional semantic-token overrides. */
+    theme?: GenuiDiagramTheme;
+}
+/** Preset chart kinds the `echart` node can build from `data`/`series` without
+ * a full ECharts option. Each maps to a themed option template. */
+export type EChartPreset = 'bar' | 'line' | 'area' | 'pie' | 'scatter';
+/** ECharts node: renders a full ECharts chart. Two modes:
+ *
+ * 1. **Full option** (`option` set): the model provides a standard ECharts
+ *    `EChartsCoreOption` object directly. This is the escape hatch for
+ *    custom chart types, complex series, or advanced features (dataZoom,
+ *    visualMap, etc.).
+ * 2. **Preset shorthand** (`preset` + `data`/`series`): the model provides
+ *    the same simple `data`/`series` shape as the `chart` node, and the
+ *    component builds a themed ECharts option automatically. This is the
+ *    easy upgrade path: change `type: 'chart'` to `type: 'echart'` and add
+ *    `preset`.
+ *
+ * The echarts engine is lazy-loaded (lib/assets/echarts.js) only when an
+ * `echart` node appears in a spec. */
+export interface GenuiEChart {
+    type: 'echart';
+    /** Optional title shown above the chart. */
+    title?: string;
+    /** Chart height in pixels (default 300). */
+    height?: number;
+    /** Preset: builds the ECharts option from `data`/`series` when `option`
+     * is absent. */
+    preset?: EChartPreset;
+    /** Simple data for preset mode (same shape as `chart.data`). */
+    data?: GenuiChartDatum[];
+    /** Multi-series for preset mode (same shape as `chart.series`). */
+    series?: Array<{
+        label: string;
+        color?: string;
+        data: GenuiChartDatum[];
+    }>;
+    /** Full ECharts option object. When present, `preset`/`data`/`series` are
+     * ignored. This is a pass-through to `echarts.setOption`. */
+    option?: Record<string, unknown>;
+}
+/** Parse the raw fence body as a GenuiSpec, or null when it is not one. */
+export declare function parseGenuiSpec(raw: string): GenuiSpec | null;
+/**
+ * Wrap a bare component object into a col root. Returns null when `value` is
+ * not component-shaped (no usable `type`). `panel`/`append` live on the root
+ * spec, so they are hoisted onto the wrapper.
+ */
+export declare function wrapSingleComponentRoot(value: unknown): GenuiSpec | null;
+/** Basic structural guard: is this object a valid GenuiSpec? */
+export declare function isGenuiSpec(value: unknown): value is GenuiSpec;

package/lib/types/client/toolview.d.ts

@@ -0,0 +1,7 @@
+import type { ToolCallViewProps } from '@deepseek-ai/dsh-client-ui-tool/client';
+/**
+ * Keyed toolview for the `render_ui` tool. `block` is the settled result
+ * node once the call completes; while it runs (or on replay without meta)
+ * the summary fallback is shown.
+ */
+export declare function GenuiToolView({ toolName, block, sessionId }: ToolCallViewProps): import("react").JSX.Element;

package/lib/types/index.d.ts

@@ -0,0 +1 @@
+export * from './plugin/index';

package/lib/types/plugin/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * GenUI plugin: teaches the model the ```dsh-ui fence syntax for emitting
+ * declarative UI components inline in its reply. The browser half renders the
+ * fence through GenuiBlock (ui-primitives); this host half only tells the
+ * model the language exists, so a session without the plugin simply never
+ * emits fences and nothing changes.
+ *
+ * The section is a convention section (order 100-199), placed after the bash
+ * guidance so the model sees it among its output-format rules.
+ * @module @changfenhuang/dsh-genui
+ */
+import { Context } from '@deepseek-ai/cordis';
+/** Convention: tool guidance uses 100–199; bash's section is 104. */
+export declare const GENUI_SECTION_ORDER = 105;
+/** The fence language description injected into every assembled system prompt.
+ *  Deliberately slim: the `genui` skill carries the full component→field
+ *  mapping; this section keeps only the contract that must always be
+ *  present (fence syntax, type whitelist, and critical behavioral rules). */
+export declare const GENUI_SECTION_TEXT = "You can render interactive UI components INSIDE your reply \u2014 between paragraphs \u2014 by emitting a fenced block with the language tag `dsh-ui` containing a JSON spec:\n\n```dsh-ui\n{\"title\":\"\u53EF\u9009\u6807\u9898\",\"gap\":14,\"items\":[...]}\n```\n\nThe spec is a white-listed component tree rendered inline where the fence sits. Only these `type` values; the `genui` skill, when available, carries the full content\u2192component mapping and per-component field details:\n\n- \u5E03\u5C40: text \u00B7 row \u00B7 col \u00B7 grid \u00B7 card \u00B7 divider \u00B7 spacer\n- \u5C55\u793A: badge \u00B7 stat \u00B7 progress \u00B7 list \u00B7 table \u00B7 keyvalue \u00B7 avatar \u00B7 audio \u00B7 video \u00B7 timeline \u00B7 file-tree \u00B7 breadcrumb \u00B7 callout \u00B7 steps \u00B7 diff \u00B7 json \u00B7 code \u00B7 copy\n- \u56FE\u8868: chart (bars|line|donut) \u00B7 echart (preset|option) \u00B7 plot (\u51FD\u6570\u56FE)\n- \u4EA4\u4E92: button \u00B7 input \u00B7 textarea \u00B7 select \u00B7 checkbox \u00B7 switch \u00B7 slider \u00B7 radio \u00B7 submit \u00B7 quiz \u00B7 link \u00B7 tabs \u00B7 accordion\n- \u9AD8\u7EA7: mermaid (flowchart/sequence/class/gantt/pie/er/state/journey) \u00B7 diagram (\u7F16\u8F91\u7EA7\u67B6\u6784/\u6D41\u7A0B\u56FE\uFF0C27 \u79CD kind) \u00B7 scene3d (3D WebGL)\n\nRules:\n- \u89E6\u53D1: \u7ED3\u6784\u5316\u8868\u8FBE\u4F18\u4E8E\u7EAF\u6587\u672C\u65F6\u4E3B\u52A8\u7528\uFF08\u8981\u70B9\u3001\u5F3A\u8C03\u3001\u5BF9\u6BD4\u3001\u6D41\u7A0B\u3001\u6B65\u9AA4\u3001\u72B6\u6001\u3001\u6570\u636E\u3001\u6F14\u793A\uFF09\uFF0C\u7EAF\u95EE\u7B54\u4E0E\u4E00\u53E5\u8BDD\u4E0D\u5957 UI\uFF1B\u4E00\u4E2A\u4E3B\u9898\u4E00\u4E2A\u4E3B\u7EC4\u4EF6\uFF0C\u6BCF\u6B21 3\u20138 \u4E2A\u7EC4\u4EF6\uFF0C\u540C\u4E00\u6570\u636E\u4E0D\u91CD\u590D\u51FA\u73B0\u3002\n- JSON \u4E25\u683C: \u574F\u56F4\u680F\u964D\u7EA7\u4E3A\u4EE3\u7801\u5757\uFF1B\u22653 \u8282\u70B9\u6216\u542B table \u7684\u56F4\u680F\u53D1\u51FA\u524D\u8C03\u7528 validate_dsh_ui\uFF0C\u274C \u4FEE\u597D\u518D\u53D1\uFF08\u82E5\u9644\u300C\u5DF2\u81EA\u52A8\u4FEE\u590D\u300DJSON \u7167\u6284\u5373\u53EF\uFF09\u3002\n- \u89C4\u6A21: \u2264200 \u8282\u70B9\u3001\u5D4C\u5957\u22648 \u5C42\uFF08\u8D85\u51FA\u88AB\u622A\u65AD\uFF09\uFF1B3D mesh 1\u20135\uFF1Bplot \u7ED9\u5408\u7406 xMin/xMax\u3002\n- LOCAL-FIRST + actions: UI \u80FD\u81EA\u5DF1\u505A\u7684\u72B6\u6001\u53D8\u5316\uFF08\u5224\u5377\u3001\u5224\u9898\u3001\u91CD\u7F6E\u3001\u5C55\u5F00\u3001\u9009\u4E2D\uFF09\u5C31\u5730\u5B8C\u6210\uFF0C\u96F6\u5F80\u8FD4\uFF1Baction \u53EA\u7528\u4E8E\u5FC5\u987B\u6A21\u578B\u53C2\u4E0E\u7684\u4E8B\u3002\u4EA4\u4E92\u7EC4\u4EF6\u5E26 \"action\":\"name\"\uFF0C\u4EA4\u4E92\u4EE5 [genui-action] name + \u7EC4\u4EF6\u6570\u636E\u56DE\u4F20\uFF0C\u5C4A\u65F6\u91CD\u6E32\u67D3\u66F4\u65B0 UI\uFF1B\u65E0 action \u7684\u6309\u94AE\u7981\u7528\u3002\n- Durable state: \u4EA4\u4E92\u72B6\u6001\u6309\u300C\u4F1A\u8BDD+\u5185\u5BB9\u6307\u7EB9\u300D\u6301\u4E45\u5316\u2014\u2014\u5237\u65B0/\u91CD\u653E\u6062\u590D\uFF1B\u91CD\u6E32\u67D3\u76F8\u540C\u5185\u5BB9\u4FDD\u7559\uFF0C\u65B0\u5185\u5BB9\u91CD\u7F6E\u3002\n- \u5377\u5B50\u6A21\u5F0F: \u6BCF\u9898\u4E00\u4E2A radio\uFF08group+answer+explanation\uFF09+ \u4E00\u4E2A submit\uFF08groups \u5168\u5217\uFF09\uFF0C\u672C\u5730\u5224\u5206\u3002\n- Secrets ban: \u4E0D\u7D22\u53D6\u5BC6\u7801\u3001API Key\u3001Token\u3001\u6062\u590D\u7801\uFF1B\u9700\u8981\u65F6\u62D2\u7EDD\u5E76\u89E3\u91CA\u3002\n- Tool channel: render_ui \u5DE5\u5177\u628A\u540C\u4E00 spec \u6E32\u67D3\u4E3A\u5DE5\u5177\u884C\u5361\u7247\uFF08\u4EA4\u4ED8\u7269\u578B\u754C\u9762\u7528\uFF09\uFF1B\u56F4\u680F\u7528\u4E8E\u56DE\u7B54\u5185\u8054 UI\u3002\n- Panel: \"panel\":true \u53EA\u6E32\u67D3\u8FDB\u4F1A\u8BDD\u9762\u677F dock \u5E76\u539F\u5730\u66F4\u65B0\uFF1B\"append\":true \u8FFD\u52A0\u5408\u5E76\uFF08\u540C\u6807\u7B7E tabs \u8FFD\u52A0/\u65B0\u6807\u7B7E\u52A0\u5165/\u5C3E\u90E8\u8FFD\u52A0\uFF09\uFF1B\u4E0A\u9650 200 \u8282\u70B9/200 \u6B21\u8FFD\u52A0\uFF0C\u6EE1\u4E86\u53D1 replace \u91CD\u5EFA\u3002\u9762\u677F\u7EC4\u4EF6\u6765\u7684 [genui-action] \u53EA\u56DE\u4E00\u4E2A panel:true \u56F4\u680F + \u81F3\u591A\u4E00\u884C 10 \u5B57\u5185\u786E\u8BA4\uFF0C\u4E0D\u89E3\u91CA\u3001\u4E0D\u7528\u666E\u901A\u56F4\u680F\u3002";
+/**
+ * Register the GenUI output-language section and the render_ui tool.
+ * @param ctx - cordis context.
+ */
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;

package/lib/types/plugin/invariant.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Package-owned invariant companion for `@changfenhuang/dsh-genui`.
+ * @module @changfenhuang/dsh-genui/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "genui-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;