sa2kit 1.6.44 → 1.6.45

package/dist/showmasterpiece/index.d.ts

@@ -0,0 +1,2524 @@
+import React__default, { ReactNode } from 'react';
+export { G as GenericOrderManager } from '../GenericOrderManager-e4WizpNf.js';
+import { P as PopupConfig } from '../popupConfig-BznThU1O.js';
+import { e as ExportField } from '../types-DszP7SAQ.js';
+import 'drizzle-orm';
+import 'drizzle-orm/pg-core';
+
+/**
+ * ShowMasterpiece 模块 - 购物车功能类型定义
+ *
+ * 定义了画集购物车功能相关的TypeScript类型，包括：
+ * - 购物车数据模型
+ * - API请求和响应类型
+ * - 购物车项数据类型
+ * - 状态枚举
+ *
+ * @fileoverview 购物车功能类型定义
+ */
+
+/**
+ * 购物车项数据模型
+ */
+interface CartItem {
+    /** 画集ID */
+    collectionId: number;
+    /** 画集信息 */
+    collection: ArtCollection;
+    /** 数量 */
+    quantity: number;
+    /** 添加时间 */
+    addedAt: Date;
+}
+/**
+ * 购物车数据模型
+ */
+interface Cart {
+    /** 购物车项列表 */
+    items: CartItem[];
+    /** 总数量 */
+    totalQuantity: number;
+    /** 总价格 */
+    totalPrice: number;
+}
+/**
+ * 用户购物车历史记录项
+ */
+interface CartHistoryItem {
+    /** 历史记录ID */
+    id: string;
+    /** 提交时间 */
+    submittedAt: Date;
+    /** 用户QQ号 */
+    qqNumber: string;
+    /** 用户手机号 */
+    phoneNumber: string;
+    /** 购物车项列表 */
+    items: CartItem[];
+    /** 总数量 */
+    totalQuantity: number;
+    /** 总价格 */
+    totalPrice: number;
+    /** 用户备注 */
+    notes?: string;
+    /** 领取方式 */
+    pickupMethod: string;
+    /** 预订状态 */
+    status: 'pending' | 'confirmed' | 'completed' | 'cancelled';
+    /** 预订ID列表 */
+    bookingIds?: number[];
+}
+/**
+ * 用户购物车历史记录
+ */
+interface CartHistory {
+    /** 历史记录列表 */
+    records: CartHistoryItem[];
+    /** 总记录数 */
+    totalRecords: number;
+}
+/**
+ * 添加到购物车请求数据
+ */
+interface AddToCartRequest {
+    /** 画集ID */
+    collectionId: number;
+    /** 数量 */
+    quantity: number;
+}
+/**
+ * 更新购物车项请求数据
+ */
+interface UpdateCartItemRequest {
+    /** 画集ID */
+    collectionId: number;
+    /** 新数量 */
+    quantity: number;
+}
+/**
+ * 从购物车移除请求数据
+ */
+interface RemoveFromCartRequest {
+    /** 画集ID */
+    collectionId: number;
+}
+/**
+ * 清空购物车请求数据
+ */
+interface ClearCartRequest {
+}
+/**
+ * 购物车操作类型
+ */
+type CartAction = {
+    type: 'ADD_ITEM';
+    payload: CartItem;
+} | {
+    type: 'UPDATE_ITEM';
+    payload: {
+        collectionId: number;
+        quantity: number;
+    };
+} | {
+    type: 'REMOVE_ITEM';
+    payload: number;
+} | {
+    type: 'CLEAR_CART';
+} | {
+    type: 'SET_CART';
+    payload: Cart;
+};
+/**
+ * 购物车状态
+ */
+interface CartState {
+    /** 购物车数据 */
+    cart: Cart;
+    /** 加载状态 */
+    loading: boolean;
+    /** 错误信息 */
+    error?: string;
+    /** 是否显示购物车弹窗 */
+    isCartOpen: boolean;
+}
+/**
+ * 批量预订请求数据
+ */
+interface BatchBookingRequest {
+    /** 用户QQ号 */
+    qqNumber: string;
+    /** 用户手机号 */
+    phoneNumber: string;
+    /** 预订项列表 */
+    items: {
+        /** 画集ID */
+        collectionId: number;
+        /** 数量 */
+        quantity: number;
+    }[];
+    /** 备注信息 */
+    notes?: string;
+    /** 领取方式 */
+    pickupMethod: string;
+}
+/**
+ * 批量预订响应数据
+ */
+interface BatchBookingResponse {
+    /** 预订ID列表 */
+    bookingIds: number[];
+    /** 成功预订数量 */
+    successCount: number;
+    /** 失败预订数量 */
+    failCount: number;
+    /** 失败原因 */
+    failures?: {
+        collectionId: number;
+        reason: string;
+    }[];
+}
+
+/**
+ * ShowMasterpiece 模块 - 上下文类型定义
+ *
+ * 这个文件定义了ShowMasterpiece模块中所有上下文相关的TypeScript类型。
+ * 将类型定义独立出来可以避免循环依赖问题。
+ *
+ * @fileoverview 上下文类型定义
+ */
+
+/**
+ * 购物车上下文状态接口
+ */
+interface CartContextState {
+    /** 购物车数据 */
+    cart: Cart;
+    /** 加载状态 */
+    loading: boolean;
+    /** 错误信息 */
+    error: string | undefined;
+    /** 刷新购物车数据 */
+    refreshCart: () => Promise<void>;
+    /** 添加商品到购物车（活动感知） */
+    addToCart: (request: AddToCartRequest & {
+        collection?: any;
+    }) => Promise<void>;
+    /** 更新购物车商品数量（活动感知） */
+    updateCartItem: (request: UpdateCartItemRequest) => Promise<void>;
+    /** 从购物车移除商品（活动感知） */
+    removeFromCart: (request: RemoveFromCartRequest) => Promise<void>;
+    /** 批量预订购物车商品（活动感知） */
+    batchBooking: (request: BatchBookingRequest) => Promise<BatchBookingResponse>;
+    /** 清空购物车（活动感知） */
+    clearCart: () => Promise<void>;
+}
+
+/**
+ * ShowMasterpiece 模块类型定义
+ *
+ * 包含画集、作品、配置等相关的TypeScript类型定义
+ */
+/**
+ * 画集分类枚举
+ *
+ * 定义画集的各种分类：
+ * - COLLECTION: 画集 - 用于展示艺术作品
+ * - ACRYLIC: 立牌 - 立牌制品
+ * - BADGE: 吧唧 - 徽章类商品
+ * - COLOR_PAPER: 色纸 - 彩色纸张制品
+ * - POSTCARD: 明信片 - 明信片类商品
+ * - LASER_TICKET: 镭射票 - 镭射票类商品
+ * - CANVAS_BAG: 帆布包 - 帆布包类商品
+ * - SUPPORT_STICK: 应援棒 - 应援棒类商品
+ * - OTHER: 挂件/钥匙扣 - 挂件/钥匙扣类商品
+ */
+declare enum CollectionCategory {
+    /** 画集 - 用于展示艺术作品 */
+    COLLECTION = "collection",
+    /** 立牌 - 立牌制品 */
+    ACRYLIC = "acrylic",
+    /** 吧唧 - 徽章类商品 */
+    BADGE = "badge",
+    /** 色纸 - 彩色纸张制品 */
+    COLOR_PAPER = "color_paper",
+    /** 透卡 - 透明卡片制品 */
+    TRANSPARENT_CARD = "transparent_card",
+    /** 明信片 - 明信片类商品 */
+    POSTCARD = "postcard",
+    /** 镭射票 - 镭射票类商品 */
+    LASER_TICKET = "laser_ticket",
+    /** 帆布包 - 帆布包类商品 */
+    CANVAS_BAG = "canvas_bag",
+    /** 线圈笔记本 - 线圈装订笔记本 */
+    SPIRAL_NOTEBOOK = "spiral_notebook",
+    /** 鼠标垫 - 鼠标垫类商品 */
+    MOUSE_PAD = "mouse_pad",
+    /** 应援棒 - 应援棒类商品 */
+    SUPPORT_STICK = "support_stick",
+    /** 挂件/钥匙扣 - 挂件/钥匙扣类商品 */
+    KEYCHAIN = "keychain",
+    /** 其它 */
+    OTHER = "other"
+}
+/**
+ * 画集分类类型
+ * 使用枚举值作为类型
+ */
+type CollectionCategoryType = `${CollectionCategory}` | string;
+/**
+ * 分类信息接口
+ * 包含分类值和显示名称
+ */
+interface CategoryInfo {
+    /** 分类值 */
+    value: CollectionCategoryType;
+    /** 显示名称 */
+    displayName: string;
+    /** 描述信息 */
+    description?: string;
+}
+/**
+ * 艺术作品页面数据结构
+ *
+ * 表示画集中的单个作品页面，包含图片、标题、描述等信息。
+ * 每个画集包含多个这样的作品页面。
+ */
+interface ArtworkPage {
+    /** 作品的唯一标识符 */
+    id: number;
+    /** 作品标题 */
+    title: string;
+    /** 编号 */
+    number: string;
+    /** 作品图片（支持URL或base64编码） */
+    image: string;
+    /** 通用文件服务的图片文件ID（新架构，可选） */
+    fileId?: string;
+    /** 作品描述 */
+    description: string;
+    /** 创作时间（可选） */
+    createdTime?: string;
+    /** 作品主题（可选） */
+    theme?: string;
+    /** 作品年份（可选） */
+    year?: string;
+    /** 创作媒介（可选） */
+    medium?: string;
+    /** 作品尺寸（可选） */
+    dimensions?: string;
+    /** 在画集中的显示顺序 */
+    pageOrder: number;
+    /** 是否激活（可选，默认true） */
+    isActive?: boolean;
+    /** 创建时间（可选） */
+    createdAt?: string;
+    /** 更新时间（可选） */
+    updatedAt?: string;
+}
+/**
+ * 艺术画集数据结构
+ *
+ * 表示一个完整的艺术画集，包含多个作品页面和相关元数据。
+ * 这是系统中的核心数据模型之一。
+ */
+interface ArtCollection {
+    /** 画集的唯一标识符 */
+    id: number;
+    /** 画集标题 */
+    title: string;
+    /** 编号 */
+    number: string;
+    /** 画集封面图片路径 */
+    coverImage: string;
+    /** 通用文件服务的封面图片文件ID（新架构，可选） */
+    coverImageFileId?: string;
+    /** 画集描述 */
+    description: string;
+    /** 画集包含的所有作品页面 */
+    pages: ArtworkPage[];
+    /** 画集分类（使用枚举值） */
+    category: CollectionCategoryType;
+    /** 画集标签列表（可选） */
+    tags?: string[];
+    /** 是否已发布（可选，默认true） */
+    isPublished?: boolean;
+    /** 画集价格（单位：元，可选） */
+    price?: number;
+    /** 创建时间（可选） */
+    createdAt?: string;
+    /** 更新时间（可选） */
+    updatedAt?: string;
+}
+/**
+ * 系统配置数据结构
+ *
+ * 存储ShowMasterpiece模块的全局配置信息，
+ * 包括网站设置、显示选项、功能开关等。
+ */
+interface MasterpiecesConfig {
+    /** 网站名称 */
+    siteName: string;
+    /** 网站描述 */
+    siteDescription?: string;
+    /** 首页主标题 */
+    heroTitle: string;
+    /** 首页副标题 */
+    heroSubtitle?: string;
+    /** 每页显示的最大画集数量 */
+    maxCollectionsPerPage: number;
+    /** 是否启用搜索功能 */
+    enableSearch: boolean;
+    /** 是否启用分类功能 */
+    enableCategories: boolean;
+    /** 首页分类Tab配置 */
+    homeTabConfig: HomeTabConfigItem[];
+    /** 默认分类 */
+    defaultCategory: string;
+    /** 主题模式：light(浅色)、dark(深色)、auto(自动) */
+    theme: 'light' | 'dark' | 'auto';
+    /** 界面语言：zh(中文)、en(英文) */
+    language: 'zh' | 'en';
+}
+interface HomeTabConfigItem {
+    category: CollectionCategoryType;
+    visible: boolean;
+    order: number;
+}
+/**
+ * 画集表单数据结构
+ *
+ * 用于创建和编辑画集时的表单数据
+ */
+interface CollectionFormData {
+    /** 画集标题 */
+    title: string;
+    /** 编号 */
+    number: string;
+    /** 封面图片 */
+    coverImage: string;
+    /** 通用文件服务的封面图片文件ID */
+    coverImageFileId?: string;
+    /** 画集描述 */
+    description: string;
+    /** 画集分类（使用枚举值） */
+    category: CollectionCategoryType;
+    /** 画集标签列表 */
+    tags: string[];
+    /** 是否已发布 */
+    isPublished: boolean;
+    /** 画集价格（单位：元，可选） */
+    price?: number;
+}
+/**
+ * 作品表单数据结构
+ *
+ * 用于创建和编辑作品时的表单数据
+ */
+interface ArtworkFormData {
+    /** 作品标题 */
+    title: string;
+    /** 编号 */
+    number: string;
+    /** 作品图片 */
+    image?: string;
+    /** 通用文件服务的图片文件ID */
+    fileId?: string;
+    /** 作品描述 */
+    description: string;
+    /** 创作时间 */
+    createdTime: string;
+    /** 作品主题 */
+    theme: string;
+}
+/**
+ * 获取所有可用的画集分类
+ *
+ * @returns 分类枚举值数组
+ */
+declare function getAvailableCategories(): CollectionCategoryType[];
+/**
+ * 验证分类是否为有效值
+ *
+ * @param category - 要验证的分类值
+ * @returns 是否为有效分类
+ */
+declare function isValidCategory(category: string): category is CollectionCategoryType;
+/**
+ * 扩展 CollectionCategoryType，使其支持 displayName 属性访问
+ * 使用方式: collection.category.displayName
+ */
+declare global {
+    interface String {
+        get displayName(): string;
+        get categoryInfo(): CategoryInfo;
+    }
+}
+
+/**
+ * 画集卡片组件 (CollectionCard) - Tailwind CSS 版本
+ *
+ * 这是一个用于展示单个画集信息的卡片组件，主要用于画集列表页面。
+ *
+ * 主要功能：
+ * - 画集封面图片展示（支持懒加载）
+ * - 画集基本信息显示（标题、编号、分类、描述等）
+ * - 作品页数统计显示
+ * - 点击进入画集浏览
+ *
+ * 性能优化特性：
+ * - 图片懒加载（Intersection Observer API）
+ * - 加载状态和错误处理
+ * - Tailwind CSS 样式
+ *
+ * @component
+ */
+
+/**
+ * CollectionCard 组件的 Props 接口
+ */
+interface CollectionCardProps {
+    /** 要展示的画集数据 */
+    collection: ArtCollection;
+    /** 用户ID */
+    userId: number;
+    /** 用户选择画集时的回调函数 */
+    onSelect: (collection: ArtCollection) => void;
+}
+/**
+ * 画集卡片组件主体
+ *
+ * @param props - 组件属性
+ * @param props.collection - 画集数据对象
+ * @param props.userId - 用户ID
+ * @param props.onSelect - 选择画集的回调函数
+ * @returns React函数组件
+ */
+declare const CollectionCard: React__default.FC<CollectionCardProps>;
+
+interface ArtworkViewerProps {
+    artwork: ArtworkPage;
+    collectionId: number;
+    onNext: () => void;
+    onPrev: () => void;
+    canGoNext: boolean;
+    canGoPrev: boolean;
+}
+declare const ArtworkViewer: React__default.FC<ArtworkViewerProps>;
+
+interface MobileAlbumViewerProps {
+    artworks: ArtworkPage[];
+    collectionId: number;
+    currentIndex: number;
+    onIndexChange: (index: number) => void;
+    onNext: () => void;
+    onPrev: () => void;
+    canGoNext: boolean;
+    canGoPrev: boolean;
+}
+declare const MobileAlbumViewer: React__default.FC<MobileAlbumViewerProps>;
+
+interface ThumbnailSidebarProps {
+    pages: ArtworkPage[];
+    currentPage: number;
+    onPageSelect: (pageIndex: number) => void;
+}
+declare const ThumbnailSidebar: React__default.FC<ThumbnailSidebarProps>;
+
+interface CollectionOrderManagerV2Props {
+    onOrderChanged?: () => void;
+    moveCollectionUp?: (id: number) => Promise<void>;
+    moveCollectionDown?: (id: number) => Promise<void>;
+    updateCollectionOrder?: (orders: {
+        id: number;
+        displayOrder: number;
+    }[]) => Promise<void>;
+}
+declare function CollectionOrderManagerV2({ onOrderChanged, moveCollectionUp: propMoveCollectionUp, moveCollectionDown: propMoveCollectionDown, updateCollectionOrder: propUpdateCollectionOrder }: CollectionOrderManagerV2Props): React__default.JSX.Element;
+
+interface ArtworkOrderManagerV2Props {
+    collectionId: number;
+    onOrderChanged?: () => void;
+    moveArtworkUp?: (collectionId: number, id: number) => Promise<void>;
+    moveArtworkDown?: (collectionId: number, id: number) => Promise<void>;
+    updateArtworkOrder?: (collectionId: number, orders: {
+        id: number;
+        pageOrder: number;
+    }[]) => Promise<void>;
+}
+declare function ArtworkOrderManagerV2({ collectionId, onOrderChanged, moveArtworkUp: propMoveArtworkUp, moveArtworkDown: propMoveArtworkDown, updateArtworkOrder: propUpdateArtworkOrder }: ArtworkOrderManagerV2Props): React__default.JSX.Element;
+
+/**
+ * 通用图片上传组件
+ * 使用通用文件服务，支持阿里云OSS存储
+ * 可在画集封面和作品图片之间复用
+ *
+ * 修复记录：
+ * - 2026-01-19: 修复封面图片上传覆盖问题
+ *   为封面图片生成唯一文件夹路径（包含时间戳和随机ID），避免新画集覆盖历史画集的封面图片
+ * - 2026-01-19: 修复图片链接过期问题
+ *   为封面图片路径添加文件扩展名，确保被正确识别为图片文件，避免生成带过期时间的签名URL
+ */
+
+interface UniversalImageUploadProps {
+    /** 当前图片值（URL） */
+    value?: string;
+    /** 通用文件服务的文件ID */
+    fileId?: string;
+    /** 值变化回调，返回包含image和fileId的对象 */
+    onChange: (data: {
+        image?: string;
+        fileId?: string;
+    }) => void;
+    /** 占位符文本 */
+    placeholder?: string;
+    /** 标签文本 */
+    label?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 业务类型：cover(封面) 或 artwork(作品) */
+    businessType?: 'cover' | 'artwork';
+    /** 是否显示调试信息 */
+    showDebugInfo?: boolean;
+    /** 是否显示测试按钮 */
+    showTestButton?: boolean;
+    /** 自定义样式类名 */
+    className?: string;
+}
+declare const UniversalImageUpload: React__default.FC<UniversalImageUploadProps>;
+
+/**
+ * ShowMasterpiece 模块 - 购物车弹窗组件
+ *
+ * @fileoverview 购物车弹窗组件
+ */
+
+/**
+ * 购物车弹窗组件属性
+ */
+interface CartModalProps {
+    /** 用户ID */
+    userId: number;
+    /** 是否显示弹窗 */
+    isOpen: boolean;
+    /** 关闭弹窗回调 */
+    onClose: () => void;
+    /** 弹窗标题 */
+    title?: string;
+    /** 弹窗宽度 */
+    width?: number | string;
+    /** 弹窗高度 */
+    height?: number | string;
+}
+/**
+ * 购物车弹窗组件
+ *
+ * @param props 组件属性
+ * @returns React组件
+ */
+declare const CartModal: React__default.FC<CartModalProps>;
+
+/**
+ * ShowMasterpiece 模块 - 购物车页面组件
+ *
+ * 完整的购物车页面，包含：
+ * - 购物车商品列表展示
+ * - 商品数量调整
+ * - 商品移除功能
+ * - 批量预订表单
+ * - 提交和状态管理
+ *
+ * @fileoverview 购物车页面组件
+ */
+
+/**
+ * 购物车页面组件属性
+ */
+interface CartPageProps {
+    /** 用户ID */
+    userId: number;
+    /** 关闭回调 */
+    onClose?: () => void;
+}
+/**
+ * 购物车页面组件
+ *
+ * @param props 组件属性
+ * @returns React组件
+ */
+declare const CartPage: React__default.FC<CartPageProps>;
+
+/**
+ * ShowMasterpiece 模块 - 购物车按钮组件
+ *
+ * 显示购物车图标和商品数量的按钮组件，点击可打开购物车弹窗
+ *
+ * @fileoverview 购物车按钮组件
+ */
+
+/**
+ * 购物车按钮组件属性
+ */
+interface CartButtonProps {
+    /** 用户ID */
+    userId: number;
+    /** 点击回调 */
+    onClick: () => void;
+    /** 按钮样式类名 */
+    className?: string;
+    /** 是否显示商品数量 */
+    showBadge?: boolean;
+}
+/**
+ * 购物车按钮组件
+ *
+ * @param props 组件属性
+ * @returns React组件
+ */
+declare const CartButton: React__default.FC<CartButtonProps>;
+
+/**
+ * ShowMasterpiece 模块 - 添加到购物车按钮组件
+ *
+ * 用于将画集添加到购物车的按钮组件
+ *
+ * @fileoverview 添加到购物车按钮组件
+ */
+
+/**
+ * 添加到购物车按钮组件属性
+ */
+interface AddToCartButtonProps {
+    /** 画集信息 */
+    collection: ArtCollection;
+    /** 用户ID */
+    userId: number;
+    /** 按钮样式类名 */
+    className?: string;
+    /** 按钮大小 */
+    size?: 'sm' | 'md' | 'lg';
+    /** 是否显示数量选择器 */
+    showQuantitySelector?: boolean;
+}
+/**
+ * 添加到购物车按钮组件
+ *
+ * @param props 组件属性
+ * @returns React组件
+ */
+declare const AddToCartButton: React__default.FC<AddToCartButtonProps>;
+
+/**
+ * ShowMasterpiece 模块 - 预订功能类型定义
+ *
+ * 定义了画集预订功能相关的TypeScript类型，包括：
+ * - 预订数据模型
+ * - API请求和响应类型
+ * - 表单数据类型
+ * - 状态枚举
+ *
+ * @fileoverview 预订功能类型定义
+ */
+
+/**
+ * 预订状态枚举
+ */
+type BookingStatus = 'pending' | 'confirmed' | 'completed' | 'cancelled';
+/**
+ * 预订数据模型
+ */
+interface Booking {
+    /** 预订ID */
+    id: number;
+    /** 画集ID */
+    collectionId: number;
+    /** 用户QQ号 */
+    qqNumber: string;
+    /** 用户手机号 */
+    phoneNumber?: string;
+    /** 预订数量 */
+    quantity: number;
+    /** 预订状态 */
+    status: BookingStatus;
+    /** 预订备注 */
+    notes?: string;
+    /** 管理员备注 */
+    adminNotes?: string;
+    /** 预订时间 */
+    createdAt: string;
+    /** 更新时间 */
+    updatedAt: string;
+    /** 确认时间 */
+    confirmedAt?: string;
+    /** 完成时间 */
+    completedAt?: string;
+    /** 取消时间 */
+    cancelledAt?: string;
+    /** 关联的画集信息 */
+    collection?: ArtCollection;
+}
+/**
+ * 创建预订请求数据
+ */
+interface CreateBookingRequest {
+    /** 画集ID */
+    collectionId: number;
+    /** 用户QQ号 */
+    qqNumber: string;
+    /** 用户手机号 */
+    phoneNumber: string;
+    /** 预订数量 */
+    quantity: number;
+    /** 预订备注 */
+    notes?: string;
+}
+/**
+ * 更新预订请求数据
+ */
+interface UpdateBookingRequest {
+    /** 预订状态 */
+    status?: BookingStatus;
+    /** 管理员备注 */
+    adminNotes?: string;
+}
+/**
+ * 预订列表查询参数
+ */
+interface BookingListParams {
+    /** 画集ID过滤 */
+    collectionId?: number;
+    /** QQ号过滤 */
+    qqNumber?: string;
+    /** 手机号过滤 */
+    phoneNumber?: string;
+    /** 状态过滤 */
+    status?: BookingStatus;
+    /** 页码 */
+    page?: number;
+    /** 每页数量 */
+    limit?: number;
+}
+/**
+ * 预订列表响应
+ */
+interface BookingListResponse {
+    /** 预订列表 */
+    bookings: Booking[];
+    /** 总数 */
+    total: number;
+    /** 当前页 */
+    page: number;
+    /** 每页数量 */
+    limit: number;
+    /** 总页数 */
+    totalPages: number;
+}
+/**
+ * 预订表单数据
+ */
+interface BookingFormData {
+    /** 画集ID */
+    collectionId: number;
+    /** 用户QQ号 */
+    qqNumber: string;
+    /** 用户手机号 */
+    phoneNumber: string;
+    /** 预订数量 */
+    quantity: number;
+    /** 预订备注 */
+    notes: string;
+}
+/**
+ * 画集简略信息（用于预订页面展示）
+ */
+interface CollectionSummary {
+    /** 画集ID */
+    id: number;
+    /** 画集标题 */
+    title: string;
+    /** 编号 */
+    number: string;
+    /** 封面图片 */
+    coverImage: string;
+    /** 价格（单位：元） */
+    price?: number;
+    /** 画集描述 */
+    description?: string;
+}
+
+/**
+ * ShowMasterpiece 模块 - 画集列表组件
+ *
+ * 用于预订页面展示画集简略信息，包括：
+ * - 画集封面和标题
+ * - 艺术家信息
+ * - 价格显示
+ * - 选择功能
+ *
+ * @fileoverview 画集列表组件
+ */
+
+/**
+ * 画集列表组件属性
+ */
+interface CollectionListProps {
+    /** 画集列表 */
+    collections: CollectionSummary[];
+    /** 当前选中的画集ID */
+    selectedCollectionId?: number;
+    /** 选择画集回调 */
+    onSelectCollection?: (collectionId: number) => void;
+    /** 加载状态 */
+    loading?: boolean;
+    /** 是否禁用选择 */
+    disabled?: boolean;
+}
+/**
+ * 画集列表组件
+ *
+ * @param props 组件属性
+ * @returns React组件
+ */
+declare const CollectionList: React__default.FC<CollectionListProps>;
+
+/**
+ * MasterpiecesService - 美术作品前端API服务
+ *
+ * 这个文件提供了客户端与美术作品相关API的通信接口。
+ * 主要用于前端组件和Hook中调用后端API，获取和操作画集数据。
+ *
+ * 主要功能：
+ * - 画集数据的获取和查询
+ * - 搜索和筛选功能
+ * - 分类和标签管理
+ * - 推荐算法
+ *
+ * 设计特点：
+ * - 使用静态方法，无需实例化
+ * - 统一的错误处理
+ * - 支持多种查询方式
+ * - TypeScript类型安全
+ *
+ * @module MasterpiecesService
+ */
+
+/**
+ * 获取美术作品画集列表（函数式API）
+ *
+ * 这是一个简单的函数式接口，用于获取所有画集数据。
+ * 主要为了保持向后兼容性而保留。
+ *
+ * @returns Promise<ArtCollection[]> 画集数组
+ * @throws {Error} 当API请求失败时抛出错误
+ *
+ * @deprecated 建议使用 MasterpiecesService.getAllCollections() 代替
+ */
+declare const getMasterpieces: () => Promise<ArtCollection[]>;
+/**
+ * 美术作品服务类
+ *
+ * 提供完整的美术作品数据访问接口，包括画集的获取、搜索、筛选等功能。
+ * 所有方法都是静态方法，可以直接调用，无需实例化。
+ *
+ * @example
+ * ```typescript
+ * // 获取所有画集
+ * const collections = await MasterpiecesService.getAllCollections();
+ *
+ * // 搜索画集
+ * const results = await MasterpiecesService.searchCollections('油画');
+ *
+ * // 按分类获取
+ * const paintings = await MasterpiecesService.getCollectionsByCategory('油画');
+ * ```
+ */
+declare class MasterpiecesService {
+    /**
+     * 获取所有画集
+     *
+     * 从后端API获取所有可用的画集数据。
+     * 返回的数据包含完整的画集信息和作品页面。
+     *
+     * @returns Promise<ArtCollection[]> 所有画集的数组
+     * @throws {Error} 当API请求失败时抛出错误
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const collections = await MasterpiecesService.getAllCollections();
+     *   console.log(`共加载了 ${collections.length} 个画集`);
+     * } catch (error) {
+     *   console.error('加载失败:', error.message);
+     * }
+     * ```
+     */
+    static getAllCollections(): Promise<ArtCollection[]>;
+    /**
+     * 根据ID获取特定画集
+     *
+     * 通过画集ID获取单个画集的详细信息。
+     * 内部实现是先获取所有画集，然后筛选出指定ID的画集。
+     *
+     * @param id - 画集的唯一标识符
+     * @returns Promise<ArtCollection | null> 找到的画集对象，如果不存在则返回null
+     *
+     * @example
+     * ```typescript
+     * const collection = await MasterpiecesService.getCollectionById(1);
+     * if (collection) {
+     *   console.log(`找到画集: ${collection.title}`);
+     * } else {
+     *   console.log('画集不存在');
+     * }
+     * ```
+     */
+    static getCollectionById(id: number): Promise<ArtCollection | null>;
+    /**
+     * 搜索画集
+     *
+     * 根据关键词在画集的多个字段中进行搜索，包括：
+     * - 画集标题
+     * - 艺术家姓名
+     * - 画集描述
+     * - 画集分类
+     * - 画集标签
+     *
+     * 搜索是大小写不敏感的，支持部分匹配。
+     *
+     * @param query - 搜索关键词
+     * @returns Promise<ArtCollection[]> 匹配的画集数组
+     *
+     * @example
+     * ```typescript
+     * // 搜索包含"山水"的画集
+     * const results = await MasterpiecesService.searchCollections('山水');
+     * console.log(`找到 ${results.length} 个相关画集`);
+     * ```
+     */
+    static searchCollections(query: string): Promise<ArtCollection[]>;
+    /**
+     * 根据分类获取画集
+     *
+     * 获取属于指定分类的所有画集。
+     * 支持特殊值 'all' 来获取所有画集。
+     *
+     * @param category - 分类名称，或 'all' 表示所有分类
+     * @returns Promise<ArtCollection[]> 该分类下的画集数组
+     *
+     * @example
+     * ```typescript
+     * // 获取油画分类的画集
+     * const paintings = await MasterpiecesService.getCollectionsByCategory('油画');
+     *
+     * // 获取所有画集
+     * const allCollections = await MasterpiecesService.getCollectionsByCategory('all');
+     * ```
+     */
+    static getCollectionsByCategory(category: string): Promise<ArtCollection[]>;
+    /**
+     * 获取推荐画集
+     *
+     * 基于简单的推荐算法获取推荐的画集。
+     * 当前算法：优先选择已发布的画集，按作品数量降序排列。
+     *
+     * @param limit - 返回的推荐画集数量，默认为3个
+     * @returns Promise<ArtCollection[]> 推荐的画集数组
+     *
+     * @example
+     * ```typescript
+     * // 获取3个推荐画集
+     * const recommended = await MasterpiecesService.getRecommendedCollections();
+     *
+     * // 获取5个推荐画集
+     * const moreRecommended = await MasterpiecesService.getRecommendedCollections(5);
+     * ```
+     */
+    static getRecommendedCollections(limit?: number): Promise<ArtCollection[]>;
+    /**
+     * 获取所有可用分类
+     *
+     * 从后端API获取所有已定义的画集分类列表。
+     * 用于构建分类筛选器和下拉菜单。
+     *
+     * @returns Promise<string[]> 分类名称数组
+     * @throws {Error} 当API请求失败时抛出错误
+     *
+     * @example
+     * ```typescript
+     * const categories = await MasterpiecesService.getCategories();
+     * console.log('可用分类:', categories);
+     * ```
+     */
+    static getCategories(): Promise<string[]>;
+    /**
+     * 获取所有可用标签
+     *
+     * 从后端API获取所有已定义的画集标签列表。
+     * 用于构建标签筛选器和标签云。
+     *
+     * @returns Promise<string[]> 标签名称数组
+     * @throws {Error} 当API请求失败时抛出错误
+     *
+     * @example
+     * ```typescript
+     * const tags = await MasterpiecesService.getTags();
+     * console.log('可用标签:', tags);
+     * ```
+     */
+    static getTags(): Promise<string[]>;
+}
+
+declare const getConfig: () => Promise<MasterpiecesConfig>;
+declare const updateConfig: (configData: Partial<MasterpiecesConfig>) => Promise<MasterpiecesConfig>;
+declare const resetConfig: () => Promise<MasterpiecesConfig>;
+declare const getAllCollections: () => Promise<ArtCollection[]>;
+declare const createCollection: (collectionData: CollectionFormData) => Promise<ArtCollection>;
+declare const updateCollection: (id: number, collectionData: CollectionFormData) => Promise<ArtCollection>;
+declare const deleteCollection: (id: number) => Promise<void>;
+declare const updateCollectionOrder: (collectionOrders: {
+    id: number;
+    displayOrder: number;
+}[]) => Promise<void>;
+declare const moveCollection: (collectionId: number, targetOrder: number) => Promise<void>;
+declare const moveCollectionUp: (collectionId: number) => Promise<void>;
+declare const moveCollectionDown: (collectionId: number) => Promise<void>;
+declare const addArtworkToCollection: (collectionId: number, artworkData: ArtworkFormData) => Promise<ArtworkPage>;
+declare const updateArtwork: (collectionId: number, artworkId: number, artworkData: ArtworkFormData) => Promise<ArtworkPage>;
+declare const deleteArtwork: (collectionId: number, artworkId: number) => Promise<void>;
+declare const getArtworksByCollection: (collectionId: number) => Promise<(ArtworkPage & {
+    pageOrder: number;
+})[]>;
+declare const updateArtworkOrder: (collectionId: number, artworkOrders: {
+    id: number;
+    pageOrder: number;
+}[]) => Promise<void>;
+declare const moveArtwork: (collectionId: number, artworkId: number, targetOrder: number) => Promise<void>;
+declare const moveArtworkUp: (collectionId: number, artworkId: number) => Promise<void>;
+declare const moveArtworkDown: (collectionId: number, artworkId: number) => Promise<void>;
+declare const getCategories: () => Promise<string[]>;
+declare const createCategory: (name: string, description?: string) => Promise<void>;
+declare const getTags: () => Promise<string[]>;
+declare function getCollectionsOverview(): Promise<Omit<ArtCollection, 'pages'>[]>;
+
+/**
+ * ShowMasterpiece 模块 - 购物车服务
+ *
+ * 提供购物车功能的前端本地存储服务，包括：
+ * - 添加商品到购物车
+ * - 更新购物车商品数量
+ * - 从购物车移除商品
+ * - 清空购物车
+ * - 批量预订
+ *
+ * @fileoverview 购物车服务 - 本地存储版本
+ */
+
+/**
+ * 购物车服务类
+ *
+ * 提供购物车功能相关的本地存储操作方法
+ */
+declare class CartService {
+    private static readonly BOOKING_URL;
+    /**
+     * 获取购物车数据
+     *
+     * @param userId 用户ID
+     * @returns 购物车数据
+     */
+    static getCart(userId: number): Promise<Cart>;
+    /**
+     * 保存购物车数据到本地存储
+     *
+     * @param userId 用户ID
+     * @param cart 购物车数据
+     */
+    private static saveCart;
+    /**
+     * 计算购物车总数量和总价格
+     *
+     * @param items 购物车商品项
+     * @returns 总数量和总价格
+     */
+    private static calculateTotals;
+    /**
+     * 添加商品到购物车
+     *
+     * @param data 添加商品数据
+     * @returns 更新后的购物车数据
+     */
+    static addToCart(data: AddToCartRequest & {
+        userId: number;
+        collection?: any;
+    }): Promise<Cart>;
+    /**
+     * 更新购物车商品数量
+     *
+     * @param data 更新商品数据
+     * @returns 更新后的购物车数据
+     */
+    static updateCartItem(data: UpdateCartItemRequest & {
+        userId: number;
+    }): Promise<Cart>;
+    /**
+     * 从购物车移除商品
+     *
+     * @param data 移除商品数据
+     * @returns 更新后的购物车数据
+     */
+    static removeFromCart(data: RemoveFromCartRequest & {
+        userId: number;
+    }): Promise<Cart>;
+    /**
+     * 清空购物车
+     *
+     * @param userId 用户ID
+     * @returns 清空后的购物车数据
+     */
+    static clearCart(userId: number): Promise<Cart>;
+    /**
+     * 批量预订购物车中的商品
+     *
+     * @param data 批量预订数据
+     * @param cart 当前购物车数据（用于保存历史记录）
+     * @returns 预订结果
+     */
+    static batchBooking(data: BatchBookingRequest, cart?: Cart): Promise<BatchBookingResponse>;
+}
+/**
+ * 购物车服务函数集
+ *
+ * 提供函数式的API调用接口，作为服务类的补充。
+ */
+/**
+ * 获取购物车数据
+ *
+ * @param userId 用户ID
+ * @returns 购物车数据
+ */
+declare const getCart: (userId: number) => Promise<Cart>;
+/**
+ * 添加商品到购物车
+ *
+ * @param data 添加商品数据
+ * @returns 更新后的购物车数据
+ */
+declare const addToCart: (data: AddToCartRequest & {
+    userId: number;
+}) => Promise<Cart>;
+/**
+ * 更新购物车商品数量
+ *
+ * @param data 更新商品数据
+ * @returns 更新后的购物车数据
+ */
+declare const updateCartItem: (data: UpdateCartItemRequest & {
+    userId: number;
+}) => Promise<Cart>;
+/**
+ * 从购物车移除商品
+ *
+ * @param data 移除商品数据
+ * @returns 更新后的购物车数据
+ */
+declare const removeFromCart: (data: RemoveFromCartRequest & {
+    userId: number;
+}) => Promise<Cart>;
+/**
+ * 清空购物车
+ *
+ * @param userId 用户ID
+ * @returns 清空后的购物车数据
+ */
+declare const clearCart: (userId: number) => Promise<Cart>;
+/**
+ * 批量预订购物车中的商品
+ *
+ * @param data 批量预订数据
+ * @param cart 当前购物车数据（用于保存历史记录）
+ * @returns 预订结果
+ */
+declare const batchBooking: (data: BatchBookingRequest, cart?: Cart) => Promise<BatchBookingResponse>;
+
+/**
+ * ShowMasterpiece 模块 - 预订服务
+ *
+ * 提供画集预订功能的前端API调用服务，包括：
+ * - 创建预订
+ * - 查询预订列表
+ * - 更新预订状态
+ * - 获取画集简略信息
+ *
+ * @fileoverview 预订服务
+ */
+
+/**
+ * 预订服务类
+ *
+ * 提供预订功能相关的API调用方法，使用面向对象的方式封装HTTP请求。
+ */
+declare class BookingService {
+    private static readonly BASE_URL;
+    /**
+     * 创建新预订
+     *
+     * @param data 预订数据
+     * @returns 创建的预订信息
+     */
+    static createBooking(data: CreateBookingRequest): Promise<Booking>;
+    /**
+     * 获取预订列表
+     *
+     * @param params 查询参数
+     * @returns 预订列表和分页信息
+     */
+    static getBookings(params?: BookingListParams): Promise<BookingListResponse>;
+    /**
+     * 获取单个预订详情
+     *
+     * @param id 预订ID
+     * @returns 预订详情
+     */
+    static getBooking(id: number): Promise<Booking>;
+    /**
+     * 更新预订状态
+     *
+     * @param id 预订ID
+     * @param data 更新数据
+     * @returns 更新后的预订信息
+     */
+    static updateBooking(id: number, data: UpdateBookingRequest): Promise<Booking>;
+    /**
+     * 删除预订
+     *
+     * @param id 预订ID
+     */
+    static deleteBooking(id: number): Promise<void>;
+    /**
+     * 获取可预订的画集列表
+     *
+     * @returns 画集简略信息列表
+     */
+    static getBookableCollections(): Promise<CollectionSummary[]>;
+}
+/**
+ * 预订服务函数集
+ *
+ * 提供函数式的API调用接口，作为服务类的补充。
+ */
+/**
+ * 创建新预订
+ *
+ * @param data 预订数据
+ * @returns 创建的预订信息
+ */
+declare const createBooking: (data: CreateBookingRequest) => Promise<Booking>;
+/**
+ * 获取预订列表
+ *
+ * @param params 查询参数
+ * @returns 预订列表和分页信息
+ */
+declare const getBookings: (params?: BookingListParams) => Promise<BookingListResponse>;
+/**
+ * 获取单个预订详情
+ *
+ * @param id 预订ID
+ * @returns 预订详情
+ */
+declare const getBooking: (id: number) => Promise<Booking>;
+/**
+ * 更新预订状态
+ *
+ * @param id 预订ID
+ * @param data 更新数据
+ * @returns 更新后的预订信息
+ */
+declare const updateBooking: (id: number, data: UpdateBookingRequest) => Promise<Booking>;
+/**
+ * 删除预订
+ *
+ * @param id 预订ID
+ */
+declare const deleteBooking$1: (id: number) => Promise<void>;
+/**
+ * 获取可预订的画集列表
+ *
+ * @returns 画集简略信息列表
+ */
+declare const getBookableCollections: () => Promise<CollectionSummary[]>;
+
+/**
+ * ShowMasterpiece 模块 - 预订管理服务
+ *
+ * 提供预订管理相关的类型定义和服务函数
+ *
+ * @fileoverview 预订管理服务
+ */
+
+/**
+ * 预订管理数据接口
+ */
+interface BookingAdminData {
+    /** 预订ID */
+    id: number;
+    /** 用户ID */
+    userId: number;
+    /** 用户名 */
+    userName: string;
+    /** 用户手机号 */
+    userPhone: string;
+    /** QQ号 */
+    qqNumber?: string;
+    /** 手机号 */
+    phoneNumber?: string;
+    /** 画集ID */
+    collectionId: number;
+    /** 画集标题 */
+    collectionTitle: string;
+    /** 画集编号 */
+    collectionNumber: string;
+    /** 画集信息 */
+    collection: {
+        /** 画集ID */
+        id: number;
+        /** 画集标题 */
+        title: string;
+        /** 画集编号 */
+        number: string;
+        /** 封面图片 */
+        coverImage: string;
+        /** 价格 */
+        price: number;
+    };
+    /** 预订状态 */
+    status: BookingStatus;
+    /** 预订时间 */
+    bookingTime: string;
+    /** 更新时间 */
+    updatedAt: string;
+    /** 创建时间 */
+    createdAt: string;
+    /** 管理员备注 */
+    adminNotes?: string;
+    /** 用户备注 */
+    notes?: string;
+    /** 领取方式 */
+    pickupMethod?: string;
+    /** 数量 */
+    quantity: number;
+    /** 价格 */
+    price: number;
+    /** 总价格 */
+    totalPrice: number;
+    /** 确认时间 */
+    confirmedAt?: string;
+    /** 完成时间 */
+    completedAt?: string;
+    /** 取消时间 */
+    cancelledAt?: string;
+}
+/**
+ * 预订管理统计信息接口
+ */
+interface BookingAdminStats {
+    /** 总预订数 */
+    totalBookings: number;
+    /** 待处理预订数 */
+    pendingBookings: number;
+    /** 已确认预订数 */
+    confirmedBookings: number;
+    /** 已完成预订数 */
+    completedBookings: number;
+    /** 已取消预订数 */
+    cancelledBookings: number;
+    /** 总金额 */
+    totalAmount: number;
+    /** 总收入 */
+    totalRevenue: number;
+    /** 总数量 */
+    totalQuantity: number;
+    /** 今日新增预订数 */
+    todayBookings: number;
+    /** 本周新增预订数 */
+    weekBookings: number;
+}
+/**
+ * 预订管理接口响应类型
+ */
+interface BookingAdminResponse {
+    bookings: BookingAdminData[];
+    stats: BookingAdminStats;
+}
+/**
+ * 预订管理查询参数
+ */
+interface BookingAdminQueryParams {
+    /** QQ号搜索 */
+    qqNumber?: string;
+    /** 手机号搜索 */
+    phoneNumber?: string;
+    /** 状态过滤 */
+    status?: BookingStatus | 'all';
+}
+/**
+ * 预订管理服务类
+ */
+declare class BookingAdminService {
+    /**
+     * 获取所有预订数据
+     */
+    static getAllBookings(params?: BookingAdminQueryParams): Promise<BookingAdminData[]>;
+    /**
+     * 强制刷新获取所有预订数据（绕过所有缓存）
+     */
+    static forceRefreshAllBookings(params?: BookingAdminQueryParams): Promise<BookingAdminData[]>;
+    /**
+     * 获取预订统计信息
+     */
+    static getBookingStats(params?: BookingAdminQueryParams): Promise<BookingAdminStats>;
+    /**
+     * 强制刷新获取预订统计信息（绕过所有缓存）
+     */
+    static forceRefreshBookingStats(params?: BookingAdminQueryParams): Promise<BookingAdminStats>;
+    /**
+     * 更新预订状态
+     */
+    static updateBookingStatus(bookingId: number, status: BookingStatus, adminNotes?: string): Promise<void>;
+    /**
+     * 删除预订
+     */
+    static deleteBooking(bookingId: number): Promise<void>;
+    /**
+     * 导出预订数据
+     */
+    static exportBookings(format?: 'csv' | 'excel'): Promise<Blob>;
+}
+declare const getAllBookings: typeof BookingAdminService.getAllBookings;
+declare const getBookingStats: typeof BookingAdminService.getBookingStats;
+declare const forceRefreshAllBookings: typeof BookingAdminService.forceRefreshAllBookings;
+declare const forceRefreshBookingStats: typeof BookingAdminService.forceRefreshBookingStats;
+declare const updateBookingStatus$1: typeof BookingAdminService.updateBookingStatus;
+declare const deleteBooking: typeof BookingAdminService.deleteBooking;
+declare const exportBookings: typeof BookingAdminService.exportBookings;
+
+/**
+ * ShowMasterpiece 模块 - 购物车历史记录服务
+ *
+ * 提供用户购物车历史记录功能，包括：
+ * - 保存用户提交的购物车数据
+ * - 获取用户历史记录
+ * - 更新预订状态
+ * - 本地存储管理
+ *
+ * @fileoverview 购物车历史记录服务
+ */
+
+/**
+ * 购物车历史记录服务类
+ *
+ * 提供购物车历史记录相关的本地存储操作方法
+ */
+declare class CartHistoryService {
+    /**
+     * 生成唯一ID
+     */
+    /**
+     * 获取用户购物车历史记录
+     *
+     * @param qqNumber 用户QQ号
+     * @param phoneNumber 用户手机号
+     * @returns 购物车历史记录
+     */
+    static getCartHistory(qqNumber: string, phoneNumber: string): Promise<CartHistory>;
+    /**
+     * 保存购物车历史记录
+     *
+     * @param historyItem 历史记录项
+     */
+    static saveCartHistory(historyItem: Omit<CartHistoryItem, 'id'>): Promise<CartHistoryItem>;
+    /**
+     * 更新预订状态
+     *
+     * @param qqNumber 用户QQ号
+     * @param phoneNumber 用户手机号
+     * @param historyId 历史记录ID
+     * @param status 新状态
+     * @param bookingIds 预订ID列表
+     */
+    static updateBookingStatus(qqNumber: string, phoneNumber: string, historyId: string, status: CartHistoryItem['status'], bookingIds?: number[]): Promise<void>;
+    /**
+     * 删除历史记录
+     *
+     * @param qqNumber 用户QQ号
+     * @param phoneNumber 用户手机号
+     * @param historyId 历史记录ID
+     */
+    static deleteHistoryRecord(qqNumber: string, phoneNumber: string, historyId: string): Promise<void>;
+    /**
+     * 清空用户所有历史记录
+     *
+     * @param qqNumber 用户QQ号
+     * @param phoneNumber 用户手机号
+     */
+    static clearUserHistory(qqNumber: string, phoneNumber: string): Promise<void>;
+    /**
+     * 获取所有历史记录（管理员功能）
+     */
+    static getAllHistory(): Promise<CartHistoryItem[]>;
+    /**
+     * 获取统计数据
+     */
+    static getStatistics(): Promise<{
+        totalRecords: number;
+        totalUsers: number;
+        totalItems: number;
+        totalRevenue: number;
+    }>;
+}
+declare const getCartHistory: typeof CartHistoryService.getCartHistory;
+declare const updateBookingStatus: typeof CartHistoryService.updateBookingStatus;
+declare const deleteHistoryRecord: typeof CartHistoryService.deleteHistoryRecord;
+declare const clearUserHistory: typeof CartHistoryService.clearUserHistory;
+declare const getAllHistory: typeof CartHistoryService.getAllHistory;
+declare const getStatistics: typeof CartHistoryService.getStatistics;
+declare const saveCartHistory: (historyItem: Omit<CartHistoryItem, "id">) => Promise<CartHistoryItem>;
+
+/**
+ * 通用文件服务核心类型定义
+ *
+ * 定义了文件存储、CDN、处理器等核心接口和类型
+ */
+/** 文件存储类型 */
+type StorageType = 'local' | 'aliyun-oss' | 'aws-s3' | 'qcloud-cos';
+/** CDN提供者类型 */
+type CDNType = 'none' | 'aliyun-cdn' | 'aws-cloudfront' | 'qcloud-cdn';
+/** 存储配置基础接口 */
+interface StorageConfig {
+    /** 存储类型 */
+    type: StorageType;
+    /** 是否启用 */
+    enabled: boolean;
+}
+/** CDN配置基础接口 */
+interface CDNConfig {
+    /** CDN类型 */
+    type: CDNType;
+    /** 是否启用 */
+    enabled: boolean;
+}
+/** 文件服务配置 */
+interface UniversalFileServiceConfig {
+    /** 默认存储提供者 */
+    defaultStorage: StorageType;
+    /** 存储提供者配置 */
+    storageProviders: Record<StorageType, StorageConfig>;
+    /** 默认CDN提供者 */
+    defaultCDN: CDNType;
+    /** CDN提供者配置 */
+    cdnProviders: Record<CDNType, CDNConfig>;
+    /** 文件大小限制(字节) */
+    maxFileSize: number;
+    /** 允许的文件类型 */
+    allowedMimeTypes: string[];
+    /** 是否启用文件处理 */
+    enableProcessing: boolean;
+    /** 处理队列大小 */
+    processingQueueSize: number;
+    /** 缓存配置 */
+    cache: {
+        /** 元数据缓存TTL(秒) */
+        metadataTTL: number;
+        /** URL缓存TTL(秒) */
+        urlTTL: number;
+    };
+}
+
+/**
+ * 通用文件服务配置管理
+ */
+
+/**
+ * 配置管理器
+ */
+declare class FileServiceConfigManager {
+    private config;
+    constructor(customConfig?: Partial<UniversalFileServiceConfig>);
+    /**
+     * 获取完整配置
+     */
+    getConfig(): UniversalFileServiceConfig;
+    /**
+     * 获取存储提供者配置
+     */
+    getStorageConfig(type: StorageType): StorageConfig | undefined;
+    /**
+     * 获取CDN提供者配置
+     */
+    getCDNConfig(type: CDNType): CDNConfig | undefined;
+    /**
+     * 更新配置
+     */
+    updateConfig(updates: Partial<UniversalFileServiceConfig>): void;
+    /**
+     * 启用存储提供者
+     */
+    enableStorageProvider(type: StorageType, config?: Partial<StorageConfig>): void;
+    /**
+     * 禁用存储提供者
+     */
+    disableStorageProvider(type: StorageType): void;
+    /**
+     * 启用CDN提供者
+     */
+    enableCDNProvider(type: CDNType, config?: Partial<CDNConfig>): void;
+    /**
+     * 禁用CDN提供者
+     */
+    disableCDNProvider(type: CDNType): void;
+    /**
+     * 从环境变量加载阿里云OSS配置
+     */
+    loadAliyunOSSFromEnv(): void;
+    /**
+     * 从配置管理模块加载阿里云OSS配置
+     */
+    loadAliyunOSSFromConfigManager(): Promise<void>;
+    /**
+     * 从环境变量加载阿里云CDN配置
+     */
+    loadAliyunCDNFromEnv(): void;
+    /**
+     * 验证配置有效性
+     */
+    private validateConfig;
+    /**
+     * 合并配置
+     */
+    private mergeConfig;
+}
+
+/**
+ * ShowMasterpiece模块 - 文件服务配置
+ *
+ * 为ShowMasterpiece模块提供特定的文件服务配置和帮助函数
+ */
+/**
+ * 获取ShowMasterpiece模块的文件服务配置
+ */
+declare function getShowMasterpieceFileConfig(): Promise<FileServiceConfigManager>;
+/**
+ * 上传ShowMasterpiece作品图片
+ */
+declare function uploadArtworkImage(file: File, collectionId?: number): Promise<{
+    fileId: string;
+    accessUrl: string;
+}>;
+/**
+ * 获取作品图片访问URL
+ */
+declare function getArtworkImageUrl(fileId: string): Promise<string>;
+/**
+ * 检查是否应该使用通用文件服务
+ *
+ * 策略：
+ * 1. 如果已经配置了OSS，新上传默认使用文件服务
+ * 2. 如果只有本地存储，可以选择使用文件服务进行统一管理
+ * 3. 兼容旧的Base64存储方式
+ */
+declare function shouldUseUniversalFileService(): Promise<boolean>;
+/**
+ * 获取存储模式显示名称
+ */
+declare function getStorageModeDisplayName(): Promise<string>;
+/**
+ * 清除配置缓存
+ *
+ * 当配置更新后调用此函数，强制重新读取配置
+ */
+declare function clearConfigCache(): void;
+/**
+ * 强制刷新配置
+ *
+ * 清除缓存并重新获取配置
+ */
+declare function refreshFileServiceConfig(): Promise<FileServiceConfigManager>;
+
+/**
+ * ShowMasterpiece 模块 - 导出配置
+ *
+ * 定义预订信息的导出字段配置
+ */
+
+/**
+ * 预订信息导出字段定义
+ */
+declare const BOOKING_EXPORT_FIELDS: ExportField[];
+/**
+ * 默认导出配置
+ */
+declare const DEFAULT_BOOKING_EXPORT_CONFIG: {
+    id: string;
+    name: string;
+    description: string;
+    format: "excel";
+    fields: ExportField[];
+    grouping: {
+        enabled: boolean;
+        fields: {
+            key: string;
+            label: string;
+            mode: "merge";
+            valueProcessing: "first";
+            showGroupHeader: boolean;
+            mergeCells: boolean;
+        }[];
+        preserveOrder: boolean;
+        nullValueHandling: "separate";
+    };
+    fileNameTemplate: string;
+    includeHeader: boolean;
+    delimiter: string;
+    encoding: string;
+    addBOM: boolean;
+    maxRows: undefined;
+    createdAt: Date;
+    updatedAt: Date;
+    moduleId: string;
+    businessId: string;
+};
+
+/**
+ * ShowMasterpiece 模块 - 预订管理面板组件
+ *
+ * 管理员查看所有用户预订信息的面板组件
+ *
+ * @fileoverview 预订管理面板组件
+ */
+
+/**
+ * 预订管理面板组件属性
+ */
+interface BookingAdminPanelProps {
+    /** 预订数据列表 */
+    bookings: BookingAdminData[];
+    /** 统计信息 */
+    stats: BookingAdminStats;
+    /** 加载状态 */
+    loading: boolean;
+    /** 错误信息 */
+    error?: string;
+    /** 搜索参数 */
+    searchParams: BookingAdminQueryParams;
+    /** 刷新数据回调 */
+    onRefresh: () => void;
+    /** 搜索预订数据回调 */
+    onSearch: (params: BookingAdminQueryParams) => Promise<void>;
+    /** 清除搜索条件回调 */
+    onClearSearch: () => void;
+    /** 更新预订状态回调 */
+    onUpdateStatus: (id: number, status: BookingStatus, adminNotes?: string) => Promise<void>;
+    /** 删除预订回调 */
+    onDeleteBooking: (id: number) => Promise<void>;
+    /** 导出预订数据回调 */
+    onExportBookings: (format?: 'csv' | 'excel') => Promise<void>;
+}
+/**
+ * 预订管理面板组件
+ *
+ * @param props 组件属性
+ * @returns React组件
+ */
+declare const BookingAdminPanel: React__default.FC<BookingAdminPanelProps>;
+
+/**
+ * ShowMasterpiece 模块 - 预订弹窗组件
+ *
+ * 使用现有的Modal组件包装预订页面，提供弹窗形式的预订功能
+ *
+ * @fileoverview 预订弹窗组件
+ */
+
+/**
+ * 预订弹窗组件属性
+ */
+interface BookingModalProps {
+    /** 是否显示弹窗 */
+    isOpen: boolean;
+    /** 关闭弹窗回调 */
+    onClose: () => void;
+    /** 弹窗标题 */
+    title?: string;
+    /** 弹窗宽度 */
+    width?: number | string;
+    /** 弹窗高度 */
+    height?: number | string;
+}
+/**
+ * 预订弹窗组件
+ *
+ * @param props 组件属性
+ * @returns React组件
+ */
+declare const BookingModal: React__default.FC<BookingModalProps>;
+
+/**
+ * ShowMasterpiece 模块 - 预订页面组件
+ *
+ * 完整的预订页面，包含：
+ * - 画集列表展示和选择
+ * - 预订表单（QQ号、数量、备注）
+ * - 提交和状态管理
+ *
+ * @fileoverview 预订页面组件
+ */
+
+/**
+ * 预订页面组件属性
+ */
+interface BookingPageProps {
+    /** 关闭回调 */
+    onClose?: () => void;
+}
+/**
+ * 预订页面组件
+ *
+ * @param props 组件属性
+ * @returns React组件
+ */
+declare const BookingPage: React__default.FC<BookingPageProps>;
+
+/**
+ * ShowMasterpiece 模块 - 用户预订历史记录页面组件
+ *
+ * 用户查看自己的预订历史记录
+ *
+ * @fileoverview 用户预订历史记录页面组件
+ */
+
+/**
+ * 用户预订历史记录页面组件属性
+ */
+interface CartHistoryPageProps {
+    /** 用户QQ号 */
+    qqNumber: string;
+    /** 用户手机号 */
+    phoneNumber: string;
+}
+/**
+ * 用户预订历史记录页面组件
+ *
+ * @param props 组件属性
+ * @returns React组件
+ */
+declare const CartHistoryPage: React__default.FC<CartHistoryPageProps>;
+
+/**
+ * ShowMasterpiece 模块 - 限时弹窗组件
+ *
+ * 基于配置显示限时提醒弹窗
+ *
+ * @fileoverview 限时弹窗组件
+ */
+
+/**
+ * 限时弹窗组件属性
+ */
+interface DeadlinePopupProps {
+    /** 弹窗配置 */
+    config: PopupConfig;
+    /** 是否显示弹窗 */
+    isOpen: boolean;
+    /** 关闭回调 */
+    onClose: () => void;
+    /** 确认回调 */
+    onConfirm?: () => void;
+    /** 取消回调 */
+    onCancel?: () => void;
+}
+/**
+ * 限时弹窗组件
+ */
+declare const DeadlinePopup: React__default.FC<DeadlinePopupProps>;
+/**
+ * 多弹窗管理组件
+ */
+interface DeadlinePopupManagerProps {
+    /** 弹窗配置列表 */
+    configs: PopupConfig[];
+    /** 关闭回调 */
+    onClose: (configId: string) => void;
+    /** 确认回调 */
+    onConfirm?: (configId: string) => void;
+    /** 取消回调 */
+    onCancel?: (configId: string) => void;
+}
+declare const DeadlinePopupManager: React__default.FC<DeadlinePopupManagerProps>;
+
+/**
+ * ShowMasterpiece 模块 - 弹窗配置管理组件
+ *
+ * 提供弹窗配置的创建、编辑、删除和启用/禁用功能
+ *
+ * @fileoverview 弹窗配置管理组件
+ */
+
+/**
+ * 弹窗配置管理组件属性
+ */
+interface PopupConfigManagementProps {
+}
+/**
+ * 弹窗配置管理组件
+ */
+declare const PopupConfigManagement: React__default.FC<PopupConfigManagementProps>;
+
+/**
+ * ShowMasterpiece模块 - 系统配置管理组件
+ *
+ * 从全局configManager复制并适配，专门为showmasterpiece模块使用
+ * 用于模块独立化准备
+ */
+
+declare const SystemConfigManager: React__default.FC;
+
+/**
+ * ShowMasterpiece模块 - 新增配置项对话框组件
+ *
+ * 从全局configManager复制并简化适配
+ */
+
+interface ConfigItemFormData {
+    key: string;
+    displayName: string;
+    description: string;
+    value: string;
+    defaultValue: string;
+    type: 'string' | 'number' | 'boolean' | 'password';
+    isRequired: boolean;
+    isSensitive: boolean;
+    validation: string;
+    sortOrder: number;
+}
+interface AddConfigItemDialogProps {
+    isOpen: boolean;
+    onSave: (data: ConfigItemFormData) => Promise<void>;
+    onCancel: () => void;
+}
+declare const AddConfigItemDialog: React__default.FC<AddConfigItemDialogProps>;
+
+/**
+ * ShowMasterpiece模块 - 删除确认对话框组件
+ *
+ * 从全局configManager复制并适配
+ */
+
+interface ConfigItem {
+    id: string;
+    key: string;
+    displayName: string;
+    description: string;
+    value: string;
+    defaultValue: string;
+    type: 'string' | 'number' | 'boolean' | 'password';
+    isRequired: boolean;
+    isSensitive: boolean;
+    validation: string | null;
+    sortOrder: number;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface DeleteConfirmDialogProps {
+    isOpen: boolean;
+    item: ConfigItem | null;
+    onConfirm: () => void;
+    onCancel: () => void;
+    loading?: boolean;
+}
+declare const DeleteConfirmDialog: React__default.FC<DeleteConfirmDialogProps>;
+
+/**
+ * ShowMasterpiece 主页面组件 - Tailwind CSS 版本
+ *
+ * 这是ShowMasterpiece模块的主要页面组件，提供完整的画集浏览体验。
+ * 支持两种视图模式：画集列表视图和作品详情视图。
+ *
+ * 主要功能：
+ * - 画集列表展示和搜索
+ * - 画集详情浏览和作品查看
+ * - 用户权限控制和认证
+ * - 响应式设计和优化的用户体验
+ * - 配置管理入口（需要管理员权限）
+ *
+ * 技术特点：
+ * - 使用自定义Hook进行状态管理
+ * - 集成认证系统，支持权限控制
+ * - 动态配置加载，支持个性化设置
+ * - 性能优化：使用useMemo缓存计算结果
+ * - 使用 Tailwind CSS 进行样式管理
+ *
+ * @component
+ */
+
+interface ShowMasterPiecesPageProps {
+    /** Next.js 页面参数 */
+    params?: Record<string, string>;
+    /** Next.js 搜索参数 */
+    searchParams?: Record<string, string | string[] | undefined>;
+}
+/**
+ * ShowMasterpiece 主组件
+ *
+ * 提供认证上下文包装器，确保组件能够访问用户认证状态。
+ * 这是模块的对外接口组件。
+ *
+ * @returns React函数组件
+ */
+declare function ShowMasterPieces(props?: ShowMasterPiecesPageProps): React__default.JSX.Element;
+
+declare function ConfigPage(): React__default.JSX.Element;
+
+/**
+ * ShowMasterpiece 模块 - 用户购物车历史记录页面
+ *
+ * 用户输入QQ号和手机号查看自己的购物车历史记录
+ *
+ * @fileoverview 用户历史记录页面
+ */
+
+/**
+ * 用户历史记录页面组件
+ *
+ * @returns React组件
+ */
+declare function UserHistoryPage(): React__default.JSX.Element;
+
+/**
+ * useMasterpieces Hook 主体函数
+ *
+ * 提供画集数据管理和浏览状态管理的完整解决方案。
+ * 包含状态管理、数据获取、缓存机制和用户交互功能。
+ *
+ */
+declare const useMasterpieces: () => {
+    /** 所有画集数据 */
+    collections: ArtCollection[];
+    /** 当前选中的画集 */
+    selectedCollection: ArtCollection | null;
+    /** 当前页面索引 */
+    currentPage: number;
+    /** 加载状态 */
+    loading: boolean;
+    /** 错误信息 */
+    error: string | null;
+    /** 获取当前作品的方法 */
+    getCurrentArtwork: () => ArtworkPage | null;
+    /** 是否可以下一页 */
+    canGoNext: boolean;
+    /** 是否可以上一页 */
+    canGoPrev: boolean;
+    /** 选择画集 */
+    selectCollection: (collection: ArtCollection) => void;
+    /** 下一页 */
+    nextPage: () => void;
+    /** 上一页 */
+    prevPage: () => void;
+    /** 跳转到指定页 */
+    goToPage: (pageIndex: number) => void;
+    /** 返回画集列表 */
+    backToGallery: () => void;
+    /** 搜索画集 */
+    searchCollections: (query: string) => Promise<void>;
+    /** 加载画集数据 */
+    loadCollections: (forceRefresh?: boolean) => Promise<void>;
+};
+
+declare const useMasterpiecesConfig: () => {
+    config: MasterpiecesConfig | null;
+    collections: ArtCollection[];
+    categories: string[];
+    tags: string[];
+    loading: boolean;
+    error: string | null;
+    refreshCounter: number;
+    updateConfig: (configData: Partial<MasterpiecesConfig>) => Promise<void>;
+    resetConfig: () => Promise<void>;
+    createCollection: (collectionData: CollectionFormData) => Promise<void>;
+    updateCollection: (id: number, collectionData: CollectionFormData) => Promise<void>;
+    deleteCollection: (id: number) => Promise<void>;
+    addArtworkToCollection: (collectionId: number, artworkData: ArtworkFormData) => Promise<void>;
+    updateArtwork: (collectionId: number, artworkId: number, artworkData: ArtworkFormData) => Promise<void>;
+    deleteArtwork: (collectionId: number, artworkId: number) => Promise<void>;
+    moveArtworkUp: (collectionId: number, artworkId: number) => Promise<void>;
+    moveArtworkDown: (collectionId: number, artworkId: number) => Promise<void>;
+    updateArtworkOrder: (collectionId: number, artworkOrders: {
+        id: number;
+        pageOrder: number;
+    }[]) => Promise<void>;
+    moveCollectionUp: (collectionId: number) => Promise<void>;
+    moveCollectionDown: (collectionId: number) => Promise<void>;
+    updateCollectionOrder: (collectionOrders: {
+        id: number;
+        displayOrder: number;
+    }[]) => Promise<void>;
+    refreshData: () => Promise<{
+        config: MasterpiecesConfig;
+        collections: any;
+        categories: string[];
+        tags: string[];
+    }>;
+};
+
+/**
+ * ShowMasterpiece 模块 - 购物车功能Hook
+ *
+ * 提供购物车功能相关的状态管理和业务逻辑，包括：
+ * - 购物车状态管理
+ * - 购物车操作（添加、更新、移除、清空）
+ * - 批量预订处理
+ * - 错误处理和加载状态
+ *
+ * @fileoverview 购物车功能Hook
+ */
+
+declare const cartUpdateEvents: EventTarget;
+declare const CART_UPDATE_EVENT = "cart-updated";
+declare const notifyCartUpdate: () => void;
+/**
+ * 购物车Hook
+ *
+ * 管理购物车的状态和业务逻辑
+ *
+ * @param userId 用户ID
+ * @returns 购物车状态和操作方法
+ */
+declare function useCart(userId: number): {
+    cart: Cart;
+    loading: boolean;
+    error: string | undefined;
+    isCartOpen: boolean;
+    loadCart: () => Promise<void>;
+    addItemToCart: (request: AddToCartRequest & {
+        userId: number;
+        collection?: any;
+    }) => Promise<void>;
+    updateItemQuantity: (collectionId: number, quantity: number) => Promise<void>;
+    removeItemFromCart: (collectionId: number) => Promise<void>;
+    clearCartItems: () => Promise<void>;
+    checkoutCart: (qqNumber: string, phoneNumber: string, notes?: string, pickupMethod?: string) => Promise<BatchBookingResponse>;
+    openCart: () => void;
+    closeCart: () => void;
+    clearError: () => void;
+};
+
+/**
+ * ShowMasterpiece 模块 - 预订功能Hook
+ *
+ * 提供预订功能相关的状态管理和业务逻辑，包括：
+ * - 预订表单状态管理
+ * - 画集列表加载
+ * - 预订提交处理
+ * - 错误处理和加载状态
+ *
+ * @fileoverview 预订功能Hook
+ */
+
+/**
+ * 预订页面Hook属性
+ */
+interface UseBookingProps {
+}
+/**
+ * 预订页面Hook
+ *
+ * 管理预订页面的状态和业务逻辑
+ *
+ * @param props Hook属性
+ * @returns 预订页面状态和操作方法
+ */
+declare function useBooking(_props?: UseBookingProps): {
+    collections: CollectionSummary[];
+    loading: boolean;
+    error: string | undefined;
+    submitting: boolean;
+    submitted: boolean;
+    loadCollections: () => Promise<void>;
+    submitBooking: (formData: BookingFormData) => Promise<void>;
+    resetSubmission: () => void;
+    clearError: () => void;
+};
+/**
+ * 预订表单Hook
+ *
+ * 管理预订表单的状态和验证
+ *
+ * @returns 表单状态和操作方法
+ */
+declare function useBookingForm(): {
+    formData: BookingFormData;
+    errors: Partial<Record<keyof BookingFormData, string>>;
+    updateField: (field: keyof BookingFormData, value: any) => void;
+    validateForm: () => boolean;
+    resetForm: () => void;
+};
+
+/**
+ * ShowMasterpiece 模块 - 预订管理Hook
+ *
+ * 提供预订管理功能的状态管理和数据获取逻辑，包括：
+ * - 获取所有预订数据
+ * - 预订统计信息
+ * - 状态更新
+ * - 加载和错误状态管理
+ * - 用户搜索功能
+ *
+ * @fileoverview 预订管理Hook
+ */
+
+/**
+ * 预订管理Hook返回值类型
+ */
+interface UseBookingAdminReturn {
+    /** 预订数据列表 */
+    bookings: BookingAdminData[];
+    /** 统计信息 */
+    stats: BookingAdminStats;
+    /** 加载状态 */
+    loading: boolean;
+    /** 错误信息 */
+    error?: string;
+    /** 搜索参数 */
+    searchParams: BookingAdminQueryParams;
+    /** 刷新数据 */
+    refreshData: () => Promise<void>;
+    /** 搜索预订数据 */
+    searchBookings: (params: BookingAdminQueryParams) => Promise<void>;
+    /** 清除搜索条件 */
+    clearSearch: () => void;
+    /** 更新预订状态 */
+    updateBookingStatus: (id: number, status: BookingStatus, adminNotes?: string) => Promise<void>;
+    /** 删除预订 */
+    deleteBooking: (id: number) => Promise<void>;
+    /** 导出预订数据 */
+    exportBookings: (format?: 'csv' | 'excel') => Promise<void>;
+    /** 清除错误 */
+    clearError: () => void;
+}
+/**
+ * 预订管理Hook
+ *
+ * 提供预订管理功能的状态管理和数据获取逻辑
+ *
+ * @returns 预订管理Hook返回值
+ */
+declare const useBookingAdmin: () => UseBookingAdminReturn;
+
+/**
+ * ShowMasterpiece 模块 - 限时弹窗Hook
+ *
+ * 管理限时弹窗的显示逻辑
+ *
+ * @fileoverview 限时弹窗Hook
+ */
+
+/**
+ * 限时弹窗Hook
+ */
+declare function useDeadlinePopup(businessModule?: string, businessScene?: string): {
+    checkPopups: (currentTime?: Date) => Promise<{
+        id: string;
+        description: string | null;
+        createdAt: Date | null;
+        updatedAt: Date | null;
+        type: string;
+        enabled: boolean | null;
+        name: string;
+        sortOrder: string | null;
+        triggerConfig: {
+            deadlineTime?: string;
+            advanceMinutes?: number;
+            triggerType: "after_deadline" | "before_deadline" | "always";
+        };
+        contentConfig: {
+            title: string;
+            message: string;
+            confirmText?: string;
+            cancelText?: string;
+            showCancel?: boolean;
+            theme?: "warning" | "info" | "error" | "success";
+        };
+        displayConfig: {
+            width?: number;
+            height?: number | string;
+            maskClosable?: boolean;
+            autoCloseSeconds?: number;
+        } | null;
+        blockProcess: boolean | null;
+        businessModule: string;
+        businessScene: string;
+    }[]>;
+    closePopup: (configId: string) => void;
+    confirmPopup: (configId: string) => void;
+    cancelPopup: (configId: string) => void;
+    temporaryClosePopup: (configId: string) => void;
+    resetDismissedPopups: () => void;
+    triggerCheck: (currentTime?: Date) => Promise<{
+        id: string;
+        description: string | null;
+        createdAt: Date | null;
+        updatedAt: Date | null;
+        type: string;
+        enabled: boolean | null;
+        name: string;
+        sortOrder: string | null;
+        triggerConfig: {
+            deadlineTime?: string;
+            advanceMinutes?: number;
+            triggerType: "after_deadline" | "before_deadline" | "always";
+        };
+        contentConfig: {
+            title: string;
+            message: string;
+            confirmText?: string;
+            cancelText?: string;
+            showCancel?: boolean;
+            theme?: "warning" | "info" | "error" | "success";
+        };
+        displayConfig: {
+            width?: number;
+            height?: number | string;
+            maskClosable?: boolean;
+            autoCloseSeconds?: number;
+        } | null;
+        blockProcess: boolean | null;
+        businessModule: string;
+        businessScene: string;
+    }[]>;
+    /** 需要显示的弹窗配置 */
+    configs: PopupConfig[];
+    /** 是否正在加载 */
+    loading: boolean;
+    /** 错误信息 */
+    error: string | null;
+    /** 是否有弹窗显示 */
+    hasPopup: boolean;
+};
+
+/**
+ * ShowMasterpiece 模块 - 购物车上下文Hook
+ *
+ * 提供购物车上下文状态的访问Hook，用于在组件中获取购物车相关的状态和操作。
+ * 这个Hook必须在CartProvider包装的组件内使用。
+ *
+ * 主要功能：
+ * - 获取购物车数据
+ * - 获取加载状态
+ * - 获取错误信息
+ * - 提供刷新购物车的方法
+ *
+ * @fileoverview 购物车上下文Hook
+ */
+
+/**
+ * 使用购物车上下文Hook
+ *
+ * 这个Hook用于在组件中访问购物车上下文状态。
+ * 必须在CartProvider包装的组件内使用，否则会抛出错误。
+ *
+ * @returns 购物车上下文状态，包含购物车数据、加载状态、错误信息和刷新方法
+ * @throws {Error} 当在CartProvider外部使用时抛出错误
+ *
+ * @example
+ * ```tsx
+ * function CartButton() {
+ *   const { cart, loading, error, refreshCart } = useCartContext();
+ *
+ *   if (loading) return <div>加载中...</div>;
+ *   if (error) return <div>错误: {error}</div>;
+ *
+ *   return (
+ *     <button onClick={refreshCart}>
+ *       购物车 ({cart.totalQuantity})
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+declare const useCartContext: () => CartContextState;
+
+/**
+ * ShowMasterpiece 模块 - 购物车上下文
+ *
+ * 提供购物车状态的全局管理，包括：
+ * - 购物车数据状态
+ * - 购物车数据刷新
+ * - 购物车更新通知
+ *
+ * @fileoverview 购物车上下文
+ */
+
+/**
+ * 购物车上下文提供者属性
+ */
+interface CartProviderProps {
+    children: ReactNode;
+    userId: number;
+}
+/**
+ * 购物车上下文提供者组件
+ *
+ * @param props 组件属性
+ * @returns React组件
+ */
+declare const CartProvider: React__default.FC<CartProviderProps>;
+
+/**
+ * ShowMasterpiece 模块 - 主入口文件
+ *
+ * 这是一个完整的美术作品展示模块，提供了从前端组件到后端API的完整解决方案。
+ * 主要功能包括：
+ * - 美术作品画集的展示和浏览
+ * - 画集和作品的管理配置界面
+ * - 拖拽排序功能
+ * - 缩略图预览
+ * - 数据持久化存储
+ *
+ * 架构特点：
+ * - 前后端分离，支持服务端渲染
+ * - 模块化设计，便于维护和扩展
+ * - TypeScript严格类型检查
+ * - CSS Modules样式隔离
+ *
+ * @version 1.0.0
+ * @author Profile-v1 Team
+ */
+/**
+ * ShowMasterpiece 模块所有组件的统一导出
+ *
+ * 包含以下组件类别：
+ * - 展示组件：CollectionCard, ArtworkViewer, ThumbnailSidebar
+ * - 管理组件：CollectionOrderManager, ArtworkOrderManager
+ * - 购物车组件：CartModal, CartPage, CartButton, AddToCartButton
+ * - 预订组件：BookingModal, BookingPage, CollectionList, BookingAdminPanel
+ * - 配置组件：SystemConfigManager, PopupConfigManagement
+ * - 对话框组件：AddConfigItemDialog, DeleteConfirmDialog
+ * - 弹窗组件：DeadlinePopup, DeadlinePopupManager
+ * - 历史组件：CartHistoryPage
+ * - 上传组件：UniversalImageUpload
+ *
+ * 使用方式：
+ * ```typescript
+ * import { CollectionCard, ArtworkViewer } from 'sa2kitsa2kit/showmasterpiece';
+ * ```
+ */
+
+/**
+ * 注意：预订管理相关的TypeScript类型定义现已通过 services 统一导出
+ * 包括：BookingAdminData, BookingAdminStats, BookingAdminResponse, BookingAdminQueryParams
+ */
+/** 模块版本号 */
+declare const SHOWMASTERPIECE_MODULE_VERSION = "1.0.0";
+/** 模块名称标识 */
+declare const SHOWMASTERPIECE_MODULE_NAME = "@profilesa2kitsa2kit/showmasterpiece";
+
+export { AddConfigItemDialog, AddToCartButton, type AddToCartRequest, type ArtCollection, type ArtworkFormData, ArtworkOrderManagerV2 as ArtworkOrderManager, ArtworkOrderManagerV2, type ArtworkPage, ArtworkViewer, BOOKING_EXPORT_FIELDS, type BatchBookingRequest, type BatchBookingResponse, type BookingAdminData, BookingAdminPanel, type BookingAdminQueryParams, type BookingAdminResponse, BookingAdminService, type BookingAdminStats, BookingModal, BookingPage, BookingService, CART_UPDATE_EVENT, type Cart, type CartAction, CartButton, CartHistoryPage, CartHistoryService, type CartItem, CartModal, CartPage, CartProvider, CartService, type CartState, type ClearCartRequest, CollectionCard, CollectionCategory, type CollectionCategoryType, type CollectionFormData, CollectionList, CollectionOrderManagerV2 as CollectionOrderManager, CollectionOrderManagerV2, DEFAULT_BOOKING_EXPORT_CONFIG, DeadlinePopup, DeadlinePopupManager, DeleteConfirmDialog, type MasterpiecesConfig, MasterpiecesService, MobileAlbumViewer, PopupConfigManagement, type RemoveFromCartRequest, SHOWMASTERPIECE_MODULE_NAME, SHOWMASTERPIECE_MODULE_VERSION, ConfigPage as ShowMasterPiecesConfigPage, UserHistoryPage as ShowMasterPiecesHistoryPage, ShowMasterPieces as ShowMasterPiecesPage, SystemConfigManager, ThumbnailSidebar, UniversalImageUpload, type UpdateCartItemRequest, addArtworkToCollection, addToCart, batchBooking, cartUpdateEvents, clearCart, clearConfigCache, clearUserHistory, createBooking, createCategory, createCollection, deleteArtwork, deleteBooking$1 as deleteBooking, deleteBooking as deleteBookingAdmin, deleteCollection, deleteHistoryRecord, exportBookings, forceRefreshAllBookings, forceRefreshBookingStats, getAllBookings, getAllCollections, getAllHistory, getArtworkImageUrl, getArtworksByCollection, getAvailableCategories, getBookableCollections, getBooking, getBookingStats, getBookings, getCart, getCartHistory, getCategories, getCollectionsOverview, getConfig, getMasterpieces, getShowMasterpieceFileConfig, getStatistics, getStorageModeDisplayName, getTags, isValidCategory, moveArtwork, moveArtworkDown, moveArtworkUp, moveCollection, moveCollectionDown, moveCollectionUp, notifyCartUpdate, refreshFileServiceConfig, removeFromCart, resetConfig, saveCartHistory, shouldUseUniversalFileService, updateArtwork, updateArtworkOrder, updateBooking, updateBookingStatus$1 as updateBookingAdminStatus, updateBookingStatus as updateCartHistoryBookingStatus, updateCartItem, updateCollection, updateCollectionOrder, updateConfig, uploadArtworkImage, useBooking, useBookingAdmin, useBookingForm, useCart, useCartContext, useDeadlinePopup, useMasterpieces, useMasterpiecesConfig };