前端 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
ServiceLogo
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:设置弹窗「插件详情」里的扩展自带设置面板 。 声明了settingsPanelmetadata 的站点扩展由设置按需加载其设置贡献;贡献按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;};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;};