@pisell/materials 6.3.26 → 6.3.28

package/lib/components/pisellFilter/index.js

@@ -43,38 +43,109 @@ var PisellFilter = (props) => {
     hiddenQuickFilter = true,
     hiddenOtherFilter = false,
     hasForm = true,
+    onChange,
     ...otherProps
   } = props;
-  const [value, setValue] = (0, import_react.useState)({});
+  const [form] = import_antd.Form.useForm();
+  const [value, setValue] = (0, import_react.useState)(() => ({
+    quickFilter: (originalValue == null ? void 0 : originalValue.quickFilter) || [],
+    otherFilter: (originalValue == null ? void 0 : originalValue.otherFilter) || [],
+    values: (originalValue == null ? void 0 : originalValue.values) || {}
+  }));
+  const isInternalChange = (0, import_react.useRef)(false);
   (0, import_react.useEffect)(() => {
-    setValue({
-      quickFilter: (originalValue == null ? void 0 : originalValue.quickFilter) || [],
-      otherFilter: (originalValue == null ? void 0 : originalValue.otherFilter) || []
-    });
-  }, [originalValue]);
+    setValue((prev) => ({
+      quickFilter: (originalValue == null ? void 0 : originalValue.quickFilter) ?? prev.quickFilter,
+      otherFilter: (originalValue == null ? void 0 : originalValue.otherFilter) ?? prev.otherFilter,
+      values: (originalValue == null ? void 0 : originalValue.values) ?? prev.values ?? {}
+    }));
+  }, [
+    originalValue == null ? void 0 : originalValue.quickFilter,
+    originalValue == null ? void 0 : originalValue.otherFilter,
+    originalValue == null ? void 0 : originalValue.values
+  ]);
+  (0, import_react.useEffect)(() => {
+    if (!hasForm || typeof (originalValue == null ? void 0 : originalValue.values) !== "object") return;
+    if (isInternalChange.current) {
+      isInternalChange.current = false;
+      return;
+    }
+    const nextValues = (originalValue == null ? void 0 : originalValue.values) ?? {};
+    if (Object.keys(nextValues).length === 0) {
+      const current = form.getFieldsValue(true);
+      const cleared = Object.keys(current).reduce(
+        (acc, k) => {
+          acc[k] = void 0;
+          return acc;
+        },
+        {}
+      );
+      if (Object.keys(cleared).length > 0) {
+        form.setFieldsValue(cleared);
+      }
+    } else {
+      form.setFieldsValue(nextValues);
+    }
+  }, [hasForm, form, originalValue == null ? void 0 : originalValue.values]);
+  const handleChange = (0, import_react.useCallback)(
+    (newVal) => {
+      setValue((prev) => ({
+        ...prev,
+        ...newVal,
+        values: newVal.values ?? prev.values
+      }));
+      onChange == null ? void 0 : onChange(newVal);
+    },
+    [onChange]
+  );
+  const handleFormValuesChange = (0, import_react.useCallback)(
+    (_, allValues) => {
+      if (typeof allValues !== "object" || allValues === null) return;
+      isInternalChange.current = true;
+      const mergedValues = { ...value.values, ...allValues };
+      const next = {
+        quickFilter: value.quickFilter,
+        otherFilter: value.otherFilter,
+        values: mergedValues
+      };
+      setValue(next);
+      onChange == null ? void 0 : onChange(next);
+    },
+    [value.quickFilter, value.otherFilter, value.values, onChange]
+  );
   const content = (0, import_react.useMemo)(() => {
     return /* @__PURE__ */ import_react.default.createElement(
       import_FilterButton.default,
       {
         ...otherProps,
+        onChange: handleChange,
         value: {
           quickFilter: value.quickFilter,
           otherFilter: value.otherFilter
         },
         hiddenQuickFilter,
         hiddenOtherFilter,
-        onChange: setValue,
         quickFilterMaxLength: quickFilterMaxLength || 100,
         formFiltersPrefix: formFiltersPrefix || ""
       }
     );
-  }, [value, hiddenQuickFilter, hiddenOtherFilter, quickFilterMaxLength, formFiltersPrefix]);
+  }, [
+    value,
+    hiddenQuickFilter,
+    hiddenOtherFilter,
+    quickFilterMaxLength,
+    formFiltersPrefix,
+    handleChange
+  ]);
   if (hasForm) {
     return /* @__PURE__ */ import_react.default.createElement(
       import_antd.Form,
       {
+        form,
         size: "large",
         layout: "vertical",
+        initialValues: value.values,
+        onValuesChange: handleFormValuesChange,
         ...otherProps
       },
       content

package/lib/components/pisellFilter/type.d.ts

@@ -0,0 +1,5 @@
+import { FilterListProps } from '../filter/components/FilterButton/types';
+import { FormInstance } from 'antd';
+export declare type PisellFilterProps = FilterListProps & FormInstance & {
+    hasForm?: boolean;
+};

package/lib/components/pisellFind/PisellFind.stories.d.ts

@@ -0,0 +1,45 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellFind } from './index';
+/**
+ * PisellFind 组件 Storybook
+ * 基于 PisellLookup 的组件内查找优化版本
+ */
+declare const meta: Meta<typeof PisellFind>;
+export default meta;
+declare type Story = StoryObj<typeof PisellFind>;
+/**
+ * 基础示例 - 列表查找
+ */
+export declare const Basic: Story;
+/**
+ * 表格查找
+ */
+export declare const TableFind: Story;
+/**
+ * Input 模式查找
+ */
+export declare const InputMode: Story;
+/**
+ * 使用 Ref 控制
+ */
+export declare const WithRef: Story;
+/**
+ * 显示确认按钮
+ */
+export declare const WithConfirmButton: Story;
+/**
+ * 关闭历史记录
+ */
+export declare const NoHistory: Story;
+/**
+ * 多字段搜索
+ */
+export declare const MultiFieldSearch: Story;
+/**
+ * Drawer 模式
+ */
+export declare const DrawerMode: Story;
+/**
+ * Playground - 自由配置
+ */
+export declare const Playground: Story;

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

@@ -0,0 +1,40 @@
+import React from 'react';
+import type { PisellLookupProps, PisellLookupRef } from '../pisellLookup';
+/**
+ * PisellFind Props
+ * 继承 PisellLookup 的所有 Props
+ */
+export declare type PisellFindProps = PisellLookupProps;
+/**
+ * PisellFind Ref
+ * 继承 PisellLookup 的所有 Ref 方法
+ */
+export declare type PisellFindRef = PisellLookupRef;
+/**
+ * PisellFind 组件
+ * 基于 PisellLookup 的组件内查找优化版本
+ *
+ * 核心特点：
+ * - 默认使用 button 触发器
+ * - 默认不显示确认按钮（输入即搜索）
+ * - 默认开启搜索历史
+ * - 默认不展示结果区（结果在页面其他位置展示）
+ *
+ * @example
+ * ```tsx
+ * // 基础用法
+ * <PisellFind
+ *   onSearch={(keyword) => {
+ *     const filtered = data.filter(item => item.name.includes(keyword));
+ *     setFilteredData(filtered);
+ *   }}
+ * />
+ *
+ * // 切换为 Input 模式
+ * <PisellFind
+ *   triggerType="input"
+ *   onSearch={(keyword) => filterData(keyword)}
+ * />
+ * ```
+ */
+export declare const PisellFind: React.ForwardRefExoticComponent<PisellLookupProps & React.RefAttributes<PisellLookupRef>>;

package/lib/components/pisellFind/index.js

@@ -33,14 +33,23 @@ __export(pisellFind_exports, {
 });
 module.exports = __toCommonJS(pisellFind_exports);
 var import_react = __toESM(require("react"));
+var import_utils = require("@pisell/utils");
 var import_pisellLookup = require("../pisellLookup");
 var import_locales = require("../../locales");
 var PisellFind = (0, import_react.forwardRef)((props, ref) => {
   const {
     // 提取需要设置默认值的 Props
     triggerType = "button",
-    buttonText = (0, import_locales.getText)("pisell-find-button-text"),
-    placeholder = (0, import_locales.getText)("pisell-find-placeholder"),
+    buttonText = (() => {
+      const key = "pisell2.recordBoard.toolbar.find";
+      const u = import_utils.locales.getText(key);
+      return u && u !== key ? u : (0, import_locales.getText)(key) || (0, import_locales.getText)("pisell-find-button-text");
+    })(),
+    placeholder = (() => {
+      const key = "pisell2.recordBoard.toolbar.findPlaceholder";
+      const u = import_utils.locales.getText(key);
+      return u && u !== key ? u : (0, import_locales.getText)(key) || (0, import_locales.getText)("pisell-find-placeholder");
+    })(),
     showConfirmButton = false,
     showHistory = true,
     historyKey = "pisell_find_history",

package/lib/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/lib/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/lib/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/lib/components/pisellGridPro/GridView/type.d.ts

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

package/lib/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/lib/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/lib/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/lib/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/lib/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/lib/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/lib/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/lib/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/lib/components/pisellGridPro/index.d.ts

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

package/lib/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/lib/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/lib/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/lib/components/pisellInformationEntry/hooks/useNativeScanner.d.ts

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

package/lib/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/lib/components/pisellInformationEntry/utils.d.ts

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

package/lib/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/lib/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/lib/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/lib/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/lib/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/lib/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;