@farris/x-ui 0.0.2 → 0.0.4

package/app-preview/src/types.d.ts

@@ -1,3 +1,5 @@
+import { DynamicComponentConfig } from '../../../../../dynamic-component/src/composition/types';
+
 /** 预览配置 */
 export type PreviewMode = 'splitScreen' | 'fullScreen';
 export interface PreviewConfig {
@@ -22,6 +24,17 @@ export interface PreviewConfig {
     postMessageTargetOrigin?: string;
     /** 预览面板初始宽度占比 (0.3 ~ 0.7)，默认 0.5 */
     initialRatio?: number;
+    /**
+     * 是否替换模式（默认 false）。
+     * 为 true 时始终替换 preview-1，不进入三面板双预览布局。
+     * 适用于从对话区域点击预览的场景。
+     */
+    replace?: boolean;
+    /**
+     * 动态组件配置（与 url/content 互斥）。
+     * 非空时走动态组件预览流程，复用三面板布局的 preview-1 槽位。
+     */
+    dynamicComponent?: DynamicComponentConfig;
 }
 export interface AppConfig {
     appPath: string;

package/bubble/src/components/text-content/composition/block-type.d.ts

@@ -0,0 +1,41 @@
+import { DynamicComponentConfig } from '../../../../../../../../../../../dynamic-component/src/composition/types';
+
+export declare enum BlockType {
+    Text = "text",
+    A2UIComplete = "a2ui-complete",
+    AssistantWidgetComplete = "assistant-widget-complete",
+    AssistantWidgetPending = "assistant-widget-pending",
+    DynamicComponentComplete = "dynamic-component-complete",
+    DynamicComponentPending = "dynamic-component-pending"
+}
+export interface TextBlock {
+    type: BlockType.Text;
+    raw: string;
+}
+export interface A2UICompleteBlock {
+    type: BlockType.A2UIComplete;
+    raw: string;
+    a2uiData: Record<string, unknown>;
+}
+export interface AssistantWidgetCompleteBlock {
+    type: BlockType.AssistantWidgetComplete;
+    raw: string;
+    widgetData: Record<string, unknown> | null;
+    widgetUrl: string | undefined;
+    widgetImplOptions: Record<string, unknown>;
+}
+export interface AssistantWidgetPendingBlock {
+    type: BlockType.AssistantWidgetPending;
+    raw: string;
+}
+export interface DynamicComponentCompleteBlock {
+    type: BlockType.DynamicComponentComplete;
+    raw: string;
+    config: DynamicComponentConfig | null;
+}
+export interface DynamicComponentPendingBlock {
+    type: BlockType.DynamicComponentPending;
+    raw: string;
+    position: 'inline' | 'right' | null;
+}
+export type ParsedBlock = TextBlock | A2UICompleteBlock | AssistantWidgetCompleteBlock | AssistantWidgetPendingBlock | DynamicComponentCompleteBlock | DynamicComponentPendingBlock;

package/bubble/src/components/text-content/renderers/a2ui-renderer.d.ts

@@ -0,0 +1,3 @@
+import { BlockRenderer } from '../../../../../../../utils/block-renderer';
+
+export declare const renderA2UI: BlockRenderer;

package/bubble/src/components/text-content/renderers/assistant-widget-renderer.d.ts

@@ -0,0 +1,3 @@
+import { BlockRenderer } from '../../../../../../../utils/block-renderer';
+
+export declare const renderWidget: BlockRenderer;

package/bubble/src/components/text-content/renderers/dynamic-component-renderer.d.ts

@@ -0,0 +1,3 @@
+import { BlockRenderer } from '../../../../../../../utils/block-renderer';
+
+export declare const renderDynamicComponent: BlockRenderer;

package/bubble/src/components/text-content/renderers/text-renderer.d.ts

@@ -0,0 +1,3 @@
+import { BlockRenderer } from '../../../../../../../utils/block-renderer';
+
+export declare const renderText: BlockRenderer;

package/bubble/src/components/text-content/utils/block-parser.d.ts

@@ -0,0 +1,3 @@
+import { ParsedBlock } from '../../../../../../../composition/block-type';
+
+export declare function parseBlocks(text: string): ParsedBlock[];

package/bubble/src/components/text-content/utils/block-renderer.d.ts

@@ -0,0 +1,13 @@
+import { VNode, SetupContext, ComputedRef } from '../../../../../../vue';
+import { ParsedBlock, BlockType } from '../../../../../../../composition/block-type';
+import { EmbeddedContentRenderContext } from '../../../../../../../../../composition/use-embedded-content';
+import { EmbeddedContent } from '../../../../../../../../../composition/types';
+
+export interface RenderContext {
+    shouldShowMarkdown: ComputedRef<boolean>;
+    emit: SetupContext['emit'];
+    renderFileEmbeddedContent: (content: EmbeddedContent, ctx: EmbeddedContentRenderContext) => VNode;
+}
+export type BlockRenderer = (block: ParsedBlock, index: number, ctx: RenderContext) => VNode | VNode[] | null;
+export type RendererRegistry = Record<BlockType, BlockRenderer>;
+export declare function createRendererRegistry(): RendererRegistry;

package/chat-preview/index.d.ts

@@ -3,8 +3,10 @@ import { default as FXChatPreview } from '../../src/chat-preview.component';
 
 export * from '../../src/chat-preview.props';
 export * from '../../src/preview-bridge-protocol';
-export { AgentWorkbenchSDK, invokeAgentWorkbenchSdkApi, postAssistantViaAgentWorkbenchSDK, subscribeAssistantViaAgentWorkbenchSDK, sendChatMessageViaAgentWorkbenchSDK, type AgentWorkbenchSDKSubscribeOptions, type SendWorkbenchChatMessageOptions, registerPreviewChromeSdk, type PreviewChromeSdkHandlers, } from '../../src/agent-workbench-sdk';
-/** @deprecated 请使用 {@link AgentWorkbenchSDK.subscribe} */
+export { postAssistantToPreviewIframe, subscribeAssistantInPreviewIframe, type PreviewAssistantBridgeSubscribeOptions, } from '../../src/preview-bridge-host';
+/** 按方法名调用宿主 `window.AgentWorkbenchSDK`（由 `@farris/x-workbench` 注入） */
+export { invokeAgentWorkbenchSdkApi } from '../../src/invoke-agent-workbench-sdk';
+/** @deprecated 请使用 {@link subscribeAssistantInPreviewIframe}；宿主侧见 `@farris/x-workbench` */
 export { createPreviewIframeSdk } from '../../src/preview-iframe-sdk';
 /** @deprecated */
 export type { CreatePreviewIframeSdkOptions } from '../../src/preview-iframe-sdk';

package/chat-preview/src/invoke-agent-workbench-sdk.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 按方法名调用宿主挂载的 {@link AgentWorkbenchSDK}（由 `@farris/x-workbench` 在 `window.AgentWorkbenchSDK` 注入）。
+ * 供网关 `InputRecommend` 等配置 `api` + `params`；无宿主 SDK 时会告警并返回 `undefined`。
+ */
+export declare function invokeAgentWorkbenchSdkApi(api: string, params?: unknown[]): unknown;

package/chat-preview/src/preview-bridge-host.d.ts

@@ -0,0 +1,15 @@
+import { PreviewBridgeAssistantPayload } from '../../../preview-bridge-protocol';
+
+export interface PreviewAssistantBridgeSubscribeOptions {
+    /** 允许的父页面 origin；不传则只做结构校验，不校验 origin */
+    allowedParentOrigins?: string[];
+    /**
+     * 为 true（默认）时接受 `window.parent` 或 `window.top` 作为发送方。
+     */
+    allowTopAsSource?: boolean;
+    onAssistantMessage?: (payload: PreviewBridgeAssistantPayload) => void;
+}
+/** 向预览 iframe 的 `contentWindow` 投递助手消息（与 {@link subscribeAssistantInPreviewIframe} 协议一致） */
+export declare function postAssistantToPreviewIframe(targetWindow: Window, targetOrigin: string, payload: PreviewBridgeAssistantPayload): boolean;
+/** 预览页内：订阅父页 / top 推送的助手消息 */
+export declare function subscribeAssistantInPreviewIframe(options: PreviewAssistantBridgeSubscribeOptions): () => void;

package/chat-preview/src/preview-iframe-sdk.d.ts

@@ -1,6 +1,7 @@
-import { AgentWorkbenchSDKSubscribeOptions } from '../../../agent-workbench-sdk';
+import { PreviewAssistantBridgeSubscribeOptions } from '../../../preview-bridge-host';
 
-export type CreatePreviewIframeSdkOptions = AgentWorkbenchSDKSubscribeOptions;
-/** @deprecated 请使用 {@link AgentWorkbenchSDK.subscribe} */
+export type CreatePreviewIframeSdkOptions = PreviewAssistantBridgeSubscribeOptions;
+/** @deprecated 请使用 {@link subscribeAssistantInPreviewIframe} */
 export declare function createPreviewIframeSdk(options: CreatePreviewIframeSdkOptions): () => void;
-export { postAssistantViaAgentWorkbenchSDK } from '../../../agent-workbench-sdk';
+/** @deprecated 请使用 {@link postAssistantToPreviewIframe} */
+export { postAssistantToPreviewIframe as postAssistantViaAgentWorkbenchSDK } from '../../../preview-bridge-host';

package/dynamic-component/index.d.ts

@@ -2,6 +2,6 @@ import { Plugin } from '../../vue';
 import { default as FXDynamicComponent } from '../../src/dynamic-component.component';
 export { default as FXDynamicComponent } from '../../src/dynamic-component.component';
 export * from '../../src/composition/types';
-export { loadDynamicComponent, unloadDynamicComponent } from '../../src/composition/dynamic-component-registry';
+export { loadDynamicComponent, unloadDynamicComponent, postDynamicComponentAssistantMessage } from '../../src/composition/dynamic-component-registry';
 declare const _default: typeof FXDynamicComponent & Plugin;
 export default _default;

package/dynamic-component/src/composition/dynamic-component-registry.d.ts

@@ -1,7 +1,8 @@
-import { DynamicComponentConfig, DynamicComponentAPI } from '../../../../types';
+import { DynamicComponentConfig, DynamicComponentAPI, DynamicComponentAssistantMessagePayload } from '../../../../types';
 
 export declare function loadDynamicComponent(config: DynamicComponentConfig): Promise<DynamicComponentAPI>;
 export declare function unloadDynamicComponent(id: string): void;
+export declare function postDynamicComponentAssistantMessage(id: string, payload: DynamicComponentAssistantMessagePayload): boolean;
 declare global {
     interface Window {
         __fluens_dynamic_component_register: (id: string, api: DynamicComponentAPI) => void;

package/dynamic-component/src/composition/types.d.ts

@@ -1,4 +1,6 @@
 export interface DynamicComponentConfig {
+    /** 允许网关透传自定义字段给动态组件 mount(config) 与右侧预览气泡 */
+    [key: string]: unknown;
     instanceId: string;
     name?: string;
     componentId?: string;
@@ -11,9 +13,19 @@ export interface DynamicComponentConfig {
     autoOpen?: boolean;
     fileRe?: string;
 }
+export interface DynamicComponentAssistantMessagePayload {
+    messageId: string;
+    role: 'assistant';
+    /** 会话内 assistant 消息的完整 content；包含 dynamic-component 围栏、markdown、复合块等结构。 */
+    content: unknown;
+}
 export interface DynamicComponentAPI {
     mount(container: HTMLElement, config: DynamicComponentConfig): void;
     unmount(): void;
+    /**
+     * 可选：接收唤起当前 dynamic-component 的 assistant 消息，以及之后同会话继续产生的 assistant 消息。
+     */
+    onAssistantMessage?: (payload: DynamicComponentAssistantMessagePayload) => void;
 }
 export interface DynamicComponentInstance {
     config: DynamicComponentConfig;

package/dynamic-component/src/dynamic-component.component.d.ts

@@ -6,7 +6,7 @@ declare const _default: import('../../../vue').DefineComponent<import('../../../
         type: PropType<DynamicComponentConfig>;
         required: true;
     };
-}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('../../../vue').ComponentOptionsMixin, import('../../../vue').ComponentOptionsMixin, {}, string, import('../../../vue').PublicProps, Readonly<import('../../../vue').ExtractPropTypes<{
+}>, () => import("vue/jsx-runtime").JSX.Element | null, {}, {}, {}, import('../../../vue').ComponentOptionsMixin, import('../../../vue').ComponentOptionsMixin, {}, string, import('../../../vue').PublicProps, Readonly<import('../../../vue').ExtractPropTypes<{
     config: {
         type: PropType<DynamicComponentConfig>;
         required: true;