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

package/src/lib/components/console/product-labels-dialog.component.js

@@ -0,0 +1,197 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, Dialog, DialogActions, DialogContent, DialogTitle, MenuItem, Stack, TextField, Typography } from "@mui/material";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { useEffect, useMemo, useState } from "react";
+import { LABEL_SIZES, MAX_LABEL_COPIES, productLabelsHtml, productLabelsZpl } from "../../printing/product-labels.js";
+/**
+ * Print product labels (AGL-3619): a label per variant with its name,
+ * options, price and a barcode the register scans back, on a thermal label
+ * printer through the browser, or as ZPL for a Zebra.
+ */ const COPIES_INPUT = {
+    htmlInput: {
+        inputMode: 'numeric',
+        min: 0,
+        max: MAX_LABEL_COPIES
+    }
+};
+/** The labels a product prints: one row per variant that has a barcode or SKU. */ export function productLabelRows(product) {
+    return product.variants.map((variant)=>{
+        var _variant_options;
+        const options = Object.values((_variant_options = variant.options) != null ? _variant_options : {}).filter(Boolean);
+        return _extends({
+            variantId: variant.id,
+            name: product.name
+        }, options.length ? {
+            detail: options.join(' / ')
+        } : {}, Number.isFinite(Number(variant.priceUsd)) ? {
+            priceCents: Math.round(Number(variant.priceUsd) * 100)
+        } : {}, {
+            currency: 'usd',
+            code: String(variant.barcode || variant.sku || '').trim(),
+            copies: 1
+        });
+    });
+}
+export function ProductLabelsDialog(props) {
+    var _ref;
+    const { product, onClose } = props;
+    const { enqueueSnackbar } = useSnackbar();
+    const initial = useMemo(()=>product ? productLabelRows(product) : [], [
+        product
+    ]);
+    const [rows, setRows] = useState(initial);
+    const [sizeId, setSizeId] = useState(LABEL_SIZES[0].id);
+    useEffect(()=>setRows(initial), [
+        initial
+    ]);
+    const printable = rows.filter((row)=>row.code && row.copies > 0);
+    const total = printable.reduce((sum, row)=>sum + row.copies, 0);
+    const setCopies = (variantId, value)=>setRows((current)=>current.map((row)=>row.variantId === variantId ? _extends({}, row, {
+                    copies: Math.max(0, Math.min(MAX_LABEL_COPIES, Math.floor(Number(value) || 0)))
+                }) : row));
+    const print = ()=>{
+        const win = window.open('', '_blank', 'width=480,height=640');
+        if (!win) {
+            return void enqueueSnackbar('Allow pop-ups for this site to print labels', {
+                variant: 'warning',
+                persist: false
+            });
+        }
+        // Every merchant-authored value on the page is escaped by the renderer.
+        win.document.write(productLabelsHtml(printable, sizeId));
+        win.document.close();
+        win.focus();
+        win.print();
+    };
+    const downloadZpl = ()=>{
+        var _ref;
+        const blob = new Blob([
+            productLabelsZpl(printable, sizeId)
+        ], {
+            type: 'text/plain'
+        });
+        const url = URL.createObjectURL(blob);
+        const link = document.createElement('a');
+        link.href = url;
+        link.download = `labels-${((_ref = product == null ? void 0 : product.name) != null ? _ref : 'product').replace(/[^A-Za-z0-9]+/g, '-').toLowerCase()}.zpl`;
+        link.click();
+        setTimeout(()=>URL.revokeObjectURL(url), 1000);
+    };
+    return /*#__PURE__*/ _jsxs(Dialog, {
+        open: Boolean(product),
+        onClose: onClose,
+        fullWidth: true,
+        maxWidth: "sm",
+        children: [
+            /*#__PURE__*/ _jsx(DialogTitle, {
+                children: `Labels — ${(_ref = product == null ? void 0 : product.name) != null ? _ref : ''}`
+            }),
+            /*#__PURE__*/ _jsx(DialogContent, {
+                children: /*#__PURE__*/ _jsxs(Stack, {
+                    spacing: 2,
+                    sx: {
+                        pt: 1
+                    },
+                    children: [
+                        /*#__PURE__*/ _jsx(TextField, {
+                            select: true,
+                            label: "Label size",
+                            value: sizeId,
+                            onChange: (event)=>setSizeId(event.target.value),
+                            children: LABEL_SIZES.map((size)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                    value: size.id,
+                                    children: size.label
+                                }, size.id))
+                        }),
+                        rows.map((row)=>{
+                            var _row_detail;
+                            return /*#__PURE__*/ _jsxs(Stack, {
+                                direction: "row",
+                                spacing: 2,
+                                sx: {
+                                    alignItems: 'center'
+                                },
+                                children: [
+                                    /*#__PURE__*/ _jsxs(Stack, {
+                                        sx: {
+                                            flex: 1,
+                                            minWidth: 0
+                                        },
+                                        children: [
+                                            /*#__PURE__*/ _jsx(Typography, {
+                                                variant: "body2",
+                                                noWrap: true,
+                                                children: (_row_detail = row.detail) != null ? _row_detail : row.name
+                                            }),
+                                            /*#__PURE__*/ _jsx(Typography, {
+                                                variant: "caption",
+                                                color: row.code ? 'text.secondary' : 'warning.main',
+                                                noWrap: true,
+                                                children: row.code || 'Add a barcode or SKU to print a label'
+                                            })
+                                        ]
+                                    }),
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        label: "Copies",
+                                        type: "number",
+                                        size: "small",
+                                        value: row.code ? row.copies : 0,
+                                        disabled: !row.code,
+                                        onChange: (event)=>setCopies(row.variantId, event.target.value),
+                                        slotProps: COPIES_INPUT,
+                                        sx: {
+                                            width: 96
+                                        }
+                                    })
+                                ]
+                            }, row.variantId);
+                        }),
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "text.secondary",
+                            children: 'Print to a label printer at 100% scale, or download ZPL to send straight to a Zebra.'
+                        })
+                    ]
+                })
+            }),
+            /*#__PURE__*/ _jsxs(DialogActions, {
+                children: [
+                    /*#__PURE__*/ _jsx(Button, {
+                        onClick: onClose,
+                        children: 'Cancel'
+                    }),
+                    /*#__PURE__*/ _jsx(Button, {
+                        disabled: !total,
+                        onClick: downloadZpl,
+                        children: 'Download ZPL'
+                    }),
+                    /*#__PURE__*/ _jsx(Button, {
+                        disabled: !total,
+                        onClick: print,
+                        children: total === 1 ? 'Print 1 label' : `Print ${total} labels`
+                    })
+                ]
+            })
+        ]
+    });
+}
+export default ProductLabelsDialog;
+
+//# sourceMappingURL=product-labels-dialog.component.js.map

package/src/lib/components/console/product-labels-dialog.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/product-labels-dialog.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 * as CommerceModel from '../../model'\nimport {\n  Button,\n  Dialog,\n  DialogActions,\n  DialogContent,\n  DialogTitle,\n  MenuItem,\n  Stack,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport { useEffect, useMemo, useState } from 'react'\nimport {\n  LABEL_SIZES,\n  MAX_LABEL_COPIES,\n  productLabelsHtml,\n  productLabelsZpl,\n  type ProductLabel,\n} from '../../printing/product-labels'\n\n/**\n * Print product labels (AGL-3619): a label per variant with its name,\n * options, price and a barcode the register scans back, on a thermal label\n * printer through the browser, or as ZPL for a Zebra.\n */\n\nconst COPIES_INPUT = { htmlInput: { inputMode: 'numeric', min: 0, max: MAX_LABEL_COPIES } } as const\n\n/** The labels a product prints: one row per variant that has a barcode or SKU. */\nexport function productLabelRows(product: CommerceModel.HostProduct): Array<ProductLabel & { variantId: string }> {\n  return product.variants.map((variant) => {\n    const options = Object.values(variant.options ?? {}).filter(Boolean)\n    return {\n      variantId: variant.id,\n      name: product.name,\n      ...(options.length ? { detail: options.join(' / ') } : {}),\n      ...(Number.isFinite(Number(variant.priceUsd))\n        ? { priceCents: Math.round(Number(variant.priceUsd) * 100) }\n        : {}),\n      currency: 'usd',\n      code: String(variant.barcode || variant.sku || '').trim(),\n      copies: 1,\n    }\n  })\n}\n\nexport function ProductLabelsDialog(props: {\n  product: (CommerceModel.HostProduct & { $id: string }) | null\n  onClose: () => void\n}) {\n  const { product, onClose } = props\n  const { enqueueSnackbar } = useSnackbar()\n  const initial = useMemo(() => (product ? productLabelRows(product) : []), [product])\n  const [rows, setRows] = useState(initial)\n  const [sizeId, setSizeId] = useState(LABEL_SIZES[0].id)\n  useEffect(() => setRows(initial), [initial])\n  const printable = rows.filter((row) => row.code && row.copies > 0)\n  const total = printable.reduce((sum, row) => sum + row.copies, 0)\n\n  const setCopies = (variantId: string, value: string) =>\n    setRows((current) =>\n      current.map((row) =>\n        row.variantId === variantId\n          ? { ...row, copies: Math.max(0, Math.min(MAX_LABEL_COPIES, Math.floor(Number(value) || 0))) }\n          : row,\n      ),\n    )\n\n  const print = () => {\n    const win = window.open('', '_blank', 'width=480,height=640')\n    if (!win) {\n      return void enqueueSnackbar('Allow pop-ups for this site to print labels', {\n        variant: 'warning',\n        persist: false,\n      })\n    }\n    // Every merchant-authored value on the page is escaped by the renderer.\n    win.document.write(productLabelsHtml(printable, sizeId))\n    win.document.close()\n    win.focus()\n    win.print()\n  }\n\n  const downloadZpl = () => {\n    const blob = new Blob([productLabelsZpl(printable, sizeId)], { type: 'text/plain' })\n    const url = URL.createObjectURL(blob)\n    const link = document.createElement('a')\n    link.href = url\n    link.download = `labels-${(product?.name ?? 'product').replace(/[^A-Za-z0-9]+/g, '-').toLowerCase()}.zpl`\n    link.click()\n    setTimeout(() => URL.revokeObjectURL(url), 1000)\n  }\n\n  return (\n    <Dialog open={Boolean(product)} onClose={onClose} fullWidth maxWidth=\"sm\">\n      <DialogTitle>{`Labels — ${product?.name ?? ''}`}</DialogTitle>\n      <DialogContent>\n        <Stack spacing={2} sx={{ pt: 1 }}>\n          <TextField select label=\"Label size\" value={sizeId} onChange={(event) => setSizeId(event.target.value)}>\n            {LABEL_SIZES.map((size) => (\n              <MenuItem key={size.id} value={size.id}>\n                {size.label}\n              </MenuItem>\n            ))}\n          </TextField>\n          {rows.map((row) => (\n            <Stack key={row.variantId} direction=\"row\" spacing={2} sx={{ alignItems: 'center' }}>\n              <Stack sx={{ flex: 1, minWidth: 0 }}>\n                <Typography variant=\"body2\" noWrap>\n                  {row.detail ?? row.name}\n                </Typography>\n                <Typography variant=\"caption\" color={row.code ? 'text.secondary' : 'warning.main'} noWrap>\n                  {row.code || 'Add a barcode or SKU to print a label'}\n                </Typography>\n              </Stack>\n              <TextField\n                label=\"Copies\"\n                type=\"number\"\n                size=\"small\"\n                value={row.code ? row.copies : 0}\n                disabled={!row.code}\n                onChange={(event) => setCopies(row.variantId, event.target.value)}\n                slotProps={COPIES_INPUT}\n                sx={{ width: 96 }}\n              />\n            </Stack>\n          ))}\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'Print to a label printer at 100% scale, or download ZPL to send straight to a Zebra.'}\n          </Typography>\n        </Stack>\n      </DialogContent>\n      <DialogActions>\n        <Button onClick={onClose}>{'Cancel'}</Button>\n        <Button disabled={!total} onClick={downloadZpl}>\n          {'Download ZPL'}\n        </Button>\n        <Button disabled={!total} onClick={print}>\n          {total === 1 ? 'Print 1 label' : `Print ${total} labels`}\n        </Button>\n      </DialogActions>\n    </Dialog>\n  )\n}\n\nexport default ProductLabelsDialog\n"],"names":["Button","Dialog","DialogActions","DialogContent","DialogTitle","MenuItem","Stack","TextField","Typography","useSnackbar","useEffect","useMemo","useState","LABEL_SIZES","MAX_LABEL_COPIES","productLabelsHtml","productLabelsZpl","COPIES_INPUT","htmlInput","inputMode","min","max","productLabelRows","product","variants","map","variant","options","Object","values","filter","Boolean","variantId","id","name","length","detail","join","Number","isFinite","priceUsd","priceCents","Math","round","currency","code","String","barcode","sku","trim","copies","ProductLabelsDialog","props","onClose","enqueueSnackbar","initial","rows","setRows","sizeId","setSizeId","printable","row","total","reduce","sum","setCopies","value","current","floor","print","win","window","open","persist","document","write","close","focus","downloadZpl","blob","Blob","type","url","URL","createObjectURL","link","createElement","href","download","replace","toLowerCase","click","setTimeout","revokeObjectURL","fullWidth","maxWidth","spacing","sx","pt","select","label","onChange","event","target","size","direction","alignItems","flex","minWidth","noWrap","color","disabled","slotProps","width","onClick"],"mappings":"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"}

package/src/lib/components/console/product-register-fields.component.d.ts

@@ -0,0 +1,19 @@
+import * as CommerceModel from '../../model';
+type Patch = Partial<CommerceModel.HostProduct>;
+export interface ProductRegisterFieldsProps {
+    posQuickKey: boolean;
+    modifierGroups: readonly CommerceModel.ProductModifierGroup[];
+    update: (patch: Patch) => void;
+}
+/**
+ * The product's register settings (AGL-3607): whether it is a quick key on
+ * the register's first screen, and its modifier groups — choices such as
+ * "Milk" or "Add-ons" the cashier picks as the item is rung up, each choice
+ * free or with a price added to the item. A group with a minimum of 1 or
+ * more must be answered before the item can be added.
+ *
+ * Memoized on its own props like every section of this editor (AGL-3423):
+ * a keystroke elsewhere in the dialog does not redraw it.
+ */
+export declare const ProductRegisterFields: import("react").MemoExoticComponent<(props: ProductRegisterFieldsProps) => import("react").JSX.Element>;
+export {};

package/src/lib/components/console/product-register-fields.component.js

@@ -0,0 +1,241 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Button, FormControlLabel, IconButton, Stack, Switch, TextField, Typography } from "@mui/material";
+import { memo, useCallback } from "react";
+import * as CommerceModel from "../../model/index.js";
+function newId(prefix) {
+    return `${prefix}${Math.random().toString(36).slice(2, 10)}`;
+}
+/** Dollars as typed, to whole cents; blank is free. */ function centsFromDollars(value) {
+    const number = Math.round(Number(String(value).replace(/[^0-9.]/g, '')) * 100);
+    return Number.isFinite(number) && number > 0 ? number : 0;
+}
+/**
+ * The product's register settings (AGL-3607): whether it is a quick key on
+ * the register's first screen, and its modifier groups — choices such as
+ * "Milk" or "Add-ons" the cashier picks as the item is rung up, each choice
+ * free or with a price added to the item. A group with a minimum of 1 or
+ * more must be answered before the item can be added.
+ *
+ * Memoized on its own props like every section of this editor (AGL-3423):
+ * a keystroke elsewhere in the dialog does not redraw it.
+ */ export const ProductRegisterFields = /*#__PURE__*/ memo(function ProductRegisterFields(props) {
+    const { modifierGroups, update } = props;
+    const setGroups = useCallback((groups)=>update({
+            modifierGroups: groups
+        }), [
+        update
+    ]);
+    const editGroup = (index, patch)=>setGroups(modifierGroups.map((group, at)=>at === index ? _extends({}, group, patch) : group));
+    const editOption = (groupIndex, optionIndex, patch)=>{
+        const group = modifierGroups[groupIndex];
+        editGroup(groupIndex, {
+            options: group.options.map((option, at)=>at === optionIndex ? _extends({}, option, patch) : option)
+        });
+    };
+    const problem = CommerceModel.modifierGroupsProblem(modifierGroups);
+    return /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 2,
+        children: [
+            /*#__PURE__*/ _jsx(Typography, {
+                variant: "subtitle1",
+                component: "h3",
+                children: 'At the register'
+            }),
+            /*#__PURE__*/ _jsx(FormControlLabel, {
+                control: /*#__PURE__*/ _jsx(Switch, {
+                    checked: props.posQuickKey,
+                    onChange: (event)=>update({
+                            posQuickKey: event.target.checked
+                        })
+                }),
+                label: "Quick key at the register"
+            }),
+            /*#__PURE__*/ _jsx(Typography, {
+                variant: "body2",
+                color: "text.secondary",
+                children: 'Modifiers are choices added as the item is rung up, such as a milk or an extra shot. ' + 'Each can be free or add to the price.'
+            }),
+            modifierGroups.map((group, groupIndex)=>/*#__PURE__*/ _jsx(Box, {
+                    role: "group",
+                    "aria-label": group.name || 'Modifier group',
+                    sx: {
+                        border: 1,
+                        borderColor: 'divider',
+                        borderRadius: 1,
+                        p: 2
+                    },
+                    children: /*#__PURE__*/ _jsxs(Stack, {
+                        spacing: 1.5,
+                        children: [
+                            /*#__PURE__*/ _jsxs(Stack, {
+                                direction: "row",
+                                spacing: 1,
+                                sx: {
+                                    alignItems: 'flex-start'
+                                },
+                                children: [
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        label: "Group name",
+                                        size: "small",
+                                        value: group.name,
+                                        onChange: (event)=>editGroup(groupIndex, {
+                                                name: event.target.value
+                                            }),
+                                        sx: {
+                                            flex: 1
+                                        }
+                                    }),
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        label: "At least",
+                                        size: "small",
+                                        value: group.min,
+                                        onChange: (event)=>editGroup(groupIndex, {
+                                                min: Math.max(0, Math.round(Number(event.target.value) || 0))
+                                            }),
+                                        helperText: group.min > 0 ? 'Required' : 'Optional',
+                                        sx: {
+                                            width: 96
+                                        },
+                                        slotProps: {
+                                            htmlInput: {
+                                                inputMode: 'numeric'
+                                            }
+                                        }
+                                    }),
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        label: "At most",
+                                        size: "small",
+                                        value: group.max,
+                                        onChange: (event)=>editGroup(groupIndex, {
+                                                max: Math.max(1, Math.round(Number(event.target.value) || 1))
+                                            }),
+                                        sx: {
+                                            width: 96
+                                        },
+                                        slotProps: {
+                                            htmlInput: {
+                                                inputMode: 'numeric'
+                                            }
+                                        }
+                                    }),
+                                    /*#__PURE__*/ _jsx(Button, {
+                                        color: "error",
+                                        onClick: ()=>setGroups(modifierGroups.filter((_group, at)=>at !== groupIndex)),
+                                        children: 'Remove group'
+                                    })
+                                ]
+                            }),
+                            group.options.map((option, optionIndex)=>/*#__PURE__*/ _jsxs(Stack, {
+                                    direction: "row",
+                                    spacing: 1,
+                                    sx: {
+                                        alignItems: 'center'
+                                    },
+                                    children: [
+                                        /*#__PURE__*/ _jsx(TextField, {
+                                            label: "Choice",
+                                            size: "small",
+                                            value: option.name,
+                                            onChange: (event)=>editOption(groupIndex, optionIndex, {
+                                                    name: event.target.value
+                                                }),
+                                            sx: {
+                                                flex: 1
+                                            }
+                                        }),
+                                        /*#__PURE__*/ _jsx(TextField, {
+                                            label: "Adds ($)",
+                                            size: "small",
+                                            defaultValue: option.priceCents ? (option.priceCents / 100).toFixed(2) : '',
+                                            placeholder: "0.00",
+                                            onBlur: (event)=>editOption(groupIndex, optionIndex, {
+                                                    priceCents: centsFromDollars(event.target.value)
+                                                }),
+                                            sx: {
+                                                width: 120
+                                            },
+                                            slotProps: {
+                                                htmlInput: {
+                                                    inputMode: 'decimal'
+                                                }
+                                            }
+                                        }),
+                                        /*#__PURE__*/ _jsx(IconButton, {
+                                            "aria-label": `Remove ${option.name || 'choice'}`,
+                                            onClick: ()=>editGroup(groupIndex, {
+                                                    options: group.options.filter((_option, at)=>at !== optionIndex),
+                                                    max: Math.max(1, Math.min(group.max, group.options.length - 1))
+                                                }),
+                                            children: '✕'
+                                        })
+                                    ]
+                                }, option.id)),
+                            /*#__PURE__*/ _jsx(Box, {
+                                children: /*#__PURE__*/ _jsx(Button, {
+                                    onClick: ()=>editGroup(groupIndex, {
+                                            options: [
+                                                ...group.options,
+                                                {
+                                                    id: newId('o'),
+                                                    name: '',
+                                                    priceCents: 0
+                                                }
+                                            ]
+                                        }),
+                                    disabled: group.options.length >= CommerceModel.POS_MAX_MODIFIER_OPTIONS,
+                                    children: 'Add choice'
+                                })
+                            })
+                        ]
+                    })
+                }, group.id)),
+            /*#__PURE__*/ _jsx(Box, {
+                children: /*#__PURE__*/ _jsx(Button, {
+                    variant: "outlined",
+                    onClick: ()=>setGroups([
+                            ...modifierGroups,
+                            {
+                                id: newId('g'),
+                                name: '',
+                                min: 0,
+                                max: 1,
+                                options: [
+                                    {
+                                        id: newId('o'),
+                                        name: '',
+                                        priceCents: 0
+                                    }
+                                ]
+                            }
+                        ]),
+                    disabled: modifierGroups.length >= CommerceModel.POS_MAX_MODIFIER_GROUPS,
+                    children: 'Add modifier group'
+                })
+            }),
+            problem && modifierGroups.length ? /*#__PURE__*/ _jsx(Typography, {
+                variant: "body2",
+                color: "warning.main",
+                children: problem
+            }) : null
+        ]
+    });
+});
+
+//# sourceMappingURL=product-register-fields.component.js.map

package/src/lib/components/console/product-register-fields.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/product-register-fields.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 {\n  Box,\n  Button,\n  FormControlLabel,\n  IconButton,\n  Stack,\n  Switch,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport { memo, useCallback } from 'react'\nimport * as CommerceModel from '../../model'\n\ntype Patch = Partial<CommerceModel.HostProduct>\n\nexport interface ProductRegisterFieldsProps {\n  posQuickKey: boolean\n  modifierGroups: readonly CommerceModel.ProductModifierGroup[]\n  update: (patch: Patch) => void\n}\n\nfunction newId(prefix: string): string {\n  return `${prefix}${Math.random().toString(36).slice(2, 10)}`\n}\n\n/** Dollars as typed, to whole cents; blank is free. */\nfunction centsFromDollars(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 product's register settings (AGL-3607): whether it is a quick key on\n * the register's first screen, and its modifier groups — choices such as\n * \"Milk\" or \"Add-ons\" the cashier picks as the item is rung up, each choice\n * free or with a price added to the item. A group with a minimum of 1 or\n * more must be answered before the item can be added.\n *\n * Memoized on its own props like every section of this editor (AGL-3423):\n * a keystroke elsewhere in the dialog does not redraw it.\n */\nexport const ProductRegisterFields = memo(function ProductRegisterFields(\n  props: ProductRegisterFieldsProps,\n) {\n  const { modifierGroups, update } = props\n  const setGroups = useCallback(\n    (groups: CommerceModel.ProductModifierGroup[]) => update({ modifierGroups: groups }),\n    [update],\n  )\n  const editGroup = (index: number, patch: Partial<CommerceModel.ProductModifierGroup>) =>\n    setGroups(modifierGroups.map((group, at) => (at === index ? { ...group, ...patch } : group)))\n  const editOption = (\n    groupIndex: number,\n    optionIndex: number,\n    patch: Partial<CommerceModel.ProductModifierOption>,\n  ) => {\n    const group = modifierGroups[groupIndex]\n    editGroup(groupIndex, {\n      options: group.options.map((option, at) => (at === optionIndex ? { ...option, ...patch } : option)),\n    })\n  }\n  const problem = CommerceModel.modifierGroupsProblem(modifierGroups)\n\n  return (\n    <Stack spacing={2}>\n      <Typography variant=\"subtitle1\" component=\"h3\">\n        {'At the register'}\n      </Typography>\n      <FormControlLabel\n        control={\n          <Switch\n            checked={props.posQuickKey}\n            onChange={(event) => update({ posQuickKey: event.target.checked })}\n          />\n        }\n        label=\"Quick key at the register\"\n      />\n      <Typography variant=\"body2\" color=\"text.secondary\">\n        {'Modifiers are choices added as the item is rung up, such as a milk or an extra shot. ' +\n          'Each can be free or add to the price.'}\n      </Typography>\n      {modifierGroups.map((group, groupIndex) => (\n        <Box\n          key={group.id}\n          role=\"group\"\n          aria-label={group.name || 'Modifier group'}\n          sx={{ border: 1, borderColor: 'divider', borderRadius: 1, p: 2 }}\n        >\n          <Stack spacing={1.5}>\n            <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'flex-start' }}>\n              <TextField\n                label=\"Group name\"\n                size=\"small\"\n                value={group.name}\n                onChange={(event) => editGroup(groupIndex, { name: event.target.value })}\n                sx={{ flex: 1 }}\n              />\n              <TextField\n                label=\"At least\"\n                size=\"small\"\n                value={group.min}\n                onChange={(event) =>\n                  editGroup(groupIndex, { min: Math.max(0, Math.round(Number(event.target.value) || 0)) })\n                }\n                helperText={group.min > 0 ? 'Required' : 'Optional'}\n                sx={{ width: 96 }}\n                slotProps={{ htmlInput: { inputMode: 'numeric' } }}\n              />\n              <TextField\n                label=\"At most\"\n                size=\"small\"\n                value={group.max}\n                onChange={(event) =>\n                  editGroup(groupIndex, { max: Math.max(1, Math.round(Number(event.target.value) || 1)) })\n                }\n                sx={{ width: 96 }}\n                slotProps={{ htmlInput: { inputMode: 'numeric' } }}\n              />\n              <Button\n                color=\"error\"\n                onClick={() => setGroups(modifierGroups.filter((_group, at) => at !== groupIndex))}\n              >\n                {'Remove group'}\n              </Button>\n            </Stack>\n            {group.options.map((option, optionIndex) => (\n              <Stack key={option.id} direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n                <TextField\n                  label=\"Choice\"\n                  size=\"small\"\n                  value={option.name}\n                  onChange={(event) => editOption(groupIndex, optionIndex, { name: event.target.value })}\n                  sx={{ flex: 1 }}\n                />\n                <TextField\n                  label=\"Adds ($)\"\n                  size=\"small\"\n                  defaultValue={option.priceCents ? (option.priceCents / 100).toFixed(2) : ''}\n                  placeholder=\"0.00\"\n                  onBlur={(event) =>\n                    editOption(groupIndex, optionIndex, { priceCents: centsFromDollars(event.target.value) })\n                  }\n                  sx={{ width: 120 }}\n                  slotProps={{ htmlInput: { inputMode: 'decimal' } }}\n                />\n                <IconButton\n                  aria-label={`Remove ${option.name || 'choice'}`}\n                  onClick={() =>\n                    editGroup(groupIndex, {\n                      options: group.options.filter((_option, at) => at !== optionIndex),\n                      max: Math.max(1, Math.min(group.max, group.options.length - 1)),\n                    })\n                  }\n                >\n                  {'✕'}\n                </IconButton>\n              </Stack>\n            ))}\n            <Box>\n              <Button\n                onClick={() =>\n                  editGroup(groupIndex, {\n                    options: [...group.options, { id: newId('o'), name: '', priceCents: 0 }],\n                  })\n                }\n                disabled={group.options.length >= CommerceModel.POS_MAX_MODIFIER_OPTIONS}\n              >\n                {'Add choice'}\n              </Button>\n            </Box>\n          </Stack>\n        </Box>\n      ))}\n      <Box>\n        <Button\n          variant=\"outlined\"\n          onClick={() =>\n            setGroups([\n              ...modifierGroups,\n              {\n                id: newId('g'),\n                name: '',\n                min: 0,\n                max: 1,\n                options: [{ id: newId('o'), name: '', priceCents: 0 }],\n              },\n            ])\n          }\n          disabled={modifierGroups.length >= CommerceModel.POS_MAX_MODIFIER_GROUPS}\n        >\n          {'Add modifier group'}\n        </Button>\n      </Box>\n      {problem && modifierGroups.length ? (\n        <Typography variant=\"body2\" color=\"warning.main\">\n          {problem}\n        </Typography>\n      ) : null}\n    </Stack>\n  )\n})\n"],"names":["Box","Button","FormControlLabel","IconButton","Stack","Switch","TextField","Typography","memo","useCallback","CommerceModel","newId","prefix","Math","random","toString","slice","centsFromDollars","value","number","round","Number","String","replace","isFinite","ProductRegisterFields","props","modifierGroups","update","setGroups","groups","editGroup","index","patch","map","group","at","editOption","groupIndex","optionIndex","options","option","problem","modifierGroupsProblem","spacing","variant","component","control","checked","posQuickKey","onChange","event","target","label","color","role","aria-label","name","sx","border","borderColor","borderRadius","p","direction","alignItems","size","flex","min","max","helperText","width","slotProps","htmlInput","inputMode","onClick","filter","_group","defaultValue","priceCents","toFixed","placeholder","onBlur","_option","length","id","disabled","POS_MAX_MODIFIER_OPTIONS","POS_MAX_MODIFIER_GROUPS"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;;AAEA,SACEA,GAAG,EACHC,MAAM,EACNC,gBAAgB,EAChBC,UAAU,EACVC,KAAK,EACLC,MAAM,EACNC,SAAS,EACTC,UAAU,QACL,gBAAe;AACtB,SAASC,IAAI,EAAEC,WAAW,QAAQ,QAAO;AACzC,YAAYC,mBAAmB,uBAAa;AAU5C,SAASC,MAAMC,MAAc;IAC3B,OAAO,GAAGA,SAASC,KAAKC,MAAM,GAAGC,QAAQ,CAAC,IAAIC,KAAK,CAAC,GAAG,KAAK;AAC9D;AAEA,qDAAqD,GACrD,SAASC,iBAAiBC,KAAa;IACrC,MAAMC,SAASN,KAAKO,KAAK,CAACC,OAAOC,OAAOJ,OAAOK,OAAO,CAAC,YAAY,OAAO;IAC1E,OAAOF,OAAOG,QAAQ,CAACL,WAAWA,SAAS,IAAIA,SAAS;AAC1D;AAEA;;;;;;;;;CASC,GACD,OAAO,MAAMM,sCAAwBjB,KAAK,SAASiB,sBACjDC,KAAiC;IAEjC,MAAM,EAAEC,cAAc,EAAEC,MAAM,EAAE,GAAGF;IACnC,MAAMG,YAAYpB,YAChB,CAACqB,SAAiDF,OAAO;YAAED,gBAAgBG;QAAO,IAClF;QAACF;KAAO;IAEV,MAAMG,YAAY,CAACC,OAAeC,QAChCJ,UAAUF,eAAeO,GAAG,CAAC,CAACC,OAAOC,KAAQA,OAAOJ,QAAQ,aAAKG,OAAUF,SAAUE;IACvF,MAAME,aAAa,CACjBC,YACAC,aACAN;QAEA,MAAME,QAAQR,cAAc,CAACW,WAAW;QACxCP,UAAUO,YAAY;YACpBE,SAASL,MAAMK,OAAO,CAACN,GAAG,CAAC,CAACO,QAAQL,KAAQA,OAAOG,cAAc,aAAKE,QAAWR,SAAUQ;QAC7F;IACF;IACA,MAAMC,UAAUhC,cAAciC,qBAAqB,CAAChB;IAEpD,qBACE,MAACvB;QAAMwC,SAAS;;0BACd,KAACrC;gBAAWsC,SAAQ;gBAAYC,WAAU;0BACvC;;0BAEH,KAAC5C;gBACC6C,uBACE,KAAC1C;oBACC2C,SAAStB,MAAMuB,WAAW;oBAC1BC,UAAU,CAACC,QAAUvB,OAAO;4BAAEqB,aAAaE,MAAMC,MAAM,CAACJ,OAAO;wBAAC;;gBAGpEK,OAAM;;0BAER,KAAC9C;gBAAWsC,SAAQ;gBAAQS,OAAM;0BAC/B,0FACC;;YAEH3B,eAAeO,GAAG,CAAC,CAACC,OAAOG,2BAC1B,KAACtC;oBAECuD,MAAK;oBACLC,cAAYrB,MAAMsB,IAAI,IAAI;oBAC1BC,IAAI;wBAAEC,QAAQ;wBAAGC,aAAa;wBAAWC,cAAc;wBAAGC,GAAG;oBAAE;8BAE/D,cAAA,MAAC1D;wBAAMwC,SAAS;;0CACd,MAACxC;gCAAM2D,WAAU;gCAAMnB,SAAS;gCAAGc,IAAI;oCAAEM,YAAY;gCAAa;;kDAChE,KAAC1D;wCACC+C,OAAM;wCACNY,MAAK;wCACL/C,OAAOiB,MAAMsB,IAAI;wCACjBP,UAAU,CAACC,QAAUpB,UAAUO,YAAY;gDAAEmB,MAAMN,MAAMC,MAAM,CAAClC,KAAK;4CAAC;wCACtEwC,IAAI;4CAAEQ,MAAM;wCAAE;;kDAEhB,KAAC5D;wCACC+C,OAAM;wCACNY,MAAK;wCACL/C,OAAOiB,MAAMgC,GAAG;wCAChBjB,UAAU,CAACC,QACTpB,UAAUO,YAAY;gDAAE6B,KAAKtD,KAAKuD,GAAG,CAAC,GAAGvD,KAAKO,KAAK,CAACC,OAAO8B,MAAMC,MAAM,CAAClC,KAAK,KAAK;4CAAI;wCAExFmD,YAAYlC,MAAMgC,GAAG,GAAG,IAAI,aAAa;wCACzCT,IAAI;4CAAEY,OAAO;wCAAG;wCAChBC,WAAW;4CAAEC,WAAW;gDAAEC,WAAW;4CAAU;wCAAE;;kDAEnD,KAACnE;wCACC+C,OAAM;wCACNY,MAAK;wCACL/C,OAAOiB,MAAMiC,GAAG;wCAChBlB,UAAU,CAACC,QACTpB,UAAUO,YAAY;gDAAE8B,KAAKvD,KAAKuD,GAAG,CAAC,GAAGvD,KAAKO,KAAK,CAACC,OAAO8B,MAAMC,MAAM,CAAClC,KAAK,KAAK;4CAAI;wCAExFwC,IAAI;4CAAEY,OAAO;wCAAG;wCAChBC,WAAW;4CAAEC,WAAW;gDAAEC,WAAW;4CAAU;wCAAE;;kDAEnD,KAACxE;wCACCqD,OAAM;wCACNoB,SAAS,IAAM7C,UAAUF,eAAegD,MAAM,CAAC,CAACC,QAAQxC,KAAOA,OAAOE;kDAErE;;;;4BAGJH,MAAMK,OAAO,CAACN,GAAG,CAAC,CAACO,QAAQF,4BAC1B,MAACnC;oCAAsB2D,WAAU;oCAAMnB,SAAS;oCAAGc,IAAI;wCAAEM,YAAY;oCAAS;;sDAC5E,KAAC1D;4CACC+C,OAAM;4CACNY,MAAK;4CACL/C,OAAOuB,OAAOgB,IAAI;4CAClBP,UAAU,CAACC,QAAUd,WAAWC,YAAYC,aAAa;oDAAEkB,MAAMN,MAAMC,MAAM,CAAClC,KAAK;gDAAC;4CACpFwC,IAAI;gDAAEQ,MAAM;4CAAE;;sDAEhB,KAAC5D;4CACC+C,OAAM;4CACNY,MAAK;4CACLY,cAAcpC,OAAOqC,UAAU,GAAG,AAACrC,CAAAA,OAAOqC,UAAU,GAAG,GAAE,EAAGC,OAAO,CAAC,KAAK;4CACzEC,aAAY;4CACZC,QAAQ,CAAC9B,QACPd,WAAWC,YAAYC,aAAa;oDAAEuC,YAAY7D,iBAAiBkC,MAAMC,MAAM,CAAClC,KAAK;gDAAE;4CAEzFwC,IAAI;gDAAEY,OAAO;4CAAI;4CACjBC,WAAW;gDAAEC,WAAW;oDAAEC,WAAW;gDAAU;4CAAE;;sDAEnD,KAACtE;4CACCqD,cAAY,CAAC,OAAO,EAAEf,OAAOgB,IAAI,IAAI,UAAU;4CAC/CiB,SAAS,IACP3C,UAAUO,YAAY;oDACpBE,SAASL,MAAMK,OAAO,CAACmC,MAAM,CAAC,CAACO,SAAS9C,KAAOA,OAAOG;oDACtD6B,KAAKvD,KAAKuD,GAAG,CAAC,GAAGvD,KAAKsD,GAAG,CAAChC,MAAMiC,GAAG,EAAEjC,MAAMK,OAAO,CAAC2C,MAAM,GAAG;gDAC9D;sDAGD;;;mCA5BO1C,OAAO2C,EAAE;0CAgCvB,KAACpF;0CACC,cAAA,KAACC;oCACCyE,SAAS,IACP3C,UAAUO,YAAY;4CACpBE,SAAS;mDAAIL,MAAMK,OAAO;gDAAE;oDAAE4C,IAAIzE,MAAM;oDAAM8C,MAAM;oDAAIqB,YAAY;gDAAE;6CAAE;wCAC1E;oCAEFO,UAAUlD,MAAMK,OAAO,CAAC2C,MAAM,IAAIzE,cAAc4E,wBAAwB;8CAEvE;;;;;mBApFFnD,MAAMiD,EAAE;0BA0FjB,KAACpF;0BACC,cAAA,KAACC;oBACC4C,SAAQ;oBACR6B,SAAS,IACP7C,UAAU;+BACLF;4BACH;gCACEyD,IAAIzE,MAAM;gCACV8C,MAAM;gCACNU,KAAK;gCACLC,KAAK;gCACL5B,SAAS;oCAAC;wCAAE4C,IAAIzE,MAAM;wCAAM8C,MAAM;wCAAIqB,YAAY;oCAAE;iCAAE;4BACxD;yBACD;oBAEHO,UAAU1D,eAAewD,MAAM,IAAIzE,cAAc6E,uBAAuB;8BAEvE;;;YAGJ7C,WAAWf,eAAewD,MAAM,iBAC/B,KAAC5E;gBAAWsC,SAAQ;gBAAQS,OAAM;0BAC/BZ;iBAED;;;AAGV,GAAE"}

package/src/lib/components/console/product-zones.d.ts

@@ -46,6 +46,28 @@ export interface ConsoleProductDraft {
     mediaUrls: string[];
     seoTitle: string;
     seoDescription: string;
+    /**
+     * What one unit ships as (AGL-3612): packed size and customs facts, as the
+     * editor holds them. A side nobody set is `null`.
+     */
+    shipping: {
+        lengthCm: number | null;
+        widthCm: number | null;
+        heightCm: number | null;
+        hsCode: string;
+        originCountry: string;
+    };
+    /**
+     * What shopping channels ask of it (AGL-3637), as the editor holds it. A
+     * field nobody entered is `''`.
+     */
+    channel: {
+        brand: string;
+        gtin: string;
+        mpn: string;
+        condition: '' | 'new' | 'refurbished' | 'used';
+        googleProductCategory: string;
+    };
 }
 /**
  * Copy a widget proposes for one product. A field left out is left alone;
@@ -59,6 +81,28 @@ export interface ConsoleProductCopyValues {
     optionNames?: string[];
     seoTitle?: string;
     seoDescription?: string;
+    /**
+     * Packed size and customs facts (AGL-3612), merged over the product's; a
+     * side set to `null` is cleared.
+     */
+    shipping?: Partial<{
+        lengthCm: number | null;
+        widthCm: number | null;
+        heightCm: number | null;
+        hsCode: string;
+        originCountry: string;
+    }>;
+    /**
+     * Shopping-channel facts (AGL-3637), merged over the product's; a field
+     * set to `''` is cleared.
+     */
+    channel?: Partial<{
+        brand: string;
+        gtin: string;
+        mpn: string;
+        condition: '' | 'new' | 'refurbished' | 'used';
+        googleProductCategory: string;
+    }>;
 }
 /**
  * What the `productEditor` zone hands each widget: the product as the editor
@@ -175,11 +219,23 @@ export declare const PRODUCT_EDITOR_ZONE: import("@aglyn/aglyn/plugin-manager/pl
 export declare const PRODUCTS_HUB_ZONE: import("@aglyn/aglyn/plugin-manager/plugin-zones").PluginZone<ConsoleProductsHubZoneProps>;
 export declare const PRODUCT_IMPORT_ZONE: import("@aglyn/aglyn/plugin-manager/plugin-zones").PluginZone<ConsoleProductImportZoneProps>;
 /**
- * Declares the three zones, from the console registrar. The ids are the ones
+ * What the `productsCreate` zone hands each widget (AGL-3596): the site and
+ * its org. The zone sits beside Add product on the Products page and in the
+ * empty catalog: another way to start a product. A widget here writes nothing
+ * through the page — anything it proposes is applied through `productsHub`.
+ */
+export interface ConsoleProductsCreateZoneProps {
+    hostId: string;
+    /** The org the page names; `undefined` where the host does not know it. */
+    orgId: string | undefined;
+}
+export declare const PRODUCTS_CREATE_ZONE: import("@aglyn/aglyn/plugin-manager/plugin-zones").PluginZone<ConsoleProductsCreateZoneProps>;
+/**
+ * Declares the four zones, from the console registrar. The ids are the ones
  * widgets have always registered under, so a widget written for them keeps
  * working. Each is `bare`: the section is one item of a layout this plugin
  * draws — among the editor's fields, above the catalog table, in the import
- * wizard's After import step — and a wrapper would add a gap the page
+ * wizard's After import step, in the row beside Add product — and a wrapper would add a gap the page
  * already spaces.
  */
 export declare function registerCommerceZones(): void;

package/src/lib/components/console/product-zones.js

@@ -18,12 +18,13 @@ import { BUNDLE_ID } from "../../constants/bundle-common.js";
 export const PRODUCT_EDITOR_ZONE = definePluginZone('productEditor');
 export const PRODUCTS_HUB_ZONE = definePluginZone('productsHub');
 export const PRODUCT_IMPORT_ZONE = definePluginZone('productImport');
+export const PRODUCTS_CREATE_ZONE = definePluginZone('productsCreate');
 /**
- * Declares the three zones, from the console registrar. The ids are the ones
+ * Declares the four zones, from the console registrar. The ids are the ones
  * widgets have always registered under, so a widget written for them keeps
  * working. Each is `bare`: the section is one item of a layout this plugin
  * draws — among the editor's fields, above the catalog table, in the import
- * wizard's After import step — and a wrapper would add a gap the page
+ * wizard's After import step, in the row beside Add product — and a wrapper would add a gap the page
  * already spaces.
  */ export function registerCommerceZones() {
     const owner = {
@@ -43,6 +44,13 @@ export const PRODUCT_IMPORT_ZONE = definePluginZone('productImport');
         layout: 'bare',
         description: 'Above the catalog table on the Products page. A widget here proposes copy, draft products, categories and switched-off discounts, and asks the hub to write them; every write is the hub’s, with its allowance and slug checks.'
     }, owner);
+    registerPluginZone({
+        zone: PRODUCTS_CREATE_ZONE,
+        label: 'Start a product',
+        surface: 'console',
+        layout: 'bare',
+        description: 'Beside Add product on the Products page, and in the empty catalog: another way to start a product. A widget here is handed the site and its org and writes nothing through the page.'
+    }, owner);
     registerPluginZone({
         zone: PRODUCT_IMPORT_ZONE,
         label: 'Product import',