sa2kit 1.6.48 → 1.6.50

package/dist/showmasterpiece/index.d.mts

@@ -379,7 +379,13 @@ interface MasterpiecesConfig {
     /** 界面语言：zh(中文)、en(英文) */
     language: 'zh' | 'en';
 }
+interface CategoryOption {
+    name: string;
+    description?: string | null;
+}
 interface HomeTabConfigItem {
+    name?: string;
+    description?: string | null;
     category: CollectionCategoryType;
     visible: boolean;
     order: number;
@@ -1039,7 +1045,7 @@ declare class MasterpiecesService {
      * 从后端API获取所有已定义的画集分类列表。
      * 用于构建分类筛选器和下拉菜单。
      *
-     * @returns Promise<string[]> 分类名称数组
+     * @returns Promise<Array<{ name: string; description?: string | null }>> 分类名称数组
      * @throws {Error} 当API请求失败时抛出错误
      *
      * @example
@@ -1048,7 +1054,10 @@ declare class MasterpiecesService {
      * console.log('可用分类:', categories);
      * ```
      */
-    static getCategories(): Promise<string[]>;
+    static getCategories(): Promise<Array<{
+        name: string;
+        description?: string | null;
+    }>>;
     /**
      * 获取所有可用标签
      *
@@ -1094,7 +1103,10 @@ declare const updateArtworkOrder: (collectionId: number, artworkOrders: {
 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 getCategories: () => Promise<Array<{
+    name: string;
+    description?: string | null;
+}>>;
 declare const createCategory: (name: string, description?: string) => Promise<void>;
 declare const getTags: () => Promise<string[]>;
 declare function getCollectionsOverview(): Promise<Omit<ArtCollection, 'pages'>[]>;
@@ -2136,7 +2148,7 @@ declare const useMasterpieces: () => {
 declare const useMasterpiecesConfig: () => {
     config: MasterpiecesConfig | null;
     collections: ArtCollection[];
-    categories: string[];
+    categories: CategoryOption[];
     tags: string[];
     loading: boolean;
     error: string | null;
@@ -2164,7 +2176,10 @@ declare const useMasterpiecesConfig: () => {
     refreshData: () => Promise<{
         config: MasterpiecesConfig;
         collections: any;
-        categories: string[];
+        categories: {
+            name: string;
+            description?: string | null;
+        }[];
         tags: string[];
     }>;
 };

package/dist/showmasterpiece/index.d.ts

@@ -379,7 +379,13 @@ interface MasterpiecesConfig {
     /** 界面语言：zh(中文)、en(英文) */
     language: 'zh' | 'en';
 }
+interface CategoryOption {
+    name: string;
+    description?: string | null;
+}
 interface HomeTabConfigItem {
+    name?: string;
+    description?: string | null;
     category: CollectionCategoryType;
     visible: boolean;
     order: number;
@@ -1039,7 +1045,7 @@ declare class MasterpiecesService {
      * 从后端API获取所有已定义的画集分类列表。
      * 用于构建分类筛选器和下拉菜单。
      *
-     * @returns Promise<string[]> 分类名称数组
+     * @returns Promise<Array<{ name: string; description?: string | null }>> 分类名称数组
      * @throws {Error} 当API请求失败时抛出错误
      *
      * @example
@@ -1048,7 +1054,10 @@ declare class MasterpiecesService {
      * console.log('可用分类:', categories);
      * ```
      */
-    static getCategories(): Promise<string[]>;
+    static getCategories(): Promise<Array<{
+        name: string;
+        description?: string | null;
+    }>>;
     /**
      * 获取所有可用标签
      *
@@ -1094,7 +1103,10 @@ declare const updateArtworkOrder: (collectionId: number, artworkOrders: {
 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 getCategories: () => Promise<Array<{
+    name: string;
+    description?: string | null;
+}>>;
 declare const createCategory: (name: string, description?: string) => Promise<void>;
 declare const getTags: () => Promise<string[]>;
 declare function getCollectionsOverview(): Promise<Omit<ArtCollection, 'pages'>[]>;
@@ -2136,7 +2148,7 @@ declare const useMasterpieces: () => {
 declare const useMasterpiecesConfig: () => {
     config: MasterpiecesConfig | null;
     collections: ArtCollection[];
-    categories: string[];
+    categories: CategoryOption[];
     tags: string[];
     loading: boolean;
     error: string | null;
@@ -2164,7 +2176,10 @@ declare const useMasterpiecesConfig: () => {
     refreshData: () => Promise<{
         config: MasterpiecesConfig;
         collections: any;
-        categories: string[];
+        categories: {
+            name: string;
+            description?: string | null;
+        }[];
         tags: string[];
     }>;
 };

package/dist/showmasterpiece/index.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkERNZE5CJ_js = require('../chunk-ERNZE5CJ.js');
+var chunkIZOIVYOW_js = require('../chunk-IZOIVYOW.js');
 var chunkDM2GUVUH_js = require('../chunk-DM2GUVUH.js');
 require('../chunk-UIYKZ73N.js');
 var chunk4XXIBWCO_js = require('../chunk-4XXIBWCO.js');
@@ -168,7 +168,7 @@ var init_masterpiecesService = chunkZ6ZWNWWR_js.__esm({
        * 从后端API获取所有已定义的画集分类列表。
        * 用于构建分类筛选器和下拉菜单。
        * 
-       * @returns Promise<string[]> 分类名称数组
+       * @returns Promise<Array<{ name: string; description?: string | null }>> 分类名称数组
        * @throws {Error} 当API请求失败时抛出错误
        * 
        * @example
@@ -182,7 +182,8 @@ var init_masterpiecesService = chunkZ6ZWNWWR_js.__esm({
         if (!response.ok) {
           throw new Error("\u83B7\u53D6\u5206\u7C7B\u5931\u8D25");
         }
-        return await response.json();
+        const payload = await response.json();
+        return Array.isArray(payload) ? payload : payload?.data ?? [];
       }
       /**
        * 获取所有可用标签
@@ -8463,7 +8464,7 @@ function ShowMasterPiecesContent() {
     return () => clearTimeout(timer);
   }, [triggerCheck]);
   const homeTabConfig = React30.useMemo(
-    () => chunkERNZE5CJ_js.normalizeHomeTabConfig(config?.homeTabConfig),
+    () => chunkIZOIVYOW_js.normalizeHomeTabConfig(config?.homeTabConfig),
     [config?.homeTabConfig]
   );
   const visibleHomeTabs = React30.useMemo(
@@ -8530,7 +8531,7 @@ function ShowMasterPiecesContent() {
   const userId = user?.id || 1;
   const categoryList = visibleHomeTabs.map((tab) => ({
     category: tab.category,
-    displayName: chunkERNZE5CJ_js.getCategoryDisplayName(tab.category)
+    displayName: tab.description || tab.name || chunkIZOIVYOW_js.getCategoryDisplayName(tab.category)
   }));
   return /* @__PURE__ */ React30__default.default.createElement(exports.CartProvider, { userId }, /* @__PURE__ */ React30__default.default.createElement("div", { className: "min-h-screen bg-gradient-to-br from-white to-prussian-blue-900/5 overflow-x-hidden" }, /* @__PURE__ */ React30__default.default.createElement("div", { className: "bg-white/95 backdrop-blur supports-[backdrop-filter]:bg-white/80 border-b border-prussian-blue-200/30 sticky top-0 z-50" }, /* @__PURE__ */ React30__default.default.createElement("div", { className: "max-w-7xl mx-auto px-3 sm:px-4 py-3 sm:py-4" }, /* @__PURE__ */ React30__default.default.createElement("div", { className: "flex items-center justify-between gap-2 sm:gap-4 min-h-[44px]" }, /* @__PURE__ */ React30__default.default.createElement("div", { className: "flex items-center gap-4 sm:gap-8 min-w-0 flex-1" }, selectedCollection && /* @__PURE__ */ React30__default.default.createElement(
     chunk4XXIBWCO_js.Button,
@@ -8661,6 +8662,7 @@ function ConfigPageContent() {
   const [showArtworkOrder, setShowArtworkOrder] = React30.useState(false);
   const [showCollectionOrder, setShowCollectionOrder] = React30.useState(false);
   const [newHomeTabCategory, setNewHomeTabCategory] = React30.useState("");
+  const [newHomeTabDescription, setNewHomeTabDescription] = React30.useState("");
   const [categoryOptions, setCategoryOptions] = React30.useState([]);
   const {
     bookings,
@@ -8704,7 +8706,7 @@ function ConfigPageContent() {
     enableSearch: config?.enableSearch || true,
     enableCategories: config?.enableCategories || true,
     defaultCategory: config?.defaultCategory || "all",
-    homeTabConfig: chunkERNZE5CJ_js.normalizeHomeTabConfig(config?.homeTabConfig),
+    homeTabConfig: chunkIZOIVYOW_js.normalizeHomeTabConfig(config?.homeTabConfig),
     theme: config?.theme || "light",
     language: config?.language || "zh"
   });
@@ -8738,7 +8740,7 @@ function ConfigPageContent() {
         enableSearch: config.enableSearch,
         enableCategories: config.enableCategories,
         defaultCategory: config.defaultCategory,
-        homeTabConfig: chunkERNZE5CJ_js.normalizeHomeTabConfig(config.homeTabConfig),
+        homeTabConfig: chunkIZOIVYOW_js.normalizeHomeTabConfig(config.homeTabConfig),
         theme: config.theme,
         language: config.language
       });
@@ -8762,7 +8764,7 @@ function ConfigPageContent() {
       }
       updated[index] = targetItem;
       updated[targetIndex] = currentItem;
-      const normalized = chunkERNZE5CJ_js.normalizeHomeTabConfig(
+      const normalized = chunkIZOIVYOW_js.normalizeHomeTabConfig(
         updated.map((item, newIndex) => ({ ...item, order: newIndex }))
       );
       return { ...prev, homeTabConfig: normalized };
@@ -8773,15 +8775,16 @@ function ConfigPageContent() {
       const updated = prev.homeTabConfig.map(
         (item) => item.category === category ? { ...item, visible: !item.visible } : item
       );
-      return { ...prev, homeTabConfig: chunkERNZE5CJ_js.normalizeHomeTabConfig(updated) };
+      return { ...prev, homeTabConfig: chunkIZOIVYOW_js.normalizeHomeTabConfig(updated) };
     });
   };
   const handleResetHomeTabs = () => {
     setConfigForm((prev) => ({
       ...prev,
-      homeTabConfig: chunkERNZE5CJ_js.buildDefaultHomeTabConfig()
+      homeTabConfig: chunkIZOIVYOW_js.buildDefaultHomeTabConfig()
     }));
     setNewHomeTabCategory("");
+    setNewHomeTabDescription("");
   };
   const handleSetAllHomeTabsVisible = (visible) => {
     setConfigForm((prev) => {
@@ -8789,11 +8792,12 @@ function ConfigPageContent() {
         ...item,
         visible
       }));
-      return { ...prev, homeTabConfig: chunkERNZE5CJ_js.normalizeHomeTabConfig(updated) };
+      return { ...prev, homeTabConfig: chunkIZOIVYOW_js.normalizeHomeTabConfig(updated) };
     });
   };
   const handleAddHomeTab = async () => {
     const trimmed = newHomeTabCategory.trim();
+    const trimmedDescription = newHomeTabDescription.trim();
     if (!trimmed) {
       alert("\u5206\u7C7B\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A");
       setNewHomeTabCategory("");
@@ -8807,26 +8811,34 @@ function ConfigPageContent() {
       setNewHomeTabCategory("");
       return;
     }
-    const hasCategory = categoryOptions.some(
-      (category) => category.toLowerCase() === trimmed.toLowerCase()
+    const existingCategory = categoryOptions.find(
+      (category) => category.name.toLowerCase() === trimmed.toLowerCase()
     );
+    const description = trimmedDescription || existingCategory?.description || "";
+    if (!description) {
+      alert("\u5C55\u793A\u6587\u6848\u4E0D\u80FD\u4E3A\u7A7A");
+      return;
+    }
     try {
-      if (!hasCategory) {
-        await exports.createCategory(trimmed);
-        setCategoryOptions((prev) => [...prev, trimmed]);
+      if (!existingCategory) {
+        await exports.createCategory(trimmed, description);
+        setCategoryOptions((prev) => [...prev, { name: trimmed, description }]);
       }
       setConfigForm((prev) => {
         const updated = [
           ...prev.homeTabConfig,
           {
+            name: trimmed,
+            description,
             category: trimmed,
             visible: true,
             order: prev.homeTabConfig.length
           }
         ];
-        return { ...prev, homeTabConfig: chunkERNZE5CJ_js.normalizeHomeTabConfig(updated) };
+        return { ...prev, homeTabConfig: chunkIZOIVYOW_js.normalizeHomeTabConfig(updated) };
       });
       setNewHomeTabCategory("");
+      setNewHomeTabDescription("");
     } catch (error2) {
       console.error("\u65B0\u589E\u5206\u7C7B\u5931\u8D25:", error2);
       alert(error2 instanceof Error ? error2.message : "\u65B0\u589E\u5206\u7C7B\u5931\u8D25");
@@ -8838,7 +8850,7 @@ function ConfigPageContent() {
         return prev;
       }
       const updated = prev.homeTabConfig.filter((item) => item.category !== category);
-      return { ...prev, homeTabConfig: chunkERNZE5CJ_js.normalizeHomeTabConfig(updated) };
+      return { ...prev, homeTabConfig: chunkIZOIVYOW_js.normalizeHomeTabConfig(updated) };
     });
   };
   React30__default.default.useEffect(() => {
@@ -9131,12 +9143,19 @@ function ConfigPageContent() {
       onChange: (e) => setConfigForm((prev) => ({ ...prev, enableCategories: e.target.checked })),
       className: "h-4 w-4 rounded border-gray-300"
     }
-  ), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Label, { htmlFor: "enableCategories", className: "text-sm font-medium" }, "\u542F\u7528\u5206\u7C7B\u529F\u80FD")))))), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.TabsContent, { value: "homeTabs", className: "space-y-6" }, /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Card, null, /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.CardHeader, null, /* @__PURE__ */ React30__default.default.createElement("div", { className: "flex items-center justify-between" }, /* @__PURE__ */ React30__default.default.createElement("div", null, /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.CardTitle, null, "\u9996\u9875\u5206\u7C7BTab\u914D\u7F6E"), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.CardDescription, null, "\u7BA1\u7406\u9996\u9875\u5206\u7C7BTab\u7684\u663E\u793A\u987A\u5E8F\u4E0E\u663E\u793A/\u9690\u85CF")), /* @__PURE__ */ React30__default.default.createElement("div", { className: "flex gap-3" }, /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Button, { variant: "outline", onClick: () => handleSetAllHomeTabsVisible(true) }, "\u5168\u90E8\u663E\u793A"), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Button, { variant: "outline", onClick: () => handleSetAllHomeTabsVisible(false) }, "\u5168\u90E8\u9690\u85CF"), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Button, { variant: "outline", onClick: handleResetHomeTabs, className: "gap-2" }, /* @__PURE__ */ React30__default.default.createElement(lucideReact.RotateCcw, { size: 16 }), "\u91CD\u7F6E\u987A\u5E8F"), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Button, { onClick: handleSaveConfig, className: "gap-2" }, /* @__PURE__ */ React30__default.default.createElement(lucideReact.Save, { size: 16 }), "\u4FDD\u5B58\u914D\u7F6E")))), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.CardContent, null, /* @__PURE__ */ React30__default.default.createElement("div", { className: "flex flex-col lg:flex-row lg:items-end gap-3 mb-4" }, /* @__PURE__ */ React30__default.default.createElement("div", { className: "flex-1 space-y-2" }, /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Label, null, "\u65B0\u589E\u5206\u7C7BTab"), /* @__PURE__ */ React30__default.default.createElement(
+  ), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Label, { htmlFor: "enableCategories", className: "text-sm font-medium" }, "\u542F\u7528\u5206\u7C7B\u529F\u80FD")))))), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.TabsContent, { value: "homeTabs", className: "space-y-6" }, /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Card, null, /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.CardHeader, null, /* @__PURE__ */ React30__default.default.createElement("div", { className: "flex items-center justify-between" }, /* @__PURE__ */ React30__default.default.createElement("div", null, /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.CardTitle, null, "\u9996\u9875\u5206\u7C7BTab\u914D\u7F6E"), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.CardDescription, null, "\u7BA1\u7406\u9996\u9875\u5206\u7C7BTab\u7684\u663E\u793A\u987A\u5E8F\u4E0E\u663E\u793A/\u9690\u85CF")), /* @__PURE__ */ React30__default.default.createElement("div", { className: "flex gap-3" }, /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Button, { variant: "outline", onClick: () => handleSetAllHomeTabsVisible(true) }, "\u5168\u90E8\u663E\u793A"), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Button, { variant: "outline", onClick: () => handleSetAllHomeTabsVisible(false) }, "\u5168\u90E8\u9690\u85CF"), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Button, { variant: "outline", onClick: handleResetHomeTabs, className: "gap-2" }, /* @__PURE__ */ React30__default.default.createElement(lucideReact.RotateCcw, { size: 16 }), "\u91CD\u7F6E\u987A\u5E8F"), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Button, { onClick: handleSaveConfig, className: "gap-2" }, /* @__PURE__ */ React30__default.default.createElement(lucideReact.Save, { size: 16 }), "\u4FDD\u5B58\u914D\u7F6E")))), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.CardContent, null, /* @__PURE__ */ React30__default.default.createElement("div", { className: "flex flex-col lg:flex-row lg:items-end gap-3 mb-4" }, /* @__PURE__ */ React30__default.default.createElement("div", { className: "flex-1 space-y-2" }, /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Label, null, "\u5206\u7C7B\u540D\u79F0"), /* @__PURE__ */ React30__default.default.createElement(
     chunk4XXIBWCO_js.Input,
     {
       value: newHomeTabCategory,
       onChange: (e) => setNewHomeTabCategory(e.target.value),
-      placeholder: "\u8F93\u5165\u65B0\u5206\u7C7B\u540D\u79F0"
+      placeholder: "\u8F93\u5165\u5206\u7C7B\u540D\u79F0"
+    }
+  ), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Label, null, "\u5C55\u793A\u6587\u6848"), /* @__PURE__ */ React30__default.default.createElement(
+    chunk4XXIBWCO_js.Input,
+    {
+      value: newHomeTabDescription,
+      onChange: (e) => setNewHomeTabDescription(e.target.value),
+      placeholder: "\u8F93\u5165\u5C55\u793A\u6587\u6848"
     }
   )), /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Button, { onClick: handleAddHomeTab, className: "gap-2" }, /* @__PURE__ */ React30__default.default.createElement(lucideReact.Plus, { size: 16 }), "\u65B0\u589ETab")), /* @__PURE__ */ React30__default.default.createElement("div", { className: "space-y-2" }, configForm.homeTabConfig.map((item, index) => /* @__PURE__ */ React30__default.default.createElement(
     "div",
@@ -9144,7 +9163,7 @@ function ConfigPageContent() {
       key: item.category,
       className: "flex flex-col sm:flex-row sm:items-center sm:justify-between gap-3 p-3 border border-slate-200 rounded-lg bg-white"
     },
-    /* @__PURE__ */ React30__default.default.createElement("div", { className: "flex items-center gap-3" }, /* @__PURE__ */ React30__default.default.createElement("span", { className: "text-sm font-semibold text-slate-800" }, chunkERNZE5CJ_js.getCategoryDisplayName(item.category)), !item.visible && /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Badge, { variant: "secondary", className: "text-xs" }, "\u5DF2\u9690\u85CF")),
+    /* @__PURE__ */ React30__default.default.createElement("div", { className: "flex items-center gap-3" }, /* @__PURE__ */ React30__default.default.createElement("div", { className: "flex flex-col" }, /* @__PURE__ */ React30__default.default.createElement("span", { className: "text-sm font-semibold text-slate-800" }, item.description || item.name || chunkIZOIVYOW_js.getCategoryDisplayName(item.category)), item.description ? /* @__PURE__ */ React30__default.default.createElement("span", { className: "text-xs text-slate-500" }, item.name || item.category) : null), !item.visible && /* @__PURE__ */ React30__default.default.createElement(chunk4XXIBWCO_js.Badge, { variant: "secondary", className: "text-xs" }, "\u5DF2\u9690\u85CF")),
     /* @__PURE__ */ React30__default.default.createElement("div", { className: "flex items-center gap-2" }, /* @__PURE__ */ React30__default.default.createElement(
       chunk4XXIBWCO_js.Button,
       {
@@ -9401,7 +9420,7 @@ function ConfigPageContent() {
       onChange: (e) => setCollectionForm((prev) => ({ ...prev, category: e.target.value })),
       className: "w-full px-3 py-2 border border-slate-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent"
     },
-    categoryOptions.map((category) => /* @__PURE__ */ React30__default.default.createElement("option", { key: category, value: category }, chunkERNZE5CJ_js.getCategoryDisplayName(category)))
+    categoryOptions.map((category) => /* @__PURE__ */ React30__default.default.createElement("option", { key: category.name, value: category.name }, category.description || chunkIZOIVYOW_js.getCategoryDisplayName(category.name)))
   )), /* @__PURE__ */ React30__default.default.createElement("div", null, /* @__PURE__ */ React30__default.default.createElement("label", { className: "block text-sm font-medium text-slate-700 mb-2" }, "\u4EF7\u683C\uFF08\u5143\uFF09"), /* @__PURE__ */ React30__default.default.createElement(
     "input",
     {