@pisell/pisellos 0.10.15 → 0.10.17

package/dist/core/index.js

@@ -106,21 +106,20 @@ var PisellOSCore = /*#__PURE__*/function () {
               _context.next = 16;
               return this.server.initialize(this.serverOptions.modules, this.serverOptions.autoInitData !== false, options);
             case 16:
-              console.log('[PisellOS] ✅ Server 初始化完成，所有数据已预加载');
               this.log('[PisellOS] Server 初始化完成');
-              _context.next = 25;
+              _context.next = 24;
               break;
-            case 20:
-              _context.prev = 20;
+            case 19:
+              _context.prev = 19;
               _context.t0 = _context["catch"](6);
               console.error('[PisellOS] ❌ Server 初始化失败:', _context.t0);
               this.log("Server \u521D\u59CB\u5316\u5931\u8D25: ".concat(_context.t0), 'error');
               throw _context.t0;
-            case 25:
+            case 24:
             case "end":
               return _context.stop();
           }
-        }, _callee, this, [[6, 20]]);
+        }, _callee, this, [[6, 19]]);
       }));
       function initializeServer(_x) {
         return _initializeServer.apply(this, arguments);
@@ -138,11 +137,10 @@ var PisellOSCore = /*#__PURE__*/function () {
       var prefix = '[PisellOS]';
       switch (level) {
         case 'info':
-          console.log("".concat(prefix, " ").concat(message));
           break;
         case 'warn':
           // 使用 console.log 避免显示堆栈跟踪，提升性能
-          console.log("%c".concat(prefix, "%c ").concat(message), 'color: #f59e0b; font-weight: bold;', 'color: #f59e0b;');
+
           break;
         case 'error':
           console.error("".concat(prefix, " ").concat(message));
@@ -249,7 +247,6 @@ var PisellOSCore = /*#__PURE__*/function () {
       }
       // 预先给模块初始化值系统
       var _createStore = createStore((options === null || options === void 0 ? void 0 : options.initialState) || {}, module.name, function (path, value) {
-          console.log('core 检测到模块值更新', module.name, path, value);
           _this3.effects.emit("".concat(module.name, ":changed"), {
             path: path,
             value: value

package/dist/model/strategy/adapter/promotion/index.js

@@ -1,9 +0,0 @@
-// 导出评估器
-export { PromotionEvaluator } from "./evaluator";
-
-// 导出适配器
-export { PromotionAdapter } from "./adapter";
-export { default } from "./adapter";
-
-// 导出策略配置示例常量
-export { X_ITEMS_FOR_Y_PRICE_STRATEGY, BUY_X_GET_Y_FREE_STRATEGY, ITEM_REWARD_STRATEGY } from "./examples";

package/dist/model/strategy/adapter/walletPass/example.js

@@ -164,8 +164,6 @@ var strategyConfigs = [
 // ============================================
 
 function runExample() {
-  console.log('========== WalletPass 评估器示例 ==========\n');
-
   // 创建评估器实例
   var evaluator = new WalletPassEvaluator();
 
@@ -178,38 +176,17 @@ function runExample() {
   });
 
   // 输出结果
-  console.log('订单信息：');
-  console.log("- \u603B\u91D1\u989D: ".concat(180, " \u5143"));
-  console.log("- \u5546\u54C1: ".concat(products.map(function (p) {
-    return "".concat(p.name, "(").concat(p.quantity, "\u4EF6)");
-  }).join(', '), "\n"));
-  console.log('评估结果：\n');
+
   results.forEach(function (result, index) {
-    console.log("Voucher ".concat(index + 1, ": ").concat(result.voucher.id));
-    console.log("  \u9762\u989D: ".concat(result.voucher.amount, " \u5143"));
-    console.log("  \u53EF\u7528: ".concat(result.isApplicable ? '✅ 是' : '❌ 否'));
-    if (result.isApplicable) {
-      console.log("  \u6700\u5927\u62B5\u6263: ".concat(result.maxDeduction, " \u5143"));
-      console.log("  \u6BCF\u5355\u53EF\u7528: ".concat(result.canUseCount, " \u5F20"));
-      console.log("  \u62B5\u6263\u7A0E\u8D39: ".concat(result.deductTaxAndFee ? '是' : '否'));
-      console.log("  \u9002\u7528\u5546\u54C1: ".concat(result.applicableProductIds.join(', ')));
-    } else {
-      console.log("  \u539F\u56E0: ".concat(result.reason));
-      console.log("  \u539F\u56E0\u7801: ".concat(result.reasonCode));
-    }
-    console.log('');
+    if (result.isApplicable) {} else {}
   });
 
   // 筛选可用的 vouchers
   var availableVouchers = results.filter(function (r) {
     return r.isApplicable;
   });
-  console.log("\n\u5171 ".concat(availableVouchers.length, " \u5F20\u53EF\u7528"));
   if (availableVouchers.length > 0) {
-    console.log('可用 voucher ID:');
-    availableVouchers.forEach(function (v) {
-      console.log("  - ".concat(v.voucher.id, ": \u6700\u591A\u62B5\u6263 ").concat(v.maxDeduction, " \u5143"));
-    });
+    availableVouchers.forEach(function (v) {});
   }
 }
 

package/dist/model/strategy/strategy-example.js

@@ -246,8 +246,6 @@ var codeContext = {
 // ============================================
 
 function runExamples() {
-  console.log('====== 策略模型使用示例 ======\n');
-
   // 创建引擎实例（开启调试和追踪）
   var engine = createStrategyEngine({
     debug: true,
@@ -255,32 +253,23 @@ function runExamples() {
   });
 
   // 示例1: 代金券
-  console.log('示例1: 10元代金券');
+
   var result1 = engine.evaluate(voucherConfig, voucherContext);
-  console.log('结果:', JSON.stringify(result1, null, 2));
-  console.log('\n');
 
   // 示例2: 阶梯满减
-  console.log('示例2: 阶梯满减（订单金额250）');
+
   var result2 = engine.evaluate(tieredDiscountConfig, tieredContext);
-  console.log('结果:', JSON.stringify(result2, null, 2));
-  console.log('\n');
 
   // 示例3: Code 模式
-  console.log('示例3: Code 模式条件');
+
   var result3 = engine.evaluate(codeConditionConfig, codeContext);
-  console.log('结果:', JSON.stringify(result3, null, 2));
-  console.log('\n');
 
   // 快速评估（不需要创建引擎实例）
-  console.log('示例4: 快速评估');
+
   var result4 = evaluate(voucherConfig, voucherContext);
-  console.log('适用:', result4.applicable);
-  console.log('匹配动作数:', result4.matchedActions.length);
-  console.log('\n');
 
   // 注册自定义运算符
-  console.log('示例5: 自定义运算符');
+
   engine.registerOperator('divisible_by', function (fieldValue, compareValue) {
     return Number(fieldValue) % Number(compareValue) === 0;
   });
@@ -317,11 +306,8 @@ function runExamples() {
     }
   };
   var result5 = engine.evaluate(customOperatorConfig, customContext);
-  console.log('结果:', result5.applicable ? '适用' : '不适用');
-  console.log('匹配动作:', result5.matchedActions);
 
   // 调试信息
-  console.log('\n引擎调试信息:', engine.getDebugInfo());
 }
 
 // 运行示例（如果直接执行此文件）

package/dist/modules/Cart/index.js

@@ -95,9 +95,6 @@ export var CartModule = /*#__PURE__*/function (_BaseModule) {
               }
               throw new Error('购物车模块需要 window 插件支持');
             case 11:
-              // this.store.temp = {};
-              console.log('[CartModule] 初始化完成');
-            case 12:
             case "end":
               return _context.stop();
           }

package/dist/modules/Cart/utils/cartProduct.js

@@ -63,7 +63,6 @@ export var handleVariantProduct = function handleVariantProduct(product) {
  */
 export var formatProductToCartItem = function formatProductToCartItem(params) {
   var _product$custom_depos;
-  console.log('formatProductToCartItem>>>>>>', params);
   var cartItem = params.cartItem,
     product = params.product,
     bundle = params.bundle,

package/dist/modules/Date/index.js

@@ -294,8 +294,6 @@ export var DateModule = /*#__PURE__*/function (_BaseModule) {
             // 将 start_time 向上取整到下一个10分钟整数
             var roundedStartTime = _this3.roundUpToNext10Minutes(resourceStartTime);
             var roundedStartTimeDayjs = dayjs(roundedStartTime);
-            console.log("[DateModule] \u4FEE\u6B63\u65F6\u95F4\u6BB5\u5F00\u59CB\u65F6\u95F4: ".concat(timeSlot.start_at, " -> ").concat(roundedStartTime, " (\u8D44\u6E90ID: ").concat(resource.id, ", \u539F\u59CBstart_time: ").concat(resource.start_time, ")"));
-
             // 将 start_at 修正为向上取整后的时间
             var correctedTimeSlot = _objectSpread(_objectSpread({}, timeSlot), {}, {
               start_at: roundedStartTime
@@ -303,7 +301,6 @@ export var DateModule = /*#__PURE__*/function (_BaseModule) {
 
             // 检查修正后的 end_at 是否也早于修正后的 start_time
             if (endAt.isBefore(roundedStartTimeDayjs)) {
-              console.log("[DateModule] \u65F6\u95F4\u6BB5\u65E0\u6548\uFF0C\u5C06\u88AB\u5220\u9664: ".concat(timeSlot.start_at, " - ").concat(timeSlot.end_at, " (\u8D44\u6E90ID: ").concat(resource.id, ", \u4FEE\u6B63\u540Estart_time: ").concat(roundedStartTime, ")"));
               return null; // 标记为删除
             }
             return correctedTimeSlot;
@@ -366,9 +363,8 @@ export var DateModule = /*#__PURE__*/function (_BaseModule) {
             case 18:
               _context4.prev = 18;
               _context4.t0 = _context4["catch"](7);
-              console.log('getAvailableTimeList_error', _context4.t0);
               return _context4.abrupt("return", disableAllDates(dates));
-            case 22:
+            case 21:
             case "end":
               return _context4.stop();
           }

package/dist/modules/Discount/index.js

@@ -501,9 +501,8 @@ export var DiscountModule = /*#__PURE__*/function (_BaseModule) {
               _context7.next = 4;
               return this.core.effects.emit("".concat(this.name, ":onDestroy"), {});
             case 4:
-              console.log('[Discount] 已销毁');
               _get(_getPrototypeOf(DiscountModule.prototype), "destroy", this).call(this);
-            case 6:
+            case 5:
             case "end":
               return _context7.stop();
           }
@@ -523,8 +522,7 @@ export var DiscountModule = /*#__PURE__*/function (_BaseModule) {
             case 0:
               this.store.discountList = [];
               this.store.originalDiscountList = [];
-              console.log('[Discount] clear');
-            case 3:
+            case 2:
             case "end":
               return _context8.stop();
           }

package/dist/modules/OpenData/index.d.ts

@@ -1,9 +1,9 @@
 import { Module, PisellCore, ModuleOptions } from '../../types';
 import { BaseModule } from '../BaseModule';
 import type { ScheduleModule } from '../Schedule';
-import type { OpenDataConfig, OpenDataFetchParams, OpenDataAvailabilityResult } from './types';
+import type { OpenDataConfig, OpenDataFetchParams, OpenDataAvailabilityResult, InvoiceLayoutConfig, InvoiceTemplateSettings } from './types';
 export * from './types';
-export { computeAvailability } from './utils';
+export { computeAvailability, getDefaultInvoiceLayoutConfig, getDefaultInvoiceTemplateSettings, normalizeInvoiceLayoutConfig, normalizeInvoiceTemplateSettings, normalizeRawInvoiceTemplateSettings, } from './utils';
 export declare class OpenDataModule extends BaseModule implements Module {
     protected defaultName: string;
     protected defaultVersion: string;
@@ -15,6 +15,7 @@ export declare class OpenDataModule extends BaseModule implements Module {
     private openCache;
     private fatherModule;
     private otherParams;
+    private fetchRevision;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
     /**
@@ -26,6 +27,8 @@ export declare class OpenDataModule extends BaseModule implements Module {
     updateOtherParams(params: Record<string, any>): void;
     fetchOpenData(params: OpenDataFetchParams): Promise<OpenDataConfig>;
     getOpenData(): OpenDataConfig | null;
+    getInvoiceLayoutConfig(): InvoiceLayoutConfig;
+    getInvoiceTemplateSettings(): InvoiceTemplateSettings;
     getLastFetchedAt(): number | null;
     /** 清除内存与 sessionStorage 镜像中的 OpenData，供宿主切店时调用。 */
     clearCache(): void;

package/dist/modules/OpenData/index.js

@@ -16,9 +16,9 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { BaseModule } from "../BaseModule";
-import { computeAvailability } from "./utils";
+import { computeAvailability, normalizeInvoiceLayoutConfig, normalizeInvoiceTemplateSettings } from "./utils";
 export * from "./types";
-export { computeAvailability } from "./utils";
+export { computeAvailability, getDefaultInvoiceLayoutConfig, getDefaultInvoiceTemplateSettings, normalizeInvoiceLayoutConfig, normalizeInvoiceTemplateSettings, normalizeRawInvoiceTemplateSettings } from "./utils";
 export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
   _inherits(OpenDataModule, _BaseModule);
   var _super = _createSuper(OpenDataModule);
@@ -36,6 +36,7 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
     _defineProperty(_assertThisInitialized(_this), "openCache", false);
     _defineProperty(_assertThisInitialized(_this), "fatherModule", void 0);
     _defineProperty(_assertThisInitialized(_this), "otherParams", {});
+    _defineProperty(_assertThisInitialized(_this), "fetchRevision", 0);
     return _this;
   }
   _createClass(OpenDataModule, [{
@@ -74,8 +75,6 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
               }
               throw new Error('OpenDataModule 需要 window 插件支持');
             case 14:
-              console.log('[OpenDataModule] 初始化完成');
-            case 15:
             case "end":
               return _context.stop();
           }
@@ -106,22 +105,23 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
     value: function () {
       var _fetchOpenData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(params) {
         var _this$appPlugin, _this$appPlugin$getDa;
-        var getData, shopId, tenantId, headers, response, data;
+        var fetchRevision, getData, shopId, tenantId, headers, response, data;
         return _regeneratorRuntime().wrap(function _callee2$(_context2) {
           while (1) switch (_context2.prev = _context2.next) {
             case 0:
+              fetchRevision = ++this.fetchRevision;
               getData = (_this$appPlugin = this.appPlugin) === null || _this$appPlugin === void 0 || (_this$appPlugin$getDa = _this$appPlugin.getData) === null || _this$appPlugin$getDa === void 0 ? void 0 : _this$appPlugin$getDa.call(_this$appPlugin);
               shopId = getData === null || getData === void 0 ? void 0 : getData('shop_id');
               if (shopId) {
-                _context2.next = 4;
+                _context2.next = 5;
                 break;
               }
               throw new Error('[OpenDataModule] 无法获取 shop_id');
-            case 4:
+            case 5:
               tenantId = getData === null || getData === void 0 ? void 0 : getData('tenant_id');
               headers = {};
               if (tenantId) headers['Tenant-Id'] = String(tenantId);
-              _context2.next = 9;
+              _context2.next = 10;
               return this.request.post("/open/my-pisell/".concat(shopId, "/setting"), {
                 scope: params.scope,
                 target: params.target,
@@ -132,17 +132,19 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
                 prefix: false,
                 headers: headers
               });
-            case 9:
+            case 10:
               response = _context2.sent;
               if (!((response === null || response === void 0 ? void 0 : response.status) === false)) {
-                _context2.next = 12;
+                _context2.next = 13;
                 break;
               }
               throw new Error((response === null || response === void 0 ? void 0 : response.message) || '获取 OpenData 配置失败');
-            case 12:
-              data = (response === null || response === void 0 ? void 0 : response.data) || {};
-              this.store.data = data;
-              this.store.lastFetchedAt = Date.now();
+            case 13:
+              data = (response === null || response === void 0 ? void 0 : response.data) || {}; // clearCache() 或后续请求发生后，旧响应不得复活已失效的 target 配置。
+              if (fetchRevision === this.fetchRevision) {
+                this.store.data = data;
+                this.store.lastFetchedAt = Date.now();
+              }
               return _context2.abrupt("return", data);
             case 16:
             case "end":
@@ -160,6 +162,16 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
     value: function getOpenData() {
       return this.store.data;
     }
+  }, {
+    key: "getInvoiceLayoutConfig",
+    value: function getInvoiceLayoutConfig() {
+      return normalizeInvoiceLayoutConfig(this.store.data);
+    }
+  }, {
+    key: "getInvoiceTemplateSettings",
+    value: function getInvoiceTemplateSettings() {
+      return normalizeInvoiceTemplateSettings(this.store.data);
+    }
   }, {
     key: "getLastFetchedAt",
     value: function getLastFetchedAt() {
@@ -171,6 +183,7 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "clearCache",
     value: function clearCache() {
+      this.fetchRevision += 1;
       this.store.data = null;
       this.store.lastFetchedAt = null;
     }

package/dist/modules/OpenData/types.d.ts

@@ -8,6 +8,40 @@ export interface MultiLangObject {
     original?: string;
     [key: string]: string | undefined;
 }
+export declare const INVOICE_MODULE_KEYS: readonly ["reference", "brand", "custom_1", "order", "handover", "customer", "line_groups", "settlement", "custom_2", "payment", "card", "total_savings", "custom_3", "barcode"];
+export type InvoiceModuleKey = (typeof INVOICE_MODULE_KEYS)[number];
+/**
+ * Documents Registry 中的 Invoice 模块配置。
+ *
+ * 模块 key、显隐值及模块私有字段均由 Registry/Native 约定，OS 不做枚举收窄或改写。
+ */
+export interface InvoiceTemplateModuleConfig {
+    key: string;
+    is_show?: unknown;
+    [key: string]: unknown;
+}
+export interface InvoiceModuleConfig extends InvoiceTemplateModuleConfig {
+}
+export interface InvoiceLayoutConfig {
+    locale?: string;
+    module: InvoiceModuleConfig[];
+}
+export interface InvoiceTemplateSettings {
+    template: string;
+    language: Record<string, number>;
+    modules: InvoiceTemplateModuleConfig[];
+    [key: string]: unknown;
+}
+export type RawInvoiceEditConfig = string | {
+    language?: unknown;
+    modules?: unknown;
+    [key: string]: unknown;
+};
+export type RawInvoiceLayoutConfig = string | {
+    locale?: unknown;
+    module?: unknown[];
+    [key: string]: unknown;
+};
 export interface OpenDataConfig {
     'basic.enable'?: boolean;
     'basic.code'?: string | null;
@@ -45,6 +79,14 @@ export interface OpenDataConfig {
         label: string;
         value: number;
     }>;
+    'documents.invoice_template'?: string;
+    'documents.invoice_edit'?: RawInvoiceEditConfig;
+    /** @deprecated 仅保留旧调用方的类型兼容，Invoice 读取逻辑不再消费该字段。 */
+    'documents.invoice'?: RawInvoiceLayoutConfig;
+    /** @deprecated Invoice 读取逻辑只消费扁平的 documents.invoice_* 字段。 */
+    documents?: {
+        invoice?: RawInvoiceLayoutConfig;
+    };
     [key: string]: any;
 }
 export interface OpenDataState {

package/dist/modules/OpenData/types.js

@@ -1 +1,7 @@
-export {};
+export var INVOICE_MODULE_KEYS = ['reference', 'brand', 'custom_1', 'order', 'handover', 'customer', 'line_groups', 'settlement', 'custom_2', 'payment', 'card', 'total_savings', 'custom_3', 'barcode'];
+
+/**
+ * Documents Registry 中的 Invoice 模块配置。
+ *
+ * 模块 key、显隐值及模块私有字段均由 Registry/Native 约定，OS 不做枚举收窄或改写。
+ */

package/dist/modules/OpenData/utils.d.ts

@@ -1,2 +1,16 @@
-import type { OpenDataAvailabilityResult, ComputeAvailabilityParams } from './types';
+import type { OpenDataConfig, OpenDataAvailabilityResult, ComputeAvailabilityParams, InvoiceLayoutConfig, InvoiceTemplateSettings } from './types';
+export declare function getDefaultInvoiceLayoutConfig(): InvoiceLayoutConfig;
+export declare function getDefaultInvoiceTemplateSettings(): InvoiceTemplateSettings;
+/**
+ * 规范化已经提取出的公开 template_settings 值，供打印入口复用。
+ */
+export declare function normalizeRawInvoiceTemplateSettings(value: unknown): InvoiceTemplateSettings;
+/**
+ * 从 OpenData Documents section 的两个扁平字段中构造 Native Invoice 配置。
+ */
+export declare function normalizeInvoiceTemplateSettings(config: OpenDataConfig | null | undefined): InvoiceTemplateSettings;
+/**
+ * 将 invoice_edit.modules 原样投影为 Web Invoice 使用的 module 字段。
+ */
+export declare function normalizeInvoiceLayoutConfig(config: OpenDataConfig | null | undefined): InvoiceLayoutConfig;
 export declare function computeAvailability(params: ComputeAvailabilityParams): OpenDataAvailabilityResult;

package/dist/modules/OpenData/utils.js

@@ -1,6 +1,91 @@
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 import dayjs from 'dayjs';
 import { getDateIsInSchedule } from "../Schedule/getDateIsInSchedule";
+function isRecord(value) {
+  return !!value && _typeof(value) === 'object' && !Array.isArray(value);
+}
+function parseInvoiceRecord(value) {
+  var parsed = value;
+  if (typeof parsed === 'string') {
+    try {
+      parsed = JSON.parse(parsed);
+    } catch (_unused) {
+      return null;
+    }
+  }
+  return isRecord(parsed) ? parsed : null;
+}
+export function getDefaultInvoiceLayoutConfig() {
+  return {
+    module: []
+  };
+}
+export function getDefaultInvoiceTemplateSettings() {
+  return {
+    template: 'DEFAULT',
+    language: {},
+    modules: []
+  };
+}
+function normalizeInvoiceTemplate(value) {
+  if (typeof value !== 'string' || value.trim().length === 0) return 'DEFAULT';
+  return value.trim().toUpperCase() === 'DEFAULT' ? 'DEFAULT' : value;
+}
+function normalizeInvoiceLanguage(value) {
+  if (!isRecord(value)) return {};
+  if (Object.values(value).some(function (item) {
+    return typeof item !== 'number';
+  })) return {};
+  return _objectSpread({}, value);
+}
+function normalizeInvoiceModules(value) {
+  if (!Array.isArray(value)) return [];
+  if (value.some(function (item) {
+    return !isRecord(item) || typeof item.key !== 'string';
+  })) {
+    return [];
+  }
+  return value.map(function (item) {
+    return _objectSpread({}, item);
+  });
+}
+
+/**
+ * 规范化已经提取出的公开 template_settings 值，供打印入口复用。
+ */
+export function normalizeRawInvoiceTemplateSettings(value) {
+  var parsed = parseInvoiceRecord(value);
+  if (!parsed) return getDefaultInvoiceTemplateSettings();
+  return _objectSpread(_objectSpread({}, parsed), {}, {
+    template: normalizeInvoiceTemplate(parsed.template),
+    language: normalizeInvoiceLanguage(parsed.language),
+    modules: normalizeInvoiceModules(parsed.modules)
+  });
+}
+
+/**
+ * 从 OpenData Documents section 的两个扁平字段中构造 Native Invoice 配置。
+ */
+export function normalizeInvoiceTemplateSettings(config) {
+  var parsedEdit = parseInvoiceRecord(config === null || config === void 0 ? void 0 : config['documents.invoice_edit']);
+  return normalizeRawInvoiceTemplateSettings(_objectSpread(_objectSpread({}, parsedEdit !== null && parsedEdit !== void 0 ? parsedEdit : {}), {}, {
+    template: normalizeInvoiceTemplate(config === null || config === void 0 ? void 0 : config['documents.invoice_template'])
+  }));
+}
+
+/**
+ * 将 invoice_edit.modules 原样投影为 Web Invoice 使用的 module 字段。
+ */
+export function normalizeInvoiceLayoutConfig(config) {
+  return {
+    module: normalizeInvoiceTemplateSettings(config).modules
+  };
+}
 function toBoolean(value) {
   if (typeof value === 'boolean') return value;
   if (typeof value === 'string') return value === 'true' || value === '1';

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

@@ -182,6 +182,8 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private calculateOrderPaidPaymentTotal;
     private getDepositAmount;
     private normalizeDepositAmount;
+    private normalizeDepositFlag;
+    private getHistoricalDepositSnapshot;
     private getLastOrderDepositSnapshot;
     private getLastOrderSubmitSnapshot;
     private applyDepositAmountToSummary;
@@ -526,7 +528,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     generateIdempotencyToken(): string;
     syncPaymentsToOrder<T = any>(params: SyncPaymentsToOrderParams): Promise<SyncPaymentsToOrderResult<T>>;
     createOrder(params: CommitOrderParams['query']): {
-        type: "appointment_booking" | "virtual";
+        type: "virtual" | "appointment_booking";
         platform: string;
         sales_channel: string;
         order_sales_channel: string;
@@ -576,7 +578,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      */
     hydrateTempOrderFromRecord(record: Record<string, any>, options?: {
         recalcOnHydrate?: boolean;
-        source?: 'salesDetail' | 'sessionStorage';
+        source?: 'salesDetail' | 'mergedSalesDetail' | 'sessionStorage';
     }): Promise<OrderTempOrder>;
     /**
      * 兼容后端详情将 holder 放在 metadata.holder 的历史形态，统一补到运行时展示路径。