@apform-ui/core 1.6.1 → 1.7.1

package/dist/composables/useClipboard.d.ts

@@ -0,0 +1,20 @@
+/**
+ * useClipboard — 文本剪贴板 composable
+ *
+ * 优先 navigator.clipboard，降级 execCommand('copy')。
+ * 反馈可选；默认不强制 ElMessage，由宿主决定。
+ */
+export interface UseClipboardOptions {
+    /** 成功回调 */
+    onSuccess?: (text: string) => void;
+    /** 失败回调 */
+    onError?: (error: unknown) => void;
+}
+/**
+ * 创建剪贴板工具
+ * @param options 可选回调
+ */
+export declare function useClipboard(options?: UseClipboardOptions): {
+    copy: (text: string) => Promise<boolean>;
+    read: () => Promise<string | null>;
+};

package/dist/docs/index.d.ts

@@ -0,0 +1,55 @@
+import { ComponentDoc } from './types';
+/**
+ * 组件文档元数据聚合出口
+ * playground 通过 `@apform-ui/core/docs` 消费
+ */
+export type { ComponentDoc, PropDoc, EmitDoc, SlotDoc } from './types';
+export { AppDialogDoc } from '../components/AppDialog/doc';
+export { AppIconDoc } from '../components/AppIcon/doc';
+export { AppPaginationDoc } from '../components/AppPagination/doc';
+export { BreadcrumbNavDoc } from '../components/BreadcrumbNav/doc';
+export { CardGridSkeletonDoc } from '../components/CardGridSkeleton/doc';
+export { CardTableDoc } from '../components/CardTable/doc';
+export { ApprovalCardDoc } from '../components/Chat/ApprovalCard/doc';
+export { AssistantPickerDoc } from '../components/Chat/AssistantPicker/doc';
+export { ComposerDoc } from '../components/Chat/Composer/doc';
+export { ConversationHeaderDoc } from '../components/Chat/ConversationHeader/doc';
+export { MessageBubbleDoc } from '../components/Chat/MessageBubble/doc';
+export { MessageListDoc } from '../components/Chat/MessageList/doc';
+export { ModelPickerDoc } from '../components/Chat/ModelPicker/doc';
+export { ProcessingDrawerDoc } from '../components/Chat/ProcessingDrawer/doc';
+export { RunStatusBarDoc } from '../components/Chat/RunStatusBar/doc';
+export { SessionSidebarDoc } from '../components/Chat/SessionSidebar/doc';
+export { AttachmentPreviewModalDoc } from '../components/Chat/message/AttachmentPreviewModal.doc';
+export { DocumentSummaryListDoc } from '../components/Chat/message/DocumentSummaryList.doc';
+export { MessageAttachmentListDoc } from '../components/Chat/message/MessageAttachmentList.doc';
+export { MessagePartsDoc } from '../components/Chat/message/MessageParts.doc';
+export { ConfirmDialogDoc } from '../components/ConfirmDialog/doc';
+export { ContentPanelDoc } from '../components/ContentPanel/doc';
+export { DocumentPreviewDrawerDoc } from '../components/DocumentPreview/DocumentPreviewDrawer.doc';
+export { DocumentPreviewPanelDoc } from '../components/DocumentPreview/DocumentPreviewPanel.doc';
+export { EmptyStateDoc } from '../components/EmptyState/doc';
+export { ErrorBoundaryDoc } from '../components/ErrorBoundary/doc';
+export { ExcelPreviewCardDoc } from '../components/ExcelPreviewCard/doc';
+export { FieldRowDoc } from '../components/FieldRow/doc';
+export { FilterBarDoc } from '../components/FilterBar/doc';
+export { FilterTabsDoc } from '../components/FilterTabs/doc';
+export { FormDialogDoc } from '../components/FormDialog/doc';
+export { HintTextDoc } from '../components/HintText/doc';
+export { JsonCardDoc } from '../components/JsonCard/doc';
+export { JsonDetailDialogDoc } from '../components/JsonDetailDialog/doc';
+export { LoadingDotsDoc } from '../components/LoadingDots/doc';
+export { PageHeaderDoc } from '../components/PageHeader/doc';
+export { PageShellDoc } from '../components/PageShell/doc';
+export { PdfPreviewCardDoc } from '../components/PdfPreviewCard/doc';
+export { SchemaLitePreviewDoc } from '../components/SchemaLitePreview/doc';
+export { SearchFormDoc } from '../components/SearchForm/doc';
+export { SectionToggleDoc } from '../components/SectionToggle/doc';
+export { SkeletonDoc } from '../components/Skeleton/doc';
+export { StatusTagDoc } from '../components/StatusTag/doc';
+export { TableRowActionsDoc } from '../components/TableRowActions/doc';
+export { ToastDoc } from '../components/Toast/doc';
+export { TruncatedTooltipTextDoc } from '../components/TruncatedTooltipText/doc';
+export { UserAvatarDoc } from '../components/UserAvatar/doc';
+/** 按组件名索引的文档表 */
+export declare const componentDocs: Record<string, ComponentDoc>;

package/dist/docs/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 组件文档元数据类型 — playground 文档站消费
+ */
+/** Props 文档行 */
+export interface PropDoc {
+    /** 属性名 */
+    name: string;
+    /** 类型说明 */
+    type: string;
+    /** 默认值（展示用字符串） */
+    default?: string;
+    /** 是否必填 */
+    required?: boolean;
+    /** 说明 */
+    description: string;
+}
+/** Emits / Events 文档行 */
+export interface EmitDoc {
+    /** 事件名 */
+    name: string;
+    /** 载荷类型说明 */
+    payload?: string;
+    /** 说明 */
+    description: string;
+}
+/** Slot 文档行 */
+export interface SlotDoc {
+    /** 插槽名 */
+    name: string;
+    /** 说明 */
+    description: string;
+}
+/** 单个组件/组合式 API 的文档描述 */
+export interface ComponentDoc {
+    /** 导出名称（英文） */
+    name: string;
+    /** 中文名，展示为「Name 中文」 */
+    titleZh?: string;
+    /** 一句话简述 */
+    description: string;
+    /** Props / Attributes */
+    props?: PropDoc[];
+    /** Emits / Events */
+    emits?: EmitDoc[];
+    /** Slots */
+    slots?: SlotDoc[];
+}

package/dist/index.d.ts

@@ -20,6 +20,10 @@ export type { StatusConfig } from './components/StatusTag';
 export { Skeleton } from './components/Skeleton';
 export { CardGridSkeleton } from './components/CardGridSkeleton';
 export { UserAvatar } from './components/UserAvatar';
+export { AppUserPanel } from './components/AppUserPanel';
+export type { AppUserPanelUser } from './components/AppUserPanel';
+export { SliderCaptcha } from './components/SliderCaptcha';
+export type { CaptchaPayload, SliderCaptchaValue } from './components/SliderCaptcha';
 export { PageShell } from './components/PageShell';
 export { PageHeader } from './components/PageHeader';
 export { BreadcrumbNav } from './components/BreadcrumbNav';
@@ -68,6 +72,8 @@ export { useDataLoading } from './composables';
 export type { UseDataLoadingOptions, UseDataLoadingReturn } from './composables';
 export { useChatScroll } from './composables';
 export type { UseChatScrollOptions, UseChatScrollReturn } from './composables';
+export { useClipboard } from './composables';
+export type { UseClipboardOptions } from './composables';
 export { ICON_MAP, APP_ICON_NAMES, isRegisteredAppIcon } from './utils';
 export type { AppIconName } from './utils';
 export { DEFAULT_PAGE_SIZE, PAGE_SIZE_OPTIONS, PAGINATION_LAYOUT } from './utils';
@@ -78,6 +84,6 @@ export { renderMarkdown, splitTextAndCodeBlocks } from './utils/textParser';
 export type { TextPart } from './utils/textParser';
 export { isImage, isPdf, isOffice, isPreviewable, fileKind, formatSize } from './utils/attachmentKind';
 export { COLORS, TEXT_COLORS, SPACING, BORDER_RADIUS, SHADOWS, DURATION, Z_INDEX, FONT_SIZE, CONTROL_HEIGHT, LAYOUT_HEIGHT, ICON_SIZE, PAGE, FORM, AVATAR_SIZE, } from './tokens';
-export declare const SCHEMA_UI_VERSION = "1.6.1";
+export declare const SCHEMA_UI_VERSION = "1.7.0";
 export declare const EP_FORK_BASE = "2.14.2";
 export declare const EP_FORK_DATE = "2026-08-27";

package/dist/types/chat.d.ts

@@ -41,6 +41,8 @@ export interface MessageDocumentSummary {
     filename: string;
     summary: string;
     pageCount?: number;
+    /** 关联附件 id（优先于 filename 匹配） */
+    attachmentId?: string;
 }
 export interface WorkflowExecution {
     executionId: string;

package/dist/utils/optionalPeers.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 可选 peer 动态加载（pdfjs-dist / xlsx）
+ *
+ * 宿主未安装时返回 null，组件回退到 iframe / props 壳。
+ * 类型刻意放宽：兼容 pdfjs 多主版本。
+ */
+/** 宽松 pdfjs 模块 */
+export type PdfjsModule = {
+    GlobalWorkerOptions: {
+        workerSrc: string;
+    };
+    getDocument: (src: unknown) => {
+        promise: Promise<any>;
+    };
+};
+/** 宽松 xlsx 模块 */
+export type XlsxModule = {
+    read: (data: ArrayBuffer, opts: {
+        type: 'array';
+    }) => {
+        SheetNames: string[];
+        Sheets: Record<string, unknown>;
+    };
+    utils: {
+        sheet_to_json: <T>(sheet: unknown, opts: {
+            header: number;
+            defval: string;
+        }) => T[];
+    };
+};
+/**
+ * 尝试加载 pdfjs-dist
+ */
+export declare function tryLoadPdfjs(): Promise<PdfjsModule | null>;
+/**
+ * 尝试加载 xlsx
+ */
+export declare function tryLoadXlsx(): Promise<XlsxModule | null>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apform-ui/core",
-  "version": "1.6.1",
+  "version": "1.7.1",
   "type": "module",
   "author": "yangdongnan",
   "license": "MIT",
@@ -39,12 +39,14 @@
     "./styles/element-override.css": "./styles/element-override.css",
     "./styles/fg-theme.css": "./styles/fg-theme.css",
     "./theme/*": "./src/theme/*",
-    "./styles/*": "./styles/*"
+    "./styles/*": "./styles/*",
+    "./docs": "./src/docs/index.ts"
   },
   "files": [
     "dist",
     "src/tokens",
     "src/theme",
+    "src/docs",
     "styles",
     "README.md"
   ],
@@ -60,7 +62,17 @@
   },
   "peerDependencies": {
     "element-plus": "2.14.2",
-    "vue": "^3.5.0"
+    "pdfjs-dist": ">=4.0.0",
+    "vue": "^3.5.0",
+    "xlsx": ">=0.18.0"
+  },
+  "peerDependenciesMeta": {
+    "pdfjs-dist": {
+      "optional": true
+    },
+    "xlsx": {
+      "optional": true
+    }
   },
   "dependencies": {
     "@element-plus/icons-vue": "^2.3.2",

package/src/docs/index.ts

@@ -0,0 +1,153 @@
+/**
+ * 组件文档元数据聚合出口
+ * playground 通过 `@apform-ui/core/docs` 消费
+ */
+export type { ComponentDoc, PropDoc, EmitDoc, SlotDoc } from './types'
+
+export { AppDialogDoc } from '../components/AppDialog/doc'
+export { AppIconDoc } from '../components/AppIcon/doc'
+export { AppPaginationDoc } from '../components/AppPagination/doc'
+export { BreadcrumbNavDoc } from '../components/BreadcrumbNav/doc'
+export { CardGridSkeletonDoc } from '../components/CardGridSkeleton/doc'
+export { CardTableDoc } from '../components/CardTable/doc'
+export { ApprovalCardDoc } from '../components/Chat/ApprovalCard/doc'
+export { AssistantPickerDoc } from '../components/Chat/AssistantPicker/doc'
+export { ComposerDoc } from '../components/Chat/Composer/doc'
+export { ConversationHeaderDoc } from '../components/Chat/ConversationHeader/doc'
+export { MessageBubbleDoc } from '../components/Chat/MessageBubble/doc'
+export { MessageListDoc } from '../components/Chat/MessageList/doc'
+export { ModelPickerDoc } from '../components/Chat/ModelPicker/doc'
+export { ProcessingDrawerDoc } from '../components/Chat/ProcessingDrawer/doc'
+export { RunStatusBarDoc } from '../components/Chat/RunStatusBar/doc'
+export { SessionSidebarDoc } from '../components/Chat/SessionSidebar/doc'
+export { AttachmentPreviewModalDoc } from '../components/Chat/message/AttachmentPreviewModal.doc'
+export { DocumentSummaryListDoc } from '../components/Chat/message/DocumentSummaryList.doc'
+export { MessageAttachmentListDoc } from '../components/Chat/message/MessageAttachmentList.doc'
+export { MessagePartsDoc } from '../components/Chat/message/MessageParts.doc'
+export { ConfirmDialogDoc } from '../components/ConfirmDialog/doc'
+export { ContentPanelDoc } from '../components/ContentPanel/doc'
+export { DocumentPreviewDrawerDoc } from '../components/DocumentPreview/DocumentPreviewDrawer.doc'
+export { DocumentPreviewPanelDoc } from '../components/DocumentPreview/DocumentPreviewPanel.doc'
+export { EmptyStateDoc } from '../components/EmptyState/doc'
+export { ErrorBoundaryDoc } from '../components/ErrorBoundary/doc'
+export { ExcelPreviewCardDoc } from '../components/ExcelPreviewCard/doc'
+export { FieldRowDoc } from '../components/FieldRow/doc'
+export { FilterBarDoc } from '../components/FilterBar/doc'
+export { FilterTabsDoc } from '../components/FilterTabs/doc'
+export { FormDialogDoc } from '../components/FormDialog/doc'
+export { HintTextDoc } from '../components/HintText/doc'
+export { JsonCardDoc } from '../components/JsonCard/doc'
+export { JsonDetailDialogDoc } from '../components/JsonDetailDialog/doc'
+export { LoadingDotsDoc } from '../components/LoadingDots/doc'
+export { PageHeaderDoc } from '../components/PageHeader/doc'
+export { PageShellDoc } from '../components/PageShell/doc'
+export { PdfPreviewCardDoc } from '../components/PdfPreviewCard/doc'
+export { SchemaLitePreviewDoc } from '../components/SchemaLitePreview/doc'
+export { SearchFormDoc } from '../components/SearchForm/doc'
+export { SectionToggleDoc } from '../components/SectionToggle/doc'
+export { SkeletonDoc } from '../components/Skeleton/doc'
+export { StatusTagDoc } from '../components/StatusTag/doc'
+export { TableRowActionsDoc } from '../components/TableRowActions/doc'
+export { ToastDoc } from '../components/Toast/doc'
+export { TruncatedTooltipTextDoc } from '../components/TruncatedTooltipText/doc'
+export { UserAvatarDoc } from '../components/UserAvatar/doc'
+
+import type { ComponentDoc } from './types'
+import { AppDialogDoc } from '../components/AppDialog/doc'
+import { AppIconDoc } from '../components/AppIcon/doc'
+import { AppPaginationDoc } from '../components/AppPagination/doc'
+import { BreadcrumbNavDoc } from '../components/BreadcrumbNav/doc'
+import { CardGridSkeletonDoc } from '../components/CardGridSkeleton/doc'
+import { CardTableDoc } from '../components/CardTable/doc'
+import { ApprovalCardDoc } from '../components/Chat/ApprovalCard/doc'
+import { AssistantPickerDoc } from '../components/Chat/AssistantPicker/doc'
+import { ComposerDoc } from '../components/Chat/Composer/doc'
+import { ConversationHeaderDoc } from '../components/Chat/ConversationHeader/doc'
+import { MessageBubbleDoc } from '../components/Chat/MessageBubble/doc'
+import { MessageListDoc } from '../components/Chat/MessageList/doc'
+import { ModelPickerDoc } from '../components/Chat/ModelPicker/doc'
+import { ProcessingDrawerDoc } from '../components/Chat/ProcessingDrawer/doc'
+import { RunStatusBarDoc } from '../components/Chat/RunStatusBar/doc'
+import { SessionSidebarDoc } from '../components/Chat/SessionSidebar/doc'
+import { AttachmentPreviewModalDoc } from '../components/Chat/message/AttachmentPreviewModal.doc'
+import { DocumentSummaryListDoc } from '../components/Chat/message/DocumentSummaryList.doc'
+import { MessageAttachmentListDoc } from '../components/Chat/message/MessageAttachmentList.doc'
+import { MessagePartsDoc } from '../components/Chat/message/MessageParts.doc'
+import { ConfirmDialogDoc } from '../components/ConfirmDialog/doc'
+import { ContentPanelDoc } from '../components/ContentPanel/doc'
+import { DocumentPreviewDrawerDoc } from '../components/DocumentPreview/DocumentPreviewDrawer.doc'
+import { DocumentPreviewPanelDoc } from '../components/DocumentPreview/DocumentPreviewPanel.doc'
+import { EmptyStateDoc } from '../components/EmptyState/doc'
+import { ErrorBoundaryDoc } from '../components/ErrorBoundary/doc'
+import { ExcelPreviewCardDoc } from '../components/ExcelPreviewCard/doc'
+import { FieldRowDoc } from '../components/FieldRow/doc'
+import { FilterBarDoc } from '../components/FilterBar/doc'
+import { FilterTabsDoc } from '../components/FilterTabs/doc'
+import { FormDialogDoc } from '../components/FormDialog/doc'
+import { HintTextDoc } from '../components/HintText/doc'
+import { JsonCardDoc } from '../components/JsonCard/doc'
+import { JsonDetailDialogDoc } from '../components/JsonDetailDialog/doc'
+import { LoadingDotsDoc } from '../components/LoadingDots/doc'
+import { PageHeaderDoc } from '../components/PageHeader/doc'
+import { PageShellDoc } from '../components/PageShell/doc'
+import { PdfPreviewCardDoc } from '../components/PdfPreviewCard/doc'
+import { SchemaLitePreviewDoc } from '../components/SchemaLitePreview/doc'
+import { SearchFormDoc } from '../components/SearchForm/doc'
+import { SectionToggleDoc } from '../components/SectionToggle/doc'
+import { SkeletonDoc } from '../components/Skeleton/doc'
+import { StatusTagDoc } from '../components/StatusTag/doc'
+import { TableRowActionsDoc } from '../components/TableRowActions/doc'
+import { ToastDoc } from '../components/Toast/doc'
+import { TruncatedTooltipTextDoc } from '../components/TruncatedTooltipText/doc'
+import { UserAvatarDoc } from '../components/UserAvatar/doc'
+
+/** 按组件名索引的文档表 */
+export const componentDocs: Record<string, ComponentDoc> = {
+  AppDialog: AppDialogDoc,
+  AppIcon: AppIconDoc,
+  AppPagination: AppPaginationDoc,
+  BreadcrumbNav: BreadcrumbNavDoc,
+  CardGridSkeleton: CardGridSkeletonDoc,
+  CardTable: CardTableDoc,
+  ApprovalCard: ApprovalCardDoc,
+  AssistantPicker: AssistantPickerDoc,
+  Composer: ComposerDoc,
+  ConversationHeader: ConversationHeaderDoc,
+  MessageBubble: MessageBubbleDoc,
+  MessageList: MessageListDoc,
+  ModelPicker: ModelPickerDoc,
+  ProcessingDrawer: ProcessingDrawerDoc,
+  RunStatusBar: RunStatusBarDoc,
+  SessionSidebar: SessionSidebarDoc,
+  AttachmentPreviewModal: AttachmentPreviewModalDoc,
+  DocumentSummaryList: DocumentSummaryListDoc,
+  MessageAttachmentList: MessageAttachmentListDoc,
+  MessageParts: MessagePartsDoc,
+  ConfirmDialog: ConfirmDialogDoc,
+  ContentPanel: ContentPanelDoc,
+  DocumentPreviewDrawer: DocumentPreviewDrawerDoc,
+  DocumentPreviewPanel: DocumentPreviewPanelDoc,
+  EmptyState: EmptyStateDoc,
+  ErrorBoundary: ErrorBoundaryDoc,
+  ExcelPreviewCard: ExcelPreviewCardDoc,
+  FieldRow: FieldRowDoc,
+  FilterBar: FilterBarDoc,
+  FilterTabs: FilterTabsDoc,
+  FormDialog: FormDialogDoc,
+  HintText: HintTextDoc,
+  JsonCard: JsonCardDoc,
+  JsonDetailDialog: JsonDetailDialogDoc,
+  LoadingDots: LoadingDotsDoc,
+  PageHeader: PageHeaderDoc,
+  PageShell: PageShellDoc,
+  PdfPreviewCard: PdfPreviewCardDoc,
+  SchemaLitePreview: SchemaLitePreviewDoc,
+  SearchForm: SearchFormDoc,
+  SectionToggle: SectionToggleDoc,
+  Skeleton: SkeletonDoc,
+  StatusTag: StatusTagDoc,
+  TableRowActions: TableRowActionsDoc,
+  Toast: ToastDoc,
+  TruncatedTooltipText: TruncatedTooltipTextDoc,
+  UserAvatar: UserAvatarDoc,
+}

package/src/docs/types.ts

@@ -0,0 +1,51 @@
+/**
+ * 组件文档元数据类型 — playground 文档站消费
+ */
+
+/** Props 文档行 */
+export interface PropDoc {
+  /** 属性名 */
+  name: string
+  /** 类型说明 */
+  type: string
+  /** 默认值（展示用字符串） */
+  default?: string
+  /** 是否必填 */
+  required?: boolean
+  /** 说明 */
+  description: string
+}
+
+/** Emits / Events 文档行 */
+export interface EmitDoc {
+  /** 事件名 */
+  name: string
+  /** 载荷类型说明 */
+  payload?: string
+  /** 说明 */
+  description: string
+}
+
+/** Slot 文档行 */
+export interface SlotDoc {
+  /** 插槽名 */
+  name: string
+  /** 说明 */
+  description: string
+}
+
+/** 单个组件/组合式 API 的文档描述 */
+export interface ComponentDoc {
+  /** 导出名称（英文） */
+  name: string
+  /** 中文名，展示为「Name 中文」 */
+  titleZh?: string
+  /** 一句话简述 */
+  description: string
+  /** Props / Attributes */
+  props?: PropDoc[]
+  /** Emits / Events */
+  emits?: EmitDoc[]
+  /** Slots */
+  slots?: SlotDoc[]
+}