@pisell/materials 6.11.34 → 6.11.36

package/es/components/pisellRecordBoard/shellFrame/ResourceWall/VenueWallCard.js

@@ -11,8 +11,9 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
 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; }
 import React, { useEffect, useRef, useState } from 'react';
+import { getText } from "../../../../locales";
 import { NoteTicker } from "./NoteTicker";
-import { VENUE_WALL_STATUS_COLOR_MAP, alphaColor, clamp, deriveVenueWallStatus, formatVenueWallCountdown } from "./venueWallUtils";
+import { getVenueWallStatusToneMap, alphaColor, clamp, deriveVenueWallStatus, formatVenueWallCountdown } from "./venueWallUtils";
 
 /** 资源墙卡内共用的墙钟 tick（每卡一条 interval，避免多字段各挂一条） */
 function useVenueWallClockNow() {
@@ -85,7 +86,7 @@ var DEFAULT_AVAILABLE = '#10b981';
  * 单块场地大屏卡（由 test.tsx CardItem 迁移，样式为内联 + 少量类名，不依赖 Tailwind）。
  */
 export var VenueWallCard = function VenueWallCard(_ref) {
-  var _VENUE_WALL_STATUS_CO, _card$currentTime, _card$currentBooking, _card$nextList, _card$nextList$length, _card$nextList2, _nextItem$booking;
+  var _toneMap$statusKey, _card$currentTime, _card$currentBooking, _card$nextList, _card$nextList$length, _card$nextList2, _nextItem$booking;
   var card = _ref.card,
     _ref$boardingSoonBefo = _ref.boardingSoonBeforeMin,
     boardingSoonBeforeMin = _ref$boardingSoonBefo === void 0 ? 10 : _ref$boardingSoonBefo,
@@ -94,7 +95,14 @@ export var VenueWallCard = function VenueWallCard(_ref) {
     _ref$availableCardCol = _ref.availableCardColor,
     availableCardColor = _ref$availableCardCol === void 0 ? DEFAULT_AVAILABLE : _ref$availableCardCol,
     _ref$heroMaxWidthRati = _ref.heroMaxWidthRatio,
-    heroMaxWidthRatio = _ref$heroMaxWidthRati === void 0 ? 0.6 : _ref$heroMaxWidthRati;
+    heroMaxWidthRatio = _ref$heroMaxWidthRati === void 0 ? 0.6 : _ref$heroMaxWidthRati,
+    statusToneMapProp = _ref.statusToneMap,
+    _ref$appearance = _ref.appearance,
+    appearance = _ref$appearance === void 0 ? 'light' : _ref$appearance;
+  var toneMap = statusToneMapProp !== null && statusToneMapProp !== void 0 ? statusToneMapProp : getVenueWallStatusToneMap();
+  var isDark = appearance === 'dark';
+  var idleMain = isDark ? '#e2e8f0' : '#0f172a';
+  var idleSub = isDark ? '#94a3b8' : '#94a3b8';
   var cardRef = useRef(null);
   var _useState7 = useState({
       width: 420,
@@ -127,16 +135,16 @@ export var VenueWallCard = function VenueWallCard(_ref) {
   var statusKey = deriveVenueWallStatus(_objectSpread(_objectSpread({}, card), {}, {
     remainingMin: liveRemainingMin
   }));
-  var tone = (_VENUE_WALL_STATUS_CO = VENUE_WALL_STATUS_COLOR_MAP[statusKey]) !== null && _VENUE_WALL_STATUS_CO !== void 0 ? _VENUE_WALL_STATUS_CO : VENUE_WALL_STATUS_COLOR_MAP.inUse;
+  var tone = (_toneMap$statusKey = toneMap[statusKey]) !== null && _toneMap$statusKey !== void 0 ? _toneMap$statusKey : toneMap.inUse;
   var isOccupied = ['inUse', 'endingSoon', 'expired'].includes(statusKey);
-  var heroText = isOccupied ? formatVenueWallCountdown(liveRemainingMin) : 'Available';
-  var heroColor = isOccupied ? statusKey === 'inUse' ? '#ffffff' : tone.color : VENUE_WALL_STATUS_COLOR_MAP.available.color;
-  var noteText = isOccupied ? tone.note : VENUE_WALL_STATUS_COLOR_MAP.available.note;
-  var noteTextColor = isOccupied ? '#ffffff' : '#0f172a';
+  var heroText = isOccupied ? formatVenueWallCountdown(liveRemainingMin) : getText('pisell-resource-wall-card-hero-available');
+  var heroColor = isOccupied ? statusKey === 'inUse' ? '#ffffff' : tone.color : toneMap.available.color;
+  var noteText = isOccupied ? tone.note : toneMap.available.note;
+  var noteTextColor = isOccupied ? '#ffffff' : idleMain;
   var noteBg = isOccupied ? tone.noteBg : alphaColor(availableCardColor, 0.2);
-  var subColor = isOccupied ? 'rgba(255,255,255,0.80)' : '#94a3b8';
-  var mainColor = isOccupied ? '#ffffff' : '#0f172a';
-  var currentLabel = 'Current';
+  var subColor = isOccupied ? 'rgba(255,255,255,0.80)' : idleSub;
+  var mainColor = isOccupied ? '#ffffff' : idleMain;
+  var currentLabel = getText('pisell-resource-wall-card-label-current');
   var currentTime = (_card$currentTime = card.currentTime) !== null && _card$currentTime !== void 0 ? _card$currentTime : '';
   var currentName = isOccupied ? (_card$currentBooking = card.currentBooking) !== null && _card$currentBooking !== void 0 ? _card$currentBooking : '' : '';
   var currentNameColor = mainColor;
@@ -151,40 +159,40 @@ export var VenueWallCard = function VenueWallCard(_ref) {
   var nextCountLabel = nextItem ? "1/".concat((_card$nextList$length = (_card$nextList2 = card.nextList) === null || _card$nextList2 === void 0 ? void 0 : _card$nextList2.length) !== null && _card$nextList$length !== void 0 ? _card$nextList$length : 0) : '';
   if (statusKey === 'boardingSoon') {
     var _card$currentBooking2;
-    heroText = "Starts in ".concat(liveStartsInMin, "m");
-    heroColor = VENUE_WALL_STATUS_COLOR_MAP.boardingSoon.color;
-    noteText = VENUE_WALL_STATUS_COLOR_MAP.boardingSoon.note;
-    noteTextColor = VENUE_WALL_STATUS_COLOR_MAP.boardingSoon.color;
-    noteBg = alphaColor(VENUE_WALL_STATUS_COLOR_MAP.boardingSoon.color, 0.18);
-    currentLabel = 'Next';
+    heroText = getText('pisell-resource-wall-card-starts-in').replace('{n}', String(liveStartsInMin));
+    heroColor = toneMap.boardingSoon.color;
+    noteText = toneMap.boardingSoon.note;
+    noteTextColor = toneMap.boardingSoon.color;
+    noteBg = alphaColor(toneMap.boardingSoon.color, 0.18);
+    currentLabel = getText('pisell-resource-wall-card-label-next');
     currentName = (_card$currentBooking2 = card.currentBooking) !== null && _card$currentBooking2 !== void 0 ? _card$currentBooking2 : '';
-    currentNameColor = VENUE_WALL_STATUS_COLOR_MAP.boardingSoon.color;
-    nextNameColor = VENUE_WALL_STATUS_COLOR_MAP.boardingSoon.color;
+    currentNameColor = toneMap.boardingSoon.color;
+    nextNameColor = toneMap.boardingSoon.color;
     progress = clamp((boardingSoonBeforeMin - liveStartsInMin) / boardingSoonBeforeMin * 100, 0, 100);
-    progressColor = VENUE_WALL_STATUS_COLOR_MAP.boardingSoon.color;
-    rightTag = VENUE_WALL_STATUS_COLOR_MAP.boardingSoon.label;
-    rightTagColor = VENUE_WALL_STATUS_COLOR_MAP.boardingSoon.color;
-    rightTagBg = alphaColor(VENUE_WALL_STATUS_COLOR_MAP.boardingSoon.color, 0.12);
-    rightTagBorder = alphaColor(VENUE_WALL_STATUS_COLOR_MAP.boardingSoon.color, 0.35);
+    progressColor = toneMap.boardingSoon.color;
+    rightTag = toneMap.boardingSoon.label;
+    rightTagColor = toneMap.boardingSoon.color;
+    rightTagBg = alphaColor(toneMap.boardingSoon.color, 0.12);
+    rightTagBorder = alphaColor(toneMap.boardingSoon.color, 0.35);
   }
   if (statusKey === 'late') {
     var _card$currentBooking3;
-    heroText = "Late +".concat(liveLateMin, "m");
+    heroText = getText('pisell-resource-wall-card-late').replace('{n}', String(liveLateMin));
     /** 仅主文案用红色；其余视觉与 Available 对齐 */
     heroColor = 'rgb(239, 68, 68)';
-    noteText = VENUE_WALL_STATUS_COLOR_MAP.late.note;
-    noteTextColor = VENUE_WALL_STATUS_COLOR_MAP.available.color;
-    noteBg = VENUE_WALL_STATUS_COLOR_MAP.available.noteBg;
-    currentLabel = 'Next';
+    noteText = toneMap.late.note;
+    noteTextColor = toneMap.available.color;
+    noteBg = toneMap.available.noteBg;
+    currentLabel = getText('pisell-resource-wall-card-label-next');
     currentName = (_card$currentBooking3 = card.currentBooking) !== null && _card$currentBooking3 !== void 0 ? _card$currentBooking3 : '';
-    currentNameColor = VENUE_WALL_STATUS_COLOR_MAP.available.color;
-    nextNameColor = VENUE_WALL_STATUS_COLOR_MAP.available.color;
+    currentNameColor = toneMap.available.color;
+    nextNameColor = toneMap.available.color;
     progress = 100;
-    progressColor = VENUE_WALL_STATUS_COLOR_MAP.available.color;
-    rightTag = VENUE_WALL_STATUS_COLOR_MAP.late.label;
-    rightTagColor = VENUE_WALL_STATUS_COLOR_MAP.available.color;
-    rightTagBg = alphaColor(VENUE_WALL_STATUS_COLOR_MAP.available.color, 0.12);
-    rightTagBorder = alphaColor(VENUE_WALL_STATUS_COLOR_MAP.available.color, 0.35);
+    progressColor = toneMap.available.color;
+    rightTag = toneMap.late.label;
+    rightTagColor = toneMap.available.color;
+    rightTagBg = alphaColor(toneMap.available.color, 0.12);
+    rightTagBorder = alphaColor(toneMap.available.color, 0.35);
   }
 
   /**
@@ -192,9 +200,9 @@ export var VenueWallCard = function VenueWallCard(_ref) {
    * drift 允许 remaining 为负后，仅「整分刚好为 0」时仍走 countdown(0) 的「Ending now」，改为「0m overtime」与产品预期一致。
    */
   if (statusKey === 'expired') {
-    heroText = liveRemainingMin < 0 ? formatVenueWallCountdown(liveRemainingMin) : liveRemainingMin === 0 ? '0m overtime' : formatVenueWallCountdown(liveRemainingMin);
+    heroText = liveRemainingMin < 0 ? formatVenueWallCountdown(liveRemainingMin) : liveRemainingMin === 0 ? getText('pisell-resource-wall-countdown-zero-overtime') : formatVenueWallCountdown(liveRemainingMin);
   }
-  var surfaceAccentColor = statusKey === 'late' ? availableCardColor : statusKey === 'boardingSoon' ? VENUE_WALL_STATUS_COLOR_MAP.boardingSoon.color : availableCardColor;
+  var surfaceAccentColor = statusKey === 'late' ? availableCardColor : statusKey === 'boardingSoon' ? toneMap.boardingSoon.color : availableCardColor;
   var cardBg = isOccupied ? "linear-gradient(180deg, ".concat(alphaColor(occupiedCardColor, 0.96), " 0%, ").concat(alphaColor(occupiedCardColor, 0.88), " 100%)") : alphaColor(surfaceAccentColor, statusKey === 'boardingSoon' || statusKey === 'late' ? 0.06 : 0.03);
   var cardBorder = isOccupied ? alphaColor(occupiedCardColor, 0.5) : alphaColor(surfaceAccentColor, 0.18);
   var moduleBorder = isOccupied ? 'rgba(255,255,255,0.10)' : alphaColor(surfaceAccentColor, 0.2);
@@ -231,6 +239,13 @@ export var VenueWallCard = function VenueWallCard(_ref) {
   var nextBlockPad = Math.max(unit * 0.16, Math.min(unit * 0.24, 16));
   var noteSize = clamp(noteHeight * 0.28 * fitScale, 10, 18);
   var tagFont = Math.max(8, tagSize * 0.68);
+
+  /**
+   * 外层卡片高度会被父级网格 `1fr` 行拉伸；若内层 grid 仍用固定 `px` 行高，
+   * 则“卡片容器变高但内容区不跟着长高”，表现为底部空白。
+   * 这里用 `minmax(基准px, nfr)` 把增量高度主要分配给 CURRENT / NEXT 两个主模块。
+   */
+  var gridTemplateRows = "".concat(headerHeight, "px minmax(").concat(Math.max(120, currentHeight), "px, 4fr) minmax(").concat(Math.max(72, nextHeight), "px, 2fr) ").concat(noteHeight, "px");
   return /*#__PURE__*/React.createElement("div", {
     ref: cardRef,
     className: "pisell-resource-wall-card",
@@ -245,16 +260,17 @@ export var VenueWallCard = function VenueWallCard(_ref) {
       borderWidth: 1,
       borderStyle: 'solid',
       borderColor: cardBorder,
-      boxShadow: '0 18px 48px rgba(15,23,42,0.06)'
+      boxShadow: isDark ? '0 18px 48px rgba(0,0,0,0.35)' : '0 18px 48px rgba(15,23,42,0.06)'
     }
   }, /*#__PURE__*/React.createElement("div", {
     style: {
       flex: 1,
       display: 'grid',
       minHeight: 0,
+      height: '100%',
       padding: shellPad,
       gap: sectionGap,
-      gridTemplateRows: "".concat(headerHeight, "px ").concat(currentHeight, "px ").concat(nextHeight, "px ").concat(noteHeight, "px")
+      gridTemplateRows: gridTemplateRows
     }
   }, /*#__PURE__*/React.createElement("div", {
     style: {
@@ -449,7 +465,7 @@ export var VenueWallCard = function VenueWallCard(_ref) {
       fontSize: nextMetaSize,
       color: subColor
     }
-  }, nextItem !== null && nextItem !== void 0 && nextItem.time ? "Next \xB7 ".concat(nextItem.time) : 'Next'), /*#__PURE__*/React.createElement("div", {
+  }, nextItem !== null && nextItem !== void 0 && nextItem.time ? getText('pisell-resource-wall-card-next-line').replace('{time}', nextItem.time) : getText('pisell-resource-wall-card-label-next')), /*#__PURE__*/React.createElement("div", {
     style: {
       fontWeight: 600,
       flexShrink: 0,

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

@@ -1,14 +1,37 @@
 import type { RecordBoardResourceWallCardModel } from '../../types';
 export declare type VenueWallStatusKey = 'inUse' | 'endingSoon' | 'expired' | 'available' | 'boardingSoon' | 'late';
-export declare const VENUE_WALL_STATUS_COLOR_MAP: Record<VenueWallStatusKey, {
+/** 单态展示配置（与 {@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[];
+export declare const VENUE_WALL_STATUS_COLOR_MAP: Record<VenueWallStatusKey, VenueWallStatusTone>;
 export declare function alphaColor(hex: string, alpha: number): string;
 export declare const clamp: (value: number, min: number, max: number) => number;
 /** 由卡片字段推导状态键（与演示页 test.tsx 规则一致） */
 export declare function deriveVenueWallStatus(card: RecordBoardResourceWallCardModel): VenueWallStatusKey;
 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/es/components/pisellRecordBoard/shellFrame/ResourceWall/venueWallUtils.js

@@ -1,3 +1,21 @@
+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 _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+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 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); }
+import { getText } from "../../../../locales";
+
+/** 单态展示配置（与 {@link VENUE_WALL_STATUS_COLOR_MAP} 值同形） */
+
+/** 仅覆盖部分字段；用于 Control Panel / localStorage */
+
+/** 单外观（浅 / 深）下的占用/空闲色与六态覆盖；持久化时 light、dark 各存一份 */
+
+export var VENUE_WALL_STATUS_KEYS = ['inUse', 'endingSoon', 'expired', 'available', 'boardingSoon', 'late'];
 export var VENUE_WALL_STATUS_COLOR_MAP = {
   inUse: {
     key: 'inUse',
@@ -75,8 +93,75 @@ export function deriveVenueWallStatus(card) {
   if (rm != null && rm <= 10) return 'endingSoon';
   return 'inUse';
 }
+function formatDurationHM(minAbs) {
+  var safe = Number.isFinite(minAbs) ? Math.max(0, Math.floor(minAbs)) : 0;
+  if (safe < 60) return "".concat(safe, "m");
+  var h = Math.floor(safe / 60);
+  var m = safe % 60;
+  return "".concat(h, "h").concat(String(m).padStart(2, '0'), "m");
+}
 export function formatVenueWallCountdown(min) {
-  if (min < 0) return "".concat(Math.abs(min), "m overtime");
-  if (min === 0) return 'Ending now';
-  return "".concat(min, "m left");
+  if (min < 0) {
+    var n = formatDurationHM(Math.abs(min));
+    return getText('pisell-resource-wall-countdown-overtime').replace('{n}', n);
+  }
+  if (min === 0) return getText('pisell-resource-wall-countdown-ending-now');
+  return getText('pisell-resource-wall-countdown-left').replace('{n}', formatDurationHM(min));
+}
+function cloneTone(t) {
+  return _objectSpread({}, t);
+}
+
+/**
+ * 合并默认六态配色与业务覆盖，供 {@link VenueWallCard} 与 Control Panel 表单初值共用。
+ */
+export function getVenueWallStatusToneMap(overrides) {
+  var out = {};
+  var _iterator = _createForOfIteratorHelper(VENUE_WALL_STATUS_KEYS),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var key = _step.value;
+      var base = cloneTone(VENUE_WALL_STATUS_COLOR_MAP[key]);
+      base.label = getText("pisell-resource-wall-tone-".concat(key, "-label"));
+      base.note = getText("pisell-resource-wall-tone-".concat(key, "-note"));
+      var patch = overrides === null || overrides === void 0 ? void 0 : overrides[key];
+      out[key] = patch ? _objectSpread(_objectSpread(_objectSpread({}, base), patch), {}, {
+        key: key
+      }) : base;
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return out;
+}
+
+/**
+ * 将编辑后的完整六态表压成「相对默认」的 overrides，便于持久化与 props 传递。
+ */
+export function diffVenueWallStatusToneOverrides(draft) {
+  var defaults = getVenueWallStatusToneMap();
+  var out = {};
+  var _iterator2 = _createForOfIteratorHelper(VENUE_WALL_STATUS_KEYS),
+    _step2;
+  try {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+      var k = _step2.value;
+      var d = draft[k];
+      var b = defaults[k];
+      var patch = {};
+      if (d.label !== b.label) patch.label = d.label;
+      if (d.note !== b.note) patch.note = d.note;
+      if (d.color !== b.color) patch.color = d.color;
+      if (d.noteBg !== b.noteBg) patch.noteBg = d.noteBg;
+      if (Object.keys(patch).length > 0) out[k] = patch;
+    }
+  } catch (err) {
+    _iterator2.e(err);
+  } finally {
+    _iterator2.f();
+  }
+  return out;
 }

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

@@ -3,6 +3,7 @@ import type { PisellFloorMapLayoutProps, PisellFloorMapLayoutRef, FloorMapDataSo
 import type { TableProps } from 'antd';
 import type { CalendarPersistContextValue } from './shellFrame/Calendar/calendarPersistGuard';
 import type { TimeRangeOption } from '../pisellTimeNavigator/types';
+import type { VenueWallAppearanceTheme, VenueWallStatusToneOverrides } from './shellFrame/ResourceWall/venueWallUtils';
 /**
  * 布局类型：一种 layout 对应一种「视图的集合」
  * - grid: 搜索 + 表格 + 分页
@@ -337,9 +338,23 @@ export interface RecordBoardResourceWallCardModel {
     /** @deprecated */
     lightOffInMin?: number;
 }
+/**
+ * 控制台「Resource & Layout」中与版式/轮播相关的可持久化字段（不含资源多选，其走 filter；不含配色，其走 appearanceTheme）。
+ */
+export interface RecordBoardResourceWallLayoutPersist {
+    layoutKey: string;
+    customCols: number;
+    customRows: number;
+    pageDurationSec: number;
+    boardingSoonBeforeMin: number;
+    heroMaxWidthRatio: number;
+}
+/** {@link RecordBoardResourceWallLayoutPersist} 默认值，与 {@link PisellRecordBoardResourceWallView} 历史初始 state 一致 */
+export declare const DEFAULT_RESOURCE_WALL_LAYOUT_PERSIST: RecordBoardResourceWallLayoutPersist;
 /**
  * 大屏资源墙视图 props；与 Shell 内 `PisellRecordBoard.ResourceWall` 合并（子优先）。
- * 可见资源由 `searchParams.filter.values[filterFieldKey]`（默认 `resource_wall_resource_ids`）与 `cards` 交集过滤。
+ * 展示顺序由 `searchParams.filter.values[filterFieldKey]`（默认 `resource_wall_resource_ids`）非空 `string[]` 决定；
+ * **未写该键、值非数组、或 `[]`**：不展示卡片。每个 id 优先用 `cards` 中同 `resourceId` 的项，否则用占位卡（仅 id）。
  */
 export interface RecordBoardResourceWallProps {
     className?: string;
@@ -352,6 +367,24 @@ export interface RecordBoardResourceWallProps {
      * @default 'resource_wall_resource_ids'
      */
     filterFieldKey?: string;
+    /** 六态文案/配色覆盖（与默认 map 浅合并）；通常由宿主从 localStorage 水合 */
+    statusToneOverrides?: VenueWallStatusToneOverrides;
+    /** 覆盖变更时回调，宿主可写入 localStorage */
+    onStatusToneOverridesChange?: (next: VenueWallStatusToneOverrides) => void;
+    /**
+     * 浅 / 深外观各自的卡面主色与六态覆盖；与 {@link onAppearanceThemeChange} 配合由宿主持久化。
+     * 未传入时由视图内部维护（刷新丢失）。
+     */
+    appearanceTheme?: VenueWallAppearanceTheme;
+    onAppearanceThemeChange?: (next: VenueWallAppearanceTheme) => void;
+    /** 当前大屏外观：浅色 / 深色；与 {@link onAppearanceModeChange} 一并由宿主导入 localStorage */
+    appearanceMode?: 'light' | 'dark';
+    onAppearanceModeChange?: (mode: 'light' | 'dark') => void;
+    /**
+     * 版式与轮播等；与 {@link onResourceWallLayoutChange} 由宿主导入 localStorage（预约页）。
+     */
+    resourceWallLayout?: Partial<RecordBoardResourceWallLayoutPersist>;
+    onResourceWallLayoutChange?: (next: RecordBoardResourceWallLayoutPersist) => void;
 }
 /**
  * RecordBoard 容器 Context 值

package/es/components/pisellRecordBoard/types.js

@@ -1 +1,126 @@
-export {};
+/**
+ * 布局类型：一种 layout 对应一种「视图的集合」
+ * - grid: 搜索 + 表格 + 分页
+ * - card: 搜索 + 卡片列表 + 分页
+ * 后续可扩展 list、kanban 等
+ */
+
+/**
+ * 列字段类型：对应 Pisell 表单组件，传入列 type 时用该组件自动渲染列（只读）与筛选项（编辑）
+ */
+
+/** 无 type 时筛选项可传入自定义组件，需支持 value / onChange 以接入 Form */
+
+/** 选项格式，用于 getOptions / options；color 用于只读态 Tag 展示 */
+
+/** 同步或异步返回选项列表，singleSelect/multipleSelect 的 fieldProps.getOptions 或 filter.getOptions 使用 */
+
+/** 列筛选配置：不传列 type 时使用。可配置 type + options/props，或传入 component（接收 value/onChange）。 */
+
+/**
+ * RecordBoard 列类型扩展（与 antd Table Column 兼容，仅增加可选字段）。
+ *
+ * 有 type（如 singleLineText）时：
+ * - 表格：自动用对应 Pisell 组件只读渲染；传入 render 则优先使用（覆盖）。
+ * - 筛选：自动用对应组件编辑态；传入 filter（type 或 component）则优先使用（覆盖）。
+ * - 排序：自动从组件 SortOptions 派生；传入 sort 则优先使用（覆盖）。
+ *
+ * 无 type 时：
+ * - 表格：无 render 则纯文本；可自定义 render。
+ * - 筛选：需配置 filterable + filter（type 或 component，component 需 value/onChange）。
+ * - 排序：需配置 sortable + sort（type 或 getSortItems）。
+ */
+
+/**
+ * 分页状态（与容器内部一致）
+ */
+
+/**
+ * 列表请求结果（与 dataSource / useRequest 等对齐）
+ */
+
+/** ShellFrame 内容区：表格、平面图、日历或大屏资源墙（与 GridLayout 同级切换） */
+
+/** 日历 Y 轴资源行（与 BookingCalendarDemo 中 court 对齐） */
+
+/**
+ * 日历格内预约条数据（与 BookingCalendarDemo 内部 booking 形状一致）；
+ * `raw` 为宿主预约行时，业务层可用其打开详情弹窗。
+ */
+
+/** 日视图时间轴上的一条预约 overlay（与 BookingCalendarDemo 内部结构对齐） */
+
+/** 表头时间分组合并（声明式）；与 {@link RecordBoardCalendarProps.renderTimelineHeader} 二选一优先用 render */
+
+/** 自定义时间列表头时注入的上下文 */
+
+/** 自定义左侧资源格 */
+
+/** 自定义日视图中间预约条外层容器内层（定位仍由日历负责） */
+
+/**
+ * 对接 `POST /shop/schedule/blocked-time` 的请求体（与后台字段一致）。
+ */
+
+/** 日历视图槽位 props：由 Shell 合并根级与子槽后传入 PisellRecordBoardCalendarView */
+
+/**
+ * 平面图槽位 props：与 PisellFloorMapLayout 对齐；items/renderItem 可省略（由 RecordBoard 默认 [] / () => null）。
+ */
+
+/** 大屏资源墙单卡数据（与画布资源 id 对齐，见 {@link resourceId}） */
+
+/**
+ * 控制台「Resource & Layout」中与版式/轮播相关的可持久化字段（不含资源多选，其走 filter；不含配色，其走 appearanceTheme）。
+ */
+
+/** {@link RecordBoardResourceWallLayoutPersist} 默认值，与 {@link PisellRecordBoardResourceWallView} 历史初始 state 一致 */
+export var DEFAULT_RESOURCE_WALL_LAYOUT_PERSIST = {
+  layoutKey: '2x3',
+  customCols: 3,
+  customRows: 2,
+  pageDurationSec: 10,
+  boardingSoonBeforeMin: 10,
+  heroMaxWidthRatio: 0.6
+};
+
+/**
+ * 大屏资源墙视图 props；与 Shell 内 `PisellRecordBoard.ResourceWall` 合并（子优先）。
+ * 展示顺序由 `searchParams.filter.values[filterFieldKey]`（默认 `resource_wall_resource_ids`）非空 `string[]` 决定；
+ * **未写该键、值非数组、或 `[]`**：不展示卡片。每个 id 优先用 `cards` 中同 `resourceId` 的项，否则用占位卡（仅 id）。
+ */
+
+/**
+ * RecordBoard 容器 Context 值
+ * 与具体 layout 类型无关，所有 layout 共用同一套数据与操作
+ */
+
+/**
+ * 各 layout 下子组件的可选透传配置（类似 ChildComponentProps）
+ */
+/**
+ * BatchActionBar 透传配置，与 PisellBatchActionBar 的 props 对齐。
+ * 具体类型见 PisellBatchActionBarProps，此处仅做透传用。
+ */
+
+/** Filter 透传配置，与 PisellFilter 的 props 对齐 */
+
+/**
+ * ToolBar 透传配置。
+ * - 继承 PisellToolBar 的 slots：topLeft、topRight、bottomLeft、bottomRight、tabs。
+ * - search：默认在工具栏内渲染 PisellFind；为对象时透传为 PisellFind 的 props；为 false 时不渲染搜索。
+ * - filter：默认在工具栏右侧渲染 PisellFilter；为对象时透传 PisellFilter props；为 false 时不渲染。筛选值绑定 searchParams.filter，变更触发 onSearch。
+ */
+
+/** Search 透传配置，与 PisellFind 的 props 对齐 */
+
+/**
+ * Grid 布局透传配置，对应 RecordBoardGridView 的 props（useRecordBoardContext('grid') 会将其合并到 context）。
+ * 基于 antd TableProps，省略由 context 注入或组件自管的项（dataSource、loading、pagination、columns、scroll、size、rowSelection）。
+ * 多选用 selectedKeys/selectedRows/onSelectionChange；其余 Table props（如 onRow、onHeaderRow、expandable、rowClassName、summary）透传。
+ */
+
+/**
+ * RecordBoard 容器 Props。
+ * 仅打散传参：列表/分页/搜索/多选/列显隐、以及 grid/toolBar/search/paginationConfig/batchActionBar/cardList 独立传入。
+ */

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { PisellSortProps } from './type';
 declare const PisellSort: (props: PisellSortProps) => JSX.Element;
 export default PisellSort;

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { TooltipPropsWithTitle } from 'antd/es/tooltip';
 import { PisellContextType } from "../pisell-config-provider/context";
 import './index.less';

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { UploadProps } from 'antd';
 import './index.less';
 export interface PisellUploadProps extends UploadProps {

package/es/components/productCard/cartSkuCard/components/AmountFooter/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './index.less';
 declare const Footer: ({ item, hideDivider, type, isOnlyTotal }: any) => JSX.Element;
 export default Footer;

package/es/components/productCard/cartSkuCard/components/Gift/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { IGiftProps } from './types';
 import './index.less';
 declare const Gift: (props: IGiftProps) => JSX.Element | null;

package/es/components/productCard/cartSkuCard/components/MultiDay/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './index.less';
 declare const MultiDay: ({ dataSource, hideDivider }: any) => JSX.Element;
 export default MultiDay;

package/es/components/productCard/cartSkuCard/components/Note/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './index.less';
 declare const Note: (props: any) => JSX.Element | null;
 export default Note;

package/es/components/productCard/cartSkuCard/components/Promotion/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 interface IPromotionProps {
     promotions: any[];
     onClick?: (item: any) => void;

package/es/components/productCard/cartSkuCard/components/discountReason/index.d.ts

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

package/es/components/productCard/cartSkuCard/components/holders/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './index.less';
 declare const Holders: (props: any) => JSX.Element | null;
 export default Holders;

package/es/components/productCard/cartSkuCard/components/packages/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './index.less';
 interface IProps {
     isShowImage?: boolean;

package/es/components/productCard/cartSkuCard/components/packages/utils.d.ts

@@ -17,4 +17,4 @@ export declare const minusSign: (item: any, type?: string) => "" | "-";
  * @Author: WangHan
  * @Date: 2024-11-22 10:58
  */
-export declare const _formatAmount: (price?: number, amountSymbol?: string, digit?: number) => string | number;
+export declare const _formatAmount: (price?: number, amountSymbol?: string, digit?: number) => any;

package/es/components/productCard/cartSkuCard/components/resources/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './index.less';
 declare const Resources: (props: any) => JSX.Element | null;
 export default Resources;

package/es/components/productCard/cartSkuCard/components/sales/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './index.less';
 interface IProps {
     hideDivider?: boolean;

package/es/components/productCard/cartSkuCard/components/specs/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './index.less';
 interface SpecsProps {
     /** 数据源 */

package/es/components/productCard/cartSkuCard/components/timeRange/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import 'dayjs/locale/zh-cn';
 import 'dayjs/locale/en';
 import 'dayjs/locale/zh-tw';

package/es/components/productCard/cartSkuCard/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './index.less';
 import { ProductCardTypes } from '../types';
 interface ISKUCardProps extends ProductCardTypes {

package/es/components/productCard/components/Action/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './index.less';
 declare const Action: ({ item, onAction }: any) => JSX.Element;
 export default Action;

package/es/components/productCard/components/AmountFooter/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './index.less';
 declare const Footer: ({ item, hideDivider, type, isOnlyTotal }: any) => JSX.Element;
 export default Footer;

package/es/components/productCard/components/Divider/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './index.less';
 declare const Divider: ({ type }: any) => JSX.Element;
 export default Divider;