@pisell/materials 6.3.26 → 6.3.28

package/es/components/pisellFind/index.js

@@ -3,6 +3,7 @@ function _extends() { _extends = Object.assign ? Object.assign.bind() : function
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 import React, { forwardRef } from 'react';
+import { locales as utilsLocales } from '@pisell/utils';
 import { PisellLookup } from "../pisellLookup";
 import { getText } from "../../locales";
 
@@ -47,9 +48,17 @@ export var PisellFind = /*#__PURE__*/forwardRef(function (props, ref) {
   var _props$triggerType = props.triggerType,
     triggerType = _props$triggerType === void 0 ? 'button' : _props$triggerType,
     _props$buttonText = props.buttonText,
-    buttonText = _props$buttonText === void 0 ? getText('pisell-find-button-text') : _props$buttonText,
+    buttonText = _props$buttonText === void 0 ? function () {
+      var key = 'pisell2.recordBoard.toolbar.find';
+      var u = utilsLocales.getText(key);
+      return u && u !== key ? u : getText(key) || getText('pisell-find-button-text');
+    }() : _props$buttonText,
     _props$placeholder = props.placeholder,
-    placeholder = _props$placeholder === void 0 ? getText('pisell-find-placeholder') : _props$placeholder,
+    placeholder = _props$placeholder === void 0 ? function () {
+      var key = 'pisell2.recordBoard.toolbar.findPlaceholder';
+      var u = utilsLocales.getText(key);
+      return u && u !== key ? u : getText(key) || getText('pisell-find-placeholder');
+    }() : _props$placeholder,
     _props$showConfirmBut = props.showConfirmButton,
     showConfirmButton = _props$showConfirmBut === void 0 ? false : _props$showConfirmBut,
     _props$showHistory = props.showHistory,

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

@@ -0,0 +1,17 @@
+import React from 'react';
+import './index.less';
+export interface PisellFloatingPanelProps {
+    fullHeight?: string | number;
+    retractHeight?: string | number;
+    width?: string | number;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    defaultOpen?: boolean;
+    isFloat?: boolean;
+    children?: React.ReactNode;
+    retractSlot?: React.ReactNode;
+    style?: React.CSSProperties;
+    retractIconStyle?: React.CSSProperties;
+}
+declare const PisellFloatingPanel: (props: PisellFloatingPanelProps) => React.JSX.Element;
+export default PisellFloatingPanel;

package/es/components/pisellGridPro/GridPro.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import './index.less';
+export interface GridProProps {
+    className?: string;
+    children?: React.ReactNode;
+    style?: React.CSSProperties;
+}
+declare const PisellGridPro: (props: GridProProps) => React.JSX.Element;
+export default PisellGridPro;

package/es/components/pisellGridPro/GridView/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import './index.less';
+import { GridViewProps } from './type';
+export type { GridViewProps };
+declare const GridView: (props: GridViewProps) => React.JSX.Element;
+export default GridView;

package/es/components/pisellGridPro/GridView/type.d.ts

@@ -0,0 +1,3 @@
+import { PisellScrollViewProps } from '../../PisellScrollView/types';
+export interface GridViewProps extends PisellScrollViewProps {
+}

package/es/components/pisellGridPro/ToolBar/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import './index.less';
+import { ToolBarProps } from './type';
+export type { ToolBarProps };
+declare const Toolbar: React.FC<ToolBarProps>;
+export default Toolbar;

package/es/components/pisellGridPro/ToolBar/index.less

@@ -14,6 +14,7 @@
   /**
    * 工具栏行通用样式
    */
+
   &-row {
     display: flex;
     flex-direction: row;
@@ -21,8 +22,10 @@
     gap: 12px;
     align-self: stretch;
   }
+
   .toolbar-row {
     justify-content: space-between;
+
     &-left {
       display: flex;
       flex-direction: row;
@@ -40,3 +43,23 @@
     }
   }
 }
+
+/**
+ * 手机版宽度：左侧区域与右侧区域换行，避免挤在一行
+ */
+@media (max-width: 768px) {
+  .pisell-grid-pro-toolbar .toolbar-row {
+    flex-wrap: wrap;
+  }
+
+  .pisell-grid-pro-toolbar .toolbar-row-left {
+    flex: 1 1 100%;
+    min-width: 0;
+  }
+
+  .pisell-grid-pro-toolbar .toolbar-row-right {
+    flex: 1 1 100%;
+    min-width: 0;
+    justify-content: flex-start;
+  }
+}

package/es/components/pisellGridPro/ToolBar/type.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+export interface ToolBarProps {
+    className?: string;
+    style?: React.CSSProperties;
+    tabs?: React.ReactNode;
+    topLeft?: React.ReactNode;
+    topRight?: React.ReactNode;
+    bottomLeft?: React.ReactNode;
+    bottomRight?: React.ReactNode;
+}

package/es/components/pisellGridPro/components/DataCard/components/StatCard/index.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import { StatCardItem } from '../../types';
+import './index.less';
+/**
+ * StatCard 统计卡片组件
+ * @description 用于展示单个统计数据，包含标题、数值和对比信息
+ * @author Pisell Team
+ */
+declare const StatCard: React.FC<StatCardItem>;
+export default StatCard;

package/es/components/pisellGridPro/components/DataCard/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { DataCardProps } from './types';
+export type { DataCardProps };
+import './index.less';
+declare const DataCard: (props: DataCardProps) => React.JSX.Element | null;
+export default DataCard;

package/es/components/pisellGridPro/components/DataCard/types.d.ts

@@ -0,0 +1,70 @@
+import React from 'react';
+/**
+ * PisellGridProDataCard 组件属性接口
+ */
+export interface DataCardProps {
+    /**
+     * 统计卡片数据列表
+     */
+    dataItems?: StatCardItem[];
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: React.CSSProperties;
+}
+/**
+ * 统计卡片数据项接口
+ */
+export interface StatCardItem {
+    /**
+     * 唯一标识
+     */
+    key: string;
+    /**
+     * 卡片标题
+     * @example "Total Orders"
+     */
+    title: React.ReactNode;
+    /**
+     * 主要数值
+     * @example 50 或 "$1580"
+     */
+    value: React.ReactNode;
+    /**
+     * 对比数值
+     * @example "+12" 或 "-230"
+     */
+    compareValue?: React.ReactNode;
+    /**
+     * 对比趋势
+     * @description up-增长(绿色), down-下降(红色)
+     * @default undefined
+     */
+    trend?: 'up' | 'down';
+    /**
+     * 对比前缀文本
+     * @default "v.s. pre"
+     */
+    comparePrefix?: string;
+    /**
+     * 是否显示对比信息
+     * @default true
+     */
+    showCompare?: boolean;
+    /**
+     * 自定义卡片样式
+     */
+    style?: React.CSSProperties;
+    /**
+     * 自定义卡片类名
+     */
+    className?: string;
+    /**
+     * 点击回调
+     */
+    onClick?: () => void;
+}

package/es/components/pisellGridPro/components/Footer/index.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import './index.less';
+export interface FooterProps {
+    className?: string;
+    children?: React.ReactNode;
+    style?: React.CSSProperties;
+}
+declare const Footer: (props: FooterProps) => React.JSX.Element;
+export default Footer;

package/es/components/pisellGridPro/components/Header/index.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import './index.less';
+export interface HeaderProps {
+    title?: React.ReactNode;
+    badge?: React.ReactNode;
+    subTitle?: React.ReactNode;
+    actionsList?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const Header: React.FC<HeaderProps>;
+export default Header;

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

@@ -0,0 +1,4 @@
+import { GridProProps } from './GridPro';
+export type { GridProProps };
+declare const PisellGridPro: any;
+export default PisellGridPro;

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

@@ -0,0 +1,29 @@
+import React from 'react';
+import './index.less';
+export interface PisellHeaderProgressBarProps {
+    title?: React.ReactNode;
+    stepText?: React.ReactNode;
+    showClose?: boolean;
+    /** 是否启用投影 */
+    enableShadow?: boolean;
+    /** 是否启用描边 */
+    enableBorder?: boolean;
+    /** 描边粗细 */
+    borderWidth?: number;
+    /** 描边颜色 */
+    borderColor?: string;
+    /** 头部背景颜色 */
+    backgroundColor?: string;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 是否显示返回键 */
+    showBack?: boolean;
+    /** 返回按钮点击事件 */
+    onBack?: () => void;
+    /** 关闭按钮点击事件 */
+    onClose?: () => void;
+}
+declare const PisellHeaderProgressBar: React.FC<PisellHeaderProgressBarProps>;
+export default PisellHeaderProgressBar;

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

@@ -0,0 +1,18 @@
+import React from 'react';
+import 'swiper/swiper-bundle.css';
+import './index.less';
+export interface PisellImageCarouselsProps {
+    dataSource?: string[];
+    width?: number | string;
+    height?: number;
+    showArrows?: boolean;
+    showDots?: boolean;
+    autoplay?: boolean;
+    interval?: number;
+    borderRadius?: number;
+    loop?: boolean;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const PisellImageCarousels: React.FC<PisellImageCarouselsProps>;
+export default PisellImageCarousels;

package/es/components/pisellInformationEntry/Scan/index.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import './index.less';
+export interface ScanProps {
+    onChange: (val: string) => void;
+    onCancel: () => void;
+}
+declare const Scan: (props: ScanProps) => React.JSX.Element;
+export default Scan;

package/es/components/pisellInformationEntry/hooks/useNativeScanner.d.ts

@@ -0,0 +1,4 @@
+export declare const useNativeScanner: (onChange?: ((val: string) => void) | undefined) => {
+    activeNativeScanner: () => void;
+    isTerminal: any;
+};

package/es/components/pisellInformationEntry/hooks/useTerminalPeripherals.d.ts

@@ -0,0 +1,8 @@
+declare type Peripherals = {
+    scanner: 'none' | 'connected' | 'disconnect';
+    nfc: 'none' | 'connected' | 'disconnect';
+};
+declare const useTerminalPeripherals: (onChange?: ((val: string) => void) | undefined) => {
+    peripheralsStatus: Peripherals;
+};
+export default useTerminalPeripherals;

package/es/components/pisellInformationEntry/utils.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 判断设备是否包含摄像头
+ */
+export declare const hasCamera: () => Promise<boolean>;

package/es/components/pisellInput/components/BankCard/utils.d.ts

@@ -0,0 +1,11 @@
+export declare const getCardType: (str: string) => "jcb" | "amex" | "visa" | "masterCard" | "unionPay" | "discover" | undefined;
+export declare const bankTypeMap: {
+    jcb: any;
+    amex: any;
+    masterCard: any;
+    visa: any;
+    unionPay: any;
+    discover: any;
+};
+export declare const getCardImgByType: (type: keyof typeof bankTypeMap) => any;
+export declare const getBankCardTypeImg: (val: number | string) => any;

package/es/components/pisellLayout/content.d.ts

@@ -0,0 +1,10 @@
+import type { LayoutProps } from 'antd';
+import React from 'react';
+export interface PisellContentProps extends Omit<LayoutProps, 'prefixCls'> {
+    children?: React.ReactNode;
+    __designMode?: string;
+    height?: number;
+    scroll?: boolean;
+}
+declare const PisellContent: React.FC<PisellContentProps>;
+export default PisellContent;

package/es/components/pisellLayout/footer.d.ts

@@ -0,0 +1,8 @@
+import type { LayoutProps } from 'antd';
+import React from 'react';
+export interface PisellFooterProps extends Omit<LayoutProps, 'prefixCls'> {
+    children?: React.ReactNode;
+    height?: number;
+}
+declare const PisellFooter: React.FC<PisellFooterProps>;
+export default PisellFooter;

package/es/components/pisellLayout/header.d.ts

@@ -0,0 +1,10 @@
+import type { LayoutProps } from 'antd';
+import React from 'react';
+import './index.less';
+export interface PisellHeaderProps extends Omit<LayoutProps, 'prefixCls'> {
+    children?: React.ReactNode;
+    height?: number;
+    fixed?: boolean;
+}
+declare const PisellHeader: React.FC<PisellHeaderProps>;
+export default PisellHeader;

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

@@ -0,0 +1,14 @@
+import type { LayoutProps } from 'antd';
+import { Layout } from 'antd';
+import React from 'react';
+export interface PisellLayoutProps extends LayoutProps {
+    children?: React.ReactNode;
+}
+export interface CompoundedComponent extends React.FC<PisellLayoutProps> {
+    Header: typeof Layout.Header;
+    Content: typeof Layout.Content;
+    Footer: typeof Layout.Footer;
+    Sider: typeof Layout.Sider;
+}
+declare const PisellLayout: CompoundedComponent;
+export default PisellLayout;

package/es/components/pisellLayout/sider.d.ts

@@ -0,0 +1,8 @@
+import type { SiderProps } from 'antd/es/layout/Sider';
+import React from 'react';
+import './index.less';
+export interface PisellSiderProps extends SiderProps {
+    children?: React.ReactNode;
+}
+declare const PisellSider: React.FC<PisellSiderProps>;
+export default PisellSider;

package/es/components/pisellLongText/PisellLongText.less

@@ -1,5 +1,6 @@
 /**
  * PisellLongText 组件样式
+ * 基于 Figma 设计规范，与 SingleLineText 设计体系一致
  */
 
 .pisell-long-text {
@@ -7,16 +8,78 @@
     position: relative;
     width: 100%;
 
-    // 基于 Figma 设计规范的 TextArea 样式
+    // TextArea 样式（Figma 设计规范，覆盖时使用 pisell-lowcode-xxx）
     .pisell-lowcode-input {
-      padding: 12px 14px; // Figma: 垂直12px，水平14px（比 Input 小2px）
+      // 基础样式
+      font-size: 16px !important;
+      line-height: 24px !important;
+
+      // 边框和圆角
+      border-radius: 8px !important;
+      border: 1px solid #d0d5dd !important; // Gray/300
+
+      // 内边距（Figma: 垂直 12px，水平 14px）
+      padding: 12px 14px !important;
+      min-height: 80px !important; // 多行最小高度，由 rows 进一步控制
+
+      // 颜色
+      color: #101828 !important; // Gray/900
+      background-color: #ffffff !important;
+
+      &::placeholder {
+        color: #667085 !important; // Gray/500
+      }
+
+      // 聚焦态
+      &:focus,
+      &:focus-within {
+        border-color: #d6bbfb !important; // Primary/300
+        box-shadow: 0 0 0 4px #f4ebff !important; // Primary/100
+        outline: none !important;
+      }
+
+      // Hover 态
+      &:hover:not(:focus):not(:focus-within):not([disabled]) {
+        border-color: #b692f6 !important; // Primary/400
+      }
+
+      // 禁用态
+      &[disabled],
+      &.pisell-lowcode-input-disabled {
+        background-color: #f9fafb !important; // Gray/50
+        color: #98a2b3 !important; // Gray/400
+        border-color: #d0d5dd !important;
+        cursor: not-allowed !important;
+      }
+    }
+
+    // 字数统计样式（TextArea showCount）
+    .pisell-lowcode-input-data-count,
+    .pisell-lowcode-input-show-count-suffix {
+      color: #667085 !important; // Gray/500
+      font-size: 14px !important;
+    }
+
+    // 错误状态
+    .pisell-lowcode-input-status-error {
+      border-color: #fda29b !important; // Error/300
+
+      &:focus,
+      &:focus-within {
+        border-color: #f97066 !important; // Error/400
+        box-shadow: 0 0 0 4px #fee4e2 !important; // Error/100
+      }
+
+      &:hover:not(:focus):not(:focus-within) {
+        border-color: #f97066 !important; // Error/400
+      }
     }
   }
 
   &-error {
     margin-top: 4px;
     font-size: 12px;
-    color: #ff4d4f;
+    color: #d92d20; // Error/600
     line-height: 1.5;
     animation: fadeIn 0.3s ease-in-out;
   }
@@ -32,12 +95,17 @@
     height: auto;
     font-size: 14px;
     margin-top: 8px;
+    color: #6d48c4;
+
+    &:hover {
+      color: #6d48c4 !important;
+    }
   }
 
   &-word-count {
     margin-top: 8px;
     font-size: 12px;
-    color: #667085;
+    color: #667085; // Gray/500
     text-align: right;
   }
 

package/es/components/pisellLongText/PisellLongText.stories.js

@@ -18,7 +18,7 @@ import React from 'react';
  * - 字数统计
  */
 var meta = {
-  title: '表单/PisellLongText',
+  title: '表单/表单组件/PisellLongText',
   component: PisellLongText,
   parameters: {
     layout: 'centered',

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

@@ -1,6 +1,7 @@
 /**
  * PisellLongText 组件导出
  */
-export { default as PisellLongText } from './PisellLongText';
+import PisellLongText from './PisellLongText';
+export { PisellLongText };
 export type { PisellLongTextProps } from './types';
 export type { DisplayState, ValidationResult, TextInputState } from './types';

package/es/components/pisellLongText/index.js

@@ -2,6 +2,21 @@
  * PisellLongText 组件导出
  */
 
-export { default as PisellLongText } from "./PisellLongText";
+import { getText } from "../../locales";
+import PisellLongText from "./PisellLongText";
+
+/** RecordBoard 列 type 联动排序：内置 A → Z / Z → A */
+PisellLongText.SortOptions = {
+  getSortItems: function getSortItems(fieldKey) {
+    return [{
+      key: "".concat(fieldKey, ":asc"),
+      label: getText('sort-a-z')
+    }, {
+      key: "".concat(fieldKey, ":desc"),
+      label: getText('sort-z-a')
+    }];
+  }
+};
+export { PisellLongText };
 
 // 公共类型从 types 中重新导出，方便使用

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

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { PisellLookupProps, PisellLookupRef } from './types';
+import './PisellLookup.less';
+export declare const PisellLookup: React.ForwardRefExoticComponent<PisellLookupProps & React.RefAttributes<PisellLookupRef>>;

package/es/components/pisellLookup/PisellLookup.js

@@ -399,11 +399,11 @@ var PisellLookupComponent = /*#__PURE__*/forwardRef(function (props, ref) {
   }, [displayType, close]);
 
   /**
-   * 处理确认触发（点击 Lookup 按钮或按 Enter 键）
+   * 处理确认触发（点击 Lookup 按钮或按 Enter 键）。支持传入当前输入值，回车时由 Trigger 传入以避免受控下 keyword 未更新导致历史未保存。
    */
-  var handleConfirm = useCallback(function () {
-    // 确认触发时保存历史记录
-    handleConfirmSearch(keyword);
+  var handleConfirm = useCallback(function (valueFromTrigger) {
+    var keywordToSearch = valueFromTrigger !== null && valueFromTrigger !== void 0 ? valueFromTrigger : keyword;
+    handleConfirmSearch(keywordToSearch);
   }, [keyword, handleConfirmSearch]);
 
   /**
@@ -428,15 +428,22 @@ var PisellLookupComponent = /*#__PURE__*/forwardRef(function (props, ref) {
 
   /**
    * 处理扫码
+   * 标记为手动操作，避免 setKeyword 触发的重渲染时防抖 effect 仍用旧的 debouncedKeyword('') 再触发一次 onSearch('')
    */
   var handleScan = useCallback(function (code) {
+    // 标记为手动操作，阻止实时搜索防抖在本次更新后误触 onSearch('')
+    isManualSelectRef.current = true;
     // 将扫码结果填入关键词
     setKeyword(code);
     // 触发搜索并保存历史记录
     handleConfirmSearch(code);
     // 触发扫码回调
     onScan === null || onScan === void 0 || onScan(code);
-  }, [setKeyword, handleConfirmSearch, onScan]);
+    // 延迟重置标记（与 handleClear 一致，等待防抖周期结束）
+    setTimeout(function () {
+      isManualSelectRef.current = false;
+    }, debounceTime + 100);
+  }, [setKeyword, handleConfirmSearch, onScan, debounceTime]);
 
   /**
    * 处理选择辅助项（历史/联想词/热门搜索）
@@ -548,17 +555,26 @@ var PisellLookupComponent = /*#__PURE__*/forwardRef(function (props, ref) {
     }, resultRender(keyword, close));
   };
 
+  /**
+   * 是否有辅助区内容（与 LookupAuxiliary 内判断一致，用于空时不展示 dropdown）
+   */
+  var hasAuxiliaryContent = showHistory && history.length > 0 || showSuggestions && suggestions.length > 0 && !!keyword || showHotWords && hotWords.length > 0 && !keyword;
+
+  /**
+   * 是否有结果区内容（loading 或有关键词且提供了 resultRender）
+   */
+  var hasResultsContent = Boolean(loading || keyword && resultRender);
+
   /**
    * 渲染内容区（辅助区 + 结果区）
    */
   var renderContent = function renderContent() {
-    var auxiliary = renderAuxiliary();
-    var results = renderResults();
-
-    // 如果没有任何内容，返回 null（避免显示空容器）
-    if (!auxiliary && !results) {
+    // 当无任何可展示内容时返回 null，避免 popup 展示空下拉框
+    if (!hasAuxiliaryContent && !hasResultsContent) {
       return null;
     }
+    var auxiliary = renderAuxiliary();
+    var results = renderResults();
     return /*#__PURE__*/React.createElement("div", {
       className: "pisell-lookup-content"
     }, auxiliary, results);