@pisell/private-materials 6.11.126 → 6.11.127

package/es/components/systemSettings/registry/services.d.ts

@@ -0,0 +1,97 @@
+import { ApiResponse, MultiLanguageText, SettingGroup, Section, SettingItem } from './types';
+export interface CreateGroupParams {
+    section_code: string;
+    code: string;
+    title: MultiLanguageText;
+    sort: number;
+}
+export interface UpdateGroupParams {
+    id: number;
+    code: string;
+    title: MultiLanguageText;
+}
+export interface DeleteGroupParams {
+    id: number;
+}
+export interface SortGroupParams {
+    section_code: string;
+    group_ids: number[];
+}
+export declare const createGroup: (request: any, params: CreateGroupParams) => Promise<ApiResponse<SettingGroup>>;
+export declare const updateGroup: (request: any, params: UpdateGroupParams) => Promise<ApiResponse<SettingGroup>>;
+export declare const deleteGroup: (request: any, params: DeleteGroupParams) => Promise<any>;
+export declare const sortGroups: (request: any, params: SortGroupParams) => Promise<any>;
+export declare const getSectionList: (request: any, params: {
+    page?: number;
+    pageSize?: number;
+    filter?: Record<string, any>;
+}) => Promise<ApiResponse<Section>>;
+export declare const getGroupList: (request: any, params: {
+    page?: number;
+    pageSize?: number;
+    filter?: Record<string, any>;
+}) => Promise<ApiResponse<SettingGroup>>;
+export interface CreateItemParams {
+    section_code: string;
+    group_id: number;
+    code: string;
+    title: MultiLanguageText;
+    description?: MultiLanguageText;
+    type: string;
+    interface?: string;
+    default?: string | null;
+    scopes?: string[];
+    schema?: any;
+    optionConfig?: {
+        sourceType?: string;
+        options?: Array<{
+            label: string;
+            value: string;
+        }>;
+        labelField?: string;
+        valueField?: string;
+        dataSource?: any;
+    };
+    sort?: number;
+}
+export interface UpdateItemParams {
+    id: number;
+    section_code: string;
+    group_id: number;
+    code: string;
+    title: MultiLanguageText;
+    description?: MultiLanguageText;
+    type: string;
+    interface?: string;
+    default?: string | null;
+    scopes?: string[];
+    schema?: any;
+    optionConfig?: {
+        sourceType?: string;
+        options?: Array<{
+            label: string;
+            value: string;
+        }>;
+        labelField?: string;
+        valueField?: string;
+        dataSource?: any;
+    };
+    sort?: number;
+}
+export interface DeleteItemParams {
+    id: number;
+}
+export interface SortItemParams {
+    id: number;
+    group_id: string;
+    item_ids: number[];
+}
+export declare const createItem: (request: any, params: CreateItemParams) => Promise<ApiResponse<SettingItem>>;
+export declare const updateItem: (request: any, params: UpdateItemParams) => Promise<ApiResponse<SettingItem>>;
+export declare const deleteItem: (request: any, params: DeleteItemParams) => Promise<any>;
+export declare const sortItems: (request: any, params: SortItemParams) => Promise<any>;
+export declare const getItemList: (request: any, params: {
+    page?: number;
+    pageSize?: number;
+    filter?: Record<string, any>;
+}) => Promise<ApiResponse<SettingItem>>;

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

@@ -0,0 +1,140 @@
+import { CSSProperties } from 'react';
+export interface MultiLanguageText {
+    en: string;
+    'zh-CN': string;
+    'zh-HK': string;
+    'ja': string;
+    'pt': 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;
+    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;
+    schema?: Record<string, any>;
+    xDataSource?: {
+        type?: string;
+        options?: Array<{
+            id?: string;
+            label: string | MultiLanguageText;
+            value: string;
+            color?: string;
+        }>;
+        dataSource?: Record<string, any>;
+        extraParams?: string;
+    };
+    xCustomUiSchema?: string;
+    xRecordSchema?: 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/es/components/taxSelect/locales.d.ts

@@ -0,0 +1,38 @@
+declare const _default: {
+    en: {
+        'pisell2.text.tax-free': string;
+        'pisell2.text.custom': string;
+        'pisell2.text.cancel': string;
+        'pisell2.text.confirm': string;
+        'pisell2.text.please-enter': string;
+    };
+    'zh-CN': {
+        'pisell2.text.tax-free': string;
+        'pisell2.text.custom': string;
+        'pisell2.text.cancel': string;
+        'pisell2.text.confirm': string;
+        'pisell2.text.please-enter': string;
+    };
+    'zh-HK': {
+        'pisell2.text.tax-free': string;
+        'pisell2.text.custom': string;
+        'pisell2.text.cancel': string;
+        'pisell2.text.confirm': string;
+        'pisell2.text.please-enter': string;
+    };
+    ja: {
+        'pisell2.text.tax-free': string;
+        'pisell2.text.custom': string;
+        'pisell2.text.cancel': string;
+        'pisell2.text.confirm': string;
+        'pisell2.text.please-enter': string;
+    };
+    pt: {
+        'pisell2.text.tax-free': string;
+        'pisell2.text.custom': string;
+        'pisell2.text.cancel': string;
+        'pisell2.text.confirm': string;
+        'pisell2.text.please-enter': string;
+    };
+};
+export default _default;

package/es/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/es/components/ticketBooking/components/ProductDisplayAdapter/utils.d.ts

@@ -0,0 +1,94 @@
+/**
+ * 格式化 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[];
+    isMini: any;
+};
+/**
+ * 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;
+    parent_category?: ProductCategory;
+}
+/**
+ * 产品项接口
+ */
+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', isTreeTab?: boolean) => CategoryTreeNode[] | TabItem[];
+/**
+ * 按 tabData 分类顺序对商品列表排序，同分类内按商品 sort 降序
+ * 仅在 isTreeTab 为 false 时使用
+ *
+ * @param data 商品列表（category 已转为 string[] 格式）
+ * @param tabData 分类 tab 列表（CategoryTreeNode[]）
+ * @returns 排序后的商品列表（原地排序）
+ */
+export declare const sortProductsByTabOrder: (data: any[], tabData: CategoryTreeNode[]) => any[];
+export {};

package/es/components/ticketBooking/components/addServiceVariant/addService.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { ProductDisplayConfig, ProductDisplayPresetKey } from '../ProductDisplayAdapter';
 import './index.less';
 interface AddServiceProps {

package/es/components/ticketBooking/components/addServiceVariant/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { ProductDisplayConfig, ProductDisplayPresetKey } from '../ProductDisplayAdapter/types';
 interface AddServiceVariantProps {
     globalState: any;

package/es/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/es/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/es/components/ticketBooking/components/menuBar/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './index.less';
 interface MenuBarProps {
     activeNavKey?: string;

package/es/components/ticketBooking/components/ticketBooking/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { type TicketBookingSecondaryDisplayConfig } from './useTicketBookingSecondaryScreen';
 import './index.less';
 import { ProductDisplayConfig, ProductDisplayPresetKey } from '../ProductDisplayAdapter/types';

package/es/components/ticketBooking/components/timeBar/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { Dayjs } from 'dayjs';
 import './index.less';
 interface ITimeBarProps {

package/es/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/es/components/ticketBooking/context/OsKeyContext.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+/**
+ * OsKey Context
+ * 用于在 TicketBooking 组件树中提供 pisellos 的 osKey
+ * osKey 用于区分不同页面使用同一个组件时的模块标识
+ */
+interface OsKeyContextType {
+    /** pisellos 模块的唯一标识 */
+    osKey: string | undefined;
+    businessCode: string | undefined;
+}
+declare const OsKeyContext: React.Context<OsKeyContextType>;
+interface OsKeyProviderProps {
+    osKey: string | undefined;
+    businessCode: 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 declare const useBusinessCode: () => string;
+export default OsKeyContext;

package/es/components/ticketBooking/context/PlatformContext.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+export declare type TicketBookingDisplayPlatform = 'pc' | 'mobile' | string;
+interface DisplayPlatformContextType {
+    /** 当前 TicketBooking 的展示平台 */
+    displayPlatform: TicketBookingDisplayPlatform;
+}
+declare const DisplayPlatformContext: React.Context<DisplayPlatformContextType>;
+interface DisplayPlatformProviderProps {
+    displayPlatform?: TicketBookingDisplayPlatform;
+    children: React.ReactNode;
+}
+/**
+ * DisplayPlatform Provider
+ * 用于在 TicketBooking 组件树中提供展示平台信息
+ */
+export declare const DisplayPlatformProvider: React.FC<DisplayPlatformProviderProps>;
+/**
+ * useDisplayPlatform Hook
+ * 在子组件中使用此 hook 获取当前展示平台
+ */
+export declare const useDisplayPlatform: () => string;
+export default DisplayPlatformContext;

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

@@ -0,0 +1,3 @@
+export { OsKeyProvider, useOsKey, useBusinessCode } from './OsKeyContext';
+export { default as OsKeyContext } from './OsKeyContext';
+export { DisplayPlatformProvider, useDisplayPlatform, type TicketBookingDisplayPlatform, } from './PlatformContext';

package/es/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;
+};

package/es/components/ticketBooking/hooks/useRuntime.d.ts

@@ -0,0 +1,4 @@
+export declare const useRuntime: () => {
+    runtime: any;
+    isSecondaryScreen: boolean;
+};

package/es/components/ticketBooking/hooks/useSync.d.ts

@@ -0,0 +1,21 @@
+import type { Store } from '../miniRedux';
+/**
+ * 双屏数据同步 hook，负责主屏与副屏之间的实时数据同步。
+ *
+ * 根据当前运行时角色（runtime.type）自动切换行为：
+ * - **主屏（main）**：订阅 store 变更，通过 unifiedCommunication SDK
+ *   将格式化后的数据以 `sync_card` 类型发布到副屏。
+ *   首次变更立即发送，后续变更防抖 2s（leading + trailing）。
+ * - **副屏（secondary-screen）**：监听 SDK 消息，将接收到的数据
+ *   通过 mergeSyncData 合并回 store，实现副屏状态同步。
+ *
+ * @param store - miniRedux Store 实例，需在组件顶层创建后传入
+ *
+ * @example
+ * ```tsx
+ * // 在根组件中使用
+ * const storeRef = useRef(createStore(initialState));
+ * useSync(storeRef.current);
+ * ```
+ */
+export declare function useSync(store: Store<any>): void;