@apform-ui/core 1.7.4 → 1.9.0

package/dist/index.d.ts

@@ -24,6 +24,22 @@ export { AppUserPanel } from './components/AppUserPanel';
 export type { AppUserPanelUser } from './components/AppUserPanel';
 export { SliderCaptcha } from './components/SliderCaptcha';
 export type { CaptchaPayload, SliderCaptchaValue } from './components/SliderCaptcha';
+export { TimeRangePicker } from './components/TimeRangePicker';
+export type { TimeRange, TimeRangePreset } from './components/TimeRangePicker';
+export { MetricChart } from './components/MetricChart';
+export type { MetricSeries, MetricThreshold, MetricUnit } from './components/MetricChart';
+export { StatCard } from './components/StatCard';
+export type { StatTrend } from './components/StatCard';
+export { SeverityBadge } from './components/SeverityBadge';
+export type { AlertSeverity } from './components/SeverityBadge';
+export { ServiceGrid } from './components/ServiceGrid';
+export type { ServiceItem } from './components/ServiceGrid';
+export { StatusTimeline } from './components/StatusTimeline';
+export type { TimelineSegment } from './components/StatusTimeline';
+export { LogStream } from './components/LogStream';
+export type { LogEntry } from './components/LogStream';
+export { ThresholdSlider } from './components/ThresholdSlider';
+export type { ThresholdType } from './components/ThresholdSlider';
 export { PageShell } from './components/PageShell';
 export { PageHeader } from './components/PageHeader';
 export { BreadcrumbNav } from './components/BreadcrumbNav';
@@ -48,6 +64,13 @@ export { DocumentPreviewPanel, DocumentPreviewDrawer, } from './components/Docum
 export { PdfPreviewCard } from './components/PdfPreviewCard';
 export { ExcelPreviewCard } from './components/ExcelPreviewCard';
 export type { DocumentPreviewChunk, DocumentPreviewPanelProps, } from './components/DocumentPreview';
+export { ImagePreviewCard } from './components/ImagePreviewCard';
+export { VideoPreviewCard } from './components/VideoPreviewCard';
+export { TextPreviewCard } from './components/TextPreviewCard';
+export { FileChip } from './components/FileChip';
+export { ArtifactGallery } from './components/ArtifactGallery';
+export { NodeArtifactStrip } from './components/NodeArtifactStrip';
+export { HitlArtifactPanel } from './components/HitlArtifactPanel';
 export { MessageBubble } from './components/Chat/MessageBubble';
 export { MessageList } from './components/Chat/MessageList';
 export { Composer } from './components/Chat/Composer';
@@ -74,6 +97,8 @@ export { useChatScroll } from './composables';
 export type { UseChatScrollOptions, UseChatScrollReturn } from './composables';
 export { useClipboard } from './composables';
 export type { UseClipboardOptions } from './composables';
+export { useRealtime } from './composables';
+export type { RealtimeEventType, RealtimeMessage, UseRealtimeOptions, UseRealtimeReturn, } 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';
@@ -83,7 +108,8 @@ export type { ApiError } from './utils';
 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.7.0";
+export { extractDocumentId, detectArtifactKind, normalizeNodeOutput, normalizeAttachments, tryParseJsonText, } from './utils/normalizeArtifact';
+export { COLORS, CHART_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.9.0";
 export declare const EP_FORK_BASE = "2.14.2";
 export declare const EP_FORK_DATE = "2026-08-27";

package/dist/tokens/index.d.ts

@@ -16,6 +16,22 @@ export declare const COLORS: {
     readonly danger: "#E50113";
     readonly info: "#4581E9";
 };
+/**
+ * 图表色板 — 基于 COLORS 派生，监控系统专用
+ * ECharts 无法读取 CSS 变量，故导出 hex 常量
+ */
+export declare const CHART_COLORS: {
+    readonly primary: "#0060A2";
+    readonly success: "#26A036";
+    readonly warning: "#F09700";
+    readonly danger: "#E50113";
+    readonly info: "#4581E9";
+    readonly series: readonly ["#0060A2", "#26A036", "#F09700", "#E50113", "#8B5CF6", "#EC4899", "#14B8A6", "#F97316"];
+    readonly axisLine: "#D5DDE3";
+    readonly splitLine: "#EBEDF3";
+    readonly tooltipBg: "#FFFFFF";
+    readonly tooltipText: "#303133";
+};
 /** 文字色 */
 export declare const TEXT_COLORS: {
     readonly title: "#303133";

package/dist/types/artifact.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 统一产物展示模型（Chat / 工作流执行共用）
+ * 不含 audio / 3D / PPT（本迭代明确不做）
+ */
+/** 产物类型 */
+export type ArtifactKind = 'text' | 'image' | 'video' | 'pdf' | 'office' | 'file' | 'json';
+/** 可预览产物项 */
+export interface ArtifactItem {
+    /** 稳定 ID */
+    id: string;
+    kind: ArtifactKind;
+    /** 可请求 URL（图/视频/文件） */
+    url?: string;
+    /** 平台文档 ID（走 preview API / 抽屉） */
+    documentId?: string;
+    /** 纯文本或 JSON 字符串 */
+    text?: string;
+    filename?: string;
+    mimetype?: string;
+    label?: string;
+    /** 字段来源：imageUrls / videoUrl / documentIds … */
+    source?: string;
+}
+/** Gallery 尺寸 */
+export type ArtifactGallerySize = 'compact' | 'default';

package/dist/types/index.d.ts

@@ -1 +1,2 @@
 export * from './chat';
+export * from './artifact';

package/dist/utils/metricFormat.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 监控指标数值格式化
+ */
+/** 指标单位 */
+export type MetricUnit = 'count' | 'ms' | 'percent' | 'currency' | 'tokens' | 'bytes';
+/**
+ * 按单位格式化数值
+ * @param value - 原始数值
+ * @param unit - 单位类型
+ */
+export declare function formatMetricValue(value: number, unit: MetricUnit): string;
+/**
+ * 相对时间文案（用于 lastSeen 等）
+ * @param iso - ISO 8601 时间
+ */
+export declare function formatRelativeTime(iso: string): string;
+/**
+ * 时长文案
+ * @param ms - 毫秒
+ */
+export declare function formatDuration(ms: number): string;

package/dist/utils/normalizeArtifact.d.ts

@@ -0,0 +1,35 @@
+import { ArtifactItem, ArtifactKind } from '../types/artifact';
+import { MessageAttachment } from '../types/chat';
+/**
+ * 从 URL 提取平台 documentId
+ * @param url 原始 URL
+ */
+export declare function extractDocumentId(url: string): string | undefined;
+/**
+ * 按 URL / 文件名 / mimetype 推断 kind
+ */
+export declare function detectArtifactKind(opts: {
+    url?: string;
+    filename?: string;
+    mimetype?: string;
+    hint?: string;
+}): ArtifactKind;
+/**
+ * 尝试把字符串识别为 JSON 产物（剧本 / 分镜等）
+ * @param raw 原始文本
+ */
+export declare function tryParseJsonText(raw: string): {
+    kind: 'json';
+    text: string;
+} | null;
+/**
+ * 从工作流节点 output 抽取产物
+ * @param payload 节点 output
+ * @param idPrefix ID 前缀
+ */
+export declare function normalizeNodeOutput(payload: unknown, idPrefix?: string): ArtifactItem[];
+/**
+ * 从 Chat 附件列表归一
+ * @param attachments 消息附件
+ */
+export declare function normalizeAttachments(attachments: MessageAttachment[]): ArtifactItem[];

package/dist/utils/optionalPeers.d.ts

@@ -36,3 +36,19 @@ export declare function tryLoadPdfjs(): Promise<PdfjsModule | null>;
  * 尝试加载 xlsx
  */
 export declare function tryLoadXlsx(): Promise<XlsxModule | null>;
+/** 宽松 echarts 模块（init + 实例方法） */
+export type EchartsModule = {
+    init: (el: HTMLElement, theme?: string | object | null, opts?: object) => EchartsInstance;
+};
+/** ECharts 实例最小接口 */
+export type EchartsInstance = {
+    setOption: (option: object, opts?: object) => void;
+    resize: () => void;
+    dispose: () => void;
+    on: (event: string, handler: (params: unknown) => void) => void;
+    off: (event: string, handler?: (params: unknown) => void) => void;
+};
+/**
+ * 尝试加载 echarts
+ */
+export declare function tryLoadEcharts(): Promise<EchartsModule | null>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apform-ui/core",
-  "version": "1.7.4",
+  "version": "1.9.0",
   "type": "module",
   "author": "yangdongnan",
   "license": "MIT",
@@ -61,12 +61,16 @@
     "prepublishOnly": "pnpm run build"
   },
   "peerDependencies": {
+    "echarts": ">=5.0.0",
     "element-plus": "2.14.2",
     "pdfjs-dist": ">=4.0.0",
     "vue": "^3.5.0",
     "xlsx": ">=0.18.0"
   },
   "peerDependenciesMeta": {
+    "echarts": {
+      "optional": true
+    },
     "pdfjs-dist": {
       "optional": true
     },
@@ -85,6 +89,7 @@
     "@types/node": "^26.0.1",
     "@vitejs/plugin-vue": "^5.2.3",
     "@vue/test-utils": "^2.4.6",
+    "echarts": "^5.6.0",
     "element-plus": "2.14.2",
     "jsdom": "^26.0.0",
     "sass-embedded": "^1.100.0",

package/src/docs/index.ts

@@ -51,6 +51,21 @@ 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 { TimeRangePickerDoc } from '../components/TimeRangePicker/doc'
+export { MetricChartDoc } from '../components/MetricChart/doc'
+export { StatCardDoc } from '../components/StatCard/doc'
+export { SeverityBadgeDoc } from '../components/SeverityBadge/doc'
+export { ServiceGridDoc } from '../components/ServiceGrid/doc'
+export { StatusTimelineDoc } from '../components/StatusTimeline/doc'
+export { LogStreamDoc } from '../components/LogStream/doc'
+export { ThresholdSliderDoc } from '../components/ThresholdSlider/doc'
+export { ImagePreviewCardDoc } from '../components/ImagePreviewCard/doc'
+export { VideoPreviewCardDoc } from '../components/VideoPreviewCard/doc'
+export { TextPreviewCardDoc } from '../components/TextPreviewCard/doc'
+export { FileChipDoc } from '../components/FileChip/doc'
+export { ArtifactGalleryDoc } from '../components/ArtifactGallery/doc'
+export { NodeArtifactStripDoc } from '../components/NodeArtifactStrip/doc'
+export { HitlArtifactPanelDoc } from '../components/HitlArtifactPanel/doc'
 
 import type { ComponentDoc } from './types'
 import { AppDialogDoc } from '../components/AppDialog/doc'
@@ -100,6 +115,21 @@ import { TableRowActionsDoc } from '../components/TableRowActions/doc'
 import { ToastDoc } from '../components/Toast/doc'
 import { TruncatedTooltipTextDoc } from '../components/TruncatedTooltipText/doc'
 import { UserAvatarDoc } from '../components/UserAvatar/doc'
+import { TimeRangePickerDoc } from '../components/TimeRangePicker/doc'
+import { MetricChartDoc } from '../components/MetricChart/doc'
+import { StatCardDoc } from '../components/StatCard/doc'
+import { SeverityBadgeDoc } from '../components/SeverityBadge/doc'
+import { ServiceGridDoc } from '../components/ServiceGrid/doc'
+import { StatusTimelineDoc } from '../components/StatusTimeline/doc'
+import { LogStreamDoc } from '../components/LogStream/doc'
+import { ThresholdSliderDoc } from '../components/ThresholdSlider/doc'
+import { ImagePreviewCardDoc } from '../components/ImagePreviewCard/doc'
+import { VideoPreviewCardDoc } from '../components/VideoPreviewCard/doc'
+import { TextPreviewCardDoc } from '../components/TextPreviewCard/doc'
+import { FileChipDoc } from '../components/FileChip/doc'
+import { ArtifactGalleryDoc } from '../components/ArtifactGallery/doc'
+import { NodeArtifactStripDoc } from '../components/NodeArtifactStrip/doc'
+import { HitlArtifactPanelDoc } from '../components/HitlArtifactPanel/doc'
 
 /** 按组件名索引的文档表 */
 export const componentDocs: Record<string, ComponentDoc> = {
@@ -138,16 +168,31 @@ export const componentDocs: Record<string, ComponentDoc> = {
   JsonCard: JsonCardDoc,
   JsonDetailDialog: JsonDetailDialogDoc,
   LoadingDots: LoadingDotsDoc,
+  LogStream: LogStreamDoc,
+  MetricChart: MetricChartDoc,
   PageHeader: PageHeaderDoc,
   PageShell: PageShellDoc,
   PdfPreviewCard: PdfPreviewCardDoc,
   SchemaLitePreview: SchemaLitePreviewDoc,
   SearchForm: SearchFormDoc,
   SectionToggle: SectionToggleDoc,
+  ServiceGrid: ServiceGridDoc,
+  SeverityBadge: SeverityBadgeDoc,
   Skeleton: SkeletonDoc,
+  StatCard: StatCardDoc,
   StatusTag: StatusTagDoc,
+  StatusTimeline: StatusTimelineDoc,
   TableRowActions: TableRowActionsDoc,
+  ThresholdSlider: ThresholdSliderDoc,
+  TimeRangePicker: TimeRangePickerDoc,
   Toast: ToastDoc,
   TruncatedTooltipText: TruncatedTooltipTextDoc,
   UserAvatar: UserAvatarDoc,
+  ImagePreviewCard: ImagePreviewCardDoc,
+  VideoPreviewCard: VideoPreviewCardDoc,
+  TextPreviewCard: TextPreviewCardDoc,
+  FileChip: FileChipDoc,
+  ArtifactGallery: ArtifactGalleryDoc,
+  NodeArtifactStrip: NodeArtifactStripDoc,
+  HitlArtifactPanel: HitlArtifactPanelDoc,
 }

package/src/tokens/index.ts

@@ -18,6 +18,32 @@ export const COLORS = {
   info: '#4581E9',
 } as const
 
+/**
+ * 图表色板 — 基于 COLORS 派生，监控系统专用
+ * ECharts 无法读取 CSS 变量，故导出 hex 常量
+ */
+export const CHART_COLORS = {
+  primary: COLORS.primary,
+  success: COLORS.success,
+  warning: COLORS.warning,
+  danger: COLORS.danger,
+  info: COLORS.info,
+  series: [
+    COLORS.primary,
+    COLORS.success,
+    COLORS.warning,
+    COLORS.danger,
+    '#8B5CF6',
+    '#EC4899',
+    '#14B8A6',
+    '#F97316',
+  ],
+  axisLine: '#D5DDE3',
+  splitLine: '#EBEDF3',
+  tooltipBg: '#FFFFFF',
+  tooltipText: '#303133',
+} as const
+
 /** 文字色 */
 export const TEXT_COLORS = {
   title: '#303133',