@pisell/private-materials 6.12.169 → 6.12.170

package/es/components/HDLKiosk/components/common/HDLKioskSkuOptionsSelection/index.less

@@ -6,7 +6,7 @@
   }
 
   .hdl-kiosk-sku-options.is-disabled {
-    opacity: 0.62;
+    opacity: 1;
   }
 
   .hdl-kiosk-sku-options .pisell-batch-selector__content {

package/es/components/HDLKiosk/components/overlays/HDLKioskModal/index.less

@@ -158,7 +158,7 @@
     .hdl-kiosk-dialog input:disabled,
     .hdl-kiosk-dialog textarea:disabled {
       cursor: not-allowed;
-      opacity: 0.45;
+      opacity: 1;
     }
 
     .hdl-kiosk-dialog button:focus-visible,

package/es/components/HDLKiosk/components/shell/HDLKioskBottomBarHost/index.js

@@ -56,7 +56,7 @@ function resolveHDLKioskBottomBarState(mode, screenOverlayActive = false) {
 /**
 * Shell 内唯一的底栏与购物车抽屉挂载点。
 */
-function HDLKioskBottomBarHost({ children, mode = "visible", fallback, cartOverlayActions, promotionsAvailable = false }) {
+function HDLKioskBottomBarHost({ children, mode = "visible", fallback, cartOverlayActions, promotionsAvailable = false, onCartOpenChange }) {
 	var _declaration$leading, _cartBarDeclaration$s;
 	const [active, setActive] = useState();
 	const [cartOpen, setCartOpen] = useState(false);
@@ -120,6 +120,9 @@ function HDLKioskBottomBarHost({ children, mode = "visible", fallback, cartOverl
 	useEffect(() => {
 		if (presentation.drawerBlocked || !drawerAvailable) setCartOpen(false);
 	}, [drawerAvailable, presentation.drawerBlocked]);
+	useEffect(() => {
+		onCartOpenChange === null || onCartOpenChange === void 0 || onCartOpenChange(cartController.open);
+	}, [cartController.open, onCartOpenChange]);
 	return /* @__PURE__ */ React.createElement(HDLKioskBottomBarContext.Provider, { value: context }, /* @__PURE__ */ React.createElement(HDLKioskCartDrawerContext.Provider, { value: cartController }, children, presentation.renderBar && floatingBarDeclaration ? /* @__PURE__ */ React.createElement(HDLKioskFloatingBar, floatingBarDeclaration) : null));
 }
 //#endregion

package/es/components/HDLKiosk/docs/02-Host/351/200/202/351/205/215/344/270/216/344/270/232/345/212/241/346/225/260/346/215/256.md

@@ -55,20 +55,21 @@ Core 不能反向 import BigSale；Adapter 不能决定下一个 Workflow 节点
 
 | 文件                                                                                                      | 具体职责                                                                   | 不应放入的逻辑                         |
 | --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------- |
-| [`index.tsx`](../../bigSale/templates/HDLKiosk/index.tsx)                                                 | 合并 config、读取 Engine plugin、创建 Scale Hub/Runtime、装配 Host 和 Core | Workflow 节点、购物车操作              |
+| [`index.tsx`](../../bigSale/templates/HDLKiosk/index.tsx)                                                 | 合并 config、读取 Engine plugin、挂载 Scale Owner、装配 Host 和 Core       | Workflow 节点、购物车操作              |
 | [`primaryWeightedProduct.ts`](../../bigSale/templates/HDLKiosk/primaryWeightedProduct.ts)                 | 从 catalog list 的首条 data variant 解析称重主商品                         | 商品查询、隐式 fallback                |
 | [`types.ts`](../../bigSale/templates/HDLKiosk/types.ts)                                                   | 声明模板内部 `HDLKioskBigSaleHostBridge`，隔离尚未标准化的宿主窄能力       | BigSale 公共 Props、通用 SalesSDK 类型 |
 | [`adapter/useBigSaleHDLKioskHost.ts`](../../bigSale/templates/HDLKiosk/adapter/useBigSaleHDLKioskHost.ts) | 用 ref 持有最新 Context/bridge/scan handle，稳定 Host 引用                 | DTO 字段转换                           |
 | [`adapter/createHost.ts`](../../bigSale/templates/HDLKiosk/adapter/createHost.ts)                         | 组合 Sales/Device/Telemetry Port 和动态 capabilities                       | React 页面逻辑                         |
-| [`adapter/capabilities.ts`](../../bigSale/templates/HDLKiosk/adapter/capabilities.ts)                     | 将当前真实方法/bridge 组合为能力位                                         | 猜测业务成功                           |
-| [`adapter/projection.ts`](../../bigSale/templates/HDLKiosk/adapter/projection.ts)                         | Cart/Customer/Summary/Payment 标准化、lineId、fingerprint                  | 发命令、主动修订单                     |
-| [`adapter/sales.ts`](../../bigSale/templates/HDLKiosk/adapter/sales.ts)                                   | 实现全部 `HDLSalesPort` query/command，转换结果                            | 决定 target Screen                     |
-| [`adapter/weightedProduct.ts`](../../bigSale/templates/HDLKiosk/adapter/weightedProduct.ts)               | 解析称重商品、单位价格换算、验证重量、生成 prepared product                | 原生秤监听、页面状态                   |
-| [`adapter/customizationProduct.ts`](../../bigSale/templates/HDLKiosk/adapter/customizationProduct.ts)     | 安全投影单选 options、验证 selection、合成 SKU/options payload             | 通用商品详情 Flow                      |
-| [`adapter/devices.ts`](../../bigSale/templates/HDLKiosk/adapter/devices.ts)                               | 扫码/称重原始订阅转 `HDLDeviceEvent`，管理连接与释放                       | 判断当前 Workflow 是否消费             |
-| [`adapter/scaleTrigger.tsx`](../../bigSale/templates/HDLKiosk/adapter/scaleTrigger.tsx)                   | 隔离 `useNativeScale`、入口触发边沿、连接状态、共享 Scale Runtime          | 称重商品价格计算                       |
+| [`adapter/host/capabilities.ts`](../../bigSale/templates/HDLKiosk/adapter/host/capabilities.ts)           | 将当前真实方法/bridge 组合为能力位                                         | 猜测业务成功                           |
+| [`adapter/host/projection.ts`](../../bigSale/templates/HDLKiosk/adapter/host/projection.ts)               | Cart/Customer/Summary/Payment 标准化、lineId、fingerprint                  | 发命令、主动修订单                     |
+| [`adapter/sales/`](../../bigSale/templates/HDLKiosk/adapter/sales)                                       | 按能力实现 `HDLSalesPort` query/command，并在 `index.ts` 组合              | 决定 target Screen                     |
+| [`adapter/sales/weightedProduct.ts`](../../bigSale/templates/HDLKiosk/adapter/sales/weightedProduct.ts)   | 解析称重商品、单位价格换算、验证重量、生成 prepared product                | 原生秤监听、页面状态                   |
+| [`adapter/sales/customizationProduct.ts`](../../bigSale/templates/HDLKiosk/adapter/sales/customizationProduct.ts) | 安全投影单选 options、验证 selection、合成 SKU/options payload       | 通用商品详情 Flow                      |
+| [`adapter/devices/devicePort.ts`](../../bigSale/templates/HDLKiosk/adapter/devices/devicePort.ts)         | 扫码原始事件与 ScaleBridge 标准事件汇入 `HDLDevicePort`                    | 判断当前 Workflow 是否消费             |
+| [`runtime/scaleBridge.ts`](../../bigSale/templates/HDLKiosk/runtime/scaleBridge.ts)                       | 统一 Scale Snapshot、owner 身份与标准设备事件流                            | React Hook、称重商品价格计算           |
+| [`runtime/BigSaleScaleRuntimeOwner.tsx`](../../bigSale/templates/HDLKiosk/runtime/BigSaleScaleRuntimeOwner.tsx) | 隔离 `useNativeScale`，校验实时帧并发布给 ScaleBridge                 | Workflow 跳转、购物车写入              |
 | [`adapter/normalize.ts`](../../bigSale/templates/HDLKiosk/adapter/normalize.ts)                           | Host 错误与未知结果标准化、安全路径读取                                    | 业务重试策略                           |
-| [`adapter/telemetry.ts`](../../bigSale/templates/HDLKiosk/adapter/telemetry.ts)                           | 当前 no-op Telemetry Port，保留正式 sink 接口                              | `console` 散落埋点                     |
+| [`adapter/host/telemetry.ts`](../../bigSale/templates/HDLKiosk/adapter/host/telemetry.ts)                 | 当前 no-op Telemetry Port，保留正式 sink 接口                              | `console` 散落埋点                     |
 
 兼容层还扩展了 SalesSDK Products Context：
 
@@ -84,12 +85,12 @@ Core 不能反向 import BigSale；Adapter 不能决定下一个 Workflow 节点
 ```mermaid
 flowchart LR
   CTX["BigSaleContext\nsales / products / cart / customer / summary"]
-  BRIDGE["Internal HDLKioskBigSaleHostBridge\ncurrent: scale hub subscriptions\nreserved: member / fulfillment"]
+  BRIDGE["Internal HDLKioskBigSaleHostBridge\nscale event source / member / fulfillment"]
   PLUGIN["Engine nativeScaleTools"]
   REF["Stable source refs\nlatest context / bridge / scan"]
   PROJECTION["projection.ts\nObservedSalesSnapshot"]
   SALES["sales.ts\nHDLSalesPort"]
-  DEVICE["devices.ts + scaleTrigger.tsx\nHDLDevicePort / ScaleRuntime"]
+  DEVICE["devicePort.ts + ScaleBridge + ScaleOwner\nHDLDevicePort / ScaleRuntime"]
   CAP["capabilities.ts\ndynamic capability getter"]
   HOST["Stable HDLKioskHost"]
   CORE["Independent HDLKiosk Core"]
@@ -120,10 +121,10 @@ resolveHDLKioskBigSaleConfig
         ↓
 读取 Engine nativeScaleTools plugin
         ↓
-创建 ScaleTriggerHub + HDLScaleRuntime
+创建 ScaleBridge（内部统一 ownerId + HDLScaleRuntime + device events）
         ↓
 创建模板内部 internalBridge
-  └─ weight/connection 订阅来自 ScaleTriggerHub
+  └─ subscribeScaleEvents 来自 ScaleBridge
         ↓
 useBigSaleHDLKioskHost → stable HDLKioskHost
         ↓
@@ -338,25 +339,25 @@ acquireScanFocus(handler, { priority: 100, id: 'hdl-kiosk' })
 `useNativeScale` 是 Hook，不能直接塞进普通 Adapter 函数。`BigSaleScaleRuntimeOwner` 常驻模板顶层：
 
 - Hook `autoStart` 随物料 active；
-- 发布完整 Scale Snapshot 给 Core `HDLScaleRuntime`；
-- 发布连接状态和首次有效正重给 `ScaleTriggerHub`；
+- 通过 `ScaleBridge` 发布完整 Snapshot 给 Core `HDLScaleRuntime`；
+- 通过同一个 Bridge 发布连接状态和首次有效正重标准事件；
 - 重量回落到阈值下后才允许下一次入口触发；
 - Error Boundary 将 Hook 异常转成 scale error，不炸毁 HDLKiosk；
 - ownerId 防止多个发布者同时写同一 Runtime。
 
-内部 Bridge 的 `subscribeWeightChange/subscribeScaleConnection` 只承接 ScaleTriggerHub 的入口事件；当前详情实时读数和 capability 仍要求 `nativeScaleTools.useNativeScale`，不能把一个只发入口事件的 bridge 冒充完整称重能力。
+内部 Host Bridge 只暴露一个 `subscribeScaleEvents` 标准事件源；详情连续读数直接读取同一 `ScaleBridge.runtime`。Capability 仍要求 `nativeScaleTools.useNativeScale`，不能把一个没有真实 Hook 来源的 Bridge 冒充完整称重能力。
 
 ## 13. 模板内部 Narrow Host Bridge
 
 [`HDLKioskBigSaleHostBridge`](../../bigSale/templates/HDLKiosk/types.ts) 只承接尚未由 SalesSDK 标准化的能力。它有意声明在 `bigSale/templates/HDLKiosk` 内部，不从 `bigSale/types.ts` 导出，也不通过 `BigSaleProps → BigSaleBaseProps → BigSaleTemplateRendererProps` 透传。
 
-当前装配提供称重 Hub 订阅和 Identity H5 认证客户读取；履约字段仍是模板适配层的待接能力描述，并不存在外部调用方：
+当前装配提供 ScaleBridge 事件订阅和 Identity H5 认证客户读取；履约字段仍是模板适配层的待接能力描述，并不存在外部调用方：
 
 | Bridge                             | 契约要求                                    |
 | ---------------------------------- | ------------------------------------------- |
 | `getAuthenticatedCustomer`         | 按 customerId 读取模板内认证结果；只读，不在 UI 中写订单客户 |
 | `writeFulfillment`                 | 真正写入堂食/外带订单事实，不能只改 UI 参数 |
-| `subscribeWeightChange/Connection` | 可选入口触发覆盖，不替代详情 Scale Runtime  |
+| `subscribeScaleEvents`             | ScaleBridge 的标准入口事件；连续详情读数来自同一 Bridge Runtime |
 
 Bridge 使用 getter/ref 消费最新实例。新增字段前先判断它是否应成为 SalesSDK 正式能力；不要把业务对象塞进通用 metadata。
 
@@ -433,7 +434,7 @@ Abort 的时机很重要：dispatch 前可 cancelled；dispatch 后再 abort 通
 | 连续加购进入 checking              | Core cart consistency + SalesSDK barrier  | Host 屏障与 React pending 展示态是否混淆                     |
 | Catalog 加购时闪动                 | Shell/Screen busy presentation            | 是否全屏遮罩或全部卡片透明度变化，不先怀疑数据丢失           |
 | Scale 入口 unavailable             | plugin + capability + bridge gating       | `useNativeScale`、prepared product、queryProducts 是否齐全   |
-| Scale 有读数但不自动进入           | `scaleTrigger` + Core ScaleIngress        | 阈值、connection、重复边沿、当前 session lock                |
+| Scale 有读数但不自动进入           | `ScaleBridge` + Core ScaleIngress         | 阈值、connection、重复边沿、当前 session lock                |
 | 登录成功但金额不变                 | identity Operation + Summary Projection   | customer 是否写入、consistency/重报价是否完成                |
 | Checkout 后 blocked                | callback normalizer + Payment Projection  | 是明确 failed 还是 unknown，禁止直接放行                     |
 | 刷新后存在旧订单或支付状态         | Host/OS 订单与支付处置                    | 当前 OS payment/cart 事实与员工处置入口                       |

package/es/components/HDLKiosk/index.js

@@ -31,7 +31,7 @@ function HDLKiosk(_ref) {
 	const localScaleRuntime = useMemo(createHDLScaleRuntime, []);
 	return /* @__PURE__ */ React.createElement(HDLScaleRuntimeProvider, { runtime: scaleRuntime !== null && scaleRuntime !== void 0 ? scaleRuntime : localScaleRuntime }, /* @__PURE__ */ React.createElement(HDLKioskContent, props));
 }
-function HDLKioskContent({ host, config, isActive = true, entryDataPreparing = false, locale, onLocaleChange, onTechnicalSupportClick, renderIdentityAuth, renderCartContent, cartOverlayActions }) {
+function HDLKioskContent({ host, config, isActive = true, entryDataPreparing = false, locale, onLocaleChange, onCollaborationStatusChange, onTechnicalSupportClick, renderIdentityAuth, renderCartContent, cartOverlayActions }) {
 	const [activeLocale, setActiveLocale] = useState(locale || "en");
 	const [scaleSimulatorAuthOpen, setScaleSimulatorAuthOpen] = useState(false);
 	const sales = useHostSnapshot(host);
@@ -51,6 +51,13 @@ function HDLKioskContent({ host, config, isActive = true, entryDataPreparing = f
 		config,
 		isActive
 	});
+	useEffect(() => {
+		if (isActive && !session) onCollaborationStatusChange === null || onCollaborationStatusChange === void 0 || onCollaborationStatusChange("home");
+	}, [
+		isActive,
+		onCollaborationStatusChange,
+		session
+	]);
 	const { scaleConnectionState } = useHDLKioskDeviceController({
 		host,
 		isActive
@@ -73,7 +80,8 @@ function HDLKioskContent({ host, config, isActive = true, entryDataPreparing = f
 		returnToEntry,
 		renderIdentityAuth,
 		renderCartContent,
-		cartOverlayActions
+		cartOverlayActions,
+		onCollaborationStatusChange
 	}) : /* @__PURE__ */ React.createElement("div", { className: "hdl-entry-shell" }, /* @__PURE__ */ React.createElement(EntryScreen, {
 		locale: activeLocale,
 		model: createEntryScreenModel(config, host.capabilities, scaleConnectionState, sales.hostStatus, entryDataPreparing),

package/es/components/HDLKiosk/index.less

@@ -64,9 +64,14 @@
     outline-offset: 3px;
   }
 
-  button:disabled {
+  // 异步操作会短暂切换 disabled；禁用态只负责阻止交互，不改变视觉透明度，
+  // 避免按钮（尤其是右上角会员入口）在请求前后产生闪烁。
+  button:disabled,
+  input:disabled,
+  textarea:disabled {
     cursor: not-allowed;
-    opacity: 0.45;
+    // 覆盖嵌入的 Login2/Register2 等旧物料自带的 disabled 透明度。
+    opacity: 1 !important;
   }
 }
 

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/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/ui/HDLKioskWorkflowView.js

@@ -13,6 +13,7 @@ import { BlockingNotice } from "../components/common/BlockingNotice/index.js";
 import { createCartDrawerModel } from "../utils.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/ui/HDLKioskWorkflowView.tsx
@@ -53,7 +54,7 @@ function HDLKioskWorkflowBlockingSurface({ snapshot, title, description, referen
 * 它把运行时控制器投影为 Screen/Dialog 所需的 props；具体页面不直接接触
 * Host、Workflow Actor 或会话计时器。
 */
-function HDLKioskWorkflowView({ session, host, sales, config, isActive, returning, returnError, renderIdentityAuth, renderCartContent, cartOverlayActions, returnToEntry }) {
+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 navigationSequence = useRef(0);
@@ -65,6 +66,29 @@ function HDLKioskWorkflowView({ session, host, sales, config, isActive, returnin
 	});
 	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 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,
@@ -158,6 +182,7 @@ function HDLKioskWorkflowView({ session, host, sales, config, isActive, returnin
 		memberAction,
 		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,

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

@@ -0,0 +1,11 @@
+//#region src/components/HDLKiosk/ui/collaborationStatus.ts
+/** 把当前可见 Screen 映射为主屏协同预览状态；购物车由 Shell 临时覆盖。 */
+function resolveHDLKioskCollaborationStatus(screenId) {
+	if (screenId === "entry") return "home";
+	if (screenId === "identity") return "identity";
+	if (screenId === "customization" || screenId === "catalog") return "selling";
+	if (screenId === "fulfillment") return "fulfillment";
+	if (screenId === "checkout") return "checkout";
+}
+//#endregion
+export { resolveHDLKioskCollaborationStatus };

package/es/components/bigSale/components/BookingFloatingPanel/useBookingPanelController.js

@@ -1,6 +1,5 @@
 import useEngineContext from "../../../../hooks/useEngineContext.js";
 import { subscribeBookingDateChange } from "../../../../plus/salesSdk/utils/bookingDate.js";
-import "../../../../plus/salesSdk/index.js";
 import dayjs from "dayjs";
 import { useCallback, useEffect, useState } from "react";
 //#region src/components/bigSale/components/BookingFloatingPanel/useBookingPanelController.ts

package/es/components/bigSale/components/TimeBar/index.js

@@ -4,7 +4,6 @@ import withResponsive from "../../../../responsive/withResponsive.js";
 import useInitLocalesOnce from "../../../../hooks/useInitLocalesOnce.js";
 import { subscribeBookingDateChange } from "../../../../plus/salesSdk/utils/bookingDate.js";
 import { useSalesSdkBookingContext } from "../../../../plus/salesSdk/context/SalesSdkBookingContext.js";
-import "../../../../plus/salesSdk/index.js";
 import locales_default from "../../locales/index.js";
 import dayjs from "dayjs";
 import React, { forwardRef, useEffect, useImperativeHandle, useMemo, useRef, useState } from "react";

package/es/components/bigSale/dialog.js

@@ -5,7 +5,6 @@ import { buildInitBookingContextParams, collectBookingIdsFromTempOrder } from ".
 import { useSalesSdk } from "../../plus/salesSdk/hooks/useSalesSdk.js";
 import { useSalesSdkCart } from "../../plus/salesSdk/hooks/useSalesSdkCart.js";
 import { SalesSdkPrepareOrderSwitchContext, SalesSdkRootRefreshContext } from "../../plus/salesSdk/context/SalesSdkProvider.js";
-import "../../plus/salesSdk/index.js";
 import { seedDineInReservationToCart } from "../../plus/pisellReservation/utils/seedDineInReservationToCart.js";
 import BigSale from "./index.js";
 import dayjs from "dayjs";

package/es/components/bigSale/hooks/useBigSaleContext.js

@@ -4,7 +4,6 @@ import { useSalesSdkCustomer } from "../../../plus/salesSdk/hooks/useSalesSdkCus
 import { useSalesSdkBookingContext } from "../../../plus/salesSdk/context/SalesSdkBookingContext.js";
 import { useSalesSdkSummary } from "../../../plus/salesSdk/hooks/useSalesSdkSummary.js";
 import { useSalesSdkProducts } from "../../../plus/salesSdk/hooks/useSalesSdkProducts.js";
-import "../../../plus/salesSdk/index.js";
 import { useMemo } from "react";
 //#region src/components/bigSale/hooks/useBigSaleContext.ts
 /**

package/es/components/bigSale/hooks/useSelectFloorMapResourceForBigSale.js

@@ -3,7 +3,6 @@ import useEngineContext from "../../../hooks/useEngineContext.js";
 import { buildInitBookingContextParams, collectBookingIdsFromTempOrder } from "../../../plus/salesSdk/utils/buildDefaultLoadProductsParams.js";
 import { useSalesSdkUIHosts } from "../../../plus/salesSdk/context/SalesSdkUIHostsContext.js";
 import { SalesSdkRootRefreshContext } from "../../../plus/salesSdk/context/SalesSdkProvider.js";
-import "../../../plus/salesSdk/index.js";
 import { resolveOrderIdForHostActions } from "../../../plus/pisellReservation/components/bookingDetailModal/bookingDetailHostActions.js";
 import { usePicoCodingOpenData } from "../../../plus/pisellReservation/hooks/usePicoCodingOpenData.js";
 import { seedDineInReservationToCart } from "../../../plus/pisellReservation/utils/seedDineInReservationToCart.js";

package/es/components/bigSale/index.js

@@ -8,7 +8,6 @@ import { useSalesSdk } from "../../plus/salesSdk/hooks/useSalesSdk.js";
 import { useSalesSdkCustomer } from "../../plus/salesSdk/hooks/useSalesSdkCustomer.js";
 import { SalesSdkProvider } from "../../plus/salesSdk/context/SalesSdkProvider.js";
 import { SalesSdkBookingContextProvider } from "../../plus/salesSdk/context/SalesSdkBookingContext.js";
-import "../../plus/salesSdk/index.js";
 import { ResponsiveBigSaleBase } from "./Base.js";
 import { isBigSaleProductSelectionFlowScene, resolveBigSaleSelectionFlowConfig } from "./selectionFlowConfig.js";
 import { isKioskPresentation } from "./templateCapabilities.js";

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;

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,7 +1,7 @@
-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，

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 };