@openviking/react 0.1.0 → 0.1.2

package/dist/components/tui/tui-assist.d.ts

@@ -0,0 +1,15 @@
+import type { RefObject } from 'react';
+import type { ResolvedTuiLabels } from './tui-labels.js';
+import type { TuiCompletion } from './use-tui-completion.js';
+export interface TuiAssistProps {
+    anchorRef: RefObject<HTMLDivElement | null>;
+    assistId: string;
+    labels: ResolvedTuiLabels;
+    completion: TuiCompletion;
+    activeIndex: number;
+    onActiveIndexChange: (index: number) => void;
+    onPick: (value: string) => void;
+    onDismiss: (value: string) => void;
+}
+/** 候选浮层和联动详情；现代浏览器使用顶层 Popover，保留宿主主题继承。 */
+export declare function TuiAssist({ anchorRef, assistId, labels, completion, activeIndex, onActiveIndexChange, onPick, onDismiss, }: TuiAssistProps): import("react").JSX.Element | null;

package/dist/components/tui/tui-code-block.d.ts

@@ -0,0 +1,8 @@
+import type { ResolvedTuiLabels } from './tui-labels.js';
+/** 文本代码块共用复制与资源链接行为。 */
+export declare function TuiCodeBlock({ text, labels, onCopy, onOpenUri, }: {
+    text: string;
+    labels: ResolvedTuiLabels;
+    onCopy?: (text: string) => void;
+    onOpenUri?: (uri: string) => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,9 @@
+import type { TuiCommandHelpContent } from './types.js';
+import type { ResolvedTuiLabels } from './tui-labels.js';
+export interface TuiCommandHelpProps {
+    content: TuiCommandHelpContent;
+    onPick?: (command: string) => void;
+    labels: ResolvedTuiLabels;
+}
+/** 命令帮助：按分组列出命令，点击填入输入框。 */
+export declare function TuiCommandHelp({ content, onPick, labels, }: TuiCommandHelpProps): import("react").JSX.Element;

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

@@ -0,0 +1,6 @@
+/** 展示宿主命令前缀与动作，保留原始大小写和空白。 */
+export declare function TuiCommandText({ text, name, namespaceOnly, }: {
+    text: string;
+    name?: string;
+    namespaceOnly?: boolean;
+}): import("react").JSX.Element;

package/dist/components/tui/tui-composer.d.ts

@@ -0,0 +1,24 @@
+import type { RefObject } from 'react';
+import type { ResolvedTuiLabels } from './tui-labels.js';
+import type { TuiCompletion } from './use-tui-completion.js';
+export interface TuiComposerProps {
+    anchorRef: RefObject<HTMLDivElement | null>;
+    assistId: string;
+    onFocus: () => void;
+    onDismiss: (value: string) => void;
+    onRequestPalette: () => void;
+    value: string;
+    history: readonly string[];
+    labels: ResolvedTuiLabels;
+    completion: TuiCompletion;
+    disabled: boolean;
+    readOnly: boolean;
+    canSubmit: boolean;
+    activeIndex: number;
+    onActiveIndexChange: (index: number | ((current: number) => number)) => void;
+    onValueChange?: (value: string) => void;
+    onSubmit?: (command: string) => void;
+    onOpenUri?: (uri: string) => void;
+}
+/** 命令输入区：受控输入、键盘补全与提交意图。 */
+export declare function TuiComposer({ anchorRef, assistId, onFocus, onDismiss, onRequestPalette, value, history, labels, completion, disabled, readOnly, canSubmit, activeIndex, onActiveIndexChange, onValueChange, onSubmit, onOpenUri, }: TuiComposerProps): import("react").JSX.Element;

package/dist/components/tui/tui-copy-button.d.ts

@@ -0,0 +1,9 @@
+export interface TuiCopyButtonProps {
+    text: string;
+    label: string;
+    copiedLabel: string;
+    onCopy?: (text: string) => void;
+    className?: string;
+}
+/** 复制按钮：成功后短暂显示已复制，并通知宿主。 */
+export declare function TuiCopyButton({ text, label, copiedLabel, onCopy, className, }: TuiCopyButtonProps): import("react").JSX.Element;

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

@@ -0,0 +1,14 @@
+import type { RefObject, UIEventHandler } from 'react';
+import type { TuiInlineCompletion } from './command-completion.js';
+import type { TuiCommandInputMatch } from './command-input.js';
+/** 原生 textarea 负责编辑与选区，镜像只绘制颜色和不属于输入值的参数提示。 */
+export declare function TuiInputMirror({ value, input, inline, colorInput, onOpenUri, onScroll, mirrorRef, hintId, }: {
+    value: string;
+    input: TuiCommandInputMatch | undefined;
+    inline?: TuiInlineCompletion;
+    colorInput?: boolean;
+    onOpenUri?: (uri: string) => void;
+    onScroll: UIEventHandler<HTMLSpanElement>;
+    mirrorRef: RefObject<HTMLSpanElement | null>;
+    hintId: string;
+}): import("react").JSX.Element;

package/dist/components/tui/tui-labels-zh.d.ts

@@ -0,0 +1,2 @@
+import type { ResolvedTuiLabels } from './tui-labels.js';
+export declare const ZH_TUI_LABELS: ResolvedTuiLabels;

package/dist/components/tui/tui-labels.d.ts

@@ -0,0 +1,5 @@
+import type { TuiLabels } from './types.js';
+/** 补齐当前语言的默认界面文案。 */
+export type ResolvedTuiLabels = Required<TuiLabels>;
+export declare const DEFAULT_TUI_LABELS: ResolvedTuiLabels;
+export declare function resolveTuiLabels(labels?: TuiLabels, locale?: 'en' | 'zh'): ResolvedTuiLabels;

package/dist/components/tui/tui-markdown-renderers.d.ts

@@ -0,0 +1,10 @@
+import type { Components } from 'react-markdown';
+import type { ResolvedTuiLabels } from './tui-labels.js';
+export interface TuiMarkdownOptions {
+    labels: ResolvedTuiLabels;
+    onOpenUri?: (uri: string) => void;
+    onCopy?: (text: string) => void;
+}
+export declare const TuiMarkdownContext: import("react").Context<TuiMarkdownOptions | null>;
+/** Stable component types preserve DOM identity, focus and copy feedback across input updates. */
+export declare const TUI_MARKDOWN_COMPONENTS: Components;

package/dist/components/tui/tui-markdown.d.ts

@@ -0,0 +1,6 @@
+import { type TuiMarkdownOptions } from './tui-markdown-renderers.js';
+export interface TuiMarkdownProps extends TuiMarkdownOptions {
+    text: string;
+}
+/** Markdown uses stable renderers; callbacks and labels flow through the instance context. */
+export declare function TuiMarkdown({ text, ...options }: TuiMarkdownProps): import("react").JSX.Element;

package/dist/components/tui/tui-param-hint.d.ts

@@ -0,0 +1,7 @@
+import type { TuiCommandDefinition } from './command-catalog.js';
+import type { ResolvedTuiLabels } from './tui-labels.js';
+export declare function TuiParamHint({ command, labels, onPick, }: {
+    command: TuiCommandDefinition;
+    labels: ResolvedTuiLabels;
+    onPick: (value: string) => void;
+}): import("react").JSX.Element;

package/dist/components/tui/tui-record-time.d.ts

@@ -0,0 +1,11 @@
+import type { ResolvedTuiLabels } from './tui-labels.js';
+import type { TuiRecord } from './types.js';
+type RecordTime = Pick<TuiRecord, 'createdAt' | 'createdAtMs'>;
+/** 按实际经过的毫秒计算相对时间；展示字符串不参与日期解析。 */
+export declare function formatTuiRecordTime(record: RecordTime, labels: ResolvedTuiLabels, now?: number): string | undefined;
+/** 客户端渲染时读取时钟，SSR 与 hydration 首屏使用相同的兜底文案。 */
+export declare function TuiRecordTime({ record, labels, }: {
+    record: RecordTime;
+    labels: ResolvedTuiLabels;
+}): import("react").JSX.Element | null;
+export {};

package/dist/components/tui/tui-record.d.ts

@@ -0,0 +1,13 @@
+import type { TuiCommandDefinition } from './command-catalog.js';
+import type { ResolvedTuiLabels } from './tui-labels.js';
+import type { TuiRecord } from './types.js';
+export interface TuiRecordProps {
+    record: TuiRecord;
+    command?: TuiCommandDefinition;
+    labels: ResolvedTuiLabels;
+    onOpenUri?: (uri: string) => void;
+    onCopy?: (text: string) => void;
+    onPickCommand?: (command: string) => void;
+}
+/** 一条执行记录：命令回显、状态与结果。 */
+export declare function TuiRecordItem(props: TuiRecordProps): import("react").JSX.Element;

package/dist/components/tui/tui-resource-preview.d.ts

@@ -0,0 +1,10 @@
+import type { TuiResourcePreviewContent } from './types.js';
+import type { ResolvedTuiLabels } from './tui-labels.js';
+export interface TuiResourcePreviewProps {
+    content: TuiResourcePreviewContent;
+    onOpenUri?: (uri: string) => void;
+    onCopy?: (text: string) => void;
+    labels: ResolvedTuiLabels;
+}
+/** 单个资源正文预览。A single resource body preview. */
+export declare function TuiResourcePreview({ content, onOpenUri, onCopy, labels, }: TuiResourcePreviewProps): import("react").JSX.Element;

package/dist/components/tui/tui-resource-tree.d.ts

@@ -0,0 +1,10 @@
+import type { TuiResourceTreeContent } from './types.js';
+export interface TuiResourceTreeProps {
+    content: TuiResourceTreeContent;
+    onOpenUri?: (uri: string) => void;
+    loadMoreLabel: string;
+    noResultLabel: string;
+    resourceLabel: string;
+}
+/** 资源树结果：有明细时按列对齐，否则逐行列出。 */
+export declare function TuiResourceTree({ content, onOpenUri, loadMoreLabel, noResultLabel, resourceLabel, }: TuiResourceTreeProps): import("react").JSX.Element;

package/dist/components/tui/tui-result-header.d.ts

@@ -0,0 +1,7 @@
+import type { TuiRecordStatus } from './types.js';
+/** 命令名与执行状态；图标通过名称表达状态。 */
+export declare function TuiResultHeader({ command, status, label, }: {
+    command: string;
+    status: TuiRecordStatus;
+    label: string;
+}): import("react").JSX.Element;

package/dist/components/tui/tui-result-text.d.ts

@@ -0,0 +1,5 @@
+import type { TuiCommandDefinition } from './command-catalog.js';
+/** 命令已出现在卡片头时，不重复显示同名正文标题。 */
+export declare function getVisibleTuiResultTitle(title: string | undefined, command?: TuiCommandDefinition): string | undefined;
+export declare function getTuiResultText(text: string, command?: TuiCommandDefinition): string;
+export declare function isTuiJson(text: string): boolean;

package/dist/components/tui/tui-search-list.d.ts

@@ -0,0 +1,8 @@
+import type { TuiSearchListContent } from './types.js';
+export interface TuiSearchListProps {
+    content: TuiSearchListContent;
+    onOpenUri?: (uri: string) => void;
+    noResultLabel: string;
+}
+/** 检索结果列表。Search result list. */
+export declare function TuiSearchList({ content, onOpenUri, noResultLabel, }: TuiSearchListProps): import("react").JSX.Element;

package/dist/components/tui/tui-skeleton.d.ts

@@ -0,0 +1,6 @@
+import type { TuiSkeletonKind } from './command-catalog.js';
+export interface TuiSkeletonProps {
+    kind: TuiSkeletonKind;
+}
+/** 等待中的骨架；按命令选择形态，未知命令使用通用骨架。 */
+export declare function TuiSkeleton({ kind }: TuiSkeletonProps): import("react").JSX.Element;

package/dist/components/tui/tui-status-card.d.ts

@@ -0,0 +1,7 @@
+import type { TuiStatusContent } from './types.js';
+export interface TuiStatusCardProps {
+    content: TuiStatusContent;
+    onOpenUri?: (uri: string) => void;
+}
+/** 键值状态卡片。Key/value status card. */
+export declare function TuiStatusCard({ content, onOpenUri }: TuiStatusCardProps): import("react").JSX.Element;

package/dist/components/tui/tui-text.d.ts

@@ -0,0 +1,10 @@
+/** Literal/code tokens end at whitespace or quoting delimiters, not filename punctuation. */
+export declare const TUI_URI_PATTERN: RegExp;
+/** Prose retains sentence punctuation outside automatic links. */
+export declare const TUI_PROSE_URI_PATTERN: RegExp;
+/** Resource targets permit only explicit resource or web navigation schemes. */
+export declare function getTuiSafeHref(uri: string | undefined): string | undefined;
+/** 复制文本到剪贴板；不可用时返回 `false`，不抛出。 */
+export declare function copyTuiText(text: string): Promise<boolean>;
+/** Validate JSON, then indent its original tokens without rewriting values. */
+export declare function formatTuiJson(text: string): string;

package/dist/components/tui/tui-uri-text.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+export interface TuiUriTextProps {
+    text: string;
+    onOpenUri?: (uri: string) => void;
+    /** 编辑镜像隐藏重复文字，但保留链接语义及输入框焦点。 */
+    editor?: boolean;
+    /** Every caller declares its content semantics; literal values retain filename punctuation. */
+    mode: 'prose' | 'literal';
+}
+/** A validated native link; rejected targets remain plain text. */
+export declare function TuiUriLink({ uri, children, onOpenUri, editor, className, }: {
+    uri?: string;
+    children: ReactNode;
+    onOpenUri?: (uri: string) => void;
+    editor?: boolean;
+    className?: string;
+}): import("react").JSX.Element;
+/** 把纯文本中的 URI 渲染成链接；宿主可通过回调接管打开。 */
+export declare function TuiUriText({ text, onOpenUri, editor, mode, }: TuiUriTextProps): import("react").JSX.Element;

package/dist/components/tui/tui-write-result.d.ts

@@ -0,0 +1,7 @@
+import type { TuiWriteResultContent } from './types.js';
+export interface TuiWriteResultProps {
+    content: TuiWriteResultContent;
+    onOpenUri?: (uri: string) => void;
+}
+/** 写入结果。Write result. */
+export declare function TuiWriteResult({ content, onOpenUri }: TuiWriteResultProps): import("react").JSX.Element;

package/dist/components/tui/tui.d.ts

@@ -1 +1,11 @@
-export {};
+import type { TuiProps } from './types.js';
+export type { TuiCommandDefinition, TuiCommandExample, TuiCommandGroup, TuiCommandParam, TuiCommandOption, TuiSkeletonKind, } from './command-catalog.js';
+export type { TuiCommandHelpContent, TuiCommandHelpItem, TuiCommandHelpSection, TuiLabels, TuiProps, TuiRecord, TuiRecordContent, TuiRecordStatus, TuiResourcePreviewContent, TuiResourceTreeContent, TuiResourceTreeDetailRow, TuiResourceTreeItem, TuiSearchListContent, TuiSearchResultItem, TuiStatusContent, TuiStatusRow, TuiTextContent, TuiWriteResultContent, } from './types.js';
+/**
+ * 命令记录、结果与输入区。宿主负责执行与会话，组件渲染传入的记录，
+ * 上报用户的提交意图与已完成的复制。
+ *
+ * Command records, results and input. The host owns execution and sessions; the
+ * component renders supplied records and reports submission intent and successful copies.
+ */
+export declare function Tui({ records, value, disabled, emptyState, locale, commands, commandGroups, onValueChange, onSubmit, onOpenUri, onCopy, labels, className, ...rest }: TuiProps): import("react").JSX.Element;