orbcafe-ui 1.1.1 → 1.1.3

package/README.md

@@ -6,7 +6,7 @@
 
 - 组件可直接通过 NPM 安装并使用。
 - 组件 API 稳定、类型完整、目录结构一致。
-- 组件内部逻辑可复用（通过 Hooks），文档可追踪（README 规范化）。
+- 组件公共 API、类型契约与回调契约稳定，文档与 examples 可追踪。
 
 ---
 
@@ -24,12 +24,13 @@
 | `CustomizeAgent` | AI 参数与 Prompt 模板设置弹窗 | `src/components/CustomizeAgent` | `src/components/CustomizeAgent/README.md` |
 | `DetailInfo` | 标准详情页容器（信息块 + Tabs + 底部表格 + AI/搜索） | `src/components/DetailInfo` | `src/components/DetailInfo/README.md` |
 | `PageLayout` | 页面壳层（Header + Navigation + Content） | `src/components/PageLayout` | `src/components/PageLayout/README.md` |
+| `AgentUI` | 聊天 UI 与 Copilot UI（StdChat / CopilotChat / AgentPanel） | `src/components/AgentUI` | `src/components/AgentUI/README.md` |
 
 ### 文档查阅顺序（推荐）
 
 1. 先看模块根 README：了解能力边界、最小接入示例。  
-2. 再看模块 `Hooks/README.md`：确认状态管理、参数、返回值与联动方式。  
-3. 最后看模块详细设计文档（如 `graphreport.md`）：理解内部结构与扩展点。  
+2. 如果该模块公开导出 hooks，再看模块 `Hooks/README.md`：确认状态管理、参数、返回值与联动方式。  
+3. 最后看模块详细设计文档或 AI 契约索引：理解内部结构、标准案例与扩展点。  
 
 ### 常用文档索引
 
@@ -38,6 +39,76 @@
 - `StdReport Hooks`：`src/components/StdReport/Hooks/README.md`
 - `PageLayout Hooks`：`src/components/PageLayout/Hooks/README.md`
 - `DetailInfo` 模块文档：`src/components/DetailInfo/README.md`
+- `AgentUI` 模块文档：`src/components/AgentUI/README.md`
+- `AI 模块契约索引`：`skills/orbcafe-ui-component-usage/references/module-contracts.md`
+
+---
+
+## AgentUI（聊天与 Copilot）
+
+`AgentUI` 是库里负责聊天类交互的标准模块，当前建议直接使用以下公共 API：
+
+- `AgentPanel`: 带头部的标准聊天容器。
+- `StdChat`: 适合整页、弹窗、工作台内嵌聊天。
+- `CopilotChat`: 适合右下角 Copilot 浮窗内容层。
+- `AgentUICardHooks` / `AgentUICardHookEvent`: 卡片交互事件回调类型。
+
+### Import
+
+```tsx
+import {
+  AgentPanel,
+  StdChat,
+  CopilotChat,
+  type ChatMessage,
+  type AgentUICardHooks
+} from 'orbcafe-ui'
+```
+
+### 使用约定
+
+- `AgentUI` 当前没有独立导出的自定义 hooks，对外稳定接口是组件 props 和回调契约。
+- 标准消息状态以 `messages + isResponding` 为主。
+- 卡片交互统一通过 `cardHooks.onCardEvent` 承接。
+- `StdChat` 负责标准聊天布局，`CopilotChat` 只负责 Copilot 面板内容层，不负责浮窗壳、拖拽和缩放。
+
+详细接入方式、example 拆解和封装边界说明见 `src/components/AgentUI/README.md`。
+
+---
+
+## AI-First Integration
+
+如果目标是让 AI 在 vibe coding 场景里稳定使用 ORBCAFE UI，推荐遵循这条顺序：
+
+1. 先用 `skills/orbcafe-ui-component-usage` 判定目标模块。
+2. 再看 `skills/orbcafe-ui-component-usage/references/module-contracts.md`，确认：
+   - 公共导出入口
+   - 推荐标准组件
+   - 是否公开 hooks
+   - 最小状态结构
+   - 标准 example
+   - 验证与排障清单
+3. 最后才看具体模块 README 和官方 examples。
+
+### 当前标准化原则
+
+- 只使用 `src/index.ts` 可达的公共导出。
+- 优先走 canonical example，不从内部组件自由拼装。
+- 每个模块都要回答 5 个问题：
+  - 用哪个公共入口组件或 hook
+  - 最小状态是什么
+  - 必须回调有哪些
+  - 标准 example 是哪个
+  - 怎么验证“真的生效了”
+
+### 关于 Hooks
+
+不是所有模块都以 hooks 为主入口。
+
+- `StdReport`、`DetailInfo`、`PivotTable`、`AINav`、`PageLayout` 明确公开了 hooks。
+- `AgentUI` 当前不公开自定义 hook，稳定入口是组件 props 和回调契约。
+
+这条规则对 AI 很重要，因为它决定了应该生成“hook 驱动代码”还是“组件 + callbacks 驱动代码”。
 
 ---
 
@@ -186,15 +257,24 @@ Hydration mismatch 常见来源：
 提交前建议至少执行：
 
 ```bash
-# 1) 构建组件库
+# 1) 校验 AI 契约与公开导出一致
+npm run check:ai-contracts
+
+# 2) 构建组件库
 npm run build
 
-# 2) 校验 examples
+# 3) 校验 examples
 cd examples
 npm run lint
 npx tsc --noEmit
 ```
 
+如果要做一轮更完整的发布前检查：
+
+```bash
+npm run release:check
+```
+
 如果只想快速看运行效果：
 
 ```bash
@@ -202,6 +282,16 @@ cd examples
 npm run dev
 ```
 
+### 发布前 AI 契约清单
+
+每次发布前至少确认：
+
+1. `src/index.ts` 的公共导出与 skill 文档一致。
+2. `skills/orbcafe-ui-component-usage/references/module-contracts.md` 和 `.json` 已同步更新。
+3. 新模块已声明 `Hook-first` / `Component-first`。
+4. 每个模块至少有一个 canonical example。
+5. router skill 已能把新模块正确分流。
+
 ---
 
 ## Internationalization (i18n)

package/dist/COrbCanvas-EGX5NO3Y.mjs

@@ -0,0 +1 @@
+export{b as COrbCanvas}from'./chunk-74Z76O3S.mjs';

package/dist/chunk-74Z76O3S.mjs

@@ -0,0 +1,183 @@
+import {Renderer,Triangle,Program,Vec3,Mesh}from'ogl';import {useRef,useEffect}from'react';import {jsx}from'react/jsx-runtime';var U=Object.defineProperty;var B=(t,o,n)=>o in t?U(t,o,{enumerable:true,configurable:true,writable:true,value:n}):t[o]=n;var X=(t,o,n)=>B(t,typeof o!="symbol"?o+"":o,n);function J({hue:t=0,hoverIntensity:o=.2,rotateOnHover:n=true,forceHoverState:s=false,backgroundColor:a="transparent"}){let c=useRef(null),g=`
+    precision highp float;
+    attribute vec2 position;
+    attribute vec2 uv;
+    varying vec2 vUv;
+    void main() {
+      vUv = uv;
+      gl_Position = vec4(position, 0.0, 1.0);
+    }
+  `,h=`
+    precision highp float;
+
+    uniform float iTime;
+    uniform vec3 iResolution;
+    uniform float hue;
+    uniform float hover;
+    uniform float rot;
+    uniform float hoverIntensity;
+    uniform vec3 backgroundColor;
+    varying vec2 vUv;
+
+    vec3 rgb2yiq(vec3 c) {
+      float y = dot(c, vec3(0.299, 0.587, 0.114));
+      float i = dot(c, vec3(0.596, -0.274, -0.322));
+      float q = dot(c, vec3(0.211, -0.523, 0.312));
+      return vec3(y, i, q);
+    }
+    
+    vec3 yiq2rgb(vec3 c) {
+      float r = c.x + 0.956 * c.y + 0.621 * c.z;
+      float g = c.x - 0.272 * c.y - 0.647 * c.z;
+      float b = c.x - 1.106 * c.y + 1.703 * c.z;
+      return vec3(r, g, b);
+    }
+    
+    vec3 adjustHue(vec3 color, float hueDeg) {
+      float hueRad = hueDeg * 3.14159265 / 180.0;
+      vec3 yiq = rgb2yiq(color);
+      float cosA = cos(hueRad);
+      float sinA = sin(hueRad);
+      float i = yiq.y * cosA - yiq.z * sinA;
+      float q = yiq.y * sinA + yiq.z * cosA;
+      yiq.y = i;
+      yiq.z = q;
+      return yiq2rgb(yiq);
+    }
+
+    vec3 hash33(vec3 p3) {
+      p3 = fract(p3 * vec3(0.1031, 0.11369, 0.13787));
+      p3 += dot(p3, p3.yxz + 19.19);
+      return -1.0 + 2.0 * fract(vec3(
+        p3.x + p3.y,
+        p3.x + p3.z,
+        p3.y + p3.z
+      ) * p3.zyx);
+    }
+
+    float snoise3(vec3 p) {
+      const float K1 = 0.333333333;
+      const float K2 = 0.166666667;
+      vec3 i = floor(p + (p.x + p.y + p.z) * K1);
+      vec3 d0 = p - (i - (i.x + i.y + i.z) * K2);
+      vec3 e = step(vec3(0.0), d0 - d0.yzx);
+      vec3 i1 = e * (1.0 - e.zxy);
+      vec3 i2 = 1.0 - e.zxy * (1.0 - e);
+      vec3 d1 = d0 - (i1 - K2);
+      vec3 d2 = d0 - (i2 - K1);
+      vec3 d3 = d0 - 0.5;
+      vec4 h = max(0.6 - vec4(
+        dot(d0, d0),
+        dot(d1, d1),
+        dot(d2, d2),
+        dot(d3, d3)
+      ), 0.0);
+      vec4 n = h * h * h * h * vec4(
+        dot(d0, hash33(i)),
+        dot(d1, hash33(i + i1)),
+        dot(d2, hash33(i + i2)),
+        dot(d3, hash33(i + 1.0))
+      );
+      return dot(vec4(31.316), n);
+    }
+
+    vec4 extractAlpha(vec3 colorIn) {
+      float a = max(max(colorIn.r, colorIn.g), colorIn.b);
+      return vec4(colorIn.rgb / (a + 1e-5), a);
+    }
+
+    const vec3 baseColor1 = vec3(0.611765, 0.262745, 0.996078);
+    const vec3 baseColor2 = vec3(0.298039, 0.760784, 0.913725);
+    const vec3 baseColor3 = vec3(0.062745, 0.078431, 0.600000);
+    // Make it solid by reducing inner radius to near zero
+    const float innerRadius = 0.0;
+    const float noiseScale = 1.0;
+
+    float light1(float intensity, float attenuation, float dist) {
+      return intensity / (1.0 + dist * attenuation);
+    }
+    float light2(float intensity, float attenuation, float dist) {
+      return intensity / (1.0 + dist * dist * attenuation);
+    }
+
+    vec4 draw(vec2 uv) {
+      vec3 color1 = adjustHue(baseColor1, hue);
+      vec3 color2 = adjustHue(baseColor2, hue);
+      vec3 color3 = adjustHue(baseColor3, hue);
+      
+      float ang = atan(uv.y, uv.x);
+      float len = length(uv);
+      float invLen = len > 0.0 ? 1.0 / len : 0.0;
+
+      float bgLuminance = dot(backgroundColor, vec3(0.299, 0.587, 0.114));
+      
+      float n0 = snoise3(vec3(uv * noiseScale, iTime * 0.5)) * 0.5 + 0.5;
+      
+      // Increased outer radius factor from 1.0 to 1.8 to make the orb larger
+      float r0 = mix(mix(innerRadius, 1.2, 0.4), mix(innerRadius, 1.8, 0.6), n0);
+      
+      float d0 = distance(uv, (r0 * invLen) * uv);
+      float v0 = light1(1.0, 10.0, d0);
+      v0 *= smoothstep(r0 * 1.05, r0, len);
+      
+      // Remove inner fade to keep the center solid
+      float innerFade = 1.0; 
+      
+      v0 *= mix(innerFade, 1.0, bgLuminance * 0.7);
+      float cl = cos(ang + iTime * 2.0) * 0.5 + 0.5;
+      
+      float a = iTime * -1.0;
+      vec2 pos = vec2(cos(a), sin(a)) * r0;
+      float d = distance(uv, pos);
+      float v1 = light2(1.5, 5.0, d);
+      v1 *= light1(1.0, 50.0, d0);
+      
+      float v2 = smoothstep(1.0, mix(innerRadius, 1.0, n0 * 0.5), len);
+      
+      // Keep center solid instead of fading out
+      float v3 = 1.0; 
+      
+      vec3 colBase = mix(color1, color2, cl);
+      float fadeAmount = mix(1.0, 0.1, bgLuminance);
+      
+      vec3 darkCol = mix(color3, colBase, v0);
+      darkCol = (darkCol + v1) * v2 * v3;
+      darkCol = clamp(darkCol, 0.0, 1.0);
+      
+      vec3 lightCol = (colBase + v1) * mix(1.0, v2 * v3, fadeAmount);
+      lightCol = mix(backgroundColor, lightCol, v0);
+      lightCol = clamp(lightCol, 0.0, 1.0);
+      
+      vec3 finalCol = mix(darkCol, lightCol, bgLuminance);
+      
+      return extractAlpha(finalCol);
+    }
+
+    vec4 mainImage(vec2 fragCoord) {
+      vec2 center = iResolution.xy * 0.5;
+      // Use max dimension to ensure the orb covers the area (creating an ambient effect)
+      // rather than fitting inside (which would be tiny in a header)
+      float size = max(iResolution.x, iResolution.y);
+      vec2 uv = (fragCoord - center) / size * 2.0;
+
+      // Add randomness/waviness to UV coordinates
+      uv.x += sin(uv.y * 3.0 + iTime * 0.5) * 0.1;
+      uv.y += cos(uv.x * 3.0 + iTime * 0.5) * 0.1;
+      
+      float angle = rot;
+      float s = sin(angle);
+      float c = cos(angle);
+      uv = vec2(c * uv.x - s * uv.y, s * uv.x + c * uv.y);
+      
+      uv.x += hover * hoverIntensity * 0.1 * sin(uv.y * 10.0 + iTime);
+      uv.y += hover * hoverIntensity * 0.1 * sin(uv.x * 10.0 + iTime);
+      
+      return draw(uv);
+    }
+
+    void main() {
+      vec2 fragCoord = vUv * iResolution.xy;
+      vec4 col = mainImage(fragCoord);
+      gl_FragColor = vec4(col.rgb * col.a, col.a);
+    }
+  `;return useEffect(()=>{let i=c.current;if(!i)return;let l=new Renderer({alpha:true,premultipliedAlpha:false}),e=l.gl;e.clearColor(0,0,0,0),i.appendChild(e.canvas);let r=new Triangle(e),v=new Program(e,{vertex:g,fragment:h,uniforms:{iTime:{value:0},iResolution:{value:new Vec3(e.canvas.width,e.canvas.height,e.canvas.width/e.canvas.height)},hue:{value:t},hover:{value:0},rot:{value:0},hoverIntensity:{value:o},backgroundColor:{value:k(a)}}}),E=new Mesh(e,{geometry:r,program:v});function y(){if(!i)return;let u=window.devicePixelRatio||1,d=i.clientWidth,f=i.clientHeight;l.setSize(d*u,f*u),e.canvas.style.width=d+"px",e.canvas.style.height=f+"px",v.uniforms.iResolution.value.set(e.canvas.width,e.canvas.height,e.canvas.width/e.canvas.height);}window.addEventListener("resize",y),y();let p=0,x=0,C=0,M=.3,w=u=>{let d=i.getBoundingClientRect(),f=u.clientX-d.left,H=u.clientY-d.top,R=d.width,q=d.height,A=Math.min(R,q),K=R/2,F=q/2,L=(f-K)/A*2,T=(H-F)/A*2;Math.sqrt(L*L+T*T)<.8?p=1:p=0;},z=()=>{p=0;};i.addEventListener("mousemove",w),i.addEventListener("mouseleave",z);let b,I=u=>{b=requestAnimationFrame(I);let d=(u-x)*.001;x=u,v.uniforms.iTime.value=u*.001,v.uniforms.hue.value=t,v.uniforms.hoverIntensity.value=o,v.uniforms.backgroundColor.value=k(a);let f=s?1:p;v.uniforms.hover.value+=(f-v.uniforms.hover.value)*.1,n&&f>.5&&(C+=d*M),v.uniforms.rot.value=C,l.render({scene:E});};return b=requestAnimationFrame(I),()=>{cancelAnimationFrame(b),window.removeEventListener("resize",y),i.removeEventListener("mousemove",w),i.removeEventListener("mouseleave",z),e.canvas.parentNode===i&&i.removeChild(e.canvas),e.getExtension("WEBGL_lose_context")?.loseContext();}},[t,o,n,s,a]),jsx("div",{ref:c,className:"w-full h-full"})}function V(t,o,n){let s,a,c;if(o===0)s=a=c=n;else {let g=(l,e,r)=>(r<0&&(r+=1),r>1&&(r-=1),r<.16666666666666666?l+(e-l)*6*r:r<.5?e:r<.6666666666666666?l+(e-l)*(.6666666666666666-r)*6:l),h=n<.5?n*(1+o):n+o-n*o,i=2*n-h;s=g(i,h,t+1/3),a=g(i,h,t),c=g(i,h,t-1/3);}return new Vec3(s,a,c)}function k(t){if(t==="transparent")return new Vec3(0,0,0);if(t.startsWith("#")){let s=parseInt(t.slice(1,3),16)/255,a=parseInt(t.slice(3,5),16)/255,c=parseInt(t.slice(5,7),16)/255;return new Vec3(s,a,c)}let o=t.match(/rgba?\((\d+),\s*(\d+),\s*(\d+)/);if(o)return new Vec3(parseInt(o[1])/255,parseInt(o[2])/255,parseInt(o[3])/255);let n=t.match(/hsla?\((\d+),\s*(\d+)%,\s*(\d+)%/);if(n){let s=parseInt(n[1])/360,a=parseInt(n[2])/100,c=parseInt(n[3])/100;return V(s,a,c)}return new Vec3(0,0,0)}export{X as a,J as b};

package/dist/index.d.mts

@@ -772,8 +772,12 @@ interface UseStandardReportOptions {
     fetchData?: (params: any) => Promise<any>;
     initialRowsPerPage?: number;
     rowsPerPageOptions?: number[];
+    tableKey?: string;
+    mode?: CStandardPageProps['mode'];
+    serviceUrl?: string;
+    variantService?: IVariantService;
 }
-declare const useStandardReport: ({ metadata, fetchData, initialRowsPerPage, rowsPerPageOptions, }: UseStandardReportOptions) => {
+declare const useStandardReport: ({ metadata, fetchData, initialRowsPerPage, rowsPerPageOptions, tableKey, mode, serviceUrl, variantService, }: UseStandardReportOptions) => {
     pageProps: CStandardPageProps;
     filters: Record<string, any>;
     rows: any[];
@@ -1196,6 +1200,12 @@ declare const en: {
     readonly 'pivot.agg.avg': "Average";
     readonly 'pivot.agg.min': "Min";
     readonly 'pivot.agg.max': "Max";
+    readonly 'pivot.preset.selectPlaceholder': "Select preset";
+    readonly 'pivot.preset.save': "Save preset";
+    readonly 'pivot.preset.delete': "Delete preset";
+    readonly 'pivot.preset.saveDialogTitle': "Save current preset";
+    readonly 'pivot.preset.nameLabel': "Preset name";
+    readonly 'pivot.preset.defaultName': "Preset {index}";
     readonly 'smartFilter.adaptFilters': "Adapt Filters";
     readonly 'smartFilter.addFilters': "Add Filters";
     readonly 'smartFilter.go': "Go";
@@ -1400,6 +1410,13 @@ interface PivotLayoutConfig {
     values?: PivotValueFieldConfig[];
 }
 type PivotFilterSelections = Record<string, string[]>;
+interface PivotTablePreset {
+    id: string;
+    name: string;
+    layout: PivotLayoutConfig;
+    filterSelections?: PivotFilterSelections;
+    showGrandTotal?: boolean;
+}
 interface PivotTableModel {
     rowFields: string[];
     setRowFields: React__default.Dispatch<React__default.SetStateAction<string[]>>;
@@ -1424,6 +1441,12 @@ interface CPivotTableProps {
     emptyText?: string;
     maxPreviewHeight?: number | string;
     model?: PivotTableModel;
+    enablePresetManagement?: boolean;
+    presets?: PivotTablePreset[];
+    defaultPresets?: PivotTablePreset[];
+    onPresetsChange?: (presets: PivotTablePreset[]) => void;
+    initialPresetId?: string;
+    onPresetApplied?: (preset: PivotTablePreset) => void;
 }
 
 declare const CPivotTable: React__default.FC<CPivotTableProps>;
@@ -1455,6 +1478,164 @@ interface UsePivotTableResult {
 }
 declare const usePivotTable: ({ fields, initialLayout, initialFilterSelections, initialShowGrandTotal, initialConfiguratorCollapsed, }: UsePivotTableOptions) => UsePivotTableResult;
 
+interface UseVoiceInputOptions {
+    onTextUpdate?: (text: string) => void;
+    onComplete: (text: string) => void | Promise<void>;
+    onError?: (error: string) => void;
+    wsUrl?: string;
+    silenceThresholdMs?: number;
+    minVolumeRms?: number;
+}
+interface UseVoiceInputResult {
+    isRecording: boolean;
+    startRecording: () => Promise<void>;
+    stopRecording: () => void;
+}
+interface CVoiceWaveOverlayProps {
+    isRecording: boolean;
+}
+interface CAINavProviderProps {
+    children: ReactNode;
+    onVoiceSubmit: (text: string) => void | Promise<void>;
+    onVoicePartial?: (text: string) => void;
+    onVoiceError?: (error: string) => void;
+    longPressMs?: number;
+    disableSpaceTrigger?: boolean;
+    ignoreWhenFocusedInput?: boolean;
+    renderOverlay?: boolean;
+    wsUrl?: string;
+    silenceThresholdMs?: number;
+    minVolumeRms?: number;
+}
+interface AINavContextValue {
+    isRecording: boolean;
+    isHotkeyRecording: boolean;
+    isSubmitting: boolean;
+    startRecording: () => Promise<void>;
+    stopRecording: () => void;
+}
+type VoiceNavigatorProviderProps = CAINavProviderProps;
+type VoiceNavigatorContextValue = AINavContextValue;
+type VoiceWaveOverlayProps = CVoiceWaveOverlayProps;
+
+declare function CAINavProvider({ children, onVoiceSubmit, onVoicePartial, onVoiceError, longPressMs, disableSpaceTrigger, ignoreWhenFocusedInput, renderOverlay, wsUrl, silenceThresholdMs, minVolumeRms }: CAINavProviderProps): react_jsx_runtime.JSX.Element;
+declare function useAINav(): AINavContextValue;
+declare const VoiceNavigatorProvider: typeof CAINavProvider;
+declare const useVoiceNavigator: typeof useAINav;
+
+declare function useVoiceInput({ onTextUpdate, onComplete, onError, wsUrl, silenceThresholdMs, minVolumeRms }: UseVoiceInputOptions): UseVoiceInputResult;
+
+declare function CVoiceWaveOverlay({ isRecording }: CVoiceWaveOverlayProps): react_jsx_runtime.JSX.Element;
+declare const VoiceWaveOverlay: typeof CVoiceWaveOverlay;
+
+interface COrbCanvasProps {
+    hue?: number;
+    hoverIntensity?: number;
+    rotateOnHover?: boolean;
+    forceHoverState?: boolean;
+    backgroundColor?: string;
+}
+declare function COrbCanvas({ hue, hoverIntensity, rotateOnHover, forceHoverState, backgroundColor }: COrbCanvasProps): react_jsx_runtime.JSX.Element;
+
+interface TableTypeContent {
+    type: 'table';
+    data: any;
+}
+interface ChartCardTypeContent {
+    type: 'bar-chart-card' | 'line-chart-card' | 'pie-chart-card' | 'combo-chart-card' | 'heatmap-chart-card' | 'fishbone-chart-card' | 'waterfall-chart-card' | 'google-map-card' | 'amap-card';
+    title: string;
+    subtitle?: string;
+    data: any[];
+    config?: any;
+}
+interface SAPCardTypeContent {
+    type: 'sap-analytical-card' | 'sap-list-card' | 'sap-object-card' | 'sap-component-card';
+    manifest: any;
+}
+interface AgentUICardTypeContent {
+    type: 'error-card' | 'warning-card' | 'suggestions-card' | 'tool-result-card';
+    [key: string]: any;
+}
+type ParsedCardData = TableTypeContent | ChartCardTypeContent | SAPCardTypeContent | AgentUICardTypeContent;
+type AgentUICardType = ParsedCardData['type'];
+type AgentUICardAction = 'render' | 'close' | 'retry' | 'confirm' | 'action' | 'suggestion-click';
+interface AgentUICardHookEvent {
+    messageId?: string;
+    cardType: AgentUICardType;
+    action: AgentUICardAction;
+    title?: string;
+    payload?: unknown;
+    rawData?: unknown;
+}
+interface AgentUICardHooks {
+    onCardEvent?: (event: AgentUICardHookEvent) => void;
+}
+
+interface AssistantActionContext {
+    isLatestAssistant: boolean;
+    onRegenerate?: () => Promise<void>;
+}
+interface ChatMessageProps {
+    message: ChatMessage;
+    onStreamingComplete?: () => void;
+    assistantActions?: AssistantActionContext;
+    streamIntervalMs?: number;
+    streamChunkSize?: number;
+    cardHooks?: AgentUICardHooks;
+}
+interface ChatMessage {
+    id: string;
+    type: 'user' | 'assistant';
+    content: string;
+    timestamp: Date;
+    isStreaming?: boolean;
+}
+declare const ChatMessage: React__default.FC<ChatMessageProps>;
+
+interface StdChatProps {
+    messages: ChatMessage[];
+    onSend: (content: string, files?: File[]) => Promise<void>;
+    onStop?: () => void;
+    onRegenerate?: (messageId: string) => Promise<void>;
+    isResponding?: boolean;
+    className?: string;
+    placeholder?: string;
+    streamIntervalMs?: number;
+    streamChunkSize?: number;
+    onMessageStreamingComplete?: (messageId: string) => void;
+    cardHooks?: AgentUICardHooks;
+}
+declare const StdChat: React__default.FC<StdChatProps>;
+
+interface AgentPanelProps extends StdChatProps {
+    title?: string;
+    description?: string;
+    headerActions?: React__default.ReactNode;
+}
+declare const AgentPanel: React__default.FC<AgentPanelProps>;
+
+type CopilotCorner = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+interface CopilotChatProps {
+    messages: ChatMessage[];
+    onSend: (content: string, files?: File[]) => Promise<void>;
+    onStop?: () => void;
+    onRegenerate?: (messageId: string) => Promise<void>;
+    isResponding?: boolean;
+    className?: string;
+    placeholder?: string;
+    title?: string;
+    corner?: CopilotCorner;
+    onCollapse?: () => void;
+    onHeaderPointerDown?: (e: React__default.PointerEvent<HTMLDivElement>) => void;
+    onPlusClick?: () => void;
+    onMicClick?: () => void;
+    streamIntervalMs?: number;
+    streamChunkSize?: number;
+    onMessageStreamingComplete?: (messageId: string) => void;
+    cardHooks?: AgentUICardHooks;
+}
+declare const CopilotChat: React__default.FC<CopilotChatProps>;
+
 interface MarkdownRendererProps {
     markdown?: string;
     content?: string;
@@ -1549,4 +1730,4 @@ declare const PAGE_TRANSITION_PRESETS: {
     };
 };
 
-export { type AmapEmbedOptions, Button, type ButtonProps, CAmapChart, type CAmapChartProps, CAppHeader, type CAppHeaderProps, type CAppHeaderUser, type CAppHeaderUserMenuItem, CAppPageLayout, type CAppPageLayoutProps, CBarChart, type CBarChartProps, CChartCard, type CChartCardProps, CComboChart, type CComboChartProps, CCustomizeAgent, type CCustomizeAgentProps, CDetailInfoPage, type CDetailInfoPageProps, CDetailSearchAiBar, type CDetailSearchAiBarProps, CDetailSectionCard, type CDetailSectionCardProps, CFishboneChart, type CFishboneChartProps, CGoogleMapChart, type CGoogleMapChartProps, CGraphCharts, CGraphKpiCards, CGraphReport, type CGraphReportProps, CHeatmapChart, type CHeatmapChartProps, CLayoutManagement, type CLayoutManagementProps, CLayoutManager, type CLayoutManagerProps, CLineChart, type CLineChartProps, CMessageBox, type CMessageBoxProps, type CMessageBoxType, CPageLayout, type CPageLayoutProps, CPageTransition, type CPageTransitionProps, CPieChart, type CPieChartProps, CPivotTable, type CPivotTableProps, CSmartFilter, type CSmartFilterProps, CSmartTable, CStandardPage, type CStandardPageProps, CTable, CTableBody, type CTableBodyProps, CTableCell, type CTableCellProps, CTableContainer, type CTableContainerProps, CTableHead, type CTableHeadProps, type CTableProps, type CTableQuickCreateConfig, type CTableQuickDeleteConfig, type CTableQuickEditConfig, CTableRow, type CTableRowProps, CVariantManagement, type CVariantManagementProps, CVariantManager, CWaterfallChart, type CWaterfallChartProps, CodeBlock, type CodeBlockProps, type CustomizeAgentSavePayload, type CustomizeAgentSettings, type CustomizeAgentTemplateOption, type DateOperator, type DetailInfoAiConfig, type DetailInfoField, type DetailInfoSearchHit, type DetailInfoSearchMode, type DetailInfoSection, type DetailInfoTab, type DetailInfoTableConfig, type FilterField, type FilterOperator, type FilterType, type FilterValue, GlobalMessage, type GoogleMapEmbedOptions, type GraphBarDatum, type GraphComboDatum, type GraphFishboneBranch, type GraphHeatmapDatum, type GraphLineDatum, type GraphMapLocation, type GraphPieDatum, type GraphReportConfig, type GraphReportFieldMapping, type GraphReportInteractionState, type GraphReportKpis, type GraphReportModel, type GraphRow, type GraphTableColumn, type GraphWaterfallDatum, type IVariantService, type LayoutMetadata, MarkdownRenderer, type MarkdownRendererProps, MathBlock, type MathBlockProps, MermaidBlock, type MermaidBlockProps, type MessageContent, type MessageEvent, type MessageOptions, NavigationIsland, type NavigationIslandProps, type NumberOperator, ORBCAFE_I18N_MESSAGES, type OrbcafeI18nContextValue, OrbcafeI18nProvider, type OrbcafeI18nProviderProps, type OrbcafeLocale, type OrbcafeLocaleMessages, type OrbcafeMessageKey, type OrbcafeMessageParams, PAGE_TRANSITION_PRESETS, type PageTransitionVariant, type ParsedMarkdownTable, type PivotAggregation, type PivotFieldDefinition, type PivotFieldType, type PivotFilterSelections, type PivotLayoutConfig, type PivotTableModel, type PivotValueFieldConfig, type PivotValueFieldState, type ReportColumn, type ReportFilter, type ReportMetadata, type SelectOperator, type TableAlign, TableBlock, type TableBlockProps, type TextOperator, ThinkBlock, type ThinkBlockProps, TreeMenu, type TreeMenuItem, type UseAmapEmbedUrlOptions, type UseDetailInfoOptions, type UseDetailInfoResult, type UseGoogleMapEmbedUrlOptions, type UseGraphChartDataOptions, type UseGraphChartDataResult, type UseGraphInteractionResult, type UseGraphReportOptions, type UseGraphReportResult, type UseNavigationIslandOptions, type UseNavigationIslandResult, type UsePageLayoutOptions, type UsePivotTableOptions, type UsePivotTableResult, type UseStandardReportOptions, type VariantMetadata, buildAmapEmbedUrl, buildGoogleMapEmbedUrl, buildGoogleMapIframe, buttonVariants, message, messageManager, parseMarkdownTable, renderMarkdown, resolveVariantFilters, resolveVariantLayout, useAmapEmbedUrl, useDetailInfo, useGoogleMapEmbedUrl, useGraphChartData, useGraphInteraction, useGraphReport, useNavigationIsland, useOrbcafeI18n, usePageLayout, usePivotTable, useStandardReport };
+export { type AINavContextValue, AgentPanel, type AgentPanelProps, type AgentUICardAction, type AgentUICardHookEvent, type AgentUICardHooks, type AgentUICardType, type AmapEmbedOptions, Button, type ButtonProps, CAINavProvider, type CAINavProviderProps, CAmapChart, type CAmapChartProps, CAppHeader, type CAppHeaderProps, type CAppHeaderUser, type CAppHeaderUserMenuItem, CAppPageLayout, type CAppPageLayoutProps, CBarChart, type CBarChartProps, CChartCard, type CChartCardProps, CComboChart, type CComboChartProps, CCustomizeAgent, type CCustomizeAgentProps, CDetailInfoPage, type CDetailInfoPageProps, CDetailSearchAiBar, type CDetailSearchAiBarProps, CDetailSectionCard, type CDetailSectionCardProps, CFishboneChart, type CFishboneChartProps, CGoogleMapChart, type CGoogleMapChartProps, CGraphCharts, CGraphKpiCards, CGraphReport, type CGraphReportProps, CHeatmapChart, type CHeatmapChartProps, CLayoutManagement, type CLayoutManagementProps, CLayoutManager, type CLayoutManagerProps, CLineChart, type CLineChartProps, CMessageBox, type CMessageBoxProps, type CMessageBoxType, COrbCanvas, type COrbCanvasProps, CPageLayout, type CPageLayoutProps, CPageTransition, type CPageTransitionProps, CPieChart, type CPieChartProps, CPivotTable, type CPivotTableProps, CSmartFilter, type CSmartFilterProps, CSmartTable, CStandardPage, type CStandardPageProps, CTable, CTableBody, type CTableBodyProps, CTableCell, type CTableCellProps, CTableContainer, type CTableContainerProps, CTableHead, type CTableHeadProps, type CTableProps, type CTableQuickCreateConfig, type CTableQuickDeleteConfig, type CTableQuickEditConfig, CTableRow, type CTableRowProps, CVariantManagement, type CVariantManagementProps, CVariantManager, CVoiceWaveOverlay, type CVoiceWaveOverlayProps, CWaterfallChart, type CWaterfallChartProps, ChatMessage, CodeBlock, type CodeBlockProps, CopilotChat, type CopilotChatProps, type CustomizeAgentSavePayload, type CustomizeAgentSettings, type CustomizeAgentTemplateOption, type DateOperator, type DetailInfoAiConfig, type DetailInfoField, type DetailInfoSearchHit, type DetailInfoSearchMode, type DetailInfoSection, type DetailInfoTab, type DetailInfoTableConfig, type FilterField, type FilterOperator, type FilterType, type FilterValue, GlobalMessage, type GoogleMapEmbedOptions, type GraphBarDatum, type GraphComboDatum, type GraphFishboneBranch, type GraphHeatmapDatum, type GraphLineDatum, type GraphMapLocation, type GraphPieDatum, type GraphReportConfig, type GraphReportFieldMapping, type GraphReportInteractionState, type GraphReportKpis, type GraphReportModel, type GraphRow, type GraphTableColumn, type GraphWaterfallDatum, type IVariantService, type LayoutMetadata, MarkdownRenderer, type MarkdownRendererProps, MathBlock, type MathBlockProps, MermaidBlock, type MermaidBlockProps, type MessageContent, type MessageEvent, type MessageOptions, NavigationIsland, type NavigationIslandProps, type NumberOperator, ORBCAFE_I18N_MESSAGES, type OrbcafeI18nContextValue, OrbcafeI18nProvider, type OrbcafeI18nProviderProps, type OrbcafeLocale, type OrbcafeLocaleMessages, type OrbcafeMessageKey, type OrbcafeMessageParams, PAGE_TRANSITION_PRESETS, type PageTransitionVariant, type ParsedMarkdownTable, type PivotAggregation, type PivotFieldDefinition, type PivotFieldType, type PivotFilterSelections, type PivotLayoutConfig, type PivotTableModel, type PivotTablePreset, type PivotValueFieldConfig, type PivotValueFieldState, type ReportColumn, type ReportFilter, type ReportMetadata, type SelectOperator, StdChat, type StdChatProps, type TableAlign, TableBlock, type TableBlockProps, type TextOperator, ThinkBlock, type ThinkBlockProps, TreeMenu, type TreeMenuItem, type UseAmapEmbedUrlOptions, type UseDetailInfoOptions, type UseDetailInfoResult, type UseGoogleMapEmbedUrlOptions, type UseGraphChartDataOptions, type UseGraphChartDataResult, type UseGraphInteractionResult, type UseGraphReportOptions, type UseGraphReportResult, type UseNavigationIslandOptions, type UseNavigationIslandResult, type UsePageLayoutOptions, type UsePivotTableOptions, type UsePivotTableResult, type UseStandardReportOptions, type UseVoiceInputOptions, type UseVoiceInputResult, type VariantMetadata, type VoiceNavigatorContextValue, VoiceNavigatorProvider, type VoiceNavigatorProviderProps, VoiceWaveOverlay, type VoiceWaveOverlayProps, buildAmapEmbedUrl, buildGoogleMapEmbedUrl, buildGoogleMapIframe, buttonVariants, message, messageManager, parseMarkdownTable, renderMarkdown, resolveVariantFilters, resolveVariantLayout, useAINav, useAmapEmbedUrl, useDetailInfo, useGoogleMapEmbedUrl, useGraphChartData, useGraphInteraction, useGraphReport, useNavigationIsland, useOrbcafeI18n, usePageLayout, usePivotTable, useStandardReport, useVoiceInput, useVoiceNavigator };