@openviking/react 0.1.1 → 0.1.2

package/dist/components/tui/command-catalog.d.ts

@@ -0,0 +1,58 @@
+/** 等待中的记录按命令选择的骨架。Skeleton chosen for a pending record. */
+export type TuiSkeletonKind = 'search' | 'resource' | 'tree' | 'status' | 'write' | 'generic';
+export interface TuiCommandGroup {
+    key: string;
+    label: string;
+}
+export interface TuiCommandParam {
+    label: string;
+    description: string;
+    required?: boolean;
+    defaultValue?: string;
+}
+export interface TuiCommandOption {
+    token: string;
+    description: string;
+    required?: boolean;
+    defaultValue?: string;
+}
+/**
+ * 一条 CLI 命令的元数据。名称、参数、说明与示例由宿主提供，
+ * 组件用它生成补全、参数提示和等待骨架。
+ *
+ * Metadata of one CLI command. Names, arguments, copy and examples come from
+ * the host; the component derives completion, parameter hints and
+ * pending skeletons from them.
+ */
+export interface TuiCommandExample {
+    value: string;
+    label?: string;
+}
+export interface TuiCommandDefinition {
+    name: string;
+    /** 接受补全时填入的真实前缀，默认 name；例如由宿主提供 ov read。 */
+    inputText?: string;
+    aliases?: readonly string[];
+    group?: string;
+    description: string;
+    usage: string;
+    summary?: string;
+    params?: readonly TuiCommandParam[];
+    options?: readonly TuiCommandOption[];
+    examples?: readonly (string | TuiCommandExample)[];
+    skeleton?: TuiSkeletonKind;
+}
+export interface TuiParsedCommandInput {
+    /** 命令名，不含开头的斜杠。Command name without the leading slash. */
+    name: string;
+    /** 命令名之后的内容。Everything after the command name. */
+    rest: string;
+    /** 命令名后是否已输入空白。Whether whitespace follows the command name. */
+    hasTrailingSpace: boolean;
+}
+/** 解析 `/name args`；不以斜杠开头时返回 `null`。Parses `/name args`. */
+export declare function parseTuiCommandInput(value: string): TuiParsedCommandInput | null;
+/** 取出命令名，忽略参数与斜杠。Resolves the command name of any input. */
+export declare function resolveTuiCommandName(value: string): string;
+/** 骨架由宿主的命令描述提供；未知命令使用通用形态。 */
+export declare function resolveTuiSkeleton(command: TuiCommandDefinition | undefined): TuiSkeletonKind;

package/dist/components/tui/command-completion.d.ts

@@ -0,0 +1,19 @@
+import type { TuiCommandDefinition } from './command-catalog.js';
+export interface TuiCommandQuery {
+    keyword: string;
+    scope: string | null;
+    matches: readonly TuiCommandDefinition[];
+    automatic: boolean;
+    canOpenPalette: boolean;
+    prefixTarget?: string;
+    colorInput: boolean;
+}
+export interface TuiInlineCompletion {
+    kind: 'prefix' | 'command';
+    suffix: string;
+    value: string;
+}
+/** 只根据宿主的完整输入前缀推导命名空间和候选；参数阶段不继续补命令。 */
+export declare function getTuiCommandQuery(value: string, commands: readonly TuiCommandDefinition[]): TuiCommandQuery;
+/** 提示永远不写入 value；只有显式接受时才使用返回的完整值。 */
+export declare function getTuiInlineCompletion(value: string, query: TuiCommandQuery, selected: TuiCommandDefinition | undefined, paletteOpen?: boolean): TuiInlineCompletion | undefined;

package/dist/components/tui/command-definitions.d.ts

@@ -0,0 +1,10 @@
+import type { TuiCommandDefinition, TuiCommandGroup } from './command-catalog.js';
+export interface TuiCommandSection {
+    group: TuiCommandGroup;
+    commands: readonly TuiCommandDefinition[];
+}
+/** 只匹配宿主目录，不包含内置业务命令或请求。 */
+export declare function findTuiCommand(text: string, commands: readonly TuiCommandDefinition[]): TuiCommandDefinition | undefined;
+export declare function filterTuiCommands(keyword: string, commands: readonly TuiCommandDefinition[]): readonly TuiCommandDefinition[];
+/** 保留宿主分组顺序，未声明的分组按首次出现顺序追加。 */
+export declare function groupTuiCommands(commands: readonly TuiCommandDefinition[], groups?: readonly TuiCommandGroup[]): readonly TuiCommandSection[];

package/dist/components/tui/command-input.d.ts

@@ -0,0 +1,16 @@
+import type { TuiCommandDefinition } from './command-catalog.js';
+export interface TuiCommandInputMatch {
+    command: TuiCommandDefinition;
+    leadingWhitespace: string;
+    prefix: string;
+    rest: string;
+}
+/** 填入的真实命令前缀由宿主提供，不在组件中绑定某个 CLI。 */
+export declare function getTuiCommandInputText(command: TuiCommandDefinition): string;
+export declare function matchTuiCommandInput(value: string, commands: readonly TuiCommandDefinition[]): TuiCommandInputMatch | undefined;
+/** 仅用于接受候选、示例或历史；不改写用户正在编辑/组合的文本。 */
+export declare function formatTuiCommandInput(value: string, commands: readonly TuiCommandDefinition[]): string;
+export declare function getTuiArgumentHints(command: TuiCommandDefinition): {
+    label: string;
+    description: string;
+}[];