@pisell/private-materials 6.12.167 → 6.12.169

package/es/components/HDLKiosk/ui/controllers/useHDLKioskActionDispatcher.js

@@ -0,0 +1,66 @@
+import { createWorkflowEvent } from "../workflowEvent.js";
+import { useCallback, useEffect, useRef, useState } from "react";
+//#region src/components/HDLKiosk/ui/controllers/useHDLKioskActionDispatcher.ts
+/**
+* 文件角色：把 Slice UI Action 适配为当前 Workflow Session 的 Event 或 Command。
+* 运行机制：统一生成 intent ID，并只投影当前节点发起的 Screen Command 状态。
+* 边界：不决定业务跳转、不解释 Operation 结果，也不拥有 Session 生命周期。
+*/
+function useHDLKioskActionDispatcher({ session, snapshot, activityId, resetSession }) {
+	const intentSequence = useRef(0);
+	const commandSequence = useRef(0);
+	const commandGeneration = useRef(0);
+	const pendingCommands = useRef(/* @__PURE__ */ new Map());
+	const [commandState, setCommandState] = useState({ busy: false });
+	useEffect(() => {
+		commandGeneration.current += 1;
+		pendingCommands.current.clear();
+		setCommandState({ busy: false });
+		return () => {
+			commandGeneration.current += 1;
+			pendingCommands.current.clear();
+		};
+	}, [session, snapshot.nodeId]);
+	return {
+		send: useCallback((action) => {
+			if (action.kind === "session") {
+				resetSession();
+				return;
+			}
+			intentSequence.current += 1;
+			const intentId = `ui:${snapshot.sessionEpoch}:${intentSequence.current}`;
+			if (action.kind === "intent" || action.kind === "navigation") {
+				const event = createWorkflowEvent(action, activityId, snapshot.nodeId, intentId);
+				if (event) session.dispatch(event);
+				return;
+			}
+			commandSequence.current += 1;
+			const execution = commandSequence.current;
+			const generation = commandGeneration.current;
+			pendingCommands.current.set(execution, action.command);
+			setCommandState({
+				busy: true,
+				commandId: action.command
+			});
+			session.executeCommand(action.command, action.input, intentId).then((result) => {
+				if (generation !== commandGeneration.current) return;
+				pendingCommands.current.delete(execution);
+				const remaining = [...pendingCommands.current.values()];
+				setCommandState({
+					busy: remaining.length > 0,
+					commandId: remaining[remaining.length - 1],
+					error: result.status === "failed" || result.status === "partialFailure" || result.status === "unknown" ? result.error : void 0
+				});
+			});
+		}, [
+			activityId,
+			resetSession,
+			session,
+			snapshot.nodeId,
+			snapshot.sessionEpoch
+		]),
+		commandState
+	};
+}
+//#endregion
+export { useHDLKioskActionDispatcher };

package/es/components/HDLKiosk/{runtime → ui}/controllers/useHDLKioskCustomerController.js

@@ -1,6 +1,6 @@
 import { _asyncToGenerator } from "../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-//#region src/components/HDLKiosk/runtime/controllers/useHDLKioskCustomerController.ts
+//#region src/components/HDLKiosk/ui/controllers/useHDLKioskCustomerController.ts
 /**
 * 文件角色：协调 Shell 全程可用的会员入口与插入式身份同步。
 * 运行机制：登录成功后通过 identity.sync 写入客户并触发订单一致性/重报价；再根据最新

package/es/components/HDLKiosk/ui/controllers/useHDLKioskDeviceController.js

@@ -0,0 +1,25 @@
+import { useEffect, useState } from "react";
+//#region src/components/HDLKiosk/ui/controllers/useHDLKioskDeviceController.ts
+/**
+* 文件角色：把 Scale 连接状态投影给 React Entry。
+* 运行机制：只观察 connectionChanged；称重启动完全由 Runtime 的 onWeight Adapter 持有。
+* 边界：不消费重量、不创建 Session，也不参与 Trigger 路由。
+*/
+function useHDLKioskDeviceController({ host, isActive }) {
+	const [scaleConnectionState, setScaleConnectionState] = useState();
+	useEffect(() => {
+		setScaleConnectionState(void 0);
+	}, [host]);
+	useEffect(() => {
+		if (!isActive || !host.capabilities.scale.available) return void 0;
+		return host.devices.subscribe((event) => {
+			if (event.type === "connectionChanged" && event.device === "scale") {
+				var _event$state;
+				setScaleConnectionState((_event$state = event.state) !== null && _event$state !== void 0 ? _event$state : event.connected ? "connected" : "disconnected");
+			}
+		}, { sources: ["scale"] });
+	}, [host, isActive]);
+	return { scaleConnectionState };
+}
+//#endregion
+export { useHDLKioskDeviceController };

package/es/components/HDLKiosk/ui/controllers/useHDLKioskExitController.js

@@ -0,0 +1,53 @@
+import { useCallback, useEffect, useRef } from "react";
+//#region src/components/HDLKiosk/ui/controllers/useHDLKioskExitController.ts
+/**
+* 文件角色：适配 Session Exit Navigation 与验证式订单重置。
+* 运行机制：用户退出先经过 Actor Guard/确认；自动退出直接解析既有 Pending Navigation，
+* 两者最终都调用 Runtime 提供的 returnToEntry。
+* 边界：不拥有 reset pending/error，也不渲染确认弹层。
+*/
+function useHDLKioskExitController({ session, snapshot, returnToEntry }) {
+	var _snapshot$pendingNavi, _snapshot$pendingNavi2;
+	const sequence = useRef(0);
+	const pendingConfirmation = ((_snapshot$pendingNavi = snapshot.pendingNavigation) === null || _snapshot$pendingNavi === void 0 ? void 0 : _snapshot$pendingNavi.request.kind) === "confirmEndOrder" ? snapshot.pendingNavigation : void 0;
+	const pendingAutomaticExit = ((_snapshot$pendingNavi2 = snapshot.pendingNavigation) === null || _snapshot$pendingNavi2 === void 0 ? void 0 : _snapshot$pendingNavi2.request.kind) === "performSessionExit" ? snapshot.pendingNavigation : void 0;
+	const resetSession = useCallback(() => {
+		returnToEntry("ui");
+	}, [returnToEntry]);
+	const requestEndOrder = useCallback(() => {
+		sequence.current += 1;
+		session.actor.navigate({
+			kind: "sessionExit",
+			reason: "userRequest"
+		}, `ui:${snapshot.sessionEpoch}:exit:${sequence.current}`);
+	}, [session.actor, snapshot.sessionEpoch]);
+	const cancelEndOrder = useCallback(() => {
+		if (!pendingConfirmation) return;
+		session.actor.resolvePendingNavigation(pendingConfirmation.navigationId, "cancel");
+	}, [pendingConfirmation, session.actor]);
+	const confirmEndOrder = useCallback(() => {
+		if (!pendingConfirmation || !session.actor.resolvePendingNavigation(pendingConfirmation.navigationId, "allow")) return;
+		resetSession();
+	}, [
+		pendingConfirmation,
+		resetSession,
+		session.actor
+	]);
+	useEffect(() => {
+		if (!pendingAutomaticExit || !session.actor.resolvePendingNavigation(pendingAutomaticExit.navigationId, "allow")) return;
+		resetSession();
+	}, [
+		pendingAutomaticExit,
+		resetSession,
+		session.actor
+	]);
+	return {
+		endOrderConfirmationOpen: Boolean(pendingConfirmation),
+		resetSession,
+		requestEndOrder,
+		cancelEndOrder,
+		confirmEndOrder
+	};
+}
+//#endregion
+export { useHDLKioskExitController };

package/es/components/HDLKiosk/{runtime → ui}/controllers/useHDLKioskScreenData.js

@@ -1,5 +1,5 @@
 import { useEffect, useState } from "react";
-//#region src/components/HDLKiosk/runtime/controllers/useHDLKioskScreenData.ts
+//#region src/components/HDLKiosk/ui/controllers/useHDLKioskScreenData.ts
 /**
 * 文件角色：按当前 Screen 集中加载页面所需的 Catalog/称重/定制商品数据。
 * 运行机制：观察当前节点，调用 Host read/query 能力并输出 loading/ready/error 数据，

package/es/components/HDLKiosk/ui/controllers/useHDLKioskSessionController.js

@@ -0,0 +1,39 @@
+import { createHDLKioskApplicationRuntime } from "../../runtime/createRuntime.js";
+import { useCallback, useEffect, useMemo, useSyncExternalStore } from "react";
+//#region src/components/HDLKiosk/ui/controllers/useHDLKioskSessionController.ts
+/**
+* 文件角色：把 React Entry 状态适配到无头 Application Runtime。
+* 运行机制：Controller 只处理能力/可见性和 UI pending；Trigger 路由、Session 创建、
+* ensure、单会话准入与销毁均由 Runtime 持有。
+* 边界：不直接创建 Actor，也不消费具体 Screen 的局部交互。
+*/
+function useHDLKioskSessionController({ host, config, isActive }) {
+	const applicationRuntime = useMemo(() => createHDLKioskApplicationRuntime(host, { config }), [config, host]);
+	const snapshot = useSyncExternalStore(applicationRuntime.subscribe, applicationRuntime.getSnapshot, applicationRuntime.getSnapshot);
+	useEffect(() => {
+		return () => applicationRuntime.dispose();
+	}, [applicationRuntime]);
+	useEffect(() => {
+		if (!isActive) {
+			applicationRuntime.deactivate();
+			return;
+		}
+		applicationRuntime.activate();
+		return () => applicationRuntime.deactivate();
+	}, [applicationRuntime, isActive]);
+	const start = useCallback(({ entry }) => applicationRuntime.start(entry), [applicationRuntime]);
+	const completeReset = useCallback((completedSession) => applicationRuntime.completeReset(completedSession), [applicationRuntime]);
+	const returnToEntry = useCallback((reason = "application") => applicationRuntime.returnToEntry(reason), [applicationRuntime]);
+	return {
+		session: snapshot.session,
+		starting: snapshot.starting,
+		startErrorReference: snapshot.startErrorReference,
+		returning: snapshot.returning,
+		returnError: snapshot.returnError,
+		start,
+		completeReset,
+		returnToEntry
+	};
+}
+//#endregion
+export { useHDLKioskSessionController };

package/es/components/HDLKiosk/{app → ui}/entry/Screen/index.js

@@ -1,6 +1,6 @@
 import React, { useState } from "react";
 import { locales } from "@pisell/utils";
-//#region src/components/HDLKiosk/app/entry/Screen/index.tsx
+//#region src/components/HDLKiosk/ui/entry/Screen/index.tsx
 const LANGUAGE_OPTIONS = Object.freeze([
 	{
 		value: "en",
@@ -23,10 +23,12 @@ const LANGUAGE_OPTIONS = Object.freeze([
 		label: "Português"
 	}
 ]);
-function BrandMark() {
-	return /* @__PURE__ */ React.createElement("span", {
+function BrandMark({ onClick }) {
+	return /* @__PURE__ */ React.createElement("button", {
 		className: "hdl-entry-brand-mark",
-		"aria-label": "Hi Malatang"
+		type: "button",
+		"aria-label": "打开称重模拟器",
+		onClick
 	}, "Hi");
 }
 function GlobeIcon() {
@@ -176,7 +178,7 @@ function EntryGraphic({ entry }) {
 	if (entry === "barcode") return /* @__PURE__ */ React.createElement(BarcodeGraphic, null);
 	return /* @__PURE__ */ React.createElement(ScaleGraphic, null);
 }
-function EntryScreen({ locale, model, onLocaleChange, onTechnicalSupportClick, onSelect, busy = false, errorReference, errorMessage = "Unable to start a safe order session." }) {
+function EntryScreen({ locale, model, onLocaleChange, onTechnicalSupportClick, onScaleSimulatorRequest, onSelect, busy = false, errorReference, errorMessage = "Unable to start a safe order session." }) {
 	const [reachMode, setReachMode] = useState(false);
 	const entryLocale = locale || "en";
 	return /* @__PURE__ */ React.createElement("section", {
@@ -202,7 +204,7 @@ function EntryScreen({ locale, model, onLocaleChange, onTechnicalSupportClick, o
 	}, /* @__PURE__ */ React.createElement("path", { d: "M112 248c-52-38-43-88-5-118 33-26 40-71 3-116" })), /* @__PURE__ */ React.createElement("svg", {
 		className: "hdl-entry-steam hdl-entry-steam--two",
 		viewBox: "0 0 180 260"
-	}, /* @__PURE__ */ React.createElement("path", { d: "M71 250c38-41 22-78-6-111-31-37-19-78 16-125" })), /* @__PURE__ */ React.createElement("span", null), /* @__PURE__ */ React.createElement("span", null), /* @__PURE__ */ React.createElement("span", null), /* @__PURE__ */ React.createElement("span", null), /* @__PURE__ */ React.createElement("span", null), /* @__PURE__ */ React.createElement("span", null)), /* @__PURE__ */ React.createElement("header", { className: "hdl-entry-screen__header" }, /* @__PURE__ */ React.createElement("div", { className: "hdl-entry-brand" }, /* @__PURE__ */ React.createElement(BrandMark, null), /* @__PURE__ */ React.createElement("span", { className: "hdl-entry-brand__copy" }, /* @__PURE__ */ React.createElement("strong", null, locales.getText("pisell2.hdl-kiosk.brand")), /* @__PURE__ */ React.createElement("small", null, "MALA · TANG"))), /* @__PURE__ */ React.createElement("label", { className: "hdl-entry-language" }, /* @__PURE__ */ React.createElement(GlobeIcon, null), /* @__PURE__ */ React.createElement("select", {
+	}, /* @__PURE__ */ React.createElement("path", { d: "M71 250c38-41 22-78-6-111-31-37-19-78 16-125" })), /* @__PURE__ */ React.createElement("span", null), /* @__PURE__ */ React.createElement("span", null), /* @__PURE__ */ React.createElement("span", null), /* @__PURE__ */ React.createElement("span", null), /* @__PURE__ */ React.createElement("span", null), /* @__PURE__ */ React.createElement("span", null)), /* @__PURE__ */ React.createElement("header", { className: "hdl-entry-screen__header" }, /* @__PURE__ */ React.createElement("div", { className: "hdl-entry-brand" }, /* @__PURE__ */ React.createElement(BrandMark, { onClick: onScaleSimulatorRequest }), /* @__PURE__ */ React.createElement("span", { className: "hdl-entry-brand__copy" }, /* @__PURE__ */ React.createElement("strong", null, locales.getText("pisell2.hdl-kiosk.brand")), /* @__PURE__ */ React.createElement("small", null, "MALA · TANG"))), /* @__PURE__ */ React.createElement("label", { className: "hdl-entry-language" }, /* @__PURE__ */ React.createElement(GlobeIcon, null), /* @__PURE__ */ React.createElement("select", {
 		"aria-label": locales.getText("pisell2.hdl-kiosk.entry-language-label"),
 		value: entryLocale,
 		onChange: (event) => onLocaleChange === null || onLocaleChange === void 0 ? void 0 : onLocaleChange(event.target.value)

package/es/components/HDLKiosk/{app → ui}/entry/model.js

@@ -1,6 +1,6 @@
-import { isBuiltInWorkflowProductionReady } from "../workflow/registry.js";
+import { isBuiltInWorkflowProductionReady } from "../../app/workflow/registry.js";
 import { locales } from "@pisell/utils";
-//#region src/components/HDLKiosk/app/entry/model.ts
+//#region src/components/HDLKiosk/ui/entry/model.ts
 function createEntryScreenModel(config, capabilities, scaleConnectionState, hostStatus, entryDataPreparing = false) {
 	const dataPreparing = entryDataPreparing || hostStatus === "loading";
 	const hostUnavailable = hostStatus === "error";

package/es/components/HDLKiosk/ui/scale.js

@@ -0,0 +1,20 @@
+import { createHDLScaleRuntime } from "../runtime/devices/scaleStore.js";
+import React, { createContext, useContext, useSyncExternalStore } from "react";
+//#region src/components/HDLKiosk/ui/scale.tsx
+const HDLScaleRuntimeContext = createContext(createHDLScaleRuntime());
+function HDLScaleRuntimeProvider({ runtime, children }) {
+	return React.createElement(HDLScaleRuntimeContext.Provider, {
+		value: runtime,
+		children
+	});
+}
+function useHDLScaleSnapshot() {
+	const runtime = useContext(HDLScaleRuntimeContext);
+	return useSyncExternalStore(runtime.subscribe, runtime.getSnapshot, runtime.getSnapshot);
+}
+/** 仅供提交边界同步读取点击当下的最新设备快照。 */
+function useHDLScaleRuntime() {
+	return useContext(HDLScaleRuntimeContext);
+}
+//#endregion
+export { HDLScaleRuntimeProvider, useHDLScaleRuntime, useHDLScaleSnapshot };

package/es/components/HDLKiosk/{runtime/useHostSnapshot.js → ui/snapshots.js}

@@ -1,11 +1,6 @@
 import { useCallback, useRef, useSyncExternalStore } from "react";
-//#region src/components/HDLKiosk/runtime/useHostSnapshot.ts
-/**
-* 文件角色：将 Host Sales Projection 安全接入 React。
-* 运行机制：通过 useSyncExternalStore 订阅统一快照，确保同一次 render 读取一致事实并
-* 兼容 Host 对象身份稳定、内部来源变化的情况。
-* 边界：只读，不触发 load/recalc，也不复制一份 React 订单状态。
-*/
+//#region src/components/HDLKiosk/ui/snapshots.ts
+/** 将纯 Host 与 Workflow 快照安全接入 React，不发送命令或派生业务事实。 */
 function useHostSnapshot(host) {
 	const cacheRef = useRef();
 	const getSnapshot = useCallback(() => {
@@ -20,5 +15,8 @@ function useHostSnapshot(host) {
 	}, [host]);
 	return useSyncExternalStore(host.sales.subscribe, getSnapshot, getSnapshot);
 }
+function useWorkflowSnapshot(actor) {
+	return useSyncExternalStore(actor.subscribe, actor.getSnapshot, actor.getSnapshot);
+}
 //#endregion
-export { useHostSnapshot };
+export { useHostSnapshot, useWorkflowSnapshot };

package/es/components/HDLKiosk/{app → ui}/views.js

@@ -4,7 +4,7 @@ import { renderFulfillment } from "../slices/fulfillment/view.js";
 import { renderIdentity } from "../slices/identity/view.js";
 import { renderPayment } from "../slices/payment/view.js";
 import { renderPrimaryProductPrompt } from "../slices/primaryProductPrompt/view.js";
-//#region src/components/HDLKiosk/app/views.ts
+//#region src/components/HDLKiosk/ui/views.ts
 const hdlKioskViews = Object.freeze({
 	identity: renderIdentity,
 	fulfillment: renderFulfillment,

package/es/components/HDLKiosk/{runtime → ui}/workflowEvent.js

@@ -1,6 +1,6 @@
 import { _objectSpread2 } from "../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js";
 import { _objectWithoutProperties } from "../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectWithoutProperties.js";
-//#region src/components/HDLKiosk/runtime/workflowEvent.ts
+//#region src/components/HDLKiosk/ui/workflowEvent.ts
 const _excluded = ["kind"];
 function createWorkflowEvent(action, currentActivity, stepId, intentId) {
 	if (action.activityId !== currentActivity) return void 0;

package/es/components/HDLKiosk/utils.js

@@ -56,10 +56,10 @@ function createCartDrawerModel(sales, primaryWeightedProductId) {
 		totalLabel: totalText ? locales.getText("pisell2.hdl-kiosk.total") : locales.getText("pisell2.hdl-kiosk.total-calculating")
 	});
 }
-function createActivityScreenModel(screenId, snapshot, node, sales, businessMode = "prototype") {
+function createActivityScreenModel(surfaceId, snapshot, node, sales, businessMode = "prototype") {
 	let title;
 	let description;
-	switch (screenId) {
+	switch (surfaceId) {
 		case "entry":
 			title = locales.getText("pisell2.hdl-kiosk.entry-title");
 			description = locales.getText("pisell2.hdl-kiosk.entry-supporting");
@@ -85,12 +85,12 @@ function createActivityScreenModel(screenId, snapshot, node, sales, businessMode
 			description = locales.getText("pisell2.hdl-kiosk.checkout-title");
 			break;
 	}
-	const canReviewCatalog = screenId !== "catalog" || sales.cart.lineCount > 0;
+	const canReviewCatalog = surfaceId !== "catalog" || sales.cart.lineCount > 0;
 	const placeholder = node.readiness === "placeholder";
 	const placeholderBlocked = placeholder && businessMode === "production";
 	const error = resolveHDLKioskErrorPresentation({ error: snapshot.lastError });
 	return Object.freeze({
-		screenId,
+		surfaceId,
 		activity: node.activity,
 		title,
 		description,

package/es/components/bigSale/templates/HDLKiosk/adapter/HDLKioskPaymentRuntime.js

@@ -105,7 +105,7 @@ function HDLKioskPaymentRuntime({ context, controllerRef }) {
 				const amount = currentAmount(context);
 				if (amount <= 0) return failed("paymentAmountInvalid", "back");
 				const runtime = runtimeRef.current;
-				if (!runtime) return unknown("paymentRuntimeUnavailable");
+				if (!runtime) return failed("paymentRuntimeUnavailable", "retry");
 				const piProvider = resolvePiPaymentProvider(method.code, Boolean((_engineContext$appHel2 = engineContext.appHelper) === null || _engineContext$appHel2 === void 0 || (_engineContext$appHel2 = _engineContext$appHel2.utils) === null || _engineContext$appHel2 === void 0 || (_engineContext$appHel2 = _engineContext$appHel2.businessUtils) === null || _engineContext$appHel2 === void 0 || (_engineContext$appHel3 = _engineContext$appHel2.isPiPaymentEnabled) === null || _engineContext$appHel3 === void 0 ? void 0 : _engineContext$appHel3.call(_engineContext$appHel2)));
 				let prepared;
 				let shouldDiscardPrepared = false;
@@ -182,6 +182,7 @@ function HDLKioskPaymentRuntime({ context, controllerRef }) {
 					} catch (discardError) {
 						return unknown("eftposPendingRollbackFailed", discardError);
 					}
+					if (prepared && !shouldDiscardPrepared) return unknown("eftposPaymentFinalizationUnresolved", error);
 					return failed("eftposPaymentFailed", "retry", error);
 				}
 			});

package/es/components/bigSale/templates/HDLKiosk/adapter/capabilities.js

@@ -6,7 +6,7 @@ function resolveBigSaleHDLKioskCapabilities(context, options = {}) {
 	const canUpdateCustomizedProduct = typeof context.cart.updateItem === "function" && typeof (bookingTicket === null || bookingTicket === void 0 ? void 0 : bookingTicket.transformDetailToProductAndBooking) === "function";
 	return {
 		session: {
-			ensure: typeof context.sales.createNew === "function",
+			ensure: typeof context.sales.createNew === "function" && typeof context.sales.clearCartAndReset === "function",
 			reset: typeof context.sales.clearCartAndReset === "function"
 		},
 		cart: {

package/es/components/bigSale/templates/HDLKiosk/adapter/projection.js

@@ -8,6 +8,15 @@ import Decimal from "decimal.js";
 * 仅在语义变化时推进 observationId。
 * 边界：Projection 只读且不是第二个 Store；不得在这里执行 load、写入或前端定价。
 */
+/**
+* 交易门禁必须优先读取 OS 同步真源。SalesSDK reset 已完成但 React RootSnapshot
+* 尚未提交时，context.tempOrder 可能仍是上一笔 paid 订单。
+*/
+function resolveBigSaleLiveTempOrder(context) {
+	const bookingTicket = context.sales.bookingTicket;
+	if (typeof (bookingTicket === null || bookingTicket === void 0 ? void 0 : bookingTicket.getTempOrder) === "function") return bookingTicket.getTempOrder();
+	return context.sales.tempOrder;
+}
 function getProduct(line) {
 	return "product_id" in line ? line : line._extend.product;
 }
@@ -93,9 +102,10 @@ function projectBigSaleCartLine(line) {
 	});
 }
 function normalizePayment(context, cartLineCount) {
-	var _context$sales$tempOr, _context$sales$tempOr2, _context$sales$tempOr3, _context$summary$summ;
-	const paymentStatus = String((_context$sales$tempOr = (_context$sales$tempOr2 = context.sales.tempOrder) === null || _context$sales$tempOr2 === void 0 ? void 0 : _context$sales$tempOr2.payment_status) !== null && _context$sales$tempOr !== void 0 ? _context$sales$tempOr : "").toLowerCase();
-	const orderId = (_context$sales$tempOr3 = context.sales.tempOrder) === null || _context$sales$tempOr3 === void 0 ? void 0 : _context$sales$tempOr3.order_id;
+	var _tempOrder$payment_st, _context$summary$summ;
+	const tempOrder = resolveBigSaleLiveTempOrder(context);
+	const paymentStatus = String((_tempOrder$payment_st = tempOrder === null || tempOrder === void 0 ? void 0 : tempOrder.payment_status) !== null && _tempOrder$payment_st !== void 0 ? _tempOrder$payment_st : "").toLowerCase();
+	const orderId = tempOrder === null || tempOrder === void 0 ? void 0 : tempOrder.order_id;
 	const amount = (_context$summary$summ = context.summary.summary) === null || _context$summary$summ === void 0 ? void 0 : _context$summary$summ.total_amount;
 	if (paymentStatus === "paid" && orderId != null && amount != null) return Object.freeze({
 		status: "succeeded",
@@ -118,19 +128,19 @@ function resolveHDLKioskPickupReferenceMode(openData) {
 	return (openData === null || openData === void 0 ? void 0 : openData["fulfillment.fulfillment_ref_mode"]) === "sale_number" ? "sale_number" : "short_number";
 }
 function resolvePickupNumber(context, mode) {
-	var _context$sales$tempOr4;
+	var _context$sales$tempOr;
 	const field = mode === "sale_number" ? "shop_order_number" : "shop_full_order_number";
-	return ((_context$sales$tempOr4 = context.sales.tempOrder) === null || _context$sales$tempOr4 === void 0 ? void 0 : _context$sales$tempOr4[field]) || void 0;
+	return ((_context$sales$tempOr = context.sales.tempOrder) === null || _context$sales$tempOr === void 0 ? void 0 : _context$sales$tempOr[field]) || void 0;
 }
 function buildSnapshot(context, observationId, pickupReferenceMode) {
-	var _context$cart$display, _context$sales$tempOr5, _context$sales$tempOr6, _context$sales$tempOr7, _context$sales$tempOr8, _context$customer$sel, _context$customer$sel2, _context$sales$tempOr9, _context$sales$tempOr10, _customer$customerId, _context$sales$tempOr11;
+	var _context$cart$display, _context$sales$tempOr2, _context$sales$tempOr3, _context$sales$tempOr4, _context$sales$tempOr5, _context$customer$sel, _context$customer$sel2, _context$sales$tempOr6, _context$sales$tempOr7, _customer$customerId, _context$sales$tempOr8;
 	const rawLines = (_context$cart$display = context.cart.displayLines) !== null && _context$cart$display !== void 0 ? _context$cart$display : context.cart.items;
 	const lines = Object.freeze(rawLines.map(projectBigSaleCartLine).filter((line) => line !== null));
 	const summary = context.summary.summary;
 	const normalizedSummary = summary ? Object.freeze({
 		status: "ready",
-		currency: String((_context$sales$tempOr5 = (_context$sales$tempOr6 = context.sales.tempOrder) === null || _context$sales$tempOr6 === void 0 ? void 0 : _context$sales$tempOr6.currency_code) !== null && _context$sales$tempOr5 !== void 0 ? _context$sales$tempOr5 : ""),
-		currencySymbol: String((_context$sales$tempOr7 = (_context$sales$tempOr8 = context.sales.tempOrder) === null || _context$sales$tempOr8 === void 0 ? void 0 : _context$sales$tempOr8.currency_symbol) !== null && _context$sales$tempOr7 !== void 0 ? _context$sales$tempOr7 : ""),
+		currency: String((_context$sales$tempOr2 = (_context$sales$tempOr3 = context.sales.tempOrder) === null || _context$sales$tempOr3 === void 0 ? void 0 : _context$sales$tempOr3.currency_code) !== null && _context$sales$tempOr2 !== void 0 ? _context$sales$tempOr2 : ""),
+		currencySymbol: String((_context$sales$tempOr4 = (_context$sales$tempOr5 = context.sales.tempOrder) === null || _context$sales$tempOr5 === void 0 ? void 0 : _context$sales$tempOr5.currency_symbol) !== null && _context$sales$tempOr4 !== void 0 ? _context$sales$tempOr4 : ""),
 		total: String(summary.total_amount),
 		due: String(summary.expect_amount)
 	}) : context.sales.status === "loading" ? Object.freeze({ status: "calculating" }) : Object.freeze({ status: "missing" });
@@ -144,7 +154,7 @@ function buildSnapshot(context, observationId, pickupReferenceMode) {
 		""
 	].includes(String((_context$customer$sel2 = context.customer.selected.id) !== null && _context$customer$sel2 !== void 0 ? _context$customer$sel2 : "")) })) : void 0;
 	const fingerprintValue = [
-		(_context$sales$tempOr9 = (_context$sales$tempOr10 = context.sales.tempOrder) === null || _context$sales$tempOr10 === void 0 ? void 0 : _context$sales$tempOr10.order_id) !== null && _context$sales$tempOr9 !== void 0 ? _context$sales$tempOr9 : "",
+		(_context$sales$tempOr6 = (_context$sales$tempOr7 = context.sales.tempOrder) === null || _context$sales$tempOr7 === void 0 ? void 0 : _context$sales$tempOr7.order_id) !== null && _context$sales$tempOr6 !== void 0 ? _context$sales$tempOr6 : "",
 		...lines.map((line) => `${line.lineId}:${line.quantity}`),
 		normalizedSummary.status === "ready" ? normalizedSummary.due : "",
 		(_customer$customerId = customer === null || customer === void 0 ? void 0 : customer.customerId) !== null && _customer$customerId !== void 0 ? _customer$customerId : ""
@@ -152,7 +162,7 @@ function buildSnapshot(context, observationId, pickupReferenceMode) {
 	return Object.freeze({
 		observationId,
 		hostStatus: context.sales.status,
-		orderId: ((_context$sales$tempOr11 = context.sales.tempOrder) === null || _context$sales$tempOr11 === void 0 ? void 0 : _context$sales$tempOr11.order_id) == null ? void 0 : String(context.sales.tempOrder.order_id),
+		orderId: ((_context$sales$tempOr8 = context.sales.tempOrder) === null || _context$sales$tempOr8 === void 0 ? void 0 : _context$sales$tempOr8.order_id) == null ? void 0 : String(context.sales.tempOrder.order_id),
 		pickupNumber: resolvePickupNumber(context, pickupReferenceMode),
 		cart: Object.freeze({
 			lines,
@@ -183,4 +193,4 @@ function createBigSaleProjectionReader(getContext, getPickupReferenceMode = () =
 	};
 }
 //#endregion
-export { createBigSaleProjectionReader, projectBigSaleCartLine, resolveBigSaleLineId, resolveHDLKioskPickupReferenceMode };
+export { createBigSaleProjectionReader, projectBigSaleCartLine, resolveBigSaleLineId, resolveBigSaleLiveTempOrder, resolveHDLKioskPickupReferenceMode };

package/es/components/bigSale/templates/HDLKiosk/adapter/sales.js

@@ -5,7 +5,7 @@ import { buildProductSkuPatch, resolvePatchProductOptions } from "../../../../..
 import { pickIdentity } from "../../../../../plus/salesSdk/utils/identity.js";
 import { buildProductLineUpdates } from "../../../../../plus/salesSdk/utils/buildProductLineUpdates.js";
 import { resolveHDLWeightedProduct } from "../../../../HDLKiosk/product.js";
-import { projectBigSaleCartLine, resolveBigSaleLineId } from "./projection.js";
+import { projectBigSaleCartLine, resolveBigSaleLineId, resolveBigSaleLiveTempOrder } from "./projection.js";
 import { failed, isRecord, partialFailure, readPath, unknown } from "./normalize.js";
 import { createHDLPrimaryWeightedPreparedProduct } from "./customizationProduct.js";
 import Decimal from "decimal.js";
@@ -22,6 +22,18 @@ function cancelled(reason) {
 		reason
 	};
 }
+const PAYMENT_WRITE_FROZEN_STATUSES = new Set(["payment_pending", "processing"]);
+function readPaymentStatus(order) {
+	var _order$payment_status;
+	return String((_order$payment_status = order === null || order === void 0 ? void 0 : order.payment_status) !== null && _order$payment_status !== void 0 ? _order$payment_status : "").trim().toLowerCase();
+}
+function hasCommittedOrderIdentity(order) {
+	const orderId = order === null || order === void 0 ? void 0 : order.order_id;
+	return orderId !== null && orderId !== void 0 && String(orderId).trim() !== "";
+}
+function isCommittedPaidOrder(order) {
+	return readPaymentStatus(order) === "paid" && hasCommittedOrderIdentity(order);
+}
 function findCartLine(context, lineId) {
 	var _context$cart$display;
 	return ((_context$cart$display = context.cart.displayLines) !== null && _context$cart$display !== void 0 ? _context$cart$display : context.cart.items).find((line) => resolveBigSaleLineId(line) === lineId);
@@ -272,13 +284,19 @@ function createBigSaleSalesPort({ getContext, getSnapshot, executeScan, writeFul
 			var _ref7 = _asyncToGenerator(function* (signal) {
 				if (signal.aborted) return { status: "cancelled" };
 				const context = getContext();
-				if (context.sales.tempOrder) return {
+				const currentOrder = resolveBigSaleLiveTempOrder(context);
+				const currentPaymentStatus = readPaymentStatus(currentOrder);
+				if (PAYMENT_WRITE_FROZEN_STATUSES.has(currentPaymentStatus)) return unknown("ensureSessionPaymentInProgress");
+				if (currentOrder && !isCommittedPaidOrder(currentOrder)) return {
 					status: "succeeded",
 					data: void 0
 				};
 				try {
-					yield context.sales.createNew();
+					const createdOrder = isCommittedPaidOrder(currentOrder) ? yield context.sales.clearCartAndReset() : yield context.sales.createNew();
 					if (signal.aborted) return unknown("ensureSessionAbortedAfterDispatch");
+					const liveCreatedOrder = resolveBigSaleLiveTempOrder(getContext());
+					const createdPaymentStatus = readPaymentStatus(liveCreatedOrder !== null && liveCreatedOrder !== void 0 ? liveCreatedOrder : createdOrder);
+					if (isCommittedPaidOrder(liveCreatedOrder !== null && liveCreatedOrder !== void 0 ? liveCreatedOrder : createdOrder) || PAYMENT_WRITE_FROZEN_STATUSES.has(createdPaymentStatus)) return unknown("ensureSessionNotWritable");
 					return {
 						status: "succeeded",
 						data: void 0

package/es/components/bigSale/templates/HDLKiosk/adapter/scaleTrigger.js

@@ -1,6 +1,6 @@
 import { _defineProperty } from "../../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/defineProperty.js";
 import { _objectSpread2 } from "../../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js";
-import React, { Component, useEffect, useRef } from "react";
+import React, { Component, useCallback, useEffect, useRef, useState } from "react";
 //#region src/components/bigSale/templates/HDLKiosk/adapter/scaleTrigger.tsx
 /**
 * 文件角色：拥有 BigSale 的 useNativeScale Hook，并桥接到 HDLKiosk 全局 Scale Runtime。
@@ -86,11 +86,21 @@ function ActiveScaleRuntimeOwner({ active, hub, minimumWeightKg, ownerId, runtim
 	const consumedReadingRef = useRef(false);
 	const lastConnectionStateRef = useRef();
 	const eventSequenceRef = useRef(0);
+	const [sample, setSample] = useState({
+		sequence: 0,
+		receivedAt: 0
+	});
 	const scale = useNativeScale({
 		unit: "KILOGRAMS",
 		precision: 3,
 		tareWeight: 0,
-		autoStart: active
+		autoStart: active,
+		onChange: useCallback(() => {
+			setSample((current) => ({
+				sequence: current.sequence + 1,
+				receivedAt: Date.now()
+			}));
+		}, [])
 	});
 	const inspection = inspectScaleEntrySnapshot(scale, minimumWeightKg);
 	useEffect(() => {
@@ -109,7 +119,8 @@ function ActiveScaleRuntimeOwner({ active, hub, minimumWeightKg, ownerId, runtim
 			connectionState: scale.connectionState,
 			rawData: scale.rawData,
 			isListening: scale.isListening,
-			error: scale.error
+			error: scale.error,
+			sampleSequence: sample.sequence
 		});
 	}, [
 		active,
@@ -120,7 +131,8 @@ function ActiveScaleRuntimeOwner({ active, hub, minimumWeightKg, ownerId, runtim
 		scale.grossWeight,
 		scale.isListening,
 		scale.rawData,
-		scale.status
+		scale.status,
+		sample.sequence
 	]);
 	useEffect(() => {
 		if (!active) {
@@ -148,11 +160,12 @@ function ActiveScaleRuntimeOwner({ active, hub, minimumWeightKg, ownerId, runtim
 			return;
 		}
 		if (consumedReadingRef.current) return;
+		if (!runtime.getSnapshot().hasLiveSample) return;
 		const grossWeight = inspection.validGrossWeightKg;
 		if (grossWeight === void 0) return;
 		consumedReadingRef.current = true;
 		eventSequenceRef.current += 1;
-		const occurredAt = Date.now();
+		const occurredAt = sample.receivedAt || Date.now();
 		hub.publishWeightChange({
 			eventId: `native-scale-change:${occurredAt}:${eventSequenceRef.current}`,
 			occurredAt,
@@ -168,6 +181,8 @@ function ActiveScaleRuntimeOwner({ active, hub, minimumWeightKg, ownerId, runtim
 		hub,
 		inspection.belowTriggerThreshold,
 		inspection.validGrossWeightKg,
+		runtime,
+		sample.receivedAt,
 		scale.status
 	]);
 	return null;

package/es/components/bigSale/templates/HDLKiosk/adapter/useBigSaleHDLKioskHost.js

@@ -75,6 +75,9 @@ function useBigSaleHDLKioskHost(context, businessCode, bridge, scaleSourceAvaila
 			}
 		}
 	});
+	useEffect(() => {
+		projectionListenersRef.current.forEach((listener) => listener());
+	});
 	return hostRef.current;
 }
 //#endregion

package/es/components/bigSale/templates/HDLKiosk/index.js

@@ -6,9 +6,9 @@ import { buildVoucherViews } from "../../../../plus/saleDetail/components/Promot
 import { createSaleWalletAssetsCleanupCoordinator } from "../../../../plus/saleDetail/components/PromotionWalletPanels/useSaleWalletAssets.js";
 import Base_default from "../../../../plus/saleDetail/Base.js";
 import localeTexts from "../../../HDLKiosk/locales.js";
-import { createHDLScaleRuntime } from "../../../HDLKiosk/devices/scale/runtime.js";
+import { createHDLScaleRuntime } from "../../../HDLKiosk/runtime/devices/scaleStore.js";
 import HDLKiosk from "../../../HDLKiosk/index.js";
-import { resolveHDLKioskConfig } from "../../../HDLKiosk/contracts/config.js";
+import { resolveHDLKioskConfig } from "../../../HDLKiosk/app/contracts/config.js";
 import { useBigSaleHDLKioskHost } from "./adapter/useBigSaleHDLKioskHost.js";
 import { useHDLKioskEntryPreparationToast } from "./adapter/useHDLKioskEntryPreparationToast.js";
 import { HDLKioskPaymentRuntime } from "./adapter/HDLKioskPaymentRuntime.js";
@@ -219,7 +219,7 @@ function HDLKioskBigSaleTemplate({ isActive = true, context, businessCode, local
 		skipsCatalogLoad
 	]);
 	return /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(BigSaleScaleRuntimeOwner, {
-		active: isActive && (config.enabledEntries.includes("scale") || config.enabledEntries.includes("quick")) && Boolean(config.primaryWeightedProductId),
+		active: isActive && (config.enabledEntries.includes("scale") || config.enabledEntries.includes("quick") || config.enabledEntries.includes("barcode")) && Boolean(config.primaryWeightedProductId),
 		hub: scaleTriggerHub,
 		nativeScaleTools,
 		minimumWeightKg: config.scaleTriggerMinimumWeightKg,

package/lib/components/HDLKiosk/{contracts → app/contracts}/config.js

@@ -1,4 +1,4 @@
-//#region src/components/HDLKiosk/contracts/config.ts
+//#region src/components/HDLKiosk/app/contracts/config.ts
 const ALL_ENTRY_MODES = Object.freeze([
 	"quick",
 	"barcode",