@pisell/materials 6.11.36 → 6.11.38

package/es/components/pisellRecordBoard/shellFrame/ToolBar/index.js

@@ -1,10 +1,19 @@
+var _excluded = ["resourceWallSortFieldKeys", "list"];
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
-function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 import React, { useCallback, useMemo } from 'react';
 import classNames from 'classnames';
 import { Button, Space, Segmented } from 'antd';
@@ -21,6 +30,7 @@ import { useRecordBoardContext } from "../../hooks/useRecordBoardContext";
 import { locales as utilsLocales } from '@pisell/utils';
 import { getText } from "../../../../locales";
 import { deriveFilterFromColumns, deriveSortFromColumns } from "../../utils/recordBoardColumns";
+import { DEFAULT_RESOURCE_WALL_STATUS_SORT_FIELD_KEYS, matchesResourceWallStatusSortField } from "../ResourceWall/venueWallUtils";
 import "./ToolBarFilter.less";
 import "./recordBoardToolbar.less";
 
@@ -30,6 +40,27 @@ function getSortButtonText() {
   var u = utilsLocales.getText(key);
   return u && u !== key ? u : getText(key) || getText('sort-button-text');
 }
+/** 资源墙无状态列派生项时注入：下拉仅「状态 → 空闲优先 / 占用优先」，仍渲染排序按钮 */
+function buildResourceWallStatusSortFallbackItem(sortConfig) {
+  var extras = _typeof(sortConfig) === 'object' && sortConfig !== null && Array.isArray(sortConfig.resourceWallSortFieldKeys) ? sortConfig.resourceWallSortFieldKeys.map(function (x) {
+    return String(x).trim();
+  }).filter(Boolean) : [];
+  var primaryKey = extras.length > 0 ? extras[0] : DEFAULT_RESOURCE_WALL_STATUS_SORT_FIELD_KEYS[0];
+  return {
+    name: primaryKey,
+    label: getText('pisell2.recordBoard.toolbar.sortStatus'),
+    isCustom: true,
+    getSortItems: function getSortItems() {
+      return [{
+        key: "".concat(primaryKey, ":asc:option"),
+        label: getText('pisell2.recordBoard.toolbar.sortStatusFreeFirst')
+      }, {
+        key: "".concat(primaryKey, ":desc:option"),
+        label: getText('pisell2.recordBoard.toolbar.sortStatusOccupiedFirst')
+      }];
+    }
+  };
+}
 function getFilterButtonText() {
   var key = 'pisell2.recordBoard.toolbar.filter';
   var u = utilsLocales.getText(key);
@@ -235,10 +266,28 @@ var RecordBoardToolBar = function RecordBoardToolBar(props) {
     onSearch(_objectSpread(_objectSpread({}, searchParams), {}, _defineProperty({}, SORT_PARAMS_FIELD, val || undefined)));
   }, [onSearch, searchParams]);
   var sortList = useMemo(function () {
-    var fromConfig = _typeof(sortConfig) === 'object' && sortConfig !== null && Array.isArray(sortConfig.list) ? sortConfig.list : null;
-    return fromConfig !== null && fromConfig !== void 0 ? fromConfig : derivedSortFromColumnsList;
-  }, [sortConfig, derivedSortFromColumnsList]);
-  var sortNode = hideSort ? null : /*#__PURE__*/React.createElement(Sort, _extends({}, _typeof(sortConfig) === 'object' && sortConfig !== null ? sortConfig : {}, {
+    /** `list: []` 若为 `??` 左值会得到空数组，无法回落到列派生；此处显式在非空时使用配置项 */
+    var configuredList = _typeof(sortConfig) === 'object' && sortConfig !== null && Array.isArray(sortConfig.list) ? sortConfig.list : null;
+    var base = configuredList != null && configuredList.length > 0 ? configuredList : derivedSortFromColumnsList;
+    if (bodyView !== 'resourceWall') {
+      return base;
+    }
+    var extraWallKeys = _typeof(sortConfig) === 'object' && sortConfig !== null && Array.isArray(sortConfig.resourceWallSortFieldKeys) ? sortConfig.resourceWallSortFieldKeys.map(String) : [];
+    var allowedKeys = [].concat(_toConsumableArray(DEFAULT_RESOURCE_WALL_STATUS_SORT_FIELD_KEYS.map(String)), _toConsumableArray(extraWallKeys));
+    var filtered = base.filter(function (item) {
+      return item.name != null && matchesResourceWallStatusSortField(String(item.name), allowedKeys);
+    });
+    if (filtered.length > 0) return filtered;
+    return [buildResourceWallStatusSortFallbackItem(sortConfig)];
+  }, [sortConfig, derivedSortFromColumnsList, bodyView]);
+  var sortSpreadRest = _typeof(sortConfig) === 'object' && sortConfig !== null ? function () {
+    var _ref3 = sortConfig,
+      _w = _ref3.resourceWallSortFieldKeys,
+      _omitList = _ref3.list,
+      rest = _objectWithoutProperties(_ref3, _excluded);
+    return rest;
+  }() : {};
+  var sortNode = hideSort ? null : /*#__PURE__*/React.createElement(Sort, _extends({}, sortSpreadRest, {
     list: sortList,
     value: sortValue,
     onChange: handleSortChange,
@@ -264,12 +313,12 @@ var RecordBoardToolBar = function RecordBoardToolBar(props) {
     // 若 otherFilter 来自 base（如 sessionStorage 恢复），JSON 会丢失函数（如 other.component），导致 custom 项空白；用 config 同 key 项补回 component/label 等
     if (otherFilter === base.otherFilter && Array.isArray(defaultFilterFromConfig === null || defaultFilterFromConfig === void 0 ? void 0 : defaultFilterFromConfig.otherFilter) && defaultFilterFromConfig.otherFilter.length > 0) {
       var configMap = new Map(defaultFilterFromConfig.otherFilter.map(function (c) {
-        var _ref3, _c$key;
-        return [(_ref3 = (_c$key = c.key) !== null && _c$key !== void 0 ? _c$key : c.name) !== null && _ref3 !== void 0 ? _ref3 : '', c];
+        var _ref4, _c$key;
+        return [(_ref4 = (_c$key = c.key) !== null && _c$key !== void 0 ? _c$key : c.name) !== null && _ref4 !== void 0 ? _ref4 : '', c];
       }));
       otherFilter = otherFilter.map(function (item) {
-        var _ref4, _item$key2, _configItem$label, _configItem$other$pla, _configItem$other, _item$other;
-        var key = (_ref4 = (_item$key2 = item.key) !== null && _item$key2 !== void 0 ? _item$key2 : item.name) !== null && _ref4 !== void 0 ? _ref4 : '';
+        var _ref5, _item$key2, _configItem$label, _configItem$other$pla, _configItem$other, _item$other;
+        var key = (_ref5 = (_item$key2 = item.key) !== null && _item$key2 !== void 0 ? _item$key2 : item.name) !== null && _ref5 !== void 0 ? _ref5 : '';
         var configItem = configMap.get(key);
         if (!configItem) return item;
         // 优先用 config 的 label/placeholder（当前语言），避免 session 恢复的旧语言覆盖
@@ -283,12 +332,18 @@ var RecordBoardToolBar = function RecordBoardToolBar(props) {
     }
     var outQuick = quickFilter;
     var outOther = otherFilter;
-    /** 资源墙：弹层只保留「资源」一项，不混入业务配置的其它 otherFilter（如预约状态、人数等） */
+    /**
+     * 资源墙：Filter 弹层只保留「大屏资源多选」一项（与顶栏 quickFilter.filterList 中
+     * `resource_wall_resource_ids` 对应），不混入日期快筛 / 业务 otherFilter。
+     */
     if (bodyView === 'resourceWall') {
       outQuick = [];
-      outOther = quickFilterList.length > 0 ? quickFilterList.map(function (item) {
+      outOther = quickFilterList.filter(function (item) {
+        var _ref6, _item$key3;
+        return ((_ref6 = (_item$key3 = item.key) !== null && _item$key3 !== void 0 ? _item$key3 : item.name) !== null && _ref6 !== void 0 ? _ref6 : '') === resourceWallFilterFieldKey;
+      }).map(function (item) {
         return _objectSpread({}, item);
-      }) : [];
+      });
     }
     return _objectSpread(_objectSpread({}, base), {}, {
       quickFilter: outQuick,

package/es/components/pisellRecordBoard/shellFrame/index.js

@@ -1,5 +1,11 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
@@ -25,6 +31,26 @@ import RecordBoardResourceWall from "./ResourceWall/RecordBoardResourceWall";
 import { PisellRecordBoardResourceWallView } from "./ResourceWall/PisellRecordBoardResourceWallView";
 import { RecordBoardShellBodyMetaContext } from "./ShellBodyMetaContext";
 
+/**
+ * 槽位 props 与根级合并：**子组件显式传入**的键覆盖根级；子级为 `undefined` 的键不覆盖（避免吞掉根级回调）。
+ * 子槽无 props（`{}`）时直接沿用根级对象引用。
+ */
+function mergeRecordBoardSlotProps(root, child) {
+  if (!child || Object.keys(child).length === 0) {
+    return root;
+  }
+  var base = _objectSpread({}, root !== null && root !== void 0 ? root : {});
+  for (var _i = 0, _Object$entries = Object.entries(child); _i < _Object$entries.length; _i++) {
+    var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
+      key = _Object$entries$_i[0],
+      val = _Object$entries$_i[1];
+    if (val !== undefined) {
+      base[key] = val;
+    }
+  }
+  return base;
+}
+
 /** fillHeight 时内容区可滚动、分页器贴底；默认表头 sticky；grid.scroll.autoCalc 时需测量高度供 scroll.y */
 var FILL_HEIGHT_SCROLL_STYLE = {
   flex: 1,
@@ -94,8 +120,7 @@ var RecordBoardShellFrame = function RecordBoardShellFrame(_ref2) {
   /** 子组件 FloorMap 与根级 context.floorMapProps 合并，子 props 覆盖根级 */
   var effectiveFloorMapProps = useMemo(function () {
     if (hasFloorMapChild) {
-      var _ctx$floorMapProps;
-      return _objectSpread(_objectSpread({}, (_ctx$floorMapProps = ctx.floorMapProps) !== null && _ctx$floorMapProps !== void 0 ? _ctx$floorMapProps : {}), floorMapPropsFromChild !== null && floorMapPropsFromChild !== void 0 ? floorMapPropsFromChild : {});
+      return mergeRecordBoardSlotProps(ctx.floorMapProps, floorMapPropsFromChild);
     }
     return ctx.floorMapProps;
   }, [hasFloorMapChild, floorMapPropsFromChild, ctx.floorMapProps]);
@@ -103,15 +128,13 @@ var RecordBoardShellFrame = function RecordBoardShellFrame(_ref2) {
   /** 子组件 Calendar 与根级 context.calendarProps 合并，子 props 覆盖根级 */
   var effectiveCalendarProps = useMemo(function () {
     if (hasCalendarChild) {
-      var _ctx$calendarProps;
-      return _objectSpread(_objectSpread({}, (_ctx$calendarProps = ctx.calendarProps) !== null && _ctx$calendarProps !== void 0 ? _ctx$calendarProps : {}), calendarPropsFromChild !== null && calendarPropsFromChild !== void 0 ? calendarPropsFromChild : {});
+      return mergeRecordBoardSlotProps(ctx.calendarProps, calendarPropsFromChild);
     }
     return ctx.calendarProps;
   }, [hasCalendarChild, calendarPropsFromChild, ctx.calendarProps]);
   var effectiveResourceWallProps = useMemo(function () {
     if (hasResourceWallChild) {
-      var _ctx$resourceWallProp;
-      return _objectSpread(_objectSpread({}, (_ctx$resourceWallProp = ctx.resourceWallProps) !== null && _ctx$resourceWallProp !== void 0 ? _ctx$resourceWallProp : {}), resourceWallPropsFromChild !== null && resourceWallPropsFromChild !== void 0 ? resourceWallPropsFromChild : {});
+      return mergeRecordBoardSlotProps(ctx.resourceWallProps, resourceWallPropsFromChild);
     }
     return ctx.resourceWallProps;
   }, [hasResourceWallChild, resourceWallPropsFromChild, ctx.resourceWallProps]);
@@ -241,7 +264,11 @@ var RecordBoardShellFrame = function RecordBoardShellFrame(_ref2) {
     value: shellBodyMeta
   }, /*#__PURE__*/React.createElement(PisellShellFrame, {
     className: classNames(className, {
-      'pisell-shell-frame--floor-map-view': !showGrid
+      /** 非表格主区：工具栏与内容区无缝（与 PisellShellFrame.less body-subview 配对） */
+      'pisell-shell-frame--body-subview': !showGrid,
+      'pisell-shell-frame--floor-map-view': showFloorMap,
+      'pisell-shell-frame--calendar-view': showCalendar,
+      'pisell-shell-frame--resource-wall-view': showResourceWall
     }),
     style: shellStyle,
     config: {

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

@@ -226,6 +226,33 @@ export interface RecordBoardCalendarBookingRenderArgs {
     onDragStart: (item: RecordBoardCalendarBookingLike) => void;
     onJumpNext: () => void;
 }
+/**
+ * 月 / 周格内单条预约插槽参数。
+ * 未使用 {@link RecordBoardCalendarProps.renderMonthWeekBooking} 时，月 / 周格仅默认 booking（紫）/ block（红），不展示状态徽标与按状态的底色。
+ */
+export interface RecordBoardCalendarGridBookingRenderArgs {
+    item: RecordBoardCalendarBookingLike;
+    dateKey: string;
+    view: 'month' | 'week';
+    isLight: boolean;
+    /**
+     * 日历建议的外层样式（圆角、内边距、默认 booking/block 底色），可与自定义 `className` 拼接。
+     * 宿主若完全自定义外观，可忽略本字段。
+     */
+    layoutClassName: string;
+    onOpenDetail: (item: RecordBoardCalendarBookingLike) => void;
+    /** 开始拖拽（月视图内置会处理 `draggable`；周格当前未挂 draggable，可自行在插槽内处理） */
+    onDragStart?: (item: RecordBoardCalendarBookingLike) => void;
+    draggable: boolean;
+}
+/** 拖拽改期的投放目标（与日历内部确认态 moveDraft 字段一致）。 */
+export interface RecordBoardBookingMoveDraft {
+    targetCourtId: string;
+    /** `YYYY-MM-DD` */
+    targetDate: string;
+    /** 与日历 `hourSlots` 一致的浮点起点小时（可含半格如 9.5） */
+    targetHour: number;
+}
 /**
  * 对接 `POST /shop/schedule/blocked-time` 的请求体（与后台字段一致）。
  */
@@ -239,9 +266,40 @@ export interface RecordBoardCalendarBlockedTimePayload {
     /** `YYYY-MM-DD HH:mm` */
     end_time: string;
 }
+/** 日视图连续空闲槽合并后的一段（与内置锁台面版预填一致） */
+export interface RecordBoardBlockedTimeMergedRange {
+    courtId: string;
+    /** `YYYY-MM-DD` */
+    date: string;
+    /** 与时间轴一致的浮点小时 */
+    startHour: number;
+    endHour: number;
+}
+/** 日视图多选的空闲格 */
+export interface RecordBoardCalendarSelectedFreeSlot {
+    courtId: string;
+    date: string;
+    hour: number;
+    court?: string;
+}
+/** 宿主弹出锁台/屏蔽表单时由日历传入的上下文（替代内置锁台面版） */
+export interface RecordBoardBlockedTimePanelPayload {
+    /** 槽位步长（小时），与日历内部 `slotStepHours` 一致 */
+    slotStepHours: number;
+    /** 与 {@link RecordBoardCalendarProps.slotStepMinutes} 一致 */
+    slotStepMinutes: number;
+    /** 日视图锚定日 `YYYY-MM-DD` */
+    dayKey: string;
+    selectedFreeSlots: RecordBoardCalendarSelectedFreeSlot[];
+    mergedRange: RecordBoardBlockedTimeMergedRange;
+}
 /** 日历视图槽位 props：由 Shell 合并根级与子槽后传入 PisellRecordBoardCalendarView */
 export interface RecordBoardCalendarProps {
     persistGuard?: CalendarPersistContextValue;
+    /**
+     * 日历画布外观：亮色切换 `theme-root.theme-light`；未传或 `dark` 为深色（默认）。
+     */
+    appearance?: 'light' | 'dark';
     className?: string;
     style?: CSSProperties;
     /** 受控：画布等资源行；不传则使用内置演示数据 */
@@ -253,8 +311,18 @@ export interface RecordBoardCalendarProps {
      * 点击预约条。返回 true 表示已消费（不再打开内置详情抽屉）。
      */
     onBookingClick?: (item: RecordBoardCalendarBookingLike) => boolean | void;
+    /**
+     * 拖拽预约条松手且投放合法后，由宿主接管确认与持久化（例如业务侧 booking 改约弹窗）。
+     * **传入后**日历不再弹出内置 MoveConfirmModal，也不会写入本地 bookings。
+     * 返回 `true` 表示宿主已视为完成（一般由弹窗 resolve）；`false`/`undefined`/reject 表示未生效。
+     */
+    onBookingMoveRequest?: (payload: {
+        item: RecordBoardCalendarBookingLike;
+        draft: RecordBoardBookingMoveDraft;
+    }) => Promise<boolean | void>;
     /**
      * 锚点日 / 视图变化（月、周、日），用于父级扩展 booking 请求时间窗。
+     * 宿主导出时建议对拉数做 **debounce**（如 200–300ms），与切 `bodyView`、切日等快速操作对齐，避免重复请求。
      */
     onViewportChange?: (payload: {
         view: string;
@@ -282,8 +350,14 @@ export interface RecordBoardCalendarProps {
     /**
      * 保存「屏蔽时间」时提交（如 `/shop/schedule/blocked-time`）。
      * 返回 `false` 表示未成功（弹窗保持）；`true` 或 `undefined` 视为成功并关闭弹窗、清空选中。
+     * 若同时传 {@link onBlockedTimePanelRequest}，内置锁台面版不再展示，本回调仅在内置路径生效。
      */
     onBlockedTimeSave?: (payload: RecordBoardCalendarBlockedTimePayload) => Promise<boolean | void>;
+    /**
+     * 日视图选中连续空闲槽并点「屏蔽」时，由宿主弹出锁台表单（替代内置锁台面版）。
+     * **传入后**不再渲染内置屏蔽弹层；未传时仍使用内置表单 + {@link onBlockedTimeSave}。
+     */
+    onBlockedTimePanelRequest?: (payload: RecordBoardBlockedTimePanelPayload) => Promise<boolean | void>;
     /** 与接口 `blocked_sales_channels` 一致；默认 `['online_store']` */
     blockedTimeSalesChannels?: string[];
     /**
@@ -296,8 +370,14 @@ export interface RecordBoardCalendarProps {
      * 若同时传 {@link renderTimelineHeader}，则仅渲染插槽，**忽略**本字段。
      */
     timelineHeaderGroups?: RecordBoardCalendarTimelineHeaderGroup[];
-    /** 自定义日视图时间轴上的预约条内容（周/月格内仍用内置紧凑摘要） */
+    /**
+     * 自定义日视图时间轴上的预约条内容（仅日视图 overlay 生效；月 / 周见 {@link renderMonthWeekBooking}）。
+     */
     renderBooking?: (args: RecordBoardCalendarBookingRenderArgs) => ReactNode;
+    /**
+     * 自定义月 / 周格内单条预约。未传时仅默认 booking / block 样式与名称、时间，不展示迟到/取消等状态徽标与状态变色。
+     */
+    renderMonthWeekBooking?: (args: RecordBoardCalendarGridBookingRenderArgs) => ReactNode;
     /** 自定义周/日视图左侧资源列单元 */
     renderResourceCell?: (args: RecordBoardCalendarResourceRenderArgs) => ReactNode;
 }
@@ -353,8 +433,11 @@ export interface RecordBoardResourceWallLayoutPersist {
 export declare const DEFAULT_RESOURCE_WALL_LAYOUT_PERSIST: RecordBoardResourceWallLayoutPersist;
 /**
  * 大屏资源墙视图 props；与 Shell 内 `PisellRecordBoard.ResourceWall` 合并（子优先）。
- * 展示顺序由 `searchParams.filter.values[filterFieldKey]`（默认 `resource_wall_resource_ids`）非空 `string[]` 决定；
- * **未写该键、值非数组、或 `[]`**：不展示卡片。每个 id 优先用 `cards` 中同 `resourceId` 的项，否则用占位卡（仅 id）。
+ * 展示顺序默认由 `searchParams.filter.values[filterFieldKey]`（默认 `resource_wall_resource_ids`）非空 `string[]` 决定；
+ * **未写该键、值非数组、或 `[]`**：不展示卡片。**仅渲染 `cards` 中能按 `resourceId` 命中的项**；
+ * 命中不到的 id（例如磁盘残留的旧店铺 / 已删资源）直接剔除、不再回退成「数字占位卡」，磁盘清洗由宿主负责。
+ * 当 `searchParams.sort` 的字段名与 {@link RecordBoardResourceWallProps.statusSortFieldKeys} 匹配（默认 `status`）时，
+ * 在筛选顺序基础上按卡占用态重排：升序空闲在前，降序占用（inUse/将结/已结束）在前。
  */
 export interface RecordBoardResourceWallProps {
     className?: string;
@@ -367,6 +450,12 @@ export interface RecordBoardResourceWallProps {
      * @default 'resource_wall_resource_ids'
      */
     filterFieldKey?: string;
+    /**
+     * 与 ToolBar `searchParams.sort` 首段字段名比对（忽略大小写）；命中时资源墙按卡状态重排。
+     * 列 key 不是 `status` 时传入实际字段名，例如 `['courtStatus']`。
+     * @default ['status']
+     */
+    statusSortFieldKeys?: string[];
     /** 六态文案/配色覆盖（与默认 map 浅合并）；通常由宿主从 localStorage 水合 */
     statusToneOverrides?: VenueWallStatusToneOverrides;
     /** 覆盖变更时回调，宿主可写入 localStorage */
@@ -507,7 +596,11 @@ export interface RecordBoardToolBarProps {
     search?: boolean | RecordBoardSearchProps;
     /** 在 ToolBar 右侧渲染筛选：默认 PisellFilter；对象透传 PisellFilter props；false 不渲染。值存于 searchParams.filter */
     filter?: boolean | RecordBoardFilterProps;
-    /** 在 ToolBar 内、筛选左侧渲染排序：默认 Sort；对象可传 list、placement 等；false 不渲染。值存于 searchParams.sort */
+    /**
+     * 在 ToolBar 内、筛选左侧渲染排序：默认 Sort；对象可传 list、placement 等；false 不渲染。值存于 searchParams.sort。
+     * 资源墙视图：排序**菜单内**仅保留「状态」相关项（其余排序仅在表格等视图出现）；若无状态列派生项，会注入「空闲优先 / 占用优先」子项。
+     * 可传 `resourceWallSortFieldKeys: string[]` 与非 `status` 列 key 对齐。表格/平面图/日历仍使用完整排序列表。
+     */
     sort?: boolean | Record<string, any>;
     /**
      * 在 ToolBar 左侧展示内联快速筛选（替代 Filter 弹层内的 quickFilter）。

package/es/components/pisellRecordBoard/types.js

@@ -58,10 +58,23 @@
 
 /** 自定义日视图中间预约条外层容器内层（定位仍由日历负责） */
 
+/**
+ * 月 / 周格内单条预约插槽参数。
+ * 未使用 {@link RecordBoardCalendarProps.renderMonthWeekBooking} 时，月 / 周格仅默认 booking（紫）/ block（红），不展示状态徽标与按状态的底色。
+ */
+
+/** 拖拽改期的投放目标（与日历内部确认态 moveDraft 字段一致）。 */
+
 /**
  * 对接 `POST /shop/schedule/blocked-time` 的请求体（与后台字段一致）。
  */
 
+/** 日视图连续空闲槽合并后的一段（与内置锁台面版预填一致） */
+
+/** 日视图多选的空闲格 */
+
+/** 宿主弹出锁台/屏蔽表单时由日历传入的上下文（替代内置锁台面版） */
+
 /** 日历视图槽位 props：由 Shell 合并根级与子槽后传入 PisellRecordBoardCalendarView */
 
 /**
@@ -86,8 +99,11 @@ export var DEFAULT_RESOURCE_WALL_LAYOUT_PERSIST = {
 
 /**
  * 大屏资源墙视图 props；与 Shell 内 `PisellRecordBoard.ResourceWall` 合并（子优先）。
- * 展示顺序由 `searchParams.filter.values[filterFieldKey]`（默认 `resource_wall_resource_ids`）非空 `string[]` 决定；
- * **未写该键、值非数组、或 `[]`**：不展示卡片。每个 id 优先用 `cards` 中同 `resourceId` 的项，否则用占位卡（仅 id）。
+ * 展示顺序默认由 `searchParams.filter.values[filterFieldKey]`（默认 `resource_wall_resource_ids`）非空 `string[]` 决定；
+ * **未写该键、值非数组、或 `[]`**：不展示卡片。**仅渲染 `cards` 中能按 `resourceId` 命中的项**；
+ * 命中不到的 id（例如磁盘残留的旧店铺 / 已删资源）直接剔除、不再回退成「数字占位卡」，磁盘清洗由宿主负责。
+ * 当 `searchParams.sort` 的字段名与 {@link RecordBoardResourceWallProps.statusSortFieldKeys} 匹配（默认 `status`）时，
+ * 在筛选顺序基础上按卡占用态重排：升序空闲在前，降序占用（inUse/将结/已结束）在前。
  */
 
 /**

package/es/components/pisellReservationScheduleBand/PisellReservationScheduleBand.less

@@ -45,18 +45,39 @@
   border-radius: 0;
   background: #141824;
   border: 1px solid rgba(255, 255, 255, 0.06);
+  /**
+   * 布局：auto | minmax(0,1fr) | auto
+   * - 左：标题 + 视图切换等内容宽占位
+   * - 右：「+ New」等固定贴行末
+   * - 中间：仅占左、右之间的剩余宽度；选日期 / 跟随时间文案在该「中间区域」内居中（见 .pisell-reservation-schedule-band-schedule）
+   */
+  /** 左/右栏 min-width:max-content 后整行可能超出视口，允许横向滚动而非压扁左侧 */
+  overflow-x: auto;
+  overflow-y: visible;
 }
 
 .pisell-reservation-schedule-band-slot-start {
   justify-self: start;
-  min-width: 0;
+  /** 勿用 min-width:0：会把「标题 + Segmented」挤折行；max-content 保证左侧优先单行横排 */
+  min-width: max-content;
   display: flex;
   align-items: center;
+  flex-direction: row;
+  flex-wrap: nowrap;
+  /** 中间栏内容偶发溢出绘制时压在左侧 Tab 上，保证左侧在上层 */
+  position: relative;
+  z-index: 1;
+  /** 业务侧（如预约）在插槽里再包一层 merge 时，保证子级也按内容宽参与列宽计算，避免整条 min-width:0 收缩链 */
+  > * {
+    min-width: max-content;
+    flex-shrink: 0;
+  }
 }
 
 .pisell-reservation-schedule-band-slot-end {
   justify-self: end;
-  min-width: 0;
+  /** 右侧按钮区同样保留完整占位，避免被 1fr 中间列挤压 */
+  min-width: max-content;
   display: flex;
   align-items: center;
 }
@@ -68,7 +89,18 @@
   flex-direction: row;
   flex-wrap: nowrap;
   align-items: center;
+  /**
+   * 仅在 Grid 的中间列（左、右扣掉之后的剩余宽度）内居中选日区；
+   * 不与「整行居中」混淆，也不会贴死到 + New。
+   */
   justify-content: center;
+  @supports (justify-content: safe center) {
+    justify-content: safe center;
+  }
+  /** 中间块总宽超过中间列时在本格内滚动，避免向左绘制盖住左侧 Segmented */
+  overflow-x: auto;
+  overflow-y: visible;
+  box-sizing: border-box;
   /** 日期与右侧「当前时间」等插槽留出间距，避免贴太紧 */
   gap: 14px;
 }

package/es/components/pisellShellFrame/PisellShellFrame.less

@@ -36,8 +36,11 @@
     margin-bottom: 8px;
   }
 
-  /** RecordBoard 平面图模式：与日程带衔接，去掉工具栏与内容区间距 */
-
+  /**
+   * RecordBoard 非表格主区（平面图 / 日历 / 资源墙）：与顶栏日程带衔接，去掉工具栏与内容区间距。
+   * `--floor-map-view` 仍可在仅平面图场景单独挂类；规则与 body-subview 一致。
+   */
+  &--body-subview &-toolbar,
   &--floor-map-view &-toolbar {
     margin-bottom: 0;
   }

package/es/components/table/Table/SelectField/index.d.ts

@@ -1,3 +1,2 @@
-/// <reference types="react" />
 declare const SelectField: () => JSX.Element;
 export default SelectField;

package/es/components/table/Table/tableConfig/summary/index.d.ts

@@ -1,3 +1,2 @@
-/// <reference types="react" />
 declare const summary: (props: any) => JSX.Element;
 export default summary;

package/es/hooks/useResponsive.d.ts

@@ -1,4 +1,4 @@
 declare type ResponsiveConfig = Record<string, number>;
 export declare function configResponsive(config: ResponsiveConfig): void;
-export default function useResponsive(): "pc" | "ipad" | "phone";
+export default function useResponsive(): "pc" | "phone" | "ipad";
 export {};

package/es/index.d.ts

@@ -131,7 +131,7 @@ export { PisellRecordBoardCalendarView, CalendarPersistProvider, } from './compo
 export { PisellRecordBoardResourceWallView, DEFAULT_RESOURCE_WALL_FILTER_FIELD_KEY, } from './components/pisellRecordBoard/shellFrame/ResourceWall/PisellRecordBoardResourceWallView';
 export { getVenueWallStatusToneMap, diffVenueWallStatusToneOverrides, } from './components/pisellRecordBoard/shellFrame/ResourceWall/venueWallUtils';
 export type { VenueWallStatusKey, VenueWallStatusTone, VenueWallStatusToneOverrides, VenueWallAppearanceSlot, VenueWallAppearanceTheme, } from './components/pisellRecordBoard/shellFrame/ResourceWall/venueWallUtils';
-export type { RecordBoardContextValue, RecordBoardChildComponentProps, RecordBoardColumnType, RecordBoardProps, RecordBoardToolBarProps, RecordBoardBodyView, RecordBoardCalendarProps, RecordBoardCalendarBlockedTimePayload, RecordBoardCalendarResource, RecordBoardCalendarBookingLike, RecordBoardCalendarDayOverlayBooking, RecordBoardCalendarTimelineHeaderGroup, RecordBoardCalendarTimelineHeaderRenderContext, RecordBoardCalendarResourceRenderArgs, RecordBoardCalendarBookingRenderArgs, RecordBoardResourceWallProps, RecordBoardResourceWallCardModel, RecordBoardResourceWallLayoutPersist, } from './components/pisellRecordBoard';
+export type { RecordBoardContextValue, RecordBoardChildComponentProps, RecordBoardColumnType, RecordBoardProps, RecordBoardToolBarProps, RecordBoardBodyView, RecordBoardCalendarProps, RecordBoardCalendarBlockedTimePayload, RecordBoardCalendarResource, RecordBoardCalendarBookingLike, RecordBoardCalendarDayOverlayBooking, RecordBoardCalendarTimelineHeaderGroup, RecordBoardCalendarTimelineHeaderRenderContext, RecordBoardCalendarResourceRenderArgs, RecordBoardCalendarBookingRenderArgs, RecordBoardBookingMoveDraft, RecordBoardBlockedTimeMergedRange, RecordBoardBlockedTimePanelPayload, RecordBoardCalendarSelectedFreeSlot, RecordBoardResourceWallProps, RecordBoardResourceWallCardModel, RecordBoardResourceWallLayoutPersist, } from './components/pisellRecordBoard';
 export { DEFAULT_RESOURCE_WALL_LAYOUT_PERSIST } from './components/pisellRecordBoard';
 export type { CalendarPersistKind, CalendarPersistContextValue, PisellRecordBoardCalendarViewProps, } from './components/pisellRecordBoard/shellFrame/Calendar';
 export { PisellShellFrame } from './components/pisellShellFrame';

package/es/locales/en-US.d.ts

@@ -179,6 +179,9 @@ declare const _default: {
     'pisell2.recordBoard.toolbar.find': string;
     'pisell2.recordBoard.toolbar.findPlaceholder': string;
     'pisell2.recordBoard.toolbar.sort': string;
+    'pisell2.recordBoard.toolbar.sortStatus': string;
+    'pisell2.recordBoard.toolbar.sortStatusFreeFirst': string;
+    'pisell2.recordBoard.toolbar.sortStatusOccupiedFirst': string;
     'pisell2.recordBoard.toolbar.filter': string;
     'pisell2.recordBoard.toolbar.reset': string;
     'pisell2.recordBoard.toolbar.viewGrid': string;
@@ -186,6 +189,77 @@ declare const _default: {
     'pisell2.recordBoard.toolbar.viewCalendar': string;
     'pisell2.recordBoard.toolbar.viewResourceWall': string;
     'pisell2.recordBoard.filter.placeholderEnter': string;
+    'pisell2.recordBoard.calendar.common.close': string;
+    'pisell2.recordBoard.calendar.common.cancel': string;
+    'pisell2.recordBoard.calendar.common.save': string;
+    'pisell2.recordBoard.calendar.common.saving': string;
+    'pisell2.recordBoard.calendar.common.resourceFallback': string;
+    'pisell2.recordBoard.calendar.common.newBookingName': string;
+    'pisell2.recordBoard.calendar.weekday.mon': string;
+    'pisell2.recordBoard.calendar.weekday.tue': string;
+    'pisell2.recordBoard.calendar.weekday.wed': string;
+    'pisell2.recordBoard.calendar.weekday.thu': string;
+    'pisell2.recordBoard.calendar.weekday.fri': string;
+    'pisell2.recordBoard.calendar.weekday.sat': string;
+    'pisell2.recordBoard.calendar.weekday.sun': string;
+    'pisell2.recordBoard.calendar.block.panelTitle': string;
+    'pisell2.recordBoard.calendar.block.defaultTitle': string;
+    'pisell2.recordBoard.calendar.block.fieldTitle': string;
+    'pisell2.recordBoard.calendar.block.fieldNote': string;
+    'pisell2.recordBoard.calendar.block.fieldResource': string;
+    'pisell2.recordBoard.calendar.block.fieldTimeRange': string;
+    'pisell2.recordBoard.calendar.block.placeholderTitle': string;
+    'pisell2.recordBoard.calendar.block.placeholderNote': string;
+    'pisell2.recordBoard.calendar.block.noResource': string;
+    'pisell2.recordBoard.calendar.block.closeAria': string;
+    'pisell2.recordBoard.calendar.block.warnSelectTime': string;
+    'pisell2.recordBoard.calendar.block.warnEndAfterStart': string;
+    'pisell2.recordBoard.calendar.block.warnSelectResource': string;
+    'pisell2.recordBoard.calendar.overflow.bookingsForDay': string;
+    'pisell2.recordBoard.calendar.overflow.listTitleBookings': string;
+    'pisell2.recordBoard.calendar.overflow.listTitleAllBookings': string;
+    'pisell2.recordBoard.calendar.overflow.moreCount': string;
+    'pisell2.recordBoard.calendar.move.title': string;
+    'pisell2.recordBoard.calendar.move.subtitle': string;
+    'pisell2.recordBoard.calendar.move.customer': string;
+    'pisell2.recordBoard.calendar.move.court': string;
+    'pisell2.recordBoard.calendar.move.newDate': string;
+    'pisell2.recordBoard.calendar.move.newStartTime': string;
+    'pisell2.recordBoard.calendar.move.newEndTime': string;
+    'pisell2.recordBoard.calendar.move.previousInfo': string;
+    'pisell2.recordBoard.calendar.move.original': string;
+    'pisell2.recordBoard.calendar.move.dropTarget': string;
+    'pisell2.recordBoard.calendar.move.updated': string;
+    'pisell2.recordBoard.calendar.move.confirm': string;
+    'pisell2.recordBoard.calendar.move.noPhone': string;
+    'pisell2.recordBoard.calendar.move.noEmail': string;
+    'pisell2.recordBoard.calendar.move.courtFallback': string;
+    'pisell2.recordBoard.calendar.move.slotDisabled': string;
+    'pisell2.recordBoard.calendar.week.headerCourtDate': string;
+    'pisell2.recordBoard.calendar.week.fullyBooked': string;
+    'pisell2.recordBoard.calendar.week.available': string;
+    'pisell2.recordBoard.calendar.day.outsideHours': string;
+    'pisell2.recordBoard.calendar.day.selectedBlock': string;
+    'pisell2.recordBoard.calendar.day.selected': string;
+    'pisell2.recordBoard.calendar.day.tapToSelect': string;
+    'pisell2.recordBoard.calendar.day.deselectAll': string;
+    'pisell2.recordBoard.calendar.day.openSlot': string;
+    'pisell2.recordBoard.calendar.day.block': string;
+    'pisell2.recordBoard.calendar.day.createBooking': string;
+    'pisell2.recordBoard.calendar.day.freeRatio': string;
+    'pisell2.recordBoard.calendar.card.continuesNext': string;
+    'pisell2.recordBoard.calendar.card.blockBy': string;
+    'pisell2.recordBoard.calendar.card.lateMinutesBadge': string;
+    'pisell2.recordBoard.calendar.card.lateMinutesDetail': string;
+    'pisell2.recordBoard.calendar.status.cancel': string;
+    'pisell2.recordBoard.calendar.status.change': string;
+    'pisell2.recordBoard.calendar.status.checkedIn': string;
+    'pisell2.recordBoard.calendar.status.pending': string;
+    'pisell2.recordBoard.calendar.status.new': string;
+    'pisell2.recordBoard.calendar.status.late': string;
+    'pisell2.recordBoard.calendar.status.noShow': string;
+    'pisell2.recordBoard.calendar.detail.staff': string;
+    'pisell2.recordBoard.calendar.detail.orderNote': string;
     'pisell2.salesManagement.pagination.previous': string;
     'pisell2.salesManagement.pagination.next': string;
     'pisell2.salesManagement.pagination.showTotal': (start: number, end: number) => string;