@pisell/materials 6.11.108 → 6.11.109

package/lib/components/dataSourceComponents/fields/index.d.ts

@@ -20,7 +20,7 @@ declare const formFieldMap: {
         Subdomain: import("react").FC<import("antd").InputProps & {
             onChange: (value: string) => void;
             onBlur?: ((e: import("react").FocusEvent<HTMLInputElement, Element>) => void) | undefined;
-            rootDomain: "custom" | "xzero" | "saas";
+            rootDomain: "custom" | "saas" | "xzero";
             customDomain?: string | undefined;
             value?: string | undefined;
             tenantId: string;
@@ -81,11 +81,7 @@ declare const formFieldMap: {
         extraParams?: Record<string, any> | undefined;
     }) => JSX.Element;
 };
-declare const getFieldComponent: (fieldComponent: string) => import("react").FC<any> | import("react").FC<import("./TimePicker/type").TimePickerProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | (import("react").FC<{}> & {
-    Group: import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps>;
-} & {
-    Group: import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps>;
-}) | import("react").FC<import("./ColorPicker/type").ColorPickerProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<(import("antd").DatePickerProps & import("../dataSourceForm/utils").WithModeProps) & import("../dataSourceForm/utils").WithFormItemProps> | (import("react").FC<import("./Input/type").InputProps> & {
+declare const getFieldComponent: (fieldComponent: string) => (import("react").FC<import("./Input/type").InputProps> & {
     JSON: import("react").FC<any>;
     Password: import("react").FC<import("antd/es/input").PasswordProps & import("react").RefAttributes<import("antd").InputRef> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps>;
     TextArea: import("react").FC<import("antd/es/input").TextAreaProps & import("react").RefAttributes<import("antd/es/input/TextArea").TextAreaRef> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps>;
@@ -98,7 +94,7 @@ declare const getFieldComponent: (fieldComponent: string) => import("react").FC<
     Subdomain: import("react").FC<import("antd").InputProps & {
         onChange: (value: string) => void;
         onBlur?: ((e: import("react").FocusEvent<HTMLInputElement, Element>) => void) | undefined;
-        rootDomain: "custom" | "xzero" | "saas";
+        rootDomain: "custom" | "saas" | "xzero";
         customDomain?: string | undefined;
         value?: string | undefined;
         tenantId: string;
@@ -106,6 +102,10 @@ declare const getFieldComponent: (fieldComponent: string) => import("react").FC<
         fieldKey?: string | undefined;
     } & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps>;
 }) | (import("react").FC<{}> & {
+    Group: import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps>;
+} & {
+    Group: import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps>;
+}) | import("react").FC<import("./ColorPicker/type").ColorPickerProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<(import("antd").DatePickerProps & import("../dataSourceForm/utils").WithModeProps) & import("../dataSourceForm/utils").WithFormItemProps> | (import("react").FC<{}> & {
     Group: import("react").FC<import("./Radio/type").RadioGroupProps & import("../dataSourceForm/utils").WithModeProps>;
 } & {
     Group: import("react").FC<import("./Radio/type").RadioGroupProps & import("../dataSourceForm/utils").WithModeProps>;
@@ -118,7 +118,7 @@ declare const getFieldComponent: (fieldComponent: string) => import("react").FC<
 } & {
     dataSource?: any;
     extraParams?: Record<string, any> | undefined;
-}) => JSX.Element) | import("react").FC<import("./Input.Phone/WithMode").PhoneInputProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Input.Mobile/WithMode").PhoneInputProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("antd").InputProps & {
+}) => JSX.Element) | import("react").FC<any> | import("react").FC<import("./TimePicker/type").TimePickerProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Input.Phone/WithMode").PhoneInputProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Input.Mobile/WithMode").PhoneInputProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("antd").InputProps & {
     onChange: (value: string) => void;
 } & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("antd").InputProps & import("react").RefAttributes<import("antd").InputRef> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("antd/es/input").PasswordProps & import("react").RefAttributes<import("antd").InputRef> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Radio/type").RadioGroupProps & import("../dataSourceForm/utils").WithModeProps> | import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps> | import("react").FC<import("./DateRangePicker/type").DateRangePickerProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Upload/type").UploadProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Translation/type").TranslationProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./IconSelect/type").IconSelectProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | ((props: import("./RecordListWrapper/type").RecordListWrapperProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps & {
     options?: any;

package/lib/components/dataSourceComponents/provider/variables/VariablesContext.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="react" />
+export interface VariablesContextType {
+    children?: React.ReactNode;
+    variables?: Record<string, any>;
+    registerVariable?: (value: Record<string, any>) => void;
+    parseVariable?: (str: string, localVariables?: Record<string, any>) => any;
+    registerValueVariable?: (componentId: string, value: Record<string, any>) => void;
+    registerFunctionVariable?: (componentId: string, value: Record<string, any>) => void;
+    subscribeVariables?: (listener: (allVariables: Record<string, any>, updateVariables: Record<string, any>) => void) => () => void;
+    config?: {
+        disabledHistoryListener?: boolean;
+    };
+}
+export declare const VariablesContext: import("react").Context<VariablesContextType>;
+export default VariablesContext;

package/lib/components/drag-sort-tree/TreeItem/index.d.ts

@@ -0,0 +1,18 @@
+import './index.less';
+import { ValueProps, SortType } from '../types';
+declare type IdType = string | number;
+declare type TreeItemProps = {
+    id: string | number;
+    key: string | number;
+    item: ValueProps | any;
+    depth: number;
+    lists: any[];
+    childrenProps?: SortType;
+    sensors?: any;
+    expandedKeys?: IdType[];
+    setExpandedKeys?: any;
+    onSelectKeys?: (ids: IdType) => void;
+    onChange?: (value: any[]) => void;
+};
+declare const TreeItem: (props: TreeItemProps) => JSX.Element;
+export default TreeItem;

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

@@ -0,0 +1,3 @@
+import './index.less';
+declare const Drawer: any;
+export default Drawer;

package/lib/components/filter/components/Dropdown/index.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import './index.less';
+import { DropdownProps } from './types';
+declare const Dropdown: React.FC<DropdownProps & {
+    onOpen: () => void;
+    onClose: () => void;
+    renderItem?: (item: any, otherProps?: any) => React.ReactNode;
+    className?: string;
+}>;
+export default Dropdown;

package/lib/components/filter/components/Dropdown/types.d.ts

@@ -0,0 +1,15 @@
+import { FilterItemProps } from '../../types';
+export interface DropdownProps {
+    quickFilter: FilterItemProps[];
+    otherFilter: FilterItemProps[];
+    hiddenQuickFilter?: boolean;
+    hiddenOtherFilter?: boolean;
+    onChange: (list: {
+        quickFilter: FilterItemProps[];
+        otherFilter: FilterItemProps[];
+    }) => void;
+    quickFilterMaxLength: number;
+    formFiltersPrefix: string;
+    /** 手机窄屏：筛选项下拉禁用搜索、避免自动聚焦 */
+    phoneLayout?: boolean;
+}

package/lib/components/filter/components/FilterButton/index.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { FilterListProps } from './types';
+import './index.less';
+declare const Filter: React.FC<FilterListProps>;
+export default Filter;

package/lib/components/filter/components/FilterButton/types.d.ts

@@ -0,0 +1,29 @@
+/// <reference types="react" />
+import { FilterItemProps } from '../../types';
+export declare type FilterValueType = {
+    quickFilter: FilterItemProps[];
+    otherFilter: FilterItemProps[];
+    /** 筛选项表单值，字段名 -> 值，与 Form 的 values 一致 */
+    values?: Record<string, any>;
+};
+export declare type FilterListProps = {
+    value?: FilterValueType;
+    hiddenQuickFilter?: boolean;
+    hiddenOtherFilter?: boolean;
+    onChange?: (value: FilterValueType) => void;
+    quickFilterMaxLength: number;
+    formFiltersPrefix: string;
+    renderItem?: (item: any, otherProps?: any) => React.ReactNode;
+    placement?: 'top' | 'left' | 'right' | 'bottom' | 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight' | 'leftTop' | 'leftBottom' | 'rightTop' | 'rightBottom';
+    /** 筛选按钮尺寸，与 antd Button size 一致 */
+    size?: 'small' | 'middle' | 'large';
+    /** 筛选触发按钮的 className，用于定制样式（如与设计系统对齐） */
+    buttonClassName?: string;
+    /** 筛选按钮文案，不传则使用 materials 内置多语言 */
+    buttonText?: string;
+    /**
+     * 手机窄屏布局：筛选项内下拉禁用搜索框，并避免打开时自动聚焦。
+     * RecordBoard compact-narrow / 预约手机 Table 等场景传入。
+     */
+    phoneLayout?: boolean;
+};

package/lib/components/filter/components/FilterItem/index.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { FilterItemProps } from '../../types';
+import './index.less';
+declare const FilterItem: React.FC<FilterItemProps & {
+    phoneLayout?: boolean;
+    /** 顶栏 ToolBarQuickFilter 内：移动端日期范围用 toolbar 高度触发器 */
+    phoneQuickFilterSlot?: boolean;
+}>;
+export default FilterItem;

package/lib/components/filter/components/QuickFilter/index.d.ts

@@ -0,0 +1,16 @@
+import React from "react";
+import { FilterItemProps } from "../../types";
+interface QuickFilterProps {
+    children?: React.ReactNode;
+    formFiltersPrefix: string;
+    /** 与 PisellFilter 一致：手机顶栏 / 抽屉筛选时启用 */
+    phoneLayout?: boolean;
+    /** RecordBoard 顶栏快筛槽：日期范围用 toolbar 高度触发器 */
+    phoneQuickFilterSlot?: boolean;
+    value?: {
+        quickFilter?: FilterItemProps[];
+        notSortFilter?: FilterItemProps[];
+    };
+}
+declare const QuickFilter: React.FC<QuickFilterProps>;
+export default QuickFilter;

package/lib/components/filter/types.d.ts

@@ -0,0 +1,52 @@
+import { ModeType } from "../table/types";
+/**
+ * 筛选总配置
+ */
+export declare type FilterType = {
+    /** 筛选是否展示 */
+    show: boolean;
+    /** 筛选项排序按钮是否展示 */
+    sortButtonShow: boolean;
+    /** 筛选列表 */
+    list: FilterItemProps[];
+    items?: string[];
+    /** 快速筛选最大长度 */
+    quickFilterMaxLength: number;
+    /** 配置存储模式 */
+    storageMode: "" | "localStorage";
+    /** 筛选列表项dom */
+    dom?: any;
+};
+/**
+ * 筛选列表项配置
+ * - type 为 single/input/rangePicker 等时使用内置或映射组件
+ * - type 为 "custom" 时使用 other.component，组件接收 value/onChange（由 Form 注入）
+ *
+ * other 扩展（节选）：
+ * - useAntdMobileRangePicker?: 手机布局下是否用 PisellMobileDateRangePicker（antd-mobile）替代 MUI 单框范围；
+ *   true 强制启用（无 showTime 时）；false 强制关闭；缺省时仅对字段名 orderDate 自动启用。
+ */
+export declare type FilterItemProps = {
+    type: "single" | "input" | "datePicker" | "rangePicker" | "rangePickerNew" | "search" | "custom";
+    name?: string | string[];
+    key: string;
+    props?: object;
+    label?: string;
+    sort?: boolean;
+    localFilter?: boolean;
+    other: Record<string, any>;
+    isCustom?: boolean;
+    columnKey?: string;
+    isHidden?: boolean;
+};
+/**
+ * 筛选组件属性
+ */
+export interface FilterProps {
+    filter: FilterType;
+    isRenderFormContent: boolean;
+    onValuesChange?: () => void;
+    tableId?: string;
+    viewMode?: ModeType;
+    isMobile?: boolean;
+}

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

@@ -0,0 +1,8 @@
+import { IconComponentProps } from '@ant-design/icons/es/components/Icon';
+import React from 'react';
+interface IconFontProps extends IconComponentProps {
+    type: string;
+    onClick?: React.MouseEventHandler<HTMLSpanElement>;
+}
+declare const IconFont: React.FC<IconFontProps>;
+export default IconFont;

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

@@ -0,0 +1,22 @@
+import React from 'react';
+import './index.less';
+export declare type ItemValue = string | number;
+export interface Item {
+    value: ItemValue;
+    label: React.ReactNode;
+    disabled: boolean;
+    type: 'text' | 'primary';
+    style?: React.CSSProperties;
+    size?: number;
+}
+export interface KeyboardProps {
+    id?: string;
+    className?: string;
+    style?: React.CSSProperties;
+    onChange?: (value?: ItemValue) => void;
+    items?: Item[];
+    rightItems?: Item[];
+    keydown?: boolean;
+}
+declare const _default: React.MemoExoticComponent<(props: KeyboardProps) => JSX.Element>;
+export default _default;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { ConfigProviderProps } from '../config-provider';
 interface PageProps extends ConfigProviderProps {
     variablesConfig?: {

package/lib/components/pisell-config-provider/context.d.ts

@@ -0,0 +1,22 @@
+/// <reference types="react" />
+export interface PisellContextType {
+    platform: 'h5' | 'pc' | 'ipad';
+    /** 货币符号 */
+    symbol?: string;
+    /** 当前语言环境 */
+    locale?: string;
+    /** 获取货币符号 */
+    getSymbolic?: () => string;
+}
+export declare const PisellContext: import("react").Context<PisellContextType>;
+/**
+ * provider外获取当前全局配置
+ */
+declare class GlobalConfig {
+    private config;
+    constructor();
+    setConfig(config: PisellContextType): void;
+    getConfig(): PisellContextType;
+}
+export declare const globalConfig: GlobalConfig;
+export default PisellContext;

package/lib/components/pisell-config-provider/index.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { PisellContextType } from './context';
+interface PisellConfigProviderType {
+    platform?: PisellContextType['platform'];
+    children: React.ReactNode;
+    /** 货币符号 */
+    symbol?: string;
+    /** 当前语言环境 */
+    locale?: string;
+    getSymbolic?: () => string;
+}
+declare const PisellConfigProvider: React.FC<PisellConfigProviderType>;
+export default PisellConfigProvider;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 import { PisellAdjustPriceProps } from './type';
 declare const PisellAdjustPrice: (props: PisellAdjustPriceProps) => JSX.Element;

package/lib/components/pisellAdjustPrice/status.d.ts

@@ -0,0 +1,32 @@
+export declare const defaultConfig: {
+    dark: {
+        backgroundColor: string;
+        containerBackgroundColor: string;
+        buttonBackgroundColor: string;
+        textColor: string;
+        resetButtonBackgroundColor: string;
+        resetButtonTextColor: string;
+        isDoneButtonFollowTheme: boolean;
+        doneButtonBackgroundColor: string;
+        doneButtonTextColor: string;
+        isShowMainText: boolean;
+        mainTextColor: string;
+        isShowSubText: boolean;
+        subTextColor: string;
+    };
+    light: {
+        backgroundColor: string;
+        containerBackgroundColor: string;
+        buttonBackgroundColor: string;
+        textColor: string;
+        resetButtonBackgroundColor: string;
+        resetButtonTextColor: string;
+        isDoneButtonFollowTheme: boolean;
+        doneButtonBackgroundColor: string;
+        doneButtonTextColor: string;
+        isShowMainText: boolean;
+        mainTextColor: string;
+        isShowSubText: boolean;
+        subTextColor: string;
+    };
+};

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

@@ -0,0 +1,22 @@
+export interface PisellAdjustPriceProps {
+    value?: number;
+    originValue: number;
+    defaultValue?: number;
+    onChange?: (val: number) => void;
+    selectType?: 'light' | 'dark';
+    backgroundColor?: string;
+    containerBackgroundColor?: string;
+    buttonBackgroundColor?: string;
+    textColor?: string;
+    resetButtonBackgroundColor?: string;
+    resetButtonTextColor?: string;
+    isDoneButtonFollowTheme?: boolean;
+    doneButtonBackgroundColor?: string;
+    doneButtonTextColor?: string;
+    isShowMainText?: boolean;
+    mainTextColor?: string;
+    isShowSubText?: boolean;
+    subTextColor?: string;
+    resetText?: string;
+    doneText?: string;
+}

package/lib/components/pisellCurrency/PisellCurrency.d.ts

@@ -0,0 +1,39 @@
+import React from 'react';
+import type { PisellCurrencyProps } from './types';
+import './PisellCurrency.less';
+/**
+ * PisellCurrency 货币组件
+ *
+ * 基于 PisellNumber 派生，专门处理货币数据。
+ * 默认启用千分位和2位小数，符合财务规范。
+ *
+ * @param props 组件 Props
+ *
+ * @example
+ * // 受控模式
+ * const [price, setPrice] = useState(0);
+ * <PisellCurrency
+ *   value={price}
+ *   onChange={setPrice}
+ *   currencySymbol="¥"
+ * />
+ *
+ * @example
+ * // 非受控模式
+ * <PisellCurrency
+ *   defaultValue={100}
+ *   currencySymbol="$"
+ * />
+ *
+ * @example
+ * // 只读态
+ * <PisellCurrency
+ *   mode="read"
+ *   value={1234.56}
+ *   currencySymbol="¥"
+ * />
+ * // 显示: ¥1,234.56
+ */
+export declare const PisellCurrency: React.FC<PisellCurrencyProps>;
+declare const MemoizedPisellCurrency: React.NamedExoticComponent<PisellCurrencyProps>;
+export default MemoizedPisellCurrency;

package/lib/components/pisellDataSourceContainer/components/Pagination/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { DataSourceContainerContextType } from '../../type';
+declare const _default: React.ForwardRefExoticComponent<Omit<Partial<import("antd").PaginationProps> & DataSourceContainerContextType & React.RefAttributes<unknown> & {
+    refId?: string | undefined;
+}, "ref"> & React.RefAttributes<any>>;
+export default _default;

package/lib/components/pisellEmail/PisellEmail.d.ts

@@ -0,0 +1,37 @@
+import React from 'react';
+import type { PisellEmailProps } from './types';
+import './PisellEmail.less';
+/**
+ * PisellEmail 邮箱地址组件
+ *
+ * 邮箱地址输入/展示组件，支持只读、编辑、禁用三种状态。
+ * 基于 Ant Design AutoComplete 和 Input 组件开发，提供邮箱格式校验、域名智能补全、
+ * mailto 邮件发送和域名隐藏功能。
+ *
+ * @param props 组件 Props
+ *
+ * @example
+ * // 编辑态（邮箱输入）
+ * <PisellEmail
+ *   placeholder="请输入邮箱地址"
+ *   required
+ * />
+ *
+ * @example
+ * // 只读态（可发邮件）
+ * <PisellEmail
+ *   mode="read"
+ *   value="user@example.com"
+ *   enableMailto
+ * />
+ *
+ * @example
+ * // 域名补全
+ * <PisellEmail
+ *   enableAutoComplete
+ *   autoCompleteDomains={['gmail.com', 'company.com']}
+ * />
+ */
+export declare const PisellEmail: React.FC<PisellEmailProps>;
+declare const _default: React.NamedExoticComponent<PisellEmailProps>;
+export default _default;

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

@@ -0,0 +1,19 @@
+import React from 'react';
+import { EmptyProps } from 'antd';
+import { PisellContextType } from '../pisell-config-provider/context';
+import './index.less';
+export interface PisellEmptyProps extends EmptyProps {
+    /** 平台 */
+    platform?: PisellContextType['platform'];
+    /** 额外内容描述 */
+    extraDescription?: React.ReactNode;
+    /** 额外内容描述 */
+    icon?: React.ReactNode;
+    /** 自定义底部额外操作区域 */
+    footer?: React.ReactNode;
+    [key: string]: any;
+    /** 最大宽度 */
+    maxWidth?: number;
+}
+declare const PisellEmpty: (props: PisellEmptyProps) => JSX.Element;
+export default PisellEmpty;

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

@@ -0,0 +1,3 @@
+import { PisellFilterProps } from './type';
+declare const PisellFilter: (props: PisellFilterProps) => JSX.Element;
+export default PisellFilter;

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

@@ -0,0 +1,7 @@
+import { FilterListProps } from '../filter/components/FilterButton/types';
+/**
+ * 筛选弹层 + 快筛列表；内部通过 Form.useForm 托管表单，无需也不应把 antd FormInstance 并入 props。
+ */
+export declare type PisellFilterProps = FilterListProps & {
+    hasForm?: boolean;
+};

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

@@ -0,0 +1,62 @@
+import React from 'react';
+import type { PisellLookupProps, PisellLookupRef } from '../pisellLookup';
+/**
+ * 原生扫码事件名，对齐宿主端约定。
+ */
+export declare const SCAN_RESULT_EVENT = "nativeScanResult";
+/**
+ * 扫码枪回传数据（对齐宿主 ScanResultPayload）
+ * - code: 条码标识（如条码格式 / 业务字段）
+ * - data: 扫描得到的字符串值（写入输入框的内容）
+ */
+export interface PisellFindScannerData {
+    code: string;
+    data: string;
+}
+/**
+ * PisellFind Props
+ * 继承 PisellLookup 的所有 Props，并扩展扫码枪监听相关字段。
+ */
+export interface PisellFindProps extends PisellLookupProps {
+    /**
+     * 是否开启扫码枪监听
+     * 通过宿主 `app.pubsub.subscribe('nativeScanResult', ...)` 订阅；
+     * 切换 false 时会 unsubscribe，停止接收事件。
+     * @default false
+     */
+    enableScanner?: boolean;
+    /**
+     * 扫码枪回调
+     * 监听到扫码枪事件时触发，参数为原始 payload 对象（含 `data` 字段）。
+     * 注意：仅在 enableScanner 为 true 时才会触发。
+     */
+    onScannerData?: (data: PisellFindScannerData) => void;
+}
+/**
+ * PisellFind Ref
+ * 继承 PisellLookup 的所有 Ref 方法
+ */
+export declare type PisellFindRef = PisellLookupRef;
+/**
+ * PisellFind 组件
+ * 基于 PisellLookup 的组件内查找优化版本
+ *
+ * 核心特点：
+ * - 默认使用 button 触发器
+ * - 默认不显示确认按钮（输入即搜索）
+ * - 默认开启搜索历史
+ * - 默认不展示结果区（结果在页面其他位置展示）
+ * - 通过 `enableScanner` 接入扫码枪：使用宿主 `app.pubsub.subscribe(SCAN_RESULT_EVENT, ...)`，
+ *   每次扫码直接覆盖输入框内容并触发 onSearch / onScannerData；切回 false 时自动 unsubscribe。
+ *
+ * @example
+ * ```tsx
+ * <PisellFind
+ *   triggerType="input"
+ *   enableScanner={isActive}
+ *   onScannerData={(payload) => console.log('scan:', payload.data)}
+ *   onSearch={(keyword) => filterData(keyword)}
+ * />
+ * ```
+ */
+export declare const PisellFind: React.ForwardRefExoticComponent<PisellFindProps & React.RefAttributes<PisellLookupRef>>;

package/lib/components/pisellFloorMapLayout/PisellFloorMapLayout.d.ts

@@ -0,0 +1,13 @@
+/**
+ * PisellFloorMapLayout - 空间布局视图
+ * 支持两种用法：1) 仅传入 items + renderItem（原有用法）；2) 传入 floorMapConfig + dataSources + mode 使用平面图视图（含多画布/编辑态）
+ */
+import React from 'react';
+import type { FloorMapItemBase, PisellFloorMapLayoutProps, PisellFloorMapLayoutRef } from './types';
+import './PisellFloorMapLayout.less';
+/** 空间布局根组件：阅读/编辑、列表与平面图双模式，ref 见 {@link PisellFloorMapLayoutRef} */
+declare const PisellFloorMapLayout: <T extends FloorMapItemBase = FloorMapItemBase>(props: PisellFloorMapLayoutProps<T> & {
+    ref?: React.Ref<PisellFloorMapLayoutRef | null> | undefined;
+}) => React.ReactElement;
+export { PisellFloorMapLayout };
+export default PisellFloorMapLayout;

package/lib/components/pisellFloorMapLayout/PisellFloorMapLayout.stories.d.ts

@@ -0,0 +1,59 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellFloorMapLayout } from './PisellFloorMapLayout';
+/**
+ * PisellFloorMapLayout 楼层图布局
+ *
+ * 空间布局视图：在二维平面按坐标渲染资源（桌台/房间/工位等），
+ * 支持缩放、平移、复位、区域定位，仅负责展示与交互。
+ */
+declare const meta: Meta<typeof PisellFloorMapLayout>;
+export default meta;
+declare type Story = StoryObj<typeof PisellFloorMapLayout>;
+/**
+ * 默认 - 纯色底 + 简单格子（格子单位，默认 item 间距 8px）
+ */
+export declare const Default: Story;
+/**
+ * 显示网格线（item 间距由 mapLayer.gap 控制）
+ */
+export declare const WithGrid: Story;
+/**
+ * 开启平移 - 可拖拽画布
+ */
+export declare const WithPan: Story;
+export declare const WithShapes: Story;
+export declare const WithVariableSizes: Story;
+export declare const PixelUnits: Story;
+/**
+ * 点击与 Hover 事件
+ */
+export declare const WithEvents: Story;
+/**
+ * Ref 调用 - 外部按钮控制缩放/复位/区域定位
+ */
+export declare const WithRefControls: Story;
+export declare const FloorMapViewEdit: Story;
+/**
+ * 平面图编辑态 + 自定义数据源记录表单（`dataSourceRecordForm.sales`）
+ */
+export declare const FloorMapViewEditCustomRecordForm: Story;
+/**
+ * Floor Map 视图 - 阅读态（方桌同样用 Figma 样式）
+ */
+export declare const FloorMapViewRead: Story;
+/**
+ * 平面图阅读态 - 验证 appearanceMode 的暗色背景兜底
+ */
+export declare const DarkBackground: Story;
+/**
+ * 自定义控制按钮显隐
+ */
+export declare const ControlsHidden: Story;
+/**
+ * `FloorMapLayoutProvider` 注入 `floorMapConfig` / `dataSources`；Layout 仅传展示向 props
+ */
+export declare const FloorMapWithLayoutProvider: Story;
+/**
+ * Figma 设计稿效果 - 餐厅桌台状态图（顶部 Tab + 图例参考 node 14131:6266，内容区不变）
+ */
+export declare const FigmaDesign: Story;