@pisell/private-materials 6.3.137 → 6.3.138

package/lib/components/scanOrder/utils/toShoppingCartProducts.js

@@ -37,19 +37,22 @@ function getDisplayName(product) {
   const origin = (product == null ? void 0 : product._origin) || {};
   const callbackData = (origin == null ? void 0 : origin.callbackData) || {};
   const callbackOrigin = (callbackData == null ? void 0 : callbackData.origin) || {};
-  return (callbackData == null ? void 0 : callbackData.name) || (callbackData == null ? void 0 : callbackData.title) || (callbackOrigin == null ? void 0 : callbackOrigin.name) || (callbackOrigin == null ? void 0 : callbackOrigin.title) || (origin == null ? void 0 : origin.name) || (origin == null ? void 0 : origin.title) || ((_b = (_a = origin == null ? void 0 : origin.resources) == null ? void 0 : _a[0]) == null ? void 0 : _b.main_field) || ((_c = product == null ? void 0 : product.metadata) == null ? void 0 : _c.resource_name) || `Product #${product.product_id ?? "unknown"}`;
+  const sourceItem = (origin == null ? void 0 : origin.sourceItem) || {};
+  return (callbackData == null ? void 0 : callbackData.name) || (callbackData == null ? void 0 : callbackData.title) || (callbackOrigin == null ? void 0 : callbackOrigin.name) || (callbackOrigin == null ? void 0 : callbackOrigin.title) || (sourceItem == null ? void 0 : sourceItem.name) || (sourceItem == null ? void 0 : sourceItem.title) || (origin == null ? void 0 : origin.name) || (origin == null ? void 0 : origin.title) || ((_b = (_a = origin == null ? void 0 : origin.resources) == null ? void 0 : _a[0]) == null ? void 0 : _b.main_field) || ((_c = product == null ? void 0 : product.metadata) == null ? void 0 : _c.resource_name) || `Product #${product.product_id ?? "unknown"}`;
 }
 function getDisplayImage(product) {
   const origin = (product == null ? void 0 : product._origin) || {};
   const callbackData = (origin == null ? void 0 : origin.callbackData) || {};
   const callbackOrigin = (callbackData == null ? void 0 : callbackData.origin) || {};
-  return (callbackData == null ? void 0 : callbackData.image) || (callbackData == null ? void 0 : callbackData.cover) || (callbackOrigin == null ? void 0 : callbackOrigin.image) || (callbackOrigin == null ? void 0 : callbackOrigin.cover) || (origin == null ? void 0 : origin.image) || (origin == null ? void 0 : origin.cover) || "";
+  const sourceItem = (origin == null ? void 0 : origin.sourceItem) || {};
+  return (callbackData == null ? void 0 : callbackData.image) || (callbackData == null ? void 0 : callbackData.cover) || (callbackOrigin == null ? void 0 : callbackOrigin.image) || (callbackOrigin == null ? void 0 : callbackOrigin.cover) || (sourceItem == null ? void 0 : sourceItem.image) || (sourceItem == null ? void 0 : sourceItem.cover) || (origin == null ? void 0 : origin.image) || (origin == null ? void 0 : origin.cover) || "";
 }
 function getUnitPrice(product) {
-  const origin = (product == null ? void 0 : product._origin) || {};
-  const callbackData = (origin == null ? void 0 : origin.callbackData) || {};
+  var _a, _b;
+  const callbackData = ((_a = product == null ? void 0 : product._origin) == null ? void 0 : _a.callbackData) || {};
   const callbackOrigin = (callbackData == null ? void 0 : callbackData.origin) || {};
-  return toNumber(product.payment_price, NaN) || toNumber(product.selling_price, NaN) || toNumber(product.original_price, NaN) || toNumber(callbackData == null ? void 0 : callbackData.price, NaN) || toNumber(callbackOrigin == null ? void 0 : callbackOrigin.price, NaN) || toNumber(origin == null ? void 0 : origin.price, NaN) || toNumber(origin == null ? void 0 : origin.selling_price, NaN) || toNumber(origin == null ? void 0 : origin.base_price, 0);
+  const sourceItem = ((_b = product == null ? void 0 : product._origin) == null ? void 0 : _b.sourceItem) || {};
+  return toNumber(product.selling_price, NaN) || toNumber(product.original_price, NaN) || toNumber(callbackData == null ? void 0 : callbackData.price, NaN) || toNumber(callbackOrigin == null ? void 0 : callbackOrigin.price, NaN) || toNumber(sourceItem == null ? void 0 : sourceItem.price, 0);
 }
 function normalizeOptions(product) {
   var _a;

package/lib/components/scanOrder/utils/transformProductDetail.d.ts

@@ -43,9 +43,10 @@ export interface ScanOrderOrderProductInput {
         price: number;
     }>;
     product_bundle: ProductDetailBundleItem[];
+    /** 券后单品单价；初次加购由入口置为 selling_price，之后由 SDK Rules 引擎维护。 */
     selling_price: string;
+    /** 券前单品单价（店铺售价）。 */
     original_price: string;
-    payment_price: string;
     tax_fee: string;
     is_charge_tax: number;
     metadata: Record<string, any>;

package/lib/components/scanOrder/utils/transformProductDetail.js

@@ -83,14 +83,7 @@ function transformProductDetailToOrderProduct(params) {
     (payload == null ? void 0 : payload.price) ?? (payload == null ? void 0 : payload.selling_price) ?? (callbackOrigin == null ? void 0 : callbackOrigin.price) ?? (sourceItem == null ? void 0 : sourceItem.price) ?? (sourceItem == null ? void 0 : sourceItem.selling_price) ?? (sourceItem == null ? void 0 : sourceItem.base_price),
     "0.00"
   );
-  const originalPrice = toPriceString(
-    (payload == null ? void 0 : payload.original_price) ?? (callbackOrigin == null ? void 0 : callbackOrigin.original_price) ?? (sourceItem == null ? void 0 : sourceItem.original_price) ?? sellingPrice,
-    sellingPrice
-  );
-  const paymentPrice = toPriceString(
-    (payload == null ? void 0 : payload.payment_price) ?? (callbackOrigin == null ? void 0 : callbackOrigin.payment_price) ?? (sourceItem == null ? void 0 : sourceItem.payment_price) ?? sellingPrice,
-    sellingPrice
-  );
+  const originalPrice = sellingPrice;
   const taxFee = toPriceString(
     (payload == null ? void 0 : payload.tax_fee) ?? (callbackOrigin == null ? void 0 : callbackOrigin.tax_fee) ?? (sourceItem == null ? void 0 : sourceItem.tax_fee),
     "0.00"
@@ -111,7 +104,6 @@ function transformProductDetailToOrderProduct(params) {
     ),
     selling_price: sellingPrice,
     original_price: originalPrice,
-    payment_price: paymentPrice,
     tax_fee: taxFee,
     is_charge_tax: isChargeTax,
     metadata: {

package/lib/components/schedules/model.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { CalendarDataItem, ScheduleItem } from "./type";
 import dayjs from "dayjs";
 export interface FormState {
@@ -69,11 +68,4 @@ export interface FormState {
     };
     setGlobalState: Function | null;
 }
-export declare const Provider: (ComponentUi: any) => any, Context: import("react").Context<{
-    state: FormState;
-} & {
-    dispatch: (params: {
-        type: string;
-        payload: any;
-    }) => void;
-}>;
+export declare const Provider: any, Context: any;

package/lib/components/shoppingCart/components/Empty/index.d.ts

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

package/lib/components/shoppingCart/components/Render/index.d.ts

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

package/lib/components/shoppingCart/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { shoppingCartProps } from './type';
 declare const shoppingCart: ({ onCard, onAction, onChange, onAddProduct, onActiveKey, ...props }: shoppingCartProps) => JSX.Element;
 export default shoppingCart;

package/lib/components/ticketBooking/components/addServiceVariant/addService.d.ts

@@ -0,0 +1,9 @@
+import './index.less';
+interface AddServiceProps {
+    onEdit?: any;
+    dispatch?: any;
+    state?: any;
+    renderMode?: 'current' | 'drawer';
+}
+declare const AddSerivce: (props: AddServiceProps) => JSX.Element | null;
+export default AddSerivce;

package/lib/components/ticketBooking/components/addServiceVariant/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 interface AddServiceVariantProps {
     globalState: any;
     setGlobalState: any;

package/lib/components/ticketBooking/components/ticketBooking/index.d.ts

@@ -0,0 +1,4 @@
+import './index.less';
+export declare const _formatBookingDetail: (data: any, modalState: any) => any;
+declare const TicketBooking: () => JSX.Element;
+export default TicketBooking;

package/lib/components/ticketBooking/components/timeBar/index.d.ts

@@ -0,0 +1,12 @@
+import type { Dayjs } from 'dayjs';
+import './index.less';
+interface ITimeBarProps {
+    globalState: any;
+    setGlobalState: any;
+    onDateChange: (date: Dayjs, dateString?: string) => void;
+    onDateTimeChange: (date: Dayjs, timeString: string) => void;
+    setIntervalTime: (value: boolean) => void;
+    locale: string;
+}
+declare const TimeBar: (props: ITimeBarProps) => JSX.Element;
+export default TimeBar;

package/lib/components/ticketBooking/index.d.ts

@@ -0,0 +1,7 @@
+import './index.less';
+interface TicketBookingProps {
+    productExtensionType: string[];
+    bookingConfigParams: Record<string, any>;
+}
+declare const _default: (props: TicketBookingProps) => JSX.Element;
+export default _default;

package/lib/components/venueBooking/components/VenueSelection/components/TimeGrid.js

@@ -289,7 +289,7 @@ function TimeGrid() {
               symbol,
               precision: 2,
               showCurrencySymbol: true,
-              hideDecimalForWholeNumbers: false,
+              hideDecimalForWholeNumbers: true,
               className: `text-[13px] font-normal leading-4 ${priceClass} md:text-sm`
             }
           ), tag ? /* @__PURE__ */ import_react.default.createElement("div", { className: `inline-flex rounded-full px-1.5 py-0 text-[8px] font-semibold leading-4 ring-1 md:text-[9px] ${tag.className}` }, tagText) : null)

package/lib/components/venueBooking/context.js

@@ -122,6 +122,7 @@ function VenueBookingProvider({ entryContext, children }) {
   const [isSubmittingOrder, setIsSubmittingOrder] = (0, import_react.useState)(false);
   const anchorDateRef = (0, import_react.useRef)(anchorDate);
   anchorDateRef.current = anchorDate;
+  const bootstrappedRef = (0, import_react.useRef)(false);
   const canNext = (0, import_react.useMemo)(() => {
     const allSelected = (0, import_hooks.getAllSelectedSlots)(venueBookingModule);
     if (Array.isArray(allSelected) && allSelected.length > 0) return true;
@@ -303,6 +304,12 @@ function VenueBookingProvider({ entryContext, children }) {
       console.warn("[venueBooking] handleLoginSuccess failed", error);
     }
   }, [syncCustomerLoginToModule, venueBookingModule, refreshViewModel]);
+  const syncCustomerLoginRef = (0, import_react.useRef)(syncCustomerLoginToModule);
+  syncCustomerLoginRef.current = syncCustomerLoginToModule;
+  const goToNearestAvailableDateRef = (0, import_react.useRef)(goToNearestAvailableDate);
+  goToNearestAvailableDateRef.current = goToNearestAvailableDate;
+  const handleLoginSuccessRef = (0, import_react.useRef)(handleLoginSuccess);
+  handleLoginSuccessRef.current = handleLoginSuccess;
   const submitOrder = (0, import_react.useCallback)(async () => {
     var _a2, _b2, _c2;
     if (isSubmittingOrder) return;
@@ -414,7 +421,7 @@ function VenueBookingProvider({ entryContext, children }) {
     if (!pubsub) return;
     const onGlobalLoginSuccess = async (res) => {
       if (res === "success" || (res == null ? void 0 : res.status) === "success") {
-        await handleLoginSuccess();
+        await handleLoginSuccessRef.current();
       }
     };
     (_a2 = pubsub.subscribe) == null ? void 0 : _a2.call(pubsub, "pisell1.login.success", onGlobalLoginSuccess);
@@ -422,7 +429,7 @@ function VenueBookingProvider({ entryContext, children }) {
       var _a3;
       (_a3 = pubsub.unsubscribe) == null ? void 0 : _a3.call(pubsub, "pisell1.login.success", onGlobalLoginSuccess);
     };
-  }, [utils == null ? void 0 : utils.pubsub, handleLoginSuccess]);
+  }, [utils == null ? void 0 : utils.pubsub]);
   (0, import_react.useEffect)(() => {
     if (!venueBookingModule) return;
     setIsGridTransition(true);
@@ -463,15 +470,16 @@ function VenueBookingProvider({ entryContext, children }) {
     };
   }, [pisellOS, venueBookingModule]);
   (0, import_react.useEffect)(() => {
-    if (!venueBookingModule) return;
+    if (bootstrappedRef.current || !venueBookingModule) return;
+    bootstrappedRef.current = true;
     let unmounted = false;
     const bootstrap = async () => {
       try {
         setIsLoading(true);
-        await syncCustomerLoginToModule();
+        await syncCustomerLoginRef.current();
         await (0, import_hooks.loadVenueProducts)(venueBookingModule, import_hooks.VENUE_PRODUCT_IDS);
         const venueProducts = typeof (venueBookingModule == null ? void 0 : venueBookingModule.getVenueProducts) === "function" ? venueBookingModule.getVenueProducts() : [];
-        await goToNearestAvailableDate(anchorDateRef.current);
+        await goToNearestAvailableDateRef.current(anchorDateRef.current);
         const moduleData = (0, import_hooks.createVenueBookingViewModel)(venueBookingModule);
         if (!unmounted) {
           setViewModel((prev) => ({
@@ -506,7 +514,7 @@ function VenueBookingProvider({ entryContext, children }) {
     return () => {
       unmounted = true;
     };
-  }, [venueBookingModule, entryContext == null ? void 0 : entryContext.biz, entryContext == null ? void 0 : entryContext.resource_id, syncCustomerLoginToModule, goToNearestAvailableDate]);
+  }, [venueBookingModule]);
   const value = (0, import_react.useMemo)(() => ({
     venueBookingModule,
     currentStep,

package/lib/index.d.ts

@@ -0,0 +1,87 @@
+export { default as Login } from './components/login';
+export type { LoginProps } from './components/login';
+export { default as BookingInfo } from './components/booking/info/index';
+export { default as BookingNotes } from './components/booking/notes';
+export { default as BookingAddons } from './components/booking/addons';
+export { default as BookingForms } from './components/booking/forms';
+export { default as BookingPayment } from './components/booking/payments';
+export { default as Booking } from './components/booking';
+export { default as Schedules } from './components/schedules';
+export { default as BookingResources } from './components/booking/materiels/resources';
+export { default as BookingStartTime } from './components/booking/materiels/startTime';
+export { default as BookingDuration } from './components/booking/materiels/duration';
+export { default as BookingContacts } from './components/booking/materiels/contacts';
+export { VerticalClient } from './components/booking/info/clientVariant';
+export { default as VerticalAddService } from './components/booking/info/addServiceVariant';
+export { default as ProductExtension } from './components/productExtension';
+export { default as BookingDeposit } from './components/booking/deposit';
+export { default as WorkspaceList } from './components/workSpaceList';
+export { default as WorkspaceListDetail } from './components/workSpaceListDetail';
+export { default as RuleSetting } from './components/ruleSetting';
+export { default as TaxSelect } from './components/taxSelect';
+export { default as EftposPay } from './components/eftposPay';
+export { default as ToCPay } from './components/pay/toC';
+export { default as Eftpos } from './components/eftpos';
+export { default as WalletList } from './components/walletList';
+export { default as BookingDashboard } from './components/booking/dashboard';
+export { default as PisellSelectCustomerModal } from './components/pisellSelectCustomerModal';
+export { default as EventBooking } from './components/eventBooking';
+export { default as EventCard } from './components/eventBooking/components/eventCard';
+export { default as EventResourceDisplay } from './components/eventBooking/components/resourceDisplay';
+export { default as EventResourceUsability } from './components/eventBooking/components/resourceUsability';
+export { default as EventProductCard } from './components/eventBooking/components/productCard';
+export { default as EventTimeResourceSelector } from './components/eventBooking/components/timeResourceSelector';
+export { default as EventSelectHolder } from './components/eventBooking/components/selectHolder';
+export { default as EventBookingServiceList } from './components/eventBooking/components/bookingServiceList';
+export { default as EventBookingAvailabilityCalendar } from './components/eventBooking/components/bookingAvailabilityCalendar';
+export { default as EventScheduleCalendar } from './components/eventBooking/components/scheduleCalendar';
+export { default as EventBookingDetailModal } from './components/eventBooking/components/bookingDetailModal';
+export { default as EventProgressBar } from './components/eventBooking/components/progressBar';
+export { default as ShoppingCart } from './components/shoppingCart';
+export { default as AppointmentBooking } from './components/appointmentBooking';
+export { default as AppointmentDeposit } from './components/appointmentBooking/deposit';
+export { default as TicketBooking } from './components/ticketBooking';
+export { default as ScanOrder } from './components/scanOrder';
+export { default as VenueBooking } from './components/venueBooking';
+export type { ScanOrderProps } from './components/scanOrder';
+export { default as SubTotal } from './components/subTotal';
+export { default as EditBookingModal } from './components/booking/editBookingModal';
+export { default as StepController } from './components/stepController';
+export { default as ClientCard } from './plus/clientCard';
+export { default as ClientSearch } from './plus/clinetSearch';
+export { default as ComprehensiveSearch } from './pro/comprehensiveSearch';
+export { default as SaasLogin } from './plus/saasLogin';
+export { default as SaasRegister } from './plus/saasRegister';
+export { default as SaasCreateOrganization } from './plus/saasCreateOrganization';
+export { default as PinModal } from './components/pinModal';
+export { default as PinVerifyModal } from './components/pinVerifyModal';
+export { OAuthConfig, SaaSAdminAuth, OrgAdminAuth, CustomerAuth, CustomerOAuthConfig, DeviceAuth, POSOperatorAuth, OnlineShopAuth, SaaSManagermentAuth, } from './components/authentication/admin';
+export type { SaaSAdminAuthProps, OrgAdminAuthProps, DeviceAuthProps, POSOperatorAuthProps, CustomerOAuthConfigProps, } from './components/authentication/admin';
+export { default as ContactInfo } from './plus/contactInfo';
+export { default as ContactInfoModal } from './plus/contactInfoModal';
+export { Login2, Register2, AuthModal } from './pro/Login2.0';
+export { default as WalletEditor } from './plus/walletEditor';
+export { default as WalletPassGallery } from './plus/walletPassGallery';
+export { default as WalletPassDetail } from './plus/walletPassGallery/components/passDetail';
+export { default as SelectHolder } from './plus/selectHolder';
+export { default as HolderList } from './plus/selectHolder/components/HolderList';
+export { default as SettingsRegistry } from './components/systemSettings/registry';
+export { default as SaasRole } from './plus/saasRole';
+export { default as SaasTeamMembers } from './plus/saasTeamMembers';
+export type { SaasTeamMembersProps } from './plus/saasTeamMembers/type';
+export { default as KioskSkuDetail } from './components/kioskSkuDetail';
+export { default as ProNumberSelector } from './pro/pisellNumberSelector';
+export { default as SKUOptionsSelection } from './plus/skuOptionsSelection';
+export { default as SaasAttendance } from './plus/saasAttendance';
+export { default as Selector } from './pro/Selector';
+export { default as PisellSalesGrid } from './plus/pisellSalesGrid';
+export { PisellReservationCore, PisellReservationBookingPage, PisellReservation, PisellVenueControlPage, default, } from './plus/pisellReservation';
+export type { FloorMapBookingClickArgs, FloorMapBookingClickMode, PisellReservationProps, PisellReservationTableRow, } from './plus/pisellReservation';
+export { defaultReservationTableRows, getDefaultReservationFloorMapConfig, } from './plus/pisellReservation';
+export { default as EcoCupProject } from './components/ecocup/cupProject';
+export { default as EcoCupList } from './components/ecocup/cupList';
+export { default as EcoCustomerList } from './components/ecocup/customerList';
+export { default as OrderList } from './plus/orderList';
+export { default as pisellSalesManagement } from './plus/pisellSalesManagement';
+export { PisellFinancialSummary, financialSummaryLocales } from './plus/pisellFinancialSummary';
+export type { PisellFinancialSummaryProps, FinancialSummaryData, FinancialSummaryLineItem, FinancialSummaryPaymentItem, FinancialSummaryRefundItem, FinancialSummaryTotalBlock, FinancialSummaryAmountFormatOptions, } from './plus/pisellFinancialSummary';

package/lib/plus/clinetSearch/Add/PhoneField/index.d.ts

@@ -1,2 +1,3 @@
+/// <reference types="react" />
 declare const PhoneField: ({ value, onChange }: any) => JSX.Element;
 export default PhoneField;

package/lib/plus/pisellSalesManagement/config/booking.d.ts

@@ -20,7 +20,7 @@ export declare const getFilterButtonList: () => ({
         }[];
         minInputNumberProps?: undefined;
         maxInputNumberProps?: undefined;
-        readonly component?: undefined;
+        component?: undefined;
         isSearchServer?: undefined;
         showSearch?: undefined;
         showTime?: undefined;
@@ -46,7 +46,7 @@ export declare const getFilterButtonList: () => ({
         mode?: undefined;
         maxTagCount?: undefined;
         options?: undefined;
-        readonly component?: undefined;
+        component?: undefined;
         isSearchServer?: undefined;
         showSearch?: undefined;
         showTime?: undefined;
@@ -91,7 +91,7 @@ export declare const getFilterButtonList: () => ({
         options: () => Promise<any>;
         minInputNumberProps?: undefined;
         maxInputNumberProps?: undefined;
-        readonly component?: undefined;
+        component?: undefined;
         isSearchServer?: undefined;
         showSearch?: undefined;
         showTime?: undefined;
@@ -111,7 +111,7 @@ export declare const getFilterButtonList: () => ({
         options?: undefined;
         minInputNumberProps?: undefined;
         maxInputNumberProps?: undefined;
-        readonly component?: undefined;
+        component?: undefined;
         isSearchServer?: undefined;
         showSearch?: undefined;
         showTime?: undefined;
@@ -133,7 +133,7 @@ export declare const getFilterButtonList: () => ({
         maxTagCount?: undefined;
         minInputNumberProps?: undefined;
         maxInputNumberProps?: undefined;
-        readonly component?: undefined;
+        component?: undefined;
         showTime?: undefined;
     };
     sort?: undefined;
@@ -152,7 +152,7 @@ export declare const getFilterButtonList: () => ({
         options?: undefined;
         minInputNumberProps?: undefined;
         maxInputNumberProps?: undefined;
-        readonly component?: undefined;
+        component?: undefined;
         isSearchServer?: undefined;
         showSearch?: undefined;
     };

package/lib/plus/pisellSalesProductCard/index.js

@@ -181,6 +181,16 @@ var PisellSalesProductCard = ({
         max: cardMaxQuantity,
         step: (stepperProps == null ? void 0 : stepperProps.step) ?? 1,
         disabled: mergedDisabled,
+        onLimitExceeded: (limitMeta) => {
+          const raw = stepperProps == null ? void 0 : stepperProps.limitMessage;
+          const limitMsg = typeof raw === "string" ? { max: raw } : raw || {};
+          const content = limitMeta.reason === "max" ? limitMsg.max : limitMsg.min;
+          if (!content) return;
+          (0, import_materials.PisellToast)({
+            content,
+            duration: 2
+          });
+        },
         onChange: (next, stepperMeta) => {
           const safeNext = Math.max(
             (stepperProps == null ? void 0 : stepperProps.min) ?? 0,

package/lib/plus/pisellSalesProductCard/types.d.ts

@@ -1,6 +1,26 @@
 /// <reference types="react" />
 import type { BundleGroupItem, BundleItem, OptionGroupItem, SkuCardConfig, VariantProductItem, VariantGroupItem } from '../skuOptionsSelection/types';
 import type { NumericStepperProps } from '../../pro/NumericStepper/index';
+/**
+ * 达到 min / max 限制时希望展示的提示文案。
+ * 通常来自 item_rule_limit.maxValidationMessage / minValidationMessage。
+ * 对应字段为空时该方向不 toast（仍会走 locales 里的默认兑底，详见 PisellSalesProductCard）。
+ */
+export interface SalesProductLimitMessage {
+    max?: string;
+    min?: string;
+}
+/**
+ * 商品卡使用的 stepper 配置，在 NumericStepperProps 基础上扩展业务字段。
+ */
+export declare type SalesProductStepperProps = NumericStepperProps & {
+    /**
+     * 达到限制时希望展示的提示文案。支持：
+     * - string：等价于 { max: string }（兼容旧用法）；
+     * - { min?, max? }：min / max 分开配置。
+     */
+    limitMessage?: string | SalesProductLimitMessage;
+};
 export declare type SalesProductText = string | Record<string, string>;
 /**
  * 从 SKUOptionsSelection 数据结构反推的完整商品定义。
@@ -103,7 +123,7 @@ export interface PisellSalesProductCardProps {
     /** PRD products[i] value，组件会基于它进行增量更新并回传 */
     value?: Partial<SalesProductValue>;
     disabled?: boolean;
-    stepperProps?: NumericStepperProps;
+    stepperProps?: SalesProductStepperProps;
     optionsText?: string;
     skuCardConfig?: SkuCardConfig;
     cartElementId?: string;

package/lib/plus/productSelect/ProductCard/ProductCardV2.js

@@ -48,7 +48,7 @@ var ProductCardV2 = (0, import_react.memo)(
     decorateConfig = {},
     cartElementId
   }) => {
-    var _a, _b;
+    var _a, _b, _c, _d, _e;
     const { __typename } = item;
     if (__typename === "category") {
       return /* @__PURE__ */ import_react.default.createElement(
@@ -74,7 +74,11 @@ var ProductCardV2 = (0, import_react.memo)(
         product: item,
         stepperProps: {
           min: (_a = item == null ? void 0 : item.item_rule_limit) == null ? void 0 : _a.min,
-          max: (_b = item == null ? void 0 : item.item_rule_limit) == null ? void 0 : _b.max
+          max: (_b = item == null ? void 0 : item.item_rule_limit) == null ? void 0 : _b.remainingMax,
+          limitMessage: {
+            max: ((_c = item == null ? void 0 : item.item_rule_limit) == null ? void 0 : _c.maxValidationMessage) ?? ((_d = item == null ? void 0 : item.item_rule_limit) == null ? void 0 : _d.validationMessage),
+            min: (_e = item == null ? void 0 : item.item_rule_limit) == null ? void 0 : _e.minValidationMessage
+          }
         },
         value: itemValue,
         skuCardConfig: {

package/lib/plus/skuOptionsSelection/components/NormalCard/index.d.ts

@@ -0,0 +1,5 @@
+import { RenderItemProps } from '../../../../pro/Selector/types';
+declare const NormalCard: (props: RenderItemProps & {
+    parentDataSource: any;
+}) => JSX.Element;
+export default NormalCard;

package/lib/plus/skuOptionsSelection/components/OptionsCard/OptionItemCard.d.ts

@@ -0,0 +1,3 @@
+import './index.less';
+declare const OptionItemCard: (props: any) => JSX.Element;
+export default OptionItemCard;

package/lib/plus/skuOptionsSelection/components/OptionsModal/index.d.ts

@@ -0,0 +1,15 @@
+interface OptionsModalProps {
+    parentDataSource: any;
+    dataSource: any;
+    modalDataSource: any;
+    values: any;
+    optionItemValue?: any;
+    modalValue: any;
+    remainingCount: number;
+    open: boolean;
+    title: string;
+    onCancel: () => void;
+    onConfirm: (v: any) => void;
+}
+declare const OptionsModal: (props: OptionsModalProps) => JSX.Element;
+export default OptionsModal;

package/lib/plus/skuOptionsSelection/index.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { IProps } from './types';
+import './index.less';
+declare const SKUOptionsSelection: React.ForwardRefExoticComponent<IProps & React.RefAttributes<unknown>>;
+export default SKUOptionsSelection;

package/lib/plus/skuOptionsSelection/locales.d.ts

@@ -0,0 +1,58 @@
+declare const _default: {
+    en: {
+        'pisell2.skuOptionsSelection.title': string;
+        'pisell2.skuOptionsSelection.titleExtra.alreadySelected': string;
+        'pisell2.skuOptionsSelection.titleExtra.totalPrice': string;
+        'pisell2.skuOptionsSelection.optionItemCard.editSelections': string;
+        'pisell2.skuOptionsSelection.variantItemCard.soldOut': string;
+        'pisell2.skuOptionsSelection.variantItemCard.price': string;
+        'pisell2.skuOptionsSelection.optionItemCard.typeText': string;
+        'pisell2.skuOptionsSelection.optionItemCard.overSelected': string;
+        'pisell2.skuOptionsSelection.optionItemCard.confirm': string;
+    };
+    'zh-CN': {
+        'pisell2.skuOptionsSelection.title': string;
+        'pisell2.skuOptionsSelection.titleExtra.alreadySelected': string;
+        'pisell2.skuOptionsSelection.titleExtra.totalPrice': string;
+        'pisell2.skuOptionsSelection.optionItemCard.editSelections': string;
+        'pisell2.skuOptionsSelection.variantItemCard.soldOut': string;
+        'pisell2.skuOptionsSelection.variantItemCard.price': string;
+        'pisell2.skuOptionsSelection.optionItemCard.typeText': string;
+        'pisell2.skuOptionsSelection.optionItemCard.overSelected': string;
+        'pisell2.skuOptionsSelection.optionItemCard.confirm': string;
+    };
+    'zh-HK': {
+        'pisell2.skuOptionsSelection.title': string;
+        'pisell2.skuOptionsSelection.titleExtra.alreadySelected': string;
+        'pisell2.skuOptionsSelection.titleExtra.totalPrice': string;
+        'pisell2.skuOptionsSelection.optionItemCard.editSelections': string;
+        'pisell2.skuOptionsSelection.variantItemCard.soldOut': string;
+        'pisell2.skuOptionsSelection.variantItemCard.price': string;
+        'pisell2.skuOptionsSelection.optionItemCard.typeText': string;
+        'pisell2.skuOptionsSelection.optionItemCard.overSelected': string;
+        'pisell2.skuOptionsSelection.optionItemCard.confirm': string;
+    };
+    ja: {
+        'pisell2.skuOptionsSelection.title': string;
+        'pisell2.skuOptionsSelection.titleExtra.alreadySelected': string;
+        'pisell2.skuOptionsSelection.titleExtra.totalPrice': string;
+        'pisell2.skuOptionsSelection.optionItemCard.editSelections': string;
+        'pisell2.skuOptionsSelection.variantItemCard.soldOut': string;
+        'pisell2.skuOptionsSelection.variantItemCard.price': string;
+        'pisell2.skuOptionsSelection.optionItemCard.typeText': string;
+        'pisell2.skuOptionsSelection.optionItemCard.overSelected': string;
+        'pisell2.skuOptionsSelection.optionItemCard.confirm': string;
+    };
+    pt: {
+        'pisell2.skuOptionsSelection.title': string;
+        'pisell2.skuOptionsSelection.titleExtra.alreadySelected': string;
+        'pisell2.skuOptionsSelection.titleExtra.totalPrice': string;
+        'pisell2.skuOptionsSelection.optionItemCard.editSelections': string;
+        'pisell2.skuOptionsSelection.variantItemCard.soldOut': string;
+        'pisell2.skuOptionsSelection.variantItemCard.price': string;
+        'pisell2.skuOptionsSelection.optionItemCard.typeText': string;
+        'pisell2.skuOptionsSelection.optionItemCard.overSelected': string;
+        'pisell2.skuOptionsSelection.optionItemCard.confirm': string;
+    };
+};
+export default _default;