@pisell/materials 1.8.22 → 1.8.23

package/es/components/pisellEmail/components/EditView.d.ts

@@ -1,15 +0,0 @@
-import React from 'react';
-import type { PisellEmailProps } from '../types';
-/**
- * PisellEmail 编辑态视图组件
- *
- * 职责：
- * - 渲染编辑态邮箱输入框
- * - 提供域名智能补全（基于 AutoComplete）
- * - 实时格式校验（标准/严格）
- * - 错误提示展示
- *
- * @param props 组件 Props
- */
-declare const EditView: React.FC<PisellEmailProps>;
-export default EditView;

package/es/components/pisellEmail/components/ReadOnlyView.d.ts

@@ -1,15 +0,0 @@
-import React from 'react';
-import type { PisellEmailProps } from '../types';
-/**
- * PisellEmail 只读态视图组件
- *
- * 职责：
- * - 渲染只读态邮箱地址展示
- * - 支持点击唤起邮件客户端（mailto）
- * - 支持域名隐藏/脱敏（partial/full 模式）
- * - 支持邮件图标按钮
- *
- * @param props 组件 Props
- */
-declare const ReadOnlyView: React.FC<PisellEmailProps>;
-export default ReadOnlyView;

package/es/components/pisellEmail/constants/emailDomains.d.ts

@@ -1,5 +0,0 @@
-/**
- * 常用邮箱域名列表
- * 用于域名自动补全功能
- */
-export declare const COMMON_EMAIL_DOMAINS: string[];

package/es/components/pisellEmail/constants/emailRegex.d.ts

@@ -1,13 +0,0 @@
-/**
- * 邮箱正则表达式常量
- */
-/**
- * 标准邮箱格式正则
- * 覆盖99%的常见邮箱格式
- */
-export declare const EMAIL_REGEX: RegExp;
-/**
- * 严格邮箱格式正则（RFC 5322）
- * 支持更复杂的邮箱格式，符合 RFC 5322 标准
- */
-export declare const STRICT_EMAIL_REGEX: RegExp;

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

@@ -1,7 +0,0 @@
-/**
- * PisellEmail 组件导出文件
- */
-import PisellEmail from './PisellEmail';
-export { PisellEmail };
-export default PisellEmail;
-export type { PisellEmailProps, MailtoOptions } from './types';

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

@@ -1,176 +0,0 @@
-import type { CSSProperties } from 'react';
-import type { BaseTextInputProps } from '@pisell/utils';
-/**
- * Mailto 邮件参数配置类型
- */
-export interface MailtoOptions {
-    /**
-     * 邮件主题
-     * @example '产品咨询'
-     */
-    subject?: string;
-    /**
-     * 邮件正文
-     * @example '您好，我想咨询...'
-     */
-    body?: string;
-    /**
-     * 抄送地址
-     * @example 'cc@example.com'
-     */
-    cc?: string;
-    /**
-     * 密送地址
-     * @example 'bcc@example.com'
-     */
-    bcc?: string;
-}
-/**
- * PisellEmail 组件 Props 类型定义
- *
- * 继承 BaseTextInputProps，添加邮箱特有的配置
- */
-export interface PisellEmailProps extends BaseTextInputProps {
-    /**
-     * 状态模式
-     * @default 'edit'
-     */
-    mode?: 'read' | 'edit';
-    /**
-     * 是否禁用
-     * @default false
-     */
-    disabled?: boolean;
-    /**
-     * 是否使用严格校验（RFC 5322）
-     * @default false
-     */
-    strictValidation?: boolean;
-    /**
-     * 白名单域名列表（仅允许指定域名）
-     * @example ['company.com', 'partner.com']
-     */
-    allowedDomains?: string[];
-    /**
-     * 黑名单域名列表（禁止某些域名）
-     * @example ['tempmail.com', '10minutemail.com']
-     */
-    blockedDomains?: string[];
-    /**
-     * 是否启用域名自动补全
-     * @default true
-     */
-    enableAutoComplete?: boolean;
-    /**
-     * 自定义补全域名列表
-     * @example ['gmail.com', 'company.com', 'custom.com']
-     */
-    autoCompleteDomains?: string[];
-    /**
-     * 是否显示所有建议（不过滤）
-     * @default false
-     */
-    showAllSuggestions?: boolean;
-    /**
-     * 选择补全建议回调
-     * @param value 选中的邮箱地址
-     */
-    onSelect?: (value: string) => void;
-    /**
-     * 是否启用 mailto（只读态）
-     * @default true
-     */
-    enableMailto?: boolean;
-    /**
-     * 是否显示邮件图标
-     * @default false
-     */
-    showEmailIcon?: boolean;
-    /**
-     * mailto 默认参数
-     */
-    mailtoOptions?: MailtoOptions;
-    /**
-     * 发送邮件回调
-     * @param email 邮箱地址
-     */
-    onMailto?: (email: string) => void;
-    /**
-     * 是否隐藏域名（只读态）
-     * @default false
-     */
-    hideDomain?: boolean;
-    /**
-     * 脱敏模式
-     * - partial: 部分隐藏（u***@gmail.com）
-     * - full: 完全隐藏（user@***）
-     * @default 'partial'
-     */
-    maskPattern?: 'partial' | 'full';
-    /**
-     * 是否显示为链接（只读态）
-     * @default true
-     */
-    displayAsLink?: boolean;
-    /**
-     * 字号
-     * @example '14px' 或 14
-     * @default 16
-     */
-    fontSize?: string | number;
-    /**
-     * 字重
-     * @example 'bold' 或 600
-     * @default 500
-     */
-    fontWeight?: string | number;
-    /**
-     * 文本颜色
-     * @example '#000000'
-     * @default '#101828'
-     */
-    color?: string;
-    /**
-     * 链接颜色（只读态）
-     * @example '#1890ff'
-     * @default '#7F56DA'
-     */
-    linkColor?: string;
-    /**
-     * 占位文本
-     * @default '请输入邮箱地址'
-     */
-    placeholder?: string;
-    /**
-     * 最大长度（RFC 5321）
-     * @default 254
-     */
-    maxLength?: number;
-    /**
-     * 是否显示清空按钮
-     * @default false
-     */
-    allowClear?: boolean;
-    /**
-     * 是否自动聚焦
-     * @default false
-     */
-    autoFocus?: boolean;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-    /**
-     * 自定义样式
-     */
-    style?: CSSProperties;
-    /**
-     * ARIA 标签
-     */
-    'aria-label'?: string;
-    /**
-     * ARIA 描述
-     */
-    'aria-describedby'?: string;
-}
-export type { DisplayState, ValidationResult, TextInputState } from '@pisell/utils';

package/es/components/pisellEmail/utils/domainSuggestions.d.ts

@@ -1,15 +0,0 @@
-/**
- * 域名补全工具函数（框架占位符）
- * TODO: 实现完整的补全逻辑
- */
-/**
- * 获取邮箱域名补全建议
- * @param input 用户输入
- * @param domains 域名列表
- * @returns 补全建议列表
- *
- * @example
- * getEmailSuggestions('user@g', COMMON_EMAIL_DOMAINS)
- * // 返回: ['user@gmail.com']
- */
-export declare function getEmailSuggestions(input: string, domains?: string[]): string[];

package/es/components/pisellEmail/utils/emailHelper.d.ts

@@ -1,66 +0,0 @@
-/**
- * 邮箱辅助函数
- */
-import type { MailtoOptions } from '../types';
-/**
- * 提取邮箱域名
- * @param email 邮箱地址
- * @returns 域名部分
- *
- * @example
- * extractEmailDomain('user@example.com') // 'example.com'
- */
-export declare function extractEmailDomain(email: string): string;
-/**
- * 提取邮箱本地部分
- * @param email 邮箱地址
- * @returns 本地部分（@ 前面的部分）
- *
- * @example
- * extractEmailLocal('user@example.com') // 'user'
- */
-export declare function extractEmailLocal(email: string): string;
-/**
- * 规范化邮箱地址（转小写）
- * @param email 邮箱地址
- * @returns 规范化后的邮箱地址
- *
- * @example
- * normalizeEmail('User@Example.COM') // 'user@example.com'
- */
-export declare function normalizeEmail(email: string): string;
-/**
- * 邮箱域名脱敏（partial 模式）
- * 只显示本地部分的第一个字符，其余用 *** 替代
- *
- * @param email 邮箱地址
- * @returns 脱敏后的邮箱（u***@gmail.com）
- *
- * @example
- * hideEmailDomain('user@gmail.com') // 'u***@gmail.com'
- */
-export declare function hideEmailDomain(email: string): string;
-/**
- * 邮箱域名完全隐藏（full 模式）
- * 隐藏整个域名部分
- *
- * @param email 邮箱地址
- * @returns 脱敏后的邮箱（user@***）
- *
- * @example
- * maskEmailDomain('user@gmail.com') // 'user@***'
- */
-export declare function maskEmailDomain(email: string): string;
-/**
- * 处理 mailto 点击，唤起邮件客户端
- *
- * @param email 邮箱地址
- * @param options mailto 可选参数（主题、正文、抄送等）
- *
- * @example
- * handleEmailClick('support@example.com', {
- *   subject: '产品咨询',
- *   body: '您好，我想咨询...'
- * })
- */
-export declare function handleEmailClick(email: string, options?: MailtoOptions): void;

package/es/components/pisellEmail/utils/emailValidator.d.ts

@@ -1,45 +0,0 @@
-/**
- * 邮箱校验工具函数
- */
-/**
- * 标准邮箱格式校验
- * @param email 邮箱地址
- * @returns 是否通过校验
- *
- * @example
- * validateEmail('user@example.com') // true
- * validateEmail('invalid-email') // false
- */
-export declare function validateEmail(email: string): boolean;
-/**
- * 严格邮箱格式校验（RFC 5322）
- * @param email 邮箱地址
- * @returns 是否通过校验
- *
- * @example
- * validateEmailStrict('user@example.com') // true
- */
-export declare function validateEmailStrict(email: string): boolean;
-/**
- * 邮箱分部校验
- * 检查邮箱的各个部分是否符合规范
- *
- * @param email 邮箱地址
- * @returns 校验结果
- */
-export declare function validateEmailParts(email: string): {
-    isValid: boolean;
-    errors: string[];
-};
-/**
- * 域名白名单/黑名单校验
- *
- * @param email 邮箱地址
- * @param allowedDomains 白名单域名列表
- * @param blockedDomains 黑名单域名列表
- * @returns 校验结果
- */
-export declare function validateEmailDomain(email: string, allowedDomains?: string[], blockedDomains?: string[]): {
-    isValid: boolean;
-    errors: string[];
-};

package/es/components/pisellEmail/utils/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * PisellEmail 工具函数导出
- */
-export * from './emailValidator';
-export * from './emailHelper';
-export * from './domainSuggestions';

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

@@ -1,19 +0,0 @@
-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) => React.JSX.Element;
-export default PisellEmpty;

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

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

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

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

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

@@ -1,45 +0,0 @@
-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/es/components/pisellFind/index.d.ts

@@ -1,40 +0,0 @@
-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/es/components/pisellFloorMapLayout/PisellFloorMapLayout.d.ts

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

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

@@ -1,55 +0,0 @@
-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;
-/**
- * 自定义控制按钮显隐
- */
-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;

package/es/components/pisellFloorMapLayout/components/CanvasTabs.d.ts

@@ -1,27 +0,0 @@
-/**
- * CanvasTabs - 多画布 Tab，支持切换、动态添加、删除与重命名（编辑态）
- * - 展示名：可选 `nameKey` + `locales.getText`，否则用 `name`（字符串或多语言对象）
- * - 角标：可选 `tabBadge` 或由布局层注入合并后的数量
- */
-import React from 'react';
-import type { FloorMapCanvas, FloorMapCanvasNameI18n } from '../types';
-import './CanvasTabs.less';
-export interface CanvasTabsProps {
-    /** 画布列表 */
-    canvases: FloorMapCanvas[];
-    /** 当前画布 id */
-    currentCanvasId: string | null;
-    /** 切换画布 */
-    onTabChange: (canvasId: string) => void;
-    /** 是否允许添加/删除/重命名画布（编辑态） */
-    canEdit?: boolean;
-    /** 添加画布 */
-    onAddCanvas?: () => void;
-    /** 删除画布（至少保留一个画布时可调用） */
-    onRemoveCanvas?: (canvasId: string) => void;
-    /** 重命名画布（对象写入 `name`，并清除 `nameKey`） */
-    onRenameCanvas?: (canvasId: string, name: string | FloorMapCanvasNameI18n) => void;
-    className?: string;
-}
-export declare function CanvasTabs(props: CanvasTabsProps): React.JSX.Element;
-export default CanvasTabs;

package/es/components/pisellFloorMapLayout/components/EditableItemLayer.d.ts

@@ -1,37 +0,0 @@
-/**
- * EditableItemLayer - 编辑态图元层：拖拽、缩放、选中、吸附
- */
-import React, { type CSSProperties } from 'react';
-import type { FloorMapItemBase, FloorMapMergedItem, FloorMapRenderOptions } from '../types';
-import './EditableItemLayer.less';
-export interface EditableItemLayerProps<T extends FloorMapItemBase = FloorMapMergedItem> {
-    items: T[];
-    renderItem: (item: T, index: number, options?: FloorMapRenderOptions) => React.ReactNode;
-    rowKey?: string | ((item: T, index: number) => string);
-    cellSize: number;
-    itemUnit?: 'cell' | 'pixel';
-    itemGap?: number;
-    contentWidth: number;
-    contentHeight: number;
-    /** 内容区 X/Y 偏移（画布包围盒向左/上扩展时，图元层整体平移） */
-    contentOffsetX?: number;
-    contentOffsetY?: number;
-    selectedId: string | null;
-    onSelect: (id: string | null) => void;
-    onUpdateItem: (itemId: string, patch: Partial<{
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    }>) => void;
-    snapStep?: number;
-    /** 画布当前缩放，用于将屏幕位移转为内容位移 */
-    scale?: number;
-    /** 拖拽/缩放图元时通知父组件，用于禁用画布平移，避免松手时画布跟着动 */
-    onInteractionChange?: (active: boolean) => void;
-    /** 每项外层容器额外样式（与定位样式合并） */
-    getMergedItemWrapperStyle?: (item: T, index: number) => CSSProperties | undefined;
-    className?: string;
-}
-export declare function EditableItemLayer<T extends FloorMapItemBase>(props: EditableItemLayerProps<T>): React.JSX.Element;
-export default EditableItemLayer;

package/es/components/pisellFloorMapLayout/components/FigmaTableCard.d.ts

@@ -1,43 +0,0 @@
-/**
- * Figma 样式餐桌/圆桌卡片：上下小条 + 白底卡片 + 状态色边框
- * 供 Floor Map Story 与 Sales Grid 平面图复用
- */
-import React from 'react';
-import type { FloorMapMergedItem, FloorMapDataSources } from '../types';
-export declare type FigmaTableStatus = 'available' | 'reserved' | 'waiting' | 'dining' | 'billed' | 'availableSoon';
-/** 方桌/圆桌卡片展示用数据结构（与 Figma 设计一致，支持桌号/状态/人数/区域等） */
-export interface FigmaTableCardItem {
-    id: string;
-    /**
-     * 无绑定或无可展示数据行时与蘸料摆台占位一致：浅灰底 + 虚线框 + 提示文案
-     * @see getRenderItemByKindCondimentStation（RecordBoard Story）
-     */
-    isNoDataPlaceholder?: boolean;
-    placeholderBorderColor?: string;
-    placeholderHint?: string;
-    /** 占位主标题：优先图元名称，否则「餐桌」/「圆桌」 */
-    placeholderTitle?: string;
-    /** 桌号/名称，空闲态居中显示 */
-    displayName?: string;
-    status?: FigmaTableStatus;
-    customerName?: string;
-    reserveTime?: string;
-    /** 当前用餐人数（与 Figma 设计一致） */
-    guests?: number;
-    /** 可坐人数（与表格列「可坐人数」绑定） */
-    capacity?: number;
-    dishes?: string;
-    duration?: string;
-    /** 区域（与表格列「区域」绑定，如大厅/包厢A） */
-    area?: string;
-}
-/** 从 merged item + dataSources 得到卡片数据 */
-export declare function getFigmaTableCardFromMerged(item: FloorMapMergedItem, dataSources: FloorMapDataSources): FigmaTableCardItem;
-/** 渲染 Figma 样式的方桌卡片（上下小条 + 白底卡片 + 状态边框） */
-export declare function renderFigmaStyleTableCard(cardItem: FigmaTableCardItem): React.JSX.Element;
-/** 渲染 Figma 样式的圆桌卡片（圆形轮廓，展示桌号/状态/人数/区域） */
-export declare function renderFigmaStyleRoundTableCard(cardItem: FigmaTableCardItem): React.JSX.Element;
-/** 返回用于 renderItemByKind.table 的渲染函数（方桌） */
-export declare function getRenderItemByKindTable(dataSources: FloorMapDataSources): (item: unknown) => React.JSX.Element;
-/** 返回用于 renderItemByKind.roundTable 的渲染函数（圆桌） */
-export declare function getRenderItemByKindRoundTable(dataSources: FloorMapDataSources): (item: unknown) => React.JSX.Element;