@pisell/private-materials 6.3.149 → 6.3.150

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/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/floorMapHostCheckout.d.ts

@@ -0,0 +1,6 @@
+import type { MouseEvent as ReactMouseEvent } from 'react';
+/**
+ * 根据点击目标解析要交给宿主的预约行：多预约卡片上子块带
+ * {@link PISELL_FLOOR_CHECKOUT_BOOKING_SELECTOR} 时命中对应项，否则取列表首条。
+ */
+export declare function resolveFloorMapHostCheckoutRecord(event: ReactMouseEvent<HTMLElement>, sourceBookings: Record<string, unknown>[] | undefined): Record<string, unknown> | undefined;

package/lib/plus/pisellReservation/floorMap/floorPlanApi.d.ts

@@ -6,10 +6,10 @@ export declare const RESERVATION_DEFAULT_FLOOR_PLAN_ID = 1;
 export type { PostShopFloorPlanBody, PutShopFloorPlanBody, ShopFloorPlanByCodeRequestOptions, ShopFloorPlanDetail, ShopFloorPlanLayoutItem, };
 export { buildFloorPlanPutBody, floorMapSavedConfigToRemotePatch, inferCanvasSizeFromScene, mergeFloorPlanViewRemote, parseLayoutFieldToViewConfigPatch, pickFloorPlanDetail, sceneElementsToShopLayout, viewConfigToLayoutPayload, isShopFloorPlanNotFoundResponse, isHttpNotFoundError, } from '@pisell/materials';
 export declare function isFloorPlanDuplicateCodeError(err: unknown): boolean;
-export declare const getShopFloorPlanByCode: any;
-export declare const postShopFloorPlan: any;
-export declare const putShopFloorPlan: any;
-export declare const unsubscribeShopFloorPlanCodeQuery: any;
+export declare const getShopFloorPlanByCode: (code: string, subscribe?: ShopFloorPlanByCodeRequestOptions | undefined) => Promise<ShopFloorPlanDetail | null>;
+export declare const postShopFloorPlan: (body: PostShopFloorPlanBody) => Promise<ShopFloorPlanDetail | null>;
+export declare const putShopFloorPlan: (id: number, body: PutShopFloorPlanBody) => Promise<unknown>;
+export declare const unsubscribeShopFloorPlanCodeQuery: (subscriberId: string) => Promise<void>;
 /**
  * 404 时 POST 创建使用预约默认 JSON（`api/create-floor-map.json`）。
  */
@@ -21,7 +21,7 @@ export declare function buildDefaultReservationFloorPlanPostBody(code: string):
 export declare function shopLayoutToSceneElements(layout: ShopFloorPlanLayoutItem[], options: {
     canvasId: string;
     dataSourceKey: string;
-}): any;
+}): import("@pisell/materials").FloorMapSceneElement[];
 export declare function saveViewConfigToShopFloorPlan(id: number, config: import('@pisell/materials').FloorMapViewConfig, options: {
     canvasWidth?: number;
     canvasHeight?: number;

package/lib/plus/pisellReservation/floorMap/reservationCards.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { type FloorMapMergedItem, type FloorMapDataSources } from '@pisell/materials';
+import { type FloorMapMergedItem, type FloorMapDataSources, type FloorMapItemBase, type FloorMapRenderOptions } from '@pisell/materials';
 import type { PisellReservationTableRow } from '../types';
 import './ReservationCards.less';
 export declare function findReservationRow(item: FloorMapMergedItem, dataSources: FloorMapDataSources): PisellReservationTableRow | undefined;
@@ -7,10 +7,10 @@ export declare function renderReservationTableCard(item: FloorMapMergedItem, dat
 export declare function renderReservationPartyCard(item: FloorMapMergedItem, dataSources: FloorMapDataSources): React.ReactNode;
 export declare function renderReservationBarCard(item: FloorMapMergedItem, dataSources: FloorMapDataSources): React.ReactNode;
 export declare function getReservationRenderItemByKind(dataSources: FloorMapDataSources): {
-    [x: number]: (item: FloorMapItemBase, _index: number, _options?: any) => any;
-    reservationBoundTable: (item: FloorMapItemBase, _index: number, _options?: any) => React.ReactNode;
-    reservationBoundRoundTable: (item: FloorMapItemBase, _index: number, _options?: any) => React.ReactNode;
-    reservationTable: (item: FloorMapItemBase, _index: number, _options?: any) => React.ReactNode;
-    reservationPartyBench: (item: FloorMapItemBase, _index: number, _options?: any) => React.ReactNode;
-    reservationBarSeat: (item: FloorMapItemBase, _index: number, _options?: any) => React.ReactNode;
+    floorMapImage: (item: FloorMapItemBase, _index: number, _options?: FloorMapRenderOptions) => React.ReactNode;
+    reservationBoundTable: (item: FloorMapItemBase, _index: number, _options?: FloorMapRenderOptions) => React.ReactNode;
+    reservationBoundRoundTable: (item: FloorMapItemBase, _index: number, _options?: FloorMapRenderOptions) => React.ReactNode;
+    reservationTable: (item: FloorMapItemBase, _index: number, _options?: FloorMapRenderOptions) => React.ReactNode;
+    reservationPartyBench: (item: FloorMapItemBase, _index: number, _options?: FloorMapRenderOptions) => React.ReactNode;
+    reservationBarSeat: (item: FloorMapItemBase, _index: number, _options?: FloorMapRenderOptions) => React.ReactNode;
 };

package/lib/plus/pisellReservation/floorMap/useReservationFloorMapMerged.d.ts

@@ -43,4 +43,4 @@ export interface UseReservationFloorMapMergedParams {
     /** 场控等：HUD 表抽屉开启时视口叠加层锚左下、Dock 默认右下（可由 floorMap 显式覆盖） */
     floorMapHudTableDrawer?: boolean;
 }
-export declare function useReservationFloorMapMerged(params: UseReservationFloorMapMergedParams): any;
+export declare function useReservationFloorMapMerged(params: UseReservationFloorMapMergedParams): Partial<import("@pisell/materials").PisellFloorMapLayoutProps<import("@pisell/materials").FloorMapItemBase>>;

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

@@ -9,5 +9,5 @@ export declare function useReservationFloorPlan(options: {
 }): {
     baseFloorConfig: FloorMapViewConfig;
     floorPlanRemoteId: number | null;
-    setRemoteFloorPlanView: import("react").Dispatch<any>;
+    setRemoteFloorPlanView: import("react").Dispatch<import("react").SetStateAction<Partial<FloorMapViewConfig> | 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,4 @@
+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/useNewReservationRoutesFromEngine.d.ts

@@ -0,0 +1,8 @@
+export declare type NewReservationRouteItem = {
+    pageName: string;
+    router: string;
+};
+/**
+ * 从引擎 app.router 筛出「新建预约」可选路由（booking_ticket / sales2 等）。
+ */
+export declare function useNewReservationRoutesFromEngine(router: unknown): NewReservationRouteItem[];

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

@@ -0,0 +1,47 @@
+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];
+/**
+ * 表格视图初始筛选项：与 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/useReservationLoadingShownDebounced.d.ts

@@ -0,0 +1,5 @@
+/**
+ * RecordBoard 的 loading：仅当 `loading` 持续超过 `reservationConstants` 中的延迟毫秒数才置为 true，
+ * 短时请求不闪遮罩；`loading` 为 false 时立即关闭。
+ */
+export declare function useReservationLoadingShownDebounced(loading: boolean): boolean;

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

@@ -7,10 +7,10 @@ export declare function useReservationScheduleDebounced(options: {
     scheduleValueProp: ReservationScheduleBandValue | undefined;
 }): {
     internalSchedule: ReservationScheduleBandValue;
-    setInternalSchedule: import("react").Dispatch<any>;
-    schedule: any;
+    setInternalSchedule: import("react").Dispatch<import("react").SetStateAction<ReservationScheduleBandValue>>;
+    schedule: ReservationScheduleBandValue;
     debouncedSchedule: ReservationScheduleBandValue;
-    scheduleRef: import("react").MutableRefObject<any>;
+    scheduleRef: import("react").MutableRefObject<ReservationScheduleBandValue>;
     flushCommittedSchedule: (next: ReservationScheduleBandValue) => void;
     queueCommittedSchedule: (next: ReservationScheduleBandValue) => void;
 };