@pisell/materials 1.0.1078 → 1.0.1079

package/es/components/pisellFloorMapLayout/utils/layoutMeasurements.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 平面图/布局内容区尺寸计算：格子与像素单位、gap 解析、包围盒
+ */
+import type { FloorMapItemBase, FloorMapItemUnit } from '../types';
+/** 默认每格像素 */
+export declare const DEFAULT_CELL_SIZE = 64;
+/** 默认 item 间距（像素） */
+export declare const DEFAULT_ITEM_GAP = 8;
+/**
+ * 将 mapLayer.gap 解析为像素数
+ */
+export declare function gapToPx(gap: number | string | undefined): number;
+/**
+ * 根据 items 计算内容区像素宽高
+ * - cell：按格子数 + cellSize + itemGap 计算
+ * - pixel：按 item 的 x/y/width/height 像素取边界（仅右/下边界，用于非 floor map 或兼容）
+ */
+export declare function getContentSize<T extends FloorMapItemBase>(items: T[], cellSize: number, itemGap: number, itemUnit: FloorMapItemUnit): {
+    contentWidth: number;
+    contentHeight: number;
+};
+/**
+ * pixel 模式下取 items 包围盒（含左/上），用于画布四周扩 padding 时的尺寸与偏移
+ */
+export declare function getPixelBoundingBox<T extends FloorMapItemBase>(items: T[], cellSize: number): {
+    minLeft: number;
+    minTop: number;
+    maxRight: number;
+    maxBottom: number;
+} | null;

package/es/components/pisellFloorMapLayout/utils/mergeCanvasesForTabs.d.ts

@@ -0,0 +1,7 @@
+import type { FloorMapCanvas, FloorMapViewConfig } from '../types';
+/**
+ * 为画布 Tab 合并展示用字段：
+ * - `tabBadge` 若在配置中已给出则原样使用（含 0）；
+ * - 否则用当前 `sceneElements` 中属于该画布的数量，且仅在大于 0 时展示角标。
+ */
+export declare function mergeCanvasesForTabs(config: FloorMapViewConfig): FloorMapCanvas[];

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/pisellHierarchicalSummaryList/PisellHierarchicalSummaryList.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import type { PisellHierarchicalSummaryListProps } from './types';
+import './PisellHierarchicalSummaryList.less';
+/** 根节点类名，供上层用同一 DOM 包裹列表与其它区块时使用 */
+export declare const PREFIX_CLS = "pisell-hierarchical-summary-list";
+export declare const PisellHierarchicalSummaryList: React.FC<PisellHierarchicalSummaryListProps>;

package/es/components/pisellHierarchicalSummaryList/PisellHierarchicalSummaryList.stories.d.ts

@@ -0,0 +1,10 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellHierarchicalSummaryList } from './PisellHierarchicalSummaryList';
+declare const meta: Meta<typeof PisellHierarchicalSummaryList>;
+export default meta;
+declare type Story = StoryObj<typeof PisellHierarchicalSummaryList>;
+export declare const Default: Story;
+export declare const Accordion: Story;
+export declare const MaxExpandLevel: Story;
+export declare const AggregateSum: Story;
+export declare const FullFeatured: Story;

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

@@ -0,0 +1 @@
+export { Row } from './Row';

package/es/components/pisellHierarchicalSummaryList/hooks/index.d.ts

@@ -0,0 +1,2 @@
+export { useExpandedKeys } from './useExpandedKeys';
+export type { ExpandedKeysController, UseExpandedKeysOptions, } from './useExpandedKeys';

package/es/components/pisellHierarchicalSummaryList/hooks/useExpandedKeys.d.ts

@@ -0,0 +1,15 @@
+import type { PisellHierarchicalSummaryListKey } from '../types';
+export interface UseExpandedKeysOptions {
+    expandedKeys?: PisellHierarchicalSummaryListKey[];
+    defaultExpandedKeys?: PisellHierarchicalSummaryListKey[];
+    onExpandedKeysChange?: (keys: PisellHierarchicalSummaryListKey[]) => void;
+}
+export interface ExpandedKeysController {
+    expandedKeys: PisellHierarchicalSummaryListKey[];
+    expandedKeySet: ReadonlySet<PisellHierarchicalSummaryListKey>;
+    setExpandedKeys: (next: PisellHierarchicalSummaryListKey[]) => void;
+}
+/**
+ * 展开态管理（兼容受控/非受控）。
+ */
+export declare function useExpandedKeys(options: UseExpandedKeysOptions): ExpandedKeysController;

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

@@ -0,0 +1,5 @@
+/**
+ * PisellHierarchicalSummaryList 组件导出
+ */
+export { PisellHierarchicalSummaryList, PREFIX_CLS as HIERARCHICAL_SUMMARY_LIST_PREFIX_CLS, } from './PisellHierarchicalSummaryList';
+export type * from './types';

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

@@ -0,0 +1,248 @@
+import type React from 'react';
+import type { CSSProperties } from 'react';
+export declare type PisellHierarchicalSummaryListKey = React.Key;
+export interface PisellHierarchicalSummaryListItem {
+    /**
+     * 行标题。最小字段（必填）
+     */
+    label: React.ReactNode;
+    /**
+     * 行数值。允许 ReactNode（string/number/组合展示）。
+     * 若不传且开启聚合，可能由 children 聚合得到。
+     */
+    value?: React.ReactNode;
+    /**
+     * 子级数据（无限层级递归）
+     */
+    children?: PisellHierarchicalSummaryListItem[];
+    /**
+     * 可选：稳定 key（推荐传入以保证展开态稳定）。
+     * 不传时组件会基于层级路径生成 key。
+     */
+    key?: PisellHierarchicalSummaryListKey;
+    /**
+     * 可选：是否隐藏该项
+     */
+    hidden?: boolean;
+    /**
+     * 可选：排序权重，值越小越靠前
+     */
+    order?: number;
+    /**
+     * 可选：条目数提示（如 "N items" / "N 条"），允许 ReactNode
+     */
+    itemsCount?: React.ReactNode;
+    /**
+     * 可选：信息提示 tooltip 内容（hover 触达）
+     */
+    infoTooltip?: React.ReactNode;
+    /**
+     * 可选：右侧 value 后附加轻量操作（tag/pill/button 等）
+     */
+    extra?: React.ReactNode;
+    /**
+     * 可选：覆盖当前行样式
+     */
+    rowStyle?: CSSProperties;
+    /**
+     * 可选：覆盖当前行类名
+     */
+    rowClassName?: string;
+    /**
+     * 可选：自定义展开内容。若设置，行可展开且展开后渲染此内容（不再渲染 children 列表）。
+     * 用于在列表中嵌入 Collapse 等自定义区块。
+     */
+    expandedContent?: React.ReactNode;
+}
+export interface PisellHierarchicalSummaryListLevelTextStyle {
+    fontSize?: number | string;
+    fontWeight?: number | string;
+    color?: string;
+    /** 行高，如 24 或 '24px' */
+    lineHeight?: number | string;
+}
+export interface PisellHierarchicalSummaryListIconStyle {
+    /** 图标尺寸（px），用于 fontSize 或宽高一致时的边长） */
+    size?: number;
+    color?: string;
+    /** 图标容器宽（px），不传则用 size */
+    width?: number;
+    /** 图标容器高（px），不传则用 size */
+    height?: number;
+}
+export interface PisellHierarchicalSummaryListDividerStyle {
+    show?: boolean;
+    color?: string;
+    style?: 'solid' | 'dashed' | 'dotted';
+}
+export interface PisellHierarchicalSummaryListLevelConfig {
+    /**
+     * 层级缩进（px）。不传则继承全局 indent 规则。
+     */
+    indent?: number;
+    /**
+     * 是否显示 "·" 分隔符（标题区元信息前的点）
+     */
+    showDotSeparator?: boolean;
+    /**
+     * 层级内分割线
+     */
+    divider?: PisellHierarchicalSummaryListDividerStyle;
+    /**
+     * 行容器样式（背景/边框/padding/圆角/阴影等）
+     */
+    rowStyle?: CSSProperties;
+    /**
+     * 行容器类名
+     */
+    rowClassName?: string;
+    /**
+     * 标题文本样式
+     */
+    labelTextStyle?: PisellHierarchicalSummaryListLevelTextStyle;
+    /**
+     * 数值文本样式
+     */
+    valueTextStyle?: PisellHierarchicalSummaryListLevelTextStyle;
+    /**
+     * info icon 样式（size/color）
+     */
+    infoIconStyle?: PisellHierarchicalSummaryListIconStyle;
+    /**
+     * 展开/收起箭头 icon 样式（size/color）
+     */
+    expandIconStyle?: PisellHierarchicalSummaryListIconStyle;
+    /**
+     * 行内元信息样式（如 "·"、N items、info icon 的文案颜色/字号等）
+     */
+    metaTextStyle?: PisellHierarchicalSummaryListLevelTextStyle;
+}
+export declare type PisellHierarchicalSummaryListAggregateMode = 'none' | 'sum';
+export interface PisellHierarchicalSummaryListAggregateConfig {
+    /**
+     * 聚合模式
+     * - none: 不聚合
+     * - sum: 对子级 number 值求和（或使用 getNumberValue 提取）
+     * @default 'none'
+     */
+    mode?: PisellHierarchicalSummaryListAggregateMode;
+    /**
+     * 从条目提取 number 值，用于 sum 聚合。
+     * 默认：若 item.value 是 number，则使用该值；否则忽略。
+     */
+    getNumberValue?: (item: PisellHierarchicalSummaryListItem) => number | null | undefined;
+    /**
+     * 聚合结果格式化（sum 输出到 value 区）
+     */
+    format?: (sum: number, ctx: {
+        item: PisellHierarchicalSummaryListItem;
+        level: number;
+    }) => React.ReactNode;
+}
+export interface PisellHierarchicalSummaryListRenderContext {
+    level: number;
+    pathKeys: PisellHierarchicalSummaryListKey[];
+    expanded: boolean;
+    hasChildren: boolean;
+    aggregatedValue?: React.ReactNode;
+}
+export interface PisellHierarchicalSummaryListProps {
+    /**
+     * 数据源
+     */
+    items: PisellHierarchicalSummaryListItem[];
+    /**
+     * 展开项 keys（受控）
+     */
+    expandedKeys?: PisellHierarchicalSummaryListKey[];
+    /**
+     * 默认展开项 keys（非受控）
+     */
+    defaultExpandedKeys?: PisellHierarchicalSummaryListKey[];
+    /**
+     * 默认展开层级（非受控初始化）。0 表示只展示 L1（不默认展开子级）。
+     * @default 0
+     */
+    defaultExpandedLevel?: number;
+    /**
+     * 展开项变化回调
+     */
+    onExpandedKeysChange?: (keys: PisellHierarchicalSummaryListKey[]) => void;
+    /**
+     * 手风琴模式：同一层级下仅允许一个子项展开
+     * @default false
+     */
+    accordion?: boolean;
+    /**
+     * 最大渲染层级（从 1 开始）。超过层级仍保留行，但不再渲染 children。
+     */
+    maxRenderLevel?: number;
+    /**
+     * 最大可展开层级（从 1 开始）。超过层级不显示展开箭头。
+     */
+    maxExpandLevel?: number;
+    /**
+     * 全局缩进（px），作用于 L2+；也可通过 levelConfig 覆盖。
+     * @default 16
+     */
+    indent?: number;
+    /**
+     * 行间距（px）
+     * @default 8
+     */
+    rowGap?: number;
+    /**
+     * 容器内边距（px 或 CSS 值），不传则使用 less 默认 20px
+     */
+    padding?: number | string;
+    /**
+     * 行内间距（px），用于 1:1 复刻设计稿
+     * - row: 行内左右两栏间距
+     * - rowLeft: 左侧 label 与 meta（· / N items）间距
+     * - meta: meta 内 dot / items-count / info 间距
+     * - rowRight: 右侧 value 与 extra / 展开图标间距
+     */
+    gaps?: {
+        row?: number;
+        rowLeft?: number;
+        meta?: number;
+        rowRight?: number;
+    };
+    /**
+     * 按层级配置样式与功能开关（key 为 level，从 1 开始）
+     */
+    levelConfig?: Record<number, PisellHierarchicalSummaryListLevelConfig>;
+    /**
+     * 自定义渲染 label
+     */
+    renderLabel?: (item: PisellHierarchicalSummaryListItem, ctx: PisellHierarchicalSummaryListRenderContext) => React.ReactNode;
+    /**
+     * 自定义渲染 value
+     */
+    renderValue?: (item: PisellHierarchicalSummaryListItem, ctx: PisellHierarchicalSummaryListRenderContext) => React.ReactNode;
+    /**
+     * 自定义 key 生成（当 item.key 不存在时使用）
+     */
+    getKey?: (item: PisellHierarchicalSummaryListItem, ctx: {
+        level: number;
+        index: number;
+        parentPathKeys: PisellHierarchicalSummaryListKey[];
+    }) => PisellHierarchicalSummaryListKey;
+    /**
+     * 聚合配置：支持内置或外部传入
+     */
+    aggregate?: PisellHierarchicalSummaryListAggregateConfig;
+    /**
+     * 根节点类名
+     */
+    className?: string;
+    /**
+     * 根节点样式
+     */
+    style?: CSSProperties;
+    /**
+     * 是否渲染根节点 div。为 false 时只渲染内部内容（用于外层用同一 DOM 包裹列表与其它区块）。
+     * @default true
+     */
+    renderRoot?: boolean;
+}

package/es/components/pisellImport/PisellImport.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { PisellImportProps } from './types';
+import './PisellImport.less';
+/**
+ * PisellImport 导入触发器组件
+ *
+ * @description 点击后打开文件选择，支持 accept、multiple、maxSize 校验，选择完成后回调 onImport(files)
+ */
+export declare function PisellImport(props: PisellImportProps): React.JSX.Element;

package/es/components/pisellImport/PisellImport.stories.d.ts

@@ -0,0 +1,49 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellImport } from './PisellImport';
+declare const meta: Meta<typeof PisellImport>;
+export default meta;
+declare type Story = StoryObj<typeof PisellImport>;
+/**
+ * 默认 Button 形态
+ */
+export declare const Basic: Story;
+/**
+ * 仅图标形态
+ */
+export declare const IconOnly: Story;
+/**
+ * 三种尺寸 - Button
+ */
+export declare const SizesButton: Story;
+/**
+ * 三种尺寸 - Icon
+ */
+export declare const SizesIcon: Story;
+/**
+ * 默认样式 vs 主色样式
+ */
+export declare const DefaultVsPrimary: Story;
+/**
+ * 禁用态
+ */
+export declare const Disabled: Story;
+/**
+ * 自定义文案
+ */
+export declare const CustomLabel: Story;
+/**
+ * 自定义图标（antd 图标）
+ */
+export declare const CustomIcon: Story;
+/**
+ * 文件选择：限制类型与大小
+ */
+export declare const FileSelect: Story;
+/**
+ * 多选文件
+ */
+export declare const MultipleFiles: Story;
+/**
+ * 与 Export 并排
+ */
+export declare const WithExport: Story;

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

@@ -0,0 +1,2 @@
+export { PisellImport } from './PisellImport';
+export type { PisellImportProps, VariantType, SizeType, ImportButtonType } from './types';

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

@@ -0,0 +1,85 @@
+import type { CSSProperties, ReactNode } from 'react';
+/**
+ * 展示形态
+ * @description icon：仅图标；button：图标 + 文案
+ */
+export declare type VariantType = 'icon' | 'button';
+/**
+ * 尺寸
+ * @description 小、中、大三种尺寸，对应设计稿 padding 与字体
+ */
+export declare type SizeType = 'small' | 'medium' | 'large';
+/**
+ * 视觉类型
+ * @description default：默认边框/灰字；primary：主色描边或填充
+ */
+export declare type ImportButtonType = 'default' | 'primary';
+/**
+ * PisellImport 组件 Props
+ * @description 导入触发器 UI 组件，仅负责展示与点击回调，不内置导入逻辑
+ */
+export interface PisellImportProps {
+    /**
+     * 展示形态
+     * @default 'button'
+     */
+    variant?: VariantType;
+    /**
+     * 尺寸
+     * @default 'medium'
+     */
+    size?: SizeType;
+    /**
+     * 视觉类型（默认样式 / 主色样式）
+     * @default 'default'
+     */
+    type?: ImportButtonType;
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Button 形态下的文案，不传时使用国际化默认文案
+     */
+    label?: ReactNode;
+    /**
+     * 自定义图标，不传时使用内置上传/导入图标
+     */
+    icon?: ReactNode;
+    /**
+     * 接受的文件类型
+     * @description 与 input[type=file] 的 accept 一致，如 ".xlsx,.csv" 或 "application/vnd.ms-excel"
+     */
+    accept?: string;
+    /**
+     * 是否允许多选
+     * @default false
+     */
+    multiple?: boolean;
+    /**
+     * 单文件最大体积（MB），超出时不会调用 onImport，并调用 onError
+     */
+    maxSize?: number;
+    /**
+     * 选择文件并校验通过后回调
+     * @description 用户选择文件后触发，e 为 input 的 change 事件
+     */
+    onImport?: (files: File[], e: React.ChangeEvent<HTMLInputElement>) => void;
+    /**
+     * 校验失败时回调（如文件过大）
+     */
+    onError?: (error: {
+        type: 'MAX_SIZE';
+        message: string;
+        file: File;
+    }) => void;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+}

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

@@ -0,0 +1,17 @@
+import React from 'react';
+import './index.less';
+export interface PisellList01Props {
+    dataSource?: any[];
+    showSearch: boolean;
+    showCategory: boolean;
+    placeholder?: string;
+    renderItem?: (item: any, index: number) => React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+    onChange?: (anchor: string) => void;
+    onSearch?: (value: any) => void;
+    isShowEmpty?: boolean;
+    description?: any;
+}
+declare const PisellList01: React.FC<PisellList01Props>;
+export default PisellList01;

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

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { LookupTriggerProps, LookupTriggerRef } from '../types';
+export declare const LookupTrigger: React.ForwardRefExoticComponent<LookupTriggerProps & React.RefAttributes<LookupTriggerRef>>;

package/es/components/pisellPhone/PisellPhone.stories.d.ts

@@ -0,0 +1,80 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellPhone } from './PisellPhone';
+/**
+ * PisellPhone 是一个电话号码输入/展示组件。
+ *
+ * ## 功能特性
+ * - 支持三种状态：只读、编辑、禁用
+ * - 国家码选择（预设24个常见国家）
+ * - 自动格式化
+ * - 格式校验
+ * - 移动端拨号
+ * - 号码脱敏
+ */
+declare const meta: Meta<typeof PisellPhone>;
+export default meta;
+declare type Story = StoryObj<typeof PisellPhone>;
+/**
+ * 基础编辑态（中国手机号）
+ */
+export declare const Basic: Story;
+/**
+ * 国家码选择器（显示所有国家）
+ */
+export declare const WithCountrySelector: Story;
+/**
+ * 国家码选择器（过滤显示）
+ */
+export declare const FilteredCountries: Story;
+/**
+ * 国家码选择器（常用国家置顶）
+ */
+export declare const CommonCountriesTop: Story;
+/**
+ * 只读态 - 格式化显示
+ */
+export declare const ReadMode: Story;
+/**
+ * 只读态 - 脱敏显示（中间）
+ */
+export declare const ReadModeMaskedMiddle: Story;
+/**
+ * 只读态 - 脱敏显示（末尾）
+ */
+export declare const ReadModeMaskedLast: Story;
+/**
+ * 只读态 - 可拨号（移动端）
+ */
+export declare const ReadModeDialable: Story;
+/**
+ * 禁用态
+ */
+export declare const Disabled: Story;
+/**
+ * 必填校验
+ */
+export declare const Required: Story;
+/**
+ * 格式校验
+ */
+export declare const FormatValidation: Story;
+/**
+ * 美国号码
+ */
+export declare const USPhone: Story;
+/**
+ * 自动格式化对比
+ */
+export declare const AutoFormatComparison: Story;
+/**
+ * 多国号码展示
+ */
+export declare const MultiCountryDisplay: Story;
+/**
+ * 脱敏模式对比
+ */
+export declare const MaskingComparison: Story;
+/**
+ * 完整功能示例
+ */
+export declare const CompleteExample: Story;

package/es/components/pisellPhone/components/DisabledView.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import type { PisellPhoneProps } from '../types';
+/**
+ * PisellPhone 禁用态视图组件
+ *
+ * 负责渲染禁用态视图，基于原始 mode 渲染对应的视图，并添加禁用样式
+ *
+ * 设计规则：
+ * - 基于编辑态或只读态的视觉
+ * - 透明度 40%
+ * - 禁止所有交互行为（包括拨号）
+ *
+ * @param props 组件 Props
+ */
+declare const DisabledView: React.FC<PisellPhoneProps>;
+export default DisabledView;

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

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { PisellPhoneProps } from '../types';
+/**
+ * PisellPhone 只读态视图组件
+ *
+ * 负责渲染只读态的电话号码展示和拨号功能
+ *
+ * 功能：
+ * - 格式化或脱敏显示
+ * - 显示国旗图标（可选）
+ * - 移动端可点击拨号（tel: 协议）
+ * - 拨号图标（可选）
+ *
+ * @param props 组件 Props
+ */
+declare const ReadOnlyView: React.FC<PisellPhoneProps>;
+export default ReadOnlyView;

package/es/components/pisellPhone/constants/countryCodes.d.ts

@@ -0,0 +1,21 @@
+import type { CountryCode } from '../types';
+/**
+ * 预设的国家码列表（24个常见国家）
+ * flag 使用正常文本（ISO 3166-1 alpha-2 两字母代码，如 CN、US）
+ *
+ * 包含：
+ * - 亚洲：中国、香港、澳门、台湾、日本、韩国、新加坡、马来西亚、泰国、印度
+ * - 欧洲：英国、法国、德国、意大利、西班牙、俄罗斯
+ * - 美洲：美国、加拿大、墨西哥、巴西
+ * - 大洋洲：澳大利亚、新西兰
+ * - 中东：阿联酋、沙特阿拉伯
+ */
+export declare const PRESET_COUNTRY_CODES: CountryCode[];
+/**
+ * 默认国家码
+ */
+export declare const DEFAULT_COUNTRY_CODE = "+86";
+/**
+ * 常用国家码（可作为默认的 commonCountryCodes）
+ */
+export declare const COMMON_COUNTRY_CODES: string[];

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

@@ -0,0 +1,8 @@
+/**
+ * PisellPhone 组件导出
+ */
+import PisellPhone from './PisellPhone';
+export { PisellPhone };
+export type { PisellPhoneProps, CountryCode } from './types';
+export { PRESET_COUNTRY_CODES, DEFAULT_COUNTRY_CODE, COMMON_COUNTRY_CODES } from './constants/countryCodes';
+export type { DisplayState, ValidationResult, TextInputState } from './types';