sa2kit 1.6.5 → 1.6.6

package/dist/calendar/index.d.ts

@@ -1,5 +1,5 @@
-import { DragStartEvent, DragOverEvent, DragEndEvent } from '@dnd-kit/core';
 import React__default from 'react';
+import { DragStartEvent, DragOverEvent, DragEndEvent } from '@dnd-kit/core';
 
 /**
  * 日历模块类型定义
@@ -461,175 +461,6 @@ interface EventListProps {
     className?: string;
 }
 
-interface UseEventsReturn {
-    events: CalendarEvent[];
-    loading: boolean;
-    error?: string;
-    createEvent: (eventData: EventFormData) => Promise<CalendarEvent>;
-    updateEvent: (eventId: number, eventData: Partial<EventFormData>) => Promise<CalendarEvent>;
-    deleteEvent: (eventId: number, deleteAll?: boolean) => Promise<void>;
-    batchDeleteEvents: (eventIds: number[]) => Promise<void>;
-    fetchEvents: (startDate: Date, endDate: Date) => Promise<void>;
-    clearError: () => void;
-}
-/**
- * 事件管理 Hook
- *
- * 提供事件的状态管理和CRUD操作
- */
-declare function useEvents(): UseEventsReturn;
-
-/**
- * 事件类型服务
- *
- * 负责处理不同类型事件的创建逻辑：
- * 1. 单次事件 (Single Event)
- * 2. 多天事件 (Multi-day Event)
- * 3. 重复事件 (Recurring Event)
- */
-declare enum EventType {
-    SINGLE = "single",// 单次事件
-    MULTI_DAY = "multi_day",// 多天事件（跨越多个日期的单个事件）
-    RECURRING = "recurring"
-}
-declare enum RecurrencePattern {
-    DAILY = "daily",
-    WEEKLY = "weekly",
-    MONTHLY = "monthly",
-    YEARLY = "yearly",
-    CUSTOM = "custom"
-}
-interface BaseEventData {
-    title: string;
-    description?: string;
-    location?: string;
-    color: string;
-    priority: string;
-    allDay: boolean;
-}
-interface SingleEventData extends BaseEventData {
-    type: EventType.SINGLE;
-    startTime: Date;
-    endTime: Date;
-}
-interface MultiDayEventData extends BaseEventData {
-    type: EventType.MULTI_DAY;
-    startDate: Date;
-    endDate: Date;
-    startTime?: string;
-    endTime?: string;
-}
-interface RecurringEventData extends BaseEventData {
-    type: EventType.RECURRING;
-    startDate: Date;
-    startTime: Date;
-    endTime: Date;
-    recurrence: {
-        pattern: RecurrencePattern;
-        interval: number;
-        endDate?: Date;
-        count?: number;
-        daysOfWeek?: number[];
-    };
-}
-type EventData = SingleEventData | MultiDayEventData | RecurringEventData;
-interface GeneratedEvent {
-    title: string;
-    description?: string;
-    startTime: Date;
-    endTime: Date;
-    location?: string;
-    color: string;
-    priority: string;
-    allDay: boolean;
-    eventType: EventType;
-    parentEventId?: string;
-    instanceDate?: string;
-    isMultiDayPart?: boolean;
-    isRecurringInstance?: boolean;
-}
-declare class EventTypeService {
-    /**
-     * 根据事件数据生成实际的事件实例
-     */
-    static generateEventInstances(eventData: EventData, viewStartDate: Date, viewEndDate: Date, parentEventId?: string): GeneratedEvent[];
-    /**
-     * 生成单次事件
-     */
-    private static generateSingleEvent;
-    /**
-     * 生成多天事件实例
-     * 例：21-23号的会议 -> 创建3个事件实例，每个代表一天
-     */
-    private static generateMultiDayEvents;
-    /**
-     * 生成重复事件实例
-     */
-    private static generateRecurringEvents;
-    /**
-     * 计算下一次重复的日期
-     */
-    private static getNextRecurrenceDate;
-    /**
-     * 格式化日期为字符串 (YYYY-MM-DD)
-     */
-    private static formatDateString;
-    /**
-     * 验证事件数据
-     */
-    static validateEventData(eventData: EventData): string[];
-    private static validateSingleEvent;
-    private static validateMultiDayEvent;
-    private static validateRecurringEvent;
-    /**
-     * 获取事件类型的描述文本
-     */
-    static getEventTypeDescription(eventData: EventData): string;
-}
-
-interface UseEnhancedEventsReturn {
-    events: CalendarEvent[];
-    loading: boolean;
-    error?: string;
-    createEvent: (eventData: EventFormData) => Promise<CalendarEvent>;
-    createEnhancedEvent: (eventData: EventData) => Promise<CalendarEvent[]>;
-    updateEvent: (eventId: number, eventData: Partial<EventFormData>) => Promise<CalendarEvent>;
-    updateEventTime: (eventId: number, newStartTime: Date, newEndTime: Date) => Promise<void>;
-    deleteEvent: (eventId: number, deleteAll?: boolean) => Promise<void>;
-    batchDeleteEvents: (eventIds: number[]) => Promise<void>;
-    fetchEvents: (startDate: Date, endDate: Date) => Promise<void>;
-    clearError: () => void;
-}
-/**
- * 增强版事件管理 Hook
- *
- * 支持新的事件类型系统：单次事件、多天事件、重复事件
- */
-declare function useEnhancedEvents(): UseEnhancedEventsReturn;
-
-interface DragState {
-    isDragging: boolean;
-    draggedEvent: CalendarEvent | null;
-    dragOverDate: Date | null;
-    previewTime: string | null;
-}
-interface UseEventDragReturn {
-    dragState: DragState;
-    handleDragStart: (event: DragStartEvent) => void;
-    handleDragOver: (event: DragOverEvent) => void;
-    handleDragEnd: (event: DragEndEvent) => void;
-    resetDragState: () => void;
-}
-/**
- * 事件拖拽Hook
- *
- * 提供事件拖拽功能，支持：
- * - 拖拽事件到不同日期
- * - 拖拽时显示预览信息
- * - 拖拽状态管理
- */
-declare function useEventDrag(events: CalendarEvent[], onEventUpdate: (eventId: number, newStartTime: Date, newEndTime: Date) => Promise<void>): UseEventDragReturn;
-
 /**
  * 日历日期工具函数
  *
@@ -762,550 +593,605 @@ declare function isValidDate(date: any): date is Date;
  */
 declare function cloneDate(date: Date): Date;
 
+interface CalendarPageProps {
+    /** 当前登录用户信息 */
+    user?: {
+        id: number;
+        name?: string;
+        [key: string]: any;
+    } | null;
+    /** 是否已认证 */
+    isAuthenticated?: boolean;
+    /** 触发登录的回调 */
+    onShowLogin?: () => void;
+    /** 自定义页头操作区域（例如用户菜单） */
+    headerActions?: React__default.ReactNode;
+}
 /**
- * 检测是否为移动端设备
+ * 基础日历页面组件
+ *
+ * 这是一个简化版本的日历页面，用于在实验田中展示基本功能
+ * 包含了基本的月历视图和事件显示
  */
-declare const isMobileDevice: () => boolean;
+declare function CalendarPage({ user, isAuthenticated, onShowLogin, headerActions }: CalendarPageProps): React__default.JSX.Element;
+
+interface EventDetailPageProps {
+    eventId: number;
+    onBack?: () => void;
+    onEdit?: (event: CalendarEvent) => void;
+    onDelete?: (eventId: number) => void;
+}
+declare const EventDetailPage: React__default.FC<EventDetailPageProps>;
+
+interface EventFormProps {
+    /** 初始事件数据（编辑模式） */
+    initialData?: Partial<EventFormData>;
+    /** 是否为编辑模式 */
+    isEdit?: boolean;
+    /** 表单提交回调 */
+    onSubmit: (data: EventFormData) => void;
+    /** 取消回调 */
+    onCancel: () => void;
+    /** 是否正在加载 */
+    loading?: boolean;
+}
 /**
- * 检测是否支持拖拽
+ * 事件表单组件
+ *
+ * 用于创建和编辑日历事件的表单组件
+ * 支持基本信息、重复规则、提醒设置等功能
  */
-declare const isDragSupported: () => boolean;
-declare const useDeviceType: () => {
-    isMobile: boolean;
-    dragSupported: boolean;
-};
+declare function EventForm({ initialData, isEdit, onSubmit, onCancel, loading }: EventFormProps): React__default.JSX.Element;
 
-interface RecurrenceRule {
-    type: 'daily' | 'weekly' | 'monthly' | 'yearly';
-    interval: number;
-    endDate?: string;
-    count?: number;
-    daysOfWeek?: number[];
-    dayOfMonth?: number;
-    weekOfMonth?: number;
+interface EventModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onSave: (eventData: CreateEventRequest | UpdateEventRequest) => Promise<void>;
+    onDelete?: (eventId: number) => Promise<void>;
+    event?: CalendarEvent | null;
+    initialDate?: Date;
 }
-interface RecurringEventInstance {
-    startTime: string;
-    endTime: string;
-    title: string;
-    description?: string;
-    location?: string;
-    color?: string;
-    priority?: string;
-    allDay: boolean;
-    isRecurringInstance: boolean;
-    recurrenceId?: string;
-    instanceDate: string;
+declare const EventModal: React__default.FC<EventModalProps>;
+
+/**
+ * 事件列表组件
+ * 支持列表/网格显示模式、排序、批量选择和批量删除
+ */
+declare function EventList({ events, config, onConfigChange, onEventClick, onEventEdit, onEventDelete, onBatchDelete, enableBatchActions, loading, className }: EventListProps): React__default.JSX.Element;
+
+interface EventSearchProps {
+    events: CalendarEvent[];
+    onFiltered: (filteredEvents: CalendarEvent[]) => void;
+    className?: string;
 }
-declare class RecurrenceService {
-    /**
-     * 根据重复规则生成事件实例
+declare const EventSearch: React__default.FC<EventSearchProps>;
+
+interface DraggableEventProps {
+    event: CalendarEvent;
+    isDragging?: boolean;
+    className?: string;
+    onClick?: () => void;
+    children?: React__default.ReactNode;
+}
+/**
+ * 可拖拽的事件组件
+ *
+ * 功能特性：
+ * - 支持拖拽移动事件（桌面端）
+ * - 移动端禁用拖拽功能
+ * - 拖拽时显示半透明效果
+ * - 保持原有的点击功能
+ * - 响应式设计
+ */
+declare const DraggableEvent: React__default.FC<DraggableEventProps>;
+
+interface DroppableCalendarCellProps {
+    date: Date;
+    events: CalendarEvent[];
+    isCurrentMonth: boolean;
+    isSelected?: boolean;
+    dragOverPreview?: string | null;
+    onEventClick?: (event: CalendarEvent) => void;
+    onDateClick?: (date: Date) => void;
+    className?: string;
+    disableDrop?: boolean;
+}
+/**
+ * 可放置的日历单元格组件
+ *
+ * 功能特性：
+ * - 支持拖拽事件到此日期
+ * - 显示当前日期的所有事件
+ * - 拖拽悬停时显示预览
+ * - 响应式设计
+ */
+declare const DroppableCalendarCell: React__default.FC<DroppableCalendarCellProps>;
+
+interface DraggableMonthViewProps {
+    events: CalendarEvent[];
+    currentDate: Date;
+    onDateChange: (date: Date) => void;
+    onEventClick?: (event: CalendarEvent) => void;
+    onDateClick?: (date: Date) => void;
+    onEventUpdate: (eventId: number, newStartTime: Date, newEndTime: Date) => Promise<void>;
+    className?: string;
+}
+/**
+ * 支持拖拽的月视图组件
+ *
+ * 功能特性：
+ * - 完整的月视图日历
+ * - 事件拖拽功能（桌面端）
+ * - 移动端禁用拖拽，优化触摸体验
+ * - 拖拽预览和反馈
+ * - 月份导航
+ * - 响应式设计
+ */
+declare const DraggableMonthView: React__default.FC<DraggableMonthViewProps>;
+
+interface UseEventsReturn {
+    events: CalendarEvent[];
+    loading: boolean;
+    error?: string;
+    createEvent: (eventData: EventFormData) => Promise<CalendarEvent>;
+    updateEvent: (eventId: number, eventData: Partial<EventFormData>) => Promise<CalendarEvent>;
+    deleteEvent: (eventId: number, deleteAll?: boolean) => Promise<void>;
+    batchDeleteEvents: (eventIds: number[]) => Promise<void>;
+    fetchEvents: (startDate: Date, endDate: Date) => Promise<void>;
+    clearError: () => void;
+}
+/**
+ * 事件管理 Hook
+ *
+ * 提供事件的状态管理和CRUD操作
+ */
+declare function useEvents(): UseEventsReturn;
+
+/**
+ * 事件类型服务
+ *
+ * 负责处理不同类型事件的创建逻辑：
+ * 1. 单次事件 (Single Event)
+ * 2. 多天事件 (Multi-day Event)
+ * 3. 重复事件 (Recurring Event)
+ */
+declare enum EventType {
+    SINGLE = "single",// 单次事件
+    MULTI_DAY = "multi_day",// 多天事件（跨越多个日期的单个事件）
+    RECURRING = "recurring"
+}
+declare enum RecurrencePattern {
+    DAILY = "daily",
+    WEEKLY = "weekly",
+    MONTHLY = "monthly",
+    YEARLY = "yearly",
+    CUSTOM = "custom"
+}
+interface BaseEventData {
+    title: string;
+    description?: string;
+    location?: string;
+    color: string;
+    priority: string;
+    allDay: boolean;
+}
+interface SingleEventData extends BaseEventData {
+    type: EventType.SINGLE;
+    startTime: Date;
+    endTime: Date;
+}
+interface MultiDayEventData extends BaseEventData {
+    type: EventType.MULTI_DAY;
+    startDate: Date;
+    endDate: Date;
+    startTime?: string;
+    endTime?: string;
+}
+interface RecurringEventData extends BaseEventData {
+    type: EventType.RECURRING;
+    startDate: Date;
+    startTime: Date;
+    endTime: Date;
+    recurrence: {
+        pattern: RecurrencePattern;
+        interval: number;
+        endDate?: Date;
+        count?: number;
+        daysOfWeek?: number[];
+    };
+}
+type EventData = SingleEventData | MultiDayEventData | RecurringEventData;
+interface GeneratedEvent {
+    title: string;
+    description?: string;
+    startTime: Date;
+    endTime: Date;
+    location?: string;
+    color: string;
+    priority: string;
+    allDay: boolean;
+    eventType: EventType;
+    parentEventId?: string;
+    instanceDate?: string;
+    isMultiDayPart?: boolean;
+    isRecurringInstance?: boolean;
+}
+declare class EventTypeService {
+    /**
+     * 根据事件数据生成实际的事件实例
      */
-    static generateRecurringInstances(baseEvent: {
-        title: string;
-        description?: string;
-        startTime: string;
-        endTime: string;
-        location?: string;
-        color?: string;
-        priority?: string;
-        allDay: boolean;
-    }, rule: RecurrenceRule, startDate: Date, endDate: Date, eventId?: string): RecurringEventInstance[];
+    static generateEventInstances(eventData: EventData, viewStartDate: Date, viewEndDate: Date, parentEventId?: string): GeneratedEvent[];
     /**
-     * 判断是否应该在指定日期生成实例
+     * 生成单次事件
      */
-    private static shouldGenerateInstance;
+    private static generateSingleEvent;
     /**
-     * 获取下一个重复事件的日期
+     * 生成多天事件实例
+     * 例：21-23号的会议 -> 创建3个事件实例，每个代表一天
      */
-    private static getNextOccurrence;
+    private static generateMultiDayEvents;
     /**
-     * 验证重复规则
+     * 生成重复事件实例
      */
-    static validateRecurrenceRule(rule: RecurrenceRule): string[];
+    private static generateRecurringEvents;
     /**
-     * 将表单数据转换为重复规则
+     * 计算下一次重复的日期
      */
-    static formDataToRecurrenceRule(formData: {
-        recurrenceType?: 'daily' | 'weekly' | 'monthly' | 'yearly';
-        recurrenceInterval?: number;
-        recurrenceEndDate?: string;
-        recurrenceCount?: number;
-    }): RecurrenceRule | null;
+    private static getNextRecurrenceDate;
     /**
-     * 描述重复规则的文本
+     * 格式化日期为字符串 (YYYY-MM-DD)
      */
-    static describeRecurrenceRule(rule: RecurrenceRule): string;
+    private static formatDateString;
+    /**
+     * 验证事件数据
+     */
+    static validateEventData(eventData: EventData): string[];
+    private static validateSingleEvent;
+    private static validateMultiDayEvent;
+    private static validateRecurringEvent;
+    /**
+     * 获取事件类型的描述文本
+     */
+    static getEventTypeDescription(eventData: EventData): string;
 }
 
-interface ReminderConfig {
-    minutes: number;
-    type: 'browser' | 'email' | 'sms' | 'sound';
-    enabled: boolean;
+interface UseEnhancedEventsReturn {
+    events: CalendarEvent[];
+    loading: boolean;
+    error?: string;
+    createEvent: (eventData: EventFormData) => Promise<CalendarEvent>;
+    createEnhancedEvent: (eventData: EventData) => Promise<CalendarEvent[]>;
+    updateEvent: (eventId: number, eventData: Partial<EventFormData>) => Promise<CalendarEvent>;
+    updateEventTime: (eventId: number, newStartTime: Date, newEndTime: Date) => Promise<void>;
+    deleteEvent: (eventId: number, deleteAll?: boolean) => Promise<void>;
+    batchDeleteEvents: (eventIds: number[]) => Promise<void>;
+    fetchEvents: (startDate: Date, endDate: Date) => Promise<void>;
+    clearError: () => void;
 }
-interface ScheduledReminder {
-    id: string;
-    eventId: number;
-    eventTitle: string;
-    reminderTime: Date;
-    config: ReminderConfig;
-    status: 'pending' | 'sent' | 'failed';
+/**
+ * 增强版事件管理 Hook
+ *
+ * 支持新的事件类型系统：单次事件、多天事件、重复事件
+ */
+declare function useEnhancedEvents(): UseEnhancedEventsReturn;
+
+interface DragState {
+    isDragging: boolean;
+    draggedEvent: CalendarEvent | null;
+    dragOverDate: Date | null;
+    previewTime: string | null;
 }
-declare class ReminderService {
-    private static reminders;
-    private static notificationPermission;
+interface UseEventDragReturn {
+    dragState: DragState;
+    handleDragStart: (event: DragStartEvent) => void;
+    handleDragOver: (event: DragOverEvent) => void;
+    handleDragEnd: (event: DragEndEvent) => void;
+    resetDragState: () => void;
+}
+/**
+ * 事件拖拽Hook
+ *
+ * 提供事件拖拽功能，支持：
+ * - 拖拽事件到不同日期
+ * - 拖拽时显示预览信息
+ * - 拖拽状态管理
+ */
+declare function useEventDrag(events: CalendarEvent[], onEventUpdate: (eventId: number, newStartTime: Date, newEndTime: Date) => Promise<void>): UseEventDragReturn;
+
+/**
+ * 日历导出服务
+ *
+ * 提供日历事件的导出功能，支持多种格式：
+ * - iCal (.ics) 格式
+ * - JSON 格式
+ * - CSV 格式
+ */
+
+interface ExportOptions {
+    format: 'ical' | 'json' | 'csv';
+    dateRange?: {
+        start: Date;
+        end: Date;
+    };
+    includeCompleted?: boolean;
+}
+declare class CalendarExportService {
     /**
-     * 初始化提醒服务
+     * 导出事件到指定格式
      */
-    static initialize(): Promise<void>;
+    static exportEvents(events: CalendarEvent[], options: ExportOptions): Promise<string>;
     /**
-     * 为事件创建提醒
+     * 导出为 iCal (.ics) 格式
      */
-    static createReminder(event: CalendarEvent, reminderMinutes: number, reminderType?: 'browser' | 'email' | 'sms' | 'sound'): string;
+    private static exportToICal;
     /**
-     * 删除提醒
+     * 导出为 JSON 格式
      */
-    static deleteReminder(reminderId: string): boolean;
+    private static exportToJSON;
     /**
-     * 删除事件的所有提醒
+     * 导出为 CSV 格式
      */
-    static deleteEventReminders(eventId: number): void;
+    private static exportToCSV;
     /**
-     * 检查并触发到期的提醒
+     * 下载导出的文件
      */
-    private static checkPendingReminders;
+    static downloadFile(content: string, filename: string, mimeType: string): void;
     /**
-     * 触发提醒
+     * 获导出方法的便捷函数
      */
-    private static triggerReminder;
+    static exportAndDownload(events: CalendarEvent[], options: ExportOptions, filename?: string): Promise<void>;
     /**
-     * 发送浏览器通知
+     * 格式化日期时间为 iCal 格式
      */
-    private static sendBrowserNotification;
+    private static formatDateTimeToICal;
     /**
-     * 发送邮件提醒
+     * 转义 iCal 文本
      */
-    private static sendEmailReminder;
+    private static escapeICalText;
     /**
-     * 发送短信提醒
+     * 转义 CSV 字段
      */
-    private static sendSmsReminder;
+    private static escapeCSVField;
+}
+
+/**
+ * 日历导入服务
+ *
+ * 提供日历事件的导入功能，支持多种格式：
+ * - iCal (.ics) 格式
+ * - JSON 格式
+ * - CSV 格式
+ */
+
+interface ImportOptions {
+    format: 'ical' | 'json' | 'csv';
+    overwriteExisting?: boolean;
+    validateEvents?: boolean;
+}
+interface ImportResult {
+    success: boolean;
+    importedCount: number;
+    errors: string[];
+    events: CreateEventRequest[];
+}
+declare class CalendarImportService {
     /**
-     * 播放声音提醒
+     * 从文件导入事件
      */
-    private static playSoundReminder;
+    static importFromFile(file: File, options: ImportOptions): Promise<ImportResult>;
     /**
-     * 显示视觉提醒
+     * 从内容字符串导入事件
      */
-    private static showVisualAlert;
+    static importFromContent(content: string, options: ImportOptions): Promise<ImportResult>;
     /**
-     * 获取时间描述文本
+     * 读取文件内容
      */
-    private static getTimeText;
+    private static readFileContent;
     /**
-     * 获取所有提醒
+     * 解析 iCal 内容
      */
-    static getAllReminders(): ScheduledReminder[];
+    private static parseICalContent;
     /**
-     * 获取事件的提醒
+     * 解析 JSON 内容
      */
-    static getEventReminders(eventId: number): ScheduledReminder[];
+    private static parseJSONContent;
     /**
-     * 智能推荐提醒时间
+     * 解析 CSV 内容
      */
-    static getSmartReminderSuggestions(event: CalendarEvent): number[];
+    private static parseCSVContent;
     /**
-     * 批量创建智能提醒
+     * 解析 CSV 行
      */
-    static createSmartReminders(event: CalendarEvent): string[];
+    private static parseCSVLine;
+    /**
+     * 验证和过滤事件
+     */
+    private static validateAndFilterEvents;
+    /**
+     * 解析 iCal 日期时间
+     */
+    private static parseICalDateTime;
+    /**
+     * 反转义 iCal 文本
+     */
+    private static unescapeICalText;
+    /**
+     * 映射 iCal 优先级
+     */
+    private static mapICalPriority;
 }
 
-/**
- * 日历导出服务
- *
- * 提供日历事件的导出功能，支持多种格式：
- * - iCal (.ics) 格式
- * - JSON 格式
- * - CSV 格式
- */
-
-interface ExportOptions {
-    format: 'ical' | 'json' | 'csv';
-    dateRange?: {
-        start: Date;
-        end: Date;
-    };
-    includeCompleted?: boolean;
+interface RecurrenceRule {
+    type: 'daily' | 'weekly' | 'monthly' | 'yearly';
+    interval: number;
+    endDate?: string;
+    count?: number;
+    daysOfWeek?: number[];
+    dayOfMonth?: number;
+    weekOfMonth?: number;
 }
-declare class CalendarExportService {
+interface RecurringEventInstance {
+    startTime: string;
+    endTime: string;
+    title: string;
+    description?: string;
+    location?: string;
+    color?: string;
+    priority?: string;
+    allDay: boolean;
+    isRecurringInstance: boolean;
+    recurrenceId?: string;
+    instanceDate: string;
+}
+declare class RecurrenceService {
     /**
-     * 导出事件到指定格式
+     * 根据重复规则生成事件实例
      */
-    static exportEvents(events: CalendarEvent[], options: ExportOptions): Promise<string>;
+    static generateRecurringInstances(baseEvent: {
+        title: string;
+        description?: string;
+        startTime: string;
+        endTime: string;
+        location?: string;
+        color?: string;
+        priority?: string;
+        allDay: boolean;
+    }, rule: RecurrenceRule, startDate: Date, endDate: Date, eventId?: string): RecurringEventInstance[];
     /**
-     * 导出为 iCal (.ics) 格式
+     * 判断是否应该在指定日期生成实例
      */
-    private static exportToICal;
+    private static shouldGenerateInstance;
     /**
-     * 导出为 JSON 格式
+     * 获取下一个重复事件的日期
      */
-    private static exportToJSON;
+    private static getNextOccurrence;
+    /**
+     * 验证重复规则
+     */
+    static validateRecurrenceRule(rule: RecurrenceRule): string[];
+    /**
+     * 将表单数据转换为重复规则
+     */
+    static formDataToRecurrenceRule(formData: {
+        recurrenceType?: 'daily' | 'weekly' | 'monthly' | 'yearly';
+        recurrenceInterval?: number;
+        recurrenceEndDate?: string;
+        recurrenceCount?: number;
+    }): RecurrenceRule | null;
     /**
-     * 导出为 CSV 格式
+     * 描述重复规则的文本
      */
-    private static exportToCSV;
+    static describeRecurrenceRule(rule: RecurrenceRule): string;
+}
+
+interface ReminderConfig {
+    minutes: number;
+    type: 'browser' | 'email' | 'sms' | 'sound';
+    enabled: boolean;
+}
+interface ScheduledReminder {
+    id: string;
+    eventId: number;
+    eventTitle: string;
+    reminderTime: Date;
+    config: ReminderConfig;
+    status: 'pending' | 'sent' | 'failed';
+}
+declare class ReminderService {
+    private static reminders;
+    private static notificationPermission;
     /**
-     * 下载导出的文件
+     * 初始化提醒服务
      */
-    static downloadFile(content: string, filename: string, mimeType: string): void;
+    static initialize(): Promise<void>;
     /**
-     * 获导出方法的便捷函数
+     * 为事件创建提醒
      */
-    static exportAndDownload(events: CalendarEvent[], options: ExportOptions, filename?: string): Promise<void>;
+    static createReminder(event: CalendarEvent, reminderMinutes: number, reminderType?: 'browser' | 'email' | 'sms' | 'sound'): string;
     /**
-     * 格式化日期时间为 iCal 格式
+     * 删除提醒
      */
-    private static formatDateTimeToICal;
+    static deleteReminder(reminderId: string): boolean;
     /**
-     * 转义 iCal 文本
+     * 删除事件的所有提醒
      */
-    private static escapeICalText;
+    static deleteEventReminders(eventId: number): void;
     /**
-     * 转义 CSV 字段
+     * 检查并触发到期的提醒
      */
-    private static escapeCSVField;
-}
-
-/**
- * 日历导入服务
- *
- * 提供日历事件的导入功能，支持多种格式：
- * - iCal (.ics) 格式
- * - JSON 格式
- * - CSV 格式
- */
-
-interface ImportOptions {
-    format: 'ical' | 'json' | 'csv';
-    overwriteExisting?: boolean;
-    validateEvents?: boolean;
-}
-interface ImportResult {
-    success: boolean;
-    importedCount: number;
-    errors: string[];
-    events: CreateEventRequest[];
-}
-declare class CalendarImportService {
+    private static checkPendingReminders;
     /**
-     * 从文件导入事件
+     * 触发提醒
      */
-    static importFromFile(file: File, options: ImportOptions): Promise<ImportResult>;
+    private static triggerReminder;
     /**
-     * 从内容字符串导入事件
+     * 发送浏览器通知
      */
-    static importFromContent(content: string, options: ImportOptions): Promise<ImportResult>;
+    private static sendBrowserNotification;
     /**
-     * 读取文件内容
+     * 发送邮件提醒
      */
-    private static readFileContent;
+    private static sendEmailReminder;
     /**
-     * 解析 iCal 内容
+     * 发送短信提醒
      */
-    private static parseICalContent;
+    private static sendSmsReminder;
     /**
-     * 解析 JSON 内容
+     * 播放声音提醒
      */
-    private static parseJSONContent;
+    private static playSoundReminder;
     /**
-     * 解析 CSV 内容
+     * 显示视觉提醒
      */
-    private static parseCSVContent;
+    private static showVisualAlert;
     /**
-     * 解析 CSV 行
+     * 获取时间描述文本
      */
-    private static parseCSVLine;
+    private static getTimeText;
     /**
-     * 验证和过滤事件
+     * 获取所有提醒
      */
-    private static validateAndFilterEvents;
+    static getAllReminders(): ScheduledReminder[];
     /**
-     * 解析 iCal 日期时间
+     * 获取事件的提醒
      */
-    private static parseICalDateTime;
+    static getEventReminders(eventId: number): ScheduledReminder[];
     /**
-     * 反转义 iCal 文本
+     * 智能推荐提醒时间
      */
-    private static unescapeICalText;
+    static getSmartReminderSuggestions(event: CalendarEvent): number[];
     /**
-     * 映射 iCal 优先级
+     * 批量创建智能提醒
      */
-    private static mapICalPriority;
-}
-
-interface CalendarPageProps {
-    /** 当前登录用户信息 */
-    user?: {
-        id: number;
-        name?: string;
-        [key: string]: any;
-    } | null;
-    /** 是否已认证 */
-    isAuthenticated?: boolean;
-    /** 触发登录的回调 */
-    onShowLogin?: () => void;
-    /** 自定义页头操作区域（例如用户菜单） */
-    headerActions?: React__default.ReactNode;
-}
-/**
- * 基础日历页面组件
- *
- * 这是一个简化版本的日历页面，用于在实验田中展示基本功能
- * 包含了基本的月历视图和事件显示
- */
-declare function CalendarPage({ user: propUser, isAuthenticated: propIsAuthenticated, onShowLogin, headerActions }: CalendarPageProps): React__default.JSX.Element;
-
-interface EventDetailPageProps {
-    eventId: number;
-    onBack?: () => void;
-    onEdit?: (event: CalendarEvent) => void;
-    onDelete?: (eventId: number) => void;
+    static createSmartReminders(event: CalendarEvent): string[];
 }
-declare const EventDetailPage: React__default.FC<EventDetailPageProps>;
 
-interface EventFormProps {
-    /** 初始事件数据（编辑模式） */
-    initialData?: Partial<EventFormData>;
-    /** 是否为编辑模式 */
-    isEdit?: boolean;
-    /** 表单提交回调 */
-    onSubmit: (data: EventFormData) => void;
-    /** 取消回调 */
-    onCancel: () => void;
-    /** 是否正在加载 */
-    loading?: boolean;
-}
 /**
- * 事件表单组件
+ * Calendar 模块 - 主入口文件
  *
- * 用于创建和编辑日历事件的表单组件
- * 支持基本信息、重复规则、提醒设置等功能
- */
-declare function EventForm({ initialData, isEdit, onSubmit, onCancel, loading }: EventFormProps): React__default.JSX.Element;
-
-/**
- * 事件列表组件
- * 支持列表/网格显示模式、排序、批量选择和批量删除
- */
-declare function EventList({ events, config, onConfigChange, onEventClick, onEventEdit, onEventDelete, onBatchDelete, enableBatchActions, loading, className }: EventListProps): React__default.JSX.Element;
-
-interface EventModalProps {
-    isOpen: boolean;
-    onClose: () => void;
-    onSave: (eventData: CreateEventRequest | UpdateEventRequest) => Promise<void>;
-    onDelete?: (eventId: number) => Promise<void>;
-    event?: CalendarEvent | null;
-    initialDate?: Date;
-}
-declare const EventModal: React__default.FC<EventModalProps>;
-
-declare const COLOR_THEMES: {
-    default: {
-        name: string;
-        colors: {
-            primary: string;
-            secondary: string;
-            accent: string;
-            danger: string;
-            purple: string;
-            pink: string;
-            indigo: string;
-            teal: string;
-        };
-        background: {
-            calendar: string;
-            cell: string;
-            today: string;
-            weekend: string;
-            otherMonth: string;
-        };
-        border: {
-            calendar: string;
-            cell: string;
-            today: string;
-        };
-        text: {
-            primary: string;
-            secondary: string;
-            today: string;
-            weekend: string;
-            otherMonth: string;
-        };
-    };
-    dark: {
-        name: string;
-        colors: {
-            primary: string;
-            secondary: string;
-            accent: string;
-            danger: string;
-            purple: string;
-            pink: string;
-            indigo: string;
-            teal: string;
-        };
-        background: {
-            calendar: string;
-            cell: string;
-            today: string;
-            weekend: string;
-            otherMonth: string;
-        };
-        border: {
-            calendar: string;
-            cell: string;
-            today: string;
-        };
-        text: {
-            primary: string;
-            secondary: string;
-            today: string;
-            weekend: string;
-            otherMonth: string;
-        };
-    };
-    colorful: {
-        name: string;
-        colors: {
-            primary: string;
-            secondary: string;
-            accent: string;
-            danger: string;
-            purple: string;
-            pink: string;
-            indigo: string;
-            teal: string;
-        };
-        background: {
-            calendar: string;
-            cell: string;
-            today: string;
-            weekend: string;
-            otherMonth: string;
-        };
-        border: {
-            calendar: string;
-            cell: string;
-            today: string;
-        };
-        text: {
-            primary: string;
-            secondary: string;
-            today: string;
-            weekend: string;
-            otherMonth: string;
-        };
-    };
-};
-interface CalendarSettingsProps {
-    onSettingsChange?: (settings: CalendarSettingsData) => void;
-}
-interface CalendarSettingsData {
-    theme: keyof typeof COLOR_THEMES;
-    customColors?: {
-        [key: string]: string;
-    };
-    weekStartsOn: number;
-    timeFormat: '12h' | '24h';
-    language: string;
-    showWeekNumbers: boolean;
-    showLunarCalendar: boolean;
-    defaultEventDuration: number;
-    workingHours: {
-        start: string;
-        end: string;
-    };
-}
-declare function CalendarSettings({ onSettingsChange }: CalendarSettingsProps): React__default.JSX.Element;
-
-interface ImprovedEventModalProps {
-    isOpen: boolean;
-    onClose: () => void;
-    onSave: (eventData: EventData) => Promise<void>;
-    onDelete?: (eventId: number) => Promise<void>;
-    event?: CalendarEvent | null;
-    initialDate?: Date;
-}
-declare const ImprovedEventModal: React__default.FC<ImprovedEventModalProps>;
-
-interface EventSearchProps {
-    events: CalendarEvent[];
-    onFiltered: (filteredEvents: CalendarEvent[]) => void;
-    className?: string;
-}
-declare const EventSearch: React__default.FC<EventSearchProps>;
-
-interface DraggableMonthViewProps {
-    events: CalendarEvent[];
-    currentDate: Date;
-    onDateChange: (date: Date) => void;
-    onEventClick?: (event: CalendarEvent) => void;
-    onDateClick?: (date: Date) => void;
-    onEventUpdate: (eventId: number, newStartTime: Date, newEndTime: Date) => Promise<void>;
-    className?: string;
-}
-/**
- * 支持拖拽的月视图组件
+ * 这是一个完整的日历应用模块，提供了从前端组件到后端API的完整解决方案。
+ * 主要功能包括：
+ * - 日历视图（月视图、周视图、日视图）
+ * - 事件管理（创建、编辑、删除）
+ * - 重复事件支持
+ * - 提醒功能
+ * - 用户配置管理
+ * - 事件分享功能
  *
- * 功能特性：
- * - 完整的月视图日历
- * - 事件拖拽功能（桌面端）
- * - 移动端禁用拖拽，优化触摸体验
- * - 拖拽预览和反馈
- * - 月份导航
- * - 响应式设计
- */
-declare const DraggableMonthView: React__default.FC<DraggableMonthViewProps>;
-
-interface DraggableEventProps {
-    event: CalendarEvent;
-    isDragging?: boolean;
-    className?: string;
-    onClick?: () => void;
-    children?: React__default.ReactNode;
-}
-/**
- * 可拖拽的事件组件
+ * 架构特点：
+ * - 前后端分离，支持服务端渲染
+ * - 模块化设计，便于维护和扩展
+ * - TypeScript严格类型检查
+ * - TailwindCSS响应式设计
  *
- * 功能特性：
- * - 支持拖拽移动事件（桌面端）
- * - 移动端禁用拖拽功能
- * - 拖拽时显示半透明效果
- * - 保持原有的点击功能
- * - 响应式设计
+ * @version 1.0.0
+ * @author Profile-v1 Team
  */
-declare const DraggableEvent: React__default.FC<DraggableEventProps>;
+/** 基础数据类型 */
 
-interface DroppableCalendarCellProps {
-    date: Date;
-    events: CalendarEvent[];
-    isCurrentMonth: boolean;
-    isSelected?: boolean;
-    dragOverPreview?: string | null;
-    onEventClick?: (event: CalendarEvent) => void;
-    onDateClick?: (date: Date) => void;
-    className?: string;
-    disableDrop?: boolean;
-}
-/**
- * 可放置的日历单元格组件
- *
- * 功能特性：
- * - 支持拖拽事件到此日期
- * - 显示当前日期的所有事件
- * - 拖拽悬停时显示预览
- * - 响应式设计
- */
-declare const DroppableCalendarCell: React__default.FC<DroppableCalendarCellProps>;
+/** 模块版本号 */
+declare const CALENDAR_MODULE_VERSION = "1.0.0";
+/** 模块名称标识 */
+declare const CALENDAR_MODULE_NAME = "sa2kit/calendar";
 
-export { type ApiResponse, type CalendarActions, type CalendarCell, type CalendarConfig, type CalendarDbService, type CalendarEvent, CalendarExportService, CalendarImportService, CalendarPage, type CalendarService, CalendarSettings, type CalendarState, type CalendarViewProps, CalendarViewType, type CreateEventRequest, type DateRange, type DeleteEventRequest, DraggableEvent, DraggableMonthView, DroppableCalendarCell, type EventCardProps, EventColor, EventDetailPage, EventForm, type EventFormData, type EventFormProps$1 as EventFormProps, EventList, type EventListConfig, EventListDisplayMode, type EventListFilter, type EventListProps, type EventListSort, EventModal, type EventModalProps$1 as EventModalProps, EventPriority, type EventResponse, EventSearch, EventSortField, EventTypeService, type EventsResponse, type GetEventsRequest, ImprovedEventModal, type MiniCalendarProps, type RecurrenceFormData, type RecurrenceRule$1 as RecurrenceRule, RecurrenceService, RecurrenceType, type Reminder, type ReminderApiData, type ReminderFormData, ReminderService, ReminderStatus, ReminderType, SortDirection, type TimeSlot, type UpdateEventRequest, type UseCalendarReturn, type UseEventsReturn$1 as UseEventsReturn, addDays, addMonths, addWeeks, addYears, cloneDate, formatDate, formatDateTime, formatTime, generateTimeSlots, getDayEnd, getDayStart, getDaysDifference, getMonthEnd, getMonthName, getMonthStart, getMonthViewDates, getRelativeTime, getWeekEnd, getWeekStart, getWeekViewDates, getWeekdayName, isDragSupported, isMobileDevice, isSameDay, isSameMonth, isSameWeek, isToday, isValidDate, isWeekend, isWorkingHour, parseDate, toLocalISOString, useDeviceType, useEnhancedEvents, useEventDrag, useEvents };
+export { type ApiResponse, type BaseEventData, CALENDAR_MODULE_NAME, CALENDAR_MODULE_VERSION, type CalendarActions, type CalendarCell, type CalendarConfig, type CalendarEvent, CalendarExportService, CalendarImportService, CalendarPage, type CalendarState, type CalendarViewProps, CalendarViewType, type CreateEventRequest, type DateRange, type DeleteEventRequest, type DragState, DraggableEvent, DraggableMonthView, DroppableCalendarCell, type EventCardProps, EventColor, type EventData, EventDetailPage, EventForm, type EventFormData, type EventFormProps$1 as EventFormProps, EventList, type EventListConfig, EventListDisplayMode, type EventListFilter, type EventListProps, type EventListSort, EventModal, type EventModalProps$1 as EventModalProps, EventPriority, type EventResponse, EventSearch, EventSortField, EventType, EventTypeService, type EventsResponse, type ExportOptions, type GeneratedEvent, type GetEventsRequest, type CalendarDbService as ICalendarDbService, type CalendarService as ICalendarService, type ImportOptions, type ImportResult, type MiniCalendarProps, type MultiDayEventData, type RecurrenceFormData, RecurrencePattern, type RecurrenceRule$1 as RecurrenceRule, type RecurrenceRule as RecurrenceRuleType, RecurrenceService, RecurrenceType, type RecurringEventData, type RecurringEventInstance, type Reminder, type ReminderConfig, type ReminderFormData, ReminderService, ReminderStatus, ReminderType, type ScheduledReminder, type SingleEventData, SortDirection, type TimeSlot, type UpdateEventRequest, type UseCalendarReturn, type UseEnhancedEventsReturn, type UseEventDragReturn, type UseEventsReturn$1 as UseEventsReturn, addDays, addMonths, addWeeks, addYears, cloneDate, formatDate, formatDateTime, formatTime, generateTimeSlots, getDayEnd, getDayStart, getDaysDifference, getMonthEnd, getMonthName, getMonthStart, getMonthViewDates, getRelativeTime, getWeekEnd, getWeekStart, getWeekViewDates, getWeekdayName, isSameDay, isSameMonth, isSameWeek, isToday, isValidDate, isWeekend, isWorkingHour, parseDate, toLocalISOString, useEnhancedEvents, useEventDrag, useEvents };