@pisell/materials 6.11.49 → 6.11.50

package/lib/components/pisellRecordBoard/utils/partitionShellFrameChildren.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { RecordBoardFloorMapProps, RecordBoardCalendarProps, RecordBoardResourceWallProps } from '../types';
+/** 与 shellFrame/FloorMap 上定义的 displayName 一致，用于从 ShellFrame children 中识别平面图槽 */
+export declare const RECORD_BOARD_FLOOR_MAP_DISPLAY_NAME = "RecordBoard.FloorMap";
+/** 与 shellFrame/Calendar 上定义的 displayName 一致 */
+export declare const RECORD_BOARD_CALENDAR_DISPLAY_NAME = "RecordBoard.Calendar";
+/** 与 shellFrame/ResourceWall 上定义的 displayName 一致 */
+export declare const RECORD_BOARD_RESOURCE_WALL_DISPLAY_NAME = "RecordBoard.ResourceWall";
+/**
+ * 将 ShellFrame 的 children 拆成：供表格区渲染的子树 + 可选的 FloorMap / Calendar 透传 props。
+ * 支持 Fragment 嵌套；多个同槽时以最后一个为准。
+ */
+export declare function partitionShellFrameChildren(children: React.ReactNode): {
+    gridChildren: React.ReactNode;
+    /** 是否出现 FloorMap 槽位节点（props 可为空，可与根级 floorMap 合并） */
+    hasFloorMapChild: boolean;
+    floorMapPropsFromChild?: RecordBoardFloorMapProps;
+    hasCalendarChild: boolean;
+    calendarPropsFromChild?: RecordBoardCalendarProps;
+    hasResourceWallChild: boolean;
+    resourceWallPropsFromChild?: RecordBoardResourceWallProps;
+    hasGridContent: boolean;
+};

package/lib/components/pisellRecordBoard/utils/recordBoardColumns.d.ts

@@ -0,0 +1,52 @@
+import React from 'react';
+import type { RecordBoardColumnType } from '../types';
+import type { FilterValueType } from '../../filter/components/FilterButton/types';
+import type { SortItemProps } from '../../sort/types';
+/** 获取列唯一 key，供列显示隐藏等使用 */
+export declare function getRecordBoardColumnKey(column: RecordBoardColumnType): string;
+/**
+ * 同值列总结栏不展示的内容：null/undefined、空串、纯空白、占位「-」。
+ * 列仍可折叠；仅用于不生成总结栏条目（避免「-」、空白等占位）。
+ */
+export declare function isTrivialUniformSummaryDisplayValue(v: any): boolean;
+/**
+ * 总结区实际渲染的 React 节点是否视为无展示价值（与 {@link isTrivialUniformSummaryDisplayValue} 对齐，含一层子节点）。
+ */
+export declare function isTrivialUniformSummaryReactContent(node: React.ReactNode): boolean;
+export interface UniformColumnSummaryItem {
+    columnKey: string;
+    title: string;
+    type: 'uniform' | 'empty';
+    /** 无 render 时的回退展示 */
+    displayValue?: string;
+    /** 仅用于判断是否相等的值（uniformCompare 的返回值或 dataIndex 取值），不参与 render */
+    value?: any;
+    /** 表格里该列单元格的值（dataIndex 从 record 取值），传给 render 的与表格单元格一致 */
+    cellValue?: any;
+    /** 代表行（如首行），供列 render 使用 */
+    record?: any;
+}
+/**
+ * 根据当前页 data 计算：哪些列「全列同值」或「全空」应隐藏，以及总结区展示项。
+ * 折叠列与总结项可不一一对应：全空、整列「-」/空白等同值仍折叠，但不生成无信息总结项。
+ * 仅当 grid.collapseUniformColumns 为 true 时使用。
+ */
+export declare function computeUniformColumnSummary(data: any[], columns: RecordBoardColumnType[]): {
+    uniformHiddenColumnKeys: string[];
+    summaryItems: UniformColumnSummaryItem[];
+};
+/**
+ * 处理列配置：对带 type 的列注入基于 Pisell 组件的 render，其余列保持不变。
+ * 有 type 时若列上传入了 render 则优先使用（覆盖自动派生）。
+ */
+export declare function processColumnsForGrid<RecordType = any>(columns: RecordBoardColumnType<RecordType>[] | undefined): RecordBoardColumnType<RecordType>[];
+/**
+ * 从 columns 派生排序列表（SortItemProps[]）。
+ * 有 type 的列：根据组件 SortOptions（或默认）生成；无 type 的列：根据 sortable + sort 生成。
+ */
+export declare function deriveSortFromColumns(columns: RecordBoardColumnType[] | undefined): SortItemProps[];
+/**
+ * 从 columns 派生 filter 列表（quickFilter + otherFilter）。
+ * 有 type 的列：根据 type + fieldProps 生成筛选项；无 type 的列：根据 filterable + filter 生成。
+ */
+export declare function deriveFilterFromColumns(columns: RecordBoardColumnType[] | undefined): FilterValueType;

package/lib/components/pisellTimeNavigator/PisellTimeNavigator.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+import type { PisellTimeNavigatorProps } from './types';
+import './PisellTimeNavigator.less';
+/**
+ * PisellTimeNavigator：可拖动的时间导航轴，时间范围内浏览、选择、控制
+ */
+export declare function PisellTimeNavigator(props: PisellTimeNavigatorProps): JSX.Element;
+export declare namespace PisellTimeNavigator {
+    var displayName: string;
+}

package/lib/components/pisellTimeNavigator/PisellTimeNavigator.js

@@ -92,22 +92,30 @@ function PisellTimeNavigator(props) {
   const referenceDayKey = referenceDateFromProp != null ? referenceDateFromProp.format("YYYY-MM-DD") : (0, import_dayjs.default)().format("YYYY-MM-DD");
   const [densityLoaded, setDensityLoaded] = (0, import_react.useState)();
   const densityReqId = (0, import_react.useRef)(0);
+  const densityAxisKeyRef = (0, import_react.useRef)(null);
   const densityGradientId = (0, import_react.useMemo)(
     () => `pisell-time-density-fill-${Math.random().toString(36).slice(2, 8)}`,
     []
   );
   (0, import_react.useEffect)(() => {
+    const axisKey = `${referenceDayKey}|${stepMinutes}`;
+    const axisKeyChanged = densityAxisKeyRef.current === null || densityAxisKeyRef.current !== axisKey;
     if (densitySeriesProp !== void 0) {
+      densityAxisKeyRef.current = null;
       setDensityLoaded(void 0);
       return;
     }
     if (!loadDensityProp) {
+      densityAxisKeyRef.current = null;
       setDensityLoaded(void 0);
       return;
     }
+    densityAxisKeyRef.current = axisKey;
     const req = ++densityReqId.current;
     let cancelled = false;
-    setDensityLoaded(void 0);
+    if (axisKeyChanged) {
+      setDensityLoaded(void 0);
+    }
     const refDay = (0, import_dayjs.default)(referenceDayKey).startOf("day");
     void loadDensityProp({ referenceDate: refDay, stepMinutes }).then((arr) => {
       if (cancelled || req !== densityReqId.current) return;

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

@@ -0,0 +1,146 @@
+import React from 'react';
+import './index.less';
+export interface FormatOption {
+    /** 原始 DOM 元素 */
+    originDom: React.ReactNode;
+    /** 是否选中状态 */
+    active: boolean;
+    /** 完整的组件数据 */
+    data: PisellWalletPassCardProps;
+}
+export interface PisellWalletPassCardProps {
+    id: number;
+    /** 卡片样式 */
+    type: 'default' | 'mini';
+    /** 商品名称 */
+    name: string;
+    /** 二维码 */
+    qrCode: string;
+    /** 共享店铺名称 */
+    storeName: string;
+    /** 余额 */
+    balance?: number;
+    /** 识别码编号 */
+    code: string;
+    /** 有效期 */
+    validDate: string;
+    /** 使用金额 */
+    redeem?: number;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 禁用原因 */
+    disabledReason?: string;
+    /** 是否展示禁用原因 */
+    showDisabledReason?: boolean;
+    /** 封面图 */
+    cover?: string;
+    /** 余额标题文案 */
+    balanceTitle?: string;
+    /** 使用金额标题文案 */
+    redeemTitle?: string;
+    /** 是否选中 */
+    active?: boolean;
+    /** 是否展示商品名称 */
+    showName?: boolean;
+    /** 是否展示共享店铺名称 */
+    showStoreName?: boolean | ((data: any) => boolean);
+    /** 是否展示使用金额 */
+    showRedeem?: boolean;
+    /** 是否展示余额 */
+    showBalance?: boolean;
+    /** 是否展示识别码编号 */
+    showCode?: boolean;
+    /** 是否展示有效期 */
+    showValidDate?: boolean;
+    /** 使用日程信息计算有效期 */
+    validDateBySchedule?: boolean;
+    /** 日程列表 */
+    scheduleList?: any[];
+    /** 是否展示右上角详情按钮 */
+    showDetail?: boolean;
+    /** 是否展示qrCode */
+    showQrCode?: boolean;
+    /** 是否展示封面 */
+    showCover?: boolean;
+    /** 是否展示余额货币符号 */
+    showBalanceSymbol?: boolean;
+    /** 展示操作按钮 */
+    showActions?: boolean;
+    /** 操作按钮配置 */
+    actions?: {
+        /** 按钮展示方式 */
+        layout: 'expanded' | 'collapsed';
+        /** detail 按钮配置 */
+        detail?: {
+            visible: boolean;
+            iconColor: string;
+        };
+        /** edit按钮配置 */
+        edit?: {
+            visible: boolean;
+            iconColor: string;
+            dialogTitle: string;
+            enableDialog: boolean;
+            fields: {
+                name: string;
+                label: string;
+            };
+        };
+    };
+    /** 编辑编辑按钮后，弹窗展示之前 */
+    beforeEdit?: (value: any) => Promise<any> | boolean | void;
+    /** 编辑弹窗点击提交 */
+    onConfirmEdit?: (value: any) => void;
+    /** 编辑金额事件 */
+    onConfirmEditAmount?: (value: number) => void;
+    /** 详情按钮点击事件 */
+    onDetail?: (data: {
+        id: number;
+        name: string;
+        storeName: string;
+        balance?: number;
+        redeem?: number;
+        code: string;
+        validDate: string;
+        originData?: any;
+    }) => void;
+    /** 是否使用外部详情处理（当为 true 且提供了 onDetail 时，不显示内部模态框） */
+    useExternalDetail?: boolean;
+    /** 单选或者多选 */
+    mode?: 'multiple' | 'single';
+    /** 是否展示选中图标 */
+    showActiveIcon?: boolean;
+    /** 开启编辑金额 */
+    enableEditAmount?: boolean;
+    /** 显示状态标识 */
+    showStatus?: boolean;
+    /** 名称标题字号字重颜色配置 */
+    nameTitleStyle?: {
+        fontSize: number;
+        fontWeight: number;
+        color: string;
+    };
+    /** 卡片状态 */
+    cardStatus?: 'used' | 'expired' | 'disabled' | 'conflict' | 'lastPayment';
+    /** 自定义余额格式化函数，如果提供则优先使用 */
+    formatBalance?: (balance?: number, option?: FormatOption) => React.ReactNode;
+    /** 自定义余额标题格式化函数，如果提供则优先使用 */
+    formatBalanceTitle?: (balanceTitle?: string, option?: FormatOption) => React.ReactNode;
+    /** 自定义使用金额格式化函数，如果提供则优先使用 */
+    formatRedeem?: (redeem?: number, option?: FormatOption) => React.ReactNode;
+    /** 自定义使用金额标题格式化函数，如果提供则优先使用 */
+    formatRedeemTitle?: (redeemTitle?: string, option?: FormatOption) => React.ReactNode;
+    /** 最大使用金额 */
+    maxRedeem?: number;
+    /** 编辑金额前事件 */
+    onBeforeEditAmount?: (value: any) => Promise<any> | boolean | void;
+    /** 是否显示持有人 */
+    showHolderName?: boolean;
+    /** 持有人, 表单记录，展示时一般取main_field */
+    holder?: any;
+    /** 持有人点击回调 */
+    onSetHolder?: (currentValue?: any) => void;
+    [key: string]: any;
+}
+declare const PisellWalletPassCard: (props: PisellWalletPassCardProps) => JSX.Element;
+export default PisellWalletPassCard;

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

@@ -0,0 +1,7 @@
+import React from 'react';
+import { ProductCardTypes } from './types';
+import './index.less';
+declare const ProductCard: React.FC<ProductCardTypes> & {
+    V2: any;
+};
+export default ProductCard;