@aglyn/plugins-commerce 1.0.0-beta.230 → 1.0.0-beta.231

package/src/lib/components/console/pos/pos-api.js

@@ -0,0 +1,101 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+export class PosRequestError extends Error {
+    constructor(message, status){
+        super(message), this.status = status;
+    }
+}
+async function call(user, route, body, options = {}) {
+    var _options_method;
+    const method = (_options_method = options.method) != null ? _options_method : 'POST';
+    const url = method === 'GET' ? `${route}?${new URLSearchParams(Object.entries(body).map(([key, value])=>[
+            key,
+            String(value)
+        ])).toString()}` : route;
+    const response = await authorizedFetch(user, url, _extends({
+        method,
+        headers: _extends({}, method === 'POST' ? {
+            'Content-Type': 'application/json'
+        } : {}, options.attemptKey ? {
+            'Idempotency-Key': options.attemptKey
+        } : {})
+    }, method === 'POST' ? {
+        body: JSON.stringify(body)
+    } : {}));
+    const payload = await response.json().catch(()=>({}));
+    if (!response.ok) {
+        var _ref;
+        throw new PosRequestError(String((_ref = payload == null ? void 0 : payload.error) != null ? _ref : 'Something went wrong'), response.status);
+    }
+    return payload;
+}
+/** A fresh attempt key, for one press of one tender. */ export function newAttemptKey() {
+    var _ref;
+    var _globalThis_crypto_randomUUID, _globalThis_crypto;
+    return (_ref = (_globalThis_crypto = globalThis.crypto) == null ? void 0 : (_globalThis_crypto_randomUUID = _globalThis_crypto.randomUUID) == null ? void 0 : _globalThis_crypto_randomUUID.call(_globalThis_crypto)) != null ? _ref : `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
+export function posRegisterContext(user, hostId) {
+    return call(user, '/api/commerce/pos-payment', {
+        action: 'context',
+        hostId
+    }, {
+        method: 'GET'
+    });
+}
+/** Prices the basket on the server and opens a sale with an empty ledger. */ export function openPosSale(user, attemptKey, body) {
+    return call(user, '/api/commerce/pos-order', _extends({}, body, {
+        payment: 'open'
+    }), {
+        attemptKey
+    });
+}
+export function posTender(user, hostId, orderId, action, body = {}, attemptKey) {
+    return call(user, '/api/commerce/pos-payment', _extends({}, body, {
+        action,
+        hostId,
+        orderId
+    }), attemptKey ? {
+        attemptKey
+    } : {});
+}
+export function posGiftCardBalance(user, hostId, code) {
+    return call(user, '/api/commerce/pos-payment', {
+        action: 'gift-card-balance',
+        hostId,
+        code
+    });
+}
+export function posDisplayCall(user, body, method = 'POST') {
+    return call(user, '/api/commerce/pos-display', body, {
+        method
+    });
+}
+export function posReadersCall(user, body) {
+    return call(user, '/api/commerce/pos-readers', body);
+}
+/** Cents as the register shows them. */ export const usd = (cents)=>`$${(Math.max(0, cents) / 100).toFixed(2)}`;
+/** A dollar string the cashier typed, as whole cents (NaN-safe, never negative). */ export function centsFromInput(value) {
+    const number = Math.round(Number(String(value).replace(/[^0-9.]/g, '')) * 100);
+    return Number.isFinite(number) && number > 0 ? number : 0;
+}
+export function posNativeBridge() {
+    const bridge = globalThis.AglynPosBridge;
+    return bridge && typeof bridge.collectCardPayment === 'function' ? bridge : null;
+}
+
+//# sourceMappingURL=pos-api.js.map

package/src/lib/components/console/pos/pos-api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../../libs/plugins/commerce/src/lib/components/console/pos/pos-api.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport type * as CommerceModel from '../../../model'\nimport type { PosRegisterSettings } from '../../../plugin-config'\n\n/**\n * The register's client half (AGL-3607): one place that knows the routes, so\n * the components ask \"take cash\" rather than building requests. Every call\n * that starts a payment carries the attempt key it is given; the server\n * derives the payment from it, so a retried press finds the same payment.\n */\n\n/** The open sale as the server reports it after every change. */\nexport interface PosSaleSummary {\n  orderId: string\n  status: string\n  totalCents: number\n  paidCents: number\n  dueCents: number\n  tenderableCents: number\n  tipCents: number\n  payments: Array<{\n    id: string\n    method: CommerceModel.OrderPaymentMethod\n    amountCents: number\n    tipCents?: number\n    status: CommerceModel.OrderPaymentStatus\n    cardBrand?: string\n    last4?: string\n    changeCents?: number\n    checkoutUrl?: string\n    readerId?: string\n    failureMessage?: string\n    livemode?: boolean\n  }>\n}\n\nexport interface PosTenderResult {\n  sale: PosSaleSummary\n  paymentId?: string\n  completed: boolean\n  clientSecret?: string\n  paymentIntentId?: string\n}\n\nexport interface PosRegisterContext {\n  settings: PosRegisterSettings\n  terminal: { available: boolean; testMode: boolean }\n  readers: Array<{\n    id: string\n    label: string\n    registerId: string | null\n    status: string\n    livemode: boolean\n  }>\n  publishableKey: string\n  smsReceipts: boolean\n}\n\ntype User = Parameters<typeof authorizedFetch>[0]\n\nexport class PosRequestError extends Error {\n  constructor(\n    message: string,\n    readonly status: number,\n  ) {\n    super(message)\n  }\n}\n\nasync function call<T>(\n  user: User,\n  route: string,\n  body: Record<string, unknown>,\n  options: { attemptKey?: string; method?: 'GET' | 'POST' } = {},\n): Promise<T> {\n  const method = options.method ?? 'POST'\n  const url =\n    method === 'GET'\n      ? `${route}?${new URLSearchParams(\n          Object.entries(body).map(([key, value]) => [key, String(value)]),\n        ).toString()}`\n      : route\n  const response = await authorizedFetch(user, url, {\n    method,\n    headers: {\n      ...(method === 'POST' ? { 'Content-Type': 'application/json' } : {}),\n      ...(options.attemptKey ? { 'Idempotency-Key': options.attemptKey } : {}),\n    },\n    ...(method === 'POST' ? { body: JSON.stringify(body) } : {}),\n  })\n  const payload = await response.json().catch(() => ({}))\n  if (!response.ok) {\n    throw new PosRequestError(String(payload?.error ?? 'Something went wrong'), response.status)\n  }\n  return payload as T\n}\n\n/** A fresh attempt key, for one press of one tender. */\nexport function newAttemptKey(): string {\n  return (\n    globalThis.crypto?.randomUUID?.() ??\n    `${Date.now()}-${Math.random().toString(36).slice(2)}`\n  )\n}\n\nexport function posRegisterContext(user: User, hostId: string) {\n  return call<PosRegisterContext>(user, '/api/commerce/pos-payment', { action: 'context', hostId }, { method: 'GET' })\n}\n\n/** Prices the basket on the server and opens a sale with an empty ledger. */\nexport function openPosSale(\n  user: User,\n  attemptKey: string,\n  body: {\n    hostId: string\n    registerId: string\n    lines: unknown[]\n    discountPct: number\n    customerEmail?: string\n    /** The person the register's customer lookup attached (AGL-3609). */\n    customer?: unknown\n    /** A PIN-switched cashier's signed assertion (AGL-3609). */\n    cashierAssertion?: string\n    locationId?: string\n  },\n) {\n  return call<{ orderId: string; totals: CommerceModel.OrderTotals; dueCents: number; stockWarnings?: unknown[] }>(\n    user,\n    '/api/commerce/pos-order',\n    { ...body, payment: 'open' },\n    { attemptKey },\n  )\n}\n\nexport type PosTenderAction =\n  | 'cash'\n  | 'gift-card'\n  | 'folio'\n  | 'card-present'\n  | 'card-present-sdk'\n  | 'card-keyed'\n  | 'card-link'\n  | 'status'\n  | 'cancel'\n  | 'retry'\n  | 'simulate'\n  | 'void'\n  | 'receipt'\n\nexport function posTender(\n  user: User,\n  hostId: string,\n  orderId: string,\n  action: PosTenderAction,\n  body: Record<string, unknown> = {},\n  attemptKey?: string,\n) {\n  return call<PosTenderResult>(\n    user,\n    '/api/commerce/pos-payment',\n    { ...body, action, hostId, orderId },\n    attemptKey ? { attemptKey } : {},\n  )\n}\n\nexport function posGiftCardBalance(user: User, hostId: string, code: string) {\n  return call<{ availableCents: number; frozen: boolean; voided: boolean; last4: string }>(\n    user,\n    '/api/commerce/pos-payment',\n    { action: 'gift-card-balance', hostId, code },\n  )\n}\n\nexport function posDisplayCall<T = any>(\n  user: User,\n  body: Record<string, unknown>,\n  method: 'GET' | 'POST' = 'POST',\n) {\n  return call<T>(user, '/api/commerce/pos-display', body, { method })\n}\n\nexport function posReadersCall<T = any>(user: User, body: Record<string, unknown>) {\n  return call<T>(user, '/api/commerce/pos-readers', body)\n}\n\n/** Cents as the register shows them. */\nexport const usd = (cents: number) => `$${(Math.max(0, cents) / 100).toFixed(2)}`\n\n/** A dollar string the cashier typed, as whole cents (NaN-safe, never negative). */\nexport function centsFromInput(value: string): number {\n  const number = Math.round(Number(String(value).replace(/[^0-9.]/g, '')) * 100)\n  return Number.isFinite(number) && number > 0 ? number : 0\n}\n\n/*==========================================\n * THE NATIVE BRIDGE (AGL-3618).\n *\n * The POS companion app loads this register in a WebView and injects\n * `window.AglynPosBridge`. When it is there, the register offers a third\n * card option — Tap to Pay or a Bluetooth reader — and hands the app a\n * PaymentIntent the SERVER created (`card-present-sdk`); the app collects\n * the card with the Stripe Terminal SDK and the register settles it exactly\n * like a smart-reader payment, by asking the server.\n *=========================================*/\n\nexport interface AglynPosBridge {\n  collectCardPayment(input: {\n    paymentIntentId: string\n    clientSecret: string\n    amountCents: number\n  }): Promise<{ status: 'collected' | 'canceled' | 'failed'; message?: string }>\n}\n\nexport function posNativeBridge(): AglynPosBridge | null {\n  const bridge = (globalThis as { AglynPosBridge?: AglynPosBridge }).AglynPosBridge\n  return bridge && typeof bridge.collectCardPayment === 'function' ? bridge : null\n}\n"],"names":["authorizedFetch","PosRequestError","Error","message","status","call","user","route","body","options","method","url","URLSearchParams","Object","entries","map","key","value","String","toString","response","headers","attemptKey","JSON","stringify","payload","json","catch","ok","error","newAttemptKey","globalThis","crypto","randomUUID","Date","now","Math","random","slice","posRegisterContext","hostId","action","openPosSale","payment","posTender","orderId","posGiftCardBalance","code","posDisplayCall","posReadersCall","usd","cents","max","toFixed","centsFromInput","number","round","Number","replace","isFinite","posNativeBridge","bridge","AglynPosBridge","collectCardPayment"],"mappings":"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"}

package/src/lib/components/console/pos/pos-cart-panel.component.d.ts

@@ -0,0 +1,36 @@
+import type { ReactNode } from 'react';
+import type { ModifierSelection, StockShortfall } from '../../../model';
+export interface RegisterLine {
+    productId: string;
+    variantId?: string;
+    name: string;
+    variantLabel?: string;
+    /** Per unit, modifiers included: the register's estimate until the server prices it. */
+    unitAmountCents: number;
+    quantity: number;
+    /** The modifier options picked (AGL-3607); the server prices them. */
+    modifiers?: ModifierSelection[];
+}
+export interface PosCartPanelProps {
+    lines: RegisterLine[];
+    shortfalls: Array<Pick<StockShortfall, 'available'> | null>;
+    onQuantity: (index: number, quantity: number) => void;
+    onRemove: (index: number) => void;
+    /** Opens the line in the item sheet to change its options or quantity. */
+    onEdit?: (index: number) => void;
+    discountPct: number;
+    onDiscountPct: (value: number) => void;
+    /** The register's customer lookup (AGL-3609), under the discount. */
+    customer?: ReactNode;
+    /** Lines can no longer change: a sale is open against them. */
+    locked: boolean;
+}
+/**
+ * The basket (AGL-3607): lines with large quantity steppers, the stock
+ * warning under any line the shelf cannot cover (AGL-2357, said and never
+ * enforced), the cashier's discount and the customer the sale is for.
+ */
+export declare function PosCartPanel(props: PosCartPanelProps): import("react").JSX.Element;
+export declare namespace PosCartPanel {
+    var displayName: string;
+}

package/src/lib/components/console/pos/pos-cart-panel.component.js

@@ -0,0 +1,160 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Box, Button, ButtonBase, IconButton, Stack, TextField, Typography } from "@mui/material";
+import { POS_TOUCH_PX } from "./pos-product-grid.component.js";
+import { usd } from "./pos-api.js";
+/**
+ * The basket (AGL-3607): lines with large quantity steppers, the stock
+ * warning under any line the shelf cannot cover (AGL-2357, said and never
+ * enforced), the cashier's discount and the customer the sale is for.
+ */ export function PosCartPanel(props) {
+    const { lines, locked } = props;
+    return /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 1,
+        sx: {
+            minHeight: 0
+        },
+        children: [
+            /*#__PURE__*/ _jsx(Box, {
+                sx: {
+                    overflowY: 'auto',
+                    flex: 1
+                },
+                children: lines.length === 0 ? /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    color: "text.secondary",
+                    children: 'Tap products to add them.'
+                }) : lines.map((line, index)=>{
+                    var _line_variantId;
+                    var _props_shortfalls_index;
+                    return /*#__PURE__*/ _jsxs(Box, {
+                        sx: {
+                            py: 0.5
+                        },
+                        children: [
+                            /*#__PURE__*/ _jsxs(Stack, {
+                                direction: "row",
+                                spacing: 1,
+                                sx: {
+                                    alignItems: 'center'
+                                },
+                                children: [
+                                    /*#__PURE__*/ _jsx(ButtonBase, {
+                                        disabled: locked || !props.onEdit,
+                                        onClick: ()=>props.onEdit == null ? void 0 : props.onEdit.call(props, index),
+                                        "aria-label": locked ? undefined : `Change ${line.name}`,
+                                        sx: {
+                                            flex: 1,
+                                            minWidth: 0,
+                                            minHeight: POS_TOUCH_PX,
+                                            justifyContent: 'flex-start',
+                                            textAlign: 'left',
+                                            borderRadius: 1
+                                        },
+                                        children: /*#__PURE__*/ _jsxs(Box, {
+                                            sx: {
+                                                minWidth: 0
+                                            },
+                                            children: [
+                                                /*#__PURE__*/ _jsx(Typography, {
+                                                    variant: "body2",
+                                                    noWrap: true,
+                                                    children: `${line.quantity}× ${line.name}`
+                                                }),
+                                                line.variantLabel ? /*#__PURE__*/ _jsx(Typography, {
+                                                    variant: "caption",
+                                                    color: "text.secondary",
+                                                    component: "p",
+                                                    noWrap: true,
+                                                    children: line.variantLabel
+                                                }) : null
+                                            ]
+                                        })
+                                    }),
+                                    !locked ? /*#__PURE__*/ _jsxs(_Fragment, {
+                                        children: [
+                                            /*#__PURE__*/ _jsx(IconButton, {
+                                                "aria-label": `One fewer ${line.name}`,
+                                                onClick: ()=>props.onQuantity(index, line.quantity - 1),
+                                                sx: {
+                                                    width: POS_TOUCH_PX,
+                                                    height: POS_TOUCH_PX
+                                                },
+                                                children: '−'
+                                            }),
+                                            /*#__PURE__*/ _jsx(IconButton, {
+                                                "aria-label": `One more ${line.name}`,
+                                                onClick: ()=>props.onQuantity(index, line.quantity + 1),
+                                                sx: {
+                                                    width: POS_TOUCH_PX,
+                                                    height: POS_TOUCH_PX
+                                                },
+                                                children: '+'
+                                            })
+                                        ]
+                                    }) : null,
+                                    /*#__PURE__*/ _jsx(Typography, {
+                                        variant: "body2",
+                                        children: usd(line.unitAmountCents * line.quantity)
+                                    }),
+                                    !locked ? /*#__PURE__*/ _jsx(Button, {
+                                        color: "error",
+                                        onClick: ()=>props.onRemove(index),
+                                        "aria-label": `Remove ${line.name}`,
+                                        sx: {
+                                            minWidth: POS_TOUCH_PX,
+                                            minHeight: POS_TOUCH_PX
+                                        },
+                                        children: '✕'
+                                    }) : null
+                                ]
+                            }),
+                            props.shortfalls[index] ? /*#__PURE__*/ _jsx(Typography, {
+                                variant: "caption",
+                                color: "warning.main",
+                                children: `Only ${(_props_shortfalls_index = props.shortfalls[index]) == null ? void 0 : _props_shortfalls_index.available} in stock — selling ${line.quantity}`
+                            }) : null
+                        ]
+                    }, `${line.productId}:${(_line_variantId = line.variantId) != null ? _line_variantId : ''}:${index}`);
+                })
+            }),
+            /*#__PURE__*/ _jsx(Stack, {
+                direction: "row",
+                spacing: 1,
+                children: /*#__PURE__*/ _jsx(TextField, {
+                    label: "Discount %",
+                    value: props.discountPct || '',
+                    onChange: (event)=>props.onDiscountPct(Math.min(100, Math.max(0, Number(event.target.value) || 0))),
+                    disabled: locked,
+                    sx: {
+                        width: 120
+                    },
+                    slotProps: {
+                        htmlInput: {
+                            inputMode: 'numeric'
+                        }
+                    }
+                })
+            }),
+            props.customer
+        ]
+    });
+}
+PosCartPanel.displayName = 'PosCartPanel';
+
+//# sourceMappingURL=pos-cart-panel.component.js.map

package/src/lib/components/console/pos/pos-cart-panel.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../../libs/plugins/commerce/src/lib/components/console/pos/pos-cart-panel.component.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport type { ReactNode } from 'react'\nimport { Box, Button, ButtonBase, IconButton, Stack, TextField, Typography } from '@mui/material'\nimport type { ModifierSelection, StockShortfall } from '../../../model'\nimport { POS_TOUCH_PX } from './pos-product-grid.component'\nimport { usd } from './pos-api'\n\nexport interface RegisterLine {\n  productId: string\n  variantId?: string\n  name: string\n  variantLabel?: string\n  /** Per unit, modifiers included: the register's estimate until the server prices it. */\n  unitAmountCents: number\n  quantity: number\n  /** The modifier options picked (AGL-3607); the server prices them. */\n  modifiers?: ModifierSelection[]\n}\n\nexport interface PosCartPanelProps {\n  lines: RegisterLine[]\n  shortfalls: Array<Pick<StockShortfall, 'available'> | null>\n  onQuantity: (index: number, quantity: number) => void\n  onRemove: (index: number) => void\n  /** Opens the line in the item sheet to change its options or quantity. */\n  onEdit?: (index: number) => void\n  discountPct: number\n  onDiscountPct: (value: number) => void\n  /** The register's customer lookup (AGL-3609), under the discount. */\n  customer?: ReactNode\n  /** Lines can no longer change: a sale is open against them. */\n  locked: boolean\n}\n\n/**\n * The basket (AGL-3607): lines with large quantity steppers, the stock\n * warning under any line the shelf cannot cover (AGL-2357, said and never\n * enforced), the cashier's discount and the customer the sale is for.\n */\nexport function PosCartPanel(props: PosCartPanelProps) {\n  const { lines, locked } = props\n  return (\n    <Stack spacing={1} sx={{ minHeight: 0 }}>\n      <Box sx={{ overflowY: 'auto', flex: 1 }}>\n        {lines.length === 0 ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'Tap products to add them.'}\n          </Typography>\n        ) : (\n          lines.map((line, index) => (\n            <Box key={`${line.productId}:${line.variantId ?? ''}:${index}`} sx={{ py: 0.5 }}>\n              <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n                <ButtonBase\n                  disabled={locked || !props.onEdit}\n                  onClick={() => props.onEdit?.(index)}\n                  aria-label={locked ? undefined : `Change ${line.name}`}\n                  sx={{\n                    flex: 1,\n                    minWidth: 0,\n                    minHeight: POS_TOUCH_PX,\n                    justifyContent: 'flex-start',\n                    textAlign: 'left',\n                    borderRadius: 1,\n                  }}\n                >\n                  <Box sx={{ minWidth: 0 }}>\n                    <Typography variant=\"body2\" noWrap>\n                      {`${line.quantity}× ${line.name}`}\n                    </Typography>\n                    {line.variantLabel ? (\n                      <Typography variant=\"caption\" color=\"text.secondary\" component=\"p\" noWrap>\n                        {line.variantLabel}\n                      </Typography>\n                    ) : null}\n                  </Box>\n                </ButtonBase>\n                {!locked ? (\n                  <>\n                    <IconButton\n                      aria-label={`One fewer ${line.name}`}\n                      onClick={() => props.onQuantity(index, line.quantity - 1)}\n                      sx={{ width: POS_TOUCH_PX, height: POS_TOUCH_PX }}\n                    >\n                      {'−'}\n                    </IconButton>\n                    <IconButton\n                      aria-label={`One more ${line.name}`}\n                      onClick={() => props.onQuantity(index, line.quantity + 1)}\n                      sx={{ width: POS_TOUCH_PX, height: POS_TOUCH_PX }}\n                    >\n                      {'+'}\n                    </IconButton>\n                  </>\n                ) : null}\n                <Typography variant=\"body2\">{usd(line.unitAmountCents * line.quantity)}</Typography>\n                {!locked ? (\n                  <Button\n                    color=\"error\"\n                    onClick={() => props.onRemove(index)}\n                    aria-label={`Remove ${line.name}`}\n                    sx={{ minWidth: POS_TOUCH_PX, minHeight: POS_TOUCH_PX }}\n                  >\n                    {'✕'}\n                  </Button>\n                ) : null}\n              </Stack>\n              {props.shortfalls[index] ? (\n                <Typography variant=\"caption\" color=\"warning.main\">\n                  {`Only ${props.shortfalls[index]?.available} in stock — selling ${line.quantity}`}\n                </Typography>\n              ) : null}\n            </Box>\n          ))\n        )}\n      </Box>\n      <Stack direction=\"row\" spacing={1}>\n        <TextField\n          label=\"Discount %\"\n          value={props.discountPct || ''}\n          onChange={(event) =>\n            props.onDiscountPct(Math.min(100, Math.max(0, Number(event.target.value) || 0)))\n          }\n          disabled={locked}\n          sx={{ width: 120 }}\n          slotProps={{ htmlInput: { inputMode: 'numeric' } }}\n        />\n      </Stack>\n      {props.customer}\n    </Stack>\n  )\n}\nPosCartPanel.displayName = 'PosCartPanel'\n"],"names":["Box","Button","ButtonBase","IconButton","Stack","TextField","Typography","POS_TOUCH_PX","usd","PosCartPanel","props","lines","locked","spacing","sx","minHeight","overflowY","flex","length","variant","color","map","line","index","py","direction","alignItems","disabled","onEdit","onClick","aria-label","undefined","name","minWidth","justifyContent","textAlign","borderRadius","noWrap","quantity","variantLabel","component","onQuantity","width","height","unitAmountCents","onRemove","shortfalls","available","productId","variantId","label","value","discountPct","onChange","event","onDiscountPct","Math","min","max","Number","target","slotProps","htmlInput","inputMode","customer","displayName"],"mappings":"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"}

package/src/lib/components/console/pos/pos-item-dialog.component.d.ts

@@ -0,0 +1,39 @@
+import * as CommerceModel from '../../../model';
+/** What the dialog hands back: one basket line's worth of choices. */
+export interface PosItemChoice {
+    variant: CommerceModel.ProductVariant;
+    modifiers: CommerceModel.ModifierSelection[];
+    quantity: number;
+}
+export interface PosItemDialogProps {
+    /** The product being added or edited; `null` closes the dialog. */
+    product: (CommerceModel.HostProduct & {
+        $id: string;
+    }) | null;
+    /** An existing line's choices, when the cashier tapped a basket line. */
+    initial?: {
+        variantId?: string;
+        modifiers?: CommerceModel.ModifierSelection[];
+        quantity: number;
+    };
+    onClose: () => void;
+    onConfirm: (choice: PosItemChoice) => void;
+    /** Editing only: takes the line out of the basket. */
+    onRemove?: () => void;
+}
+/** Whether the register must ask before adding: a choice of variant or any modifier. */
+export declare function posItemNeedsChoice(product: CommerceModel.HostProduct): boolean;
+/**
+ * The register's item sheet (AGL-3607): the size, color or other variant,
+ * then each modifier group — required ones marked, "pick one" groups as a
+ * single toggle row and "pick up to N" groups as chips — and the quantity,
+ * with the line's price on the Add button as it changes. Full screen on a
+ * phone, a dialog on a tablet; every target is at least 44px.
+ *
+ * The price shown is the register's estimate. The server prices the line
+ * again from the product when the sale is charged.
+ */
+export declare function PosItemDialog(props: PosItemDialogProps): import("react").JSX.Element;
+export declare namespace PosItemDialog {
+    var displayName: string;
+}