@apform-ui/core 1.7.3 → 1.8.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';
@@ -74,6 +90,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 +101,7 @@ 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 { 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.8.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/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/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.3",
+  "version": "1.8.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,14 @@ 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'
 
 import type { ComponentDoc } from './types'
 import { AppDialogDoc } from '../components/AppDialog/doc'
@@ -100,6 +108,14 @@ 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'
 
 /** 按组件名索引的文档表 */
 export const componentDocs: Record<string, ComponentDoc> = {
@@ -138,15 +154,23 @@ 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,

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',