@pisell/materials 6.11.108 → 6.11.109

package/lib/components/pisellRecordBoard/shellFrame/ResourceWall/VenueWallCard.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { RecordBoardResourceWallCardModel } from '../../types';
+import { type VenueWallStatusKey, type VenueWallStatusTone } from './venueWallUtils';
+import './VenueWallCard.less';
+export interface VenueWallCardProps {
+    card: RecordBoardResourceWallCardModel;
+    /** 与 PisellRecordBoardResourceWallView 顶栏同源墙钟毫秒时间戳（唯一定时器驱动） */
+    wallNowMs: number;
+    /** boardingSoon：用于进度条分母（分钟）；与「距结束」快结束窗口对称 */
+    boardingSoonBeforeMin?: number;
+    occupiedCardColor?: string;
+    availableCardColor?: string;
+    heroMaxWidthRatio?: number;
+    /** 合并后的六态配色与文案；不传则用默认 map */
+    statusToneMap?: Record<VenueWallStatusKey, VenueWallStatusTone>;
+    /** 非占用态主/辅文案色在暗色外壳下的对比度 */
+    appearance?: 'light' | 'dark';
+}
+declare function VenueWallCardInner({ card, wallNowMs, boardingSoonBeforeMin, occupiedCardColor, availableCardColor, statusToneMap: statusToneMapProp, appearance, }: VenueWallCardProps): JSX.Element;
+/** 单块场地大屏卡：漂移与文案由 {@link buildVenueWallCardPresentation} 统一计算 */
+export declare const VenueWallCard: React.MemoExoticComponent<typeof VenueWallCardInner>;
+export {};

package/lib/components/pisellRecordBoard/shellFrame/ResourceWall/venueWallCardPresentation.d.ts

@@ -0,0 +1,58 @@
+import type { RecordBoardResourceWallCardModel } from '../../types';
+import { type VenueWallStatusKey, type VenueWallStatusTone } from './venueWallUtils';
+/** 与平面图 empty / reserved / occupied 对齐的三种大屏展示态 */
+export declare type VenueWallFloorLikeStatus = 'empty' | 'reserved' | 'occupied';
+/**
+ * 标题胶囊 5 态：在 floorLike 三大类基础上，把 `late` 与 `expired` 拆出独立色与文案，
+ * 与当前区一档强调色（红）对齐。
+ */
+export declare type VenueWallHeaderStatusKey = 'empty' | 'reserved' | 'late' | 'occupied' | 'expired';
+/** 由 {@link buildVenueWallCardPresentation} 产出，供 VenueWallCard 渲染层使用 */
+export declare type VenueWallCardPresentation = {
+    statusKey: VenueWallStatusKey;
+    floorLikeStatus: VenueWallFloorLikeStatus;
+    /** 标题栏右侧 5 态键，决定胶囊样式（描边/底色变体） */
+    headerStatusKey: VenueWallHeaderStatusKey;
+    /** 标题栏右侧：空闲 / 预约中 / 迟到 / 占用中 / 超时 */
+    headerStatusLabel: string;
+    /** 标题胶囊主色（迟到/超时为红，与一档强调色对齐） */
+    headerStatusColor: string;
+    /** 紫色渐变占用卡 vs 浅色强调卡 */
+    cardVariant: 'occupied' | 'accent';
+    mainColor: string;
+    subColor: string;
+    surfaceAccentColor: string;
+    /** 当前区一档：剩余时间 / 距开始 / 结束提示等（非布局「块」） */
+    primaryEmphasisLine: string;
+    primaryEmphasisColor: string;
+    /** 二档：预约时段文案 */
+    timeRangeLine: string;
+    /** 二档：联系人（「Available to Book」等占位已剥离） */
+    contactLine: string;
+    showProgress: boolean;
+    progress: number;
+    progressColor: string;
+    showEndingSoonMarquee: boolean;
+    marqueeText: string;
+    marqueeColor: string;
+    /** 跑马灯胶囊底：与 {@link primaryEmphasisColor} 同一强调色（半透明叠底） */
+    marqueeShellBackground: string;
+};
+/**
+ * 纯函数：三态大屏文案 + 进度 + 条件跑马灯。
+ * 右上角标题栏仅保留 empty/reserved/occupied；迟到/超时只出现在当前区一档主提示。
+ */
+export declare function buildVenueWallCardPresentation(args: {
+    card: RecordBoardResourceWallCardModel;
+    toneMap: Record<VenueWallStatusKey, VenueWallStatusTone>;
+    wallNowMs: number;
+    liveRemainingMin: number;
+    liveRemainingPreciseMin: number;
+    liveStartsInMin: number;
+    liveLateMin: number;
+    boardingSoonBeforeMin: number;
+    idleMain: string;
+    idleSub: string;
+    occupiedCardColor: string;
+    availableCardColor: string;
+}): VenueWallCardPresentation;

package/lib/components/pisellRecordBoard/shellFrame/ResourceWall/venueWallUtils.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 资源墙（Venue Wall）共用工具：六态键、默认色板、倒计时文案、卡片状态推导、配色合并与 diff。
+ */
+import type { RecordBoardResourceWallCardModel } from '../../types';
+export declare type VenueWallStatusKey = 'inUse' | 'endingSoon' | 'expired' | 'available' | 'boardingSoon' | 'late';
+/** 单态展示配置（与 {@link VENUE_WALL_STATUS_COLOR_MAP} 值同形） */
+export declare type VenueWallStatusTone = {
+    key: VenueWallStatusKey;
+    label: string;
+    note: string;
+    color: string;
+    noteBg: string;
+};
+/** 仅覆盖部分字段；用于 Control Panel / localStorage */
+export declare type VenueWallStatusToneOverrides = Partial<Record<VenueWallStatusKey, Partial<VenueWallStatusTone>>>;
+/** 单外观（浅 / 深）下的占用/空闲色与六态覆盖；持久化时 light、dark 各存一份 */
+export declare type VenueWallAppearanceSlot = {
+    occupiedCardColor?: string;
+    availableCardColor?: string;
+    statusToneOverrides?: VenueWallStatusToneOverrides;
+};
+export declare type VenueWallAppearanceTheme = {
+    light?: VenueWallAppearanceSlot;
+    dark?: VenueWallAppearanceSlot;
+};
+export declare const VENUE_WALL_STATUS_KEYS: VenueWallStatusKey[];
+/**
+ * 六态默认色与占位英文；`getVenueWallStatusToneMap` 会将 label/note 换为 i18n，此处仅作 merge 基底。
+ */
+export declare const VENUE_WALL_STATUS_COLOR_MAP: Record<VenueWallStatusKey, VenueWallStatusTone>;
+/** 将 `#RGB` / `#RRGGBB` 转为 `rgba(...)`，供渐变与半透明底 */
+export declare function alphaColor(hex: string, alpha: number): string;
+/** 将数值限制在 [min, max]（布局行列、主文案比例等） */
+export declare const clamp: (value: number, min: number, max: number) => number;
+/** 由卡片字段推导状态键（与演示页 test.tsx 规则一致） */
+export declare function deriveVenueWallStatus(card: RecordBoardResourceWallCardModel): VenueWallStatusKey;
+/**
+ * ToolBar Sort 写入的 `searchParams.sort`（如 `status:asc:string`）拆出字段名与升降序。
+ */
+export declare function parseRecordBoardToolbarSortParam(sort: unknown): {
+    field: string;
+    dir: 'asc' | 'desc';
+} | null;
+/** 当 Sort 字段名匹配这些 key（忽略大小写）时，资源墙按占用态重排卡片 */
+export declare const DEFAULT_RESOURCE_WALL_STATUS_SORT_FIELD_KEYS: string[];
+export declare function matchesResourceWallStatusSortField(sortField: string, keys: readonly string[]): boolean;
+/**
+ * 用于资源墙排序：占用/将结/已结束为 1，其余为 0（与 {@link deriveVenueWallStatus} 一致）。
+ * asc → 空闲侧在前；desc → 占用侧在前。
+ */
+export declare function venueWallOccupiedSortRank(card: RecordBoardResourceWallCardModel): 0 | 1;
+export declare function formatDurationHM(minAbs: number): string;
+/**
+ * 将「剩余/超支分钟数」格式化为跑码条/主副标题用短文案（走 i18n 模板，负值表示 overtime）。
+ */
+export declare function formatVenueWallCountdown(min: number): string;
+/**
+ * 合并默认六态配色与业务覆盖，供 {@link VenueWallCard} 与 Control Panel 表单初值共用。
+ */
+export declare function getVenueWallStatusToneMap(overrides?: VenueWallStatusToneOverrides | null): Record<VenueWallStatusKey, VenueWallStatusTone>;
+/**
+ * 将编辑后的完整六态表压成「相对默认」的 overrides，便于持久化与 props 传递。
+ */
+export declare function diffVenueWallStatusToneOverrides(draft: Record<VenueWallStatusKey, VenueWallStatusTone>): VenueWallStatusToneOverrides;

package/lib/components/pisellRecordBoard/shellFrame/ShellBodyMetaContext.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+import type { RecordBoardFloorMapProps, RecordBoardCalendarProps, RecordBoardResourceWallProps } from '../types';
+/**
+ * ShellFrame 解析子节点后的元信息，供 ToolBar 等判断是否需要「表格 / 平面图 / 日历」Segmented。
+ * 未处于 ShellFrame.Provider 内时为 undefined（如单独挂载 ToolBar）。
+ */
+export interface RecordBoardShellBodyMeta {
+    /** 子组件 FloorMap props 与根级 floorMap 合并后的结果（子优先） */
+    effectiveFloorMapProps?: RecordBoardFloorMapProps;
+    /** 子组件 Calendar props 与根级 calendar 合并后的结果（子优先） */
+    effectiveCalendarProps?: RecordBoardCalendarProps;
+    /** ShellFrame 内是否存在 GridLayout / CardLayout 等非 FloorMap 子节点 */
+    hasGridContent: boolean;
+    /** 合并后是否存在可渲染的平面图配置 */
+    hasFloorMapSlot: boolean;
+    /** 合并后是否存在可渲染的日历配置 */
+    hasCalendarSlot: boolean;
+    /** 子组件 ResourceWall props 与根级 resourceWall 合并后的结果（子优先） */
+    effectiveResourceWallProps?: RecordBoardResourceWallProps;
+    /** 合并后是否存在大屏资源墙槽（根级或子节点声明即 true） */
+    hasResourceWallSlot: boolean;
+}
+export declare const RecordBoardShellBodyMetaContext: React.Context<RecordBoardShellBodyMeta | undefined>;
+export declare function useRecordBoardShellBodyMeta(): RecordBoardShellBodyMeta | undefined;

package/lib/components/pisellRecordBoard/shellFrame/ToolBar/index.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { RecordBoardToolBarProps as ToolBarPropsType } from '../../types';
+import './ToolBarFilter.less';
+import './recordBoardToolbar.less';
+/**
+ * RecordBoard 下的工具栏：使用 PisellToolBar。
+ * 左侧默认 PisellFind（inline）；右侧默认 PisellFilter。通过 childComponentProps.toolBar.search / toolBar.filter 为对象时透传对应组件 props，为 false 时不渲染。
+ * 可透传 topLeft、topRight、bottomLeft、bottomRight、tabs。
+ */
+declare const RecordBoardToolBar: React.FC<RecordBoardToolBarProps>;
+export declare type RecordBoardToolBarProps = ToolBarPropsType;
+export default RecordBoardToolBar;

package/lib/components/pisellRecordBoard/shellFrame/ToolBar/recordBoardToolBarI18n.d.ts

@@ -0,0 +1,13 @@
+import type { SortItemProps } from '../../../sort/types';
+import type { FilterValueType } from '../../../filter/components/FilterButton/types';
+/** 与 Quick Filter 同源：优先 utils，若 utils 返回 key（未命中）则用 materials 再回退 */
+export declare function getSortButtonText(): string;
+/** 资源墙无状态列派生项时注入：下拉仅「状态 → 空闲优先 / 占用优先」，仍渲染排序按钮 */
+export declare function buildResourceWallStatusSortFallbackItem(sortConfig: unknown): SortItemProps;
+export declare function getFilterButtonText(): string;
+export declare function getViewGridLabel(): string;
+export declare function getViewFloorMapLabel(): string;
+export declare function getViewCalendarLabel(): string;
+export declare function getViewResourceWallLabel(): string;
+/** 筛选无值时使用的默认筛选项；业务可通过 childComponentProps.toolBar.filter.defaultFilterValue 覆盖 */
+export declare function getDefaultFilterValue(): FilterValueType;

package/lib/components/pisellRecordBoard/shellFrame/ToolBarQuickFilter/index.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import type { FilterItemProps } from '../../../filter/types';
+export interface ToolBarQuickFilterProps {
+    /** 快速筛选项列表（与 Filter 的 quickFilter 同结构），不传则从 columns 派生时由父级传入 */
+    filterList?: FilterItemProps[];
+    /** 表单字段前缀，与 PisellFilter 保持一致，默认 '' */
+    formFiltersPrefix?: string;
+    /** 表单项尺寸 */
+    size?: 'small' | 'middle' | 'large';
+    /** 与 ToolBar 上 PisellFilter 一致：窄屏 / 手机筛选布局 */
+    phoneLayout?: boolean;
+}
+/**
+ * RecordBoard 工具栏左侧内联快速筛选：将 quickFilter 直接展示在 ToolBar 左侧，不放入 Filter 弹层。
+ * 与 searchParams.filter 联动，变更写入 searchParams.filter.values 并触发 onSearch。
+ * 启用时建议 ToolBar 对 PisellFilter 传 hiddenQuickFilter: true，仅保留高级筛选在弹层内。
+ */
+declare const ToolBarQuickFilter: React.FC<ToolBarQuickFilterProps>;
+export default ToolBarQuickFilter;

package/lib/components/pisellRecordBoard/shellFrame/index.d.ts

@@ -0,0 +1,30 @@
+import React from 'react';
+import RecordBoardToolBar from './ToolBar';
+import RecordBoardBatchActionBar from './BatchActionBar';
+import RecordBoardPagination from './Pagination';
+import RecordBoardSearch from './Search';
+import './shellFrameFloorMap.less';
+import ToolBarReset from './ToolBarReset';
+import ToolBarQuickFilter from './ToolBarQuickFilter';
+import RecordBoardFloorMap from './FloorMap';
+import RecordBoardCalendar from './Calendar/RecordBoardCalendar';
+import RecordBoardResourceWall from './ResourceWall/RecordBoardResourceWall';
+/**
+ * Shell Frame：基于 PisellShellFrame 的 RecordBoard 壳层。
+ * 解析子节点：**GridLayout / CardLayout 等** 与可选 **FloorMap / Calendar / ResourceWall** 槽；
+ * 子视图组合与 Segmented 切换由子节点与根级 props 决定；根级 `floorMap` / `calendar` / `resourceWall` 与子槽合并时**子组件优先**。
+ */
+declare const RecordBoardShellFrame: React.FC<{
+    children?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+    /**
+     * 工具栏与表格主体之间的「附加条」插槽，透传给底层 PisellShellFrame.belowToolbar。
+     * 用于在不改 ToolBar 内部结构的前提下，紧贴 toolbar 下方插入轻量条目
+     * （例如 HUD 抽屉里的「当日总览」摘要栏）。
+     */
+    belowToolbar?: React.ReactNode;
+}>;
+export default RecordBoardShellFrame;
+export { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, ToolBarReset, ToolBarQuickFilter, RecordBoardFloorMap, RecordBoardCalendar, RecordBoardResourceWall, };
+export { useRecordBoardShellBodyMeta } from './ShellBodyMetaContext';