@pisell/materials 6.11.108 → 6.11.109

package/es/components/pisellRecordBoard/utils/partitionShellFrameChildren.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { RecordBoardFloorMapProps, RecordBoardCalendarProps, RecordBoardResourceWallProps } from '../types';
+/** 与 shellFrame/FloorMap 上定义的 displayName 一致，用于从 ShellFrame children 中识别平面图槽 */
+export declare const RECORD_BOARD_FLOOR_MAP_DISPLAY_NAME = "RecordBoard.FloorMap";
+/** 与 shellFrame/Calendar 上定义的 displayName 一致 */
+export declare const RECORD_BOARD_CALENDAR_DISPLAY_NAME = "RecordBoard.Calendar";
+/** 与 shellFrame/ResourceWall 上定义的 displayName 一致 */
+export declare const RECORD_BOARD_RESOURCE_WALL_DISPLAY_NAME = "RecordBoard.ResourceWall";
+/**
+ * 将 ShellFrame 的 children 拆成：供表格区渲染的子树 + 可选的 FloorMap / Calendar 透传 props。
+ * 支持 Fragment 嵌套；多个同槽时以最后一个为准。
+ */
+export declare function partitionShellFrameChildren(children: React.ReactNode): {
+    gridChildren: React.ReactNode;
+    /** 是否出现 FloorMap 槽位节点（props 可为空，可与根级 floorMap 合并） */
+    hasFloorMapChild: boolean;
+    floorMapPropsFromChild?: RecordBoardFloorMapProps;
+    hasCalendarChild: boolean;
+    calendarPropsFromChild?: RecordBoardCalendarProps;
+    hasResourceWallChild: boolean;
+    resourceWallPropsFromChild?: RecordBoardResourceWallProps;
+    hasGridContent: boolean;
+};

package/es/components/pisellRecordBoard/utils/recordBoardColumns.d.ts

@@ -0,0 +1,52 @@
+import React from 'react';
+import type { RecordBoardColumnType } from '../types';
+import type { FilterValueType } from '../../filter/components/FilterButton/types';
+import type { SortItemProps } from '../../sort/types';
+/** 获取列唯一 key，供列显示隐藏等使用 */
+export declare function getRecordBoardColumnKey(column: RecordBoardColumnType): string;
+/**
+ * 同值列总结栏不展示的内容：null/undefined、空串、纯空白、占位「-」。
+ * 列仍可折叠；仅用于不生成总结栏条目（避免「-」、空白等占位）。
+ */
+export declare function isTrivialUniformSummaryDisplayValue(v: any): boolean;
+/**
+ * 总结区实际渲染的 React 节点是否视为无展示价值（与 {@link isTrivialUniformSummaryDisplayValue} 对齐，含一层子节点）。
+ */
+export declare function isTrivialUniformSummaryReactContent(node: React.ReactNode): boolean;
+export interface UniformColumnSummaryItem {
+    columnKey: string;
+    title: string;
+    type: 'uniform' | 'empty';
+    /** 无 render 时的回退展示 */
+    displayValue?: string;
+    /** 仅用于判断是否相等的值（uniformCompare 的返回值或 dataIndex 取值），不参与 render */
+    value?: any;
+    /** 表格里该列单元格的值（dataIndex 从 record 取值），传给 render 的与表格单元格一致 */
+    cellValue?: any;
+    /** 代表行（如首行），供列 render 使用 */
+    record?: any;
+}
+/**
+ * 根据当前页 data 计算：哪些列「全列同值」或「全空」应隐藏，以及总结区展示项。
+ * 折叠列与总结项可不一一对应：全空、整列「-」/空白等同值仍折叠，但不生成无信息总结项。
+ * 仅当 grid.collapseUniformColumns 为 true 时使用。
+ */
+export declare function computeUniformColumnSummary(data: any[], columns: RecordBoardColumnType[]): {
+    uniformHiddenColumnKeys: string[];
+    summaryItems: UniformColumnSummaryItem[];
+};
+/**
+ * 处理列配置：对带 type 的列注入基于 Pisell 组件的 render，其余列保持不变。
+ * 有 type 时若列上传入了 render 则优先使用（覆盖自动派生）。
+ */
+export declare function processColumnsForGrid<RecordType = any>(columns: RecordBoardColumnType<RecordType>[] | undefined): RecordBoardColumnType<RecordType>[];
+/**
+ * 从 columns 派生排序列表（SortItemProps[]）。
+ * 有 type 的列：根据组件 SortOptions（或默认）生成；无 type 的列：根据 sortable + sort 生成。
+ */
+export declare function deriveSortFromColumns(columns: RecordBoardColumnType[] | undefined): SortItemProps[];
+/**
+ * 从 columns 派生 filter 列表（quickFilter + otherFilter）。
+ * 有 type 的列：根据 type + fieldProps 生成筛选项；无 type 的列：根据 filterable + filter 生成。
+ */
+export declare function deriveFilterFromColumns(columns: RecordBoardColumnType[] | undefined): FilterValueType;

package/es/components/pisellRecordBoard/utils/recordBoardPhoneGrid.d.ts

@@ -0,0 +1,27 @@
+import type { RecordBoardColumnType } from '../types';
+/** Grid 根节点在 `layoutVariant="phone"` 时追加的 class，用于收紧单元格 padding 等 */
+export declare const RECORD_BOARD_PHONE_GRID_CLASS = "pisell-record-board-grid--phone";
+export interface AdaptColumnsForPhoneLayoutOptions {
+    /** 列 key → 最大宽度（px），在比例缩放后再取 min */
+    widthCapsByKey?: Record<string, number>;
+    /** 列 key → 宽度缩放比例（相对原 width）；未配置则用 defaultWidthRatio */
+    widthRatioByKey?: Record<string, number>;
+    /** 默认 numeric width 缩放比例 @default 5/6 */
+    defaultWidthRatio?: number;
+    /** 是否去掉 fixed 列（手机横向滚动场景） @default true */
+    unsetFixed?: boolean;
+}
+/**
+ * 手机 Table：收窄列宽并去掉 fixed，供 RecordBoard Grid 在 layoutVariant=phone 时统一调用。
+ * 业务可通过 grid.phoneColumnWidthCaps / phoneColumnWidthRatioByKey 覆盖特定列。
+ */
+export declare function adaptColumnsForPhoneLayout(columns: RecordBoardColumnType[], options?: AdaptColumnsForPhoneLayoutOptions): RecordBoardColumnType[];
+export declare function mergeRecordBoardPhoneGridClassName(className?: string): string | undefined;
+/**
+ * 手机 Table：`scroll.x: 'max-content'` 会按内容撑出比「列宽之和」更宽的滚动区域，
+ * 列宽已被 adaptColumnsForPhoneLayout 收窄后仍保留 max-content 时，右侧会出现可滚动的空白。
+ * 与预约 buildReservationMobileTableGridConfig 去掉横向 scroll 的策略一致，改为数值宽度。
+ */
+export declare function resolveRecordBoardPhoneScrollX(scrollX: number | string | undefined, sumColumnWidths: number, options?: {
+    selectionColumnWidth?: number;
+}): number | string | undefined;

package/es/components/pisellReservationSchedule/PisellReservationSchedule.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+import type { PisellReservationScheduleProps } from './types';
+import './PisellReservationSchedule.less';
+/**
+ * 营业日导航条：上一日、中间日期文案、下一日（深色条样式，适配预约顶栏）
+ */
+export declare function PisellReservationSchedule(props: PisellReservationScheduleProps): JSX.Element;
+export declare namespace PisellReservationSchedule {
+    var displayName: string;
+}

package/es/components/pisellReservationScheduleBand/PisellReservationScheduleBand.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+import type { PisellReservationScheduleBandProps } from './types';
+import './PisellReservationScheduleBand.less';
+/**
+ * 预约顶栏组合：营业日切换 + 锚定到选中日的时间导航轴
+ */
+export declare function PisellReservationScheduleBand(props: PisellReservationScheduleBandProps): JSX.Element;
+export declare namespace PisellReservationScheduleBand {
+    var displayName: string;
+}

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

@@ -0,0 +1,3 @@
+export { PisellReservationScheduleBand } from './PisellReservationScheduleBand';
+export { formatScheduleAtLabel } from './utils/formatScheduleAtLabel';
+export type { PisellReservationScheduleBandProps, ReservationScheduleBandValue, TimeNavigatorPassthroughProps, } from './types';

package/es/components/pisellShellFrame/PisellShellFrame.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { PisellShellFrameProps } from './types';
+import './PisellShellFrame.less';
+/**
+ * PisellShellFrame：通用壳层布局组件。
+ * 支持通过 config 控制各区域显隐，不同展示类型（表格/看板/日历/楼层图等）复用同一壳层。
+ *
+ * - 顶部：标题区（标题/副标题/辅助信息）、工具区（Toolbar）、统计区（Statistic List，可选折叠）
+ * - 中间：滚动承载（可选）+ Layout 插槽（children）
+ * - 底部：批量操作条（按选中状态出现）、状态提示区（加载/错误/同步提示等）
+ */
+export declare const PisellShellFrame: React.FC<PisellShellFrameProps>;
+export default PisellShellFrame;

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

@@ -0,0 +1,62 @@
+import type { ReactNode, CSSProperties } from 'react';
+/**
+ * 滚动配置：为 true 时使用默认滚动；为对象时传入样式或 scroll 相关配置。
+ */
+export declare type PisellShellFrameScrollConfig = boolean | {
+    style?: CSSProperties;
+    className?: string;
+};
+/**
+ * PisellShellFrame 配置：控制各区域的展示与行为。
+ * 不同展示类型（表格/看板/日历等）复用同一壳层，通过配置控制显隐。
+ */
+export interface PisellShellFrameConfig {
+    /** 是否展示顶部标题区（标题/副标题/辅助信息） */
+    showTitle?: boolean;
+    /** 是否展示顶部工具区（Toolbar） */
+    showToolbar?: boolean;
+    /** 是否展示顶部统计区（Statistic List） */
+    showStatistic?: boolean;
+    /** 统计区是否支持折叠，仅 showStatistic 为 true 时有效 */
+    statisticCollapsible?: boolean;
+    /** 中间内容区是否使用滚动承载包裹；为 true 时默认 overflow auto */
+    scroll?: PisellShellFrameScrollConfig;
+    /** 是否展示底部批量操作条（按选中状态出现由调用方控制，此处仅控制是否渲染该槽位） */
+    showBatchActionBar?: boolean;
+    /** 是否展示底部状态提示区（加载/错误/同步提示等） */
+    showStatusArea?: boolean;
+}
+/**
+ * PisellShellFrame 组件 Props。
+ * 通过 config 控制各区域显隐，通过 slot props 传入各区域内容。
+ */
+export interface PisellShellFrameProps {
+    /** 类名 */
+    className?: string;
+    /** 内联样式 */
+    style?: CSSProperties;
+    /** 区域显隐与行为配置，未传则默认不展示可选区域 */
+    config?: PisellShellFrameConfig;
+    /** 标题 */
+    title?: ReactNode;
+    /** 副标题 */
+    subtitle?: ReactNode;
+    /** 标题区右侧辅助信息 */
+    titleExtra?: ReactNode;
+    /** 工具栏内容 */
+    toolbar?: ReactNode;
+    /**
+     * 工具栏正下方、统计/正文之上的"附加条"插槽，渲染于 header 内部。
+     * 适用于「统计摘要 / 当前所选筛选标签」等需要紧贴 toolbar 的轻量条目。
+     * 当为空时不占位、不渲染外壳。
+     */
+    belowToolbar?: ReactNode;
+    /** 统计列表内容（如 PisellStatisticList 或自定义） */
+    statisticList?: ReactNode;
+    /** 主内容（表格/看板/日历/楼层图等），当 config.scroll 为 true 时会被滚动容器包裹 */
+    children?: ReactNode;
+    /** 批量操作条，通常按选中状态显隐由调用方控制 */
+    batchActionBar?: ReactNode;
+    /** 状态提示（加载/错误/同步提示等） */
+    statusArea?: ReactNode;
+}

package/es/components/pisellSingleLineText/PisellSingleLineText.d.ts

@@ -0,0 +1,40 @@
+import React from 'react';
+import type { PisellSingleLineTextProps } from './types';
+import './PisellSingleLineText.less';
+/**
+ * PisellSingleLineText 单行文本组件
+ *
+ * 通用的单行文本输入/展示组件，支持只读、编辑、禁用三种状态。
+ * 基于 Ant Design Input 组件开发，提供完整的校验框架。
+ *
+ * @param props 组件 Props
+ *
+ * @example
+ * // 受控模式
+ * const [value, setValue] = useState('');
+ * <PisellSingleLineText
+ *   value={value}
+ *   onChange={(v) => setValue(v)}
+ *   placeholder="请输入"
+ * />
+ *
+ * @example
+ * // 非受控模式
+ * <PisellSingleLineText
+ *   defaultValue="初始值"
+ *   required
+ *   minLength={3}
+ * />
+ *
+ * @example
+ * // 只读态
+ * <PisellSingleLineText
+ *   mode="read"
+ *   value="这是一段很长的文本内容"
+ *   ellipsis
+ *   showTooltip
+ * />
+ */
+export declare const PisellSingleLineText: React.FC<PisellSingleLineTextProps>;
+declare const _default: React.NamedExoticComponent<PisellSingleLineTextProps>;
+export default _default;

package/es/components/pisellSingleSelect/PisellSingleSelect.d.ts

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

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

@@ -0,0 +1,22 @@
+import React from 'react';
+import './index.less';
+export interface PisellStatisticListProps extends React.HTMLAttributes<HTMLDivElement> {
+    isHasBorder?: boolean;
+    backgroundColors?: string[];
+    labelColor?: string;
+    valueColor?: string;
+    data: {
+        label: string;
+        value: string;
+        isLink?: boolean;
+        link?: string;
+        tip?: string;
+        onClick?: () => void;
+        children?: {
+            label: string;
+            value: string;
+        }[];
+    }[];
+}
+declare const PisellStatisticList: (props: PisellStatisticListProps) => JSX.Element;
+export default PisellStatisticList;

package/es/components/pisellTimeNavigator/PisellTimeNavigator.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+import type { PisellTimeNavigatorProps } from './types';
+import './PisellTimeNavigator.less';
+/**
+ * PisellTimeNavigator：可拖动的时间导航轴，时间范围内浏览、选择、控制
+ */
+export declare function PisellTimeNavigator(props: PisellTimeNavigatorProps): JSX.Element;
+export declare namespace PisellTimeNavigator {
+    var displayName: string;
+}

package/es/components/pisellTimeNavigator/PisellTimeNavigator.stories.d.ts

@@ -0,0 +1,79 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellTimeNavigator } from './PisellTimeNavigator';
+/**
+ * PisellTimeNavigator 组件 Storybook
+ * 时间导航轴：时间范围内浏览、选择、控制
+ */
+declare const meta: Meta<typeof PisellTimeNavigator>;
+export default meta;
+declare type Story = StoryObj<typeof PisellTimeNavigator>;
+/**
+ * 默认：横向、轴动、显示 Now
+ */
+export declare const Default: Story;
+/** 默认 - 竖向 */
+export declare const DefaultVertical: Story;
+/**
+ * 受控 + 默认 12:00
+ */
+export declare const Controlled: Story;
+/** 受控 - 竖向 */
+export declare const ControlledVertical: Story;
+/**
+ * 非受控 + 默认 14:30
+ */
+export declare const Uncontrolled: Story;
+/** 非受控 - 竖向 */
+export declare const UncontrolledVertical: Story;
+/**
+ * 竖向
+ */
+export declare const Vertical: Story;
+/**
+ * 指针动模式（cursor-moves）
+ */
+export declare const CursorMoves: Story;
+/** 指针动模式 - 竖向 */
+export declare const CursorMovesVertical: Story;
+/**
+ * 营业时间高亮 10:00–22:00
+ */
+export declare const BusinessHours: Story;
+/** 营业时间高亮 - 竖向 */
+export declare const BusinessHoursVertical: Story;
+/**
+ * 自定义时间范围 08:00–20:00
+ */
+export declare const CustomRange: Story;
+/** 自定义时间范围 - 竖向 */
+export declare const CustomRangeVertical: Story;
+/**
+ * 步长 30 分钟
+ */
+export declare const Step30: Story;
+/** 步长 30 分钟 - 竖向 */
+export declare const Step30Vertical: Story;
+/**
+ * 惯性滚动开启
+ */
+export declare const Inertia: Story;
+/** 惯性滚动 - 竖向 */
+export declare const InertiaVertical: Story;
+/**
+ * 吸附到整点（松手后自动吸附到 0/15/30/45 分刻度）
+ */
+export declare const SnapToStep: Story;
+/** 吸附到整点 - 竖向 */
+export declare const SnapToStepVertical: Story;
+/**
+ * 隐藏 Now 按钮
+ */
+export declare const NoNowButton: Story;
+/** 隐藏 Now 按钮 - 竖向 */
+export declare const NoNowButtonVertical: Story;
+/**
+ * 实时模式（仅演示，实际会跟随系统时间）
+ */
+export declare const Realtime: Story;
+/** 实时模式 - 竖向 */
+export declare const RealtimeVertical: Story;

package/es/components/pisellTimeNavigator/components/NowButton.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { CSSProperties } from 'react';
+export interface NowButtonProps {
+    orientation: 'horizontal' | 'vertical';
+    onClick: () => void;
+    style?: CSSProperties;
+    className?: string;
+    renderCustom?: () => React.ReactNode;
+}
+/**
+ * Now 按钮：固定入口，点击跳回当前时间并进入 Realtime
+ * 横向：右侧，左箭头；竖向：底部，上箭头
+ */
+export declare function NowButton({ orientation, onClick, style, className, renderCustom, }: NowButtonProps): JSX.Element;

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

@@ -0,0 +1,5 @@
+export { PisellTimeNavigator } from './PisellTimeNavigator';
+export { getHorizontalAxisSlotCount, getRangeBounds, buildCalendarHourSlotsFromRange, buildCalendarTimelineSlotStartsFromRange, pickReferenceDateContainingNow, DEFAULT_CALENDAR_SLOT_STEP_MINUTES, } from './utils';
+export type { PisellTimeNavigatorProps, TimeNavigatorValue, TimeRangeOption, CursorMode, TimeNavigatorOrientation, } from './types';
+/** 多语言文案（en / zh-CN / zh-HK / ja / pt），使用前请在应用内通过 locales.init(pisellTimeNavigatorLocales, lang) 合并 */
+export { default as pisellTimeNavigatorLocales } from './locales';

package/es/components/pisellToast/squareToast/index.d.ts

@@ -0,0 +1,15 @@
+import { clear, show, success, info, loading, fail, hide } from './methods';
+import './index.less';
+interface ToastInstance {
+    show: typeof show;
+    clear: typeof clear;
+    success: typeof success;
+    info: typeof info;
+    loading: typeof loading;
+    fail: typeof fail;
+    error: typeof fail;
+    hide: typeof hide;
+}
+declare const Toast: ToastInstance;
+export declare const useToast: () => ToastInstance;
+export default Toast;

package/es/components/pisellToast/squareToast/methods.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { ToastProps } from './toast';
+interface ToastInstance {
+    close: () => void;
+}
+declare const show: (configOrContent: Partial<ToastProps> | React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
+declare const clear: () => void;
+declare const success: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
+declare const info: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
+declare const loading: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
+declare const fail: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
+declare const hide: () => void;
+export { show, clear, success, info, loading, fail, hide };

package/es/components/pisellToast/squareToast/renderImperatively.d.ts

@@ -0,0 +1,28 @@
+import type { ReactElement } from 'react';
+import type { Root } from 'react-dom/client';
+import React from 'react';
+declare type ImperativeProps = {
+    open?: boolean;
+    onCancel?: () => void;
+    afterClose?: () => void;
+};
+declare type TargetElement = ReactElement<ImperativeProps>;
+export declare type ImperativeHandler = {
+    close: () => void;
+    replace: (element: TargetElement) => void;
+    isRendered?: () => boolean;
+};
+export declare type UnmountType = () => Promise<void>;
+export declare type RenderType = (node: React.ReactElement, container: Element | DocumentFragment) => UnmountType;
+declare const MARK = "__pisell_react_root__";
+declare type ContainerType = (Element | DocumentFragment) & {
+    [MARK]?: Root;
+};
+export declare function render(node: React.ReactElement, container: ContainerType): void;
+export declare function unmount(container: ContainerType): Promise<void>;
+/**
+ * @deprecated 设置 React 渲染函数以兼容使用。
+ */
+export declare function unstableSetRender(render?: RenderType): RenderType;
+export declare function renderImperatively(element: TargetElement): ImperativeHandler;
+export {};

package/es/components/pisellToast/squareToast/toast.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+import './index.less';
+export declare type ToastType = 'success' | 'error' | 'warning' | 'info' | 'loading';
+export interface ToastProps {
+    /** Toast 类型 */
+    icon?: ToastType | React.ReactNode;
+    /** 显示的内容，支持文本或 React 节点 */
+    content: React.ReactNode;
+    /** 是否显示 */
+    open?: boolean;
+    /** 自动关闭时间，单位毫秒，0 表示不自动关闭 */
+    duration?: number;
+    /** 关闭 */
+    onCancel?: () => void;
+    /** 关闭后回调 */
+    afterClose?: () => void;
+    /** 自定义样式类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 是否显示遮罩 */
+    mask?: boolean;
+}
+declare const Toast: React.FC<ToastProps>;
+export default Toast;

package/es/components/pisellUrl/PisellUrl.d.ts

@@ -0,0 +1,37 @@
+import React from 'react';
+import type { PisellUrlProps } from './types';
+import './PisellUrl.less';
+/**
+ * PisellUrl URL 链接组件
+ *
+ * URL 链接输入/展示组件，支持只读、编辑、禁用三种状态。
+ * 基于 Ant Design Input 组件开发，提供 URL 格式校验、协议自动补全、
+ * 链接跳转和协议/路径显示控制功能。
+ *
+ * @param props 组件 Props
+ *
+ * @example
+ * // 编辑态（URL 输入）
+ * <PisellUrl
+ *   placeholder="请输入网址"
+ *   required
+ * />
+ *
+ * @example
+ * // 只读态（可跳转）
+ * <PisellUrl
+ *   mode="read"
+ *   value="https://www.example.com"
+ *   enableLinkClick
+ * />
+ *
+ * @example
+ * // 协议自动补全
+ * <PisellUrl
+ *   autoCompleteProtocol
+ *   defaultProtocol="https://"
+ * />
+ */
+export declare const PisellUrl: React.FC<PisellUrlProps>;
+declare const _default: React.NamedExoticComponent<PisellUrlProps>;
+export default _default;