@pisell/private-materials 6.11.126 → 6.11.127

package/es/plus/pisellFinancialSummary/components/Collapse/types.d.ts

@@ -0,0 +1,48 @@
+import type React from 'react';
+/**
+ * Figma 14256:5103 Collapse 单条可折叠项
+ * 设计稿：Collapse Item = Collapse Head + Collapse Body
+ */
+/** 头部左侧信息：时间、日期、客户、渠道等 */
+export interface CollapseHeadMeta {
+    /** 如 "20:00" */
+    time?: React.ReactNode;
+    /** 如 "30/08/2025" */
+    date?: React.ReactNode;
+    /** 如 "Customer" */
+    customer?: React.ReactNode;
+    /** 如 "Online Store" */
+    channel?: React.ReactNode;
+    /** 或直接传多段文案（按 gap 8px 排列） */
+    segments?: React.ReactNode[];
+}
+/** Body 内一行：支付方式/描述 + 金额 + 操作按钮 */
+export interface CollapseBodyRow {
+    /** 左侧描述，如 "Visa (12****1234)"，支持 bullet 列表样式 */
+    label: React.ReactNode;
+    /** 右侧金额，如 "-$30" */
+    amount?: React.ReactNode;
+    /** 操作按钮，如 { label: 'Void', onClick } */
+    action?: {
+        label: React.ReactNode;
+        onClick?: () => void;
+    };
+}
+export interface CollapseProps {
+    /** 头部左侧：时间/日期/客户/渠道等 */
+    headMeta: CollapseHeadMeta;
+    /** 头部右侧金额，如 "-$30" */
+    headAmount: React.ReactNode;
+    /** 是否展开 */
+    expanded?: boolean;
+    /** 默认是否展开 */
+    defaultExpanded?: boolean;
+    /** 展开变化回调 */
+    onExpandChange?: (expanded: boolean) => void;
+    /** Body 内容行（可多条） */
+    children?: React.ReactNode;
+    /** 或通过 bodyRows 传入结构化行（与 children 二选一） */
+    bodyRows?: CollapseBodyRow[];
+    className?: string;
+    style?: React.CSSProperties;
+}

package/es/plus/pisellFinancialSummary/locales.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Financial Summary 组件多语言文案（中/英/繁）
+ * 使用方式：由业务方在 init 时合并到 locales；组件内通过 locales.getText(key) 获取
+ */
+declare const _default: {
+    en: {
+        'pisell2.financialSummary.balanceDue': string;
+        'pisell2.financialSummary.total': string;
+        'pisell2.financialSummary.paid': string;
+        'pisell2.financialSummary.refund': string;
+        'pisell2.financialSummary.itemsCount': string;
+    };
+    'zh-CN': {
+        'pisell2.financialSummary.balanceDue': string;
+        'pisell2.financialSummary.total': string;
+        'pisell2.financialSummary.paid': string;
+        'pisell2.financialSummary.refund': string;
+        'pisell2.financialSummary.itemsCount': string;
+    };
+    'zh-HK': {
+        'pisell2.financialSummary.balanceDue': string;
+        'pisell2.financialSummary.total': string;
+        'pisell2.financialSummary.paid': string;
+        'pisell2.financialSummary.refund': string;
+        'pisell2.financialSummary.itemsCount': string;
+    };
+};
+export default _default;

package/es/plus/pisellFinancialSummary/types.d.ts

@@ -0,0 +1,139 @@
+import type React from 'react';
+import type { CSSProperties } from 'react';
+/**
+ * Total 区块下的单行项，支持多层级嵌套（如 Subtotal、Tax、Fee、Surcharge、Discount 等）
+ */
+export interface FinancialSummaryLineItem {
+    /** 行标题 */
+    label: React.ReactNode;
+    /** 金额，缺失时展示占位符（如 "—"） */
+    value?: number | null;
+    /** 子级明细 */
+    children?: FinancialSummaryLineItem[];
+    /** 稳定 key，建议传入以保证展开态稳定 */
+    key?: React.Key;
+    /** 展示在 label 旁边的条目数，如 "3 items" */
+    itemsCount?: React.ReactNode;
+    /** 提示 icon 的 tooltip 内容 */
+    infoTooltip?: React.ReactNode;
+}
+/** Collapse Body 单行（Figma 14256:5103 明细行：描述 + 金额 + 操作按钮） */
+export interface FinancialSummaryCollapseBodyRow {
+    label: React.ReactNode;
+    amount?: React.ReactNode;
+    action?: {
+        label: React.ReactNode;
+        onClick?: () => void;
+    };
+}
+/**
+ * 支付记录项，作为「付款历史」下的明细行（label 可为 methodName · time 等）
+ */
+export interface FinancialSummaryPaymentItem {
+    key?: React.Key;
+    /** 支付方式名称（非 Collapse 模式或 bodyRows 未传时使用） */
+    methodName?: string;
+    /** 支付金额 */
+    amount: number;
+    /** 支付时间，可选（Collapse 头部） */
+    time?: string;
+    /** 日期，可选（Collapse 头部，如 "30/08/2025"） */
+    date?: string;
+    /** 客户/操作人（Collapse 头部，如 "Customer" / "Staff: Jenny"） */
+    customer?: React.ReactNode;
+    /** 渠道/终端（Collapse 头部，如 "Online Store" / "Terminal 1100"） */
+    channel?: React.ReactNode;
+    /** 额外明细 */
+    detail?: React.ReactNode;
+    /** Collapse 展开后 body 行（不传则用 methodName + amount 生成一行） */
+    bodyRows?: FinancialSummaryCollapseBodyRow[];
+}
+/**
+ * 退款记录项，作为「退款」下的明细行
+ */
+export interface FinancialSummaryRefundItem {
+    key?: React.Key;
+    /** 退款说明 */
+    label?: React.ReactNode;
+    /** 退款金额 */
+    amount: number;
+    /** 退款时间，可选 */
+    time?: string;
+    date?: string;
+    customer?: React.ReactNode;
+    channel?: React.ReactNode;
+    /** 额外明细 */
+    detail?: React.ReactNode;
+    /** Collapse body 行 */
+    bodyRows?: FinancialSummaryCollapseBodyRow[];
+}
+/**
+ * Total 区块数据结构
+ */
+export interface FinancialSummaryTotalBlock {
+    /** Total 汇总值，可选（可由子项聚合） */
+    value?: number | null;
+    /** Total 下明细，支持多层级 */
+    children?: FinancialSummaryLineItem[];
+}
+/**
+ * 组件入参数据：Balance Due + Total + Paid + Refund
+ */
+export interface FinancialSummaryData {
+    /** 最终应付金额，null 时显示占位符 */
+    balanceDue: number | null;
+    /** Total 区块，无数据或不展示时可省略 */
+    total?: FinancialSummaryTotalBlock;
+    /** 支付记录，无数据时不展示 Paid 区块 */
+    paid?: FinancialSummaryPaymentItem[];
+    /** 退款记录，无数据时不展示 Refund 区块 */
+    refund?: FinancialSummaryRefundItem[];
+}
+/**
+ * 金额格式化选项（与 @pisell/utils formatAmountWithOptions 对齐）
+ */
+export interface FinancialSummaryAmountFormatOptions {
+    /** 货币符号，默认 '' */
+    currencySymbol?: string;
+    /** 小数位数，默认 2 */
+    amountPrecision?: number;
+    /** 是否使用千分位分隔符 */
+    useThousandsSeparator?: boolean;
+    /** 整数是否隐藏 .00 */
+    hideDecimalForWholeNumbers?: boolean;
+}
+/**
+ * PisellFinancialSummary 组件 Props
+ */
+export interface PisellFinancialSummaryProps extends FinancialSummaryAmountFormatOptions {
+    /** 资金汇总数据 */
+    data: FinancialSummaryData;
+    /** 是否显示 Total 区块，默认 true */
+    showTotal?: boolean;
+    /** 是否显示 Paid 区块，默认 true */
+    showPaid?: boolean;
+    /** 是否显示 Refund 区块，默认 true */
+    showRefund?: boolean;
+    /** 是否在 label 旁显示 N items，默认 true */
+    showItemsCount?: boolean;
+    /** 是否显示提示 icon，默认 true */
+    showInfoIcon?: boolean;
+    /** 是否隐藏金额为 0 的行，默认 false */
+    hideZeroAmountRows?: boolean;
+    /** 覆盖「Balance due」等多语言标题 */
+    titleBalanceDue?: React.ReactNode;
+    /** 覆盖「Total」标题 */
+    titleTotal?: React.ReactNode;
+    /** 覆盖「Paid」标题 */
+    titlePaid?: React.ReactNode;
+    /** 覆盖「Refund」标题 */
+    titleRefund?: React.ReactNode;
+    /** 数据缺失时展示的占位内容，默认 "—" */
+    missingValuePlaceholder?: React.ReactNode;
+    /** 默认展开层级（0=仅首行，2=展开到二级见明细，3=展开到三级），默认 0 */
+    defaultExpandedLevel?: number;
+    /** 根节点类名 */
+    className?: string;
+    /** 根节点样式 */
+    style?: CSSProperties;
+}

package/es/plus/pisellFinancialSummary/utils/buildSummaryItems.d.ts

@@ -0,0 +1,44 @@
+import type React from 'react';
+import type { FinancialSummaryData } from '../types';
+/** 与 PisellHierarchicalSummaryList items 结构兼容，避免从 @pisell/materials 导入类型时的 TS2709 */
+export interface SummaryListItem {
+    key?: React.Key;
+    label: React.ReactNode;
+    value?: React.ReactNode;
+    children?: SummaryListItem[];
+    itemsCount?: React.ReactNode;
+    infoTooltip?: React.ReactNode;
+    extra?: React.ReactNode;
+}
+export interface BuildSummaryItemsOptions {
+    /** 金额格式化 */
+    currencySymbol?: string;
+    amountPrecision?: number;
+    useThousandsSeparator?: boolean;
+    hideDecimalForWholeNumbers?: boolean;
+    /** 是否在 label 旁展示 N items */
+    showItemsCount?: boolean;
+    /** 是否展示提示 icon（由 list item 的 infoTooltip 决定是否渲染） */
+    showInfoIcon?: boolean;
+    /** 是否隐藏金额为 0 的行 */
+    hideZeroAmountRows?: boolean;
+    /** 数据缺失时的占位 */
+    missingValuePlaceholder?: React.ReactNode;
+    /** 标题与 N items 文案 */
+    getText: (key: string) => string;
+    /** 标题覆盖（Balance Due / Total / Paid / Refund） */
+    titleBalanceDue?: React.ReactNode;
+    titleTotal?: React.ReactNode;
+    titlePaid?: React.ReactNode;
+    titleRefund?: React.ReactNode;
+    /** 是否显示 Total/Paid/Refund 区块 */
+    showTotal?: boolean;
+    showPaid?: boolean;
+    showRefund?: boolean;
+    /** 为 true 时不把 Paid/Refund 加入 items（由上层注入带 expandedContent 的项，用于 Collapse 展示） */
+    skipPaidAndRefund?: boolean;
+}
+/**
+ * 将 FinancialSummaryData 转为 PisellHierarchicalSummaryList 所需的 items
+ */
+export declare function buildSummaryItems(data: FinancialSummaryData, options: BuildSummaryItemsOptions): SummaryListItem[];

package/es/plus/pisellFinancialSummary/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { buildSummaryItems } from './buildSummaryItems';
+export type { BuildSummaryItemsOptions, SummaryListItem } from './buildSummaryItems';

package/es/plus/pisellReservation/PisellReservation.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import 'dayjs/locale/zh-cn';
+import 'dayjs/locale/en';
+import 'dayjs/locale/zh-tw';
+import type { PisellReservationProps } from './types';
+import './PisellReservation.less';
+/**
+ * 预约看板 Core：内置 Sales 预约列表 + 时间轴 + 平面图。
+ * 页面壳 {@link PisellReservationBookingPage} / {@link PisellVenueControlPage} 通过 props 组合默认行为。
+ */
+export declare const PisellReservationCore: React.FC<PisellReservationProps>;

package/es/plus/pisellReservation/PisellReservation.js

@@ -56,10 +56,11 @@ import { buildCalendarResourcesFromMergedTables, findMergedTableRowForBookingRaw
 import { mergeGridBookingSearchParams, mergeSearchParamsBookingWindow, mergeSearchParamsBookingRange, readBodyViewFromStorageKey, shouldUseBuiltinReservationList } from "./data/reservationDataUtils";
 import { sceneElementsToBoundFormRecordIds } from "./floorMap/floorMapBoundRecordIds";
 import { RecordBoardBodyViewCapture, ReservationDefaultScheduleStart, ReservationGridTopRight, PisellReservationScheduleEndActions, PisellReservationToolbarTabs, ScheduleSyncOnFloorEnter } from "./components/PisellReservationSubcomponents";
+import { ReservationResourceWallResourceSelect } from "./components/ReservationResourceWallResourceSelect";
 import { useReservationFloorPlan } from "./floorMap/useReservationFloorPlan";
 import { useReservationFloorMapMerged } from "./floorMap/useReservationFloorMapMerged";
 import { ReservationCalendarDayBookingRoomCard } from "./components/ReservationCalendarDayBookingRoomCard";
-import { GRID_DS_KEY, PISELL_RESERVATION_HUD_DRAWER_COLUMN_STORAGE_KEY, PISELL_RESERVATION_HUD_LOCAL_PAGE_SIZE, I18N_CALENDAR_WRITE_NOT_AVAILABLE, I18N_HUD_TABLE_DRAWER_TITLE, I18N_NEW_MODAL_PLACEHOLDER, I18N_NEW_MODAL_TITLE, PISELL_RESERVATION_PAGE_LOCALES, PISELL_RESERVATION_RESOURCE_WALL_FILTER_STORAGE_PREFIX, RESERVATION_RESOURCE_WALL_PERSISTED_FILTER_VALUE_KEYS } from "./reservationConstants";
+import { GRID_DS_KEY, PISELL_RESERVATION_HUD_DRAWER_COLUMN_STORAGE_KEY, PISELL_RESERVATION_HUD_LOCAL_PAGE_SIZE, I18N_CALENDAR_WRITE_NOT_AVAILABLE, I18N_HUD_TABLE_DRAWER_TITLE, I18N_NEW_MODAL_PLACEHOLDER, I18N_NEW_MODAL_TITLE, I18N_RESOURCE_WALL_RESOURCES, PISELL_RESERVATION_PAGE_LOCALES, PISELL_RESERVATION_RESOURCE_WALL_FILTER_STORAGE_PREFIX, RESERVATION_RESOURCE_WALL_PERSISTED_FILTER_VALUE_KEYS } from "./reservationConstants";
 import { mapReservationRowsToVenueWallCards } from "./data/mapReservationToVenueWallCards";
 import { timelineRangeFromOperatingDayBoundary } from "./data/reservationOperatingDayRange";
 import { useReservationScheduleDebounced } from "./hooks/useReservationScheduleDebounced";
@@ -1156,6 +1157,47 @@ export var PisellReservationCore = function PisellReservationCore(props) {
     }));
   }, [isInternalListData, resourceWallFilterStorageKey, onSearch, searchParams]);
 
+  /**
+   * 水合后清洗：把 `resource_wall_resource_ids` 里**不在当前 `venueWallCards`** 的 id 剔除。
+   *
+   * 触发链：切店铺 / 资源被删 → localStorage 可能残留老 id → 水合 effect 原样写回 searchParams
+   * → 资源数据到达后此 effect 比对并 `onSearch` 回去 → 既有的 localStorage 同步 effect 监听到
+   * `searchParams` 变化后**自动**把裁剪后的 id 回写磁盘，保持干净。
+   *
+   * 防误剔除的保险：
+   *  - `floorDayBookingData.loading`：底层请求未结束时不裁剪。
+   *  - `venueWallCards.length === 0`：没有参照基准（含"该店铺确实零资源"）时**不主动清空**，保留原值。
+   */
+  useEffect(function () {
+    if (!isInternalListData) return;
+    if (!resourceWallFilterHydratedRef.current) return;
+    if (floorDayBookingData.loading) return;
+    if (venueWallCards.length === 0) return;
+    var fv = searchParams === null || searchParams === void 0 ? void 0 : searchParams.filter;
+    if (!fv || _typeof(fv) !== 'object' || fv === null) return;
+    var vals = fv.values;
+    if (!vals || _typeof(vals) !== 'object' || Array.isArray(vals)) return;
+    var existingRaw = vals.resource_wall_resource_ids;
+    if (!Array.isArray(existingRaw)) return;
+    var existingIds = existingRaw.map(function (x) {
+      return String(x);
+    });
+    var validIdSet = new Set(venueWallCards.map(function (c) {
+      return String(c.resourceId);
+    }));
+    var prunedIds = existingIds.filter(function (id) {
+      return validIdSet.has(id);
+    });
+    if (prunedIds.length === existingIds.length) return;
+    onSearch === null || onSearch === void 0 || onSearch(_objectSpread(_objectSpread({}, searchParams), {}, {
+      filter: _objectSpread(_objectSpread({}, fv), {}, {
+        values: _objectSpread(_objectSpread({}, vals), {}, {
+          resource_wall_resource_ids: prunedIds
+        })
+      })
+    }));
+  }, [isInternalListData, venueWallCards, floorDayBookingData.loading, searchParams, onSearch]);
+
   /**
    * 资源墙 localStorage：须依赖整块 `searchParams`。若仅依赖 `searchParams.filter`，
    * 少数路径可能只改写 `filter.values` 而复用同一 `filter` 引用，effect 不触发则多选 id 不落盘。
@@ -1266,14 +1308,57 @@ export var PisellReservationCore = function PisellReservationCore(props) {
   }, [scheduleEndSlotProp, defaultScheduleEnd, handleOpenNewReservationModal]);
   var bookingToolBar = bookingChildProps.toolBar;
 
+  /** 资源墙 Filter 多选：选项与合并 tables 同源 */
+  var resourceWallFilterSelectOptions = useMemo(function () {
+    return tables.map(function (row) {
+      var id = String(row.id);
+      var r = row;
+      var code = r.code != null && String(r.code).trim() !== '' ? String(r.code) : '';
+      var name = r.name != null && String(r.name).trim() !== '' ? String(r.name) : '';
+      return {
+        value: id,
+        label: code || name || id
+      };
+    });
+  }, [tables]);
+
+  /**
+   * 在 booking 透视工具栏快筛列表末尾注入「大屏资源多选」。
+   * 资源墙顶栏左侧快筛收起，该项仅在右侧 Filter 弹层展示（见 RecordBoard ToolBar）。
+   */
+  var bookingQuickFilterWithResourceWall = useMemo(function () {
+    var base = bookingToolBar === null || bookingToolBar === void 0 ? void 0 : bookingToolBar.quickFilter;
+    if (base === false || base == null) return base;
+    if (!isInternalListData) return base;
+    var rawList = base.filterList;
+    var filterList = Array.isArray(rawList) ? _toConsumableArray(rawList) : [];
+    var exists = filterList.some(function (i) {
+      var _ref2, _key;
+      return String((_ref2 = (_key = i.key) !== null && _key !== void 0 ? _key : i.name) !== null && _ref2 !== void 0 ? _ref2 : '') === DEFAULT_RESOURCE_WALL_FILTER_FIELD_KEY;
+    });
+    if (exists) return base;
+    return _objectSpread(_objectSpread({}, _typeof(base) === 'object' && base !== null ? base : {}), {}, {
+      filterList: [].concat(_toConsumableArray(filterList), [{
+        type: 'custom',
+        key: DEFAULT_RESOURCE_WALL_FILTER_FIELD_KEY,
+        name: DEFAULT_RESOURCE_WALL_FILTER_FIELD_KEY,
+        label: locales.getText(I18N_RESOURCE_WALL_RESOURCES),
+        other: {
+          component: ReservationResourceWallResourceSelect,
+          options: resourceWallFilterSelectOptions
+        }
+      }])
+    });
+  }, [bookingToolBar === null || bookingToolBar === void 0 ? void 0 : bookingToolBar.quickFilter, isInternalListData, resourceWallFilterSelectOptions]);
+
   /** 时间轴密度：优先用宿主 getTimelineHighlights；否则用本地按预约行计算 */
   var loadReservationDensity = useCallback( /*#__PURE__*/function () {
-    var _ref3 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(_ref2) {
+    var _ref4 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(_ref3) {
       var referenceDate, stepMinutes, slotCount, densityRows;
       return _regeneratorRuntime().wrap(function _callee2$(_context2) {
         while (1) switch (_context2.prev = _context2.next) {
           case 0:
-            referenceDate = _ref2.referenceDate, stepMinutes = _ref2.stepMinutes;
+            referenceDate = _ref3.referenceDate, stepMinutes = _ref3.stepMinutes;
             slotCount = reservationTimelineAxisSlotCount(referenceDate, stepMinutes, effectiveTimelineRange);
             if (!(salesTimelineHighlights != null && salesTimelineHighlights.length > 0)) {
               _context2.next = 4;
@@ -1290,18 +1375,18 @@ export var PisellReservationCore = function PisellReservationCore(props) {
       }, _callee2);
     }));
     return function (_x) {
-      return _ref3.apply(this, arguments);
+      return _ref4.apply(this, arguments);
     };
   }(), [isInternalListData, floorDayBookingData.data, data, salesTimelineHighlights, effectiveTimelineRange.start, effectiveTimelineRange.end]);
   var toolBarMerged = useMemo(function () {
-    var _ref4 = toolBarProp !== null && toolBarProp !== void 0 ? toolBarProp : {},
-      extraTabs = _ref4.tabs,
-      topRightProp = _ref4.topRight,
-      bottomLeftProp = _ref4.bottomLeft,
-      toolBarQuickFilterOverride = _ref4.quickFilter,
-      restToolbar = _objectWithoutProperties(_ref4, _excluded2);
+    var _ref5 = toolBarProp !== null && toolBarProp !== void 0 ? toolBarProp : {},
+      extraTabs = _ref5.tabs,
+      topRightProp = _ref5.topRight,
+      bottomLeftProp = _ref5.bottomLeft,
+      toolBarQuickFilterOverride = _ref5.quickFilter,
+      restToolbar = _objectWithoutProperties(_ref5, _excluded2);
     return _objectSpread(_objectSpread(_objectSpread({}, bookingToolBar !== null && bookingToolBar !== void 0 ? bookingToolBar : {}), restToolbar), {}, {
-      quickFilter: toolBarQuickFilterOverride !== undefined ? toolBarQuickFilterOverride : bookingToolBar === null || bookingToolBar === void 0 ? void 0 : bookingToolBar.quickFilter,
+      quickFilter: toolBarQuickFilterOverride !== undefined ? toolBarQuickFilterOverride : bookingQuickFilterWithResourceWall,
       tabs: /*#__PURE__*/React.createElement(PisellReservationToolbarTabs, {
         extraTabs: extraTabs,
         schedule: schedule,
@@ -1327,7 +1412,7 @@ export var PisellReservationCore = function PisellReservationCore(props) {
       }),
       bottomLeft: bottomLeftProp !== null && bottomLeftProp !== void 0 ? bottomLeftProp : null
     });
-  }, [bookingToolBar, toolBarProp, schedule, handleScheduleChange, scheduleStartSlotProp, effectiveScheduleEndSlot, followWallClock, timeNavigatorPropsProp, mergedTimeNavigatorProps, schedulePropsProp, loadReservationDensity, calendarGranularity]);
+  }, [bookingToolBar, bookingQuickFilterWithResourceWall, toolBarProp, schedule, handleScheduleChange, scheduleStartSlotProp, effectiveScheduleEndSlot, followWallClock, timeNavigatorPropsProp, mergedTimeNavigatorProps, schedulePropsProp, loadReservationDensity, calendarGranularity]);
 
   // --- 渲染：RecordBoard + 新建弹窗 + 平面图预约详情 + FAB ---
 
@@ -1427,7 +1512,7 @@ export var PisellReservationCore = function PisellReservationCore(props) {
 
   /** 日视图「屏蔽」弹窗保存 → `POST /shop/schedule/blocked-time` */
   var handleBlockedTimeSave = useCallback( /*#__PURE__*/function () {
-    var _ref5 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(payload) {
+    var _ref6 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(payload) {
       return _regeneratorRuntime().wrap(function _callee3$(_context3) {
         while (1) switch (_context3.prev = _context3.next) {
           case 0:
@@ -1451,7 +1536,7 @@ export var PisellReservationCore = function PisellReservationCore(props) {
       }, _callee3, null, [[0, 9]]);
     }));
     return function (_x2) {
-      return _ref5.apply(this, arguments);
+      return _ref6.apply(this, arguments);
     };
   }(), [floorDayBookingData]);
 

package/es/plus/pisellReservation/components/bookingChangeModal/demo.d.ts

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

package/es/plus/pisellReservation/components/bookingDetailModal/bookingProductToProductCard.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 将 booking 顶层 products[] 行映射为 ProductCard 的 dataSource（只读展示）。
+ * 字段对齐 {@link api/api-bookings-demo.json} 中 order.products 结构。
+ * 数据源必须为 raw.products，不得使用 order.products。
+ */
+import type { productType } from '../../../../../../materials/src/components/productCard/types';
+/**
+ * @param line booking.products 或 order.products 同源结构（与 api-bookings-demo 一致）
+ */
+export declare function bookingProductLineToProductCardData(line: Record<string, unknown>, index: number): productType;

package/es/plus/pisellReservation/data/filterBookingsAtTimeCursor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 平面图时间轴游标：从当日预约列表中筛出「在 cursor 时刻仍有效」的项，避免仅拖动时间重复请求接口。
+ */
+import { type Dayjs } from 'dayjs';
+/**
+ * @param bookings GET booking 列表项（与 bookingToReservationTables 入参一致）
+ * @param cursor 顶栏日程带 `at`（与 PisellTimeNavigator 对齐）
+ */
+export declare function filterBookingsVisibleAtTimeCursor(bookings: unknown[], cursor: Dayjs): unknown[];

package/es/plus/pisellReservation/floorMap/useReservationFloorPlan.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { FloorMapViewConfig } from '@pisell/materials';
 export declare function useReservationFloorPlan(options: {
     resolvedFloorPlanId: number | null;

package/es/plus/pisellReservation/floorRoomCard/floorRoomCardDom.d.ts

@@ -0,0 +1,3 @@
+import type { FloorRoomCardBooking } from './floorRoomCardModel';
+/** 宿主点击解析：同订单多行用 recordId 命中唯一条 raw */
+export declare function floorRoomCardBookingCheckoutDomKey(b: FloorRoomCardBooking): string;

package/es/plus/pisellReservation/floorRoomCard/floorRoomCardHeaderFormat.d.ts

@@ -0,0 +1,3 @@
+import type { FloorRoomCardBooking, FloorRoomCardData } from './floorRoomCardModel';
+export declare function formatRoomCapLine(data: FloorRoomCardData, bookingsForOcc: FloorRoomCardBooking[]): string;
+export declare function floorRoomCardStatusTagLabel(status: FloorRoomCardData['status']): string;

package/es/plus/pisellReservation/floorRoomCard/floorRoomCardModel.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 平面图绑定桌 RoomCard 数据结构（对齐 demo/card mock，供展示与 getCardType）
+ */
+export declare type FloorRoomCardHolder = {
+    name: string;
+    phone?: string;
+};
+/** 宿主单条 booking.status，用于多条列表时区分占用/预留肤（与行级聚合 status 解耦） */
+export declare type FloorRoomCardHostBookingStatus = 'reserved' | 'occupied' | 'locked' | 'empty';
+export declare type FloorRoomCardBooking = {
+    booking_id: string;
+    /**
+     * 宿主 `floorMapSourceBookings` 行 `id`；同一订单多时段时多条可共用 `booking_id`，
+     * 点击命中与 DOM 需用此行级 id 区分。
+     */
+    recordId?: string;
+    start_date: string;
+    start_time: string;
+    end_date: string;
+    end_time: string;
+    number: number;
+    holder?: FloorRoomCardHolder;
+    amount: string | number;
+    /** 来自宿主 `booking.status`（小写）；多条 occupied 时参与 multi_occupied，纯预留多条则排序后主卡+Next */
+    hostBookingStatus?: FloorRoomCardHostBookingStatus;
+    /** 宿主：迟到时长（分钟）；有值才展示「迟到 +Xm」，前端不按开始时间推算 */
+    lateTime?: number;
+    /** 宿主：超时时长（分钟）；有值才展示「+Xm」，前端不按结束时间推算 */
+    timeoutTime?: number;
+    /** 宿主：进行中进度 0–100（100 为满条），优先于起止时间推算 */
+    progressPercent?: number;
+    /**
+     * 宿主：距预约开始剩余分钟（`remainingReserveTime`），预留 not_arrived 时用于「还有 n 分钟」展示，优先于本地起止时间推算
+     */
+    remainingReserveTime?: number;
+    /**
+     * 宿主订单支付状态（来源：接口 `booking.order.payment_status` 等，映射到模型）。
+     * - `paid`：已付（绿）
+     * - 其它（含宿主曾返回的 `partially_paid`）：按需付款展示（红）；映射层应写入 `unpaid`
+     * - 未设：按需付款展示
+     */
+    order_payment_status?: string;
+    /**
+     * 订单商品件数：`products` 有效行数优先，否则 `order.summary.product_quantity`；无则 0。
+     */
+    product_quantity?: number;
+    /** 接口 `is_next` / `isNext`：为 true 时仅展示在 Next 行，不参与主档/多条约预览主列表 */
+    isNext?: boolean;
+};
+export declare type FloorRoomCardRoomStatus = 'empty' | 'reserved' | 'occupied' | 'locked';
+/** 细分态：与 demo `CARD_CLASS` / `getCardType` 一致 */
+export declare type FloorRoomCardSubStatus = 'not_arrived' | 'late' | 'payed' | 'payment_required' | 'timeout' | '';
+export declare type FloorRoomCardData = {
+    main_field: string;
+    capacity: number | string;
+    status: FloorRoomCardRoomStatus;
+    sub_status: FloorRoomCardSubStatus;
+    bookings: FloorRoomCardBooking[];
+};

package/es/plus/pisellReservation/floorRoomCard/floorRoomCardPaymentUi.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 平面图 RoomCard：订单支付态 → UI 分支（印章 / 金额颜色）
+ */
+/** 平面图 RoomCard 仅两种徽章：已付款 / 需付款 */
+export declare type FloorRoomCardPaymentUiKind = 'paid' | 'unpaid';
+/**
+ * @param orderPaymentStatus 来自 {@link FloorRoomCardBooking.order_payment_status}（接口多为 `order.payment_status` 映射）
+ */
+export declare function floorRoomCardPaymentUiFromOrderStatus(orderPaymentStatus: string | undefined): FloorRoomCardPaymentUiKind;

package/es/plus/pisellReservation/floorRoomCard/mapFloorRoomCardViewProps.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 将 {@link FloorRoomCardData} 映射为 {@link RoomCardHeaderView} props（供嵌入页直连纯 UI）。
+ */
+import type { FloorRoomCardBooking, FloorRoomCardData } from './floorRoomCardModel';
+import type { RoomCardHeaderViewProps } from './views/RoomCardHeaderView';
+export declare function mapFloorRoomCardDataToHeaderViewProps(data: FloorRoomCardData, options?: {
+    hideCapacity?: boolean;
+    occupancyBookings?: FloorRoomCardBooking[];
+    showStatusTag?: boolean;
+}): RoomCardHeaderViewProps;

package/es/plus/pisellReservation/floorRoomCard/views/RoomCardHeaderView.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="react" />
+import type { FloorRoomCardRoomStatus } from '../floorRoomCardModel';
+export interface RoomCardHeaderViewProps {
+    roomTitle: string;
+    /** 为 null 或空串时不渲染 Cap 行 */
+    capacityLine: string | null;
+    status: FloorRoomCardRoomStatus;
+    statusLabel: string;
+    /** false：维护卡等仅左侧标题+Cap，无右侧状态 tag */
+    showStatusTag?: boolean;
+}
+export declare function RoomCardHeaderView(props: RoomCardHeaderViewProps): JSX.Element;

package/es/plus/pisellReservation/floorRoomCard/views/RoomCardIcons.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="react" />
+export declare const IconClock: () => JSX.Element;
+export declare const IconUsers: () => JSX.Element;
+export declare const IconWarn: () => JSX.Element;
+export declare const IconMoney: () => JSX.Element;

package/es/plus/pisellReservation/floorRoomCard/views/RoomCardShellView.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+export interface RoomCardShellViewProps {
+    className: string;
+    checkoutBookingKey?: string;
+    header: React.ReactNode;
+    children?: React.ReactNode;
+}
+/** 单张 RoomCard 根壳：顶栏 + 可选主体（empty 仅顶栏） */
+export declare function RoomCardShellView(props: RoomCardShellViewProps): JSX.Element;