@pisell/materials 6.11.49 → 6.11.50

package/lib/components/pisellRecordBoard/shellFrame/Calendar/view/BookingCalendarMonthView.js

@@ -101,123 +101,126 @@ function BookingCalendarMonthView({
           )
         ),
         /* @__PURE__ */ import_react.default.createElement("div", { className: "absolute right-3 top-3 flex gap-1 pt-1" }, day.bookingCount > 0 && /* @__PURE__ */ import_react.default.createElement("span", { className: "h-3 w-3 rounded-full bg-violet-500" }), (day.blockCount > 0 || day.fullyBooked) && /* @__PURE__ */ import_react.default.createElement("span", { className: "h-3 w-3 rounded-full bg-red-500" })),
-        dayItems.length > 0 ? /* @__PURE__ */ import_react.default.createElement("div", { className: "mt-10 flex w-full flex-col items-start gap-1.5" }, dayItems.map((item, i) => {
-          const isLastVisible = i === dayItems.length - 1;
-          const shrinkForMore = showMoreTile && isLastVisible;
-          const layoutClassName = `block rounded-md px-2 py-2 text-xs text-left ${(0, import_BookingCalendarStyle.getGridBookingRowStateClasses)(
-            item
-          )} ${shrinkForMore ? "flex-1 min-w-0" : "w-full"}`;
-          return /* @__PURE__ */ import_react.default.createElement(
-            "div",
-            {
-              key: i,
-              className: "flex w-full items-stretch gap-2"
-            },
-            renderMonthWeekBooking ? /* @__PURE__ */ import_react.default.createElement(
+        dayItems.length > 0 ? (
+          /** 顶对齐：日期区为 top-3(12px) + h-11(44px)=56px，原先 mt-10(40px) 与数字圈底不齐，易多出一条缝 */
+          /* @__PURE__ */ import_react.default.createElement("div", { className: "mt-14 flex w-full flex-col items-start gap-1.5" }, dayItems.map((item, i) => {
+            const isLastVisible = i === dayItems.length - 1;
+            const shrinkForMore = showMoreTile && isLastVisible;
+            const layoutClassName = `block rounded-md px-2 pt-1.5 pb-2 text-xs text-left ${(0, import_BookingCalendarStyle.getGridBookingRowStateClasses)(
+              item
+            )} ${shrinkForMore ? "flex-1 min-w-0" : "w-full"}`;
+            return /* @__PURE__ */ import_react.default.createElement(
               "div",
               {
-                className: shrinkForMore ? "flex-1 min-w-0" : "w-full"
+                key: i,
+                className: "flex w-full items-stretch gap-2"
               },
-              renderMonthWeekBooking({
-                item,
-                dateKey: day.key,
-                view: "month",
-                isLight,
-                layoutClassName,
-                onOpenDetail: openBookingDetail,
-                onDragStart: (it) => setDraggingItem(it),
-                draggable: item.kind !== "block"
-              })
-            ) : /* @__PURE__ */ import_react.default.createElement(
-              "button",
-              {
-                type: "button",
-                draggable: item.kind !== "block",
-                onDragStart: (e) => {
-                  if (item.kind !== "block") {
-                    e.stopPropagation();
-                    setDraggingItem(item);
-                  }
-                },
-                onClick: (e) => {
-                  e.stopPropagation();
-                  openBookingDetail(item);
+              renderMonthWeekBooking ? /* @__PURE__ */ import_react.default.createElement(
+                "div",
+                {
+                  className: shrinkForMore ? "flex-1 min-w-0" : "w-full"
                 },
-                className: layoutClassName
-              },
-              /* @__PURE__ */ import_react.default.createElement("div", { className: "truncate" }, item.name),
-              /* @__PURE__ */ import_react.default.createElement("div", { className: "mt-1 opacity-80" }, (0, import_bookingCalendarDateUtils.formatHourLabel)(item.startHour), " -", " ", (0, import_bookingCalendarDateUtils.formatHourLabel)(item.endHour))
-            ),
-            shrinkForMore && /* @__PURE__ */ import_react.default.createElement(
-              "div",
-              {
-                className: "relative h-[52px] w-[52px] shrink-0",
-                ref: (overflowPopover == null ? void 0 : overflowPopover.courtId) === "month" && (overflowPopover == null ? void 0 : overflowPopover.date) === day.key ? overflowPanelRef : null
-              },
-              /* @__PURE__ */ import_react.default.createElement(
+                renderMonthWeekBooking({
+                  item,
+                  dateKey: day.key,
+                  view: "month",
+                  isLight,
+                  layoutClassName,
+                  onOpenDetail: openBookingDetail,
+                  onDragStart: (it) => setDraggingItem(it),
+                  draggable: item.kind !== "block"
+                })
+              ) : /* @__PURE__ */ import_react.default.createElement(
                 "button",
                 {
-                  onMouseEnter: (e) => {
-                    e.stopPropagation();
-                    setOverflowPopover({
-                      courtId: "month",
-                      date: day.key,
-                      items: moreItems,
-                      pinned: false
-                    });
+                  type: "button",
+                  draggable: item.kind !== "block",
+                  onDragStart: (e) => {
+                    if (item.kind !== "block") {
+                      e.stopPropagation();
+                      setDraggingItem(item);
+                    }
                   },
                   onClick: (e) => {
                     e.stopPropagation();
-                    setOverflowPopover(null);
-                    setOverflowListModal(
-                      (prev) => prev && prev.scope === "month" && prev.date === day.key ? null : {
-                        scope: "month",
-                        date: day.key,
-                        title: (0, import_calendarI18n.tCal)(
-                          "pisell2.recordBoard.calendar.overflow.listTitleBookings",
-                          { date: day.key }
-                        ),
-                        items: allItems.filter(
-                          (x) => x.kind === "booking"
-                        )
-                      }
-                    );
+                    openBookingDetail(item);
                   },
-                  className: "flex h-[52px] w-[52px] items-center justify-center rounded-xl bg-violet-700/90 text-sm font-semibold text-white"
+                  className: layoutClassName
                 },
-                "+",
-                moreCount
+                /* @__PURE__ */ import_react.default.createElement("div", { className: "truncate" }, item.name),
+                /* @__PURE__ */ import_react.default.createElement("div", { className: "mt-1 opacity-80" }, (0, import_bookingCalendarDateUtils.formatHourLabel)(item.startHour), " -", " ", (0, import_bookingCalendarDateUtils.formatHourLabel)(item.endHour))
               ),
-              (overflowPopover == null ? void 0 : overflowPopover.courtId) === "month" && (overflowPopover == null ? void 0 : overflowPopover.date) === day.key && !overflowListModal && /* @__PURE__ */ import_react.default.createElement(
+              shrinkForMore && /* @__PURE__ */ import_react.default.createElement(
                 "div",
                 {
-                  onMouseLeave: () => {
-                    if (!(overflowPopover == null ? void 0 : overflowPopover.pinned))
-                      setOverflowPopover(null);
-                  },
-                  className: `absolute right-0 top-[60px] z-20 flex min-w-[240px] max-h-[360px] flex-col rounded-xl border p-3 shadow-2xl ${isLight ? "theme-panel theme-border" : "border-zinc-700 bg-[#111218]"}`
+                  className: "relative h-[52px] w-[52px] shrink-0",
+                  ref: (overflowPopover == null ? void 0 : overflowPopover.courtId) === "month" && (overflowPopover == null ? void 0 : overflowPopover.date) === day.key ? overflowPanelRef : null
                 },
                 /* @__PURE__ */ import_react.default.createElement(
-                  "div",
+                  "button",
                   {
-                    className: `mb-3 shrink-0 text-xs font-semibold ${isLight ? "theme-text-soft" : "text-zinc-300"}`
+                    onMouseEnter: (e) => {
+                      e.stopPropagation();
+                      setOverflowPopover({
+                        courtId: "month",
+                        date: day.key,
+                        items: moreItems,
+                        pinned: false
+                      });
+                    },
+                    onClick: (e) => {
+                      e.stopPropagation();
+                      setOverflowPopover(null);
+                      setOverflowListModal(
+                        (prev) => prev && prev.scope === "month" && prev.date === day.key ? null : {
+                          scope: "month",
+                          date: day.key,
+                          title: (0, import_calendarI18n.tCal)(
+                            "pisell2.recordBoard.calendar.overflow.listTitleBookings",
+                            { date: day.key }
+                          ),
+                          items: allItems.filter(
+                            (x) => x.kind === "booking"
+                          )
+                        }
+                      );
+                    },
+                    className: "flex h-[52px] w-[52px] items-center justify-center rounded-xl bg-violet-700/90 text-sm font-semibold text-white"
                   },
-                  (0, import_calendarI18n.tCal)(
-                    "pisell2.recordBoard.calendar.overflow.bookingsForDay"
-                  )
+                  "+",
+                  moreCount
                 ),
-                /* @__PURE__ */ import_react.default.createElement("div", { className: "min-h-0 flex-1 overflow-hidden" }, /* @__PURE__ */ import_react.default.createElement(
-                  import_OverflowPopover.MonthGridOverflowVirtualList,
+                (overflowPopover == null ? void 0 : overflowPopover.courtId) === "month" && (overflowPopover == null ? void 0 : overflowPopover.date) === day.key && !overflowListModal && /* @__PURE__ */ import_react.default.createElement(
+                  "div",
                   {
-                    items: overflowPopover.items,
-                    listWidth: 214,
-                    onPickItem: openBookingDetail
-                  }
-                ))
+                    onMouseLeave: () => {
+                      if (!(overflowPopover == null ? void 0 : overflowPopover.pinned))
+                        setOverflowPopover(null);
+                    },
+                    className: `absolute right-0 top-[60px] z-20 flex min-w-[240px] max-h-[360px] flex-col rounded-xl border p-3 shadow-2xl ${isLight ? "theme-panel theme-border" : "border-zinc-700 bg-[#111218]"}`
+                  },
+                  /* @__PURE__ */ import_react.default.createElement(
+                    "div",
+                    {
+                      className: `mb-3 shrink-0 text-xs font-semibold ${isLight ? "theme-text-soft" : "text-zinc-300"}`
+                    },
+                    (0, import_calendarI18n.tCal)(
+                      "pisell2.recordBoard.calendar.overflow.bookingsForDay"
+                    )
+                  ),
+                  /* @__PURE__ */ import_react.default.createElement("div", { className: "min-h-0 flex-1 overflow-hidden" }, /* @__PURE__ */ import_react.default.createElement(
+                    import_OverflowPopover.MonthGridOverflowVirtualList,
+                    {
+                      items: overflowPopover.items,
+                      listWidth: 214,
+                      onPickItem: openBookingDetail
+                    }
+                  ))
+                )
               )
-            )
-          );
-        })) : null
+            );
+          }))
+        ) : null
       );
     }))))
   );

package/lib/components/pisellRecordBoard/shellFrame/Calendar/view/bookingCalendarDayViewContext.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { RecordBoardCalendarProps } from '../../../types';
+/** 供日视图拆分出的子组件读取 `calendarProps` / 明暗，避免每层透传（可选使用） */
+export declare type BookingCalendarDayChromeContextValue = {
+    calendarProps: RecordBoardCalendarProps;
+    isLight: boolean;
+};
+export declare function BookingCalendarDayChromeProvider({ children, value, }: {
+    children: React.ReactNode;
+    value: BookingCalendarDayChromeContextValue;
+}): JSX.Element;
+export declare function useBookingCalendarDayChrome(): BookingCalendarDayChromeContextValue;

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

@@ -0,0 +1,8 @@
+/**
+ * RecordBoard 列显示隐藏设置（仅控制表格列展示，不控制 filter/sort）。
+ * 参考 table Actions ColumnsSetting，仅保留显隐切换，无拖拽排序。
+ */
+import React from 'react';
+import './index.less';
+declare const RecordBoardColumnSetting: React.FC;
+export default RecordBoardColumnSetting;

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

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { RecordBoardFloorMapProps } from '../types';
+/**
+ * RecordBoard 平面图槽位：仅在 PisellRecordBoard.ShellFrame 内使用，本身不渲染 DOM。
+ * 将 PisellFloorMapLayout 所需 props 声明在树结构上；与 GridLayout 并存时出现「表格 / 平面图」切换。
+ *
+ * @example
+ * <PisellRecordBoard.ShellFrame>
+ *   <PisellRecordBoard.GridLayout />
+ *   <PisellRecordBoard.FloorMap floorMapConfig={...} dataSources={...} />
+ * </PisellRecordBoard.ShellFrame>
+ */
+declare const RecordBoardFloorMap: React.FC<RecordBoardFloorMapProps>;
+export default RecordBoardFloorMap;

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

@@ -0,0 +1,14 @@
+import React from 'react';
+import './index.less';
+import type { RecordBoardContextValue } from '../../types';
+export interface RecordBoardPaginationProps extends Partial<Pick<RecordBoardContextValue, 'pagination' | 'total' | 'onPageChange' | 'loading'>> {
+    className?: string;
+    style?: React.CSSProperties;
+    render?: (ctx: RecordBoardContextValue) => React.ReactNode;
+}
+/**
+ * RecordBoard 下的分页：接入 packages/materials 的 Pagination，从 context 取 pagination / total / onPageChange；可透传 childComponentProps.pagination。
+ * 当 context 中 pagination 缺失时使用默认分页，避免在 Storybook 或未完整注入 context 时报错。
+ */
+declare const RecordBoardPagination: React.FC<RecordBoardPaginationProps>;
+export default RecordBoardPagination;

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

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { RecordBoardResourceWallProps } from '../../types';
+import './ResourceWallViewport.less';
+/** 与 {@link RecordBoardResourceWallProps.filterFieldKey} 默认一致 */
+export declare const DEFAULT_RESOURCE_WALL_FILTER_FIELD_KEY = "resource_wall_resource_ids";
+/**
+ * RecordBoard 大屏资源墙主视口：`cards` 提供全量卡数据；可见列表由
+ * `searchParams.filter.values[filterFieldKey]` 中的资源 id 与 `cards` 交集决定。
+ * 若 ToolBar `searchParams.sort` 指向状态列（默认字段名 `status`），则按占用态重排展示顺序。
+ * 支持网格分页轮播、浅深外观、伪全屏与控制台（布局 / 配色 / 选中资源）。
+ */
+export declare const PisellRecordBoardResourceWallView: React.FC<RecordBoardResourceWallProps>;

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

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { RecordBoardResourceWallProps } from '../../types';
+/**
+ * RecordBoard 大屏资源墙槽位：仅在 PisellRecordBoard.ShellFrame 内使用，本身不渲染 DOM。
+ * 与 GridLayout / FloorMap / Calendar 并存时出现视图切换。
+ */
+declare const RecordBoardResourceWall: React.FC<RecordBoardResourceWallProps>;
+export default RecordBoardResourceWall;

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

@@ -0,0 +1,50 @@
+import React from 'react';
+import { type VenueWallStatusToneOverrides } from './venueWallUtils';
+export declare type ResourceWallLayoutPreset = {
+    key: string;
+    label: string;
+    cols: number;
+    rows: number;
+};
+export declare type ResourceWallControlPanelApplyPayload = {
+    resourceIds: string[];
+    layoutKey: string;
+    customCols: number;
+    customRows: number;
+    pageDurationSec: number;
+    occupiedCardColor: string;
+    availableCardColor: string;
+    boardingSoonBeforeMin: number;
+    statusToneOverrides: VenueWallStatusToneOverrides;
+    /** 与 test.tsx「主文案基准宽度占比」对接，写入 {@link VenueWallCard} */
+    heroMaxWidthRatio: number;
+};
+export interface ResourceWallControlPanelProps {
+    open: boolean;
+    onClose: () => void;
+    isDark: boolean;
+    layoutPresets: readonly ResourceWallLayoutPreset[];
+    layoutKey: string;
+    customCols: number;
+    customRows: number;
+    pageDurationSec: number;
+    occupiedCardColor: string;
+    availableCardColor: string;
+    boardingSoonBeforeMin: number;
+    statusToneOverrides: VenueWallStatusToneOverrides | undefined;
+    selectedResourceIds: string[];
+    onApply: (payload: ResourceWallControlPanelApplyPayload) => void;
+    /** 与 test.tsx「当前分页 / 倒计时」展示一致（1-based current） */
+    carouselPager: {
+        currentPage: number;
+        totalPages: number;
+    };
+    /** 主文案宽度占比初值，与 {@link VenueWallCardProps.heroMaxWidthRatio} 一致 */
+    heroMaxWidthRatio?: number;
+}
+/**
+ * 资源墙管理台（Portal）：选资源、网格预设/自定义行列、翻页秒数、占用/空闲色、六态说明与色值；
+ * `onApply` 回传负载中含 `diffVenueWallStatusToneOverrides` 压缩结果。
+ * 源自 test `showAdmin` 对接；关闭（Close / Escape / 遮罩）时提交草稿并关闭。
+ */
+export declare const ResourceWallControlPanel: React.FC<ResourceWallControlPanelProps>;

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

@@ -0,0 +1,17 @@
+import React from 'react';
+import { type VenueWallStatusKey, type VenueWallStatusTone } from './venueWallUtils';
+export interface ResourceWallControlPanelColorTabProps {
+    adminSectionBg: string;
+    adminInputBg: string;
+    headerText: string;
+    mutedText: string;
+    divider: string;
+    draftOcc: string;
+    setDraftOcc: (v: string) => void;
+    draftAvail: string;
+    setDraftAvail: (v: string) => void;
+    draftTones: Record<VenueWallStatusKey, VenueWallStatusTone>;
+    setDraftTones: React.Dispatch<React.SetStateAction<Record<VenueWallStatusKey, VenueWallStatusTone>>>;
+}
+/** 控制台「外观 / 颜色」分页：占用/空闲底色与六态表格 */
+export declare const ResourceWallControlPanelColorTab: React.FC<ResourceWallControlPanelColorTabProps>;

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,17 @@
+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';
+}
+/**
+ * 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.js

@@ -192,6 +192,7 @@ var RecordBoardShellFrame = ({ children, className, style, belowToolbar }) => {
     () => hasGridContent && ctx.bodyView === "grid",
     [hasGridContent, ctx.bodyView]
   );
+  const showGridPagination = showGrid && ctx.gridInfiniteScroll !== true;
   const showFloorMap = (0, import_react.useMemo)(
     () => hasFloorMapSlot && effectiveFloorMapProps != null && ctx.bodyView === "floorMap",
     [hasFloorMapSlot, effectiveFloorMapProps, ctx.bodyView]
@@ -306,7 +307,7 @@ var RecordBoardShellFrame = ({ children, className, style, belowToolbar }) => {
       autoCalc: (_c = (_b = (_a = ctx == null ? void 0 : ctx.childComponentProps) == null ? void 0 : _a.grid) == null ? void 0 : _b.scroll) == null ? void 0 : _c.autoCalc
     },
     gridChildren
-  ) : showResourceWall ? resourceWallNode : showCalendar ? calendarNode : floorMapNode, showGrid ? /* @__PURE__ */ import_react.default.createElement(import_Pagination.default, null) : null) : /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, showGrid ? gridChildren : showResourceWall ? resourceWallNode : showCalendar ? calendarNode : floorMapNode, showGrid ? /* @__PURE__ */ import_react.default.createElement(import_Pagination.default, null) : null);
+  ) : showResourceWall ? resourceWallNode : showCalendar ? calendarNode : floorMapNode, showGridPagination ? /* @__PURE__ */ import_react.default.createElement(import_Pagination.default, null) : null) : /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, showGrid ? gridChildren : showResourceWall ? resourceWallNode : showCalendar ? calendarNode : floorMapNode, showGridPagination ? /* @__PURE__ */ import_react.default.createElement(import_Pagination.default, null) : null);
   const shellStyle = fillHeight && style ? { ...style, ...FILL_HEIGHT_WRAPPER_STYLE } : fillHeight ? FILL_HEIGHT_WRAPPER_STYLE : style;
   const wrapper = /* @__PURE__ */ import_react.default.createElement(import_ShellBodyMetaContext.RecordBoardShellBodyMetaContext.Provider, { value: shellBodyMeta }, /* @__PURE__ */ import_react.default.createElement(
     import_pisellShellFrame.PisellShellFrame,