@zhama/a2ui 0.10.2 → 0.10.3

package/dist/a2ui-CnaCcq4c.d.ts

@@ -0,0 +1,36 @@
+import { A as Action, E as AnyComponentNode } from './types-CtrG7MJe.js';
+
+/**
+ * A2UI Base Event Types
+ */
+interface BaseEventDetail<EventType extends string> {
+    readonly eventType: EventType;
+}
+
+/**
+ * A2UI Action Event Types
+ */
+
+type Namespace = 'a2ui';
+interface A2UIAction extends BaseEventDetail<`${Namespace}.action`> {
+    readonly action: Action;
+    readonly dataContextPath: string;
+    readonly sourceComponentId: string;
+    readonly sourceComponent: AnyComponentNode | null;
+}
+/**
+ * A2UI 事件类型映射
+ */
+interface A2UIEventDetailMap {
+    'a2ui.action': A2UIAction;
+}
+/**
+ * A2UI 事件名称
+ */
+declare const A2UI_EVENT_NAME: "a2uiaction";
+/**
+ * A2UI 事件类型
+ */
+type A2UIEventType = keyof A2UIEventDetailMap;
+
+export { type A2UIAction as A, type BaseEventDetail as B, type A2UIEventDetailMap as a, type A2UIEventType as b, A2UI_EVENT_NAME as c };

package/dist/a2ui-vyxwZCoa.d.cts

@@ -0,0 +1,36 @@
+import { A as Action, E as AnyComponentNode } from './types-CtrG7MJe.cjs';
+
+/**
+ * A2UI Base Event Types
+ */
+interface BaseEventDetail<EventType extends string> {
+    readonly eventType: EventType;
+}
+
+/**
+ * A2UI Action Event Types
+ */
+
+type Namespace = 'a2ui';
+interface A2UIAction extends BaseEventDetail<`${Namespace}.action`> {
+    readonly action: Action;
+    readonly dataContextPath: string;
+    readonly sourceComponentId: string;
+    readonly sourceComponent: AnyComponentNode | null;
+}
+/**
+ * A2UI 事件类型映射
+ */
+interface A2UIEventDetailMap {
+    'a2ui.action': A2UIAction;
+}
+/**
+ * A2UI 事件名称
+ */
+declare const A2UI_EVENT_NAME: "a2uiaction";
+/**
+ * A2UI 事件类型
+ */
+type A2UIEventType = keyof A2UIEventDetailMap;
+
+export { type A2UIAction as A, type BaseEventDetail as B, type A2UIEventDetailMap as a, type A2UIEventType as b, A2UI_EVENT_NAME as c };

package/dist/context/index.d.cts

@@ -0,0 +1,27 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { j as Theme, i as MessageProcessor, ao as SurfaceID } from '../types-CtrG7MJe.cjs';
+
+declare const ThemeContext: react.Context<Theme>;
+interface ThemeProviderProps {
+    theme?: Theme;
+    children: ReactNode;
+}
+declare function ThemeProvider({ theme, children }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
+declare function useTheme(): Theme;
+
+interface ProcessorContextValue {
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+}
+declare const ProcessorContext: react.Context<ProcessorContextValue>;
+interface ProcessorProviderProps {
+    processor: MessageProcessor | null;
+    surfaceId?: SurfaceID;
+    children: ReactNode;
+}
+declare function ProcessorProvider({ processor, surfaceId, children, }: ProcessorProviderProps): react_jsx_runtime.JSX.Element;
+declare function useProcessor(): ProcessorContextValue;
+
+export { ProcessorContext, ProcessorProvider, type ProcessorProviderProps, ThemeContext, ThemeProvider, type ThemeProviderProps, useProcessor, useTheme };

package/dist/context/index.d.ts

@@ -0,0 +1,27 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { j as Theme, i as MessageProcessor, ao as SurfaceID } from '../types-CtrG7MJe.js';
+
+declare const ThemeContext: react.Context<Theme>;
+interface ThemeProviderProps {
+    theme?: Theme;
+    children: ReactNode;
+}
+declare function ThemeProvider({ theme, children }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
+declare function useTheme(): Theme;
+
+interface ProcessorContextValue {
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+}
+declare const ProcessorContext: react.Context<ProcessorContextValue>;
+interface ProcessorProviderProps {
+    processor: MessageProcessor | null;
+    surfaceId?: SurfaceID;
+    children: ReactNode;
+}
+declare function ProcessorProvider({ processor, surfaceId, children, }: ProcessorProviderProps): react_jsx_runtime.JSX.Element;
+declare function useProcessor(): ProcessorContextValue;
+
+export { ProcessorContext, ProcessorProvider, type ProcessorProviderProps, ThemeContext, ThemeProvider, type ThemeProviderProps, useProcessor, useTheme };

package/dist/data/index.d.cts

@@ -0,0 +1,2 @@
+export { A as A2uiMessageProcessor, c as createMessageProcessor, j as isAnyComponentNode, h as isBooleanValue, e as isComponentArrayReference, g as isNumberValue, d as isObject, b as isPath, k as isResolvedAudioPlayer, l as isResolvedButton, m as isResolvedCard, n as isResolvedCheckbox, o as isResolvedColumn, p as isResolvedDateTimeInput, q as isResolvedDivider, s as isResolvedIcon, r as isResolvedImage, t as isResolvedList, u as isResolvedModal, v as isResolvedMultipleChoice, w as isResolvedRow, x as isResolvedSlider, y as isResolvedTabItem, z as isResolvedTabs, B as isResolvedText, C as isResolvedTextField, D as isResolvedVideo, f as isStringValue, a as isValueMap } from '../index-DKh6MRhF.cjs';
+import '../types-CtrG7MJe.cjs';

package/dist/data/index.d.ts

@@ -0,0 +1,2 @@
+export { A as A2uiMessageProcessor, c as createMessageProcessor, j as isAnyComponentNode, h as isBooleanValue, e as isComponentArrayReference, g as isNumberValue, d as isObject, b as isPath, k as isResolvedAudioPlayer, l as isResolvedButton, m as isResolvedCard, n as isResolvedCheckbox, o as isResolvedColumn, p as isResolvedDateTimeInput, q as isResolvedDivider, s as isResolvedIcon, r as isResolvedImage, t as isResolvedList, u as isResolvedModal, v as isResolvedMultipleChoice, w as isResolvedRow, x as isResolvedSlider, y as isResolvedTabItem, z as isResolvedTabs, B as isResolvedText, C as isResolvedTextField, D as isResolvedVideo, f as isStringValue, a as isValueMap } from '../index-BJe-XUR4.js';
+import '../types-CtrG7MJe.js';

package/dist/events/index.d.cts

@@ -0,0 +1,2 @@
+export { A as A2UIAction, a as A2UIEventDetailMap, b as A2UIEventType, c as A2UI_EVENT_NAME, B as BaseEventDetail } from '../a2ui-vyxwZCoa.cjs';
+import '../types-CtrG7MJe.cjs';

package/dist/events/index.d.ts

@@ -0,0 +1,2 @@
+export { A as A2UIAction, a as A2UIEventDetailMap, b as A2UIEventType, c as A2UI_EVENT_NAME, B as BaseEventDetail } from '../a2ui-CnaCcq4c.js';
+import '../types-CtrG7MJe.js';

package/dist/index-BJe-XUR4.d.ts

@@ -0,0 +1,118 @@
+import { v as ValueMap, p as ComponentArrayReference, S as StringValue, N as NumberValue, B as BooleanValue, E as AnyComponentNode, a8 as ResolvedAudioPlayer, ah as ResolvedButton, aj as ResolvedCard, aa as ResolvedCheckbox, ag as ResolvedColumn, ac as ResolvedDateTimeInput, a9 as ResolvedDivider, a6 as ResolvedImage, a5 as ResolvedIcon, ai as ResolvedList, am as ResolvedModal, ad as ResolvedMultipleChoice, af as ResolvedRow, ae as ResolvedSlider, ak as ResolvedTabItem, al as ResolvedTabs, a4 as ResolvedText, ab as ResolvedTextField, a7 as ResolvedVideo, i as MessageProcessor, ap as Surface, x as ServerToClientMessage, k as DataValue } from './types-CtrG7MJe.js';
+
+/**
+ * A2UI Type Guards
+ * 类型守卫函数
+ */
+
+declare function isValueMap(value: unknown): value is ValueMap;
+declare function isPath(key: string, value: unknown): value is string;
+declare function isObject(value: unknown): value is Record<string, unknown>;
+declare function isComponentArrayReference(value: unknown): value is ComponentArrayReference;
+declare function isStringValue(value: unknown): value is StringValue;
+declare function isNumberValue(value: unknown): value is NumberValue;
+declare function isBooleanValue(value: unknown): value is BooleanValue;
+declare function isAnyComponentNode(value: unknown): value is AnyComponentNode;
+declare function isResolvedAudioPlayer(props: unknown): props is ResolvedAudioPlayer;
+declare function isResolvedButton(props: unknown): props is ResolvedButton;
+declare function isResolvedCard(props: unknown): props is ResolvedCard;
+declare function isResolvedCheckbox(props: unknown): props is ResolvedCheckbox;
+declare function isResolvedColumn(props: unknown): props is ResolvedColumn;
+declare function isResolvedDateTimeInput(props: unknown): props is ResolvedDateTimeInput;
+declare function isResolvedDivider(props: unknown): props is ResolvedDivider;
+declare function isResolvedImage(props: unknown): props is ResolvedImage;
+declare function isResolvedIcon(props: unknown): props is ResolvedIcon;
+declare function isResolvedList(props: unknown): props is ResolvedList;
+declare function isResolvedModal(props: unknown): props is ResolvedModal;
+declare function isResolvedMultipleChoice(props: unknown): props is ResolvedMultipleChoice;
+declare function isResolvedRow(props: unknown): props is ResolvedRow;
+declare function isResolvedSlider(props: unknown): props is ResolvedSlider;
+declare function isResolvedTabItem(item: unknown): item is ResolvedTabItem;
+declare function isResolvedTabs(props: unknown): props is ResolvedTabs;
+declare function isResolvedText(props: unknown): props is ResolvedText;
+declare function isResolvedTextField(props: unknown): props is ResolvedTextField;
+declare function isResolvedVideo(props: unknown): props is ResolvedVideo;
+
+/**
+ * A2UI Message Processor
+ * 处理并整合服务器消息，构建 UI Surface 层级模型
+ */
+
+declare class A2uiMessageProcessor implements MessageProcessor {
+    static readonly DEFAULT_SURFACE_ID = "@default";
+    private mapCtor;
+    private arrayCtor;
+    private setCtor;
+    private objCtor;
+    private surfaces;
+    constructor(opts?: {
+        mapCtor?: MapConstructor;
+        arrayCtor?: ArrayConstructor;
+        setCtor?: SetConstructor;
+        objCtor?: ObjectConstructor;
+    });
+    getSurfaces(): ReadonlyMap<string, Surface>;
+    clearSurfaces(): void;
+    processMessages(messages: ServerToClientMessage[]): void;
+    getData(node: AnyComponentNode, relativePath: string, surfaceId?: string): DataValue | null;
+    setData(node: AnyComponentNode | null, relativePath: string, value: DataValue, surfaceId?: string): void;
+    resolvePath(path: string, dataContextPath?: string): string;
+    private parseIfJsonString;
+    private convertKeyValueArrayToMap;
+    private setDataByPath;
+    private normalizePath;
+    private getDataByPath;
+    private getOrCreateSurface;
+    private handleBeginRendering;
+    private handleSurfaceUpdate;
+    private handleDataModelUpdate;
+    private handleDeleteSurface;
+    private rebuildComponentTree;
+    private findValueKey;
+    private buildNodeRecursive;
+    private resolvePropertyValue;
+}
+/**
+ * 创建默认的消息处理器
+ */
+declare function createMessageProcessor(): A2uiMessageProcessor;
+
+/**
+ * A2UI Data Module
+ */
+
+type index_A2uiMessageProcessor = A2uiMessageProcessor;
+declare const index_A2uiMessageProcessor: typeof A2uiMessageProcessor;
+declare const index_createMessageProcessor: typeof createMessageProcessor;
+declare const index_isAnyComponentNode: typeof isAnyComponentNode;
+declare const index_isBooleanValue: typeof isBooleanValue;
+declare const index_isComponentArrayReference: typeof isComponentArrayReference;
+declare const index_isNumberValue: typeof isNumberValue;
+declare const index_isObject: typeof isObject;
+declare const index_isPath: typeof isPath;
+declare const index_isResolvedAudioPlayer: typeof isResolvedAudioPlayer;
+declare const index_isResolvedButton: typeof isResolvedButton;
+declare const index_isResolvedCard: typeof isResolvedCard;
+declare const index_isResolvedCheckbox: typeof isResolvedCheckbox;
+declare const index_isResolvedColumn: typeof isResolvedColumn;
+declare const index_isResolvedDateTimeInput: typeof isResolvedDateTimeInput;
+declare const index_isResolvedDivider: typeof isResolvedDivider;
+declare const index_isResolvedIcon: typeof isResolvedIcon;
+declare const index_isResolvedImage: typeof isResolvedImage;
+declare const index_isResolvedList: typeof isResolvedList;
+declare const index_isResolvedModal: typeof isResolvedModal;
+declare const index_isResolvedMultipleChoice: typeof isResolvedMultipleChoice;
+declare const index_isResolvedRow: typeof isResolvedRow;
+declare const index_isResolvedSlider: typeof isResolvedSlider;
+declare const index_isResolvedTabItem: typeof isResolvedTabItem;
+declare const index_isResolvedTabs: typeof isResolvedTabs;
+declare const index_isResolvedText: typeof isResolvedText;
+declare const index_isResolvedTextField: typeof isResolvedTextField;
+declare const index_isResolvedVideo: typeof isResolvedVideo;
+declare const index_isStringValue: typeof isStringValue;
+declare const index_isValueMap: typeof isValueMap;
+declare namespace index {
+  export { index_A2uiMessageProcessor as A2uiMessageProcessor, index_createMessageProcessor as createMessageProcessor, index_isAnyComponentNode as isAnyComponentNode, index_isBooleanValue as isBooleanValue, index_isComponentArrayReference as isComponentArrayReference, index_isNumberValue as isNumberValue, index_isObject as isObject, index_isPath as isPath, index_isResolvedAudioPlayer as isResolvedAudioPlayer, index_isResolvedButton as isResolvedButton, index_isResolvedCard as isResolvedCard, index_isResolvedCheckbox as isResolvedCheckbox, index_isResolvedColumn as isResolvedColumn, index_isResolvedDateTimeInput as isResolvedDateTimeInput, index_isResolvedDivider as isResolvedDivider, index_isResolvedIcon as isResolvedIcon, index_isResolvedImage as isResolvedImage, index_isResolvedList as isResolvedList, index_isResolvedModal as isResolvedModal, index_isResolvedMultipleChoice as isResolvedMultipleChoice, index_isResolvedRow as isResolvedRow, index_isResolvedSlider as isResolvedSlider, index_isResolvedTabItem as isResolvedTabItem, index_isResolvedTabs as isResolvedTabs, index_isResolvedText as isResolvedText, index_isResolvedTextField as isResolvedTextField, index_isResolvedVideo as isResolvedVideo, index_isStringValue as isStringValue, index_isValueMap as isValueMap };
+}
+
+export { A2uiMessageProcessor as A, isResolvedText as B, isResolvedTextField as C, isResolvedVideo as D, isValueMap as a, isPath as b, createMessageProcessor as c, isObject as d, isComponentArrayReference as e, isStringValue as f, isNumberValue as g, isBooleanValue as h, index as i, isAnyComponentNode as j, isResolvedAudioPlayer as k, isResolvedButton as l, isResolvedCard as m, isResolvedCheckbox as n, isResolvedColumn as o, isResolvedDateTimeInput as p, isResolvedDivider as q, isResolvedImage as r, isResolvedIcon as s, isResolvedList as t, isResolvedModal as u, isResolvedMultipleChoice as v, isResolvedRow as w, isResolvedSlider as x, isResolvedTabItem as y, isResolvedTabs as z };

package/dist/index-BWAU7Xp2.d.ts

@@ -0,0 +1,331 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { E as AnyComponentNode, i as MessageProcessor, ao as SurfaceID, a4 as ResolvedText, a6 as ResolvedImage, a5 as ResolvedIcon, a7 as ResolvedVideo, a8 as ResolvedAudioPlayer, ah as ResolvedButton, af as ResolvedRow, ag as ResolvedColumn, ai as ResolvedList, S as StringValue, a9 as ResolvedDivider, aa as ResolvedCheckbox, ab as ResolvedTextField, ac as ResolvedDateTimeInput, ad as ResolvedMultipleChoice, ae as ResolvedSlider, ap as Surface$1, N as NumberValue } from './types-CtrG7MJe.js';
+import { ReactNode, ComponentType } from 'react';
+import { A as A2UIAction } from './a2ui-CnaCcq4c.js';
+
+interface TextProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    text: ResolvedText['text'];
+    usageHint?: ResolvedText['usageHint'];
+    /**
+     * 是否使用 markdown 渲染
+     * @default true
+     */
+    markdown?: boolean;
+}
+declare function Text({ component, processor, surfaceId, text, usageHint, markdown, }: TextProps): react_jsx_runtime.JSX.Element;
+
+interface ImageProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    url: ResolvedImage['url'];
+    usageHint?: ResolvedImage['usageHint'];
+    fit?: ResolvedImage['fit'];
+}
+declare function Image({ component, processor, surfaceId, url, usageHint, fit, }: ImageProps): react_jsx_runtime.JSX.Element;
+
+interface IconProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    name: ResolvedIcon['name'];
+    size?: number | string;
+    className?: string;
+    /**
+     * 是否使用容器包裹 (类似首页风格)
+     */
+    container?: boolean;
+    /**
+     * 容器颜色变体: blue, green, purple, orange, primary, etc.
+     */
+    variant?: string;
+}
+declare function Icon({ component, processor, surfaceId, name, size, className, container, variant, }: IconProps): react_jsx_runtime.JSX.Element | null;
+
+interface VideoProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    url: ResolvedVideo['url'];
+}
+declare function Video({ component, processor, surfaceId, url }: VideoProps): react_jsx_runtime.JSX.Element;
+
+interface AudioProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    url: ResolvedAudioPlayer['url'];
+    description?: ResolvedAudioPlayer['description'];
+}
+declare function Audio({ component, processor, surfaceId, url, description }: AudioProps): react_jsx_runtime.JSX.Element;
+
+interface ButtonProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    action: ResolvedButton['action'];
+    children?: ReactNode;
+    onAction?: (event: A2UIAction) => void;
+}
+declare function Button({ component, action, children, onAction }: ButtonProps): react_jsx_runtime.JSX.Element;
+
+interface RowProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    alignment?: ResolvedRow['alignment'];
+    distribution?: ResolvedRow['distribution'];
+    children?: ReactNode;
+}
+declare function Row({ component, alignment, distribution, children, }: RowProps): react_jsx_runtime.JSX.Element;
+
+interface ColumnProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    alignment?: ResolvedColumn['alignment'];
+    distribution?: ResolvedColumn['distribution'];
+    children?: ReactNode;
+}
+declare function Column({ component, alignment, distribution, children, }: ColumnProps): react_jsx_runtime.JSX.Element;
+
+interface ListProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    direction?: ResolvedList['direction'];
+    children?: ReactNode;
+}
+declare function List({ direction, children }: ListProps): react_jsx_runtime.JSX.Element;
+
+interface CardProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    children?: ReactNode;
+}
+declare function Card({ children }: CardProps): react_jsx_runtime.JSX.Element;
+
+interface TabsProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    titles: StringValue[];
+    children?: ReactNode[];
+}
+declare function Tabs({ component, processor, surfaceId, titles, children }: TabsProps): react_jsx_runtime.JSX.Element;
+
+interface DividerProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    axis?: ResolvedDivider['axis'];
+    thickness?: ResolvedDivider['thickness'];
+    color?: ResolvedDivider['color'];
+}
+declare function Divider({ axis, thickness, color }: DividerProps): react_jsx_runtime.JSX.Element;
+
+interface ModalProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    entryPoint?: ReactNode;
+    content?: ReactNode;
+}
+declare function Modal({ entryPoint, content }: ModalProps): react_jsx_runtime.JSX.Element;
+
+interface CheckboxProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    label: ResolvedCheckbox['label'];
+    value: ResolvedCheckbox['value'];
+}
+declare function Checkbox({ component, processor, surfaceId, label, value }: CheckboxProps): react_jsx_runtime.JSX.Element;
+
+interface TextFieldProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    label: ResolvedTextField['label'];
+    text?: ResolvedTextField['text'];
+    type?: ResolvedTextField['type'];
+    validationRegexp?: ResolvedTextField['validationRegexp'];
+}
+declare function TextField({ component, processor, surfaceId, label, text, type, }: TextFieldProps): react_jsx_runtime.JSX.Element;
+
+interface DateTimeInputProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    value: ResolvedDateTimeInput['value'];
+    enableDate?: ResolvedDateTimeInput['enableDate'];
+    enableTime?: ResolvedDateTimeInput['enableTime'];
+}
+declare function DateTimeInput({ component, processor, surfaceId, value, enableDate, enableTime, }: DateTimeInputProps): react_jsx_runtime.JSX.Element;
+
+interface MultipleChoiceProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    selections: ResolvedMultipleChoice['selections'];
+    options?: ResolvedMultipleChoice['options'];
+    maxAllowedSelections?: ResolvedMultipleChoice['maxAllowedSelections'];
+}
+declare function MultipleChoice({ component, processor, surfaceId, selections, options, }: MultipleChoiceProps): react_jsx_runtime.JSX.Element;
+
+interface SliderProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    value: ResolvedSlider['value'];
+    minValue?: ResolvedSlider['minValue'];
+    maxValue?: ResolvedSlider['maxValue'];
+}
+declare function Slider({ component, processor, surfaceId, value, minValue, maxValue, }: SliderProps): react_jsx_runtime.JSX.Element;
+
+interface RootProps {
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    childComponents: AnyComponentNode[] | null;
+    enableCustomElements?: boolean;
+    onAction?: (event: A2UIAction) => void;
+}
+declare function Root({ processor, surfaceId, childComponents, enableCustomElements, onAction, }: RootProps): react_jsx_runtime.JSX.Element | null;
+interface ComponentRendererProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    enableCustomElements: boolean;
+    onAction?: (event: A2UIAction) => void;
+}
+declare function ComponentRenderer({ component, processor, surfaceId, enableCustomElements, onAction, }: ComponentRendererProps): ReactNode;
+
+interface SurfaceProps {
+    surfaceId: SurfaceID;
+    surface: Surface$1 | null;
+    processor: MessageProcessor | null;
+    enableCustomElements?: boolean;
+    onAction?: (event: A2UIAction) => void;
+}
+declare function Surface({ surfaceId, surface, processor, enableCustomElements, onAction, }: SurfaceProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * A2UI Component Registry
+ */
+
+/**
+ * 组件 Props 基础接口
+ */
+interface A2UIComponentProps {
+    component: AnyComponentNode;
+    processor: MessageProcessor | null;
+    surfaceId: SurfaceID | null;
+    childComponents?: AnyComponentNode[] | null;
+    enableCustomElements?: boolean;
+}
+/**
+ * 组件注册项
+ */
+type RegisteredComponent = ComponentType<A2UIComponentProps & Record<string, unknown>>;
+/**
+ * 组件注册表
+ */
+declare class ComponentRegistry {
+    private registry;
+    /**
+     * 注册组件
+     */
+    register(typeName: string, component: RegisteredComponent): void;
+    /**
+     * 获取组件
+     */
+    get(typeName: string): RegisteredComponent | undefined;
+    /**
+     * 检查组件是否已注册
+     */
+    has(typeName: string): boolean;
+    /**
+     * 注销组件
+     */
+    unregister(typeName: string): boolean;
+    /**
+     * 获取所有已注册的组件类型
+     */
+    getRegisteredTypes(): string[];
+}
+declare const componentRegistry: ComponentRegistry;
+
+interface MarkdownProps {
+    children: string;
+    className?: string;
+}
+/**
+ * Markdown 渲染组件
+ */
+declare function Markdown({ children, className }: MarkdownProps): react_jsx_runtime.JSX.Element;
+/**
+ * 简单的 markdown 到 HTML 转换
+ * 注意：这个函数返回一个 React 元素，不是原始 HTML 字符串
+ */
+declare function renderMarkdown(value: string): ReactNode;
+
+/**
+ * A2UI UI Utilities
+ */
+
+/**
+ * 从 StringValue 提取实际字符串值
+ */
+declare function extractStringValue(val: StringValue | null, component: AnyComponentNode | null, processor: MessageProcessor | null, surfaceId: string | null): string;
+/**
+ * 从 NumberValue 提取实际数字值
+ */
+declare function extractNumberValue(val: NumberValue | null, component: AnyComponentNode | null, processor: MessageProcessor | null, surfaceId: string | null): number;
+/**
+ * 合并 className
+ */
+declare function cn(...classes: (string | Record<string, boolean> | undefined | null | false)[]): string;
+
+/**
+ * A2UI UI Module
+ */
+
+type index_A2UIComponentProps = A2UIComponentProps;
+declare const index_Audio: typeof Audio;
+declare const index_Button: typeof Button;
+declare const index_Card: typeof Card;
+declare const index_Checkbox: typeof Checkbox;
+declare const index_Column: typeof Column;
+type index_ComponentRegistry = ComponentRegistry;
+declare const index_ComponentRegistry: typeof ComponentRegistry;
+declare const index_ComponentRenderer: typeof ComponentRenderer;
+declare const index_DateTimeInput: typeof DateTimeInput;
+declare const index_Divider: typeof Divider;
+declare const index_Icon: typeof Icon;
+declare const index_Image: typeof Image;
+declare const index_List: typeof List;
+declare const index_Markdown: typeof Markdown;
+declare const index_Modal: typeof Modal;
+declare const index_MultipleChoice: typeof MultipleChoice;
+declare const index_Root: typeof Root;
+declare const index_Row: typeof Row;
+declare const index_Slider: typeof Slider;
+declare const index_Surface: typeof Surface;
+declare const index_Tabs: typeof Tabs;
+declare const index_Text: typeof Text;
+declare const index_TextField: typeof TextField;
+declare const index_Video: typeof Video;
+declare const index_cn: typeof cn;
+declare const index_componentRegistry: typeof componentRegistry;
+declare const index_extractNumberValue: typeof extractNumberValue;
+declare const index_extractStringValue: typeof extractStringValue;
+declare const index_renderMarkdown: typeof renderMarkdown;
+declare namespace index {
+  export { type index_A2UIComponentProps as A2UIComponentProps, index_Audio as Audio, index_Button as Button, index_Card as Card, index_Checkbox as Checkbox, index_Column as Column, index_ComponentRegistry as ComponentRegistry, index_ComponentRenderer as ComponentRenderer, index_DateTimeInput as DateTimeInput, index_Divider as Divider, index_Icon as Icon, index_Image as Image, index_List as List, index_Markdown as Markdown, index_Modal as Modal, index_MultipleChoice as MultipleChoice, index_Root as Root, index_Row as Row, index_Slider as Slider, index_Surface as Surface, index_Tabs as Tabs, index_Text as Text, index_TextField as TextField, index_Video as Video, index_cn as cn, index_componentRegistry as componentRegistry, index_extractNumberValue as extractNumberValue, index_extractStringValue as extractStringValue, index_renderMarkdown as renderMarkdown };
+}
+
+export { Audio as A, Button as B, Column as C, Divider as D, Image as I, List as L, MultipleChoice as M, Row as R, Slider as S, Text as T, Video as V, Icon as a, Card as b, Checkbox as c, TextField as d, DateTimeInput as e, Tabs as f, Modal as g, Root as h, index as i, Surface as j, ComponentRenderer as k, Markdown as l, ComponentRegistry as m, componentRegistry as n, type A2UIComponentProps as o, extractStringValue as p, extractNumberValue as q, renderMarkdown as r, cn as s };