@farris/x-ui 0.0.6 → 0.0.7

package/chat-preview/index.d.ts

@@ -0,0 +1,17 @@
+import { Plugin } from '../../vue';
+import { default as FXChatPreview } from '../../src/chat-preview.component';
+
+export * from '../../src/chat-preview.props';
+export * from '../../src/preview-bridge-protocol';
+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';
+/** 会话分屏预览：由 FXConversation 注册，供 AgentWorkbenchSDK 等聚合调用 */
+export { registerPreviewChromeSdk, previewLayoutBridge, type PreviewChromeSdkHandlers, } from '../../src/preview-chrome-sdk';
+export { FXChatPreview };
+declare const _default: typeof FXChatPreview & Plugin;
+export default _default;

package/chat-preview/src/chat-preview.component.d.ts

@@ -0,0 +1,34 @@
+import { PreviewConfig } from '../../../../../app-preview';
+
+declare const _default: import('../../../vue').DefineComponent<import('../../../vue').ExtractPropTypes<{
+    previewConfig: {
+        type: import('../../../vue').PropType<PreviewConfig>;
+        default: () => {};
+    };
+    onClose: {
+        type: import('../../../vue').PropType<() => void>;
+        default: () => void;
+    };
+    onIframeLoad: {
+        type: import('../../../vue').PropType<() => void>;
+        default: () => void;
+    };
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('../../../vue').ComponentOptionsMixin, import('../../../vue').ComponentOptionsMixin, {}, string, import('../../../vue').PublicProps, Readonly<import('../../../vue').ExtractPropTypes<{
+    previewConfig: {
+        type: import('../../../vue').PropType<PreviewConfig>;
+        default: () => {};
+    };
+    onClose: {
+        type: import('../../../vue').PropType<() => void>;
+        default: () => void;
+    };
+    onIframeLoad: {
+        type: import('../../../vue').PropType<() => void>;
+        default: () => void;
+    };
+}>> & Readonly<{}>, {
+    previewConfig: PreviewConfig;
+    onClose: () => void;
+    onIframeLoad: () => void;
+}, {}, {}, {}, string, import('../../../vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/chat-preview/src/chat-preview.props.d.ts

@@ -0,0 +1,19 @@
+import { ExtractPropTypes, PropType } from '../../../vue';
+import { PreviewConfig } from '../../../../../app-preview';
+
+export declare const chatPreviewProps: {
+    previewConfig: {
+        type: PropType<PreviewConfig>;
+        default: () => {};
+    };
+    onClose: {
+        type: PropType<() => void>;
+        default: () => void;
+    };
+    /** iframe 文档 load 后回调（用于父页在子页监听器就绪后再 postMessage） */
+    onIframeLoad: {
+        type: PropType<() => void>;
+        default: () => void;
+    };
+};
+export type ChatPreviewProps = ExtractPropTypes<typeof chatPreviewProps>;

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-bridge-protocol.d.ts

@@ -0,0 +1,22 @@
+/** 父页 → iframe 的 postMessage 协议（与 iframe 侧 SDK 对齐） */
+export declare const PREVIEW_BRIDGE_SOURCE: "farris-x-preview-bridge";
+export declare const PREVIEW_BRIDGE_VERSION: 1;
+export declare const PREVIEW_BRIDGE_MESSAGE_TYPE_ASSISTANT: "assistant.message";
+export interface PreviewBridgeAssistantPayload {
+    messageId: string;
+    role: 'user' | 'assistant';
+    /** 助手消息的完整 content（与会话内结构一致，由 structured clone / 序列化承载） */
+    content: unknown;
+}
+export interface PreviewBridgeMessageEnvelope {
+    source: typeof PREVIEW_BRIDGE_SOURCE;
+    v: typeof PREVIEW_BRIDGE_VERSION;
+    type: typeof PREVIEW_BRIDGE_MESSAGE_TYPE_ASSISTANT;
+    payload: PreviewBridgeAssistantPayload;
+}
+/**
+ * postMessage 走 structured clone，Vue reactive/Proxy 可能无法克隆导致静默失败；
+ * 先 JSON 往返成纯对象再投递。
+ */
+export declare function clonePreviewPayloadForPostMessage(payload: PreviewBridgeAssistantPayload): PreviewBridgeAssistantPayload;
+export declare function isPreviewBridgeAssistantMessage(data: unknown): data is PreviewBridgeMessageEnvelope;

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

@@ -0,0 +1,28 @@
+import { PreviewConfig } from '../../../../../app-preview/src/types';
+
+/** 由 FXConversation 注入，供 window 侧 imperative 调用（分屏 / 双栏预览） */
+export interface PreviewChromeSdkHandlers {
+    showPreview?: (config: PreviewConfig) => void;
+    closePreviewPane?: () => void;
+    closeRightPreview?: () => void;
+    showFullScreenPreview?: (config: PreviewConfig) => void;
+    closeFullScreenPreview?: () => void;
+}
+/**
+ * 会话组件挂载时注册；卸载时执行返回函数。多实例时后进先出，避免前一个页面卸载清空后一个的句柄。
+ */
+export declare function registerPreviewChromeSdk(handlers: PreviewChromeSdkHandlers): () => void;
+/** 实现细节：对外由 `@farris/x-workbench` 的 `agent-workbench-sdk.ts` 聚合为 `window.AgentWorkbenchSDK`。 */
+export declare const previewLayoutBridge: {
+    /**
+     * 打开或更新预览：右侧空 → 单栏右侧；仅右侧已有 → 双栏（旧右→左，新→右）；**左右已有 → 只替换右侧 iframe**。
+     */
+    readonly showPreview: (config: PreviewConfig) => void;
+    /** 与 {@link previewLayoutBridge.showPreview} 相同，强调在双栏时只换右侧。 */
+    readonly replaceRightPreview: (config: PreviewConfig) => void;
+    readonly closePreviewPane: () => void;
+    readonly closeRightPreview: () => void;
+    readonly showFullScreenPreview: (config: PreviewConfig) => void;
+    readonly closeFullScreenPreview: () => void;
+    readonly isPreviewLayoutActive: () => boolean;
+};

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

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

package/components.d.ts

@@ -4,6 +4,8 @@ export { default as FXBubble, FXBubbleAction } from '../bubble';
 export * from '../bubble';
 export { default as FXCarousel, FXCarouselItem } from '../carousel';
 export * from '../carousel';
+export { default as FXChatPreview } from '../chat-preview';
+export * from '../chat-preview';
 export { default as FXConfirmDialog } from '../confirm-dialog';
 export * from '../confirm-dialog';
 export { default as FXCoding } from '../coding';

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, postDynamicComponentAssistantMessage } from '../../src/composition/dynamic-component-registry';
+export { loadDynamicComponent, unloadDynamicComponent, postDynamicComponentAssistantMessage, peekDynamicComponentRegisterBootstrapId, normalizeDynamicComponentRegisterClaim, getDynamicComponentRegistryDebugSnapshot } 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,10 +1,23 @@
 import { DynamicComponentConfig, DynamicComponentAPI, DynamicComponentAssistantMessagePayload } from '../../../../types';
 
+/** 与对话 mock 「口令规范化」同源：隐蔽字符会导致 pending key 肉眼一致却 get 失败 */
+export declare function normalizeDynamicComponentRegisterClaim(raw: unknown): string;
+/** 供调试：`import { peekDynamicComponentRegisterBootstrapId } from '@farris/x-ui'` */
+export declare function peekDynamicComponentRegisterBootstrapId(): string | undefined;
+/** 控制台联调快照 */
+export declare function getDynamicComponentRegistryDebugSnapshot(): {
+    pendingKeys: string[];
+    bootstrapQueue: string[];
+    activeKeys: string[];
+    windowBootstrapPeek?: string;
+};
 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;
+        __fluens_dynamic_component_bootstrap_instance_id?: string;
+        __fluens_get_dynamic_component_registry_debug_snapshot?: typeof getDynamicComponentRegistryDebugSnapshot;
     }
 }

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

@@ -12,18 +12,20 @@ export interface DynamicComponentConfig {
     isFullscreen?: boolean;
     autoOpen?: boolean;
     fileRe?: string;
+    /** 打开后落位目标面板，默认 'preview' */
+    target?: 'preview' | 'previewExtra';
 }
 export interface DynamicComponentAssistantMessagePayload {
     messageId: string;
-    role: 'assistant';
-    /** 会话内 assistant 消息的完整 content；包含 dynamic-component 围栏、markdown、复合块等结构。 */
+    role: 'user' | 'assistant';
+    /** 会话内消息的完整 content；含 dynamic-component 围栏、markdown、复合块等（与 UI 气泡一致）。 */
     content: unknown;
 }
 export interface DynamicComponentAPI {
     mount(container: HTMLElement, config: DynamicComponentConfig): void;
     unmount(): void;
     /**
-     * 可选：接收唤起当前 dynamic-component 的 assistant 消息，以及之后同会话继续产生的 assistant 消息。
+     * 可选：接收同会话内用户/助手消息（与右侧 iframe 预览桥一致），用于侧栏/预览区与流式同步。
      */
     onAssistantMessage?: (payload: DynamicComponentAssistantMessagePayload) => void;
 }