跳转到内容

前端 SDK 导出:SelectionService – TabItem

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

返回接口索引

SelectionService · SendIcon · ServiceLogo · SettingsFeedback · SettingsIcon · SettingsSection · SlotContribution · SlotContributionMap · SlotName · SlotsService · SnippetCandidate · SnippetLibraryIcon · SnippetResult · SnippetTagWithCount · SnippetTrigger · SparklesIcon · StarIcon · StorageIcon · StoredAsset · SunIcon · SwapColorsIcon · Switch · SwitchProps · TabItem

SelectionService

export interface SelectionService {
getSnapshot(): SelectionSnapshot;
subscribe(listener: () => void): () => void;
setFromRuntime(raw: {
nodeIds: readonly string[];
primaryNodeId: string | null;
editingFocus: boolean;
}, validNodeIds: ReadonlySet<string>): void;
setKeyboardActive(active: boolean): void;
reset(): void;
}

关联类型:SelectionSnapshot

SendIcon

发送/执行(Lucide Send;产品专有实心纸飞机见 CUSTOM_ICON_EXCEPTIONS)。

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

关联类型:UiIconProps

Known product/service identity only; generic API protocols have no brand mark.

export function ServiceLogo({ service, size }: { service: string; size?: number; }): React.JSX.Element | null;

SettingsFeedback

export function SettingsFeedback({ tone, children, }: { tone?: "neutral" | "success" | "danger" | "warning"; children: ReactNode; }): React.JSX.Element;

SettingsIcon

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

关联类型:UiIconProps

SettingsSection

export function SettingsSection({ title, description, action, children, }: { title: string; description?: string; action?: ReactNode; children: ReactNode; }): React.JSX.Element;

SlotContribution

export type SlotContribution<S extends SlotName> = {
id: string;
owner: string;
priority?: number;
} & (S extends "canvas.node-action" ? {
available?: (context: NodeActionContext) => boolean;
} : S extends "canvas.selection-action" ? {
available?: (context: SelectionActionContext) => boolean;
} : {
available?: () => boolean;
}) & SlotContributionMap[S];

关联类型:SlotName · NodeActionContext · SelectionActionContext · SlotContributionMap

成员说明:

  • id:contribution 稳定 ID;同一 slot 内重复 ID 会启动失败。 贡献稳定 ID;同一 slot 内重复会启动失败。 贡献稳定 ID(= 命中回传的 actionId);同一 slot 内重复会启动失败。
  • owner:注册 owner(通常是 Plugin ID),用于诊断。 拥有者(诊断用)。
  • priority:越小越靠前;同 priority 按注册序号,再按 ID 稳定排序。 越小越靠前。
  • available:贡献是否在本节点可用;false 时不呈现。 贡献当前选区是否可用;false 时不呈现。 此刻是否应该出现;缺省总是出现。

SlotContributionMap

export type SlotContributionMap = {
"app.route": {
path: string;
render: ComponentType<RouteProps>;
};
"canvas.overlay": {
render: ComponentType<CanvasSlotProps>;
};
"canvas.catalog-item-action": CatalogItemActionContribution;
"canvas.create-option": CanvasCreateOptionContribution;
"canvas.node-action": NodeActionContribution;
"canvas.selection-action": SelectionActionContribution;
"canvas.topbar": {
render: ComponentType<CanvasSlotProps>;
};
"canvas.topbar-status": {
wrapsStatus?: boolean;
render: ComponentType<CanvasSlotProps & {
renderStatus: (readout: ReactNode, details: ReactNode) => ReactNode;
}>;
};
"canvas.focus-header": {
position?: "before-title" | "after-title";
render: ComponentType<{
nodeId: string;
}>;
};
"canvas.minimap": {
render: ComponentType<CanvasSlotProps & {
onCollapse?: () => void;
}>;
};
"canvas.minimap-top": {
render: ComponentType<CanvasSlotProps>;
};
"canvas.minimap-side": {
position?: "left" | "right";
render: ComponentType<CanvasSlotProps>;
};
"canvas.toolbar": {
render: ComponentType<CanvasSlotProps>;
};
"canvas.toolbar-status": {
wrapsStatus?: boolean;
render: ComponentType<CanvasSlotProps & {
renderStatus: (readout: ReactNode, details: ReactNode) => ReactNode;
}>;
};
"canvas.toolbar-action": {
label: string;
icon: ComponentType<{
className?: string;
}>;
tone?: "primary";
tooltip?: ComponentType<{
children: ReactNode;
}>;
onActivate: () => void;
};
"canvas.context-menu": {
items: (context: ContextMenuContext) => CanvasContextMenuItem[];
onSelect: (itemId: string, context: ContextMenuContext) => void;
};
"canvas.node-template": {
icon?: ComponentType<{
className?: string;
}>;
nodeType: string;
label: string;
section?: string;
order?: number;
createNodeData: (context: ContextMenuContext) => import("@woohaa3/contracts").CanvasNodeData | undefined;
};
"canvas.focus-workspace": {
kind: string;
matchesFocus?: (input: {
canvas: import("@woohaa3/contracts").ServerCanvas | null;
focus: {
nodeId: string;
kind: string;
};
}) => boolean;
validate?: (props: CanvasSlotProps) => string | null;
layout?: FocusLayoutSource;
exclusive?: boolean;
render: ComponentType<CanvasSlotProps>;
};
"canvas.node-drop": {
dropLabel?: string;
nodeType: string;
matchesTarget?: (input: {
canvas: import("@woohaa3/contracts").ServerCanvas;
targetNodeId: string;
}) => boolean;
acceptsSources?: (input: {
canvas: import("@woohaa3/contracts").ServerCanvas;
targetNodeId: string;
sourceNodeIds: readonly string[];
}) => boolean;
onDrop: (input: {
canvas: import("@woohaa3/contracts").ServerCanvas;
targetNodeId: string;
sourceNodeIds: readonly string[];
point: {
x: number;
y: number;
};
}) => boolean;
onPreview?: (input: {
canvas: import("@woohaa3/contracts").ServerCanvas;
targetNodeId: string;
sourceNodeIds: readonly string[];
}) => string | null;
};
"canvas.document-workspace": {
isAvailable?: (documentId: string) => boolean;
layout?: FocusLayoutSource;
render: ComponentType<CanvasSlotProps & {
document?: {
documentId: string;
} | null;
}>;
};
"dialog.renderer": {
dialogId: string;
render: DialogRenderer;
};
"ai-center.generation-history": {
render: ComponentType<{
canvasId: string;
active: boolean;
onClose: () => boolean;
}>;
};
"agent-assistant.configuration": {
kind: "login" | "installed" | "api-key" | "provider-login";
label: string;
description?: string;
icon?: string;
modelTypes?: readonly import("@woohaa3/contracts").CanvasTaskModelType[];
setupOrder?: number;
providerId?: string;
configured?: {
getSnapshot: () => boolean;
subscribe: (listener: () => void) => () => void;
};
render: ComponentType<{
connectionId?: string;
onSaved?: (connectionId: string) => void;
}>;
};
"agent-assistant.provider-balance": {
providerId: string;
render: ComponentType;
};
"agent-assistant.hosting-source": {
ownerExtensionId: string;
render: ComponentType<{
onSaved?: () => void;
}>;
};
"provider-credentials.top": {
render: ComponentType<{
requestClose?: () => void;
}>;
};
"settings.plugin-config": {
pluginId: string;
render: ComponentType<SettingsPanelRenderProps>;
};
"authoring.delivery": {
resolve(input: {
canvasId: string;
nodeId: string;
data: import("@woohaa3/contracts").CanvasNodeData | undefined;
}): AssistantDeliveryTarget | null;
};
"authoring.generate": {
render?: AuthoringGenerationComponent;
sourceId?: string;
sourceLabel?: string;
};
"execution.prompt-skill": {
rewrite: (input: {
skill: {
id: string;
label: string;
description?: string;
};
prompt: string;
canvasId: string;
nodeId: string;
taskKind: string;
}) => Promise<{
prompt: string;
} | {
error: string;
}>;
};
"input.paste": {
handle: (event: ClipboardEvent) => boolean | void | Promise<void>;
};
"input.drop": {
handle: (event: DragEvent) => boolean | void | Promise<void>;
canAccept?: (event: DragEvent) => boolean;
};
};

关联类型:RouteProps · CanvasSlotProps · CatalogItemActionContribution · CanvasCreateOptionContribution · NodeActionContribution · SelectionActionContribution · ContextMenuContext · CanvasContextMenuItem · CanvasNodeData · ServerCanvas · FocusLayoutSource · DialogRenderer · CanvasTaskModelType · SettingsPanelRenderProps · AssistantDeliveryTarget · AuthoringGenerationComponent

成员说明:

  • canvas.catalog-item-action:画布目录条目上的动作。 宿主在画布切换器的每个条目旁渲染贡献;贡献方自行判断在本条目是否呈现。用于把 「把这张本地画布同步到远端」这类动作做成显式操作,而不是登录后的默认行为。
  • canvas.create-option:新建画布时可勾选的选项(例如「同时同步到远端」)。
  • canvas.node-action:通用「选中节点操作」横条的动作贡献 。 宿主在单选图片/视频/model3d 时渲染顶部独立横条并按 order 排列贡献的动作;下载由宿主自己 贡献。宿主只做通用布局/pointer 隔离/尺寸测量,MUST NOT import 扩展实现或按业务 ID 分支。
  • canvas.selection-action:多选动作横条的动作贡献 。 宿主在选中 ≥2 个节点时渲染顶部独立横条(锚定选区包围盒),按 order 排列贡献的动作;横条由 Bevy 绘制、Rust 命中。宿主只做通用布局/命中派发/尺寸测量,MUST NOT import 扩展实现或按业务 ID 分支。
  • canvas.topbar:画布左上角顶栏。 宿主用一个固定的 flex 行承载贡献,按 priority 从左到右排列:低 priority 在左。 与 canvas.overlay 的差别是不做各自绝对定位,便于「当前用户」与画布切换器相邻。
  • canvas.topbar-status:窗口顶栏右侧的紧凑读数(Tauri 横栏)。 与 canvas.toolbar-status 的区别是归属:顶栏读数是窗口装饰的一部分,在概览与节点聚焦 编辑时都常驻,渲染在横栏靠右(画布控件之后、窗口按钮之前),悬停气泡向下展开; 工具栏读数只在右下角控件面板里、气泡向上展开。贡献方按运行宿主自行二选一 (例如开发性能面板在桌面进入顶栏、在浏览器留在工具栏),宿主不按扩展 ID 分支。 两个位置共用同一份气泡实现:宿主注入 renderStatus,贡献不各自实现 tooltip。
  • canvas.focus-header:公共聚焦标题栏的可选贡献;插件拥有其内容和交互。
  • canvas.minimap:右下角控件面板顶部的小地图(2026-10-26)。 宿主只提供面板位置与画布 props;贡献自己读取 working 画布、订阅本地视口并经 InteractionController 平移。小地图与 canvas.minimap-side 同处概览区, 收起后一起隐藏;地图内部的收起/适合屏幕按钮在悬停边缘浮出,收起动作经 宿主注入的 onCollapse 交给宿主保存状态。没有贡献时不占高度。
  • canvas.minimap-top:小地图面板上方的独立概览控件。
  • canvas.minimap-side:小地图两侧的紧凑内容(2026-10-26),例如右侧的缩放条。 只在小地图概览区展开时渲染;缺省放在右侧,left 排在小地图之前。
  • canvas.toolbar-status:工具栏状态位置的紧凑读数;宿主保留同步状态气泡与色调,采用首个可用贡献。
  • canvas.toolbar-action:右下角控件面板里的图标动作。 tone: "primary" 用强调色实底表达面板主操作(如 AI 助手);顺序仍按 priority 升序。
  • canvas.node-template:通用扩展节点模板。 扩展声明一个通用宿主节点的创建项:宿主据此在 section(缺省「创作工具」)插入菜单项, 选中时用 createNodeData() 产出的自包含 nodeData 创建 nodeType 节点。宿主只按通用 节点契约处理,不 import 任何具体扩展内容,也不出现业务插件专属 node type 或分支; nodeType 的合法性由 canonical 规范化与 reducer 校验。拉线创建时模板不作为连线目标(排除)。
  • canvas.focus-workspace:通用 extension 聚焦工作区。 扩展为一个 focus kind(如 "extension")提供工作区覆盖层;宿主在 node-focus 且 kind 匹配 并通过可选 matches 时渲染该贡献,并隐藏普通画布邻居(工具栏/面板/提示/菜单),使「普通画布与其他 focus mode 不 并行响应」。宿主只按通用 kind/contribution 处理,MUST NOT import 任何具体业务工作区实现。 非模态、铺满内容区或以自身 surface 覆盖;进入/退出由 Canvas Navigation 原子管理。
  • canvas.node-drop:通用 extension 节点复制 Drop 接收。 拖动一批来源节点在 pointerup 落在某类型的纯模型扩展节点范围内时,宿主按贡献把释放委托给 extension;extension 自行读取画布、规划和提交(经通用 canvasCommands)。返回 true 表示 已消费本次释放(来源节点回位、不提交移动)。宿主只按通用 nodeType 命中与 slot 分派, MUST NOT import 任何具体业务收集/项目实现。
  • canvas.document-workspace:独立文档工作区呈现(编辑扩展工作区,design D1/D4)。 当 Canvas Navigation mode 为 document-workspace 时,宿主渲染唯一贡献;它与节点聚焦 互斥,且不伪造画布节点。贡献方自己提供不透明内容背景、取景与输入 owner;宿主只提供内容 矩形布局与 2D 媒体 overlay 的通用清理。
  • ai-center.generation-history:Read-only canvas history workspace. The contributing feature owns its state and media.
  • agent-assistant.provider-balance:提供商列表行里的余额读数(可选)。 宿主在「模型提供商」列表按 providerId 找到该贡献并渲染;扩展自己决定读取方式与展示 文案,宿主不认识任何具体供应商的余额接口。没有贡献或没有可读余额时不占位。
  • agent-assistant.hosting-source:临时图床来源的「如何让它就绪」面板(可选)。 能力中心按候选的 ownerExtensionId 找到该贡献并渲染,替代通用的凭据表单。用于来源的 就绪条件不是可编辑配置、而是扩展自己的账号状态(例如需要先扫码登录)的场景;宿主不按 扩展 ID 分支,也不在只读列表里替扩展发起登录。
  • settings.plugin-config:设置弹窗「插件详情」里的扩展自带设置面板 。 声明了 settingsPanel metadata 的站点扩展由设置按需加载其设置贡献;贡献按 pluginId 归到对应插件详情。宿主不 import 具体扩展实现;面板只取得 requestClose(语境为返回列表) 与 reportEditState(dirty/pending 汇总)。
  • authoring.delivery:模型/镜头 authoring 生成入口 UI。 宿主持有目标身份、门禁与 MCP 指引,并内置渲染生成面板(提示词/来源连接选择/提交/会话)。 个人生成插件通过本 slot 只声明来源身份与可用连接,不再贡献面板 UI。 宿主 MUST NOT 导入具体插件的面板或业务实现。 sourceId/sourceLabel: 贡献方只声明自己服务的来源(对应连接 adapterId)与可用连接。宿主按 owner 可见连接渲染 来源/连接选择,来源覆盖不了;同一来源多个贡献仍按 priority 取首个。 缺省 sourceId 时回退到贡献 id,保持既有单一来源兼容。
  • execution.prompt-skill:执行面板「快捷改写」的提示词技能实现 。 宿主把首个可用贡献接到节点执行面板的快捷改写菜单:用户选中一项后调用 rewrite, 把返回的提示词写回当前草稿。草稿所有权在宿主,扩展不得直接写画布或草稿 store。 没有可用贡献时菜单保留既有「未接入提示词工具插件」提示。

SlotName

export type SlotName = keyof SlotContributionMap;

关联类型:SlotContributionMap

SlotsService

export interface SlotsService {
register<S extends SlotName>(slot: S, contribution: SlotContribution<S>): () => void;
list<S extends SlotName>(slot: S): ReadonlyArray<SlotContribution<S>>;
subscribe(slot: SlotName, listener: () => void): () => void;
version(): number;
}

关联类型:SlotName · SlotContribution

成员说明:

  • version:全局版本号,供诊断/测试。

SnippetCandidate

# 片段候选。 选中后由宿主 materialize 为可插入文本;这里只负责触发 # 菜单与选择回调。

export type SnippetCandidate = {
id: string;
name: string;
summary: string;
};

SnippetLibraryIcon

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

关联类型:UiIconProps

SnippetResult

片段目录协议结果;失败携带稳定错误码(跨进程按字符串判定)。

export type SnippetResult<T> = {
ok: true;
value: T;
} | {
ok: false;
code: PromptSnippetErrorCode | "unauthorized" | "unavailable";
error: string;
};

关联类型:PromptSnippetErrorCode

SnippetTagWithCount

export type SnippetTagWithCount = PromptSnippetTag & {
snippetCount: number;
};

关联类型:PromptSnippetTag

成员说明:

  • name:规范化后的展示名(去除首尾空白、压缩内部空白)。

SnippetTrigger

export type SnippetTrigger = {
search(query: string): Promise<readonly SnippetCandidate[]>;
select(snippetId: string): string | null;
};

关联类型:SnippetCandidate

成员说明:

  • search:按 query 搜索片段;空 query 返回默认列表。
  • select:选中片段:返回要插入选区/光标位置的正文(已 materialize);null 表示放弃。

SparklesIcon

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

关联类型:UiIconProps

StarIcon

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

关联类型:UiIconProps

StorageIcon

存储后端。

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

关联类型:UiIconProps

StoredAsset

export type StoredAsset = CanvasAsset & {
nodeId?: string;
createdAt: string;
providerTaskId?: string;
historyTitle?: string;
};

关联类型:CanvasAsset

成员说明:

  • isFavorite:Whether this asset is saved in the current canvas generation history.
  • historyTitle:Optional name owned by a generation-history entry, independent of asset.title.

SunIcon

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

关联类型:UiIconProps

SwapColorsIcon

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

关联类型:UiIconProps

Switch

export const Switch: React.ForwardRefExoticComponent<Omit<Omit<SwitchPrimitive.SwitchProps & React.RefAttributes<HTMLButtonElement>, "ref">, "asChild"> & { testId?: string; } & React.RefAttributes<HTMLButtonElement>>;

关联类型:SwitchProps

SwitchProps

export type SwitchProps = Omit<ComponentPropsWithoutRef<typeof SwitchPrimitive.Root>, "asChild"> & {
testId?: string;
};

成员说明:

  • testId:稳定测试/定位标识。

TabItem

export type TabItem = {
value: string;
label: ReactNode;
disabled?: boolean;
icon?: ReactNode;
};