@aura-react-comp/x 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Aura Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,81 @@
-# Temporary Holding Version
+# @aura-react-comp/x
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Aura AI 组件库：对话式 AI 界面的原子组件与数据流 Hooks，对标 Ant Design X 的 Aura 实现。
+
+覆盖从「输入 → 流式接收 → 渲染 → 推理过程 → 消息操作 → 会话管理」的完整链路，
+并以 `XProvider` 与 Aura 生态共享同一套紫罗兰视觉语言。
+
+## 安装
+
+```bash
+pnpm add @aura-react-comp/x antd react react-dom
+```
+
+`antd`（>=6）、`react` / `react-dom`（>=18）为 peerDependencies，需由使用方提供。
+`mermaid`（>=10）为**可选** peerDependency，仅在使用 `Mermaid` 组件时才需要安装。
+
+## 样式引入（重要）
+
+```tsx
+import '@aura-react-comp/ui/style.css'; // Aura 基础设计令牌（--aura-*）
+import '@aura-react-comp/x/style.css'; // AI 组件样式
+```
+
+本包的 `.less` 直接使用 `var(--aura-*)` 且**不设 fallback**，基础令牌未加载时
+颜色、圆角、字号、间距会整体失效。基础令牌由 `@aura-react-comp/ui` 提供
+（已随本包依赖自动安装），因此需引入它的 `style.css` 一次。
+
+品牌相关变量（渐变 / 光晕 / 软底色，`--aura-x-*`）由 `XProvider` 在运行期
+从 `colorPrimary` 实时派生并注入子树作用域——**换主色即时全量生效**，无需重新构建样式。
+
+## 使用
+
+```tsx
+import { XProvider, Bubble, Sender, useXChat } from '@aura-react-comp/x';
+import '@aura-react-comp/ui/style.css';
+import '@aura-react-comp/x/style.css';
+
+const App = () => {
+  const { messages, onRequest } = useXChat({ request: callModel });
+
+  return (
+    <XProvider>
+      <Bubble.List items={messages} />
+      <Sender onSubmit={({ message }) => onRequest({ message })} />
+    </XProvider>
+  );
+};
+```
+
+建议在应用根节点包裹 `XProvider`，使 antd 主题与 Aura 品牌色（默认主色 `#7c3aed`）保持一致。
+
+## 组件总览（20 个导出）
+
+| 分组     | 组件                                | 说明                                                               |
+| -------- | ----------------------------------- | ------------------------------------------------------------------ |
+| 主题桥接 | `XProvider`                         | 将 Aura 设计令牌映射到 antd 主题系统，支持暗色 / 紧凑 / 自定义主色 |
+| 交互     | `Bubble` / `Bubble.List`            | 消息气泡，支持头像、加载态、变体与列表分组                         |
+| 交互     | `Sender`                            | 对话输入框，支持提交类型、加载态与自定义操作区                     |
+| 交互     | `Attachments`                       | 附件条，支持上传、预览与状态展示                                   |
+| 交互     | `FileCard`                          | 文件卡片，内置状态与文件大小 / 扩展名格式化                        |
+| 交互     | `Folder`                            | 文件树，支持预览、右键菜单与自定义目录图标                         |
+| 引导     | `Welcome`                           | 欢迎语，用于对话开始的引导区                                       |
+| 引导     | `Prompts`                           | 提示集，支持横向 / 纵向排布                                        |
+| 引导     | `Suggestion`                        | 建议项，用于输入框上方的快捷提问                                   |
+| 推理     | `Think`                             | 单段思考过程展示                                                   |
+| 推理     | `ThoughtChain`                      | 多步思维链，支持状态与嵌套内容                                     |
+| 反馈     | `Actions`                           | 消息操作组（复制 / 重试 / 点赞等）                                 |
+| 反馈     | `MarkdownContent`                   | Markdown 安全渲染，围栏代码块默认接入语法高亮                      |
+| 反馈     | `Sources`                           | 来源引用与跳转                                                     |
+| 反馈     | `CodeHighlighter`                   | 代码高亮，配色走 `var(--aura-*)` 以自动跟随亮暗主题                |
+| 反馈     | `Mermaid`                           | Mermaid 图表渲染（`mermaid` 为可选依赖，按需动态加载）             |
+| 会话     | `Conversations`                     | 会话列表管理，支持分组与菜单                                       |
+| 数据     | `useXStream`                        | SSE / 流式响应解析                                                 |
+| 数据     | `useXChat`                          | 对话数据流管理，支持多会话与请求中止                               |
+| 数据     | `XNotification` / `useNotification` | 系统级通知与权限管控                                               |
+
+完整 API 与在线示例见文档站「AI 组件」。
+
+## 许可证
+
+MIT

package/esm/actions/index.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+export interface ActionItem {
+    key: React.Key;
+    icon?: React.ReactNode;
+    label?: React.ReactNode;
+    /** 危险操作（红色态） */
+    danger?: boolean;
+    disabled?: boolean;
+    /** 切换态（如点赞 / 收藏） */
+    active?: boolean;
+    onClick?: () => void;
+}
+export interface ActionsProps {
+    items: ActionItem[];
+    direction?: 'horizontal' | 'vertical';
+    /** 可访问名称（role=toolbar 时读屏依赖它） */
+    ariaLabel?: string;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * Actions — 消息操作组。
+ *
+ * 常放在 [`Bubble`](/x-components/bubble) 的 `footer`：复制、重新生成、点赞、
+ * 切换收藏等。语义为工具栏（role=toolbar），按钮从 `label` / `icon`
+ * 生成可访问名称。
+ */
+export declare const Actions: React.FC<ActionsProps>;

package/esm/actions/index.js

@@ -0,0 +1,37 @@
+import React from 'react';
+import { classNames, prefixCls } from '@aura-react-comp/shared';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Actions — 消息操作组。
+ *
+ * 常放在 [`Bubble`](/x-components/bubble) 的 `footer`：复制、重新生成、点赞、
+ * 切换收藏等。语义为工具栏（role=toolbar），按钮从 `label` / `icon`
+ * 生成可访问名称。
+ */
+export const Actions = ({
+  items,
+  direction = 'horizontal',
+  ariaLabel = '操作',
+  className,
+  style
+}) => /*#__PURE__*/_jsx("div", {
+  role: "toolbar",
+  "aria-label": ariaLabel,
+  "aria-orientation": direction,
+  className: classNames(prefixCls('x-actions'), prefixCls(`x-actions--${direction}`), className),
+  style: style,
+  children: items.map(item => /*#__PURE__*/_jsxs("button", {
+    type: "button",
+    className: classNames(prefixCls('x-actions-item'), item.danger && prefixCls('x-actions-item--danger'), item.active && prefixCls('x-actions-item--active')),
+    disabled: item.disabled,
+    "aria-label": typeof item.label === 'string' ? item.label : undefined,
+    title: typeof item.label === 'string' ? item.label : undefined,
+    onClick: item.onClick,
+    children: [item.icon, item.label ? /*#__PURE__*/_jsx("span", {
+      className: prefixCls('x-actions-item-label'),
+      children: item.label
+    }) : null]
+  }, item.key))
+});
+Actions.displayName = 'Actions';

package/esm/actions/index.less

@@ -0,0 +1,59 @@
+/* Actions — 消息操作组 */
+
+.aura-x-actions {
+  display: flex;
+  gap: var(--aura-spacing-1);
+  align-items: center;
+}
+
+.aura-x-actions--vertical {
+  flex-direction: column;
+  align-items: stretch;
+}
+
+.aura-x-actions-item {
+  display: inline-flex;
+  gap: var(--aura-spacing-1);
+  align-items: center;
+  justify-content: center;
+  padding: var(--aura-spacing-1) var(--aura-spacing-2);
+  border: none;
+  border-radius: var(--aura-radius-sm);
+  background: transparent;
+  color: var(--aura-text-secondary);
+  font-size: var(--aura-font-size-xs);
+  line-height: 1.5;
+  cursor: pointer;
+  transition:
+    background var(--aura-duration-fast) var(--aura-easing),
+    color var(--aura-duration-fast) var(--aura-easing);
+}
+
+.aura-x-actions-item:not(:disabled):hover {
+  background: var(--aura-x-accent-soft);
+  color: var(--aura-x-accent);
+}
+
+.aura-x-actions-item:focus-visible {
+  outline: none;
+  box-shadow: var(--aura-x-focus-ring);
+}
+
+.aura-x-actions-item--active {
+  color: var(--aura-x-accent);
+  background: var(--aura-x-accent-soft);
+}
+
+.aura-x-actions-item--danger:not(:disabled):hover {
+  background: rgba(239, 68, 68, 0.12);
+  color: var(--aura-error);
+}
+
+.aura-x-actions-item:disabled {
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+
+.aura-x-actions--vertical .aura-x-actions-item {
+  justify-content: flex-start;
+}

package/esm/attachments/index.d.ts

@@ -0,0 +1,41 @@
+import React from 'react';
+import type { FileCardStatus } from '../file-card';
+export interface AttachmentItem {
+    /** 唯一键（同时作为 React key） */
+    id: React.Key;
+    name: string;
+    /** 字节数 */
+    size?: number;
+    status?: FileCardStatus;
+    /** `status="uploading"` 时的进度（0–100） */
+    percent?: number;
+    description?: React.ReactNode;
+    /** 失败原因 */
+    errorTip?: React.ReactNode;
+    /** 原始 File 对象，随 onRemove 回调透传 */
+    file?: File;
+}
+export interface AttachmentsProps {
+    items: AttachmentItem[];
+    /** 移除回调：回传被移除的项与其索引 */
+    onRemove?: (item: AttachmentItem, index: number) => void;
+    /**
+     * 溢出模式：
+     * - `wrap`：换行排列（默认）
+     * - `scrollX`：单行横向滚动，超出容器宽度可滑动
+     * @default 'wrap'
+     */
+    overflow?: 'wrap' | 'scrollX';
+    /** 空列表占位；缺省渲染 null */
+    empty?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * Attachments — 附件列表。
+ *
+ * 输入框（`Sender` 的 `header` 插槽）上方的附件条：把待发送的文件
+ * 以 [`FileCard`](/x-components/file-card) 形态横向排布，支持移除与
+ * 上传进度。语义为 `role="list"`，每张卡片是一个 `listitem`。
+ */
+export declare const Attachments: React.FC<AttachmentsProps>;

package/esm/attachments/index.js

@@ -0,0 +1,48 @@
+import React from 'react';
+import { classNames, prefixCls } from '@aura-react-comp/shared';
+import { FileCard } from "../file-card";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Attachments — 附件列表。
+ *
+ * 输入框（`Sender` 的 `header` 插槽）上方的附件条：把待发送的文件
+ * 以 [`FileCard`](/x-components/file-card) 形态横向排布，支持移除与
+ * 上传进度。语义为 `role="list"`，每张卡片是一个 `listitem`。
+ */
+export const Attachments = ({
+  items,
+  onRemove,
+  overflow = 'wrap',
+  empty,
+  className,
+  style
+}) => {
+  if (items.length === 0) {
+    if (!empty) return null;
+    return /*#__PURE__*/_jsx("div", {
+      className: classNames(prefixCls('x-attachments'), prefixCls('x-attachments--empty'), className),
+      style: style,
+      children: empty
+    });
+  }
+  return /*#__PURE__*/_jsx("div", {
+    role: "list",
+    "aria-label": "\u9644\u4EF6\u5217\u8868",
+    className: classNames(prefixCls('x-attachments'), overflow === 'scrollX' && prefixCls('x-attachments--scroll-x'), className),
+    style: style,
+    children: items.map((item, index) => /*#__PURE__*/_jsx("div", {
+      role: "listitem",
+      className: prefixCls('x-attachments-item'),
+      children: /*#__PURE__*/_jsx(FileCard, {
+        name: item.name,
+        size: item.size,
+        status: item.status,
+        percent: item.percent,
+        description: item.description,
+        errorTip: item.errorTip,
+        onRemove: onRemove ? () => onRemove(item, index) : undefined
+      })
+    }, item.id))
+  });
+};
+Attachments.displayName = 'Attachments';

package/esm/attachments/index.less

@@ -0,0 +1,22 @@
+/* Attachments — 附件列表（输入框上方的附件条） */
+
+.aura-x-attachments {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--aura-spacing-2);
+  align-items: stretch;
+}
+
+.aura-x-attachments--scroll-x {
+  flex-wrap: nowrap;
+  padding-bottom: var(--aura-spacing-1);
+  overflow-x: auto;
+  /* 横滑条与卡片间距，避免遮挡最后一张卡片 */
+  scrollbar-width: thin;
+}
+
+.aura-x-attachments--empty {
+  color: var(--aura-text-tertiary);
+  font-size: var(--aura-font-size-xs);
+  line-height: 1.5;
+}

package/esm/bubble/index.d.ts

@@ -0,0 +1,42 @@
+import React from 'react';
+export interface BubbleProps {
+    /** 消息角色：user 渲染在右侧，assistant / system 渲染在左侧 */
+    role?: 'user' | 'assistant' | 'system';
+    /** 消息内容（纯文本）；需要 Markdown 时传 contentRender */
+    content?: string;
+    /** 自定义内容渲染扩展点（如传 MarkdownContent） */
+    contentRender?: (content: string) => React.ReactNode;
+    /** 头像（放任意节点，如 @aura-react-comp/ui 的 Avatar） */
+    avatar?: React.ReactNode;
+    /** 气泡上方的说明区（如消息来源、时间） */
+    header?: React.ReactNode;
+    /** 气泡下方的操作区（如复制 / 重新生成按钮） */
+    footer?: React.ReactNode;
+    /** 生成中：内容区显示三点打字动画，aria-busy 标记 */
+    loading?: boolean;
+    /** 视觉变体 */
+    variant?: 'filled' | 'outlined' | 'shadow';
+    className?: string;
+    style?: React.CSSProperties;
+}
+export declare const BubbleBase: React.FC<BubbleProps>;
+export interface BubbleListItem extends BubbleProps {
+    /** 列表内唯一键 */
+    key: React.Key;
+}
+export interface BubbleListProps {
+    items: BubbleListItem[];
+    /**
+     * items 变化时自动滚动到底部（打字机场景）。
+     * 容器高度由使用方控制（如 style={{ maxHeight: 320 }}），超出部分内部滚动。
+     * @default true
+     */
+    autoScroll?: boolean;
+    className?: string;
+    style?: React.CSSProperties;
+}
+export declare const BubbleList: React.FC<BubbleListProps>;
+/** Bubble（含 Bubble.List 复合导出，与 antd X 的用法对齐） */
+export declare const Bubble: React.FC<BubbleProps> & {
+    List: typeof BubbleList;
+};

package/esm/bubble/index.js

@@ -0,0 +1,80 @@
+import React, { useEffect, useRef } from 'react';
+import { classNames, prefixCls } from '@aura-react-comp/shared';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+export const BubbleBase = ({
+  role = 'assistant',
+  content = '',
+  contentRender,
+  avatar,
+  header,
+  footer,
+  loading = false,
+  variant = 'filled',
+  className,
+  style
+}) => {
+  // user 在右（end），assistant / system 在左（start）
+  const placement = role === 'user' ? 'end' : 'start';
+  const rootClass = classNames(prefixCls('x-bubble'), prefixCls(`x-bubble--${placement}`), prefixCls(`x-bubble--${variant}`), className);
+  return /*#__PURE__*/_jsxs("div", {
+    className: rootClass,
+    "data-role": role,
+    style: style,
+    "aria-busy": loading || undefined,
+    children: [avatar ? /*#__PURE__*/_jsx("div", {
+      className: prefixCls('x-bubble-avatar'),
+      children: avatar
+    }) : null, /*#__PURE__*/_jsxs("div", {
+      className: prefixCls('x-bubble-main'),
+      children: [header ? /*#__PURE__*/_jsx("div", {
+        className: prefixCls('x-bubble-header'),
+        children: header
+      }) : null, /*#__PURE__*/_jsx("div", {
+        className: classNames(prefixCls('x-bubble-content'), loading && prefixCls('x-bubble-content-loading')),
+        children: loading ? /*#__PURE__*/_jsxs("span", {
+          className: prefixCls('x-bubble-dots'),
+          "aria-hidden": "true",
+          children: [/*#__PURE__*/_jsx("i", {}), /*#__PURE__*/_jsx("i", {}), /*#__PURE__*/_jsx("i", {})]
+        }) : contentRender ? contentRender(content) : /*#__PURE__*/_jsx("span", {
+          className: prefixCls('x-bubble-text'),
+          children: content
+        })
+      }), footer ? /*#__PURE__*/_jsx("div", {
+        className: prefixCls('x-bubble-footer'),
+        children: footer
+      }) : null]
+    })]
+  });
+};
+BubbleBase.displayName = 'Bubble';
+export const BubbleList = ({
+  items,
+  autoScroll = true,
+  className,
+  style
+}) => {
+  const listRef = useRef(null);
+  useEffect(() => {
+    if (!autoScroll) return;
+    const el = listRef.current;
+    if (el) el.scrollTop = el.scrollHeight;
+  }, [items, autoScroll]);
+  return /*#__PURE__*/_jsx("div", {
+    ref: listRef,
+    className: classNames(prefixCls('x-bubble-list'), className),
+    style: style,
+    children: items.map(({
+      key,
+      ...rest
+    }) => /*#__PURE__*/_jsx(BubbleBase, {
+      ...rest
+    }, key))
+  });
+};
+BubbleList.displayName = 'BubbleList';
+
+/** Bubble（含 Bubble.List 复合导出，与 antd X 的用法对齐） */
+export const Bubble = Object.assign(BubbleBase, {
+  List: BubbleList
+});

package/esm/bubble/index.less

@@ -0,0 +1,164 @@
+/* Bubble — AI 对话气泡（玻璃拟态 + 品牌渐变） */
+
+.aura-x-bubble {
+  display: flex;
+  gap: var(--aura-spacing-3);
+  align-items: flex-start;
+  animation: aura-x-bubble-in var(--aura-duration-normal) var(--aura-easing);
+}
+
+@keyframes aura-x-bubble-in {
+  from {
+    opacity: 0;
+    transform: translateY(6px);
+  }
+
+  to {
+    opacity: 1;
+    transform: none;
+  }
+}
+
+/* 用户消息在右侧 */
+.aura-x-bubble--end {
+  flex-direction: row-reverse;
+}
+
+.aura-x-bubble-avatar {
+  flex-shrink: 0;
+  display: grid;
+  place-items: center;
+  width: 36px;
+  height: 36px;
+  border-radius: var(--aura-radius-full);
+  overflow: hidden;
+  border: 1px solid var(--aura-x-bubble-border);
+  background: var(--aura-x-stage-bg);
+}
+
+.aura-x-bubble-main {
+  display: flex;
+  flex-direction: column;
+  gap: var(--aura-spacing-1);
+  min-width: 0;
+  max-width: 100%;
+}
+
+.aura-x-bubble--end .aura-x-bubble-main {
+  align-items: flex-end;
+}
+
+.aura-x-bubble-header,
+.aura-x-bubble-footer {
+  font-size: var(--aura-font-size-xs);
+  color: var(--aura-text-tertiary);
+  padding: 0 var(--aura-spacing-1);
+}
+
+.aura-x-bubble-content {
+  padding: var(--aura-spacing-3) var(--aura-spacing-4);
+  border-radius: var(--aura-radius-lg);
+  font-size: var(--aura-font-size-md);
+  line-height: 1.65;
+  word-break: break-word;
+  white-space: pre-wrap;
+  transition:
+    background var(--aura-duration-normal) var(--aura-easing),
+    box-shadow var(--aura-duration-normal) var(--aura-easing);
+}
+
+/* 气泡尖角朝向说话者（现代聊天形态） */
+.aura-x-bubble--start .aura-x-bubble-content {
+  border-top-left-radius: var(--aura-radius-sm);
+}
+
+.aura-x-bubble--end .aura-x-bubble-content {
+  border-top-right-radius: var(--aura-radius-sm);
+}
+
+/* AI：玻璃拟态 */
+.aura-x-bubble--start.aura-x-bubble--filled .aura-x-bubble-content {
+  background: var(--aura-x-bubble-ai-bg);
+  border: 1px solid var(--aura-x-bubble-border);
+  backdrop-filter: var(--aura-x-glass-blur);
+  -webkit-backdrop-filter: var(--aura-x-glass-blur);
+}
+
+/* 用户：品牌渐变 + 光晕投影 */
+.aura-x-bubble--end.aura-x-bubble--filled .aura-x-bubble-content {
+  background: var(--aura-x-bubble-user-bg);
+  color: var(--aura-x-bubble-user-text);
+  box-shadow: 0 6px 18px -6px rgba(124, 58, 237, 0.55);
+}
+
+/* outlined：细边框玻璃 */
+.aura-x-bubble--outlined .aura-x-bubble-content {
+  background: var(--aura-x-bubble-ai-bg);
+  border: 1px solid var(--aura-x-bubble-border);
+}
+
+/* shadow：玻璃 + 光晕 */
+.aura-x-bubble--shadow .aura-x-bubble-content {
+  background: var(--aura-x-bubble-ai-bg);
+  backdrop-filter: var(--aura-x-glass-blur);
+  -webkit-backdrop-filter: var(--aura-x-glass-blur);
+  box-shadow: var(--aura-x-glow);
+}
+
+/* 生成中：品牌色光点 */
+.aura-x-bubble-dots {
+  display: inline-flex;
+  gap: 4px;
+  align-items: center;
+}
+
+.aura-x-bubble-dots i {
+  width: 6px;
+  height: 6px;
+  border-radius: var(--aura-radius-full);
+  background: var(--aura-x-accent);
+  opacity: 0.35;
+  animation: aura-x-bubble-blink 1.2s infinite ease-in-out;
+}
+
+.aura-x-bubble-dots i:nth-child(2) {
+  animation-delay: 0.2s;
+}
+
+.aura-x-bubble-dots i:nth-child(3) {
+  animation-delay: 0.4s;
+}
+
+@keyframes aura-x-bubble-blink {
+  0%,
+  80%,
+  100% {
+    opacity: 0.2;
+    transform: scale(0.85);
+  }
+
+  40% {
+    opacity: 1;
+    transform: scale(1);
+  }
+}
+
+/* 无障碍：偏好减少动效时关闭入场与打点动画 */
+@media (prefers-reduced-motion: reduce) {
+  .aura-x-bubble {
+    animation: none;
+  }
+
+  .aura-x-bubble-dots i {
+    animation: none;
+    opacity: 0.6;
+  }
+}
+
+/* 列表 */
+.aura-x-bubble-list {
+  display: flex;
+  flex-direction: column;
+  gap: var(--aura-spacing-4);
+  overflow-y: auto;
+}

package/esm/code-highlighter/index.d.ts

@@ -0,0 +1,39 @@
+import React from 'react';
+export interface CodeHighlighterProps {
+    /**
+     * 代码语言。prism-react-renderer 内置语言（js / ts / tsx / jsx / json /
+     * bash / css / html / python / go / sql / yaml 等）会着色；
+     * 未内置的语言安全回退为纯文本，不会报错。
+     * @default 'text'
+     */
+    lang?: string;
+    /** 代码内容 */
+    children?: string;
+    /**
+     * 头部内容：
+     * - 不传：渲染默认头部（语言名 + 复制按钮）
+     * - `false`：不渲染头部
+     * - 函数：`({ lang, code }) => ReactNode | false`，返回 `false` 同样不渲染
+     */
+    header?: React.ReactNode | ((info: {
+        lang: string;
+        code: string;
+    }) => React.ReactNode | false) | false;
+    /** 复制成功后的提示文案 @default '已复制' */
+    copiedText?: string;
+    /** 复制成功回调 */
+    onCopy?: (code: string) => void;
+    className?: string;
+    style?: React.CSSProperties;
+}
+export interface CodeHighlighterRef {
+    /** 根节点 DOM */
+    nativeElement: HTMLDivElement | null;
+}
+/**
+ * CodeHighlighter — 代码高亮。
+ *
+ * 基于 `prism-react-renderer`：等宽字体 + 语法着色 + 头部语言标识与一键复制。
+ * 配色走 `var(--aura-*)` 令牌，亮暗主题自动跟随，无需传入主题对象。
+ */
+export declare const CodeHighlighter: React.ForwardRefExoticComponent<CodeHighlighterProps & React.RefAttributes<CodeHighlighterRef>>;