@pisell/materials 6.3.27 → 6.3.28

package/es/components/pisellLookup/PisellLookup.less

@@ -132,8 +132,11 @@
 
   // ============ Input 样式覆盖 ============
 
-  // 覆盖 Ant Design Input 默认样式（适用于所有尺寸）
-  &-trigger-input.pisell-lowcode-input-affix-wrapper {
+  // 覆盖 Ant Design Input 默认样式（适用于所有尺寸）；默认高度 50px
+  // 同时匹配 ant- / pisell-lowcode- 前缀，确保有无 prefixCls 都能生效
+  &-trigger-input.pisell-lowcode-input-affix-wrapper,
+  &-trigger-input.ant-input-affix-wrapper {
+    min-height: 50px;
     border: 1px solid #d0d5dd;
     border-radius: 8px;
     box-shadow: 0px 1px 2px 0px rgba(16, 24, 40, 0.05);
@@ -145,13 +148,15 @@
     }
 
     &:focus,
-    &.pisell-lowcode-input-affix-wrapper-focused {
+    &.pisell-lowcode-input-affix-wrapper-focused,
+    &.ant-input-affix-wrapper-focused {
       border-color: #7f56d9;
       box-shadow: 0px 1px 2px 0px rgba(16, 24, 40, 0.05), 0 0 0 2px rgba(127, 86, 217, 0.1);
     }
 
-    // Input 文本样式
-    .pisell-lowcode-input {
+    // Input 文本样式（antd 内部 input 类名可能为 .ant-input 或 .pisell-lowcode-input）
+    .pisell-lowcode-input,
+    .ant-input {
       color: #000000;
       font-size: 16px;
       line-height: 24px;
@@ -164,8 +169,9 @@
     }
   }
 
-  // 小号输入框
-  &-trigger-input.pisell-lowcode-input-affix-wrapper-sm {
+  // 小号输入框（同时匹配 ant- / pisell-lowcode-）
+  &-trigger-input.pisell-lowcode-input-affix-wrapper-sm,
+  &-trigger-input.ant-input-affix-wrapper-sm {
     padding: 2px 2px 2px 12px;
 
     .pisell-lookup-input-clear {
@@ -192,8 +198,10 @@
     }
   }
 
-  // 大号输入框
-  &-trigger-input.pisell-lowcode-input-affix-wrapper-lg {
+  // 大号输入框，高度 58px（同时匹配 ant- / pisell-lowcode-）
+  &-trigger-input.pisell-lowcode-input-affix-wrapper-lg,
+  &-trigger-input.ant-input-affix-wrapper-lg {
+    min-height: 58px;
     padding: 6px 6px 6px 16px;
 
     .pisell-lookup-input-clear {
@@ -210,6 +218,23 @@
 
     .pisell-lookup-input-confirm {
       padding: 10px;
+      line-height: 24px;
+    }
+  }
+
+  // 无 Lookup 按钮时：class 在包裹层 .pisell-lookup-trigger-input-no-confirm 上，对子元素 affix-wrapper 设左右对称 padding
+  &-trigger-input-no-confirm {
+    > .ant-input-affix-wrapper,
+    > .pisell-lowcode-input-affix-wrapper {
+      padding: 4px 16px;
+    }
+    > .ant-input-affix-wrapper-sm,
+    > .pisell-lowcode-input-affix-wrapper-sm {
+      padding: 2px 12px;
+    }
+    > .ant-input-affix-wrapper-lg,
+    > .pisell-lowcode-input-affix-wrapper-lg {
+      padding: 6px 16px;
     }
   }
 
@@ -270,8 +295,8 @@
     }
 
     &-confirm {
+      border: none;
       background-color: #7f56d9;
-      border-color: #7f56d9;
       border-radius: 8px;
       box-shadow: 0px 1px 2px 0px rgba(16, 24, 40, 0.05);
       padding: 10px;
@@ -279,39 +304,37 @@
       min-width: auto;
       font-size: 16px;
       font-weight: 600;
-      line-height: 22px;
+      line-height: 20px;
       color: #ffffff;
 
       &:hover {
         background-color: #6941c6 !important;
-        border-color: #6941c6 !important;
         color: #ffffff !important;
       }
 
       &:active {
         background-color: #53389e !important;
-        border-color: #53389e !important;
         color: #ffffff !important;
       }
 
       span {
         font-size: 16px;
         font-weight: 600;
-        line-height: 22px;
+        line-height: 20px;
       }
 
       &.pisell-lowcode-btn-sm {
         padding: 10px;
         height: auto;
         font-size: 16px;
-        line-height: 22px;
+        line-height: 20px;
       }
 
       &.pisell-lowcode-btn-middle {
         padding: 10px;
         height: auto;
         font-size: 16px;
-        line-height: 22px;
+        line-height: 20px;
       }
     }
   }

package/es/components/pisellLookup/components/LookupTrigger.js

@@ -195,11 +195,13 @@ var LookupTriggerComponent = /*#__PURE__*/forwardRef(function (props, ref) {
   };
 
   /**
-   * 处理按 Enter 键
+   * 处理按 Enter 键：传入当前输入值，避免受控模式下 state 未更新导致历史未保存
    */
   var handleKeyPress = function handleKeyPress(e) {
     if (e.key === 'Enter') {
-      onConfirm === null || onConfirm === void 0 || onConfirm();
+      var _ref2, _e$currentTarget$valu, _e$currentTarget;
+      var currentValue = (_ref2 = (_e$currentTarget$valu = (_e$currentTarget = e.currentTarget) === null || _e$currentTarget === void 0 ? void 0 : _e$currentTarget.value) !== null && _e$currentTarget$valu !== void 0 ? _e$currentTarget$valu : value) !== null && _ref2 !== void 0 ? _ref2 : '';
+      onConfirm === null || onConfirm === void 0 || onConfirm(currentValue);
     }
   };
 
@@ -230,7 +232,7 @@ var LookupTriggerComponent = /*#__PURE__*/forwardRef(function (props, ref) {
       onClick: handleConfirm,
       className: "pisell-lookup-input-confirm"
     }, confirmButtonText));
-    return /*#__PURE__*/React.createElement(Input, {
+    var inputEl = /*#__PURE__*/React.createElement(Input, {
       ref: inputRef,
       value: value,
       onChange: handleChange,
@@ -243,9 +245,17 @@ var LookupTriggerComponent = /*#__PURE__*/forwardRef(function (props, ref) {
       prefix: prefix,
       suffix: suffix,
       autoFocus: autoFocus,
-      className: "pisell-lookup-trigger-input ".concat(className || ''),
+      className: "pisell-lookup-trigger-input ".concat(className || '').trim(),
       style: style
     });
+
+    // 无 Lookup 按钮时用带 class 的包裹层，确保 DOM 上一定有 pisell-lookup-trigger-input-no-confirm；同时保留 pisell-lookup-trigger-input 以便 modal 下 .pisell-lookup-search-area-with-close .pisell-lookup-trigger-input { flex: 1 } 能命中
+    if (!showConfirmButton) {
+      return /*#__PURE__*/React.createElement("div", {
+        className: "pisell-lookup-trigger-input pisell-lookup-trigger-input-no-confirm"
+      }, inputEl);
+    }
+    return inputEl;
   };
 
   /**

package/es/components/pisellLookup/hooks/useDebounceSearch.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 防抖搜索 Hook
+ */
+export interface UseDebounceSearchOptions {
+    /**
+     * 关键词
+     */
+    keyword: string;
+    /**
+     * 防抖时间（毫秒）
+     */
+    debounceTime: number;
+    /**
+     * 搜索触发回调
+     */
+    onSearch?: (keyword: string) => void;
+    /**
+     * 是否启用防抖
+     */
+    enabled?: boolean;
+    /**
+     * 上次搜索的关键词（用于去重）
+     */
+    lastSearchKeyword?: string;
+    /**
+     * 是否跳过防抖触发（用于手动选择场景）
+     */
+    skipDebounce?: boolean;
+}
+export interface UseDebounceSearchResult {
+    /**
+     * 防抖后的关键词
+     */
+    debouncedKeyword: string;
+}
+/**
+ * 防抖搜索 Hook
+ * 用于实时搜索模式的防抖处理
+ */
+export declare const useDebounceSearch: (options: UseDebounceSearchOptions) => UseDebounceSearchResult;

package/es/components/pisellLookup/hooks/useSearchState.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 搜索状态管理 Hook
+ */
+export interface UseSearchStateOptions {
+    /**
+     * 受控的关键词
+     */
+    value?: string;
+    /**
+     * 默认关键词
+     */
+    defaultValue?: string;
+    /**
+     * 受控的可见性
+     */
+    visible?: boolean;
+    /**
+     * 默认可见性
+     */
+    defaultVisible?: boolean;
+    /**
+     * 关键词变化回调
+     */
+    onChange?: (value: string) => void;
+    /**
+     * 可见性变化回调
+     */
+    onVisibleChange?: (visible: boolean) => void;
+    /**
+     * 打开回调
+     */
+    onOpen?: () => void;
+    /**
+     * 关闭回调
+     */
+    onClose?: () => void;
+}
+export interface UseSearchStateResult {
+    /**
+     * 当前关键词
+     */
+    keyword: string;
+    /**
+     * 设置关键词
+     */
+    setKeyword: (value: string) => void;
+    /**
+     * 是否可见
+     */
+    visible: boolean;
+    /**
+     * 设置可见性
+     */
+    setVisible: (visible: boolean) => void;
+    /**
+     * 打开
+     */
+    open: () => void;
+    /**
+     * 关闭
+     */
+    close: () => void;
+    /**
+     * 切换可见性
+     */
+    toggle: () => void;
+    /**
+     * 是否为受控的关键词
+     */
+    isControlledKeyword: boolean;
+    /**
+     * 是否为受控的可见性
+     */
+    isControlledVisible: boolean;
+}
+/**
+ * 搜索状态管理 Hook
+ * 支持受控和非受控模式
+ */
+export declare const useSearchState: (options: UseSearchStateOptions) => UseSearchStateResult;

package/es/components/pisellLookup/types.d.ts

@@ -421,7 +421,8 @@ export interface LookupTriggerProps {
     /**
      * 确认触发回调
      */
-    onConfirm?: () => void;
+    /** 确认搜索（回车或点击按钮）；可传入当前输入值，受控下回车时传 input 当前值以保证历史能正确保存 */
+    onConfirm?: (value?: string) => void;
     /**
      * 扫码回调
      */

package/es/components/pisellLookup/utils/storage.d.ts

@@ -0,0 +1,42 @@
+/**
+ * localStorage 工具函数
+ * 用于管理搜索历史的存储
+ */
+/**
+ * 从 localStorage 加载历史记录
+ * @param key 存储的 key
+ * @returns 历史记录数组
+ */
+export declare const loadHistory: (key: string) => string[];
+/**
+ * 保存历史记录到 localStorage
+ * @param key 存储的 key
+ * @param history 历史记录数组
+ * @param maxCount 最大数量限制
+ */
+export declare const saveHistory: (key: string, history: string[], maxCount: number) => void;
+/**
+ * 清除历史记录
+ * @param key 存储的 key
+ */
+export declare const clearHistory: (key: string) => void;
+/**
+ * 添加历史记录项
+ * @param key 存储的 key
+ * @param item 新的历史记录项
+ * @param maxCount 最大数量限制
+ * @returns 更新后的历史记录数组
+ */
+export declare const addHistoryItem: (key: string, item: string, maxCount: number) => string[];
+/**
+ * 删除历史记录项
+ * @param key 存储的 key
+ * @param item 要删除的历史记录项
+ * @returns 更新后的历史记录数组
+ */
+export declare const removeHistoryItem: (key: string, item: string) => string[];
+/**
+ * 检查 localStorage 是否可用
+ * @returns 是否可用
+ */
+export declare const isLocalStorageAvailable: () => boolean;

package/es/components/pisellMetricCard/components/MetricTitle.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { MetricTitleProps } from '../types';
+/**
+ * MetricTitle 标题组件
+ *
+ * 负责渲染标题、副标题和提示信息
+ * 支持自定义字号、字重、颜色等样式
+ *
+ * @param props 组件属性
+ */
+declare const MetricTitle: React.FC<MetricTitleProps>;
+export default MetricTitle;

package/es/components/pisellMetricCard/components/MetricValue.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { MetricValueProps } from '../types';
+/**
+ * MetricValue 数值展示组件
+ *
+ * 负责渲染格式化后的主数值
+ * 支持自定义字号、字重、颜色等样式
+ *
+ * @param props 组件属性
+ */
+declare const MetricValue: React.FC<MetricValueProps>;
+export default MetricValue;

package/es/components/pisellMetricCard/components/TrendIcon.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { TrendIconProps } from '../types';
+/**
+ * TrendIcon 趋势箭头组件
+ *
+ * 根据趋势类型显示上升或下降箭头
+ * - up: 显示上升箭头 ↑
+ * - down: 显示下降箭头 ↓
+ * - neutral: 不显示箭头
+ *
+ * @param props 组件属性
+ */
+declare const TrendIcon: React.FC<TrendIconProps>;
+export default TrendIcon;

package/es/components/pisellMetricCard/types.d.ts

@@ -0,0 +1,201 @@
+import type { CSSProperties, ReactNode } from 'react';
+/**
+ * 趋势类型
+ */
+export declare type TrendType = 'up' | 'down' | 'neutral';
+/**
+ * 数值格式化配置
+ */
+export interface ValueFormatConfig {
+    /** 小数精度（小数位数），默认 0 */
+    precision?: number;
+    /** 是否使用千分位分隔符，默认 false */
+    useGrouping?: boolean;
+    /** 是否显示货币符号，默认 false */
+    showCurrencySymbol?: boolean;
+    /** 货币符号（如 $, ¥），默认 '' */
+    currencySymbol?: string;
+    /** 自定义格式化函数 */
+    formatter?: (value: number | null) => string;
+    /** 整数时隐藏小数部分，默认 true */
+    hideDecimalForWholeNumbers?: boolean;
+}
+/**
+ * 环比配置
+ */
+export interface ComparisonConfig {
+    /** 环比数值（支持正负值） */
+    value: number | string | null;
+    /** 环比前缀文本，默认 'v.s. pre' */
+    text?: string;
+    /** 是否显示趋势箭头，默认 true */
+    showTrendIcon?: boolean;
+    /** 正向趋势颜色，默认 '#52c41a' */
+    positiveColor?: string;
+    /** 负向趋势颜色，默认 '#ff4d4f' */
+    negativeColor?: string;
+    /** 环比字号，默认 14 */
+    size?: number | string;
+}
+/**
+ * 样式配置
+ */
+export interface MetricCardStyleConfig {
+    /** 卡片容器样式 */
+    card?: {
+        /** 是否显示边框，默认 true */
+        bordered?: boolean;
+        /** 圆角大小（px），默认 12 */
+        borderRadius?: number;
+        /** 内边距（px），默认 16 */
+        padding?: number;
+        /** 阴影效果，默认 true */
+        shadow?: boolean | string;
+        /** 背景色，默认 '#ffffff' */
+        background?: string;
+        /** 卡片宽度，默认 'auto' */
+        width?: string | number;
+    };
+    /** 标题样式 */
+    title?: {
+        /** 字号，默认 14 */
+        size?: number | string;
+        /** 字重，默认 400 */
+        weight?: number | string;
+        /** 颜色，默认 'rgba(0, 0, 0, 0.45)' */
+        color?: string;
+    };
+    /** 数值样式 */
+    value?: {
+        /** 字号，默认 30 */
+        size?: number | string;
+        /** 字重，默认 600 */
+        weight?: number | string;
+        /** 颜色，默认 'rgba(0, 0, 0, 0.85)' */
+        color?: string;
+    };
+}
+/**
+ * PisellMetricCard 组件 Props
+ *
+ * 采用扁平 + 对象组合的设计，降低复杂度和耦合
+ *
+ * @example 基础用法
+ * ```tsx
+ * <PisellMetricCard
+ *   title="Total Sales"
+ *   value={1580}
+ * />
+ * ```
+ *
+ * @example 带格式化和环比
+ * ```tsx
+ * <PisellMetricCard
+ *   title="Revenue"
+ *   value={1580}
+ *   format={{
+ *     showCurrencySymbol: true,
+ *     currencySymbol: '$',
+ *     useGrouping: true
+ *   }}
+ *   comparison={{
+ *     value: 120,
+ *     text: 'v.s. last month'
+ *   }}
+ * />
+ * ```
+ */
+export interface PisellMetricCardProps {
+    /** 标题文本 */
+    title: string | ReactNode;
+    /** 主数值 */
+    value: number | string | null;
+    /** 副标题文本（可选） */
+    subtitle?: string | ReactNode;
+    /** 标签内容（可选） */
+    tag?: ReactNode;
+    /** 提示信息内容（可选） */
+    tooltip?: string | ReactNode;
+    /**
+     * 数值格式化配置
+     * @example format={{ precision: 2, useGrouping: true, currencySymbol: '$' }}
+     */
+    format?: ValueFormatConfig;
+    /**
+     * 环比配置
+     * @example comparison={{ value: 120, text: 'v.s. pre' }}
+     */
+    comparison?: ComparisonConfig;
+    /**
+     * 样式配置
+     * @example
+     * styleConfig={{
+     *   card: { borderRadius: 8, padding: 24 },
+     *   title: { size: 16, weight: 600 },
+     *   value: { size: 36, color: '#1890ff' }
+     * }}
+     */
+    styleConfig?: MetricCardStyleConfig;
+    /** 是否显示副标题，默认 false */
+    showSubtitle?: boolean;
+    /** 是否显示标签，默认 false */
+    showTag?: boolean;
+    /** 是否显示提示信息，默认 false */
+    showTooltip?: boolean;
+    /** 是否显示加载状态，默认 false */
+    loading?: boolean;
+    /** 鼠标悬停是否有交互效果，默认 true */
+    hoverable?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 点击卡片回调 */
+    onClick?: () => void;
+}
+/**
+ * FormatOptions (别名，用于导出)
+ */
+export interface FormatOptions extends ValueFormatConfig {
+}
+/**
+ * MetricTitle 组件 Props
+ */
+export interface MetricTitleProps {
+    title: string | ReactNode;
+    subtitle?: string | ReactNode;
+    tooltip?: string | ReactNode;
+    titleSize?: number | string;
+    titleWeight?: number | string;
+    titleColor?: string;
+}
+/**
+ * MetricValue 组件 Props
+ */
+export interface MetricValueProps {
+    value: string | null;
+    valueSize?: number | string;
+    valueWeight?: number | string;
+    valueColor?: string;
+}
+/**
+ * MetricComparison 组件 Props
+ */
+export interface MetricComparisonProps {
+    comparison: number | string | null;
+    comparisonText?: string;
+    showTrendIcon?: boolean;
+    positiveColor?: string;
+    negativeColor?: string;
+    comparisonSize?: number | string;
+    precision?: number;
+    showCurrencySymbol?: boolean;
+    currencySymbol?: string;
+}
+/**
+ * TrendIcon 组件 Props
+ */
+export interface TrendIconProps {
+    trend: TrendType;
+    color?: string;
+}

package/es/components/pisellMetricCard/utils/calculateTrend.d.ts

@@ -0,0 +1,14 @@
+import type { TrendType } from '../types';
+/**
+ * 计算趋势方向
+ *
+ * @param comparison 环比数值
+ * @returns 'up' | 'down' | 'neutral'
+ *
+ * @example
+ * calculateTrend(120) // 'up'
+ * calculateTrend(-230) // 'down'
+ * calculateTrend(0) // 'neutral'
+ * calculateTrend(null) // 'neutral'
+ */
+export declare function calculateTrend(comparison: number | string | null | undefined): TrendType;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import IpadModal from './IpadModal';
 import MobileModal from './MobileModal';
 import PcModal from './PcModal';