@qhr123/sa2kit 0.7.1 → 0.7.2

package/README.md

@@ -205,10 +205,12 @@ import { LanguageSwitcher } from '@qhr123/sa2kit/i18n';
 
 **Requirements:**
 - ✅ React >= 18.0.0
-- ✅ Tailwind CSS configured in your project
+- ✅ Tailwind CSS configured in your project ([Setup Guide](./docs/tailwind-setup.md))
 - ✅ Next.js App Router compatible ('use client' included)
 ```
 
+**Note:** UI components use Tailwind CSS. See the [Tailwind Setup Guide](./docs/tailwind-setup.md) for configuration instructions.
+
 ### Analytics
 
 ```typescript
@@ -258,6 +260,7 @@ function MyComponent() {
 
 ## Documentation
 
+- [Tailwind CSS Setup](./docs/tailwind-setup.md) - **UI Components Configuration**
 - [Logger Documentation](./docs/logger.md)
 - [Utility Functions](./docs/utils.md)
 - [React Hooks](./docs/hooks.md)

package/dist/analytics/index.d.mts

@@ -1,3 +1,5 @@
+import React__default from 'react';
+
 /**
  * 埋点系统类型定义
  * Analytics System Type Definitions
@@ -923,6 +925,133 @@ declare class DesktopDeviceAdapter implements AnalyticsDeviceAdapter {
     private getOSVersion;
 }
 
+/**
+ * 埋点管理界面组件类型
+ * Analytics Dashboard Component Types
+ */
+interface DashboardEvent {
+    id: string;
+    eventType: string;
+    eventName: string;
+    timestamp: string;
+    priority: number;
+    userId?: string | null;
+    sessionId: string;
+    deviceId: string;
+    pageUrl?: string | null;
+    pageTitle?: string | null;
+    referrer?: string | null;
+    properties?: Record<string, any>;
+    platform: string;
+    appVersion: string;
+    sdkVersion: string;
+}
+interface DashboardStats {
+    totalEvents: number;
+    uniqueUsers: number;
+    uniqueSessions: number;
+    uniqueDevices: number;
+    eventsByType: {
+        eventType: string;
+        count: number;
+    }[];
+    eventsByPlatform: {
+        platform: string;
+        count: number;
+    }[];
+    topPages: {
+        pageUrl: string;
+        count: number;
+    }[];
+}
+interface DateRange {
+    startDate: string;
+    endDate: string;
+}
+interface FilterOptions {
+    dateRange?: DateRange;
+    eventType?: string;
+    platform?: string;
+    userId?: string;
+}
+interface ChartDataPoint {
+    name: string;
+    value: number;
+    [key: string]: any;
+}
+
+/**
+ * 统计卡片组件
+ * Statistics Card Component
+ */
+
+interface StatCardProps {
+    title: string;
+    value: string | number;
+    subtitle?: string;
+    icon?: React__default.ReactNode;
+    trend?: {
+        value: number;
+        isPositive: boolean;
+    };
+    className?: string;
+}
+declare const StatCard: React__default.FC<StatCardProps>;
+
+/**
+ * 事件列表组件
+ * Events List Component
+ */
+
+interface EventListProps {
+    events: DashboardEvent[];
+    loading?: boolean;
+    onEventClick?: (event: DashboardEvent) => void;
+    className?: string;
+}
+declare const EventList: React__default.FC<EventListProps>;
+
+/**
+ * 筛选面板组件
+ * Filter Panel Component
+ */
+
+interface FilterPanelProps {
+    onFilterChange: (filters: FilterOptions) => void;
+    initialFilters?: FilterOptions;
+    className?: string;
+}
+declare const FilterPanel: React__default.FC<FilterPanelProps>;
+
+/**
+ * 图表组件
+ * Charts Component
+ */
+
+interface PieChartProps {
+    data: ChartDataPoint[];
+    title?: string;
+    className?: string;
+}
+declare const PieChart: React__default.FC<PieChartProps>;
+interface BarChartProps {
+    data: ChartDataPoint[];
+    title?: string;
+    className?: string;
+}
+declare const BarChart: React__default.FC<BarChartProps>;
+
+/**
+ * 埋点数据仪表板组件
+ * Analytics Dashboard Component
+ */
+
+interface AnalyticsDashboardProps {
+    apiBaseUrl?: string;
+    className?: string;
+}
+declare const AnalyticsDashboard: React__default.FC<AnalyticsDashboardProps>;
+
 /**
  * Analytics 埋点分析模块
  *
@@ -932,4 +1061,4 @@ declare class DesktopDeviceAdapter implements AnalyticsDeviceAdapter {
 
 declare const ANALYTICS_VERSION = "1.0.0";
 
-export { ANALYTICS_VERSION, Analytics, type AnalyticsConfig, type AnalyticsDeviceAdapter, type AnalyticsEvent, type AnalyticsNetworkAdapter, type AnalyticsStorageAdapter, type ApiCallEvent, type BaseEvent, CatchError, type ClickEvent, DesktopDeviceAdapter, DesktopNetworkAdapter, DesktopStorageAdapter, type DeviceInfo, type ErrorEvent, EventPriority, EventQueue, EventType, MiniappDeviceAdapter, MiniappNetworkAdapter, MiniappStorageAdapter, MobileDeviceAdapter, MobileNetworkAdapter, MobileStorageAdapter, type PageViewEvent, type PerformanceEvent, Track, TrackClick, TrackPerformance, type UploadResponse, Uploader, WebDeviceAdapter, WebNetworkAdapter, WebStorageAdapter, createAnalytics, createDesktopConfig, createMiniappConfig, createMobileConfig, createWebConfig, debounce, deepClone, formatEvent, formatTimestamp, generateUniqueId, getAllInstanceKeys, getAnalyticsInstance, getBatchSize, getCurrentPageTitle, getCurrentPageUrl, getEventSize, getGlobalAnalytics, getPageDuration, getReferrer, isAnalyticsInitialized, isDevelopment, isMobile, mergeEventProperties, resetAllAnalytics, resetAnalytics, safeParse, safeStringify, sanitizeEvent, setGlobalAnalytics, throttle, useAnalytics, useAutoTracking, useErrorTracking, usePageDuration, usePageView, usePerformanceTracking, useTrackClick, useTrackEvent, validateEvent, validateEvents, webAdapter };
+export { ANALYTICS_VERSION, Analytics, type AnalyticsConfig, AnalyticsDashboard, type AnalyticsDashboardProps, type AnalyticsDeviceAdapter, type AnalyticsEvent, type AnalyticsNetworkAdapter, type AnalyticsStorageAdapter, type ApiCallEvent, BarChart, type BaseEvent, CatchError, type ChartDataPoint, type ClickEvent, type DashboardEvent, type DashboardStats, DesktopDeviceAdapter, DesktopNetworkAdapter, DesktopStorageAdapter, type DeviceInfo, type ErrorEvent, EventList, type EventListProps, EventPriority, EventQueue, EventType, type FilterOptions, FilterPanel, type FilterPanelProps, MiniappDeviceAdapter, MiniappNetworkAdapter, MiniappStorageAdapter, MobileDeviceAdapter, MobileNetworkAdapter, MobileStorageAdapter, type PageViewEvent, type PerformanceEvent, PieChart, StatCard, type StatCardProps, Track, TrackClick, TrackPerformance, type UploadResponse, Uploader, WebDeviceAdapter, WebNetworkAdapter, WebStorageAdapter, createAnalytics, createDesktopConfig, createMiniappConfig, createMobileConfig, createWebConfig, debounce, deepClone, formatEvent, formatTimestamp, generateUniqueId, getAllInstanceKeys, getAnalyticsInstance, getBatchSize, getCurrentPageTitle, getCurrentPageUrl, getEventSize, getGlobalAnalytics, getPageDuration, getReferrer, isAnalyticsInitialized, isDevelopment, isMobile, mergeEventProperties, resetAllAnalytics, resetAnalytics, safeParse, safeStringify, sanitizeEvent, setGlobalAnalytics, throttle, useAnalytics, useAutoTracking, useErrorTracking, usePageDuration, usePageView, usePerformanceTracking, useTrackClick, useTrackEvent, validateEvent, validateEvents, webAdapter };

package/dist/analytics/index.d.ts

@@ -1,3 +1,5 @@
+import React__default from 'react';
+
 /**
  * 埋点系统类型定义
  * Analytics System Type Definitions
@@ -923,6 +925,133 @@ declare class DesktopDeviceAdapter implements AnalyticsDeviceAdapter {
     private getOSVersion;
 }
 
+/**
+ * 埋点管理界面组件类型
+ * Analytics Dashboard Component Types
+ */
+interface DashboardEvent {
+    id: string;
+    eventType: string;
+    eventName: string;
+    timestamp: string;
+    priority: number;
+    userId?: string | null;
+    sessionId: string;
+    deviceId: string;
+    pageUrl?: string | null;
+    pageTitle?: string | null;
+    referrer?: string | null;
+    properties?: Record<string, any>;
+    platform: string;
+    appVersion: string;
+    sdkVersion: string;
+}
+interface DashboardStats {
+    totalEvents: number;
+    uniqueUsers: number;
+    uniqueSessions: number;
+    uniqueDevices: number;
+    eventsByType: {
+        eventType: string;
+        count: number;
+    }[];
+    eventsByPlatform: {
+        platform: string;
+        count: number;
+    }[];
+    topPages: {
+        pageUrl: string;
+        count: number;
+    }[];
+}
+interface DateRange {
+    startDate: string;
+    endDate: string;
+}
+interface FilterOptions {
+    dateRange?: DateRange;
+    eventType?: string;
+    platform?: string;
+    userId?: string;
+}
+interface ChartDataPoint {
+    name: string;
+    value: number;
+    [key: string]: any;
+}
+
+/**
+ * 统计卡片组件
+ * Statistics Card Component
+ */
+
+interface StatCardProps {
+    title: string;
+    value: string | number;
+    subtitle?: string;
+    icon?: React__default.ReactNode;
+    trend?: {
+        value: number;
+        isPositive: boolean;
+    };
+    className?: string;
+}
+declare const StatCard: React__default.FC<StatCardProps>;
+
+/**
+ * 事件列表组件
+ * Events List Component
+ */
+
+interface EventListProps {
+    events: DashboardEvent[];
+    loading?: boolean;
+    onEventClick?: (event: DashboardEvent) => void;
+    className?: string;
+}
+declare const EventList: React__default.FC<EventListProps>;
+
+/**
+ * 筛选面板组件
+ * Filter Panel Component
+ */
+
+interface FilterPanelProps {
+    onFilterChange: (filters: FilterOptions) => void;
+    initialFilters?: FilterOptions;
+    className?: string;
+}
+declare const FilterPanel: React__default.FC<FilterPanelProps>;
+
+/**
+ * 图表组件
+ * Charts Component
+ */
+
+interface PieChartProps {
+    data: ChartDataPoint[];
+    title?: string;
+    className?: string;
+}
+declare const PieChart: React__default.FC<PieChartProps>;
+interface BarChartProps {
+    data: ChartDataPoint[];
+    title?: string;
+    className?: string;
+}
+declare const BarChart: React__default.FC<BarChartProps>;
+
+/**
+ * 埋点数据仪表板组件
+ * Analytics Dashboard Component
+ */
+
+interface AnalyticsDashboardProps {
+    apiBaseUrl?: string;
+    className?: string;
+}
+declare const AnalyticsDashboard: React__default.FC<AnalyticsDashboardProps>;
+
 /**
  * Analytics 埋点分析模块
  *
@@ -932,4 +1061,4 @@ declare class DesktopDeviceAdapter implements AnalyticsDeviceAdapter {
 
 declare const ANALYTICS_VERSION = "1.0.0";
 
-export { ANALYTICS_VERSION, Analytics, type AnalyticsConfig, type AnalyticsDeviceAdapter, type AnalyticsEvent, type AnalyticsNetworkAdapter, type AnalyticsStorageAdapter, type ApiCallEvent, type BaseEvent, CatchError, type ClickEvent, DesktopDeviceAdapter, DesktopNetworkAdapter, DesktopStorageAdapter, type DeviceInfo, type ErrorEvent, EventPriority, EventQueue, EventType, MiniappDeviceAdapter, MiniappNetworkAdapter, MiniappStorageAdapter, MobileDeviceAdapter, MobileNetworkAdapter, MobileStorageAdapter, type PageViewEvent, type PerformanceEvent, Track, TrackClick, TrackPerformance, type UploadResponse, Uploader, WebDeviceAdapter, WebNetworkAdapter, WebStorageAdapter, createAnalytics, createDesktopConfig, createMiniappConfig, createMobileConfig, createWebConfig, debounce, deepClone, formatEvent, formatTimestamp, generateUniqueId, getAllInstanceKeys, getAnalyticsInstance, getBatchSize, getCurrentPageTitle, getCurrentPageUrl, getEventSize, getGlobalAnalytics, getPageDuration, getReferrer, isAnalyticsInitialized, isDevelopment, isMobile, mergeEventProperties, resetAllAnalytics, resetAnalytics, safeParse, safeStringify, sanitizeEvent, setGlobalAnalytics, throttle, useAnalytics, useAutoTracking, useErrorTracking, usePageDuration, usePageView, usePerformanceTracking, useTrackClick, useTrackEvent, validateEvent, validateEvents, webAdapter };
+export { ANALYTICS_VERSION, Analytics, type AnalyticsConfig, AnalyticsDashboard, type AnalyticsDashboardProps, type AnalyticsDeviceAdapter, type AnalyticsEvent, type AnalyticsNetworkAdapter, type AnalyticsStorageAdapter, type ApiCallEvent, BarChart, type BaseEvent, CatchError, type ChartDataPoint, type ClickEvent, type DashboardEvent, type DashboardStats, DesktopDeviceAdapter, DesktopNetworkAdapter, DesktopStorageAdapter, type DeviceInfo, type ErrorEvent, EventList, type EventListProps, EventPriority, EventQueue, EventType, type FilterOptions, FilterPanel, type FilterPanelProps, MiniappDeviceAdapter, MiniappNetworkAdapter, MiniappStorageAdapter, MobileDeviceAdapter, MobileNetworkAdapter, MobileStorageAdapter, type PageViewEvent, type PerformanceEvent, PieChart, StatCard, type StatCardProps, Track, TrackClick, TrackPerformance, type UploadResponse, Uploader, WebDeviceAdapter, WebNetworkAdapter, WebStorageAdapter, createAnalytics, createDesktopConfig, createMiniappConfig, createMobileConfig, createWebConfig, debounce, deepClone, formatEvent, formatTimestamp, generateUniqueId, getAllInstanceKeys, getAnalyticsInstance, getBatchSize, getCurrentPageTitle, getCurrentPageUrl, getEventSize, getGlobalAnalytics, getPageDuration, getReferrer, isAnalyticsInitialized, isDevelopment, isMobile, mergeEventProperties, resetAllAnalytics, resetAnalytics, safeParse, safeStringify, sanitizeEvent, setGlobalAnalytics, throttle, useAnalytics, useAutoTracking, useErrorTracking, usePageDuration, usePageView, usePerformanceTracking, useTrackClick, useTrackEvent, validateEvent, validateEvents, webAdapter };