@pisell/private-materials 6.8.13 → 6.8.15

package/lib/components/systemSettings/registry/types.d.ts

@@ -0,0 +1,126 @@
+import { CSSProperties } from 'react';
+export interface MultiLanguageText {
+    en: string;
+    'zh-CN': string;
+    'zh-HK': string;
+    original: string;
+}
+export interface BaseItem {
+    id: number;
+    name: string | MultiLanguageText;
+    code: string;
+    order?: number;
+}
+export interface SettingItem extends BaseItem {
+    key?: string;
+    scopes?: string[];
+    groupId?: number;
+    group_id?: number;
+    fieldType?: string;
+    type?: string;
+    interfaceType?: string;
+    interface?: string;
+    description?: string | MultiLanguageText;
+    systemDefaultValue?: string;
+    default?: string;
+    uiSchema?: string;
+    schema?: any;
+    title?: string | MultiLanguageText;
+    sort: number;
+    created_at?: string | null;
+    updated_at?: string | null;
+    deleted_at?: string | null;
+}
+export interface SettingGroup extends BaseItem {
+    items: SettingItem[];
+    expanded?: boolean;
+    sort: number;
+}
+export interface Section extends BaseItem {
+    icon?: string;
+    description?: string | MultiLanguageText;
+    groups: SettingGroup[];
+    created_at?: string | null;
+    updated_at?: string | null;
+    deleted_at?: string | null;
+}
+export interface TreeNode {
+    key: string;
+    type: 'group' | 'item';
+    data: SettingGroup | SettingItem;
+    children?: TreeNode[];
+    parentKey?: string;
+}
+export declare type OperationType = 'add' | 'edit' | 'delete';
+export interface DragItem {
+    id: number;
+    type: 'group' | 'item';
+    groupId?: number;
+}
+export interface RegistryProps {
+    className?: string;
+    style?: CSSProperties;
+    sections?: Section[];
+    selectedSectionId?: number;
+    onSectionSelect?: (sectionId: number) => void;
+    onDataChange?: (sections: Section[]) => void;
+}
+export interface SectionListProps {
+    sections: Section[];
+    selectedSectionId?: number;
+    onSectionSelect: (sectionId: number) => void;
+    loading?: boolean;
+    hasMore?: boolean;
+    onLoadMore?: () => void;
+}
+export interface SettingsTableProps {
+    section?: Section;
+    groupList?: SettingGroup[];
+    groupLoading?: boolean;
+    onDataChange?: (section: Section) => void;
+    onEditGroup?: (group: SettingGroup) => void;
+    onDeleteGroup?: (groupId: number) => void;
+    onAddItem?: (groupId: number) => void;
+    onEditItem?: (item: SettingItem) => void;
+    onDeleteItem?: (itemId: number) => void;
+    onGroupReorder?: (groupIds: number[]) => void;
+    onItemMove?: (itemId: number, targetGroupId: number, newOrder: number) => void;
+}
+export interface GroupFormData {
+    title: MultiLanguageText;
+    code: string;
+}
+export interface ItemFormData {
+    name: MultiLanguageText;
+    key: string;
+    fieldType: string;
+    interfaceType?: string;
+    scopes: string[];
+    description?: MultiLanguageText;
+    default?: string | null;
+    uiSchema?: string;
+}
+export interface GroupModalProps {
+    open: boolean;
+    type: OperationType;
+    data?: SettingGroup;
+    onOk: (data: GroupFormData) => void | Promise<void>;
+    onCancel: () => void;
+}
+export interface ItemModalProps {
+    open: boolean;
+    type: OperationType;
+    data?: SettingItem;
+    section?: Section;
+    onOk: (data: ItemFormData) => void | Promise<void>;
+    onCancel: () => void;
+}
+export interface ApiResponse<T> {
+    data: T[];
+    meta: {
+        count: number;
+        page: number;
+        pageSize: number;
+        totalPage: number;
+    };
+}

package/lib/components/systemSettings/registry/utils/typeValidation.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 类型验证工具函数
+ * 用于验证默认值是否符合指定的字段类型
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    error?: string;
+}
+/**
+ * 根据字段类型验证默认值
+ */
+export declare const validateDefaultValue: (fieldType: string, defaultValue: any) => ValidationResult;
+/**
+ * 解析默认值为对应的类型
+ */
+export declare const parseDefaultValue: (fieldType: string, defaultValue: any) => any;

package/lib/components/systemSettings/registry/utils/validators.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 验证器工具函数
+ */
+/**
+ * 创建带前缀的应用标识符验证器
+ * 用于验证设置项的键格式
+ */
+export declare const createPrefixedAppIdentifierValidator: (sectionCode: string) => (_: any, value: string) => Promise<void>;

package/lib/components/taxSelect/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { SelectProps } from "antd";
 import "./index.less";
 interface TaxSelectProps {

package/lib/components/ticketBooking/components/ProductDisplayAdapter/ProductDisplayAdapter.js

@@ -157,7 +157,7 @@ var ProductDisplayAdapter = (props) => {
           displayStyle,
           columns,
           paginationType,
-          layoutDirection: "horizontal",
+          layoutDirection: "vertical",
           tabStyle: enableTab ? tabStyle : "none",
           tabData,
           tabGroup: "category",

package/lib/components/ticketBooking/components/ProductDisplayAdapter/index.less

@@ -17,6 +17,7 @@
     background-color: #4e4e4e;
     overflow: auto;
     border-radius: 0;
+    max-height: 100%;
     .list-group-items {
       .list-item {
         height: 100% !important;
@@ -53,8 +54,8 @@
 }
 
 .pisell-product-display-adapter__search-wrapper {
-  padding: 0;
-  margin-bottom: 12px;
+  padding: 12px;
+  margin: 0;
   --ps-color-primary: #8157d5;
   --ps-color-text: #1b1b1b;
   --ps-color-text-secondary: #4e4e4e;

package/lib/components/ticketBooking/components/ProductDisplayAdapter/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * 产品展示配置类型定义
+ */
+import type { ProductCardConfig } from '../../../../plus/productSelect/ProductCard/SkuCard/type';
+/** 预设配置的字符串键 */
+export declare type ProductDisplayPresetKey = 'product-select' | 'sku-list-a1' | 'sku-list-a2' | 'sku-list-a5' | 'default';
+/** ProductSelect 布局配置 */
+export interface ProductSelectLayout {
+    grid: boolean;
+    config: string;
+}
+export declare type NumberBoolean = 0 | 1;
+/** ProductSelect 列表设置 */
+export interface ProductListSetting {
+    /** 是否显示产品封面 */
+    isProductCover?: NumberBoolean;
+    /** 是否显示标题 */
+    isTitle?: NumberBoolean;
+    /** 是否显示副标题 */
+    isSubtitle?: NumberBoolean;
+    /** 是否显示价格 */
+    isPrice?: NumberBoolean;
+    /** 是否显示原价 */
+    isOriginPrice?: NumberBoolean;
+    /** 是否显示库存 */
+    isStock?: NumberBoolean;
+}
+/** ProductSelect 模式配置 */
+export interface ProductSelectConfig {
+    /** 是否显示搜索框 */
+    showSearch?: boolean;
+    /** 是否显示分类Tab */
+    showTab?: boolean;
+    /** 布局配置 */
+    layout?: ProductSelectLayout;
+    /** 产品列表设置 */
+    productListSetting?: ProductListSetting;
+}
+/** SkuCard 显示模式 */
+export declare type SkuCardDisplayMode = 'display_a1' | 'display_a2' | 'display_a5' | 'display_a9' | 'display_custom';
+/**
+ * SkuCard 配置
+ * 直接使用 ProductCardConfig 类型，保持类型同步
+ *
+ * @see packages/private-materials/src/plus/productSelect/ProductCard/SkuCard/type.ts ProductCardConfig
+ */
+export declare type SkuCardAllConfig = ProductCardConfig;
+/** List 布局类型 */
+export declare type ListLayoutType = 'grid' | 'list';
+/** Tab 样式类型 */
+export declare type TabStyleType = 'switch' | 'anchor' | 'none';
+/** List 组件配置 */
+export interface ListConfig {
+    /** 布局类型 */
+    layout?: ListLayoutType;
+    /** 列数 */
+    columns?: number;
+    /** 是否显示分页 */
+    showPagination?: boolean;
+    /** 是否显示Tab */
+    showTab?: boolean;
+    /** Tab 样式类型：switch-切换模式，anchor-锚点模式，none-不显示 */
+    tabStyle?: TabStyleType;
+    /** Tab 是否吸顶 */
+    stickyTop?: boolean;
+    /** Tab配置 */
+    tabConfig?: any;
+    /** 分页配置 */
+    paginationConfig?: any;
+    [key: string]: any;
+}
+/** SkuList 模式配置 */
+export interface SkuListConfig {
+    /** List 组件配置 */
+    listConfig?: ListConfig;
+    /** SkuCard 配置 */
+    skuCardAllConfig?: SkuCardAllConfig;
+}
+/** 展示模式类型 */
+export declare type DisplayMode = 'product-select' | 'sku-list';
+/**
+ * 产品展示配置
+ * 用于配置化控制产品展示的方式
+ */
+export interface ProductDisplayConfig {
+    /** 展示模式 */
+    displayMode: DisplayMode;
+    /** ProductSelect 模式配置 */
+    productSelectConfig?: ProductSelectConfig;
+    /** SkuList 模式配置 */
+    skuListConfig?: SkuListConfig;
+}
+/**
+ * 产品展示配置预设
+ * 支持通过字符串键或直接使用配置对象
+ */
+export declare const ProductDisplayPresets: Record<ProductDisplayPresetKey, ProductDisplayConfig>;
+/**
+ * 兼容性：保持原有的导出方式
+ * @deprecated 建议使用 ProductDisplayPresets['product-select'] 或字符串键访问
+ */
+export declare const LegacyProductDisplayPresets: {
+    /** @deprecated 使用 ProductDisplayPresets['product-select'] */
+    DEFAULT_PRODUCT_SELECT: ProductDisplayConfig;
+    /** @deprecated 使用 ProductDisplayPresets['sku-list-a1'] */
+    DEFAULT_SKU_LIST_A1: ProductDisplayConfig;
+    /** @deprecated 使用 ProductDisplayPresets['sku-list-a2'] */
+    DEFAULT_SKU_LIST_A2: ProductDisplayConfig;
+    /** @deprecated 使用 ProductDisplayPresets['sku-list-a5'] */
+    DEFAULT_SKU_LIST_A5: ProductDisplayConfig;
+};
+/**
+ * 工具函数：将字符串键或配置对象解析为配置对象
+ */
+export declare function resolveProductDisplayConfig(config?: ProductDisplayPresetKey | ProductDisplayConfig): ProductDisplayConfig;

package/lib/components/ticketBooking/components/ProductDisplayAdapter/types.js

@@ -150,7 +150,7 @@ var ProductDisplayPresets = {
         // 使用 switch 模式
         stickyTop: true,
         // Tab 吸顶
-        columns: 4,
+        columns: 5,
         tabGroup: "category"
       },
       skuCardAllConfig: {

package/lib/components/ticketBooking/components/ProductDisplayAdapter/utils.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 格式化 SKU 数据源，适配 SkuCard 组件
+ */
+export declare const formatSkuDataSource: (dataSource: any) => {
+    id: any;
+    title: any;
+    subtitle: any;
+    cover: any;
+    price: any;
+    original_price: any;
+    stock: any;
+    sortKeys: string[];
+};
+/**
+ * Tab 项接口定义（与 List 组件保持一致）
+ */
+export interface TabItem {
+    key: string;
+    label: string;
+    group?: string;
+}
+/**
+ * 产品分类信息接口
+ */
+interface ProductCategory {
+    id: number;
+    name: string;
+    icon?: string;
+    slug?: string;
+    sort?: number;
+    /** 父级分类 ID，0 或 null/undefined 表示一级分类 */
+    parent_id?: number | null;
+}
+/**
+ * 产品项接口
+ */
+interface Product {
+    id: number;
+    title: string;
+    category?: ProductCategory[];
+    [key: string]: any;
+}
+/**
+ * 分类树节点接口（Switch 模式返回值）
+ */
+export interface CategoryTreeNode {
+    /** 分类 ID，All 节点为 '{父级路径}_all' 格式 */
+    id: number | string;
+    /** 分类唯一标识 兼容 List 组件的 key 字段 */
+    key: number | string;
+    /** 分类名称 兼容 List 组件的 label 字段 */
+    label: string;
+    /** 分类分组 兼容 List 组件的 group 字段 */
+    group: number | string;
+    /** 分类名称 */
+    name: string;
+    /** 分类图标 */
+    icon?: string;
+    /**
+     * 路径式父级标识
+     * - 一级分类：无此字段
+     * - 二级分类：'1'（父级 id）
+     * - 三级分类：'1_2'（路径格式）
+     * - 以此类推
+     */
+    pid?: string;
+    /** 该分类下所有商品的 ID 数组（包含子分类的商品） */
+    productIds: number[];
+    /** 子分类列表，如果有子分类，第一个为 All 节点 */
+    children?: CategoryTreeNode[];
+    /** 子分类最大层级 */
+    childrenMaxLevel: number;
+}
+/**
+ * 根据产品数据生成分类 Tabs（Switch 模式）
+ * 参考 TestResponsiveWrapper 的 generateSimpleTabItems 函数
+ *
+ * @param products 产品列表
+ * @param tabStyle tab 样式类型
+ * @returns Switch 模式返回 CategoryTreeNode[]，Anchor 模式返回 TabItem[]
+ */
+export declare const generateProductTabs: (products: Product[], tabStyle?: 'switch' | 'anchor') => CategoryTreeNode[] | TabItem[];
+export {};

package/lib/components/ticketBooking/components/bookingDataPanel/bookingList/utils.d.ts

@@ -0,0 +1,6 @@
+export declare const formatShowList: (list: any[], options: {
+    search: string;
+    listSelectType: string;
+    sort: string;
+}) => any[];
+export declare const getBookingType: (record: any) => "pisell2" | "pisell1";

package/lib/components/ticketBooking/components/bookingDataPanel/constants.d.ts

@@ -0,0 +1,22 @@
+export declare const getPayStatusMap: () => {
+    authorized: any;
+    paid: any;
+    partially_paid: any;
+    partially_refunded: any;
+    payment_pending: any;
+    refunded: any;
+    unpaid: any;
+    voided: any;
+    payment_processing: any;
+};
+export declare const payStatusColorMap: {
+    authorized: string;
+    paid: string;
+    partially_paid: string;
+    partially_refunded: string;
+    payment_pending: string;
+    refunded: string;
+    unpaid: string;
+    voided: string;
+    payment_processing: string;
+};

package/lib/components/ticketBooking/context/IsActiveContext.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+/**
+ * IsActive Context
+ * 用于在 TicketBooking 组件树中提供 isActive 状态
+ * isActive 用于标识当前组件是否处于激活状态
+ */
+interface IsActiveContextType {
+    /** 是否激活 */
+    isActive: boolean;
+}
+declare const IsActiveContext: React.Context<IsActiveContextType>;
+interface IsActiveProviderProps {
+    isActive: boolean;
+    children: React.ReactNode;
+}
+/**
+ * IsActive Provider
+ * 提供 isActive 给子组件使用
+ */
+export declare const IsActiveProvider: React.FC<IsActiveProviderProps>;
+/**
+ * useIsActive Hook
+ * 在子组件中使用此 hook 获取 isActive 状态
+ */
+export declare const useIsActive: () => boolean;
+export default IsActiveContext;

package/lib/components/ticketBooking/context/OsKeyContext.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+/**
+ * OsKey Context
+ * 用于在 TicketBooking 组件树中提供 pisellos 的 osKey
+ * osKey 用于区分不同页面使用同一个组件时的模块标识
+ */
+interface OsKeyContextType {
+    /** pisellos 模块的唯一标识 */
+    osKey: string | undefined;
+}
+declare const OsKeyContext: React.Context<OsKeyContextType>;
+interface OsKeyProviderProps {
+    osKey: string | undefined;
+    children: React.ReactNode;
+}
+/**
+ * OsKey Provider
+ * 提供 osKey 给子组件使用
+ */
+export declare const OsKeyProvider: React.FC<OsKeyProviderProps>;
+/**
+ * useOsKey Hook
+ * 在子组件中使用此 hook 获取 osKey
+ */
+export declare const useOsKey: () => string;
+export default OsKeyContext;

package/lib/components/ticketBooking/context/index.d.ts

@@ -0,0 +1,2 @@
+export { OsKeyProvider, useOsKey } from './OsKeyContext';
+export { default as OsKeyContext } from './OsKeyContext';

package/lib/components/ticketBooking/hooks/pisellos/useActiveExecute.d.ts

@@ -0,0 +1,21 @@
+/**
+ * useActiveExecute Hook
+ * 返回一个函数，该函数接收一个回调函数，并返回一个包装后的函数
+ * 包装后的函数只在 isActive 为 true 时执行原始回调
+ *
+ * @example
+ * ```tsx
+ * const { executeIfActive } = useActiveExecute();
+ *
+ * // 创建一个包装函数用于事件监听
+ * const handleChange = (data) => {
+ *   console.log('data:', data);
+ * };
+ *
+ * // 返回的函数会在被调用时检查 isActive
+ * pisellos.effects.on('event', executeIfActive(handleChange));
+ * ```
+ */
+export declare const useActiveExecute: () => {
+    executeIfActive: <T extends (...args: any[]) => any>(fn: T) => T;
+};