@pisell/pisellos 2.1.173 → 2.1.174

package/lib/modules/Holder/types.d.ts

@@ -0,0 +1,123 @@
+import { ProductData } from '../Product/types';
+/**
+ * 商品 holder 配置
+ */
+export interface IHolderConfig {
+    required?: number;
+    resource_id: number;
+    status?: string;
+    [key: string]: any;
+}
+/**
+ * 表单记录
+ */
+export interface IFormRecord {
+    form_id: number;
+    form_record_id: number;
+    main_field: string;
+    customer_cover?: string;
+    created_at?: string;
+    customer_id?: number;
+    [key: string]: any;
+}
+/**
+ * 表单配置/定义
+ */
+export interface IFormInfo {
+    form_id: number;
+    name: string;
+    fields?: Record<string, any>[];
+    [key: string]: any;
+}
+/**
+ * 单个 form_id 下的数据结构
+ */
+export interface IFormItemData {
+    records: IFormRecord[];
+    form: IFormInfo | Record<string, any>;
+}
+/**
+ * form_id 为 key 的 map 结构，如 948: { records: [], form: {} }
+ */
+export type HolderFormMap = Record<string, IFormItemData>;
+/**
+ * Holder 模块 reactive store，仅 holderMap 会触发 changed 事件
+ */
+export interface HolderState {
+    holderMap: HolderFormMap;
+}
+export interface IFetchFormInfoParams {
+    url?: string;
+    query: {
+        form_id: string | number;
+    };
+    useCache?: boolean;
+}
+export interface IFetchFormRecordsParams {
+    url?: string;
+    query: {
+        customer_id?: number;
+        form_id: string | number;
+        shop_id: string | number;
+        num?: number;
+        skip?: number;
+        [key: string]: any;
+    };
+    useCache?: boolean;
+}
+export interface IAddFormRecordParams {
+    url?: string;
+    body: {
+        form_id: number;
+        shop_id: number | string;
+        customer_id?: number;
+        [key: string]: any;
+    };
+}
+/**
+ * UI 层自行调用添加接口后，将返回记录写入 holderMap
+ */
+export interface IAppendFormRecordParams {
+    /** 接口返回的 data，或完整响应 { data: {...} } */
+    record: IFormRecord | Record<string, any>;
+    /** 可选，未传则从 record.form_id 读取 */
+    form_id?: number | string;
+}
+export interface IEnsureFormDataParams {
+    form_id: number | string;
+    shop_id: number | string;
+    customer_id?: number;
+    useCache?: boolean;
+    forceRefresh?: boolean;
+    formInfoUrl?: string;
+    recordsUrl?: string;
+    skip?: number;
+    num?: number;
+}
+export interface IEnsureFormByProductParams {
+    product: ProductData | Record<string, any>;
+    customer_id?: number;
+    shop_id?: number | string;
+    useCache?: boolean;
+}
+export interface IRefreshAllFormRecordsParams {
+    customer_id?: number;
+    useCache?: boolean;
+    recordsUrl?: string;
+    num?: number;
+    skip?: number;
+}
+export interface HolderModuleAPI {
+    getHolderFormMap: () => HolderFormMap;
+    getHolderFormData: (formId: number | string) => IFormItemData | undefined;
+    setFormData: (formId: number | string, data: Partial<IFormItemData>) => void;
+    fetchFormInfo: (params: IFetchFormInfoParams) => Promise<IFormInfo | IFormInfo[]>;
+    fetchRecords: (params: IFetchFormRecordsParams) => Promise<IFormRecord[]>;
+    ensureFormData: (params: IEnsureFormDataParams) => Promise<IFormItemData>;
+    ensureFormByProduct: (params: IEnsureFormByProductParams) => Promise<IFormItemData | null>;
+    addFormRecord: (params: IAddFormRecordParams) => Promise<IFormRecord>;
+    appendFormRecord: (params: IAppendFormRecordParams) => IFormRecord;
+    removeFormRecord: (formId: number | string, formRecordId: number) => void;
+    clearFormData: (formId?: number | string) => void;
+    refreshAllFormRecords: (params?: IRefreshAllFormRecordsParams) => Promise<HolderFormMap>;
+}

package/lib/modules/Holder/types.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/modules/Holder/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/lib/modules/Holder/utils.d.ts

@@ -0,0 +1,13 @@
+import { ProductData } from '../Product/types';
+import { IFormItemData, IHolderConfig } from './types';
+export declare function getProductHolderConfig(product?: ProductData | Record<string, any> | null): IHolderConfig | null;
+export declare function getFormIdFromHolderConfig(config: IHolderConfig): number;
+export declare function normalizeFormId(formId: number | string): number;
+export declare function createEmptyFormItemData(): {
+    records: any[];
+    form: Record<string, any>;
+};
+export declare function resolveFormMetaFromHolderItem(mapKey: string, item: IFormItemData): {
+    form_id: number | string;
+    shop_id: number | string;
+} | null;

package/lib/modules/Holder/utils.js

@@ -0,0 +1,71 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/modules/Holder/utils.ts
+var utils_exports = {};
+__export(utils_exports, {
+  createEmptyFormItemData: () => createEmptyFormItemData,
+  getFormIdFromHolderConfig: () => getFormIdFromHolderConfig,
+  getProductHolderConfig: () => getProductHolderConfig,
+  normalizeFormId: () => normalizeFormId,
+  resolveFormMetaFromHolderItem: () => resolveFormMetaFromHolderItem
+});
+module.exports = __toCommonJS(utils_exports);
+function getProductHolderConfig(product) {
+  var _a;
+  if (!product)
+    return null;
+  const config = (product == null ? void 0 : product.holder_config) ?? ((_a = product == null ? void 0 : product.origin) == null ? void 0 : _a.holder_config);
+  if ((config == null ? void 0 : config.status) && (config == null ? void 0 : config.status) !== "enable")
+    return null;
+  if (!(config == null ? void 0 : config.resource_id))
+    return null;
+  return config;
+}
+function getFormIdFromHolderConfig(config) {
+  return Number(config == null ? void 0 : config.resource_id);
+}
+function normalizeFormId(formId) {
+  return Number(formId);
+}
+function createEmptyFormItemData() {
+  return {
+    records: [],
+    form: {}
+  };
+}
+function resolveFormMetaFromHolderItem(mapKey, item) {
+  const formInfo = item.form || {};
+  const nestedForm = formInfo.form || {};
+  const form_id = normalizeFormId(
+    nestedForm.id ?? formInfo.form_id ?? formInfo.id ?? mapKey
+  );
+  const shop_id = nestedForm.shop_id ?? formInfo.shop_id;
+  if (shop_id === void 0 || shop_id === null || shop_id === "") {
+    return null;
+  }
+  return { form_id, shop_id };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createEmptyFormItemData,
+  getFormIdFromHolderConfig,
+  getProductHolderConfig,
+  normalizeFormId,
+  resolveFormMetaFromHolderItem
+});

package/lib/modules/Order/index.d.ts

@@ -57,6 +57,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private getTempOrderStorageKey;
     private restoreTempOrderFromStorage;
     persistTempOrder(): void;
+    notifyTempOrderChanged(): void;
     private createDefaultTempOrderInstance;
     ensureTempOrder(): ScanOrderTempOrder;
     restoreOrder(): ScanOrderTempOrder;

package/lib/modules/Order/index.js

@@ -325,6 +325,16 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       return;
     this.window.localStorage.setItem(key, JSON.stringify(this.store.tempOrder));
   }
+  notifyTempOrderChanged() {
+    if (!this.store.tempOrder)
+      return;
+    this.store.tempOrder = {
+      ...this.store.tempOrder,
+      products: [...this.store.tempOrder.products],
+      bookings: this.store.tempOrder.bookings ? [...this.store.tempOrder.bookings] : []
+    };
+    this.persistTempOrder();
+  }
   // ─── TempOrder: 创建 & 获取 ───
   createDefaultTempOrderInstance() {
     return (0, import_utils.createDefaultTempOrder)({
@@ -595,6 +605,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     let is_deposit = 0;
     if (params.cartItems.length > 0) {
       params.cartItems.forEach((item) => {
+        var _a2;
         if (!item._origin.duration) {
           const { duration, durationType } = (0, import_utils.generateDuration)(item);
           item._origin.duration = duration;
@@ -602,6 +613,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         }
         const discountList = (0, import_utils.getAllDiscountList)(item);
         item._origin.product.discount_list = discountList;
+        if ((_a2 = params == null ? void 0 : params.extraData) == null ? void 0 : _a2.is_add_holder_info) {
+          (0, import_utils.ensureCartItemOriginHolder)(item, this.window);
+        }
         if ((0, import_utils2.isNormalProduct)(item._origin)) {
           order.relation_products.push(item._origin.product);
           const relationForms = item._origin.relation_forms || [];

package/lib/modules/Order/types.d.ts

@@ -235,6 +235,8 @@ export interface OrderModuleAPI {
     updateProductInOrder: (params: UpdateProductInOrderParams) => Promise<ScanOrderOrderProduct[]>;
     removeProductFromOrder: (identity: ScanOrderOrderProductIdentity) => Promise<ScanOrderOrderProduct[]>;
     persistTempOrder: () => void;
+    /** 提交 tempOrder 变更并触发 `{moduleName}:changed` 事件 */
+    notifyTempOrderChanged: () => void;
     submitTempOrder: <T = any>(params?: {
         cacheId?: string;
         platform?: string;

package/lib/modules/Order/utils.d.ts

@@ -2,6 +2,7 @@ import Decimal from 'decimal.js';
 import { CartItem } from "../Cart";
 import type { ScanOrderSubmitPayload, ScanOrderSubmitProduct, ScanOrderSummary, ScanOrderTempOrder } from '../../solution/ScanOrder/types';
 import type { RulesParamsHooks } from '../Rules/types';
+import type { WindowPlugin } from '../../plugins';
 /**
  * 把"含 option 的主商品单价"与 bundle 合成"单行 composite 单价"。
  *
@@ -86,6 +87,15 @@ export declare const mergeRelationForms: (relationForms: {
     form_id: number;
     form_record_ids: number[];
 }[];
+export interface CartOrderHolder {
+    customer_id?: number;
+    form_id: number | string;
+    form_record: (number | string)[] | null;
+}
+/**
+ * 为购物车行补齐订单所需的 holder 信息（与 cartAccount 结构保持一致）
+ */
+export declare function ensureCartItemOriginHolder(cartItem: CartItem, window?: WindowPlugin): void;
 export declare const getAllDiscountList: (cartItem: CartItem) => any;
 export declare function createUuidV4(): string;
 export declare function isTempOrder(data: any): data is ScanOrderTempOrder;

package/lib/modules/Order/utils.js

@@ -33,8 +33,9 @@ __export(utils_exports, {
   composeLinePrice: () => composeLinePrice,
   createDefaultOrderRulesHooks: () => createDefaultOrderRulesHooks,
   createDefaultTempOrder: () => createDefaultTempOrder,
-  createEmptySummary: () => import_utils2.createEmptySummary,
+  createEmptySummary: () => import_utils3.createEmptySummary,
   createUuidV4: () => createUuidV4,
+  ensureCartItemOriginHolder: () => ensureCartItemOriginHolder,
   filterProductsForScanOrderMore: () => filterProductsForScanOrderMore,
   formatDateTime: () => formatDateTime,
   formatV1Product: () => formatV1Product,
@@ -50,8 +51,9 @@ __export(utils_exports, {
 module.exports = __toCommonJS(utils_exports);
 var import_dayjs = __toESM(require("dayjs"));
 var import_decimal = __toESM(require("decimal.js"));
-var import_utils = require("../../solution/ScanOrder/utils");
+var import_utils = require("../Holder/utils");
 var import_utils2 = require("../../solution/ScanOrder/utils");
+var import_utils3 = require("../../solution/ScanOrder/utils");
 function composeLinePrice(params) {
   const { mainPrice, bundle, useOriginalBundle } = params;
   let total = new import_decimal.default(Number(mainPrice) || 0);
@@ -113,7 +115,7 @@ function createDefaultOrderRulesHooks() {
         // 否则同 SKU 不同小料会在 calcDiscount 重组时互相覆盖。
         // 不透明 identity 契约下，normalizeOrderProduct / restoreTempOrderFromStorage 已保证 identity_key 必存在；
         // 留 fingerprint 分支仅作 Rules 单测里直接传裸 product 时的兜底。
-        _id: product.identity_key ? `${product.product_id}_${product.product_variant_id}_${product.identity_key}` : `${product.product_id}_${product.product_variant_id}_${(0, import_utils.buildProductLineFingerprint)(
+        _id: product.identity_key ? `${product.product_id}_${product.product_variant_id}_${product.identity_key}` : `${product.product_id}_${product.product_variant_id}_${(0, import_utils2.buildProductLineFingerprint)(
           product.product_option_item,
           product.product_bundle
         )}`,
@@ -196,6 +198,34 @@ var mergeRelationForms = (relationForms) => {
     }, {})
   ).filter((item) => item.form_record_ids.length > 0);
 };
+function getCustomerIdFromStorage(window) {
+  var _a;
+  try {
+    const customer = JSON.parse(((_a = window == null ? void 0 : window.getLocalStorage) == null ? void 0 : _a.call(window, "customer")) || "{}");
+    const customerId = Number(customer == null ? void 0 : customer.id);
+    return Number.isFinite(customerId) && customerId > 0 ? customerId : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function ensureCartItemOriginHolder(cartItem, window) {
+  var _a;
+  if ((_a = cartItem == null ? void 0 : cartItem._origin) == null ? void 0 : _a.holder) {
+    return;
+  }
+  const holderConfig = (0, import_utils.getProductHolderConfig)(
+    (cartItem == null ? void 0 : cartItem._productInit) ?? (cartItem == null ? void 0 : cartItem._productOrigin)
+  );
+  const formRecordId = cartItem == null ? void 0 : cartItem.holder_id;
+  if (!(holderConfig == null ? void 0 : holderConfig.resource_id) || formRecordId == null) {
+    return;
+  }
+  cartItem._origin.holder = {
+    customer_id: getCustomerIdFromStorage(window),
+    form_id: holderConfig.resource_id,
+    form_record: [formRecordId]
+  };
+}
 var getAllDiscountList = (cartItem) => {
   var _a, _b, _c, _d;
   let discountList = ((_b = (_a = cartItem == null ? void 0 : cartItem._origin) == null ? void 0 : _a.product) == null ? void 0 : _b.discount_list) || [];
@@ -378,7 +408,7 @@ function resolveSubmitCollectPax(tempOrder) {
   return normalizeSubmitCollectPaxValue((_a = tempOrder.metadata) == null ? void 0 : _a.collect_pax);
 }
 function createDefaultTempOrder(params) {
-  const summary = params.summary || (0, import_utils.createEmptySummary)();
+  const summary = params.summary || (0, import_utils2.createEmptySummary)();
   return {
     order_id: null,
     relation_id: void 0,
@@ -437,7 +467,7 @@ function buildSubmitPayload(params) {
     enhance
   } = params;
   const scheduleDate = tempOrder.schedule_date || tempOrder.created_at || formatDateTime(now);
-  const summary = tempOrder.summary || (0, import_utils.createEmptySummary)();
+  const summary = tempOrder.summary || (0, import_utils2.createEmptySummary)();
   const relationId = tempOrder.relation_id;
   const tableFormId = tempOrder.table_form_id;
   const bookingUuid = createUuidV4();
@@ -540,6 +570,7 @@ function formatV1Product(products) {
   createDefaultTempOrder,
   createEmptySummary,
   createUuidV4,
+  ensureCartItemOriginHolder,
   filterProductsForScanOrderMore,
   formatDateTime,
   formatV1Product,

package/lib/modules/Product/types.d.ts

@@ -189,6 +189,13 @@ export interface ProductData {
     };
     /** 购物车行键，用于唯一标识购物车中的商品，用于相同 SKU商品合并 */
     rowKey?: string;
+    /** holder 表单配置 */
+    holder_config?: {
+        required?: number;
+        resource_id?: number;
+        status?: string;
+        [key: string]: any;
+    };
 }
 /**
  * 商品媒体信息接口

package/lib/modules/Rules/entitlementLines.d.ts

@@ -0,0 +1,8 @@
+import type { RulesParamsHooks } from './types';
+export declare function isEntitlementRuntimeLine(product: any, mappedProduct?: any): boolean;
+/** 仅同步本次多次卡行的数量与价格，沿用 Rules 的主商品、套餐计算结果。 */
+export declare function rebuildEntitlementLine(origin: any, bundle: any[], hooks: RulesParamsHooks, count?: number): any;
+/** 重算只还原本次多次卡；套餐和多 Holder 按父商品份数计算，不再合并商品行。 */
+export declare function prepareEntitlementLines(products: any[], hooks: RulesParamsHooks, canUseEntitlement: (product: any) => boolean): any[];
+/** 客户端钩子可能保留原 _id，只给新增的重复行补标识，保留拆分结果。 */
+export declare function finalizeEntitlementLines(products: any[], hooks: RulesParamsHooks): any[];

package/lib/modules/Rules/entitlementLines.js

@@ -0,0 +1,158 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/modules/Rules/entitlementLines.ts
+var entitlementLines_exports = {};
+__export(entitlementLines_exports, {
+  finalizeEntitlementLines: () => finalizeEntitlementLines,
+  isEntitlementRuntimeLine: () => isEntitlementRuntimeLine,
+  prepareEntitlementLines: () => prepareEntitlementLines,
+  rebuildEntitlementLine: () => rebuildEntitlementLine
+});
+module.exports = __toCommonJS(entitlementLines_exports);
+var import_lodash_es = require("lodash-es");
+var import_decimal = __toESM(require("decimal.js"));
+var import_entitlementPass = require("../Discount/entitlementPass");
+var import_entitlementState = require("../Discount/entitlementState");
+var SOURCE = "entitlement_source_identity";
+function isManualDiscount(data) {
+  var _a;
+  return data.isManualDiscount ?? (data.total != data.origin_total && (data.bundle || []).every((item) => {
+    var _a2;
+    return !((_a2 = item.discount_list) == null ? void 0 : _a2.length);
+  }) && (!((_a = data.discount_list) == null ? void 0 : _a.length) || data.discount_list.every((item) => item.type === "product")));
+}
+function isEntitlementRuntimeLine(product, mappedProduct) {
+  var _a;
+  return ((_a = product.metadata) == null ? void 0 : _a[SOURCE]) != null && !(0, import_entitlementState.isPersistedEntitlementLine)(product, mappedProduct) && !isManualDiscount(mappedProduct ?? product);
+}
+function rebuildEntitlementLine(origin, bundle, hooks, count) {
+  const data = hooks.getProduct(origin);
+  const quantity = count ?? data.quantity ?? data.num ?? 1;
+  const discounts = (data.discount_list || []).map(
+    (item) => {
+      var _a;
+      return (0, import_entitlementPass.isEntitlementPass)(item) && !((_a = item.metadata) == null ? void 0 : _a.custom_product_bundle_map_id) ? { ...item, _num: quantity, metadata: { ...item.metadata, num: quantity } } : item;
+    }
+  );
+  const mainDiscount = discounts.filter((item) => {
+    var _a;
+    return !((_a = item.metadata) == null ? void 0 : _a.custom_product_bundle_map_id);
+  }).reduce((sum, item) => sum.plus(item.amount || 0), new import_decimal.default(0));
+  const originalPrice = new import_decimal.default(data.original_price ?? data.price ?? 0);
+  const sourceSellingPrice = originalPrice.minus(mainDiscount).toNumber();
+  const optionPrice = (data.options || []).reduce((sum, item) => sum.plus(new import_decimal.default(item.price || 0).times(item.num || 0)), new import_decimal.default(0));
+  const bundleTotal = bundle.reduce((sum, item) => sum.plus(new import_decimal.default(item.price || 0).times(item.num || 1)), new import_decimal.default(0));
+  const bundleOriginalTotal = bundle.reduce((sum, item) => sum.plus(new import_decimal.default(item.original_price ?? item.price ?? 0).times(item.num || 1)), new import_decimal.default(0));
+  return hooks.setProduct(origin, {
+    quantity,
+    discount_list: discounts,
+    bundle,
+    price: sourceSellingPrice,
+    main_product_selling_price: sourceSellingPrice,
+    total: new import_decimal.default(sourceSellingPrice).plus(optionPrice).plus(bundleTotal).toNumber(),
+    origin_total: originalPrice.plus(optionPrice).plus(bundleOriginalTotal).toNumber()
+  });
+}
+function setLineIdentity(row, id) {
+  row._id = id;
+  row.metadata = { ...row.metadata, unique_identification_number: id };
+  if (row._extend)
+    row._extend.unique_identification_number = id;
+  return row;
+}
+function prepareEntitlementLines(products, hooks, canUseEntitlement) {
+  return products.flatMap((original) => {
+    var _a, _b, _c, _d;
+    const data = hooks.getProduct(original);
+    if ((0, import_entitlementState.isPersistedEntitlementLine)(original, data) || isManualDiscount(data))
+      return [original];
+    const applicable = canUseEntitlement(original);
+    if (!((_a = original.metadata) == null ? void 0 : _a[SOURCE]) && !(0, import_entitlementState.hasEntitlementDiscount)(data) && !applicable)
+      return [original];
+    const origin = (0, import_lodash_es.cloneDeep)(original);
+    origin.metadata = { ...origin.metadata, [SOURCE]: ((_b = origin.metadata) == null ? void 0 : _b[SOURCE]) ?? data._id };
+    const bundle = (data.bundle || []).map((item) => {
+      var _a2;
+      const entitlement = (item.discount_list || []).find(import_entitlementPass.isEntitlementPass);
+      if (!entitlement)
+        return item;
+      const discounts = (item.discount_list || []).filter((discount) => !(0, import_entitlementPass.isEntitlementPass)(discount));
+      const originalPrice = item.original_price ?? ((_a2 = entitlement.discount) == null ? void 0 : _a2.original_amount) ?? item.product_price ?? item.price ?? 0;
+      const amount = discounts.reduce((sum, discount) => sum.plus(discount.amount || 0), new import_decimal.default(0));
+      const price = new import_decimal.default(originalPrice).minus(amount.div(item.num || 1)).toNumber();
+      return { ...item, original_price: originalPrice, price, bundle_selling_price: price, discount_list: discounts };
+    });
+    const mainEntitlement = (_c = data.discount_list) == null ? void 0 : _c.find(import_entitlementPass.isEntitlementPass);
+    const restored = hooks.setProduct(origin, {
+      original_price: data.original_price ?? ((_d = mainEntitlement == null ? void 0 : mainEntitlement.discount) == null ? void 0 : _d.original_amount) ?? data.price,
+      discount_list: (data.discount_list || []).filter((item) => !(0, import_entitlementPass.isEntitlementPass)(item)),
+      bundle
+    });
+    const row = rebuildEntitlementLine(restored, bundle, hooks);
+    const count = Math.max(1, Math.floor(Number(data.quantity || data.num || 1)));
+    if (!applicable || count <= 1 || !bundle.length && !Array.isArray(data.holder_id))
+      return [row];
+    return Array.from({ length: count }, (_, index) => {
+      var _a2, _b2;
+      const unit = (0, import_lodash_es.cloneDeep)(row);
+      for (const source of [unit, unit._extend]) {
+        if (Array.isArray(source == null ? void 0 : source.holder_id))
+          source.holder_id = source.holder_id.slice(index, index + 1);
+      }
+      if (Array.isArray((_b2 = (_a2 = unit._origin) == null ? void 0 : _a2.holder) == null ? void 0 : _b2.form_record)) {
+        const records = unit._origin.holder.form_record;
+        if (records.length > 1)
+          unit._origin.holder.form_record = records.slice(index, index + 1);
+      }
+      return setLineIdentity(rebuildEntitlementLine(unit, hooks.getProduct(unit).bundle || [], hooks, 1), `${data._id}:entitlement-unit:${index}`);
+    });
+  });
+}
+function finalizeEntitlementLines(products, hooks) {
+  const runtime = (item) => isEntitlementRuntimeLine(item, hooks.getProduct(item));
+  const seen = new Set(products.filter((item) => !runtime(item)).map((item) => String(item._id)));
+  return products.map((origin, index) => {
+    if (!runtime(origin))
+      return origin;
+    const base = String(origin._id ?? hooks.getProduct(origin)._id);
+    let id = base;
+    let ordinal = index;
+    while (seen.has(id))
+      id = `${base}:entitlement-split:${ordinal++}`;
+    seen.add(id);
+    return id === String(origin._id) ? origin : setLineIdentity((0, import_lodash_es.cloneDeep)(origin), id);
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  finalizeEntitlementLines,
+  isEntitlementRuntimeLine,
+  prepareEntitlementLines,
+  rebuildEntitlementLine
+});

package/lib/modules/Rules/index.d.ts

@@ -8,17 +8,26 @@ export declare class RulesModule extends BaseModule implements Module, RulesModu
     protected defaultVersion: string;
     private store;
     private hooks;
+    private entitlementPassEnabled;
+    private defaultWalletPassEvaluator?;
+    setEntitlementPassEnabled(enabled: boolean): void;
+    private getWalletPassEvaluator;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
     setRulesList(rulesList: Rules[]): Promise<void>;
     getRulesList(): Rules[];
+    private normalizeHolderRecordIds;
+    /**
+     * 商品未开启 Holder 选择时跳过匹配；已开启时，特定 form Holder 卡
+     * 只适用于同一 Holder Record，是否必填不影响匹配规则。
+     */
     private checkHolderMatch;
     isDiscountListAvailable({ oldDiscountList, newDiscountList, productList, holders, isFormSubject, }: {
         oldDiscountList: Discount[];
         newDiscountList: Discount[];
         productList: any[];
         holders: {
-            form_record_id: number;
+            form_record_id: number | string;
         }[];
         isFormSubject: boolean;
     }): {
@@ -26,6 +35,7 @@ export declare class RulesModule extends BaseModule implements Module, RulesModu
         discountList: Discount[];
         productList: any[];
         unavailableReason?: UnavailableReason;
+        evaluatedDiscountList?: Discount[];
     };
     filterDiscountListByType(discountList: Discount[], type: string): Discount[];
     private getUnavailableReason;
@@ -33,7 +43,7 @@ export declare class RulesModule extends BaseModule implements Module, RulesModu
         discountList: Discount[];
         productList: any[];
         holders: {
-            form_record_id: number;
+            form_record_id: number | string;
         }[];
         isFormSubject: boolean;
     }, options?: {