@chatbi-v/xcml 2.0.1 → 2.1.1

package/dist/index.d.cts

@@ -397,6 +397,58 @@ declare function toXCMLNodeFromElement(name: string, attrs: Record<string, any>,
  */
 declare function preprocessXCML(md: string, knownTags?: string[]): string;
 
+interface XTagPluginOptions {
+    /**
+     * 允许的标签名称列表，不包含前缀 'x-'
+     * @default ['chart', 'table', 'metric', 'list', 'card', 'toc']
+     */
+    tags?: string[];
+}
+/**
+ * 插件工厂：返回 marked 扩展/引擎插件（兼容 @ant-design/x-markdown）
+ */
+declare function xTagPlugin(options?: XTagPluginOptions): {
+    level: string;
+    name: string;
+    start(src: string): number;
+    /**
+     * tokenizer：将 <x-*> 片段转为自定义 Token
+     */
+    tokenizer(src: string): {
+        type: string;
+        raw: string;
+        name: string;
+        attrs: Record<string, any>;
+        body: string;
+    } | undefined;
+    /**
+     * renderer：不返回原始 HTML，转为受控节点
+     */
+    renderer(token: any): {
+        type: string;
+        props: any;
+        body: any;
+    };
+};
+
+interface XCMLLayoutContextValue {
+    /**
+     * 容器宽度（像素）
+     */
+    containerWidth: number;
+}
+/**
+ * XCML 布局上下文 Provider
+ * 负责监听容器尺寸变化并下发给子组件
+ */
+declare const XCMLLayoutProvider: React$1.FC<{
+    children: React$1.ReactNode;
+}>;
+/**
+ * 获取 XCML 布局信息的 Hook
+ */
+declare const useXCMLLayout: () => XCMLLayoutContextValue;
+
 interface XCMLProps {
     content?: string;
     stream?: AsyncIterable<string>;
@@ -414,6 +466,14 @@ interface XCMLProps {
      * 主题配置，用于 Mermaid 等图表
      */
     theme?: string;
+    /**
+     * 内容变更回调
+     */
+    onContentChange?: (content: string) => void;
+    /**
+     * 组件渲染状态变更回调
+     */
+    onComponentRender?: (tag: string, status: 'loading' | 'success' | 'error') => void;
 }
 /**
  * XCML 核心渲染组件 (XCMLMarkdown)
@@ -999,8 +1059,8 @@ type ThemeProviderState = {
     theme: Theme;
     setTheme: (theme: Theme) => void;
 };
-declare function ThemeProvider({ children, defaultTheme, theme: controlledTheme, primaryColor, // Indigo 500 default
+declare function ThemeProvider({ children, defaultTheme, theme: controlledTheme, primaryColor, // Orange 600 (Sunset)
 storageKey, scoped, className, style, ...props }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
 declare const useTheme: () => ThemeProviderState;
 
-export { AntVChartLoader, type AntVRendererOptions, type BaseChartProps, type BasicRenderersOptions, COMMON_PROPS, type ChartAxisConfig, type ChartComponent, type ChartLabelConfig, type ChartLegendConfig, type ChartProps, type ChartStrategy, type ColumnChartProps, DefaultEmptyPlaceholder, DefaultErrorPlaceholder, type DualAxesChartProps, type DualAxesChildConfig, type ExtendedRenderersOptions, type FunnelChartProps, type LineChartProps, type PieChartProps, type Theme, ThemeProvider, type XCMLBaseComponent, type XCMLBaseProps, XCMLCardWrapper, XCMLChart, type XCMLComponentSchema, type XCMLContext, XCMLEventBus, XCMLMarkdown, type XCMLPlugin, type XCMLPropertyCategory, type XCMLPropertyDefinition, type XCMLPropertyType, type XCMLProps, type XCMLRenderer, XCML_SCHEMAS, buildConfig, chartSchema, cleanPropsBySchema, columnChartSchema, columnStrategy, createAntVRenderers, createBasicRenderers, createExtendedRenderers, createRenderersWithAliases, deepMerge, dualAxesChartSchema, dualAxesStrategy, extractBaseStyles, funnelChartSchema, funnelStrategy, getChartStrategy, getTheme, lineChartSchema, lineStrategy, mergePropsAndBody, normalizeNodeData, normalizeTagName, parseArrayProp, parseInlineData, parseXCML, pieChartSchema, pieStrategy, preprocessXCML, renderXCML, strategies, stringifyToXCML, themeDark, themeLight, themeMap, toXCMLNodeFromElement, toXCMLTag, toXTag, useTheme, useXCMLComponent, useXCMLNode, validateDataSchema, validateXCMLNode, withXCMLCard, xcmlBus };
+export { AntVChartLoader, type AntVRendererOptions, type BaseChartProps, type BasicRenderersOptions, COMMON_PROPS, type ChartAxisConfig, type ChartComponent, type ChartLabelConfig, type ChartLegendConfig, type ChartProps, type ChartStrategy, type ColumnChartProps, DefaultEmptyPlaceholder, DefaultErrorPlaceholder, type DualAxesChartProps, type DualAxesChildConfig, type ExtendedRenderersOptions, type FunnelChartProps, type LineChartProps, type PieChartProps, type Theme, ThemeProvider, type XCMLBaseComponent, type XCMLBaseProps, XCMLCardWrapper, XCMLChart, type XCMLComponentSchema, type XCMLContext, XCMLEventBus, XCMLLayoutProvider, XCMLMarkdown, type XCMLPlugin, type XCMLPropertyCategory, type XCMLPropertyDefinition, type XCMLPropertyType, type XCMLProps, type XCMLRenderer, XCML_SCHEMAS, type XTagPluginOptions, buildConfig, chartSchema, cleanPropsBySchema, columnChartSchema, columnStrategy, createAntVRenderers, createBasicRenderers, createExtendedRenderers, createRenderersWithAliases, deepMerge, dualAxesChartSchema, dualAxesStrategy, extractBaseStyles, funnelChartSchema, funnelStrategy, getChartStrategy, getTheme, lineChartSchema, lineStrategy, mergePropsAndBody, normalizeNodeData, normalizeTagName, parseArrayProp, parseInlineData, parseXCML, pieChartSchema, pieStrategy, preprocessXCML, renderXCML, strategies, stringifyToXCML, themeDark, themeLight, themeMap, toXCMLNodeFromElement, toXCMLTag, toXTag, useTheme, useXCMLComponent, useXCMLLayout, useXCMLNode, validateDataSchema, validateXCMLNode, withXCMLCard, xTagPlugin, xcmlBus };

package/dist/index.d.ts

@@ -397,6 +397,58 @@ declare function toXCMLNodeFromElement(name: string, attrs: Record<string, any>,
  */
 declare function preprocessXCML(md: string, knownTags?: string[]): string;
 
+interface XTagPluginOptions {
+    /**
+     * 允许的标签名称列表，不包含前缀 'x-'
+     * @default ['chart', 'table', 'metric', 'list', 'card', 'toc']
+     */
+    tags?: string[];
+}
+/**
+ * 插件工厂：返回 marked 扩展/引擎插件（兼容 @ant-design/x-markdown）
+ */
+declare function xTagPlugin(options?: XTagPluginOptions): {
+    level: string;
+    name: string;
+    start(src: string): number;
+    /**
+     * tokenizer：将 <x-*> 片段转为自定义 Token
+     */
+    tokenizer(src: string): {
+        type: string;
+        raw: string;
+        name: string;
+        attrs: Record<string, any>;
+        body: string;
+    } | undefined;
+    /**
+     * renderer：不返回原始 HTML，转为受控节点
+     */
+    renderer(token: any): {
+        type: string;
+        props: any;
+        body: any;
+    };
+};
+
+interface XCMLLayoutContextValue {
+    /**
+     * 容器宽度（像素）
+     */
+    containerWidth: number;
+}
+/**
+ * XCML 布局上下文 Provider
+ * 负责监听容器尺寸变化并下发给子组件
+ */
+declare const XCMLLayoutProvider: React$1.FC<{
+    children: React$1.ReactNode;
+}>;
+/**
+ * 获取 XCML 布局信息的 Hook
+ */
+declare const useXCMLLayout: () => XCMLLayoutContextValue;
+
 interface XCMLProps {
     content?: string;
     stream?: AsyncIterable<string>;
@@ -414,6 +466,14 @@ interface XCMLProps {
      * 主题配置，用于 Mermaid 等图表
      */
     theme?: string;
+    /**
+     * 内容变更回调
+     */
+    onContentChange?: (content: string) => void;
+    /**
+     * 组件渲染状态变更回调
+     */
+    onComponentRender?: (tag: string, status: 'loading' | 'success' | 'error') => void;
 }
 /**
  * XCML 核心渲染组件 (XCMLMarkdown)
@@ -999,8 +1059,8 @@ type ThemeProviderState = {
     theme: Theme;
     setTheme: (theme: Theme) => void;
 };
-declare function ThemeProvider({ children, defaultTheme, theme: controlledTheme, primaryColor, // Indigo 500 default
+declare function ThemeProvider({ children, defaultTheme, theme: controlledTheme, primaryColor, // Orange 600 (Sunset)
 storageKey, scoped, className, style, ...props }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
 declare const useTheme: () => ThemeProviderState;
 
-export { AntVChartLoader, type AntVRendererOptions, type BaseChartProps, type BasicRenderersOptions, COMMON_PROPS, type ChartAxisConfig, type ChartComponent, type ChartLabelConfig, type ChartLegendConfig, type ChartProps, type ChartStrategy, type ColumnChartProps, DefaultEmptyPlaceholder, DefaultErrorPlaceholder, type DualAxesChartProps, type DualAxesChildConfig, type ExtendedRenderersOptions, type FunnelChartProps, type LineChartProps, type PieChartProps, type Theme, ThemeProvider, type XCMLBaseComponent, type XCMLBaseProps, XCMLCardWrapper, XCMLChart, type XCMLComponentSchema, type XCMLContext, XCMLEventBus, XCMLMarkdown, type XCMLPlugin, type XCMLPropertyCategory, type XCMLPropertyDefinition, type XCMLPropertyType, type XCMLProps, type XCMLRenderer, XCML_SCHEMAS, buildConfig, chartSchema, cleanPropsBySchema, columnChartSchema, columnStrategy, createAntVRenderers, createBasicRenderers, createExtendedRenderers, createRenderersWithAliases, deepMerge, dualAxesChartSchema, dualAxesStrategy, extractBaseStyles, funnelChartSchema, funnelStrategy, getChartStrategy, getTheme, lineChartSchema, lineStrategy, mergePropsAndBody, normalizeNodeData, normalizeTagName, parseArrayProp, parseInlineData, parseXCML, pieChartSchema, pieStrategy, preprocessXCML, renderXCML, strategies, stringifyToXCML, themeDark, themeLight, themeMap, toXCMLNodeFromElement, toXCMLTag, toXTag, useTheme, useXCMLComponent, useXCMLNode, validateDataSchema, validateXCMLNode, withXCMLCard, xcmlBus };
+export { AntVChartLoader, type AntVRendererOptions, type BaseChartProps, type BasicRenderersOptions, COMMON_PROPS, type ChartAxisConfig, type ChartComponent, type ChartLabelConfig, type ChartLegendConfig, type ChartProps, type ChartStrategy, type ColumnChartProps, DefaultEmptyPlaceholder, DefaultErrorPlaceholder, type DualAxesChartProps, type DualAxesChildConfig, type ExtendedRenderersOptions, type FunnelChartProps, type LineChartProps, type PieChartProps, type Theme, ThemeProvider, type XCMLBaseComponent, type XCMLBaseProps, XCMLCardWrapper, XCMLChart, type XCMLComponentSchema, type XCMLContext, XCMLEventBus, XCMLLayoutProvider, XCMLMarkdown, type XCMLPlugin, type XCMLPropertyCategory, type XCMLPropertyDefinition, type XCMLPropertyType, type XCMLProps, type XCMLRenderer, XCML_SCHEMAS, type XTagPluginOptions, buildConfig, chartSchema, cleanPropsBySchema, columnChartSchema, columnStrategy, createAntVRenderers, createBasicRenderers, createExtendedRenderers, createRenderersWithAliases, deepMerge, dualAxesChartSchema, dualAxesStrategy, extractBaseStyles, funnelChartSchema, funnelStrategy, getChartStrategy, getTheme, lineChartSchema, lineStrategy, mergePropsAndBody, normalizeNodeData, normalizeTagName, parseArrayProp, parseInlineData, parseXCML, pieChartSchema, pieStrategy, preprocessXCML, renderXCML, strategies, stringifyToXCML, themeDark, themeLight, themeMap, toXCMLNodeFromElement, toXCMLTag, toXTag, useTheme, useXCMLComponent, useXCMLLayout, useXCMLNode, validateDataSchema, validateXCMLNode, withXCMLCard, xTagPlugin, xcmlBus };