@pisell/private-materials 6.11.126 → 6.11.127

package/lib/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/lib/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/lib/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/lib/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/lib/plus/pisellFinancialSummary/utils/index.d.ts

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

package/lib/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/lib/plus/pisellReservation/PisellReservation.js

@@ -65,6 +65,7 @@ var import_calendarAdapter = require("./data/calendarAdapter");
 var import_reservationDataUtils = require("./data/reservationDataUtils");
 var import_floorMapBoundRecordIds = require("./floorMap/floorMapBoundRecordIds");
 var import_PisellReservationSubcomponents = require("./components/PisellReservationSubcomponents");
+var import_ReservationResourceWallResourceSelect = require("./components/ReservationResourceWallResourceSelect");
 var import_useReservationFloorPlan = require("./floorMap/useReservationFloorPlan");
 var import_useReservationFloorMapMerged = require("./floorMap/useReservationFloorMapMerged");
 var import_ReservationCalendarDayBookingRoomCard = require("./components/ReservationCalendarDayBookingRoomCard");
@@ -1123,6 +1124,40 @@ var PisellReservationCore = (props) => {
       }
     });
   }, [isInternalListData, resourceWallFilterStorageKey, onSearch, searchParams]);
+  (0, import_react.useEffect)(() => {
+    if (!isInternalListData) return;
+    if (!resourceWallFilterHydratedRef.current) return;
+    if (floorDayBookingData.loading) return;
+    if (venueWallCards.length === 0) return;
+    const fv = searchParams == null ? void 0 : searchParams.filter;
+    if (!fv || typeof fv !== "object" || fv === null) return;
+    const vals = fv.values;
+    if (!vals || typeof vals !== "object" || Array.isArray(vals)) return;
+    const existingRaw = vals.resource_wall_resource_ids;
+    if (!Array.isArray(existingRaw)) return;
+    const existingIds = existingRaw.map((x) => String(x));
+    const validIdSet = new Set(
+      venueWallCards.map((c) => String(c.resourceId))
+    );
+    const prunedIds = existingIds.filter((id) => validIdSet.has(id));
+    if (prunedIds.length === existingIds.length) return;
+    onSearch == null ? void 0 : onSearch({
+      ...searchParams,
+      filter: {
+        ...fv,
+        values: {
+          ...vals,
+          resource_wall_resource_ids: prunedIds
+        }
+      }
+    });
+  }, [
+    isInternalListData,
+    venueWallCards,
+    floorDayBookingData.loading,
+    searchParams,
+    onSearch
+  ]);
   (0, import_react.useEffect)(() => {
     if (!isInternalListData) return;
     const fv = searchParams == null ? void 0 : searchParams.filter;
@@ -1228,6 +1263,48 @@ var PisellReservationCore = (props) => {
     );
   }, [scheduleEndSlotProp, defaultScheduleEnd, handleOpenNewReservationModal]);
   const bookingToolBar = bookingChildProps.toolBar;
+  const resourceWallFilterSelectOptions = (0, import_react.useMemo)(() => {
+    return tables.map((row) => {
+      const id = String(row.id);
+      const r = row;
+      const code = r.code != null && String(r.code).trim() !== "" ? String(r.code) : "";
+      const name = r.name != null && String(r.name).trim() !== "" ? String(r.name) : "";
+      return { value: id, label: code || name || id };
+    });
+  }, [tables]);
+  const bookingQuickFilterWithResourceWall = (0, import_react.useMemo)(() => {
+    const base = bookingToolBar == null ? void 0 : bookingToolBar.quickFilter;
+    if (base === false || base == null) return base;
+    if (!isInternalListData) return base;
+    const rawList = base.filterList;
+    const filterList = Array.isArray(rawList) ? [...rawList] : [];
+    const exists = filterList.some(
+      (i) => String(
+        i.key ?? i.name ?? ""
+      ) === import_materials.DEFAULT_RESOURCE_WALL_FILTER_FIELD_KEY
+    );
+    if (exists) return base;
+    return {
+      ...typeof base === "object" && base !== null ? base : {},
+      filterList: [
+        ...filterList,
+        {
+          type: "custom",
+          key: import_materials.DEFAULT_RESOURCE_WALL_FILTER_FIELD_KEY,
+          name: import_materials.DEFAULT_RESOURCE_WALL_FILTER_FIELD_KEY,
+          label: import_utils.locales.getText(import_reservationConstants.I18N_RESOURCE_WALL_RESOURCES),
+          other: {
+            component: import_ReservationResourceWallResourceSelect.ReservationResourceWallResourceSelect,
+            options: resourceWallFilterSelectOptions
+          }
+        }
+      ]
+    };
+  }, [
+    bookingToolBar == null ? void 0 : bookingToolBar.quickFilter,
+    isInternalListData,
+    resourceWallFilterSelectOptions
+  ]);
   const loadReservationDensity = (0, import_react.useCallback)(
     async ({
       referenceDate,
@@ -1271,7 +1348,7 @@ var PisellReservationCore = (props) => {
     return {
       ...bookingToolBar ?? {},
       ...restToolbar,
-      quickFilter: toolBarQuickFilterOverride !== void 0 ? toolBarQuickFilterOverride : bookingToolBar == null ? void 0 : bookingToolBar.quickFilter,
+      quickFilter: toolBarQuickFilterOverride !== void 0 ? toolBarQuickFilterOverride : bookingQuickFilterWithResourceWall,
       tabs: /* @__PURE__ */ import_react.default.createElement(
         import_PisellReservationSubcomponents.PisellReservationToolbarTabs,
         {
@@ -1294,6 +1371,7 @@ var PisellReservationCore = (props) => {
     };
   }, [
     bookingToolBar,
+    bookingQuickFilterWithResourceWall,
     toolBarProp,
     schedule,
     handleScheduleChange,

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

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

package/lib/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/lib/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/lib/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/lib/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/lib/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/lib/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/lib/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/lib/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/lib/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/lib/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/lib/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;

package/lib/plus/pisellReservation/hooks/usePisellReservationBookingData.d.ts

@@ -0,0 +1,51 @@
+import { type Dayjs } from 'dayjs';
+/** 避免 `?? []` 每次 render 新数组引用，触发依赖 list 的 effect 死循环 */
+export declare const EMPTY_RESERVATION_LIST: unknown[];
+/** 营业日锚定：当日 02:00 — 次日 02:00（与时间轴默认一致） */
+export declare function bookingTimeWindowForAnchorDay(anchorDay: Dayjs): [Dayjs, Dayjs];
+/**
+ * 日历跨日视口：从 rangeStart 所在自然日 02:00 到 rangeEnd 的次日 02:00（与单日营业窗首尾相接）。
+ */
+export declare function bookingTimeWindowForCalendarRange(rangeStart: Date, rangeEnd: Date): [Dayjs, Dayjs];
+/**
+ * 表格视图初始筛选项：与 Sales Monitor 一致——支付态 + **今日营业日窗口**（`bookingTimeWindowForAnchorDay`）。
+ * 用户可在 QuickFilter 改日期；平面图仍用独立的 `floorDayBookingData` 与顶栏日程对齐。
+ */
+export declare function getGridTableBookingSearchParams(): Record<string, unknown>;
+export interface UsePisellReservationBookingDataOptions {
+    /** 列表单页条数；平面图按日合并台位时宜用大页 */
+    listPageSize?: number;
+    /** 初始筛选项；不传则与 Sales Monitor 一致（含当前营业日预约窗口） */
+    getInitialSearchParams?: () => Record<string, unknown>;
+    /**
+     * 合并进每次请求的扁平参数（在 `filter.values` 展开之后），如平面图
+     * `form_record_ids: number[]` 按当前资源桌筛选预约。
+     */
+    extraRequestParams?: Record<string, unknown>;
+    /**
+     * 是否启用列表 WebSocket 推送并用 `mutate` 覆盖当前数据（`osServer` + `subscriberId`）。
+     * 表格全量/分页必须与接口 HTTP 结果一致，应设为 `false`：推送常为平面图子集（如仅绑定桌），
+     * 会覆盖刚返回的整页列表，表现为「请求 50 条只显示几条且像平面图资源」。
+     * 平面图合并用 booking 请求可保持默认 `true`。
+     */
+    subscribeRealtimePush?: boolean;
+}
+/** 内置列表数据 hook 返回结构（booking / resource 页共用） */
+export interface UsePisellReservationBookingDataResult {
+    data: unknown[];
+    loading: boolean;
+    total: number;
+    pagination: {
+        pageNumber: number;
+        pageSize: number;
+    };
+    onPageChange: (pageNumber: number, pageSize: number) => void;
+    searchParams: Record<string, unknown>;
+    onSearch: (params: Record<string, unknown>) => void;
+    onReset: () => void;
+    refresh: () => void;
+    refreshAsync: () => Promise<unknown>;
+    /** 函数式合并 searchParams 并重置到第一页（用于日程变更） */
+    patchSearchParams: (updater: (prev: Record<string, unknown>) => Record<string, unknown>) => void;
+}
+export declare function usePisellReservationBookingData(enabled: boolean, options?: UsePisellReservationBookingDataOptions): UsePisellReservationBookingDataResult;

package/lib/plus/pisellReservation/hooks/useReservationScheduleDebounced.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { ReservationScheduleBandValue } from '@pisell/materials';
 /**
  * @returns `schedule` 绑定日程带 UI；`debouncedSchedule` 绑定 sales / patch / 外部 onSearch。