@pisell/materials 6.11.13 → 6.11.15

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) => 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/pisellInformationEntry/Input/index.d.ts

@@ -4,5 +4,5 @@ export interface PisellEntryInputProps {
     onChange: (val: string) => void;
     searchDescribe?: React.ReactNode;
 }
-declare const PisellEntryInput: (props: PisellEntryInputProps) => React.JSX.Element;
+declare const PisellEntryInput: (props: PisellEntryInputProps) => JSX.Element;
 export default PisellEntryInput;

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

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

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

@@ -29,5 +29,5 @@ export interface PisellInformationEntryProps extends Omit<React.HTMLAttributes<H
     /** 录入类型切换时候触发的 */
     onChangeType?: (val: null | EntryModeType['type']) => void;
 }
-declare const PisellInformationEntry: (props: PisellInformationEntryProps) => React.JSX.Element;
+declare const PisellInformationEntry: (props: PisellInformationEntryProps) => JSX.Element;
 export default PisellInformationEntry;

package/lib/components/pisellInput/components/BankCard/index.d.ts

@@ -1,4 +1,4 @@
-import React from 'react';
+/// <reference types="react" />
 import { InputProps } from 'antd';
 import { PisellContextType } from "../../../pisell-config-provider/context";
 import './index.less';
@@ -7,5 +7,5 @@ export declare type BankCardProps = InputProps & {
     platform?: PisellContextType['platform'];
     onChange?: (val: string) => void;
 };
-declare const BankCard: (props: BankCardProps) => React.JSX.Element;
+declare const BankCard: (props: BankCardProps) => JSX.Element;
 export default BankCard;

package/lib/components/pisellInput/components/Copy/index.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 import { InputProps, ButtonProps } from 'antd';
 import { PisellContextType } from "../../../pisell-config-provider/context";
 export interface CopyProps extends InputProps {
@@ -7,5 +6,5 @@ export interface CopyProps extends InputProps {
     /** 后缀button的透传配置 */
     buttonProps?: ButtonProps;
 }
-declare const Copy: (props: CopyProps) => React.JSX.Element;
+declare const Copy: (props: CopyProps) => JSX.Element;
 export default Copy;

package/lib/components/pisellInput/components/SecurityCode/index.d.ts

@@ -1,4 +1,4 @@
-import React from 'react';
+/// <reference types="react" />
 import { InputProps } from 'antd';
 import './index.less';
 import { PisellContextType } from "../../../pisell-config-provider/context";
@@ -8,5 +8,5 @@ export interface SecurityCodeProps extends Omit<InputProps, 'onChange'> {
     onChange?: (val: string) => void;
     showCVCIcon?: boolean;
 }
-declare const SecurityCode: (props: SecurityCodeProps) => React.JSX.Element;
+declare const SecurityCode: (props: SecurityCodeProps) => JSX.Element;
 export default SecurityCode;

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

@@ -1,13 +1,13 @@
-import React from 'react';
+/// <reference types="react" />
 import { InputProps } from 'antd';
 import { PisellContextType } from '../pisell-config-provider/context';
 declare const PisellInput: {
     (props: InputProps & {
         /** 平台 */
         platform?: PisellContextType['platform'];
-    }): React.JSX.Element;
-    BankCard: (props: import("./components/BankCard").BankCardProps) => React.JSX.Element;
-    SecurityCode: (props: import("./components/SecurityCode").SecurityCodeProps) => React.JSX.Element;
-    Copy: (props: import("./components/Copy").CopyProps) => React.JSX.Element;
+    }): JSX.Element;
+    BankCard: (props: import("./components/BankCard").BankCardProps) => JSX.Element;
+    SecurityCode: (props: import("./components/SecurityCode").SecurityCodeProps) => JSX.Element;
+    Copy: (props: import("./components/Copy").CopyProps) => JSX.Element;
 };
 export default PisellInput;

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/pisellLoading/index.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 import { SpinProps } from 'antd';
 import './index.less';
 declare type MaskType = {
@@ -16,5 +15,5 @@ export interface PisellLoadingProps extends SpinProps {
     /** 延迟显示加载效果的时间（防止闪烁）	 */
     delay?: number;
 }
-declare const PisellLoading: (props: PisellLoadingProps) => React.JSX.Element;
+declare const PisellLoading: (props: PisellLoadingProps) => JSX.Element;
 export default PisellLoading;

package/lib/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/lib/components/pisellLookup/PisellLookup.stories.d.ts

@@ -0,0 +1,129 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellLookup } from './PisellLookup';
+/**
+ * PisellLookup 组件 Storybook
+ * 搜索交互协议组件，提供统一的搜索入口、状态管理和结果承载能力
+ */
+declare const meta: Meta<typeof PisellLookup>;
+export default meta;
+declare type Story = StoryObj<typeof PisellLookup>;
+/**
+ * 基础示例 - Input 触发器 + Inline 展示
+ */
+export declare const Basic: Story;
+/**
+ * Input 触发器 - 默认尺寸（Middle）
+ */
+export declare const InputTriggerMiddle: Story;
+/**
+ * Input 触发器 - 大号尺寸
+ */
+export declare const InputTriggerLarge: Story;
+/**
+ * Button 触发器 + Modal 展示
+ */
+export declare const ButtonTrigger: Story;
+/**
+ * Icon 触发器 + Modal 展示
+ */
+export declare const IconTrigger: Story;
+/**
+ * Text 触发器 + Modal 展示
+ */
+export declare const TextTrigger: Story;
+/**
+ * 自定义触发器 + Modal 展示
+ */
+export declare const CustomTrigger: Story;
+/**
+ * Drawer 展示模式
+ */
+export declare const DrawerDisplay: Story;
+/**
+ * 搜索历史功能
+ */
+export declare const WithSearchHistory: Story;
+/**
+ * 联想词功能
+ */
+export declare const WithSuggestions: Story;
+/**
+ * 热门搜索功能
+ */
+export declare const WithHotWords: Story;
+/**
+ * 完整功能 - 历史 + 联想词 + 热门搜索
+ */
+export declare const FullFeatures: Story;
+/**
+ * 实时搜索模式
+ */
+export declare const RealtimeSearch: Story;
+/**
+ * 确认触发模式
+ */
+export declare const ConfirmSearch: Story;
+/**
+ * 受控模式示例
+ */
+export declare const Controlled: Story;
+/**
+ * 加载状态
+ */
+export declare const Loading: Story;
+/**
+ * 禁用状态
+ */
+export declare const Disabled: Story;
+/**
+ * Modal 自定义宽度
+ */
+export declare const ModalCustomWidth: Story;
+/**
+ * Modal 显示遮罩层
+ */
+export declare const ModalWithMask: Story;
+/**
+ * Modal 挂载到容器并使用 100% 宽度
+ */
+export declare const ModalFullWidth: Story;
+/**
+ * Drawer 不同方向
+ */
+export declare const DrawerPlacements: Story;
+/**
+ * 自定义空状态
+ */
+export declare const CustomEmpty: Story;
+/**
+ * 移动端场景
+ */
+export declare const MobileScenario: Story;
+/**
+ * 保留搜索内容（默认行为）
+ */
+export declare const PreserveKeyword: Story;
+/**
+ * 关闭时清空内容
+ */
+export declare const ClearOnClose: Story;
+/**
+ * 隐藏 Lookup 按钮（输入即搜索）
+ */
+export declare const NoConfirmButton: Story;
+/**
+ * 监听打开和关闭事件
+ */
+export declare const WithOpenCloseEvents: Story;
+/**
+ * 使用 Ref 控制
+ */
+export declare const WithRef: Story;
+/**
+ * 仅触发搜索（不展示结果）
+ */
+export declare const OnlyTriggerSearch: Story;
+/**
+ * Playground - 自由配置
+ */
+export declare const Playground: Story;

package/lib/components/pisellLookup/components/HotWords.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { HotWordsProps } from '../types';
+/**
+ * HotWords 组件
+ * 展示热门搜索
+ */
+export declare const HotWords: React.FC<HotWordsProps>;

package/lib/components/pisellLookup/components/LookupAuxiliary.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { LookupAuxiliaryProps } from '../types';
+/**
+ * LookupAuxiliary 组件
+ * 辅助信息层：搜索历史、联想词、热门搜索
+ */
+export declare const LookupAuxiliary: React.FC<LookupAuxiliaryProps>;

package/lib/components/pisellLookup/components/LookupResultHost.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { LookupResultHostProps } from '../types';
+/**
+ * LookupResultHost 组件
+ * 结果承载层：根据展示类型渲染不同的容器
+ */
+export declare const LookupResultHost: React.FC<LookupResultHostProps>;

package/lib/components/pisellLookup/components/SearchHistory.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { SearchHistoryProps } from '../types';
+/**
+ * SearchHistory 组件
+ * 展示搜索历史记录
+ */
+export declare const SearchHistory: React.FC<SearchHistoryProps>;

package/lib/components/pisellLookup/components/SuggestWords.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { SuggestWordsProps } from '../types';
+/**
+ * SuggestWords 组件
+ * 展示搜索联想词
+ */
+export declare const SuggestWords: React.FC<SuggestWordsProps>;

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

@@ -0,0 +1,9 @@
+/**
+ * 子组件统一导出
+ */
+export { SearchHistory } from './SearchHistory';
+export { SuggestWords } from './SuggestWords';
+export { HotWords } from './HotWords';
+export { LookupAuxiliary } from './LookupAuxiliary';
+export { LookupTrigger } from './LookupTrigger';
+export { LookupResultHost } from './LookupResultHost';

package/lib/components/pisellLookup/hooks/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 自定义 Hooks 统一导出
+ */
+export * from './useSearchState';
+export * from './useSearchHistory';
+export * from './useDebounceSearch';

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

@@ -0,0 +1,48 @@
+/**
+ * 搜索历史管理 Hook
+ */
+export interface UseSearchHistoryOptions {
+    /**
+     * 存储 key
+     */
+    historyKey: string;
+    /**
+     * 最大历史记录数量
+     */
+    maxHistoryCount: number;
+    /**
+     * 自定义加载历史记录函数
+     */
+    onLoadHistory?: () => string[];
+    /**
+     * 自定义保存历史记录函数
+     */
+    onSaveHistory?: (history: string[]) => void;
+}
+export interface UseSearchHistoryResult {
+    /**
+     * 历史记录数组
+     */
+    history: string[];
+    /**
+     * 添加历史记录
+     */
+    addHistory: (keyword: string) => void;
+    /**
+     * 删除历史记录
+     */
+    removeHistory: (keyword: string) => void;
+    /**
+     * 清除全部历史记录
+     */
+    clearAllHistory: () => void;
+    /**
+     * 重新加载历史记录
+     */
+    reloadHistory: () => void;
+}
+/**
+ * 搜索历史管理 Hook
+ * 支持自定义存储逻辑
+ */
+export declare const useSearchHistory: (options: UseSearchHistoryOptions) => UseSearchHistoryResult;

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

@@ -0,0 +1,6 @@
+/**
+ * PisellLookup 组件导出
+ */
+export { PisellLookup } from './PisellLookup';
+export type { PisellLookupRef } from './types';
+export type * from './types';

package/lib/components/pisellLookup/utils/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 工具函数统一导出
+ */
+export * from './storage';
+export * from './trigger';

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