sa2kit 1.6.44 → 1.6.45

package/dist/chunk-3TNR6IMC.js

@@ -0,0 +1,168 @@
+'use strict';
+
+// src/showmasterpiece/types/index.ts
+var CollectionCategory = /* @__PURE__ */ ((CollectionCategory2) => {
+  CollectionCategory2["COLLECTION"] = "collection";
+  CollectionCategory2["ACRYLIC"] = "acrylic";
+  CollectionCategory2["BADGE"] = "badge";
+  CollectionCategory2["COLOR_PAPER"] = "color_paper";
+  CollectionCategory2["TRANSPARENT_CARD"] = "transparent_card";
+  CollectionCategory2["POSTCARD"] = "postcard";
+  CollectionCategory2["LASER_TICKET"] = "laser_ticket";
+  CollectionCategory2["CANVAS_BAG"] = "canvas_bag";
+  CollectionCategory2["SPIRAL_NOTEBOOK"] = "spiral_notebook";
+  CollectionCategory2["MOUSE_PAD"] = "mouse_pad";
+  CollectionCategory2["SUPPORT_STICK"] = "support_stick";
+  CollectionCategory2["KEYCHAIN"] = "keychain";
+  CollectionCategory2["OTHER"] = "other";
+  return CollectionCategory2;
+})(CollectionCategory || {});
+var defaultHomeTabCategoryOrder = [
+  "canvas_bag" /* CANVAS_BAG */,
+  "spiral_notebook" /* SPIRAL_NOTEBOOK */,
+  "mouse_pad" /* MOUSE_PAD */,
+  "acrylic" /* ACRYLIC */,
+  "badge" /* BADGE */,
+  "color_paper" /* COLOR_PAPER */,
+  "keychain" /* KEYCHAIN */,
+  "transparent_card" /* TRANSPARENT_CARD */,
+  "laser_ticket" /* LASER_TICKET */
+];
+function buildDefaultHomeTabConfig() {
+  const config = [];
+  let order = 0;
+  defaultHomeTabCategoryOrder.forEach((category) => {
+    config.push({ category, visible: true, order });
+    order += 1;
+  });
+  return config;
+}
+function normalizeHomeTabConfig(input) {
+  if (!input || input.length === 0) {
+    return buildDefaultHomeTabConfig();
+  }
+  const filtered = input.filter((item) => item && isValidCategory(item.category)).map((item) => ({
+    category: item.category,
+    visible: item.visible ?? true,
+    order: Number.isFinite(item.order) ? Number(item.order) : 0
+  }));
+  if (filtered.length === 0) {
+    return buildDefaultHomeTabConfig();
+  }
+  filtered.sort((a, b) => a.order - b.order);
+  const normalized = filtered.map((item, index) => ({ ...item, order: index }));
+  if (!normalized.some((item) => item.visible)) {
+    const firstItem = normalized[0];
+    if (firstItem) {
+      normalized[0] = { ...firstItem, visible: true };
+    }
+  }
+  return normalized;
+}
+function getAvailableCategories() {
+  return Object.values(CollectionCategory);
+}
+function isValidCategory(category) {
+  if (typeof category !== "string") {
+    return false;
+  }
+  return category.trim().length > 0;
+}
+var categories = {
+  ["collection" /* COLLECTION */]: {
+    value: "collection" /* COLLECTION */,
+    displayName: "\u753B\u96C6",
+    description: "\u7528\u4E8E\u5C55\u793A\u827A\u672F\u4F5C\u54C1"
+  },
+  ["acrylic" /* ACRYLIC */]: {
+    value: "acrylic" /* ACRYLIC */,
+    displayName: "\u7ACB\u724C",
+    description: "\u7ACB\u724C\u5236\u54C1"
+  },
+  ["badge" /* BADGE */]: {
+    value: "badge" /* BADGE */,
+    displayName: "\u5427\u5527",
+    description: "\u5FBD\u7AE0\u7C7B\u5546\u54C1"
+  },
+  ["color_paper" /* COLOR_PAPER */]: {
+    value: "color_paper" /* COLOR_PAPER */,
+    displayName: "\u8272\u7EB8",
+    description: "\u5F69\u8272\u7EB8\u5F20\u5236\u54C1"
+  },
+  ["transparent_card" /* TRANSPARENT_CARD */]: {
+    value: "transparent_card" /* TRANSPARENT_CARD */,
+    displayName: "\u900F\u5361",
+    description: "\u900F\u660E\u5361\u7247\u5236\u54C1"
+  },
+  ["postcard" /* POSTCARD */]: {
+    value: "postcard" /* POSTCARD */,
+    displayName: "\u660E\u4FE1\u7247",
+    description: "\u660E\u4FE1\u7247\u7C7B\u5546\u54C1"
+  },
+  ["laser_ticket" /* LASER_TICKET */]: {
+    value: "laser_ticket" /* LASER_TICKET */,
+    displayName: "\u956D\u5C04\u7968",
+    description: "\u956D\u5C04\u7968\u7C7B\u5546\u54C1"
+  },
+  ["canvas_bag" /* CANVAS_BAG */]: {
+    value: "canvas_bag" /* CANVAS_BAG */,
+    displayName: "\u5E06\u5E03\u5305",
+    description: "\u5E06\u5E03\u5305\u7C7B\u5546\u54C1"
+  },
+  ["spiral_notebook" /* SPIRAL_NOTEBOOK */]: {
+    value: "spiral_notebook" /* SPIRAL_NOTEBOOK */,
+    displayName: "\u7EBF\u5708\u7B14\u8BB0\u672C",
+    description: "\u7EBF\u5708\u88C5\u8BA2\u7B14\u8BB0\u672C"
+  },
+  ["mouse_pad" /* MOUSE_PAD */]: {
+    value: "mouse_pad" /* MOUSE_PAD */,
+    displayName: "\u9F20\u6807\u57AB",
+    description: "\u9F20\u6807\u57AB\u7C7B\u5546\u54C1"
+  },
+  ["support_stick" /* SUPPORT_STICK */]: {
+    value: "support_stick" /* SUPPORT_STICK */,
+    displayName: "\u5E94\u63F4\u68D2",
+    description: "\u5E94\u63F4\u68D2\u7C7B\u5546\u54C1"
+  },
+  ["keychain" /* KEYCHAIN */]: {
+    value: "keychain" /* KEYCHAIN */,
+    displayName: "\u6302\u4EF6/\u94A5\u5319\u6263",
+    description: "\u6302\u4EF6/\u94A5\u5319\u6263\u7C7B\u5546\u54C1"
+  },
+  ["other" /* OTHER */]: {
+    value: "other" /* OTHER */,
+    displayName: "\u5176\u5B83",
+    description: "\u5176\u4ED6\u7C7B\u578B\u5546\u54C1"
+  }
+};
+function getCategoryDisplayName(category) {
+  return categories[category]?.displayName || category;
+}
+function getCategoryInfo(category) {
+  return categories[category] || {
+    value: category,
+    displayName: category,
+    description: ""
+  };
+}
+if (!Object.getOwnPropertyDescriptor(String.prototype, "displayName")) {
+  Object.defineProperty(String.prototype, "displayName", {
+    get() {
+      return getCategoryDisplayName(this);
+    }
+  });
+}
+if (!Object.getOwnPropertyDescriptor(String.prototype, "categoryInfo")) {
+  Object.defineProperty(String.prototype, "categoryInfo", {
+    get() {
+      return getCategoryInfo(this);
+    }
+  });
+}
+
+exports.buildDefaultHomeTabConfig = buildDefaultHomeTabConfig;
+exports.getAvailableCategories = getAvailableCategories;
+exports.getCategoryDisplayName = getCategoryDisplayName;
+exports.normalizeHomeTabConfig = normalizeHomeTabConfig;
+//# sourceMappingURL=chunk-3TNR6IMC.js.map
+//# sourceMappingURL=chunk-3TNR6IMC.js.map

package/dist/chunk-3TNR6IMC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/showmasterpiece/types/index.ts"],"names":["CollectionCategory"],"mappings":"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","file":"chunk-3TNR6IMC.js","sourcesContent":["/**\n * ShowMasterpiece 模块类型定义\n * \n * 包含画集、作品、配置等相关的TypeScript类型定义\n */\n\n// ===== 画集分类枚举 =====\n\n/**\n * 画集分类枚举\n * \n * 定义画集的各种分类：\n * - COLLECTION: 画集 - 用于展示艺术作品\n * - ACRYLIC: 立牌 - 立牌制品\n * - BADGE: 吧唧 - 徽章类商品\n * - COLOR_PAPER: 色纸 - 彩色纸张制品\n * - POSTCARD: 明信片 - 明信片类商品\n * - LASER_TICKET: 镭射票 - 镭射票类商品\n * - CANVAS_BAG: 帆布包 - 帆布包类商品\n * - SUPPORT_STICK: 应援棒 - 应援棒类商品\n * - OTHER: 挂件/钥匙扣 - 挂件/钥匙扣类商品\n */\nexport enum CollectionCategory {\n  /** 画集 - 用于展示艺术作品 */\n  COLLECTION = 'collection',\n  /** 立牌 - 立牌制品 */\n  ACRYLIC = 'acrylic',\n  /** 吧唧 - 徽章类商品 */\n  BADGE = 'badge',\n  /** 色纸 - 彩色纸张制品 */\n  COLOR_PAPER = 'color_paper',\n  /** 透卡 - 透明卡片制品 */\n  TRANSPARENT_CARD = 'transparent_card',\n  /** 明信片 - 明信片类商品 */\n  POSTCARD = 'postcard',\n  /** 镭射票 - 镭射票类商品 */\n  LASER_TICKET = 'laser_ticket',\n  /** 帆布包 - 帆布包类商品 */\n  CANVAS_BAG = 'canvas_bag',\n  /** 线圈笔记本 - 线圈装订笔记本 */\n  SPIRAL_NOTEBOOK = 'spiral_notebook',\n  /** 鼠标垫 - 鼠标垫类商品 */\n  MOUSE_PAD = 'mouse_pad',\n  /** 应援棒 - 应援棒类商品 */\n  SUPPORT_STICK = 'support_stick',\n  /** 挂件/钥匙扣 - 挂件/钥匙扣类商品 */\n  KEYCHAIN = 'keychain',\n  /** 其它 */\n  OTHER = 'other'\n}\n\n/**\n * 画集分类类型\n * 使用枚举值作为类型\n */\nexport type CollectionCategoryType = `${CollectionCategory}` | string;\n\n/**\n * 分类信息接口\n * 包含分类值和显示名称\n */\nexport interface CategoryInfo {\n  /** 分类值 */\n  value: CollectionCategoryType;\n  /** 显示名称 */\n  displayName: string;\n  /** 描述信息 */\n  description?: string;\n}\n\n// ===== 基础类型定义 =====\n\n/**\n * 艺术作品页面数据结构\n * \n * 表示画集中的单个作品页面，包含图片、标题、描述等信息。\n * 每个画集包含多个这样的作品页面。\n */\nexport interface ArtworkPage {\n  /** 作品的唯一标识符 */\n  id: number;\n  \n  /** 作品标题 */\n  title: string;\n  \n  /** 编号 */\n  number: string;\n  \n  /** 作品图片（支持URL或base64编码） */\n  image: string;\n  \n  /** 通用文件服务的图片文件ID（新架构，可选） */\n  fileId?: string;\n  \n  /** 作品描述 */\n  description: string;\n  \n  /** 创作时间（可选） */\n  createdTime?: string;\n  \n  /** 作品主题（可选） */\n  theme?: string;\n  \n  /** 作品年份（可选） */\n  year?: string;\n  \n  /** 创作媒介（可选） */\n  medium?: string;\n  \n  /** 作品尺寸（可选） */\n  dimensions?: string;\n  \n  /** 在画集中的显示顺序 */\n  pageOrder: number;\n  \n  /** 是否激活（可选，默认true） */\n  isActive?: boolean;\n  \n  /** 创建时间（可选） */\n  createdAt?: string;\n  \n  /** 更新时间（可选） */\n  updatedAt?: string;\n}\n\n/**\n * 艺术画集数据结构\n * \n * 表示一个完整的艺术画集，包含多个作品页面和相关元数据。\n * 这是系统中的核心数据模型之一。\n */\nexport interface ArtCollection {\n  /** 画集的唯一标识符 */\n  id: number;\n  \n  /** 画集标题 */\n  title: string;\n  \n  /** 编号 */\n  number: string;\n  \n  /** 画集封面图片路径 */\n  coverImage: string;\n  \n  /** 通用文件服务的封面图片文件ID（新架构，可选） */\n  coverImageFileId?: string;\n  \n  /** 画集描述 */\n  description: string;\n  \n  /** 画集包含的所有作品页面 */\n  pages: ArtworkPage[];\n  \n  /** 画集分类（使用枚举值） */\n  category: CollectionCategoryType;\n  \n  /** 画集标签列表（可选） */\n  tags?: string[];\n  \n  /** 是否已发布（可选，默认true） */\n  isPublished?: boolean;\n  \n  /** 画集价格（单位：元，可选） */\n  price?: number;\n  \n  /** 创建时间（可选） */\n  createdAt?: string;\n  \n  /** 更新时间（可选） */\n  updatedAt?: string;\n}\n\n// ===== 配置相关类型 =====\n\n/**\n * 系统配置数据结构\n * \n * 存储ShowMasterpiece模块的全局配置信息，\n * 包括网站设置、显示选项、功能开关等。\n */\nexport interface MasterpiecesConfig {\n  /** 网站名称 */\n  siteName: string;\n  \n  /** 网站描述 */\n  siteDescription?: string;\n  \n  /** 首页主标题 */\n  heroTitle: string;\n  \n  /** 首页副标题 */\n  heroSubtitle?: string;\n  \n  /** 每页显示的最大画集数量 */\n  maxCollectionsPerPage: number;\n  \n  /** 是否启用搜索功能 */\n  enableSearch: boolean;\n  \n  /** 是否启用分类功能 */\n  enableCategories: boolean;\n\n  /** 首页分类Tab配置 */\n  homeTabConfig: HomeTabConfigItem[];\n  \n  /** 默认分类 */\n  defaultCategory: string;\n  \n  /** 主题模式：light(浅色)、dark(深色)、auto(自动) */\n  theme: 'light' | 'dark' | 'auto';\n  \n  /** 界面语言：zh(中文)、en(英文) */\n  language: 'zh' | 'en';\n}\n\nexport interface HomeTabConfigItem {\n  category: CollectionCategoryType;\n  visible: boolean;\n  order: number;\n}\n\nexport const defaultHomeTabCategoryOrder: CollectionCategoryType[] = [\n  CollectionCategory.CANVAS_BAG,\n  CollectionCategory.SPIRAL_NOTEBOOK,\n  CollectionCategory.MOUSE_PAD,\n  CollectionCategory.ACRYLIC,\n  CollectionCategory.BADGE,\n  CollectionCategory.COLOR_PAPER,\n  CollectionCategory.KEYCHAIN,\n  CollectionCategory.TRANSPARENT_CARD,\n  CollectionCategory.LASER_TICKET,\n];\n\nexport function buildDefaultHomeTabConfig(): HomeTabConfigItem[] {\n  const config: HomeTabConfigItem[] = [];\n  let order = 0;\n\n  defaultHomeTabCategoryOrder.forEach((category) => {\n    config.push({ category, visible: true, order });\n    order += 1;\n  });\n\n  return config;\n}\n\nexport function normalizeHomeTabConfig(\n  input?: HomeTabConfigItem[] | null,\n): HomeTabConfigItem[] {\n  if (!input || input.length === 0) {\n    return buildDefaultHomeTabConfig();\n  }\n\n  const filtered = input\n    .filter((item) => item && isValidCategory(item.category))\n    .map((item) => ({\n      category: item.category,\n      visible: item.visible ?? true,\n      order: Number.isFinite(item.order) ? Number(item.order) : 0,\n    }));\n\n  if (filtered.length === 0) {\n    return buildDefaultHomeTabConfig();\n  }\n\n  filtered.sort((a, b) => a.order - b.order);\n  const normalized = filtered.map((item, index) => ({ ...item, order: index }));\n\n  if (!normalized.some((item) => item.visible)) {\n    const firstItem = normalized[0];\n    if (firstItem) {\n      normalized[0] = { ...firstItem, visible: true };\n    }\n  }\n\n  return normalized;\n}\n\n// ===== 表单数据类型 =====\n\n/**\n * 画集表单数据结构\n * \n * 用于创建和编辑画集时的表单数据\n */\nexport interface CollectionFormData {\n  /** 画集标题 */\n  title: string;\n  \n  /** 编号 */\n  number: string;\n  \n  /** 封面图片 */\n  coverImage: string;\n  \n  /** 通用文件服务的封面图片文件ID */\n  coverImageFileId?: string;\n  \n  /** 画集描述 */\n  description: string;\n  \n  /** 画集分类（使用枚举值） */\n  category: CollectionCategoryType;\n  \n  /** 画集标签列表 */\ntags: string[];\n  \n  /** 是否已发布 */\n  isPublished: boolean;\n  \n  /** 画集价格（单位：元，可选） */\n  price?: number;\n}\n\n/**\n * 作品表单数据结构\n * \n * 用于创建和编辑作品时的表单数据\n */\nexport interface ArtworkFormData {\n  /** 作品标题 */\n  title: string;\n  \n  /** 编号 */\n  number: string;\n  \n  /** 作品图片 */\n  image?: string;\n  \n  /** 通用文件服务的图片文件ID */\n  fileId?: string;\n  \n  /** 作品描述 */\n  description: string;\n  \n  /** 创作时间 */\n  createdTime: string;\n  \n  /** 作品主题 */\n  theme: string;\n}\n\n/**\n * 配置表单数据结构\n * \n * 用于编辑系统配置时的表单数据\n */\nexport interface ConfigFormData {\n  /** 网站名称 */\n  siteName: string;\n  \n  /** 网站描述 */\n  siteDescription: string;\n  \n  /** 首页主标题 */\n  heroTitle: string;\n  \n  /** 首页副标题 */\n  heroSubtitle: string;\n  \n  /** 每页显示的最大画集数量 */\n  maxCollectionsPerPage: number;\n  \n  /** 是否启用搜索功能 */\n  enableSearch: boolean;\n  \n  /** 是否启用分类功能 */\n  enableCategories: boolean;\n\n  /** 首页分类Tab配置 */\n  homeTabConfig: HomeTabConfigItem[];\n  \n  /** 默认分类 */\n  defaultCategory: string;\n  \n  /** 主题模式 */\n  theme: 'light' | 'dark' | 'auto';\n  \n  /** 界面语言 */\n  language: 'zh' | 'en';\n}\n\n// ===== 工具函数 =====\n\n/**\n * 获取所有可用的画集分类\n * \n * @returns 分类枚举值数组\n */\nexport function getAvailableCategories(): CollectionCategoryType[] {\n  return Object.values(CollectionCategory);\n}\n\n/**\n * 验证分类是否为有效值\n * \n * @param category - 要验证的分类值\n * @returns 是否为有效分类\n */\nexport function isValidCategory(category: string): category is CollectionCategoryType {\n  if (typeof category !== 'string') {\n    return false;\n  }\n  return category.trim().length > 0;\n}\n\n/**\n * 分类信息映射\n * 为每个分类提供完整的信息对象\n */\nexport const categories = {\n  [CollectionCategory.COLLECTION]: {\n    value: CollectionCategory.COLLECTION,\n    displayName: '画集',\n    description: '用于展示艺术作品'\n  },\n  [CollectionCategory.ACRYLIC]: {\n    value: CollectionCategory.ACRYLIC,\n    displayName: '立牌',\n    description: '立牌制品'\n  },\n  [CollectionCategory.BADGE]: {\n    value: CollectionCategory.BADGE,\n    displayName: '吧唧',\n    description: '徽章类商品'\n  },\n  [CollectionCategory.COLOR_PAPER]: {\n    value: CollectionCategory.COLOR_PAPER,\n    displayName: '色纸',\n    description: '彩色纸张制品'\n  },\n  [CollectionCategory.TRANSPARENT_CARD]: {\n    value: CollectionCategory.TRANSPARENT_CARD,\n    displayName: '透卡',\n    description: '透明卡片制品'\n  },\n  [CollectionCategory.POSTCARD]: {\n    value: CollectionCategory.POSTCARD,\n    displayName: '明信片',\n    description: '明信片类商品'\n  },\n  [CollectionCategory.LASER_TICKET]: {\n    value: CollectionCategory.LASER_TICKET,\n    displayName: '镭射票',\n    description: '镭射票类商品'\n  },\n  [CollectionCategory.CANVAS_BAG]: {\n    value: CollectionCategory.CANVAS_BAG,\n    displayName: '帆布包',\n    description: '帆布包类商品'\n  },\n  [CollectionCategory.SPIRAL_NOTEBOOK]: {\n    value: CollectionCategory.SPIRAL_NOTEBOOK,\n    displayName: '线圈笔记本',\n    description: '线圈装订笔记本'\n  },\n  [CollectionCategory.MOUSE_PAD]: {\n    value: CollectionCategory.MOUSE_PAD,\n    displayName: '鼠标垫',\n    description: '鼠标垫类商品'\n  },\n  [CollectionCategory.SUPPORT_STICK]: {\n    value: CollectionCategory.SUPPORT_STICK,\n    displayName: '应援棒',\n    description: '应援棒类商品'\n  },\n  [CollectionCategory.KEYCHAIN]: {\n    value: CollectionCategory.KEYCHAIN,\n    displayName: '挂件/钥匙扣',\n    description: '挂件/钥匙扣类商品'\n  },\n  [CollectionCategory.OTHER]: {\n    value: CollectionCategory.OTHER,\n    displayName: '其它',\n    description: '其他类型商品'\n  }\n} as const satisfies Record<CollectionCategory, CategoryInfo>;\n\n\n/**\n * 获取分类的显示名称\n * 支持 collection.category.displayName 的调用方式\n */\nexport function getCategoryDisplayName(category: CollectionCategoryType): string {\n  return categories[category as CollectionCategory]?.displayName || category;\n}\n\n/**\n * 获取分类的完整信息\n * 支持 collection.category.displayName 的调用方式\n */\nexport function getCategoryInfo(category: CollectionCategoryType): CategoryInfo {\n  return categories[category as CollectionCategory] || {\n    value: category,\n    displayName: category,\n    description: ''\n  };\n}\n\n/**\n * 扩展 CollectionCategoryType，使其支持 displayName 属性访问\n * 使用方式: collection.category.displayName\n */\ndeclare global {\n  interface String {\n    get displayName(): string;\n    get categoryInfo(): CategoryInfo;\n  }\n}\n\n// 为字符串类型添加 displayName getter（避免重复定义）\nif (!Object.getOwnPropertyDescriptor(String.prototype, 'displayName')) {\n  Object.defineProperty(String.prototype, 'displayName', {\n    get(this: string): string {\n      return getCategoryDisplayName(this as CollectionCategoryType);\n    }\n  });\n}\n\n// 为字符串类型添加 categoryInfo getter（避免重复定义）\nif (!Object.getOwnPropertyDescriptor(String.prototype, 'categoryInfo')) {\n  Object.defineProperty(String.prototype, 'categoryInfo', {\n    get(this: string): CategoryInfo {\n      return getCategoryInfo(this as CollectionCategoryType);\n    }\n  });\n}\n\n/**\n * 获取分类的描述信息 (枚举调用方式)\n */\nexport const CategoryDescription = {\n  [CollectionCategory.COLLECTION]: '用于展示艺术作品，包含多个作品页面的画集',\n  [CollectionCategory.ACRYLIC]: '立牌制品，如亚克力立牌、展示立牌等',\n  [CollectionCategory.BADGE]: '徽章类商品，如徽章、钥匙扣等',\n  [CollectionCategory.COLOR_PAPER]: '彩色纸张制品，如彩色卡纸、彩色打印纸等',\n  [CollectionCategory.TRANSPARENT_CARD]: '透明卡片制品，如透明卡片、透明卡等',\n  [CollectionCategory.POSTCARD]: '明信片类商品，如艺术明信片、纪念明信片等',\n  [CollectionCategory.LASER_TICKET]: '镭射票类商品，如演唱会门票、电影票等',\n  [CollectionCategory.CANVAS_BAG]: '帆布包类商品，如帆布袋、帆布背包等',\n  [CollectionCategory.SPIRAL_NOTEBOOK]: '线圈装订笔记本，如线圈笔记本、线圈装订笔记本等',\n  [CollectionCategory.MOUSE_PAD]: '鼠标垫类商品，如鼠标垫、鼠标垫等',\n  [CollectionCategory.SUPPORT_STICK]: '应援棒类商品，如荧光棒、应援棒等',\n  [CollectionCategory.KEYCHAIN]: '挂件/钥匙扣类商品，如装饰挂件、钥匙扣等',\n  [CollectionCategory.OTHER]: '挂件/钥匙扣类商品，如装饰挂件、钥匙扣等'\n} as const;\n\n// ===== 上下文类型导出 =====\nexport type { CartContextState } from './context'; \n"]}

package/dist/chunk-4NFOSCM6.js

@@ -0,0 +1,34 @@
+'use strict';
+
+var chunkZ6ZWNWWR_js = require('./chunk-Z6ZWNWWR.js');
+
+// src/universalFile/server/types.ts
+var FileServiceError; exports.StorageProviderError = void 0; exports.CDNProviderError = void 0;
+var init_types = chunkZ6ZWNWWR_js.__esm({
+  "src/universalFile/server/types.ts"() {
+    FileServiceError = class extends Error {
+      constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "FileServiceError";
+      }
+    };
+    exports.StorageProviderError = class extends FileServiceError {
+      constructor(message, details) {
+        super(message, "STORAGE_PROVIDER_ERROR", details);
+        this.name = "StorageProviderError";
+      }
+    };
+    exports.CDNProviderError = class extends FileServiceError {
+      constructor(message, details) {
+        super(message, "CDN_PROVIDER_ERROR", details);
+        this.name = "CDNProviderError";
+      }
+    };
+  }
+});
+
+exports.init_types = init_types;
+//# sourceMappingURL=chunk-4NFOSCM6.js.map
+//# sourceMappingURL=chunk-4NFOSCM6.js.map

package/dist/chunk-4NFOSCM6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/universalFile/server/types.ts"],"names":["StorageProviderError","CDNProviderError","__esm"],"mappings":";;;;;AAAA,IA8ca,kBA4BAA,qCAAA,CAAA,CAQAC;AAlfb,IAAA,UAAA,GAAAC,sBAAA,CAAA;AAAA,EAAA,mCAAA,GAAA;AA8cO,IAAM,gBAAA,GAAN,cAA+B,KAAA,CAAM;AAAA,MAC1C,WAAA,CACE,OAAA,EACgB,IAAA,EACA,OAAA,EAChB;AACA,QAAA,KAAA,CAAM,OAAO,CAAA;AAHG,QAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,QAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAGhB,QAAA,IAAA,CAAK,IAAA,GAAO,kBAAA;AAAA,MACd;AAAA,KACF;AAmBO,IAAMF,4BAAA,GAAN,cAAmC,gBAAA,CAAiB;AAAA,MACzD,WAAA,CAAY,SAAiB,OAAA,EAA+B;AAC1D,QAAA,KAAA,CAAM,OAAA,EAAS,0BAA0B,OAAO,CAAA;AAChD,QAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AAAA,MACd;AAAA,KACF;AAGO,IAAMC,wBAAA,GAAN,cAA+B,gBAAA,CAAiB;AAAA,MACrD,WAAA,CAAY,SAAiB,OAAA,EAA+B;AAC1D,QAAA,KAAA,CAAM,OAAA,EAAS,sBAAsB,OAAO,CAAA;AAC5C,QAAA,IAAA,CAAK,IAAA,GAAO,kBAAA;AAAA,MACd;AAAA,KACF;AAAA,EAAA;AAAA,CAAA","file":"chunk-4NFOSCM6.js","sourcesContent":["/**\n * UniversalFile Server 端类型定义\n */\n\nimport type {\n  StorageType as _StorageType,\n  CDNType as _CDNType,\n  ProcessorType as _ProcessorType,\n  FileMetadata,\n  UploadStatus,\n  AccessPermission,\n  UploadFileInfo as _UploadFileInfo,\n  ProcessingOptions as _ProcessingOptions,\n} from '../types';\n\n// Re-export client types for server use\nexport type StorageType = _StorageType;\nexport type CDNType = _CDNType;\nexport type ProcessorType = _ProcessorType;\nexport type UploadFileInfo = _UploadFileInfo;\nexport type ProcessingOptions = _ProcessingOptions;\n\n// ============= Provider 接口 =============\n\n/** 存储提供者接口 */\nexport interface IStorageProvider {\n  /** 提供者类型 */\n  readonly type: StorageType;\n\n  /** 初始化 */\n  initialize(config: StorageConfig): Promise<void>;\n\n  /** 上传文件 */\n  upload(fileInfo: UploadFileInfo, path: string): Promise<StorageResult>;\n\n  /** 下载文件 */\n  download(path: string): Promise<Buffer>;\n\n  /** 删除文件 */\n  delete(path: string): Promise<StorageResult>;\n\n  /** 获取文件信息 */\n  getFileInfo(path: string): Promise<StorageResult>;\n\n  /** 生成访问URL */\n  getAccessUrl(path: string, expiresIn?: number): Promise<string>;\n\n  /** 生成预签名上传URL */\n  getUploadUrl(path: string, expiresIn?: number): Promise<string>;\n\n  /** 检查文件是否存在 */\n  exists(path: string): Promise<boolean>;\n\n  /** 列出文件 */\n  list(prefix: string, maxKeys?: number): Promise<string[]>;\n}\n\n/** CDN 提供者接口 */\nexport interface ICDNProvider {\n  /** 提供者类型 */\n  readonly type: CDNType;\n\n  /** 初始化 */\n  initialize(config: CDNConfig): Promise<void>;\n\n  /** 生成CDN URL */\n  generateUrl(originalUrl: string): Promise<string>;\n\n  /** 刷新缓存 */\n  refreshCache(urls: string[]): Promise<CDNResult>;\n\n  /** 预热缓存 */\n  preheatCache(urls: string[]): Promise<CDNResult>;\n\n  /** 获取访问统计 */\n  getAccessStats(startTime: Date, endTime: Date): Promise<CDNResult>;\n}\n\n/** 文件处理器接口 */\nexport interface IFileProcessor {\n  /** 处理器类型 */\n  readonly type: ProcessorType;\n\n  /** 初始化 */\n  initialize(): Promise<void>;\n\n  /** 处理文件 */\n  process(\n    inputPath: string,\n    outputPath: string,\n    options: ProcessingOptions\n  ): Promise<ProcessingResult>;\n\n  /** 检查文件是否支持处理 */\n  supports(mimeType: string): boolean;\n\n  /** 获取文件信息 */\n  getFileInfo(filePath: string): Promise<Record<string, any>>;\n}\n\n// ============= 配置接口 =============\n\n/** 存储配置基础接口 */\nexport interface StorageConfig {\n  /** 存储类型 */\n  type: StorageType;\n  /** 是否启用 */\n  enabled: boolean;\n}\n\n/** 本地存储配置 */\nexport interface LocalStorageConfig extends StorageConfig {\n  type: 'local';\n  /** 存储根目录 */\n  rootPath: string;\n  /** 基础URL */\n  baseUrl: string;\n}\n\n/** 阿里云 OSS 配置 */\nexport interface AliyunOSSConfig extends StorageConfig {\n  type: 'aliyun-oss';\n  /** 地域 */\n  region: string;\n  /** 存储桶名称 */\n  bucket: string;\n  /** 访问密钥ID */\n  accessKeyId: string;\n  /** 访问密钥密码 */\n  accessKeySecret: string;\n  /** 自定义域名 */\n  customDomain?: string;\n  /** 是否使用HTTPS */\n  secure?: boolean;\n  /** 是否使用内网访问 */\n  internal?: boolean;\n}\n\n/** CDN配置基础接口 */\nexport interface CDNConfig {\n  /** CDN类型 */\n  type: CDNType;\n  /** 是否启用 */\n  enabled: boolean;\n}\n\n/** 阿里云 CDN 配置 */\nexport interface AliyunCDNConfig extends CDNConfig {\n  type: 'aliyun-cdn';\n  /** CDN域名 */\n  domain: string;\n  /** 访问密钥ID */\n  accessKeyId: string;\n  /** 访问密钥密码 */\n  accessKeySecret: string;\n  /** 地域 */\n  region?: string;\n}\n\n/** 缓存配置 */\nexport interface CacheConfig {\n  /** 是否启用缓存 */\n  enabled: boolean;\n  /** 最大缓存大小 */\n  maxSize?: number;\n  /** 缓存 TTL（秒） */\n  ttl?: number;\n  /** 是否使用 Redis */\n  useRedis?: boolean;\n  /** Redis 配置 */\n  redisConfig?: {\n    host: string;\n    port: number;\n    password?: string;\n    db?: number;\n  };\n}\n\n/** 文件服务配置 */\n/** 缓存配置扩展 */\nexport interface CacheConfig {\n  /** 是否启用缓存 */\n  enabled: boolean;\n  /** 元数据缓存TTL（秒） */\n  metadataTTL?: number;\n  /** URL缓存TTL（秒） */\n  urlTTL?: number;\n  /** 最大缓存条目数 */\n  maxSize?: number;\n}\n\nexport interface UniversalFileServiceConfig {\n  /** 存储配置 */\n  storage: StorageConfig;\n  /** CDN 配置（可选） */\n  cdn?: CDNConfig;\n  /** 缓存配置（可选） */\n  cache?: CacheConfig;\n  /** 数据库持久化配置（可选） */\n  persistence?: FileServicePersistenceConfig;\n  /** 启用的处理器 */\n  processors?: ProcessorType[];\n  /** 数据库连接（可选） @deprecated 使用 persistence.repository 代替 */\n  db?: any;\n  /** 最大文件大小（字节） */\n  maxFileSize?: number;\n  /** 允许的文件类型 */\n  allowedMimeTypes?: string[];\n  /** 是否启用监控 */\n  enableMonitoring?: boolean;\n\n  // 运行时字段（由服务类内部管理）\n  /** 存储提供者映射（内部使用） */\n  storageProviders?: Map<StorageType, IStorageProvider>;\n  /** 默认存储类型 */\n  defaultStorage?: StorageType;\n  /** 默认CDN类型 */\n  defaultCDN?: CDNType;\n}\n\n// ============= 结果类型 =============\n\n/** 存储结果 */\n/** 存储操作结果 */\nexport interface StorageResult {\n  /** 是否成功 */\n  success: boolean;\n  /** 存储路径 */\n  path?: string;\n  /** 访问URL */\n  url?: string;\n  /** 文件大小 */\n  size?: number;\n  /** 错误信息 */\n  error?: string;\n  /** 额外数据 */\n  data?: Record<string, any>;\n}\n\n/** 存储元数据 */\nexport interface StorageMetadata {\n  /** 文件大小 */\n  size: number;\n  /** MIME 类型 */\n  mimeType: string;\n  /** 最后修改时间 */\n  lastModified: Date;\n  /** 自定义元数据 */\n  metadata?: Record<string, any>;\n}\n\n/** CDN 结果 */\n/** CDN操作结果 */\nexport interface CDNResult {\n  /** 是否成功 */\n  success: boolean;\n  /** CDN URL */\n  url?: string;\n  /** 错误信息 */\n  error?: string;\n  /** 额外数据 */\n  data?: Record<string, any>;\n}\n\n/** CDN 统计信息 */\nexport interface CDNStats {\n  /** 带宽（字节/秒） */\n  bandwidth: number;\n  /** 请求数 */\n  requests: number;\n  /** 流量（字节） */\n  traffic: number;\n  /** 统计时间范围 */\n  timeRange: {\n    start: Date;\n    end: Date;\n  };\n}\n\n/** 处理结果 */\nexport interface ProcessingResult {\n  /** 是否成功 */\n  success: boolean;\n  /** 处理后的文件路径 */\n  processedPath?: string;\n  /** 处理后的文件大小 */\n  processedSize?: number;\n  /** 缩略图路径 */\n  thumbnailPath?: string;\n  /** 错误信息 */\n  error?: string;\n  /** 处理耗时(毫秒) */\n  processingTime?: number;\n  /** 额外数据 */\n  data?: Record<string, any>;\n}\n\n/** 处理器信息 */\nexport interface ProcessorInfo {\n  /** 处理器名称 */\n  name: string;\n  /** 处理器版本 */\n  version: string;\n  /** 支持的格式 */\n  supportedFormats: string[];\n  /** 支持的操作 */\n  supportedOperations: string[];\n}\n\n// ============= 数据库相关类型 =============\n\n/** 文件数据库记录 */\nexport interface FileRecord extends FileMetadata {\n  /** 创建时间 */\n  createdAt: Date | string;\n  /** 更新时间 */\n  updatedAt: Date | string;\n}\n\n/** 文件查询选项 */\nexport interface FileQueryOptions {\n  /** 模块 ID */\n  moduleId?: string;\n  /** 业务 ID */\n  businessId?: string;\n  /** 上传者 ID */\n  uploaderId?: string;\n  /** 文件类型 */\n  mimeType?: string;\n  /** 访问权限 */\n  permission?: AccessPermission;\n  /** 状态 */\n  status?: UploadStatus;\n  /** 分页 */\n  page?: number;\n  pageSize?: number;\n  /** 排序 */\n  orderBy?: string;\n  orderDirection?: 'asc' | 'desc';\n}\n\n/** 分页结果 */\nexport interface PaginatedResult<T> {\n  /** 数据列表 */\n  items: T[];\n  /** 总数 */\n  total: number;\n  /** 当前页 */\n  page: number;\n  /** 每页大小 */\n  pageSize: number;\n  /** 总页数 */\n  totalPages: number;\n}\n\n// ============= 事件类型 =============\n\n/** 文件事件类型 */\nexport type FileEventType =\n  | 'upload:start'\n  | 'upload:progress'\n  | 'upload:complete'\n  | 'upload:error'\n  | 'download:start'\n  | 'download:complete'\n  | 'download:error'\n  | 'delete:complete'\n  | 'delete:error'\n  | 'process:start'\n  | 'process:complete'\n  | 'process:error';\n\n/** 文件事件 */\nexport interface FileEvent {\n  /** 事件类型 */\n  type: FileEventType;\n  /** 文件 ID */\n  fileId: string;\n  /** 事件数据 */\n  data?: any;\n  /** 时间戳 */\n  timestamp: Date;\n}\n\n/** 事件监听器 */\nexport type FileEventListener = (event: FileEvent) => void | Promise<void>;\n\n// ============= 数据库持久化接口 =============\n\n/**\n * 文件元数据数据库持久化接口\n *\n * 实现此接口以提供自定义的数据库持久化支持\n *\n * @example\n * ```typescript\n * // Drizzle ORM 实现\n * class DrizzleFileRepository implements IFileMetadataRepository {\n *   async save(metadata: FileMetadata): Promise<void> {\n *     await db.insert(fileMetadata).values(metadata);\n *   }\n *   // ... 其他方法\n * }\n * ```\n */\nexport interface IFileMetadataRepository {\n  /**\n   * 保存文件元数据到数据库\n   */\n  save(metadata: FileMetadata): Promise<void>;\n\n  /**\n   * 从数据库获取文件元数据\n   */\n  get(fileId: string): Promise<FileMetadata | null>;\n\n  /**\n   * 查询文件列表\n   */\n  query(options: FileQueryOptions): Promise<PaginatedResult<FileMetadata>>;\n\n  /**\n   * 从数据库删除文件元数据\n   */\n  delete(fileId: string): Promise<void>;\n\n  /**\n   * 批量删除文件元数据\n   */\n  batchDelete(fileIds: string[]): Promise<void>;\n}\n\n/**\n * 数据库持久化配置\n */\nexport interface FileServicePersistenceConfig {\n  /**\n   * 是否启用持久化\n   */\n  enabled: boolean;\n\n  /**\n   * 持久化仓储实现\n   */\n  repository: IFileMetadataRepository;\n\n  /**\n   * 是否自动持久化（默认 true）\n   * 如果为 true，文件上传完成后自动保存到数据库\n   */\n  autoPersist?: boolean;\n\n  /**\n   * 是否优先使用缓存（默认 false）\n   * 如果为 true，查询时优先从缓存获取\n   */\n  cacheFirst?: boolean;\n}\n\n// ============= 异常类型定义 =============\n\n/** 文件服务异常基类 */\nexport class FileServiceError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly details?: Record<string, any>\n  ) {\n    super(message);\n    this.name = 'FileServiceError';\n  }\n}\n\n/** 文件上传异常 */\nexport class FileUploadError extends FileServiceError {\n  constructor(message: string, details?: Record<string, any>) {\n    super(message, 'FILE_UPLOAD_ERROR', details);\n    this.name = 'FileUploadError';\n  }\n}\n\n/** 文件处理异常 */\nexport class FileProcessingError extends FileServiceError {\n  constructor(message: string, details?: Record<string, any>) {\n    super(message, 'FILE_PROCESSING_ERROR', details);\n    this.name = 'FileProcessingError';\n  }\n}\n\n/** 存储提供者异常 */\nexport class StorageProviderError extends FileServiceError {\n  constructor(message: string, details?: Record<string, any>) {\n    super(message, 'STORAGE_PROVIDER_ERROR', details);\n    this.name = 'StorageProviderError';\n  }\n}\n\n/** CDN提供者异常 */\nexport class CDNProviderError extends FileServiceError {\n  constructor(message: string, details?: Record<string, any>) {\n    super(message, 'CDN_PROVIDER_ERROR', details);\n    this.name = 'CDNProviderError';\n  }\n}\n"]}

package/dist/{chunk-3NHAT7D4.mjs → chunk-4VJQZSPU.mjs}

@@ -1,4 +1,4 @@
-import { logger } from './chunk-3DXPQ4YV.mjs';
+import { init_logger, logger } from './chunk-PXWDQFWV.mjs';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 
@@ -262,6 +262,7 @@ var stringUtils = {
 };
 
 // src/utils/debug.ts
+init_logger();
 var debugUtils = {
   /**
    * 安全的 JSON 序列化
@@ -357,5 +358,5 @@ function cn(...inputs) {
 }
 
 export { arrayUtils, cn, debugUtils, errorUtils, fileUtils, formatTime, japaneseUtils, stringUtils, validators };
-//# sourceMappingURL=chunk-3NHAT7D4.mjs.map
-//# sourceMappingURL=chunk-3NHAT7D4.mjs.map
+//# sourceMappingURL=chunk-4VJQZSPU.mjs.map
+//# sourceMappingURL=chunk-4VJQZSPU.mjs.map

package/dist/chunk-4VJQZSPU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/time.ts","../src/utils/japanese.ts","../src/utils/validators.ts","../src/utils/file.ts","../src/utils/array.ts","../src/utils/string.ts","../src/utils/debug.ts","../src/utils/error.ts","../src/utils/cn.ts"],"names":[],"mappings":"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","file":"chunk-4VJQZSPU.mjs","sourcesContent":["/**\n * 时间格式化工具\n */\n\nexport const formatTime = {\n  /**\n   * 将秒数转换为 MM:SS 格式\n   */\n  toMinutesSeconds(seconds: number): string {\n    const minutes = Math.floor(seconds / 60);\n    const remainingSeconds = Math.floor(seconds % 60);\n    return minutes + ':' + remainingSeconds.toString().padStart(2, '0');\n  },\n\n  /**\n   * 将秒数转换为 HH:MM:SS 格式\n   */\n  toHoursMinutesSeconds(seconds: number): string {\n    const hours = Math.floor(seconds / 3600);\n    const minutes = Math.floor((seconds % 3600) / 60);\n    const remainingSeconds = Math.floor(seconds % 60);\n\n    if (hours > 0) {\n      return hours + ':' + minutes.toString().padStart(2, '0') + ':' + remainingSeconds.toString().padStart(2, '0');\n    }\n    return minutes + ':' + remainingSeconds.toString().padStart(2, '0');\n  },\n\n  /**\n   * 格式化日期为用户友好的格式\n   */\n  formatDate(date: string | Date, locale = 'zh-CN'): string {\n    const d = new Date(date);\n    const now = new Date();\n    const diffMs = now.getTime() - d.getTime();\n    const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));\n\n    if (diffDays === 0) {\n      return locale === 'zh-CN' ? '今天' : 'Today';\n    } else if (diffDays === 1) {\n      return locale === 'zh-CN' ? '昨天' : 'Yesterday';\n    } else if (diffDays < 7) {\n      return locale === 'zh-CN' ? diffDays + '天前' : diffDays + ' days ago';\n    } else {\n      return d.toLocaleDateString(locale);\n    }\n  },\n};\n\n","/**\n * 日语文本处理工具\n */\n\nexport const japaneseUtils = {\n  /**\n   * 提取文本中的汉字\n   */\n  extractKanji(text: string): string[] {\n    return text.match(/[\\u4E00-\\u9FAF]/g) || [];\n  },\n\n  /**\n   * 提取文本中的假名\n   */\n  extractKana(text: string): string[] {\n    return text.match(/[\\u3040-\\u309F\\u30A0-\\u30FF]/g) || [];\n  },\n\n  /**\n   * 清理文本，移除特殊字符但保留日语字符\n   */\n  cleanText(text: string): string {\n    return text.replace(/[^\\u3040-\\u309F\\u30A0-\\u30FF\\u4E00-\\u9FAF\\w\\s]/g, '');\n  },\n};\n","/**\n * 验证工具\n */\n\nexport const validators = {\n  /**\n   * 验证邮箱格式\n   */\n  isValidEmail(email: string): boolean {\n    const emailRegex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n    return emailRegex.test(email);\n  },\n\n  /**\n   * 验证密码强度\n   */\n  isValidPassword(password: string): {\n    isValid: boolean;\n    errors: string[];\n  } {\n    const errors: string[] = [];\n\n    if (password.length < 6) {\n      errors.push('Password must be at least 6 characters');\n    }\n\n    if (password.length > 50) {\n      errors.push('Password must not exceed 50 characters');\n    }\n\n    if (!/[a-zA-Z]/.test(password)) {\n      errors.push('Password must contain at least one letter');\n    }\n\n    if (!/[0-9]/.test(password)) {\n      errors.push('Password must contain at least one number');\n    }\n\n    return {\n      isValid: errors.length === 0,\n      errors,\n    };\n  },\n\n  /**\n   * 验证用户名格式\n   */\n  isValidUsername(username: string): boolean {\n    const usernameRegex = /^[a-zA-Z0-9_]{3,20}$/;\n    return usernameRegex.test(username);\n  },\n\n  /**\n   * 验证文件大小\n   */\n  isValidFileSize(size: number, maxSize: number): boolean {\n    return size > 0 && size <= maxSize;\n  },\n\n  /**\n   * 验证文件类型\n   */\n  isValidFileType(type: string, supportedTypes: string[]): boolean {\n    return supportedTypes.includes(type);\n  },\n\n  /**\n   * 验证 URL 格式\n   */\n  isValidUrl(url: string): boolean {\n    try {\n      new URL(url);\n      return true;\n    } catch {\n      return false;\n    }\n  },\n};\n\n","/**\n * 文件处理工具\n */\n\nexport const fileUtils = {\n  /**\n   * 格式化文件大小\n   */\n  formatFileSize(bytes: number): string {\n    if (bytes === 0) return '0 Bytes';\n\n    const k = 1024;\n    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];\n    const i = Math.floor(Math.log(bytes) / Math.log(k));\n\n    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];\n  },\n\n  /**\n   * 获取文件扩展名\n   */\n  getFileExtension(filename: string): string {\n    return filename.slice(((filename.lastIndexOf('.') - 1) >>> 0) + 2);\n  },\n\n  /**\n   * 生成唯一文件名\n   */\n  generateUniqueFileName(originalName: string): string {\n    const timestamp = Date.now();\n    const random = Math.random().toString(36).substring(2, 15);\n    const extension = this.getFileExtension(originalName);\n    const baseName = originalName.replace('.' + (extension), '');\n    return extension ? (baseName) + '_' + (timestamp) + '_' + (random) + '.' + (extension) : (baseName) + '_' + (timestamp) + '_' + (random);\n  },\n\n  /**\n   * 验证文件名是否有效\n   */\n  isValidFilename(filename: string): boolean {\n    // 不允许包含特殊字符\n    const invalidChars = /[<>:\"/\\\\|?*\\x00-\\x1F]/g;\n    return !invalidChars.test(filename) && filename.length > 0 && filename.length <= 255;\n  },\n};\n\n","/**\n * 数组和对象工具\n */\n\nexport const arrayUtils = {\n  /**\n   * 数组去重\n   */\n  unique<T>(array: T[]): T[] {\n    return [...new Set(array)];\n  },\n\n  /**\n   * 数组分组\n   */\n  groupBy<T>(array: T[], key: keyof T): Record<string, T[]> {\n    return array.reduce(\n      (groups, item) => {\n        const groupKey = String(item[key]);\n        const group = groups[groupKey] || [];\n        group.push(item);\n        groups[groupKey] = group;\n        return groups;\n      },\n      {} as Record<string, T[]>\n    );\n  },\n\n  /**\n   * 数组分页\n   */\n  paginate<T>(\n    array: T[],\n    page: number,\n    limit: number\n  ): {\n    data: T[];\n    total: number;\n    page: number;\n    pages: number;\n    hasNext: boolean;\n    hasPrev: boolean;\n  } {\n    const total = array.length;\n    const pages = Math.ceil(total / limit);\n    const start = (page - 1) * limit;\n    const end = start + limit;\n    const data = array.slice(start, end);\n\n    return {\n      data,\n      total,\n      page,\n      pages,\n      hasNext: page < pages,\n      hasPrev: page > 1,\n    };\n  },\n\n  /**\n   * 数组随机排序\n   */\n  shuffle<T>(array: T[]): T[] {\n    const shuffled = [...array];\n    for (let i = shuffled.length - 1; i > 0; i--) {\n      const j = Math.floor(Math.random() * (i + 1));\n      [shuffled[i], shuffled[j]] = [shuffled[j]!, shuffled[i]!];\n    }\n    return shuffled;\n  },\n};\n\n","/**\n * 字符串工具\n */\n\nexport const stringUtils = {\n  /**\n   * 截断文本\n   */\n  truncate(text: string, length: number, suffix = '...'): string {\n    if (text.length <= length) return text;\n    return text.substring(0, length - suffix.length) + suffix;\n  },\n\n  /**\n   * 首字母大写\n   */\n  capitalize(text: string): string {\n    if (!text) return '';\n    return text.charAt(0).toUpperCase() + text.slice(1).toLowerCase();\n  },\n\n  /**\n   * 驼峰转下划线\n   */\n  camelToSnake(text: string): string {\n    return text.replace(/[A-Z]/g, (letter) => '_' + (letter.toLowerCase()));\n  },\n\n  /**\n   * 下划线转驼峰\n   */\n  snakeToCamel(text: string): string {\n    return text.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());\n  },\n\n  /**\n   * 生成随机字符串\n   */\n  generateRandom(length: number): string {\n    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';\n    let result = '';\n    for (let i = 0; i < length; i++) {\n      result += chars.charAt(Math.floor(Math.random() * chars.length));\n    }\n    return result;\n  },\n};\n\n","/**\n * 调试工具\n */\n\nimport { logger } from '../logger';\nimport { fileUtils } from './file';\n\nexport const debugUtils = {\n  /**\n   * 安全的 JSON 序列化\n   */\n  safeStringify(obj: any): string {\n    try {\n      return JSON.stringify(obj, null, 2);\n    } catch (error) {\n      return '[Circular Reference or Invalid JSON: ' + (error) + ']';\n    }\n  },\n\n  /**\n   * 性能计时器\n   */\n  createTimer(label?: string) {\n    const start = typeof performance !== 'undefined' ? performance.now() : Date.now();\n    return {\n      end: () => {\n        const end = typeof performance !== 'undefined' ? performance.now() : Date.now();\n        const duration = end - start;\n        const message = (label || 'Timer') + ': ' + (duration.toFixed(2)) + 'ms';\n        logger.info(message);\n        return duration;\n      },\n    };\n  },\n\n  /**\n   * 内存使用情况（仅在 Node.js 环境）\n   */\n  getMemoryUsage(): Record<string, string> | null {\n    if (typeof process !== 'undefined' && process.memoryUsage) {\n      const usage = process.memoryUsage();\n      return {\n        rss: fileUtils.formatFileSize(usage.rss),\n        heapTotal: fileUtils.formatFileSize(usage.heapTotal),\n        heapUsed: fileUtils.formatFileSize(usage.heapUsed),\n        external: fileUtils.formatFileSize(usage.external),\n      };\n    }\n    return null;\n  },\n};\n\n","/**\n * 错误处理工具\n */\n\nexport const errorUtils = {\n  /**\n   * 创建标准化的错误对象\n   */\n  createError(\n    code: string,\n    message: string,\n    details?: any\n  ): Error & { code: string; details?: any } {\n    const error = new Error(message) as Error & { code: string; details?: any };\n    error.code = code;\n    if (details) {\n      error.details = details;\n    }\n    return error;\n  },\n\n  /**\n   * 安全的错误信息提取\n   */\n  extractErrorMessage(error: unknown): string {\n    if (error instanceof Error) {\n      return error.message;\n    }\n    if (typeof error === 'string') {\n      return error;\n    }\n    if (error && typeof error === 'object' && 'message' in error) {\n      return String(error.message);\n    }\n    return 'Unknown error';\n  },\n\n  /**\n   * 错误重试机制\n   */\n  async retry<T>(fn: () => Promise<T>, maxAttempts = 3, delay = 1000): Promise<T> {\n    let lastError: Error;\n\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        return await fn();\n      } catch (error) {\n        lastError = error instanceof Error ? error : new Error(String(error));\n\n        if (attempt === maxAttempts) {\n          throw lastError;\n        }\n\n        // 指数退避延迟\n        await new Promise((resolve) => setTimeout(resolve, delay * Math.pow(2, attempt - 1)));\n      }\n    }\n\n    throw lastError!;\n  },\n};\n\n","import { clsx, type ClassValue } from \"clsx\"\nimport { twMerge } from \"tailwind-merge\"\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs))\n}\n\n"]}