跳转到内容

前端 SDK 导出:Tabs – TypeIcon

本页由当前 SDK 声明自动生成。 导入入口:@woohaa3/frontend/extension-api。

返回接口索引

Tabs · TabsProps · TaskActivityFeedItem · TaskActivityRow · TaskActivityRowKind · TaskActivityRowTone · TaskActivityStoreService · TaskActivityStoreSnapshot · TaskCatalogService · TaskListIcon · TaskRemoteService · TextArea · TextInput · Theme · ThemeProvider · ThemeProviderProps · ThemeService · ThemeSource · ToolsIcon · Tooltip · TooltipIfPresent · TooltipProps · TrashIcon · TypeIcon

Tabs

export function Tabs(props: TabsProps): React.JSX.Element;

关联类型:TabsProps

TabsProps

export type TabsProps = {
value: string;
onValueChange: (value: string) => void;
items: readonly TabItem[];
panels: Record<string, ReactNode>;
className?: string;
label?: string;
dir?: "ltr" | "rtl";
};

关联类型:TabItem

成员说明:

  • panels:各 value 对应的面板内容(按 value 取用)。
  • label:列表可访问名。
  • dir:键盘方向(默认 ltr)。

TaskActivityFeedItem

活动浮层记录(含本地 optimistic/local-failure 标记;非 canonical 事实)。

export type TaskActivityFeedItem = CanvasTaskActivity & {
optimistic: boolean;
localFailure: boolean;
};

关联类型:CanvasTaskActivity

成员说明:

  • taskKey:durable 任务主键。
  • runId:业务 run 关联键;optimistic 合并兜底。
  • nodeId:权威画布节点身份。
  • modelType:模型类型摘要(用于卡片与图标)。
  • progress:权威进度(0..1);缺失时前端不得伪造百分比。
  • result:安全结果摘要(只含 storageKey 等白名单字段)。
  • error:安全错误摘要(只含 name/message)。

TaskActivityRow

只读行视图:与面板实际渲染的记录一致,覆盖全部来源。

不含来源内部载荷(提示词、参数、凭据、签名 URL 或媒体字节),也不含动作函数—— 该能力仍是只读的,没有写入口。

export type TaskActivityRow = {
key: string;
kind: TaskActivityRowKind;
title: string;
secondary?: string;
detail?: string;
status: string;
state: string;
tone: TaskActivityRowTone;
progress?: number;
nodeId?: string;
createdAt: string;
updatedAt: string;
active: boolean;
};

关联类型:TaskActivityRowKind · TaskActivityRowTone

成员说明:

  • key:稳定身份:task:<runId> | job:<id> | group:<requestId> | skill:<skillRunId>:<stepId>。

TaskActivityRowKind

活动记录来源种类;只决定数据来源与可用动作,不决定寿命或清理规则。

export type TaskActivityRowKind = "task" | "job" | "group" | "skill";

TaskActivityRowTone

活动记录语义色(状态灯与状态文案)。

export type TaskActivityRowTone = "active" | "success" | "danger" | "muted";

TaskActivityStoreService

feature-owned 只读活动 store capability(由 task-activity extension 提供)。

export type TaskActivityStoreService = {
getSnapshot(): TaskActivityStoreSnapshot;
subscribe(listener: () => void): () => void;
};

关联类型:TaskActivityStoreSnapshot

TaskActivityStoreSnapshot

export type TaskActivityStoreSnapshot = {
rows: readonly TaskActivityRow[];
items: TaskActivityFeedItem[];
jobs: BackgroundActivityJob[];
unread: number;
cursor: number;
hasActive: boolean;
};

关联类型:TaskActivityRow · TaskActivityFeedItem · BackgroundActivityJob

成员说明:

  • rows:统一记录列表:全部来源按开始时间从新到旧交错。

TaskCatalogService

export interface TaskCatalogService {
getState(): CatalogState;
subscribe(listener: () => void): () => void;
load(force?: boolean): Promise<void>;
invalidate(): void;
}

关联类型:CatalogState

成员说明:

  • invalidate:站点生成插件/模型策略变化时使目录失效并重取。

TaskListIcon

任务编排。

export const TaskListIcon: { ({ size, strokeWidth, absoluteStrokeWidth, ...rest }: UiIconProps): React.JSX.Element; displayName: string; };

关联类型:UiIconProps

TaskRemoteService

Task Remote:浏览器允许的只读 catalog/history 协议。

export interface TaskRemoteService {
fetchCatalog(): Promise<CanvasTaskCatalog>;
createHistory(): TaskHistoryReader;
}

关联类型:CanvasTaskCatalog · TaskHistoryReader

TextArea

export const TextArea: React.ForwardRefExoticComponent<TextareaHTMLAttributes<HTMLTextAreaElement> & React.RefAttributes<HTMLTextAreaElement>>;

TextInput

export const TextInput: React.ForwardRefExoticComponent<InputHTMLAttributes<HTMLInputElement> & React.RefAttributes<HTMLInputElement>>;

Theme

export type Theme = typeof theme;

ThemeProvider

export function ThemeProvider({ service, children }: ThemeProviderProps): React.JSX.Element;

关联类型:ThemeProviderProps

ThemeProviderProps

export type ThemeProviderProps = {
service: ThemeSource;
children: ReactNode;
};

关联类型:ThemeSource

ThemeService

Theme Service。

页面级唯一主题 owner:持有当前合法 snapshot、投影 --app-* variables、管理本地选择 生命周期。实现见 services/theme/service.ts(AppThemeService),但契约只依赖 @woohaa3/contracts 的纯类型,避免平台 Service 反向依赖 feature。

export interface ThemeService {
getSnapshot(): AppThemeSnapshot;
subscribe(listener: () => void): () => void;
setPreset(preset: unknown): {
ok: true;
} | {
ok: false;
error: string;
};
select(presetId: string): {
ok: true;
} | {
ok: false;
error: string;
};
registerPreset(presetId: string, preset: unknown): void;
presetIds(): readonly string[];
applyTo(root: HTMLElement): () => void;
diagnostic(): string | null;
dispose(): void;
}

关联类型:AppThemeSnapshot

成员说明:

  • getSnapshot:当前主题 snapshot(订阅后读取;同一引用的原子对象)。
  • subscribe:订阅主题变化;返回退订函数。
  • setPreset:用完整 preset 原子替换;非法输入整体拒绝并保留上一主题。
  • select:按 id 选择已注册 preset。
  • registerPreset:注册可由本地选择引用的具名 preset。
  • presetIds:已注册、可供 select 选择的 preset id。
  • applyTo:把当前 snapshot 写到主题根容器;返回撤销函数。
  • diagnostic:最近一次非法切换的诊断(成功切换后清空)。
  • dispose:释放:撤销订阅与根容器,不遗留 document 级监听。

ThemeSource

Minimal browser presentation source; the host owns validation and persistence.

export interface ThemeSource {
subscribe(listener: () => void): () => void;
getSnapshot(): AppThemeSnapshot;
applyTo(root: HTMLElement): () => void;
}

关联类型:AppThemeSnapshot

ToolsIcon

MCP 与工具授权。

export const ToolsIcon: { ({ size, strokeWidth, absoluteStrokeWidth, ...rest }: UiIconProps): React.JSX.Element; displayName: string; };

关联类型:UiIconProps

Tooltip

无 Provider 也可用:直接包一层 Radix Tooltip(缺 Provider 时提供本地 default delay)。

export const Tooltip: React.ForwardRefExoticComponent<TooltipProps & React.RefAttributes<HTMLButtonElement>>;

关联类型:TooltipProps

TooltipIfPresent

仅有可见文案时才需要 Tooltip 的便捷包装(content 为空则原样返回)。

export function TooltipIfPresent(props: TooltipProps & { content?: ReactNode; }): React.JSX.Element;

关联类型:TooltipProps

TooltipProps

export type TooltipProps = {
children: ReactNode;
content: ReactNode;
sideOffset?: number;
side?: "top" | "right" | "bottom" | "left";
align?: "start" | "center" | "end";
open?: boolean;
onOpenChange?: (open: boolean) => void;
className?: string;
forceMount?: boolean;
disabled?: boolean;
};

成员说明:

  • children:触发元素(作为 Radix Trigger asChild)。
  • content:提示内容。
  • sideOffset:提示相对触发元素的偏移。
  • open:受控 open(缺省非受控)。
  • className:提示内容 class(业务可追加布局类)。
  • forceMount:关闭时是否保留在 DOM(Radix 默认会卸载)。
  • disabled:禁用提示(例如 disabled 控件不必提示)。

TrashIcon

export const TrashIcon: { ({ size, strokeWidth, absoluteStrokeWidth, ...rest }: UiIconProps): React.JSX.Element; displayName: string; };

关联类型:UiIconProps

TypeIcon

export const TypeIcon: { ({ size, strokeWidth, absoluteStrokeWidth, ...rest }: UiIconProps): React.JSX.Element; displayName: string; };

关联类型:UiIconProps