@pisell/private-materials 6.12.168 → 6.12.170

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/README.md

@@ -0,0 +1,43 @@
+# BigSale HDLKiosk integration
+
+This directory is the compatibility boundary between BigSale/SalesSDK and the
+independent `components/HDLKiosk` material.
+
+## Structure
+
+- `index.tsx`: outer composition only; renders device owners, HDLKiosk and the
+  embedded payment runtime.
+- `adapter/useBigSaleHDLKioskAdapter.ts`: owns late React capabilities and the
+  stable Host assembly (payment controller, authenticated customer, scale and
+  fulfillment).
+- `adapter/useBigSaleHDLKioskHost.ts`: bridges changing React Context into one
+  stable Host and publishes semantic Projection changes.
+- `adapter/createHost.ts`: pure Host composition factory.
+- `adapter/host/`: pure Host support: capabilities, Projection, telemetry and
+  the fulfillment writer.
+- `adapter/devices/`: raw BigSale device sources converted to HDLKiosk ports.
+- `adapter/sales/index.ts`: composition-only Sales Port entry.
+- `adapter/sales/`: capability modules for session, catalog, identity,
+  fulfillment, cart, weighted products and payment.
+- `runtime/scaleBridge.ts`: owns one Scale Snapshot runtime and one standard
+  device-event stream.
+- `runtime/BigSaleScaleRuntimeOwner.tsx`: the only React owner of the native
+  scale Hook; publishes exclusively through ScaleBridge.
+- `runtime/HDLKioskPaymentRuntime.tsx`: React-owned payment runtime.
+- `hooks/`: template-level React effects that are not Host adapters.
+- `cart/`: SaleDetail-based cart overlay presentation.
+- `auth/`: BigSale login/register integration.
+
+## Boundary rules
+
+1. Raw BigSale, SalesSDK and OS objects stop in this directory.
+2. HDLKiosk Core receives only contracts from `components/HDLKiosk/app`.
+3. Reads use Projection snapshots; writes use explicit Host operations.
+4. A stable Host must pair `getSnapshot` with semantic `subscribe`
+   notifications. Updating a ref without publishing is not a valid store.
+5. React-owned capabilities are assembled in `useBigSaleHDLKioskAdapter`; do
+   not add new controller refs to `index.tsx`.
+6. Add capability-specific code to `adapter/sales/` rather than growing the
+   Sales Port composition file with unrelated concerns.
+7. Keep tests beside their capability. Shared BigSale test data belongs in
+   `adapter/testing/`, not in a new aggregate adapter suite.

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

@@ -1,11 +1,11 @@
-import { resolveBigSaleHDLKioskCapabilities } from "./capabilities.js";
-import { createBigSaleDevicePort } from "./devices.js";
-import { createBigSaleProjectionReader } from "./projection.js";
-import { createBigSaleSalesPort } from "./sales.js";
-import { createBigSaleTelemetryPort } from "./telemetry.js";
+import { resolveBigSaleHDLKioskCapabilities } from "./host/capabilities.js";
+import { createBigSaleDevicePort } from "./devices/devicePort.js";
+import { createBigSaleProjectionReader } from "./host/projection.js";
+import { createBigSaleSalesPort } from "./sales/index.js";
+import { createBigSaleTelemetryPort } from "./host/telemetry.js";
 //#region src/components/bigSale/templates/HDLKiosk/adapter/createHost.ts
 function createBigSaleHDLKioskHost({ getContext, executeScan, hasScanExecutionSource, devices, writeFulfillment, getWriteFulfillment, getAuthenticatedCustomer, allowSimulatedFulfillment, subscribeProjection, getPickupReferenceMode, getPaymentController }) {
-	const resolveScaleWeightChangeSource = () => (devices === null || devices === void 0 ? void 0 : devices.getSubscribeWeightChange) ? devices.getSubscribeWeightChange() : devices === null || devices === void 0 ? void 0 : devices.subscribeWeightChange;
+	const resolveScaleEventSource = () => (devices === null || devices === void 0 ? void 0 : devices.getSubscribeScaleEvents) ? devices.getSubscribeScaleEvents() : devices === null || devices === void 0 ? void 0 : devices.subscribeScaleEvents;
 	const getSnapshot = createBigSaleProjectionReader(getContext, getPickupReferenceMode);
 	const telemetry = createBigSaleTelemetryPort();
 	let compatibilityFallbackSequence = 0;
@@ -37,7 +37,7 @@ function createBigSaleHDLKioskHost({ getContext, executeScan, hasScanExecutionSo
 		telemetry,
 		get capabilities() {
 			return resolveBigSaleHDLKioskCapabilities(getContext(), {
-				hasScaleWeightChangeSource: typeof resolveScaleWeightChangeSource() === "function",
+				hasScaleWeightChangeSource: typeof resolveScaleEventSource() === "function",
 				hasScanExecutionSource: (hasScanExecutionSource === null || hasScanExecutionSource === void 0 ? void 0 : hasScanExecutionSource()) === true
 			});
 		}

package/es/components/bigSale/templates/HDLKiosk/adapter/{devices.js → devices/devicePort.js}

@@ -1,4 +1,4 @@
-//#region src/components/bigSale/templates/HDLKiosk/adapter/devices.ts
+//#region src/components/bigSale/templates/HDLKiosk/adapter/devices/devicePort.ts
 const SCAN_RESULT_EVENT = "nativeScanResult";
 const FALLBACK_DEDUPE_WINDOW_MS = 350;
 function fingerprint(value) {
@@ -13,7 +13,7 @@ function fingerprint(value) {
 * BigSale/PisellOS 原始扫码协议只停留在本文件。缺少宿主 eventId 时使用
 * 非明文 fingerprint + 短窗口合成降级 ID；capability 会保持 stableEventId=false。
 */
-function createBigSaleDevicePort({ getPubsub, getAcquireScanFocus, subscribeWeightChange, subscribeScaleConnection, getSubscribeWeightChange, getSubscribeScaleConnection, now = Date.now } = {}) {
+function createBigSaleDevicePort({ getPubsub, getAcquireScanFocus, subscribeScaleEvents, getSubscribeScaleEvents, now = Date.now } = {}) {
 	const listeners = /* @__PURE__ */ new Map();
 	let stopScanner;
 	let stopScale;
@@ -82,44 +82,16 @@ function createBigSaleDevicePort({ getPubsub, getAcquireScanFocus, subscribeWeig
 		} catch (_unused5) {}
 	};
 	const connectScale = () => {
-		const currentSubscribeWeightChange = getSubscribeWeightChange ? getSubscribeWeightChange() : subscribeWeightChange;
-		const currentSubscribeScaleConnection = getSubscribeScaleConnection ? getSubscribeScaleConnection() : subscribeScaleConnection;
-		if (stopScale || !currentSubscribeWeightChange && !currentSubscribeScaleConnection) return;
-		const cleanups = [];
-		if (currentSubscribeWeightChange) try {
-			const cleanup = currentSubscribeWeightChange((payload) => {
-				var _payload$occurredAt, _payload$eventId;
-				const occurredAt = (_payload$occurredAt = payload.occurredAt) !== null && _payload$occurredAt !== void 0 ? _payload$occurredAt : now();
-				eventSequence += 1;
-				emit("scale", {
-					type: "weightChanged",
-					eventId: (_payload$eventId = payload.eventId) !== null && _payload$eventId !== void 0 ? _payload$eventId : `big-sale-scale:${occurredAt}:${eventSequence}`,
-					weight: payload.weight,
-					occurredAt
-				});
-			});
-			if (typeof cleanup === "function") cleanups.push(cleanup);
-		} catch (_unused6) {}
-		if (currentSubscribeScaleConnection) try {
-			const cleanup = currentSubscribeScaleConnection((payload) => {
-				var _payload$occurredAt2;
-				emit("scale", {
-					type: "connectionChanged",
-					device: "scale",
-					connected: payload.connected,
-					state: payload.state,
-					occurredAt: (_payload$occurredAt2 = payload.occurredAt) !== null && _payload$occurredAt2 !== void 0 ? _payload$occurredAt2 : now()
-				});
-			});
-			if (typeof cleanup === "function") cleanups.push(cleanup);
-		} catch (_unused7) {}
-		stopScale = () => {
-			cleanups.forEach((cleanup) => {
+		const currentSubscribe = getSubscribeScaleEvents ? getSubscribeScaleEvents() : subscribeScaleEvents;
+		if (stopScale || !currentSubscribe) return;
+		try {
+			const cleanup = currentSubscribe((event) => emit("scale", event));
+			stopScale = () => {
 				try {
 					cleanup();
-				} catch (_unused8) {}
-			});
-		};
+				} catch (_unused6) {}
+			};
+		} catch (_unused7) {}
 	};
 	const syncConnections = () => {
 		const scannerNeeded = Array.from(listeners.values()).some((sources) => sources.has("scanner"));

package/es/components/bigSale/templates/HDLKiosk/adapter/{capabilities.js → host/capabilities.js}

@@ -1,4 +1,4 @@
-//#region src/components/bigSale/templates/HDLKiosk/adapter/capabilities.ts
+//#region src/components/bigSale/templates/HDLKiosk/adapter/host/capabilities.ts
 function resolveBigSaleHDLKioskCapabilities(context, options = {}) {
 	var _bookingTicket$store;
 	const bookingTicket = context.sales.bookingTicket;
@@ -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/{fulfillment.js → host/fulfillmentWriter.js}

@@ -1,6 +1,6 @@
-import { _asyncToGenerator } from "../../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js";
-import { partialFailure, unknown } from "./normalize.js";
-//#region src/components/bigSale/templates/HDLKiosk/adapter/fulfillment.ts
+import { _asyncToGenerator } from "../../../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js";
+import { partialFailure, unknown } from "../normalize.js";
+//#region src/components/bigSale/templates/HDLKiosk/adapter/host/fulfillmentWriter.ts
 function createHDLKioskFulfillmentWriter(runtime) {
 	if (typeof (runtime === null || runtime === void 0 ? void 0 : runtime.setPickupReferenceMode) !== "function" || typeof (runtime === null || runtime === void 0 ? void 0 : runtime.setServiceType) !== "function") return;
 	const setPickupReferenceMode = runtime.setPickupReferenceMode.bind(runtime);

package/es/components/bigSale/templates/HDLKiosk/adapter/{projection.js → host/projection.js}

@@ -1,13 +1,22 @@
-import { _objectSpread2 } from "../../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js";
-import { hasSkuSelection, resolveSkuValueCandidates } from "../../../../../plus/skuOptionsSelection/utils/resolveSkuValue.js";
+import { _objectSpread2 } from "../../../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js";
+import { hasSkuSelection, resolveSkuValueCandidates } from "../../../../../../plus/skuOptionsSelection/utils/resolveSkuValue.js";
 import Decimal from "decimal.js";
-//#region src/components/bigSale/templates/HDLKiosk/adapter/projection.ts
+//#region src/components/bigSale/templates/HDLKiosk/adapter/host/projection.ts
 /**
 * 文件角色：把 BigSale/SalesSDK 当前状态投影成 HDLKiosk 只读业务快照。
 * 运行机制：归一化订单行、称重数量、Summary、Customer、Payment 和 fingerprint，
 * 仅在语义变化时推进 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/{telemetry.js → host/telemetry.js}

@@ -1,4 +1,4 @@
-//#region src/components/bigSale/templates/HDLKiosk/adapter/telemetry.ts
+//#region src/components/bigSale/templates/HDLKiosk/adapter/host/telemetry.ts
 /** M11 接入正式埋点前保持无副作用，不回退到散落 console。 */
 function createBigSaleTelemetryPort() {
 	return { emit: () => void 0 };