@pisell/private-materials 6.12.356 → 6.12.357

package/lib/components/venueBooking/components/Cart/index.js

@@ -3,7 +3,10 @@ const require_useEngineContext = require("../../../../hooks/useEngineContext.js"
 const require_objectSpread2 = require("../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js");
 const require_asyncToGenerator = require("../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js");
 const require_index = require("../../../shoppingCart/index.js");
+const require_holderConfig = require("../../../../utils/holderConfig.js");
+const require_utils = require("../../../appointmentBooking/utils.js");
 const require_index$1 = require("../../../subTotal/index.js");
+const require_buildCartHolderParams = require("../../../../utils/buildCartHolderParams.js");
 const require_orderProductIdentity = require("../../utils/orderProductIdentity.js");
 const require_context = require("../../context.js");
 const require_index$2 = require("../Voucher/index.js");
@@ -21,24 +24,65 @@ require("./index.less");
 * 支持两种模式：embedded（桌面端内嵌）和 drawer（移动端抽屉弹出）
 */
 function Cart(props) {
-	var _engineContext$appHel, _engineContext$appHel2, _engineContext$appHel3, _engineContext$engine, _businessUtils$getApp, _businessUtils$getApp2, _ref, _ref2, _ref3, _summary$total_amount, _summary$deposit3;
+	var _engineContext$appHel, _engineContext$appHel2, _engineContext$appHel3, _engineContext$engine, _engineContext$appHel4, _businessUtils$getApp, _businessUtils$getApp2, _ref, _ref2, _ref3, _summary$total_amount, _summary$deposit3;
 	const { open, onCancel, onNext, items, summary, embedded = false, confirmLoading = false, extraContent } = props;
-	const { currentStep, runModuleAction, refreshViewModel, refreshTimeSlotGrid, venueBookingModule, isAgreeDepositPolicy, setIsAgreeDepositPolicy } = require_context.useVenueBookingContext();
+	const { currentStep, runModuleAction, refreshViewModel, refreshTimeSlotGrid, venueBookingModule, isAgreeDepositPolicy, setIsAgreeDepositPolicy, isLoading, isLogin } = require_context.useVenueBookingContext();
 	const engineContext = require_useEngineContext.default();
 	const businessUtils = engineContext === null || engineContext === void 0 || (_engineContext$appHel = engineContext.appHelper) === null || _engineContext$appHel === void 0 || (_engineContext$appHel = _engineContext$appHel.utils) === null || _engineContext$appHel === void 0 ? void 0 : _engineContext$appHel.businessUtils;
 	const symbol = String((engineContext === null || engineContext === void 0 || (_engineContext$appHel2 = engineContext.appHelper) === null || _engineContext$appHel2 === void 0 || (_engineContext$appHel2 = _engineContext$appHel2.utils) === null || _engineContext$appHel2 === void 0 || (_engineContext$appHel3 = _engineContext$appHel2.getSymbolic) === null || _engineContext$appHel3 === void 0 ? void 0 : _engineContext$appHel3.call(_engineContext$appHel2)) || "$");
 	const locale = (engineContext === null || engineContext === void 0 || (_engineContext$engine = engineContext.engine) === null || _engineContext$engine === void 0 || (_engineContext$engine = _engineContext$engine.props) === null || _engineContext$engine === void 0 ? void 0 : _engineContext$engine.locale) || "en";
+	const [holderMap, setHolderMap] = (0, react.useState)({});
+	const { pisellos, translation } = (engineContext === null || engineContext === void 0 || (_engineContext$appHel4 = engineContext.appHelper) === null || _engineContext$appHel4 === void 0 ? void 0 : _engineContext$appHel4.utils) || {};
 	const hasGoodPassApp = !!(businessUtils === null || businessUtils === void 0 || (_businessUtils$getApp = businessUtils.getAppByModal) === null || _businessUtils$getApp === void 0 ? void 0 : _businessUtils$getApp.call(businessUtils, "goodpass"));
 	const hasDiscountCardApp = !!(businessUtils === null || businessUtils === void 0 || (_businessUtils$getApp2 = businessUtils.getAppByModal) === null || _businessUtils$getApp2 === void 0 ? void 0 : _businessUtils$getApp2.call(businessUtils, "discountcard"));
 	const showVoucher = hasGoodPassApp || hasDiscountCardApp;
+	(0, react.useEffect)(() => {
+		var _pisellos$effects;
+		const onHolderChanged = (res) => {
+			if ((res === null || res === void 0 ? void 0 : res.path) === "holderMap") setHolderMap(res === null || res === void 0 ? void 0 : res.value);
+		};
+		pisellos === null || pisellos === void 0 || (_pisellos$effects = pisellos.effects) === null || _pisellos$effects === void 0 || _pisellos$effects.on("venueBooking_holder:changed", onHolderChanged);
+		return () => {
+			var _pisellos$effects2;
+			pisellos === null || pisellos === void 0 || (_pisellos$effects2 = pisellos.effects) === null || _pisellos$effects2 === void 0 || _pisellos$effects2.off("venueBooking_holder:changed", onHolderChanged);
+		};
+	}, [pisellos]);
+	(0, react.useEffect)(() => {
+		if (isLoading || !venueBookingModule) return;
+		try {
+			var _venueBookingModule$g;
+			setHolderMap(((_venueBookingModule$g = venueBookingModule.getHolderFormMap) === null || _venueBookingModule$g === void 0 ? void 0 : _venueBookingModule$g.call(venueBookingModule)) || {});
+		} catch (error) {
+			console.warn("[venueBooking] Holder data is not ready", error);
+			setHolderMap({});
+		}
+	}, [venueBookingModule, isLoading]);
 	const isVisible = embedded || open;
 	const totalAmount = (_ref = (_ref2 = (_ref3 = (_summary$total_amount = summary === null || summary === void 0 ? void 0 : summary.total_amount) !== null && _summary$total_amount !== void 0 ? _summary$total_amount : summary === null || summary === void 0 ? void 0 : summary.expect_amount) !== null && _ref3 !== void 0 ? _ref3 : summary === null || summary === void 0 ? void 0 : summary.amount) !== null && _ref2 !== void 0 ? _ref2 : summary === null || summary === void 0 ? void 0 : summary.total) !== null && _ref !== void 0 ? _ref : "0.00";
 	const cartProducts = (0, react.useMemo)(() => {
-		return (items || []).map((item) => require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, item), {}, {
-			symbol: (item === null || item === void 0 ? void 0 : item.symbol) || symbol,
-			is_hide_like: true
-		}));
-	}, [items, symbol]);
+		return (items || []).map((item) => {
+			var _item$_origin, _engineContext$appHel5;
+			const holderConfig = require_buildCartHolderParams.getVenueCartHolderConfig(item);
+			const holderParams = require_buildCartHolderParams.buildCartHolderParams({
+				item,
+				holderConfig,
+				formData: require_holderConfig.isHolderConfigEnabled(holderConfig) ? holderMap === null || holderMap === void 0 ? void 0 : holderMap[holderConfig === null || holderConfig === void 0 ? void 0 : holderConfig.resource_id] : {},
+				translation,
+				enabled: !!(item === null || item === void 0 || (_item$_origin = item._origin) === null || _item$_origin === void 0 || (_item$_origin = _item$_origin.product) === null || _item$_origin === void 0 ? void 0 : _item$_origin.bookingUuid),
+				utils: engineContext === null || engineContext === void 0 || (_engineContext$appHel5 = engineContext.appHelper) === null || _engineContext$appHel5 === void 0 ? void 0 : _engineContext$appHel5.utils
+			});
+			return require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, item), {}, {
+				symbol: (item === null || item === void 0 ? void 0 : item.symbol) || symbol,
+				is_hide_like: true,
+				allowClearHolder: true
+			}, holderParams);
+		});
+	}, [
+		items,
+		symbol,
+		holderMap,
+		translation
+	]);
 	const confirmOrderText = currentStep === "checkout" ? String(_pisell_utils.locales.getText("pisell2.venue.action.pay.now") || "立即支付") : String(_pisell_utils.locales.getText("pisell2.venue.action.next") || "下一步");
 	/**
 	* SubTotal 金额明细列表
@@ -46,12 +90,12 @@ function Cart(props) {
 	* surcharges 为服务费列表，label 支持多语言对象，按当前 locale 取值
 	*/
 	const subTotalList = (0, react.useMemo)(() => {
-		var _summary$product_amou, _summary$tax_fee, _ref4, _summary$total_amount2, _summary$deposit, _venueBookingModule$g, _tempSummary$is_price, _summary$deposit$tota, _summary$deposit2;
+		var _summary$product_amou, _summary$tax_fee, _ref4, _summary$total_amount2, _summary$deposit, _venueBookingModule$g2, _tempSummary$is_price, _summary$deposit$tota, _summary$deposit2;
 		const subTotal = Number((_summary$product_amou = summary === null || summary === void 0 ? void 0 : summary.product_amount) !== null && _summary$product_amou !== void 0 ? _summary$product_amou : 0);
 		const totalTaxFee = Number((_summary$tax_fee = summary === null || summary === void 0 ? void 0 : summary.tax_fee) !== null && _summary$tax_fee !== void 0 ? _summary$tax_fee : 0);
 		const total = Number((_ref4 = (_summary$total_amount2 = summary === null || summary === void 0 ? void 0 : summary.total_amount) !== null && _summary$total_amount2 !== void 0 ? _summary$total_amount2 : summary === null || summary === void 0 ? void 0 : summary.expect_amount) !== null && _ref4 !== void 0 ? _ref4 : 0);
 		const hasDeposit = !!(summary === null || summary === void 0 || (_summary$deposit = summary.deposit) === null || _summary$deposit === void 0 ? void 0 : _summary$deposit.hasDeposit);
-		const tempOrder = venueBookingModule === null || venueBookingModule === void 0 || (_venueBookingModule$g = venueBookingModule.getTempOrder) === null || _venueBookingModule$g === void 0 ? void 0 : _venueBookingModule$g.call(venueBookingModule);
+		const tempOrder = venueBookingModule === null || venueBookingModule === void 0 || (_venueBookingModule$g2 = venueBookingModule.getTempOrder) === null || _venueBookingModule$g2 === void 0 ? void 0 : _venueBookingModule$g2.call(venueBookingModule);
 		const tempSummary = (tempOrder === null || tempOrder === void 0 ? void 0 : tempOrder.summary) || {};
 		const taxTitle = String((tempSummary === null || tempSummary === void 0 ? void 0 : tempSummary.tax_title) || (summary === null || summary === void 0 ? void 0 : summary.tax_title) || "GST/Tax");
 		const rawTaxRate = Number(tempSummary === null || tempSummary === void 0 ? void 0 : tempSummary.tax_rate);
@@ -113,7 +157,57 @@ function Cart(props) {
 		return false;
 	};
 	const handleCartChange = function() {
-		var _ref5 = require_asyncToGenerator._asyncToGenerator(function* (item, type, sourceItem) {
+		var _ref6 = require_asyncToGenerator._asyncToGenerator(function* (item, type, sourceItem) {
+			if (type === "add_holder") {
+				var _engineContext$appHel6;
+				const holderConfig = require_buildCartHolderParams.getVenueCartHolderConfig(item);
+				if (!require_holderConfig.isHolderConfigEnabled(holderConfig)) return;
+				const formId = holderConfig === null || holderConfig === void 0 ? void 0 : holderConfig.resource_id;
+				if (!formId) return;
+				const skuRelationFormId = require_buildCartHolderParams.getSkuRelationFormId(holderMap, formId);
+				return require_utils.openForm({
+					form_id: skuRelationFormId || formId,
+					title: _pisell_utils.locales.getText("pisell2.venue.create.form"),
+					utils: engineContext === null || engineContext === void 0 || (_engineContext$appHel6 = engineContext.appHelper) === null || _engineContext$appHel6 === void 0 ? void 0 : _engineContext$appHel6.utils,
+					callback: function() {
+						var _ref5 = require_asyncToGenerator._asyncToGenerator(function* (res) {
+							if ((res === null || res === void 0 ? void 0 : res.status) === "success") {
+								var _engineContext$appHel7, _engineContext$appHel8, _item$_origin2;
+								const { formRecordId, formId: holderFormId } = require_buildCartHolderParams.handleCartHolderFormSuccess({
+									res,
+									formId,
+									skuRelationFormId,
+									utils: engineContext === null || engineContext === void 0 || (_engineContext$appHel7 = engineContext.appHelper) === null || _engineContext$appHel7 === void 0 ? void 0 : _engineContext$appHel7.utils,
+									module: venueBookingModule
+								});
+								const customer = require_utils.getCustomer(engineContext === null || engineContext === void 0 || (_engineContext$appHel8 = engineContext.appHelper) === null || _engineContext$appHel8 === void 0 ? void 0 : _engineContext$appHel8.utils);
+								venueBookingModule.setBookingHolder(item === null || item === void 0 || (_item$_origin2 = item._origin) === null || _item$_origin2 === void 0 || (_item$_origin2 = _item$_origin2.product) === null || _item$_origin2 === void 0 ? void 0 : _item$_origin2.bookingUuid, {
+									customer_id: customer === null || customer === void 0 ? void 0 : customer.id,
+									form_id: holderFormId,
+									form_record: [formRecordId]
+								});
+								yield refreshViewModel();
+							}
+						});
+						return function callback(_x) {
+							return _ref5.apply(this, arguments);
+						};
+					}()
+				});
+			}
+			if (type === "change_holder") {
+				var _engineContext$appHel9, _item$_origin3;
+				const customer = require_utils.getCustomer(engineContext === null || engineContext === void 0 || (_engineContext$appHel9 = engineContext.appHelper) === null || _engineContext$appHel9 === void 0 ? void 0 : _engineContext$appHel9.utils);
+				const holder = (sourceItem === null || sourceItem === void 0 ? void 0 : sourceItem._origin) || sourceItem;
+				const params = !sourceItem ? null : {
+					customer_id: customer === null || customer === void 0 ? void 0 : customer.id,
+					form_id: holder === null || holder === void 0 ? void 0 : holder.form_id,
+					form_record: [holder === null || holder === void 0 ? void 0 : holder.form_record_id]
+				};
+				venueBookingModule.setBookingHolder(item === null || item === void 0 || (_item$_origin3 = item._origin) === null || _item$_origin3 === void 0 || (_item$_origin3 = _item$_origin3.product) === null || _item$_origin3 === void 0 ? void 0 : _item$_origin3.bookingUuid, params);
+				yield refreshViewModel();
+				return;
+			}
 			if (type !== "delete") return;
 			const targetItem = sourceItem && typeof sourceItem === "object" ? sourceItem : item;
 			if (currentStep !== "select-venue" && isVenueBookingCartItem(targetItem)) {
@@ -139,8 +233,8 @@ function Cart(props) {
 				});
 			}
 		});
-		return function handleCartChange(_x, _x2, _x3) {
-			return _ref5.apply(this, arguments);
+		return function handleCartChange(_x2, _x3, _x4) {
+			return _ref6.apply(this, arguments);
 		};
 	}();
 	(0, react.useEffect)(() => {
@@ -156,9 +250,9 @@ function Cart(props) {
 			isShowNote: false,
 			isShowDelete: true,
 			isShowPackageNote: false,
-			isShowChangeHolder: false,
-			isShowHolder: false,
-			isShowAddHolderButton: false
+			isShowChangeHolder: currentStep === "checkout" ? false : !!isLogin,
+			isShowHolder: true,
+			isShowAddHolderButton: true
 		},
 		platform: "h5",
 		emptyText: _pisell_utils.locales.getText("pisell2.venue.cart.empty"),
@@ -174,8 +268,8 @@ function Cart(props) {
 		isAgreePolicy: isAgreeDepositPolicy,
 		onChange: setIsAgreeDepositPolicy,
 		getProtocol: (id) => {
-			var _venueBookingModule$g2;
-			return venueBookingModule === null || venueBookingModule === void 0 || (_venueBookingModule$g2 = venueBookingModule.getProtocol) === null || _venueBookingModule$g2 === void 0 ? void 0 : _venueBookingModule$g2.call(venueBookingModule, id);
+			var _venueBookingModule$g3;
+			return venueBookingModule === null || venueBookingModule === void 0 || (_venueBookingModule$g3 = venueBookingModule.getProtocol) === null || _venueBookingModule$g3 === void 0 ? void 0 : _venueBookingModule$g3.call(venueBookingModule, id);
 		}
 	}) : null), extraContent ? /* @__PURE__ */ react.default.createElement("div", { className: "pisell-venue-booking-cart-extra-content" }, extraContent) : null);
 	if (embedded) return /* @__PURE__ */ react.default.createElement(react.default.Fragment, null, cartListContent, /* @__PURE__ */ react.default.createElement("div", { className: "pisell-venue-booking-cart-embedded-footer" }, cartSummaryContent, /* @__PURE__ */ react.default.createElement(_pisell_materials.Button, {

package/lib/components/venueBooking/context.js

@@ -2,6 +2,7 @@ const require_runtime = require("../../_virtual/_rolldown/runtime.js");
 const require_useEngineContext = require("../../hooks/useEngineContext.js");
 const require_objectSpread2 = require("../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js");
 const require_asyncToGenerator = require("../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js");
+const require_buildCartHolderParams = require("../../utils/buildCartHolderParams.js");
 const require_hooks = require("./hooks.js");
 const require_utils = require("./utils.js");
 let dayjs = require("dayjs");
@@ -504,13 +505,23 @@ function VenueBookingProvider({ entryContext, children }) {
 			} });
 			return;
 		}
+		if (currentStep === "addons") {
+			const { hasError } = require_buildCartHolderParams.validateRequiredCartHolders({
+				items: viewModel.cartItems,
+				getHolderConfig: require_buildCartHolderParams.getVenueCartHolderConfig
+			});
+			if (hasError) return;
+		}
 		goToStep("checkout");
 	}, [
 		isLogin,
 		openLoginModal,
 		handleLoginSuccess,
 		goToStep,
-		venueBookingModule
+		venueBookingModule,
+		currentStep,
+		viewModel.cartItems,
+		require_buildCartHolderParams.getVenueCartHolderConfig
 	]);
 	/** 主操作按钮行为（含登录门禁，自适应 2/3 步流程） */
 	const handlePrimaryAction = (0, react.useCallback)(() => {
@@ -546,9 +557,9 @@ function VenueBookingProvider({ entryContext, children }) {
 		isAgreeDepositPolicy,
 		viewModel.summary,
 		stepList,
-		proceedToCheckout,
 		goToStep,
-		handleSubmitOrder
+		handleSubmitOrder,
+		proceedToCheckout
 	]);
 	(0, react.useEffect)(() => {
 		var _pubsub$subscribe;

package/lib/components/venueBooking/locales.js

@@ -126,7 +126,8 @@ var locales_default = {
 		"pisell2.appointment.policy": "You have read and agreed to this policy",
 		"pisell2.appointment.policy.confirm": "Confirm",
 		"pisell2.appointment.booking.empty.data": "No data",
-		"pisell2.product-select.search": "Search"
+		"pisell2.product-select.search": "Search",
+		"pisell2.venue.create.form": "Create form"
 	},
 	"zh-CN": {
 		"pisell2.venue.step.select": "选择场地",
@@ -250,7 +251,8 @@ var locales_default = {
 		"pisell2.appointment.policy": "您已仔细阅读并同意此协议",
 		"pisell2.appointment.policy.confirm": "确定",
 		"pisell2.appointment.booking.empty.data": "暂无数据",
-		"pisell2.product-select.search": "搜索"
+		"pisell2.product-select.search": "搜索",
+		"pisell2.venue.create.form": "创建表单"
 	},
 	"zh-HK": {
 		"pisell2.venue.step.select": "選擇場地",
@@ -374,7 +376,8 @@ var locales_default = {
 		"pisell2.appointment.policy": "您已仔細閱讀並同意此協議",
 		"pisell2.appointment.policy.confirm": "確定",
 		"pisell2.appointment.booking.empty.data": "暫無數據",
-		"pisell2.product-select.search": "搜索"
+		"pisell2.product-select.search": "搜索",
+		"pisell2.venue.create.form": "创建表单"
 	},
 	ja: {
 		"pisell2.venue.step.select": "コートを選択",
@@ -498,7 +501,8 @@ var locales_default = {
 		"pisell2.appointment.policy": "このポリシーを読み、同意しました",
 		"pisell2.appointment.policy.confirm": "確認",
 		"pisell2.appointment.booking.empty.data": "データなし",
-		"pisell2.product-select.search": "検索"
+		"pisell2.product-select.search": "検索",
+		"pisell2.venue.create.form": "フォームを作成"
 	},
 	pt: {
 		"pisell2.venue.step.select": "Escolher quadra",
@@ -622,7 +626,8 @@ var locales_default = {
 		"pisell2.appointment.policy": "Você leu e concordou com esta política",
 		"pisell2.appointment.policy.confirm": "Confirmar",
 		"pisell2.appointment.booking.empty.data": "Sem dados",
-		"pisell2.product-select.search": "Pesquisar"
+		"pisell2.product-select.search": "Pesquisar",
+		"pisell2.venue.create.form": "Criar formulário"
 	}
 };
 //#endregion

package/lib/utils/buildCartHolderParams.js

@@ -0,0 +1,172 @@
+const require_objectSpread2 = require("../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js");
+const require_holderConfig = require("./holderConfig.js");
+const require_utils = require("../components/appointmentBooking/utils.js");
+//#region src/utils/buildCartHolderParams.ts
+const toHolderRecordId = (value) => {
+	if (value == null || value === "") return void 0;
+	const id = Number(value);
+	return Number.isNaN(id) ? void 0 : id;
+};
+/**
+* 从 _origin.holder 解析 form_record_id。
+* form_record 可能是 number、number[]；不能假定一定是数组下标 [0]。
+*/
+const resolveOriginHolderId = (holder) => {
+	const formRecord = holder === null || holder === void 0 ? void 0 : holder.form_record;
+	if (Array.isArray(formRecord)) for (const value of formRecord) {
+		const id = toHolderRecordId(value);
+		if (id != null) return id;
+	}
+	else {
+		const id = toHolderRecordId(formRecord);
+		if (id != null) return id;
+	}
+	return toHolderRecordId(holder === null || holder === void 0 ? void 0 : holder.form_record_id);
+};
+/**
+* 从购物车行解析当前选中的 holder form_record_id。
+*
+* venueBooking：以 _origin.holder 为准（SDK 会原地更新 form_record）；
+* 顶层 item.holder_id 可能是上一轮 UI 注入或 SDK 回灌的滞后值，不能优先于 _origin.holder。
+*/
+const resolveCartItemHolderId = (item) => {
+	var _item$_origin;
+	const originHolder = item === null || item === void 0 || (_item$_origin = item._origin) === null || _item$_origin === void 0 ? void 0 : _item$_origin.holder;
+	if (originHolder && typeof originHolder === "object") return resolveOriginHolderId(originHolder);
+	return toHolderRecordId(item === null || item === void 0 ? void 0 : item.holder_id);
+};
+const getCurrentCustomerId = (utils) => {
+	var _getCustomer;
+	return (_getCustomer = require_utils.getCustomer(utils)) === null || _getCustomer === void 0 ? void 0 : _getCustomer.id;
+};
+const createCartHolderOption = (holder, customerId) => {
+	const _id = (holder === null || holder === void 0 ? void 0 : holder.formRecordId) || (holder === null || holder === void 0 ? void 0 : holder.form_record_id);
+	return {
+		key: _id,
+		id: _id,
+		label: holder === null || holder === void 0 ? void 0 : holder.main_field,
+		name: holder === null || holder === void 0 ? void 0 : holder.main_field,
+		username: holder === null || holder === void 0 ? void 0 : holder.main_field,
+		type: "holder",
+		_origin: require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, holder), {}, { customer_id: customerId })
+	};
+};
+/**
+* 构建 ProductCard Holder 组件使用的单条 holder 数据。
+* 输出字段需要与购物车 ProductCard 消费格式保持一致。
+*/
+const buildCartHolderOption = (holder, utils) => {
+	if (!holder) return {};
+	return createCartHolderOption(holder, getCurrentCustomerId(utils));
+};
+const buildCartHolderOptions = (records, utils) => {
+	const customerId = getCurrentCustomerId(utils);
+	return records.map((record) => createCartHolderOption(record, customerId));
+};
+const getCartHolderTitle = (records, holderId) => {
+	var _records$find;
+	if (!holderId) return "";
+	return (_records$find = records.find((record) => Number(record === null || record === void 0 ? void 0 : record.form_record_id) === holderId)) === null || _records$find === void 0 ? void 0 : _records$find.main_field;
+};
+/**
+* 根据 holderMap 与购物车行数据，构建 ProductCard 所需的 holder 展示字段。
+* 供 appointmentBooking、venueBooking 等购物车场景复用。
+*/
+const buildCartHolderParams = ({ item, holderConfig = {}, formData, translation, enabled = true, utils }) => {
+	var _formData$form;
+	if (!enabled || !require_holderConfig.isHolderConfigEnabled(holderConfig)) return {
+		isShowChangeHolder: false,
+		isErrorHolder: false,
+		holders: []
+	};
+	const records = (formData === null || formData === void 0 ? void 0 : formData.records) || [];
+	const holderId = resolveCartItemHolderId(item);
+	return {
+		holder_id: holderId,
+		isErrorHolder: !!(!holderId && require_holderConfig.isHolderConfigRequired(holderConfig)),
+		isShowChangeHolder: true,
+		addHolderButtonText: translation(formData === null || formData === void 0 || (_formData$form = formData.form) === null || _formData$form === void 0 || (_formData$form = _formData$form.form) === null || _formData$form === void 0 || (_formData$form = _formData$form.setting) === null || _formData$form === void 0 ? void 0 : _formData$form.title),
+		holder_title: getCartHolderTitle(records, holderId),
+		holders: buildCartHolderOptions(records, utils)
+	};
+};
+/**
+* 从 appointmentBooking 购物车行读取 holder_config
+*/
+const getAppointmentCartHolderConfig = (item) => {
+	var _item$_productInit;
+	return (item === null || item === void 0 || (_item$_productInit = item._productInit) === null || _item$_productInit === void 0 ? void 0 : _item$_productInit.holder_config) || {};
+};
+/**
+* 从 venueBooking 购物车行读取 holder_config
+*/
+const getVenueCartHolderConfig = (item) => {
+	var _item$_origin2;
+	return (item === null || item === void 0 || (_item$_origin2 = item._origin) === null || _item$_origin2 === void 0 || (_item$_origin2 = _item$_origin2.product) === null || _item$_origin2 === void 0 ? void 0 : _item$_origin2.holder_config) || {};
+};
+/**
+* 校验购物车中 holder_config.required 的行是否已选择 holder。
+*/
+const validateRequiredCartHolders = ({ items = [], getHolderConfig = getVenueCartHolderConfig }) => {
+	const invalidItems = items.filter((item) => {
+		if (!require_holderConfig.isHolderConfigRequired(getHolderConfig(item))) return false;
+		return !resolveCartItemHolderId(item);
+	});
+	return {
+		hasError: invalidItems.length > 0,
+		invalidItems
+	};
+};
+/**
+* 从 holderMap 解析 minors 表单关联的 sku 关系表单 ID（form_to_form 隐藏字段的 linkedTable）。
+*/
+const getSkuRelationFormId = (holderMap, formId) => {
+	var _formData$form2, _formData$form3, _detail$setting;
+	if (!formId) return 0;
+	const formData = holderMap === null || holderMap === void 0 ? void 0 : holderMap[formId];
+	if ((formData === null || formData === void 0 || (_formData$form2 = formData.form) === null || _formData$form2 === void 0 || (_formData$form2 = _formData$form2.form) === null || _formData$form2 === void 0 ? void 0 : _formData$form2.form_type) !== "minors") return 0;
+	const detail = formData === null || formData === void 0 || (_formData$form3 = formData.form) === null || _formData$form3 === void 0 || (_formData$form3 = _formData$form3.field) === null || _formData$form3 === void 0 ? void 0 : _formData$form3.find((item) => (item === null || item === void 0 ? void 0 : item.filed_type) === "form_to_form" && (item === null || item === void 0 ? void 0 : item.status) === "hide");
+	return (detail === null || detail === void 0 || (_detail$setting = detail.setting) === null || _detail$setting === void 0 ? void 0 : _detail$setting.linkedTable) || 0;
+};
+/**
+* 从 form_to_form_value 中取最新创建的 form_record_id。
+*/
+const getSkuRelationFormRecordId = (res) => {
+	var _res$values;
+	const formToFormValue = res === null || res === void 0 || (_res$values = res.values) === null || _res$values === void 0 || (_res$values = _res$values.form_to_form_value) === null || _res$values === void 0 ? void 0 : _res$values[0];
+	const formDataValue = (formToFormValue === null || formToFormValue === void 0 ? void 0 : formToFormValue.form_data_value) || [];
+	return formDataValue[formDataValue.length - 1];
+};
+/**
+* 处理购物车添加 holder 表单提交成功后的公共逻辑。
+* - minors 关联表单：刷新 holder 列表，取 form_to_form_value 中的 record id
+* - 普通表单：appendFormRecord 并直接使用 form_record_id
+*/
+const handleCartHolderFormSuccess = ({ res, formId, skuRelationFormId, utils, module }) => {
+	var _res$values2, _res$values3, _res$values4;
+	let formRecordId = res === null || res === void 0 || (_res$values2 = res.values) === null || _res$values2 === void 0 ? void 0 : _res$values2.form_record_id;
+	let resolvedFormId = res === null || res === void 0 || (_res$values3 = res.values) === null || _res$values3 === void 0 ? void 0 : _res$values3.form_id;
+	if (formId && skuRelationFormId) {
+		var _module$refreshAllHol;
+		const customer = require_utils.getCustomer(utils);
+		module === null || module === void 0 || (_module$refreshAllHol = module.refreshAllHolderFormRecords) === null || _module$refreshAllHol === void 0 || _module$refreshAllHol.call(module, { customer_id: customer === null || customer === void 0 ? void 0 : customer.id });
+		formRecordId = getSkuRelationFormRecordId(res);
+		resolvedFormId = formId;
+	} else if (formId) {
+		var _module$appendFormRec;
+		module === null || module === void 0 || (_module$appendFormRec = module.appendFormRecord) === null || _module$appendFormRec === void 0 || _module$appendFormRec.call(module, { record: res === null || res === void 0 ? void 0 : res.values });
+	}
+	return {
+		formRecordId,
+		mainField: res === null || res === void 0 || (_res$values4 = res.values) === null || _res$values4 === void 0 ? void 0 : _res$values4.main_field,
+		formId: resolvedFormId
+	};
+};
+//#endregion
+exports.buildCartHolderOption = buildCartHolderOption;
+exports.buildCartHolderParams = buildCartHolderParams;
+exports.getAppointmentCartHolderConfig = getAppointmentCartHolderConfig;
+exports.getSkuRelationFormId = getSkuRelationFormId;
+exports.getVenueCartHolderConfig = getVenueCartHolderConfig;
+exports.handleCartHolderFormSuccess = handleCartHolderFormSuccess;
+exports.validateRequiredCartHolders = validateRequiredCartHolders;

package/lib/utils/holderConfig.js

@@ -0,0 +1,7 @@
+//#region src/utils/holderConfig.ts
+/** Holder selection requires an enabled configuration and a valid form ID. */
+const isHolderConfigEnabled = (config) => (config === null || config === void 0 ? void 0 : config.status) === "enable" && Number.isFinite(Number(config === null || config === void 0 ? void 0 : config.resource_id)) && Number(config === null || config === void 0 ? void 0 : config.resource_id) > 0;
+const isHolderConfigRequired = (config) => isHolderConfigEnabled(config) && Number(config === null || config === void 0 ? void 0 : config.required) === 1;
+//#endregion
+exports.isHolderConfigEnabled = isHolderConfigEnabled;
+exports.isHolderConfigRequired = isHolderConfigRequired;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pisell/private-materials",
-  "version": "6.12.356",
+  "version": "6.12.357",
   "main": "./lib/index.js",
   "module": "./es/index.js",
   "types": "./lib/index.d.ts",
@@ -74,9 +74,9 @@
     "styled-components": "^6.0.0-rc.3",
     "use-sync-external-store": "^1.6.0",
     "@pisell/pi-payment-sdk": "0.0.4",
+    "@pisell/materials": "6.12.86",
     "@pisell/utils": "3.0.7",
     "@pisell/icon": "0.0.11",
-    "@pisell/materials": "6.12.86",
     "@pisell/date-picker": "3.0.12"
   },
   "peerDependencies": {

package/es/private-materials/lowcode/authmodal/meta.d.ts

@@ -1 +0,0 @@
-export { };