@pisell/materials 6.11.107 → 6.11.108

package/lib/components/pisellFloorMapLayout/utils/floorMapResourcePickerTypes.d.ts

@@ -1,109 +0,0 @@
-/**
- * 平面图资源选择槽位的通用类型与工具。
- * 默认由 `@pisell/materials` 的 `PisellResourcePickerModal` 承担；
- * 业务可通过 `renderFilterBar` 注入 Tabbar 等筛选区，或通过 `renderResourcePickerModal` 整页覆盖。
- */
-import type { ReactNode } from 'react';
-/** 选择模式 */
-export declare type PisellCardPickerMode = 'single' | 'multiple';
-/** 可选条目：至少包含稳定主键 id */
-export interface PisellCardPickerItem {
-    id: string;
-    [key: string]: unknown;
-}
-/** 分类路径，最多 3 级（不足时后续为 null；未选层级表示「全部」） */
-export declare type PisellCardPickerCategoryPath = [
-    string | null | undefined,
-    string | null | undefined,
-    string | null | undefined
-];
-/** 单级分类配置（最多 3 级） */
-export interface PisellCardPickerCategoryLevelConfig {
-    /** 嵌套模式下该级行左侧标签（如「省」「市」「区/镇」） */
-    label?: string;
-    /**
-     * parallel 模式：从 item[field] 读取该维度的 key。
-     * nested 模式：请用 getCategoryPath / nestedPathField 从单字段拆路径。
-     */
-    field?: string;
-}
-/**
- * nested：同一维度嵌套分级（广东 → 中山 → 三乡），子级依赖父级已选。
- * parallel：三个独立维度（每级互不影响）。
- */
-export declare type PisellCardPickerCategoryMode = 'nested' | 'parallel';
-/** 分类筛选配置（最多 3 级；数据只有 1 级时 UI 只展示有值的那一行） */
-export interface PisellCardPickerCategoryConfig {
-    /** 默认 nested */
-    mode?: PisellCardPickerCategoryMode;
-    /**
-     * 最多 3 级配置位。
-     * nested：单字段拆路径；仅 1 段时只出现第 1 行，多段时再逐级出现。
-     */
-    levels: [
-        PisellCardPickerCategoryLevelConfig?,
-        PisellCardPickerCategoryLevelConfig?,
-        PisellCardPickerCategoryLevelConfig?
-    ];
-    /** 自定义 [L1,L2,L3]；优先于 levels[].field */
-    getCategoryPath?: (item: PisellCardPickerItem) => PisellCardPickerCategoryPath;
-    /**
-     * nested 便捷项：从 item[nestedPathField] 用 `/` `>` 等拆成最多 3 段。
-     * 与 getCategoryPath 同时存在时以 getCategoryPath 为准。
-     */
-    nestedPathField?: string;
-}
-/**
- * 卡片小标签（如人数、状态、面积等）。
- * - text：必填，纯文本内容
- * - icon：可选 ReactNode，前置图标（如 TeamOutlined）
- * 业务自由组合多个；空数组等价于不展示。
- */
-export interface PisellCardPickerCardBadge {
-    text: string;
-    icon?: ReactNode;
-}
-export interface PisellCardPickerCardMeta {
-    title: string;
-    subtitles: string[];
-    /**
-     * 卡片末行的标签数组（如人数 / 状态）。比 subtitle 更紧凑，支持前置 icon。
-     */
-    badges?: PisellCardPickerCardBadge[];
-    /**
-     * 左侧缩略图/预览节点。传入字符串走内置 `<img>`，传入 ReactNode 直接渲染
-     * （如平面图 View All 的 palette preview cell）。
-     */
-    image?: ReactNode | string;
-}
-/**
- * 平面图工具栏「打开资源选择」槽位 props。
- * 与 `PisellProResourcePickerModalProps` 字段对齐；业务注入 modal 时可透传
- * `categoryConfig` / `getSearchText` / `getCardMeta` 等扩展项。
- */
-export interface FloorMapResourcePickerSlotProps {
-    open: boolean;
-    onClose: () => void;
-    onConfirm: (selectedIds: string[]) => void;
-    records: PisellCardPickerItem[];
-    mode?: PisellCardPickerMode;
-    value?: string[];
-    title?: string;
-    disabledIds?: string[];
-    /** 最多三级分类；不传则仅搜索 + 列表 */
-    categoryConfig?: PisellCardPickerCategoryConfig;
-    getSearchText?: (record: PisellCardPickerItem) => string;
-    getCardMeta?: (record: PisellCardPickerItem) => PisellCardPickerCardMeta;
-    renderCard?: (record: PisellCardPickerItem, ctx: {
-        selected: boolean;
-        disabled: boolean;
-    }) => ReactNode;
-    zIndex?: number;
-    width?: number;
-    className?: string;
-}
-/**
- * 把单字段中的层级路径解析为 [L1, L2, L3]。
- * 例：`广东/中山/三乡` → `['广东','中山','三乡']`；不足三级后续为 null。
- */
-export declare function parseNestedPathSegments(raw: unknown, maxDepth?: number): PisellCardPickerCategoryPath;

package/lib/components/pisellFloorMapLayout/utils/floorMapToolbarPalette.d.ts

@@ -1,34 +0,0 @@
-import type { FloorMapElementKindConfig } from '../types';
-import { type FloorMapBuiltinShapeDef } from './floorMapBuiltinShapes';
-/** @deprecated 使用 {@link FLOOR_MAP_TOOLBAR_PALETTE_SIDEBAR_LIMIT} */
-export declare const FLOOR_MAP_TOOLBAR_PALETTE_VISIBLE_LIMIT = 5;
-/** 解析侧栏每类展示上限（至少 1） */
-export declare function resolvePaletteSidebarVisibleLimit(limit?: number): number;
-/** 分类下图元数是否应显示「查看全部」 */
-export declare function shouldShowPaletteViewAll(entryCount: number, limit?: number): boolean;
-/** 侧栏直接展示的 palette 条目（前 N 项） */
-export declare function getPaletteSidebarVisibleEntries<T>(entries: T[], limit?: number): T[];
-/** 批量从弹窗落点时的单项描述（与 {@link FloorMapPlaceMode} scene 子集对齐） */
-export interface FloorMapPaletteBulkPlaceItem {
-    elementKind: string;
-    builtinShapeKey?: string;
-}
-/**
- * 侧栏 / 弹窗共用的 palette 条目：普通 kind 一项；内置图形 kind 按预设展开多项。
- */
-export interface FloorMapToolbarPaletteEntry {
-    key: string;
-    kind: FloorMapElementKindConfig;
-    builtinShapeKey?: string;
-    label: string;
-    shapeDef?: FloorMapBuiltinShapeDef;
-}
-/** 该 palette 条目是否点击即落画布（装饰内置图形单卡、无绑定 kind 等） */
-export declare function isDirectPlacePaletteEntry(entry: FloorMapToolbarPaletteEntry): boolean;
-export declare function buildToolbarPaletteEntries(kinds: FloorMapElementKindConfig[], resolveBuiltinLabel: (shapeDef: FloorMapBuiltinShapeDef) => string): FloorMapToolbarPaletteEntry[];
-/** palette 条目 → 批量落点 payload（每项数量 1） */
-export declare function paletteEntriesToBulkPlaceItems(entries: FloorMapToolbarPaletteEntry[]): FloorMapPaletteBulkPlaceItem[];
-/**
- * 按弹窗内各条目数量展开为落点列表（数量为 n 则重复 n 次，落点时阶梯偏移）。
- */
-export declare function expandPaletteEntriesByQuantity(entries: FloorMapToolbarPaletteEntry[], quantities: Readonly<Record<string, number>>): FloorMapPaletteBulkPlaceItem[];

package/lib/components/pisellFloorMapLayout/utils/floorMapViewConfigDiff.d.ts

@@ -1,8 +0,0 @@
-import type { FloorMapViewConfig } from '../types';
-/**
- * 与 {@link useFloorMapEditState} 中 `useEffect` 逻辑一致：补全 `canvasUi`、空 `elementKinds` 时的默认调色板、`sceneElements`。
- * 用于从上游 prop 得到「可与当前 draft 公平比较」的基准配置。
- */
-export declare function normalizeFloorMapViewConfigFromProp(floorMapConfigProp: FloorMapViewConfig): FloorMapViewConfig;
-/** 判断当前编辑草稿是否与基准配置一致（数组顺序无关） */
-export declare function floorMapViewConfigsEqual(a: FloorMapViewConfig, b: FloorMapViewConfig): boolean;

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

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

package/lib/components/pisellLongText/PisellLongText.d.ts

@@ -1,39 +0,0 @@
-import React from 'react';
-import type { PisellLongTextProps } from './types';
-import './PisellLongText.less';
-/**
- * PisellLongText 长文本/多行文本组件
- *
- * 多行文本输入/展示组件，支持只读、编辑、禁用三种状态。
- * 基于 Ant Design TextArea 组件开发，提供展开/折叠功能和完整的校验框架。
- *
- * @param props 组件 Props
- *
- * @example
- * // 编辑态
- * <PisellLongText
- *   placeholder="请输入内容"
- *   rows={3}
- *   maxLength={500}
- *   showCount
- * />
- *
- * @example
- * // 只读态（展开折叠）
- * <PisellLongText
- *   mode="read"
- *   value={longText}
- *   maxLines={3}
- *   enableExpand
- * />
- *
- * @example
- * // 自动高度
- * <PisellLongText
- *   autoSize={{ minRows: 3, maxRows: 10 }}
- *   placeholder="自动调整高度"
- * />
- */
-export declare const PisellLongText: React.FC<PisellLongTextProps>;
-declare const _default: React.NamedExoticComponent<PisellLongTextProps>;
-export default _default;

package/lib/components/pisellMultipleSelect/PisellMultipleSelect.d.ts

@@ -1,9 +0,0 @@
-/**
- * PisellMultipleSelect - 多选下拉组件
- * 基于 Ant Design Select 封装，提供符合 Pisell 设计规范的多选功能
- */
-import React from 'react';
-import type { PisellMultipleSelectProps, MultipleSelectRef } from './types';
-import './PisellMultipleSelect.less';
-declare const PisellMultipleSelect: React.ForwardRefExoticComponent<PisellMultipleSelectProps<string | number> & React.RefAttributes<MultipleSelectRef<string | number>>>;
-export default PisellMultipleSelect;

package/lib/components/pisellMultipleSelect/components/EditView.d.ts

@@ -1,8 +0,0 @@
-/**
- * PisellMultipleSelect - EditView (编辑态视图)
- * 正常可编辑状态下的渲染
- */
-import React from 'react';
-import type { EditViewProps } from '../types';
-declare const EditView: React.ForwardRefExoticComponent<EditViewProps<string | number> & React.RefAttributes<any>>;
-export default EditView;

package/lib/components/pisellNavigationMenu/PisellNavigationMenu.d.ts

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

package/lib/components/pisellNumber/PisellNumber.d.ts

@@ -1,42 +0,0 @@
-import React from 'react';
-import type { PisellNumberProps } from './types';
-import './PisellNumber.less';
-/**
- * PisellNumber 数值组件
- *
- * 通用的数值输入/展示组件，支持只读、编辑、禁用三种状态。
- * 基于 Ant Design InputNumber 组件开发，提供完整的校验框架。
- *
- * @param props 组件 Props
- *
- * @example
- * // 受控模式
- * const [value, setValue] = useState(0);
- * <PisellNumber
- *   value={value}
- *   onChange={setValue}
- *   min={0}
- *   max={100}
- * />
- *
- * @example
- * // 非受控模式
- * <PisellNumber
- *   defaultValue={10}
- *   min={0}
- *   max={999}
- *   step={10}
- * />
- *
- * @example
- * // 只读态
- * <PisellNumber
- *   mode="read"
- *   value={1234.567}
- *   precision={2}
- *   useGrouping
- * />
- */
-export declare const PisellNumber: React.FC<PisellNumberProps>;
-declare const MemoizedPisellNumber: React.NamedExoticComponent<PisellNumberProps>;
-export default MemoizedPisellNumber;

package/lib/components/pisellPhone/PisellPhone.d.ts

@@ -1,36 +0,0 @@
-import React from 'react';
-import type { PisellPhoneProps } from './types';
-import './PisellPhone.less';
-/**
- * PisellPhone 电话号码组件
- *
- * 电话号码输入/展示组件，支持只读、编辑、禁用三种状态。
- * 基于 Ant Design Input 和 Select 组件开发，提供国家码选择、自动格式化、格式校验和拨号功能。
- *
- * @param props 组件 Props
- *
- * @example
- * // 编辑态（中国手机号）
- * <PisellPhone
- *   placeholder="请输入手机号"
- *   required
- * />
- *
- * @example
- * // 只读态（可拨号）
- * <PisellPhone
- *   mode="read"
- *   value="13800000000"
- *   countryCode="+86"
- * />
- *
- * @example
- * // 国家码选择
- * <PisellPhone
- *   showCountrySelector
- *   availableCountryCodes={['+86', '+1', '+44']}
- * />
- */
-export declare const PisellPhone: React.FC<PisellPhoneProps>;
-declare const _default: React.NamedExoticComponent<PisellPhoneProps>;
-export default _default;

package/lib/components/pisellPhone/components/EditView.d.ts

@@ -1,19 +0,0 @@
-import React from 'react';
-import type { PisellPhoneProps } from '../types';
-/**
- * PisellPhone 编辑态视图组件
- *
- * 负责渲染编辑态的电话号码输入，包含国家码选择器和号码输入框
- *
- * 功能：
- * - 国家码选择器（下拉，支持搜索）
- * - 电话号码输入（只保留数字）
- * - 自动格式化（根据国家码）
- * - 动态设置最大长度（根据国家码）
- * - 实时或失焦校验
- * - 错误提示展示
- *
- * @param props 组件 Props
- */
-declare const EditView: React.FC<PisellPhoneProps>;
-export default EditView;

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

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

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

@@ -1,209 +0,0 @@
-import type { CSSProperties } from 'react';
-import type { BaseTextInputProps } from '@pisell/utils';
-/**
- * 国家码配置类型
- */
-export interface CountryCode {
-    /**
-     * 国家码
-     * @example '+86', '+1', '+44'
-     */
-    code: string;
-    /**
-     * 国家名称
-     * @example '中国', '美国', '英国'
-     */
-    name: string;
-    /**
-     * 国旗 emoji 或图标
-     * @example '🇨🇳', '🇺🇸', '🇬🇧'
-     */
-    flag: string;
-    /**
-     * 号码格式（可选，用于显示占位符）
-     * @example 'XXX XXXX XXXX', '(XXX) XXX-XXXX'
-     */
-    format?: string;
-    /**
-     * 最大长度
-     * @example 11 (中国), 10 (美国)
-     */
-    maxLength: number;
-    /**
-     * 校验正则
-     * @example /^1[3-9]\d{9}$/ (中国手机号)
-     */
-    pattern: RegExp;
-}
-/**
- * PisellPhone 组件 Props 类型定义
- *
- * 继承 BaseTextInputProps，添加电话号码特有的配置
- */
-export interface PisellPhoneProps extends BaseTextInputProps {
-    /**
-     * 状态模式
-     * @default 'edit'
-     */
-    mode?: 'read' | 'edit';
-    /**
-     * 是否禁用
-     * @default false
-     */
-    disabled?: boolean;
-    /**
-     * 当前选中的国家码
-     * @default '+86'
-     * @example '+86', '+1', '+44'
-     */
-    countryCode?: string;
-    /**
-     * 默认国家码（非受控模式）
-     * @default '+86'
-     */
-    defaultCountryCode?: string;
-    /**
-     * 是否显示国家码选择器
-     * @default true
-     */
-    showCountrySelector?: boolean;
-    /**
-     * 可用的国家码列表（从预设24个中过滤）
-     * @example ['+86', '+1', '+44']
-     */
-    availableCountryCodes?: string[];
-    /**
-     * 常用国家码（置顶显示）
-     * @example ['+86', '+1']
-     */
-    commonCountryCodes?: string[];
-    /**
-     * 完全自定义国家码列表（覆盖预设）
-     */
-    countryCodes?: CountryCode[];
-    /**
-     * 国家码变更回调
-     * @param code 新的国家码
-     */
-    onCountryCodeChange?: (code: string) => void;
-    /**
-     * 是否自动格式化
-     * @default true
-     */
-    autoFormat?: boolean;
-    /**
-     * 格式化规则
-     * @default 'auto'
-     */
-    formatRule?: 'mobile' | 'landline' | 'auto';
-    /**
-     * 格式化分隔符
-     * @default ' '
-     */
-    separator?: string;
-    /**
-     * 是否启用拨号（移动端）
-     * @default true
-     */
-    enableDial?: boolean;
-    /**
-     * 是否显示拨号图标
-     * @default false
-     */
-    showDialIcon?: boolean;
-    /**
-     * 拨号回调
-     * @param phone 完整的电话号码（含国家码）
-     */
-    onDial?: (phone: string) => void;
-    /**
-     * 是否脱敏显示（只读态）
-     * @default false
-     */
-    enableMasking?: boolean;
-    /**
-     * 脱敏模式
-     * - middle: 中间4位脱敏（138****0000）
-     * - last: 后4位脱敏（1380000****）
-     * - custom: 使用自定义函数
-     * @default 'middle'
-     */
-    maskPattern?: 'middle' | 'last' | 'custom';
-    /**
-     * 自定义脱敏函数
-     * @param phone 电话号码
-     * @returns 脱敏后的号码
-     */
-    customMask?: (phone: string) => string;
-    /**
-     * 是否显示国旗图标
-     * @default true
-     */
-    showFlag?: boolean;
-    /**
-     * 字号
-     * @example '14px' 或 14
-     * @default 16
-     */
-    fontSize?: string | number;
-    /**
-     * 字重
-     * @example 'bold' 或 600
-     * @default 500
-     */
-    fontWeight?: string | number;
-    /**
-     * 文本颜色
-     * @example '#000000'
-     * @default '#101828'
-     */
-    color?: string;
-    /**
-     * 占位文本
-     * @default '请输入电话号码'
-     */
-    placeholder?: string;
-    /**
-     * 最大长度（根据国家码自动设置）
-     */
-    maxLength?: number;
-    /**
-     * 是否显示清空按钮
-     * @default false
-     */
-    allowClear?: boolean;
-    /**
-     * 是否自动聚焦
-     * @default false
-     */
-    autoFocus?: boolean;
-    /**
-     * 是否校验格式
-     * @default true
-     */
-    validateFormat?: boolean;
-    /**
-     * 自定义校验函数
-     * @param phone 电话号码（纯数字）
-     * @param countryCode 国家码
-     * @returns true 表示校验通过，string 表示错误信息
-     */
-    customValidator?: (phone: string, countryCode: string) => boolean | string;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-    /**
-     * 自定义样式
-     */
-    style?: CSSProperties;
-    /**
-     * ARIA 标签
-     */
-    'aria-label'?: string;
-    /**
-     * ARIA 描述
-     */
-    'aria-describedby'?: string;
-}
-export type { DisplayState, ValidationResult, TextInputState } from '@pisell/utils';

package/lib/components/pisellPhone/utils/countryCodeHelper.d.ts

@@ -1,35 +0,0 @@
-import type { CountryCode, PisellPhoneProps } from '../types';
-/**
- * 根据国家码获取国旗 emoji
- * @param countryCode 国家码
- * @returns 国旗 emoji
- */
-export declare function getCountryFlag(countryCode: string): string;
-/**
- * 根据国家码获取最大长度
- * @param countryCode 国家码
- * @param countryCodes 国家码列表
- * @returns 最大长度
- */
-export declare function getMaxLength(countryCode: string, countryCodes: CountryCode[]): number;
-/**
- * 根据国家码获取配置
- * @param countryCode 国家码
- * @param countryCodes 国家码列表
- * @returns 国家码配置
- */
-export declare function getCountryConfig(countryCode: string, countryCodes: CountryCode[]): CountryCode | undefined;
-/**
- * 获取最终的国家码列表
- *
- * 优先级：
- * 1. props.countryCodes（完全自定义）
- * 2. props.availableCountryCodes（从预设中过滤）
- * 3. PRESET_COUNTRY_CODES（默认全部24个）
- *
- * 然后根据 props.commonCountryCodes 排序（置顶）
- *
- * @param props 组件 Props
- * @returns 国家码列表
- */
-export declare function getCountryCodes(props: PisellPhoneProps): CountryCode[];

package/lib/components/pisellRating/PisellRating.d.ts

@@ -1,31 +0,0 @@
-import React from 'react';
-import type { PisellRatingProps } from './types';
-import './PisellRating.less';
-/**
- * PisellRating 评分组件
- *
- * 基于 Ant Design Rate 组件开发，提供直观的星级评分交互。
- * 支持只读、编辑、禁用三种状态。
- *
- * @param props 组件 Props
- *
- * @example
- * // 基础使用
- * const [rating, setRating] = useState(0);
- * <PisellRating value={rating} onChange={setRating} />
- *
- * @example
- * // 只读态
- * <PisellRating mode="read" value={4.5} allowHalf />
- *
- * @example
- * // 带评分描述
- * <PisellRating
- *   value={rating}
- *   onChange={setRating}
- *   tooltips={['很差', '差', '一般', '好', '很好']}
- * />
- */
-export declare const PisellRating: React.FC<PisellRatingProps>;
-declare const _default: React.NamedExoticComponent<PisellRatingProps>;
-export default _default;

package/lib/components/pisellRecordBoard/PisellRecordBoard.d.ts

@@ -1,9 +0,0 @@
-import React from 'react';
-import type { RecordBoardProps } from './types';
-/**
- * RecordBoard 容器：提供统一的 data / pagination / search 上下文。
- * 打散 props：列表/分页/搜索/多选、grid/toolBar/…；可选根级 **floorMap**（兼容透传）。
- * 平面图推荐在 ShellFrame 内使用 **PisellRecordBoard.FloorMap** 声明，与根级 `floorMap` 合并（子优先）。
- */
-declare const PisellRecordBoard: React.FC<RecordBoardProps>;
-export default PisellRecordBoard;