@pisell/private-materials 6.12.168 → 6.12.170

package/es/components/HDLKiosk/slices/customization/Screen/index.js

@@ -1,11 +1,11 @@
 import { _objectSpread2 } from "../../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js";
 import { _asyncToGenerator } from "../../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js";
-import { useHDLScaleSnapshot } from "../../../devices/scale/runtime.js";
 import { useHDLKioskBottomBar, useHDLKioskBottomBarController } from "../../../components/shell/HDLKioskBottomBarHost/index.js";
 import { HDLKioskOrderSummary } from "../../../components/shell/HDLKioskOrderSummary/index.js";
 import { createHDLKioskSkuValue, readHDLKioskProductOptionGroups, readHDLKioskProductOptionItems } from "../../../components/common/HDLKioskSkuOptionsSelection/model.js";
 import HDLKioskSkuOptionsSelection from "../../../components/common/HDLKioskSkuOptionsSelection/index.js";
 import { resolveHDLWeightedProduct } from "../../../product.js";
+import { useHDLScaleRuntime, useHDLScaleSnapshot } from "../../../ui/scale.js";
 import React, { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { STANDARD_WEIGHT_UNIT, formatAmount, getWeightUnitSymbol, locales } from "@pisell/utils";
 import Decimal from "decimal.js";
@@ -27,13 +27,10 @@ function getScaleStatusText(scale) {
 	if (scale.error) return locales.getText("pisell2.hdl-kiosk.scale-reading-error");
 	if (scale.connectionState === "disconnected") return locales.getText("pisell2.hdl-kiosk.scale-disconnected");
 	if (scale.connectionState !== "connected" || !scale.isListening) return locales.getText("pisell2.hdl-kiosk.scale-connecting");
-	switch (scale.status) {
-		case "stable": return locales.getText("pisell2.hdl-kiosk.scale-stable");
-		case "overload": return locales.getText("pisell2.hdl-kiosk.scale-overload");
-		case "negative": return locales.getText("pisell2.hdl-kiosk.scale-negative");
-		case "unstable":
-		case null: return locales.getText("pisell2.hdl-kiosk.scale-unstable");
-	}
+	if (scale.status === "overload") return locales.getText("pisell2.hdl-kiosk.scale-overload");
+	if (scale.status === "negative") return locales.getText("pisell2.hdl-kiosk.scale-negative");
+	if (!scale.hasLiveSample) return locales.getText("pisell2.hdl-kiosk.scale-connecting");
+	return locales.getText(scale.status === "stable" ? "pisell2.hdl-kiosk.scale-stable" : "pisell2.hdl-kiosk.scale-unstable");
 }
 function initialSelections(product) {
 	if (!product) return [];
@@ -71,6 +68,19 @@ function formatMoney(value, currencySymbol) {
 	const amount = value.toDecimalPlaces(2).toNumber();
 	return String(formatAmount(amount, 2, currencySymbol || ""));
 }
+function resolveScaleMeasurement(scale, productFacts, minimumWeightKg) {
+	var _scale$grossWeightKg, _productFacts$fixedTa, _productFacts$fixedTa2;
+	const gross = new Decimal((_scale$grossWeightKg = scale.grossWeightKg) !== null && _scale$grossWeightKg !== void 0 ? _scale$grossWeightKg : NaN);
+	const tare = (_productFacts$fixedTa = productFacts === null || productFacts === void 0 || (_productFacts$fixedTa2 = productFacts.fixedTare) === null || _productFacts$fixedTa2 === void 0 ? void 0 : _productFacts$fixedTa2.valueKg) !== null && _productFacts$fixedTa !== void 0 ? _productFacts$fixedTa : new Decimal(0);
+	const numbersValid = gross.isFinite() && tare.isFinite() && !gross.isNegative() && !tare.isNegative();
+	const net = numbersValid ? Decimal.max(gross.minus(tare), 0) : new Decimal(0);
+	return {
+		gross,
+		tare,
+		net,
+		valid: numbersValid && scale.active && scale.hasLiveSample && scale.isListening && scale.connectionState === "connected" && scale.status === "stable" && !scale.error && net.greaterThanOrEqualTo(minimumWeightKg) && (productFacts === null || productFacts === void 0 ? void 0 : productFacts.available) === true
+	};
+}
 function BackIcon() {
 	return /* @__PURE__ */ React.createElement("svg", {
 		viewBox: "0 0 24 24",
@@ -159,6 +169,7 @@ function ProductFallback() {
 }
 function CustomizationScreen({ product, loading, errorReference, errorMessage, busy, syncing, canGoBack, minimumWeightKg, orderBar, send }) {
 	var _productFacts$product, _orderBar$primaryLine, _orderBar$primaryLine2, _orderBar$primaryLine3, _orderBar$primaryLine4, _orderBar$primaryLine7, _productFacts$unitPri, _orderBar$primaryLine9, _orderBar$primaryLine11;
+	const scaleRuntime = useHDLScaleRuntime();
 	const scale = useHDLScaleSnapshot();
 	const skuOptionsRef = useRef(null);
 	const hydratedDraftKeyRef = useRef();
@@ -179,30 +190,21 @@ function CustomizationScreen({ product, loading, errorReference, errorMessage, b
 		(_orderBar$primaryLine7 = orderBar.primaryLine) === null || _orderBar$primaryLine7 === void 0 ? void 0 : _orderBar$primaryLine7.skuValue,
 		product
 	]);
-	const measurement = useMemo(() => {
-		var _scale$grossWeightKg, _productFacts$fixedTa, _productFacts$fixedTa2;
-		const gross = new Decimal((_scale$grossWeightKg = scale.grossWeightKg) !== null && _scale$grossWeightKg !== void 0 ? _scale$grossWeightKg : NaN);
-		const tare = (_productFacts$fixedTa = productFacts === null || productFacts === void 0 || (_productFacts$fixedTa2 = productFacts.fixedTare) === null || _productFacts$fixedTa2 === void 0 ? void 0 : _productFacts$fixedTa2.valueKg) !== null && _productFacts$fixedTa !== void 0 ? _productFacts$fixedTa : new Decimal(0);
-		const numbersValid = gross.isFinite() && tare.isFinite() && !gross.isNegative() && !tare.isNegative();
-		const net = numbersValid ? Decimal.max(gross.minus(tare), 0) : new Decimal(0);
-		return {
-			gross,
-			tare,
-			net,
-			valid: numbersValid && scale.active && scale.isListening && scale.connectionState === "connected" && scale.status === "stable" && !scale.error && net.greaterThanOrEqualTo(minimumWeightKg) && (productFacts === null || productFacts === void 0 ? void 0 : productFacts.available) === true
-		};
-	}, [
+	const measurement = useMemo(() => resolveScaleMeasurement(scale, productFacts, minimumWeightKg), [
 		minimumWeightKg,
 		productFacts,
 		scale
 	]);
 	const statusText = getScaleStatusText(scale);
-	const stable = scale.status === "stable" && scale.connectionState === "connected" && scale.isListening && !scale.error;
+	const readingInvalid = scale.status === "overload" || scale.status === "negative";
+	const stable = scale.status === "stable" && scale.hasLiveSample && scale.connectionState === "connected" && scale.isListening && !scale.error;
 	const unitPricePerStandardWeight = (_productFacts$unitPri = productFacts === null || productFacts === void 0 ? void 0 : productFacts.unitPricePerKg) !== null && _productFacts$unitPri !== void 0 ? _productFacts$unitPri : new Decimal(0);
 	const amountText = orderBar.confirmedAmount !== void 0 ? formatMoney(new Decimal(orderBar.confirmedAmount), orderBar.currencySymbol) : "—";
 	const submit = useCallback(_asyncToGenerator(function* () {
-		var _skuOptionsRef$curren2, _skuOptionsRef$curren3, _orderBar$primaryLine8, _scale$updatedAt;
-		if (!productFacts || !measurement.valid || busy || syncing) return;
+		var _skuOptionsRef$curren2, _skuOptionsRef$curren3, _orderBar$primaryLine8, _currentScale$updated;
+		const currentScale = scaleRuntime.getSnapshot();
+		const currentMeasurement = resolveScaleMeasurement(currentScale, productFacts, minimumWeightKg);
+		if (!productFacts || !currentMeasurement.valid || busy || syncing) return;
 		try {
 			var _skuOptionsRef$curren;
 			yield (_skuOptionsRef$curren = skuOptionsRef.current) === null || _skuOptionsRef$curren === void 0 ? void 0 : _skuOptionsRef$curren.validate();
@@ -219,24 +221,21 @@ function CustomizationScreen({ product, loading, errorReference, errorMessage, b
 				existingLineId: (_orderBar$primaryLine8 = orderBar.primaryLine) === null || _orderBar$primaryLine8 === void 0 ? void 0 : _orderBar$primaryLine8.lineId,
 				skuValue: submittedSkuValue,
 				measurement: {
-					grossWeightKg: formatWeight(measurement.gross),
-					tareWeightKg: formatWeight(measurement.tare),
-					netWeightKg: formatWeight(measurement.net),
+					grossWeightKg: formatWeight(currentMeasurement.gross),
+					tareWeightKg: formatWeight(currentMeasurement.tare),
+					netWeightKg: formatWeight(currentMeasurement.net),
 					source: "auto",
 					status: "stable",
-					measuredAt: (_scale$updatedAt = scale.updatedAt) !== null && _scale$updatedAt !== void 0 ? _scale$updatedAt : Date.now()
+					measuredAt: (_currentScale$updated = currentScale.updatedAt) !== null && _currentScale$updated !== void 0 ? _currentScale$updated : Date.now()
 				}
 			}
 		});
 	}), [
 		busy,
-		measurement.valid,
-		measurement.gross,
-		measurement.net,
-		measurement.tare,
+		minimumWeightKg,
 		(_orderBar$primaryLine9 = orderBar.primaryLine) === null || _orderBar$primaryLine9 === void 0 ? void 0 : _orderBar$primaryLine9.lineId,
 		productFacts,
-		scale.updatedAt,
+		scaleRuntime,
 		skuValue,
 		send,
 		syncing
@@ -314,9 +313,9 @@ function CustomizationScreen({ product, loading, errorReference, errorMessage, b
 		src: productFacts.imageUrl,
 		alt: ""
 	}) : /* @__PURE__ */ React.createElement(ProductFallback, null)), /* @__PURE__ */ React.createElement("div", { className: "hdl-customization-product__copy" }, /* @__PURE__ */ React.createElement("p", null, locales.getText("pisell2.hdl-kiosk.customization-product-eyebrow")), /* @__PURE__ */ React.createElement("h1", { id: "hdl-customization-title" }, (productFacts === null || productFacts === void 0 ? void 0 : productFacts.name) || locales.getText("pisell2.hdl-kiosk.weighted-product-loading")), /* @__PURE__ */ React.createElement("strong", null, productFacts ? formatMoney(unitPricePerStandardWeight, orderBar.currencySymbol) : "—", " ", /* @__PURE__ */ React.createElement("small", null, "/", STANDARD_WEIGHT_UNIT_LABEL)))), /* @__PURE__ */ React.createElement("aside", { className: "hdl-customization-weight" }, /* @__PURE__ */ React.createElement("div", { className: "hdl-customization-weight__status" }, /* @__PURE__ */ React.createElement("span", {
-		className: `hdl-customization-weight__dot${stable ? " is-stable" : ""}`,
+		className: `hdl-customization-weight__dot${readingInvalid ? " is-error" : stable ? " is-stable" : ""}`,
 		"aria-hidden": "true"
-	}), /* @__PURE__ */ React.createElement("div", null, /* @__PURE__ */ React.createElement("strong", null, locales.getText("pisell2.hdl-kiosk.customization-weighing")), /* @__PURE__ */ React.createElement("small", null, statusText)), /* @__PURE__ */ React.createElement(ScaleIcon, null)), /* @__PURE__ */ React.createElement("dl", null, /* @__PURE__ */ React.createElement("div", null, /* @__PURE__ */ React.createElement("dt", null, locales.getText("pisell2.hdl-kiosk.customization-unit-price")), /* @__PURE__ */ React.createElement("dd", null, productFacts ? formatMoney(unitPricePerStandardWeight, orderBar.currencySymbol) : "—", " ", /* @__PURE__ */ React.createElement("small", null, "/", STANDARD_WEIGHT_UNIT_LABEL))), /* @__PURE__ */ React.createElement("div", { className: "is-featured" }, /* @__PURE__ */ React.createElement("dt", null, locales.getText("pisell2.hdl-kiosk.gross-weight")), /* @__PURE__ */ React.createElement("dd", null, measurement.gross.isFinite() ? formatWeight(measurement.gross) : "—", " ", "kg")), /* @__PURE__ */ React.createElement("div", null, /* @__PURE__ */ React.createElement("dt", null, locales.getText("pisell2.hdl-kiosk.tare-weight")), /* @__PURE__ */ React.createElement("dd", null, formatWeight(measurement.tare), " kg")), /* @__PURE__ */ React.createElement("div", null, /* @__PURE__ */ React.createElement("dt", null, locales.getText("pisell2.hdl-kiosk.net-weight")), /* @__PURE__ */ React.createElement("dd", null, formatWeight(measurement.net), " kg"))))), /* @__PURE__ */ React.createElement("div", { className: "hdl-customization-options" }, product && productFacts ? /* @__PURE__ */ React.createElement(HDLKioskSkuOptionsSelection, {
+	}), /* @__PURE__ */ React.createElement("div", null, /* @__PURE__ */ React.createElement("strong", null, locales.getText("pisell2.hdl-kiosk.customization-weighing")), /* @__PURE__ */ React.createElement("small", null, statusText)), /* @__PURE__ */ React.createElement(ScaleIcon, null)), /* @__PURE__ */ React.createElement("dl", null, /* @__PURE__ */ React.createElement("div", null, /* @__PURE__ */ React.createElement("dt", null, locales.getText("pisell2.hdl-kiosk.customization-unit-price")), /* @__PURE__ */ React.createElement("dd", null, productFacts ? formatMoney(unitPricePerStandardWeight, orderBar.currencySymbol) : "—", " ", /* @__PURE__ */ React.createElement("small", null, "/", STANDARD_WEIGHT_UNIT_LABEL))), /* @__PURE__ */ React.createElement("div", { className: "is-featured" }, /* @__PURE__ */ React.createElement("dt", null, locales.getText("pisell2.hdl-kiosk.gross-weight")), /* @__PURE__ */ React.createElement("dd", null, readingInvalid ? "Err." : `${measurement.gross.isFinite() ? formatWeight(measurement.gross) : "—"} kg`)), /* @__PURE__ */ React.createElement("div", null, /* @__PURE__ */ React.createElement("dt", null, locales.getText("pisell2.hdl-kiosk.tare-weight")), /* @__PURE__ */ React.createElement("dd", null, formatWeight(measurement.tare), " kg")), /* @__PURE__ */ React.createElement("div", null, /* @__PURE__ */ React.createElement("dt", null, locales.getText("pisell2.hdl-kiosk.net-weight")), /* @__PURE__ */ React.createElement("dd", null, readingInvalid ? "Err." : `${formatWeight(measurement.net)} kg`))))), /* @__PURE__ */ React.createElement("div", { className: "hdl-customization-options" }, product && productFacts ? /* @__PURE__ */ React.createElement(HDLKioskSkuOptionsSelection, {
 		ref: skuOptionsRef,
 		product,
 		value: skuValue,

package/es/components/HDLKiosk/slices/customization/Screen/index.less

@@ -122,6 +122,11 @@
     box-shadow: 0 0 0 5px rgba(18, 183, 106, 0.16);
   }
 
+  .hdl-customization-weight__dot.is-error {
+    background: #f04438;
+    box-shadow: 0 0 0 5px rgba(240, 68, 56, 0.16);
+  }
+
   .hdl-customization-weight__status > div {
     min-width: 0;
     flex: 1;

package/es/components/HDLKiosk/slices/customization/slice.js

@@ -1,11 +1,10 @@
 import { defineSlice, effect } from "../../kernel/application/defineSlice.js";
-import { cartRemoveLineOperation } from "../../app/operations/cart.js";
-import { productRemovePrimaryProductOperation, productSyncPrimaryWeightedProductOperation } from "./operation.js";
+import { cartRemoveLineOperation, productRemovePrimaryProductOperation, productSyncPrimaryWeightedProductOperation } from "../../app/operations.js";
 //#region src/components/HDLKiosk/slices/customization/slice.ts
 /** Customization Slice：Next 时才提交本地称重草稿；加购成功后才离开。 */
 const customizationSlice = defineSlice({
 	id: "customization",
-	screen: { id: "customization" },
+	surface: { id: "customization" },
 	commands: { removePrimaryProduct: cartRemoveLineOperation },
 	intents: {
 		complete: effect(productSyncPrimaryWeightedProductOperation, { navigate: "next" }),

package/es/components/HDLKiosk/slices/fulfillment/slice.js

@@ -1,10 +1,10 @@
 import { defineSlice, effect } from "../../kernel/application/defineSlice.js";
-import { setFulfillmentOperation } from "../../app/operations/fulfillment.js";
+import { setFulfillmentOperation } from "../../app/operations.js";
 //#region src/components/HDLKiosk/slices/fulfillment/slice.ts
 /** Fulfillment Slice：声明就餐方式完成条件与回退语义；不依赖 React 或 Host 实现。 */
 const fulfillmentSlice = defineSlice({
 	id: "fulfillment",
-	screen: { id: "fulfillment" },
+	surface: { id: "fulfillment" },
 	intents: { complete: effect(setFulfillmentOperation, {
 		precondition: "fulfillment.selected",
 		navigate: "next"

package/es/components/HDLKiosk/slices/fulfillment/view.js

@@ -4,7 +4,7 @@ import React from "react";
 //#region src/components/HDLKiosk/slices/fulfillment/view.tsx
 /** Fulfillment 展示装配：组合页面、订单摘要与购物车投影；不执行订单写入。 */
 const renderFulfillment = ({ node, viewSnapshot, sales, businessMode, send }) => /* @__PURE__ */ React.createElement(FulfillmentScreen, {
-	model: createActivityScreenModel(node.screenId, viewSnapshot, node, sales, businessMode),
+	model: createActivityScreenModel(node.surfaceId, viewSnapshot, node, sales, businessMode),
 	orderBar: createOrderBarModel(sales),
 	send
 });

package/es/components/HDLKiosk/slices/identity/Screen/index.less

@@ -131,7 +131,7 @@
 
   .hdl-identity-auth-panel[aria-busy='true'] {
     pointer-events: none;
-    opacity: 0.72;
+    opacity: 1;
   }
 
   .hdl-identity-auth-panel--disabled {

package/es/components/HDLKiosk/slices/identity/slice.js

@@ -1,10 +1,10 @@
 import { defineSlice, effect } from "../../kernel/application/defineSlice.js";
-import { identitySyncOperation } from "./operation.js";
+import { identitySyncOperation } from "../../app/operations.js";
 //#region src/components/HDLKiosk/slices/identity/slice.ts
 /** Identity Slice：声明身份节点的 Intent 与客户同步 Effect；不依赖 React 或 Host 实现。 */
 const identitySlice = defineSlice({
 	id: "identity",
-	screen: { id: "identity" },
+	surface: { id: "identity" },
 	intents: {
 		complete: effect(identitySyncOperation, { navigate: "next" }),
 		omit: effect(identitySyncOperation, { navigate: "next" })

package/es/components/HDLKiosk/slices/identity/view.js

@@ -4,7 +4,7 @@ import React from "react";
 //#region src/components/HDLKiosk/slices/identity/view.tsx
 /** Identity 展示装配：把统一 View Context 转为本 Slice Screen props；不决定流程目标。 */
 const renderIdentity = ({ node, viewSnapshot, sales, businessMode, renderIdentityAuth, send }) => /* @__PURE__ */ React.createElement(IdentityScreen, {
-	model: createActivityScreenModel(node.screenId, viewSnapshot, node, sales, businessMode),
+	model: createActivityScreenModel(node.surfaceId, viewSnapshot, node, sales, businessMode),
 	orderBar: createOrderBarModel(sales),
 	send,
 	renderIdentityAuth

package/es/components/HDLKiosk/slices/payment/Screen/index.less

@@ -114,7 +114,7 @@
   .hdl-content-restart-order-button:disabled,
   .hdl-payment-method:disabled,
   .hdl-checkout-screen .hdl-floating-bar__button:disabled {
-    opacity: 0.48;
+    opacity: 1;
     cursor: not-allowed;
     transform: none;
   }

package/es/components/HDLKiosk/slices/payment/slice.js

@@ -1,10 +1,10 @@
 import { defineSlice, intentPrecondition } from "../../kernel/application/defineSlice.js";
-import { checkoutPayEftposOperation, checkoutRequestStaffPaymentApprovalOperation } from "../../app/operations/checkout.js";
+import { checkoutPayEftposOperation, checkoutRequestStaffPaymentApprovalOperation } from "../../app/operations.js";
 //#region src/components/HDLKiosk/slices/payment/slice.ts
 /** Payment Slice：声明卡/现金选择、支付派发与 Host 成功确认；支付不确定不作成功处理。 */
 const paymentMethodSlice = defineSlice({
 	id: "paymentMethod",
-	screen: { id: "checkout" },
+	surface: { id: "checkout" },
 	commands: {
 		payEftpos: checkoutPayEftposOperation,
 		requestStaffPaymentApproval: checkoutRequestStaffPaymentApprovalOperation
@@ -14,7 +14,7 @@ const paymentMethodSlice = defineSlice({
 /** 支付完成仍复用 Checkout Screen，仅作为 Workflow 的成功终态。 */
 const paymentCompletedSlice = defineSlice({
 	id: "paymentCompleted",
-	screen: { id: "checkout" },
+	surface: { id: "checkout" },
 	intents: {}
 });
 //#endregion

package/es/components/HDLKiosk/slices/primaryProductPrompt/slice.js

@@ -3,7 +3,7 @@ import { defineSlice, intentPrecondition } from "../../kernel/application/define
 /** 主商品询问 Slice：只表达是否进入称重定制，不承担 Catalog 页面职责。 */
 const primaryProductPromptSlice = defineSlice({
 	id: "primaryProductPrompt",
-	screen: { id: "primaryProductPrompt" },
+	surface: { id: "primaryProductPrompt" },
 	presentation: "modal",
 	intents: {
 		complete: intentPrecondition("cart.notEmpty", { navigate: "next" }),

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

@@ -1,5 +1,6 @@
-import { _asyncToGenerator } from "../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js";
 import { useHDLKioskCustomerController } from "./controllers/useHDLKioskCustomerController.js";
+import { useHDLKioskActionDispatcher } from "./controllers/useHDLKioskActionDispatcher.js";
+import { useHDLKioskExitController } from "./controllers/useHDLKioskExitController.js";
 import { useHDLKioskScreenData } from "./controllers/useHDLKioskScreenData.js";
 import { canReopenWorkflowStep } from "../kernel/workflow/selectors.js";
 import { EndOrderDialog } from "../components/overlays/EndOrderDialog/index.js";
@@ -10,12 +11,12 @@ import { HDLKioskShell } from "../components/shell/HDLKioskShell/index.js";
 import { HDLKioskBottomBarHost, useHDLKioskCartDrawerController } from "../components/shell/HDLKioskBottomBarHost/index.js";
 import { BlockingNotice } from "../components/common/BlockingNotice/index.js";
 import { createCartDrawerModel } from "../utils.js";
-import { ScreenRenderer } from "../app/ScreenRenderer.js";
-import { useWorkflowSnapshot } from "./useWorkflowSnapshot.js";
-import { createWorkflowEvent } from "./workflowEvent.js";
+import { ScreenRenderer } from "./ScreenRenderer.js";
+import { useWorkflowSnapshot } from "./snapshots.js";
+import { resolveHDLKioskCollaborationStatus } from "./collaborationStatus.js";
 import React, { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { locales } from "@pisell/utils";
-//#region src/components/HDLKiosk/runtime/HDLKioskWorkflowView.tsx
+//#region src/components/HDLKiosk/ui/HDLKioskWorkflowView.tsx
 /**
 * 文件角色：承载一个活跃 HDLKiosk 会话的 React 组合视图。
 * 运行机制：组合 Customer/ScreenData Controller，订阅 Host 与 Actor
@@ -40,52 +41,65 @@ function HDLKioskWorkflowCartOverlay({ model, busy, memberAction, send, renderCa
 		} : void 0
 	});
 }
+function HDLKioskWorkflowBlockingSurface({ snapshot, title, description, reference, hideBottomBar = false }) {
+	return /* @__PURE__ */ React.createElement(HDLKioskShell, { snapshot }, /* @__PURE__ */ React.createElement(HDLKioskBottomBarHost, { mode: hideBottomBar ? "hidden" : void 0 }, /* @__PURE__ */ React.createElement(HDLKioskHeader, null), /* @__PURE__ */ React.createElement("main", { className: "hdl-shell__main" }, /* @__PURE__ */ React.createElement(BlockingNotice, {
+		title,
+		description,
+		reference
+	}))));
+}
 /**
 * 活跃点餐会话的 UI 编排层。
 *
 * 它把运行时控制器投影为 Screen/Dialog 所需的 props；具体页面不直接接触
 * Host、Workflow Actor 或会话计时器。
 */
-function HDLKioskWorkflowView({ session, host, sales, config, isActive, renderIdentityAuth, renderCartContent, cartOverlayActions, returnToEntry }) {
-	var _snapshot$pendingNavi, _snapshot$pendingNavi2, _session$definition$n2, _customer$error, _activeNode$presentat;
+function HDLKioskWorkflowView({ session, host, sales, config, isActive, returning, returnError, renderIdentityAuth, renderCartContent, cartOverlayActions, onCollaborationStatusChange, returnToEntry }) {
+	var _session$definition$n2, _customer$error, _activeNode$presentat;
 	const snapshot = useWorkflowSnapshot(session.actor);
-	const sequence = useRef(0);
-	const resetInFlight = useRef(false);
-	const [resetting, setResetting] = useState(false);
-	const [resetError, setResetError] = useState();
+	const navigationSequence = useRef(0);
 	const [memberLoginOpen, setMemberLoginOpen] = useState(false);
-	const [commandState, setCommandState] = useState({ busy: false });
-	const commandGeneration = useRef(0);
-	const pendingCommands = useRef(0);
 	const activeNode = session.definition.nodes[snapshot.nodeId];
-	const pendingEndOrderNavigation = ((_snapshot$pendingNavi = snapshot.pendingNavigation) === null || _snapshot$pendingNavi === void 0 ? void 0 : _snapshot$pendingNavi.request.kind) === "confirmEndOrder" ? snapshot.pendingNavigation : void 0;
-	const pendingAutomaticExitNavigation = ((_snapshot$pendingNavi2 = snapshot.pendingNavigation) === null || _snapshot$pendingNavi2 === void 0 ? void 0 : _snapshot$pendingNavi2.request.kind) === "performSessionExit" ? snapshot.pendingNavigation : void 0;
-	const endOrderConfirmationOpen = Boolean(pendingEndOrderNavigation);
-	const currentScreenId = activeNode.screenId;
 	const customizationStepId = session.definition.stepOrder.find((stepId) => {
 		var _session$definition$n;
 		return ((_session$definition$n = session.definition.nodes[stepId]) === null || _session$definition$n === void 0 ? void 0 : _session$definition$n.activity) === "customization";
 	});
 	const screenDataNode = (_session$definition$n2 = session.definition.nodes[snapshot.surface.pageStepId]) !== null && _session$definition$n2 !== void 0 ? _session$definition$n2 : activeNode;
 	const paymentSafeForReset = sales.payment.status === "idle" || sales.payment.status === "failed";
-	const resetSession = useCallback(_asyncToGenerator(function* () {
-		if (resetInFlight.current) return;
-		resetInFlight.current = true;
-		setResetting(true);
-		setResetError(void 0);
-		sequence.current += 1;
-		const result = yield returnToEntry("ui");
-		if (result.status === "succeeded") return;
-		resetInFlight.current = false;
-		setResetting(false);
-		setResetError(result.status === "failed" || result.status === "partialFailure" || result.status === "unknown" ? result.error : {
-			code: "resetCancelled",
-			source: "operation",
-			recovery: "staff",
-			safeMessageKey: "hdlKiosk.error.resetCancelled",
-			traceId: `hdl-reset-cancelled-${Date.now()}`
-		});
-	}), [returnToEntry]);
+	const screenCollaborationStatus = resolveHDLKioskCollaborationStatus(screenDataNode.surfaceId);
+	const currentCollaborationStatus = useRef("home");
+	const statusBeforeCartOpen = useRef("home");
+	const cartOpenRef = useRef(false);
+	const publishCollaborationStatus = useCallback((status) => {
+		if (isActive) onCollaborationStatusChange === null || onCollaborationStatusChange === void 0 || onCollaborationStatusChange(status);
+	}, [isActive, onCollaborationStatusChange]);
+	const handleCartOpenChange = useCallback((open) => {
+		if (open) {
+			if (!cartOpenRef.current) statusBeforeCartOpen.current = currentCollaborationStatus.current;
+			cartOpenRef.current = true;
+			publishCollaborationStatus("cart");
+			return;
+		}
+		if (!cartOpenRef.current) return;
+		cartOpenRef.current = false;
+		publishCollaborationStatus(statusBeforeCartOpen.current);
+	}, [publishCollaborationStatus]);
+	useEffect(() => {
+		if (!screenCollaborationStatus) return;
+		currentCollaborationStatus.current = screenCollaborationStatus;
+		if (!cartOpenRef.current) publishCollaborationStatus(screenCollaborationStatus);
+	}, [publishCollaborationStatus, screenCollaborationStatus]);
+	const { endOrderConfirmationOpen, resetSession, requestEndOrder, cancelEndOrder, confirmEndOrder } = useHDLKioskExitController({
+		session,
+		snapshot,
+		returnToEntry
+	});
+	const { send, commandState } = useHDLKioskActionDispatcher({
+		session,
+		snapshot,
+		activityId: activeNode.activity,
+		resetSession
+	});
 	const customer = useHDLKioskCustomerController({
 		session,
 		snapshot,
@@ -93,7 +107,7 @@ function HDLKioskWorkflowView({ session, host, sales, config, isActive, renderId
 		activityId: activeNode.activity,
 		isActive,
 		loginAvailable: Boolean(renderIdentityAuth),
-		interactionBlocked: resetting || commandState.busy
+		interactionBlocked: returning || commandState.busy
 	});
 	const requestMemberLogin = useCallback(() => {
 		if (customer.canLogin && renderIdentityAuth) setMemberLoginOpen(true);
@@ -102,106 +116,27 @@ function HDLKioskWorkflowView({ session, host, sales, config, isActive, renderId
 		setMemberLoginOpen(false);
 		customer.applyAuthenticatedCustomer(customerId);
 	}, [customer.applyAuthenticatedCustomer]);
-	const requestEndOrder = useCallback(() => {
-		sequence.current += 1;
-		session.actor.navigate({
-			kind: "sessionExit",
-			reason: "userRequest"
-		}, `ui:${snapshot.sessionEpoch}:${sequence.current}`);
-	}, [session, snapshot.sessionEpoch]);
 	const editPrimaryProduct = useCallback(() => {
 		if (!customizationStepId || customizationStepId === snapshot.nodeId) return;
-		sequence.current += 1;
+		navigationSequence.current += 1;
 		session.actor.navigate({
 			kind: "step",
 			stepId: customizationStepId
-		}, `ui:edit-primary-product:${snapshot.sessionEpoch}:${sequence.current}`);
+		}, `ui:edit-primary-product:${snapshot.sessionEpoch}:${navigationSequence.current}`);
 	}, [
 		customizationStepId,
 		session.actor,
 		snapshot.nodeId,
 		snapshot.sessionEpoch
 	]);
-	const cancelEndOrder = useCallback(() => {
-		if (!pendingEndOrderNavigation) return;
-		session.actor.resolvePendingNavigation(pendingEndOrderNavigation.navigationId, "cancel");
-	}, [pendingEndOrderNavigation, session.actor]);
-	const confirmEndOrder = useCallback(() => {
-		if (!pendingEndOrderNavigation || !session.actor.resolvePendingNavigation(pendingEndOrderNavigation.navigationId, "allow")) return;
-		resetSession();
-	}, [
-		pendingEndOrderNavigation,
-		resetSession,
-		session.actor
-	]);
-	useEffect(() => {
-		if (!pendingAutomaticExitNavigation || !session.actor.resolvePendingNavigation(pendingAutomaticExitNavigation.navigationId, "allow")) return;
-		resetSession();
-	}, [
-		pendingAutomaticExitNavigation,
-		resetSession,
-		session.actor
-	]);
 	const { catalog, customization, payment } = useHDLKioskScreenData({
 		host,
-		currentScreenId: screenDataNode.screenId,
+		currentScreenId: screenDataNode.surfaceId,
 		activity: screenDataNode.activity,
 		isActive,
 		primaryWeightedProductId: config.primaryWeightedProductId
 	});
-	useEffect(() => {
-		commandGeneration.current += 1;
-		pendingCommands.current = 0;
-		setCommandState({ busy: false });
-		setMemberLoginOpen(false);
-	}, [session]);
-	const send = useCallback((action) => {
-		if (action.kind === "session") {
-			resetSession();
-			return;
-		}
-		sequence.current += 1;
-		const intentId = `ui:${snapshot.sessionEpoch}:${sequence.current}`;
-		if (action.kind === "intent" || action.kind === "navigation") {
-			const event = createWorkflowEvent(action, activeNode.activity, snapshot.nodeId, intentId);
-			if (event) session.actor.send(event);
-			return;
-		}
-		const generation = commandGeneration.current;
-		pendingCommands.current += 1;
-		setCommandState({
-			busy: true,
-			commandId: action.command
-		});
-		session.executeCommand(action.command, action.input, intentId).then((result) => {
-			if (generation !== commandGeneration.current) return;
-			pendingCommands.current = Math.max(0, pendingCommands.current - 1);
-			setCommandState({
-				busy: pendingCommands.current > 0,
-				commandId: pendingCommands.current > 0 ? action.command : void 0,
-				error: result.status === "failed" ? result.error : void 0
-			});
-		});
-	}, [
-		activeNode.activity,
-		resetSession,
-		session,
-		snapshot.nodeId,
-		snapshot.sessionEpoch
-	]);
-	useEffect(() => {
-		if (activeNode.activity !== "paymentMethod" || snapshot.status !== "idle" || sales.payment.status !== "succeeded") return;
-		send({
-			kind: "intent",
-			activityId: "paymentMethod",
-			intent: "complete"
-		});
-	}, [
-		activeNode.activity,
-		sales.payment.status,
-		send,
-		snapshot.status
-	]);
+	useEffect(() => setMemberLoginOpen(false), [session, snapshot.nodeId]);
 	const memberAction = customer.visible ? {
 		member: customer.member,
 		memberName: customer.memberName,
@@ -211,7 +146,7 @@ function HDLKioskWorkflowView({ session, host, sales, config, isActive, renderId
 		errorReference: (_customer$error = customer.error) === null || _customer$error === void 0 ? void 0 : _customer$error.traceId,
 		onLogin: requestMemberLogin
 	} : void 0;
-	const canEndOrder = snapshot.status === "idle" && !resetting && !snapshot.pendingNavigation && !commandState.busy && !customer.busy && paymentSafeForReset;
+	const canEndOrder = snapshot.status === "idle" && !returning && !snapshot.pendingNavigation && !commandState.busy && !customer.busy && paymentSafeForReset;
 	const cartDrawerModel = useMemo(() => createCartDrawerModel(sales, snapshot.context.primaryWeightedProductId), [sales, snapshot.context.primaryWeightedProductId]);
 	const endOrderBottomBar = activeNode.activity === "paymentCompleted" ? void 0 : {
 		ariaLabel: locales.getText("pisell2.hdl-kiosk.exit-order"),
@@ -226,24 +161,28 @@ function HDLKioskWorkflowView({ session, host, sales, config, isActive, renderId
 			"aria-hidden": "true"
 		}, /* @__PURE__ */ React.createElement("path", { d: "m15 5-7 7 7 7M8 12h10" })), /* @__PURE__ */ React.createElement("span", null, locales.getText("pisell2.hdl-kiosk.back")))
 	};
-	if (resetError) return /* @__PURE__ */ React.createElement(HDLKioskShell, { snapshot }, /* @__PURE__ */ React.createElement(HDLKioskBottomBarHost, null, /* @__PURE__ */ React.createElement(HDLKioskHeader, null), /* @__PURE__ */ React.createElement("main", { className: "hdl-shell__main" }, /* @__PURE__ */ React.createElement(BlockingNotice, {
+	if (returnError) return /* @__PURE__ */ React.createElement(HDLKioskWorkflowBlockingSurface, {
+		snapshot,
 		title: locales.getText("pisell2.hdl-kiosk.reset-failed-title"),
 		description: locales.getText("pisell2.hdl-kiosk.reset-failed-description"),
-		reference: resetError.traceId
-	}))));
+		reference: returnError.traceId
+	});
 	if (snapshot.status === "blocked") {
 		var _snapshot$lastError;
-		return /* @__PURE__ */ React.createElement(HDLKioskShell, { snapshot }, /* @__PURE__ */ React.createElement(HDLKioskBottomBarHost, { mode: "hidden" }, /* @__PURE__ */ React.createElement(HDLKioskHeader, null), /* @__PURE__ */ React.createElement("main", { className: "hdl-shell__main" }, /* @__PURE__ */ React.createElement(BlockingNotice, {
+		return /* @__PURE__ */ React.createElement(HDLKioskWorkflowBlockingSurface, {
+			snapshot,
 			title: locales.getText("pisell2.hdl-kiosk.blocked-title"),
 			description: locales.getText("pisell2.hdl-kiosk.blocked-description"),
-			reference: (_snapshot$lastError = snapshot.lastError) === null || _snapshot$lastError === void 0 ? void 0 : _snapshot$lastError.traceId
-		}))));
+			reference: (_snapshot$lastError = snapshot.lastError) === null || _snapshot$lastError === void 0 ? void 0 : _snapshot$lastError.traceId,
+			hideBottomBar: true
+		});
 	}
 	return /* @__PURE__ */ React.createElement(HDLKioskShell, {
 		snapshot,
 		memberAction,
-		variant: currentScreenId === "identity" ? "identityGate" : "default"
+		variant: screenDataNode.surfaceId === "identity" ? "identityGate" : "default"
 	}, /* @__PURE__ */ React.createElement(HDLKioskBottomBarHost, {
+		onCartOpenChange: handleCartOpenChange,
 		mode: ((_activeNode$presentat = activeNode.presentation) === null || _activeNode$presentat === void 0 ? void 0 : _activeNode$presentat.mode) === "modal" || endOrderConfirmationOpen || memberLoginOpen ? "masked" : "visible",
 		fallback: endOrderBottomBar,
 		cartOverlayActions,
@@ -257,7 +196,7 @@ function HDLKioskWorkflowView({ session, host, sales, config, isActive, renderId
 		sales,
 		send,
 		commandState,
-		resetting,
+		resetting: returning,
 		capabilities: host.capabilities,
 		businessMode: config.businessMode,
 		scaleMinimumWeightKg: config.scaleTriggerMinimumWeightKg,