@spree/dashboard-core 1.0.0-rc.4 → 1.0.0-rc.6

package/src/locales/pl.json

@@ -1,5 +1,8 @@
 {
   "admin": {
+    "address_select": {
+      "none": "Nie wybrano adresu"
+    },
     "app_name": "Spree Admin",
     "a11y": {
       "breadcrumb": "Ścieżka nawigacji",
@@ -97,6 +100,7 @@
     "address_book": {
       "default_billing": "Domyślny rozliczeniowy",
       "default_shipping": "Domyślny wysyłkowy",
+      "inherited_from": "Dziedziczony z: {{name}}",
       "set_default_billing": "Ustaw jako domyślny adres rozliczeniowy",
       "set_default_shipping": "Ustaw jako domyślny adres wysyłkowy"
     },
@@ -113,6 +117,7 @@
         "title": "Zresetuj hasło"
       },
       "login": {
+        "account_deactivated": "To konto zostało dezaktywowane. Skontaktuj się z administratorem, aby przywrócić dostęp.",
         "account_not_provisioned": "To konto nie ma dostępu do tego sklepu. Poproś administratora o zaproszenie.",
         "divider": "lub",
         "invalid_oauth_state": "Ta sesja logowania wygasła lub była nieprawidłowa. Zaloguj się ponownie.",
@@ -484,6 +489,12 @@
         "discard_title": "Odrzucić szkic?"
       }
     },
+    "currency_amounts": {
+      "amount_in_currency": "Kwota w {{currency}}",
+      "help": "Waluty bez kwoty nie mają oferowanej tej metody dostawy.",
+      "label": "Kwota",
+      "required": "Podaj kwotę w co najmniej jednej walucie."
+    },
     "custom_field_definitions": {
       "errors": {
         "failed_to_create": "Nie udało się utworzyć definicji pola niestandardowego",
@@ -938,6 +949,14 @@
       "order_multiple": {
         "label": "Wielokrotność zamówienia",
         "help": "Każdy kolejny krok powyżej minimum. Pozostaw puste, aby dopuścić dowolną ilość."
+      },
+      "store": {
+        "digital_asset_authorized_clicks": {
+          "label": "Dozwolone pobrania"
+        },
+        "digital_asset_authorized_days": {
+          "label": "Dostępne dni"
+        }
       }
     },
     "image_upload": {
@@ -2063,6 +2082,38 @@
           "description": "Sprzedawca musi podać adres do zwrotów"
         }
       }
+    },
+    "digital_assets": {
+      "add": "Dodaj",
+      "all_variants": "Wszystkie warianty",
+      "columns": {
+        "file": "Plik",
+        "variant": "Wariant",
+        "size": "Rozmiar",
+        "downloads": "Pobrania",
+        "days": "Dni"
+      },
+      "delete_description": "„{{name}}” nie będzie już dostępny do pobrania dla osób, które go kupiły. Zmiana działa natychmiast.",
+      "delete_title": "Usunąć ten plik?",
+      "description": "Pliki, które kupujący mogą pobrać po zakupie. Dołącz je do produktu cyfrowego lub do fizycznego, aby dostarczyć instrukcję albo gwarancję.",
+      "download": "Pobierz",
+      "drop_hint": "Przeciągnij i upuść pliki tutaj lub kliknij, aby wybrać",
+      "empty": "Brak plików",
+      "limit_invalid": "Limity muszą być liczbami całkowitymi od 1 lub puste.",
+      "limits_help": "Pozostaw limity pobrań i dni puste, aby użyć ustawień sklepu.",
+      "source": {
+        "upload": "Prześlij plik"
+      },
+      "store_default": "{{count}} (domyślne sklepu)",
+      "title": "Pliki cyfrowe",
+      "untitled": "Plik bez nazwy",
+      "upload": "Dodaj plik",
+      "upload_failed": "Nie udało się przesłać {{name}}: {{message}}",
+      "uploading": "Przesyłanie {{name}}…",
+      "uploading_short": "Przesyłanie…",
+      "replace": "Zastąp plik",
+      "replace_description": "„{{name}}” zostanie usunięty, a wszyscy kupujący pobiorą nowy plik ze swoich dotychczasowych linków. Obowiązuje natychmiast.",
+      "replace_title": "Zastąpić ten plik?"
     }
   }
 }

package/src/locales/zh-CN.json

@@ -1,5 +1,8 @@
 {
   "admin": {
+    "address_select": {
+      "none": "未选择地址"
+    },
     "app_name": "Spree Admin",
     "a11y": {
       "breadcrumb": "面包屑导航",
@@ -97,6 +100,7 @@
     "address_book": {
       "default_billing": "默认账单",
       "default_shipping": "默认收货",
+      "inherited_from": "继承自 {{name}}",
       "set_default_billing": "设为默认账单地址",
       "set_default_shipping": "设为默认收货地址"
     },
@@ -113,6 +117,7 @@
         "title": "重置密码"
       },
       "login": {
+        "account_deactivated": "此账户已被停用。请联系管理员恢复访问权限。",
         "account_not_provisioned": "此账户无权访问该店铺。请向管理员申请邀请。",
         "divider": "或",
         "invalid_oauth_state": "登录会话已过期或无效。请重新登录。",
@@ -483,6 +488,12 @@
         "discard_title": "放弃此草稿？"
       }
     },
+    "currency_amounts": {
+      "amount_in_currency": "{{currency}} 金额",
+      "help": "未填写金额的币种将不会提供该配送方式。",
+      "label": "金额",
+      "required": "请至少为一种货币输入金额。"
+    },
     "custom_field_definitions": {
       "errors": {
         "failed_to_create": "创建自定义字段定义失败",
@@ -937,6 +948,14 @@
       "order_multiple": {
         "label": "订购倍数",
         "help": "在最小起订量之上的每一档增量。留空表示不限数量。"
+      },
+      "store": {
+        "digital_asset_authorized_clicks": {
+          "label": "允许的下载次数"
+        },
+        "digital_asset_authorized_days": {
+          "label": "可用天数"
+        }
       }
     },
     "image_upload": {
@@ -2033,6 +2052,38 @@
           "description": "卖家必须提供退货地址"
         }
       }
+    },
+    "digital_assets": {
+      "add": "添加",
+      "all_variants": "所有变体",
+      "columns": {
+        "file": "文件",
+        "variant": "变体",
+        "size": "大小",
+        "downloads": "下载次数",
+        "days": "天数"
+      },
+      "delete_description": "购买过“{{name}}”的人将无法再下载它。此操作立即生效。",
+      "delete_title": "删除此文件？",
+      "description": "买家购买后可下载的文件。可附加到数字商品，也可附加到实体商品以随货提供说明书或保修卡。",
+      "download": "下载",
+      "drop_hint": "将文件拖放到此处，或点击浏览",
+      "empty": "暂无文件",
+      "limit_invalid": "限制必须是不小于 1 的整数，或留空。",
+      "limits_help": "将下载次数和天数限制留空即可使用商店设置。",
+      "source": {
+        "upload": "上传文件"
+      },
+      "store_default": "{{count}}（商店默认）",
+      "title": "数字文件",
+      "untitled": "未命名文件",
+      "upload": "添加文件",
+      "upload_failed": "上传 {{name}} 失败：{{message}}",
+      "uploading": "正在上传 {{name}}…",
+      "uploading_short": "上传中…",
+      "replace": "替换文件",
+      "replace_description": "“{{name}}”将被移除，所有买家将通过现有链接下载新文件。立即生效。",
+      "replace_title": "替换此文件？"
     }
   }
 }

package/src/pages/package-types.tsx

@@ -1,4 +1,5 @@
 import { zodResolver } from '@hookform/resolvers/zod'
+import { DimensionUnit, WeightUnit } from '@spree/core'
 import {
   Button,
   Field,
@@ -32,6 +33,7 @@ import { z } from 'zod/v4'
 import type { PanelPackageType } from '../api-client'
 import { Can } from '../components/can'
 import { ResourceTable, resourceSearchSchema } from '../components/resource-table'
+import { HostFormSlot } from '../components/slot'
 import {
   canDeletePackageTypes,
   canWritePackageTypes,
@@ -42,13 +44,12 @@ import {
   useUpdatePackageType,
 } from '../hooks/use-package-types'
 import { mapSpreeErrorsToForm } from '../lib/form-errors'
+import { extensionFormValues, extensionSubmitValues } from '../lib/form-fields-registry'
 import { Subject } from '../lib/permissions'
 import { usePermissions } from '../providers/permission-provider'
 import {
-  PACKAGE_DIMENSION_UNITS,
   PACKAGE_TYPE_DEFAULTS,
   PACKAGE_TYPE_KINDS,
-  PACKAGE_WEIGHT_UNITS,
   type PackageTypeFormValues,
   packageTypeFormSchema,
   packageTypeFormValuesToParams,
@@ -89,7 +90,14 @@ export type PackageTypesSearch = z.infer<typeof packageTypesSearchSchema>
  */
 function noop() {}
 
-export function PackageTypesPage({ search }: { search: PackageTypesSearch }) {
+export function PackageTypesPage({
+  search,
+  formKey = 'package_type',
+}: {
+  search: PackageTypesSearch
+  /** Names the sheets' slot and extension fields — `seller.package_type` in the seller panel. */
+  formKey?: string
+}) {
   const { t } = useTranslation()
   const navigate = useNavigate()
   const confirm = useConfirm()
@@ -194,16 +202,27 @@ export function PackageTypesPage({ search }: { search: PackageTypesSearch }) {
         }
       />
 
-      {isCreating && <CreatePackageTypeSheet open onOpenChange={(o) => !o && closeSheet()} />}
-      {editId && <EditPackageTypeSheet id={editId} open onOpenChange={(o) => !o && closeSheet()} />}
+      {isCreating && (
+        <CreatePackageTypeSheet formKey={formKey} open onOpenChange={(o) => !o && closeSheet()} />
+      )}
+      {editId && (
+        <EditPackageTypeSheet
+          id={editId}
+          formKey={formKey}
+          open
+          onOpenChange={(o) => !o && closeSheet()}
+        />
+      )}
     </>
   )
 }
 
 function CreatePackageTypeSheet({
+  formKey,
   open,
   onOpenChange,
 }: {
+  formKey: string
   open: boolean
   onOpenChange: (open: boolean) => void
 }) {
@@ -211,12 +230,15 @@ function CreatePackageTypeSheet({
   const createMutation = useCreatePackageType()
   const form = useForm<PackageTypeFormValues>({
     resolver: zodResolver(packageTypeFormSchema),
-    defaultValues: PACKAGE_TYPE_DEFAULTS,
+    defaultValues: { ...PACKAGE_TYPE_DEFAULTS, ...extensionFormValues(formKey, null) },
   })
 
   async function onSubmit(values: PackageTypeFormValues) {
     try {
-      await createMutation.mutateAsync(packageTypeFormValuesToParams(values))
+      await createMutation.mutateAsync({
+        ...packageTypeFormValuesToParams(values),
+        ...extensionSubmitValues(formKey, form),
+      })
       form.reset(PACKAGE_TYPE_DEFAULTS)
       onOpenChange(false)
     } catch (err) {
@@ -240,6 +262,11 @@ function CreatePackageTypeSheet({
         <form onSubmit={form.handleSubmit(onSubmit)} className="flex min-h-0 flex-1 flex-col">
           <div className="flex flex-1 flex-col gap-4 overflow-y-auto p-4">
             <PackageTypeFormFields form={form} />
+            <HostFormSlot
+              form={form}
+              name={`${formKey}.form_fields`}
+              context={{ packageType: undefined, mode: 'new' }}
+            />
           </div>
           <SheetFooter>
             <Button type="submit" disabled={createMutation.isPending}>
@@ -254,10 +281,12 @@ function CreatePackageTypeSheet({
 
 function EditPackageTypeSheet({
   id,
+  formKey,
   open,
   onOpenChange,
 }: {
   id: string
+  formKey: string
   open: boolean
   onOpenChange: (open: boolean) => void
 }) {
@@ -271,12 +300,17 @@ function EditPackageTypeSheet({
   const form = useForm<PackageTypeFormValues>({
     resolver: zodResolver(packageTypeFormSchema),
     defaultValues: PACKAGE_TYPE_DEFAULTS,
-    values: packageType ? packageTypeToFormValues(packageType) : undefined,
+    values: packageType
+      ? { ...packageTypeToFormValues(packageType), ...extensionFormValues(formKey, packageType) }
+      : undefined,
   })
 
   async function onSubmit(values: PackageTypeFormValues) {
     try {
-      await updateMutation.mutateAsync(packageTypeFormValuesToParams(values))
+      await updateMutation.mutateAsync({
+        ...packageTypeFormValuesToParams(values),
+        ...extensionSubmitValues(formKey, form),
+      })
       onOpenChange(false)
     } catch (err) {
       if (!mapSpreeErrorsToForm(err, form.setError)) throw err
@@ -299,6 +333,11 @@ function EditPackageTypeSheet({
         <form onSubmit={form.handleSubmit(onSubmit)} className="flex min-h-0 flex-1 flex-col">
           <div className="flex flex-1 flex-col gap-4 overflow-y-auto p-4">
             <PackageTypeFormFields form={form} />
+            <HostFormSlot
+              form={form}
+              name={`${formKey}.form_fields`}
+              context={{ packageType, mode: 'edit' }}
+            />
           </div>
           <SheetFooter>
             <Button type="submit" disabled={updateMutation.isPending}>
@@ -376,7 +415,7 @@ function PackageTypeFormFields({ form }: { form: UseFormReturn<PackageTypeFormVa
         <UnitField
           form={form}
           name="dimensions_unit"
-          units={PACKAGE_DIMENSION_UNITS}
+          units={Object.values(DimensionUnit)}
           label={t('admin.fields.package_type.dimensions_unit.label')}
         />
       </div>
@@ -416,7 +455,7 @@ function PackageTypeFormFields({ form }: { form: UseFormReturn<PackageTypeFormVa
         <UnitField
           form={form}
           name="weight_unit"
-          units={PACKAGE_WEIGHT_UNITS}
+          units={Object.values(WeightUnit)}
           label={t('admin.fields.package_type.weight_unit.label')}
         />
       </div>

package/src/pages/settings-index.tsx

@@ -103,7 +103,10 @@ function SettingsCard({ entry, tenantId }: { entry: SettingsNavEntry; tenantId:
       >
         <Icon className="mt-0.5 size-6 shrink-0 text-muted-foreground opacity-80 hover:opacity-100" />
         <span className="flex min-w-0 flex-col gap-1">
-          <span className="text-sm font-medium leading-none">{label}</span>
+          <span className="flex items-center gap-1.5 text-sm font-medium leading-none">
+            {label}
+            {entry.badge && <entry.badge />}
+          </span>
           {description && <span className="text-sm text-muted-foreground">{description}</span>}
         </span>
       </Link>

package/src/pages/stock-locations.tsx

@@ -34,6 +34,7 @@ import { Can } from '../components/can'
 import { CountryCombobox } from '../components/country-combobox'
 import { StateCombobox, useCountryStates } from '../components/country-state-fields'
 import { ResourceTable, resourceSearchSchema } from '../components/resource-table'
+import { HostFormSlot } from '../components/slot'
 import {
   canDeleteStockLocations,
   listStockLocations,
@@ -43,6 +44,7 @@ import {
   useUpdateStockLocation,
 } from '../hooks/use-stock-locations'
 import { mapSpreeErrorsToForm } from '../lib/form-errors'
+import { extensionFormValues, extensionSubmitValues } from '../lib/form-fields-registry'
 import { Subject } from '../lib/permissions'
 import { usePermissions } from '../providers/permission-provider'
 import {
@@ -90,8 +92,11 @@ export function StockLocationsPage({
   search,
   stockLevelsPanel: StockLevelsPanel,
   activityPanel: ActivityPanel,
+  formKey = 'stock_location',
 }: {
   search: StockLocationsSearch
+  /** Names the sheets' slot and extension fields — `seller.stock_location` in the seller panel. */
+  formKey?: string
   /** Rendered inside the edit sheet, below the form. Optional — see above. */
   stockLevelsPanel?: ComponentType<{ stockLocationId: string }>
   /** What changed in this warehouse, for reconciliation. Optional. */
@@ -170,10 +175,13 @@ export function StockLocationsPage({
         }
       />
 
-      {isCreating && <CreateStockLocationSheet open onOpenChange={(o) => !o && closeSheet()} />}
+      {isCreating && (
+        <CreateStockLocationSheet formKey={formKey} open onOpenChange={(o) => !o && closeSheet()} />
+      )}
       {editId && (
         <EditStockLocationSheet
           id={editId}
+          formKey={formKey}
           open
           onOpenChange={(o) => !o && closeSheet()}
           stockLevelsPanel={StockLevelsPanel}
@@ -189,9 +197,11 @@ export function StockLocationsPage({
 // ============================================================================
 
 function CreateStockLocationSheet({
+  formKey,
   open,
   onOpenChange,
 }: {
+  formKey: string
   open: boolean
   onOpenChange: (open: boolean) => void
 }) {
@@ -201,13 +211,13 @@ function CreateStockLocationSheet({
   const form = useForm<StockLocationFormValues>({
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     resolver: zodResolver(stockLocationFormSchema) as any,
-    defaultValues: STOCK_LOCATION_DEFAULTS,
+    defaultValues: { ...STOCK_LOCATION_DEFAULTS, ...extensionFormValues(formKey, null) },
   })
 
   async function onSubmit(values: StockLocationFormValues) {
     try {
       const params = formValuesToParams(values)
-      await createMutation.mutateAsync(params)
+      await createMutation.mutateAsync({ ...params, ...extensionSubmitValues(formKey, form) })
       form.reset(STOCK_LOCATION_DEFAULTS)
       onOpenChange(false)
     } catch (err) {
@@ -231,6 +241,11 @@ function CreateStockLocationSheet({
         <form onSubmit={form.handleSubmit(onSubmit)} className="flex min-h-0 flex-1 flex-col">
           <div className="flex flex-1 flex-col gap-4 overflow-y-auto p-4">
             <StockLocationFormFields form={form} />
+            <HostFormSlot
+              form={form}
+              name={`${formKey}.form_fields`}
+              context={{ stockLocation: undefined, mode: 'new' }}
+            />
           </div>
           <SheetFooter>
             <Button
@@ -259,12 +274,14 @@ function CreateStockLocationSheet({
 
 function EditStockLocationSheet({
   id,
+  formKey,
   open,
   onOpenChange,
   stockLevelsPanel: StockLevelsPanel,
   activityPanel: ActivityPanel,
 }: {
   id: string
+  formKey: string
   open: boolean
   onOpenChange: (open: boolean) => void
   stockLevelsPanel?: ComponentType<{ stockLocationId: string }>
@@ -284,14 +301,17 @@ function EditStockLocationSheet({
   // with whatever the server last persisted (including external edits).
   useEffect(() => {
     if (stockLocation) {
-      form.reset(stockLocationToFormValues(stockLocation))
+      form.reset({
+        ...stockLocationToFormValues(stockLocation),
+        ...extensionFormValues(formKey, stockLocation),
+      })
     }
-  }, [stockLocation, form])
+  }, [stockLocation, form, formKey])
 
   async function onSubmit(values: StockLocationFormValues) {
     try {
       const params = formValuesToParams(values)
-      await updateMutation.mutateAsync(params)
+      await updateMutation.mutateAsync({ ...params, ...extensionSubmitValues(formKey, form) })
       form.reset(values)
       onOpenChange(false)
     } catch (err) {
@@ -314,6 +334,11 @@ function EditStockLocationSheet({
           <form onSubmit={form.handleSubmit(onSubmit)} className="flex min-h-0 flex-1 flex-col">
             <div className="flex flex-1 flex-col gap-4 overflow-y-auto p-4">
               <StockLocationFormFields form={form} />
+              <HostFormSlot
+                form={form}
+                name={`${formKey}.form_fields`}
+                context={{ stockLocation, mode: 'edit' }}
+              />
               {StockLevelsPanel && <StockLevelsPanel stockLocationId={id} />}
               {ActivityPanel && <ActivityPanel stockLocationId={id} />}
             </div>

package/src/products/assignable-variants.ts

@@ -0,0 +1,35 @@
+import { i18n, type ProductFormValues } from '@spree/dashboard-core'
+import { type Control, useWatch } from 'react-hook-form'
+
+interface LabelledVariant {
+  id: string
+  options_text?: string | null
+  sku?: string | null
+  name?: string | null
+}
+
+/** The name a variant goes by in a picker. */
+export function variantLabel(variant: LabelledVariant): string {
+  return (
+    variant.options_text ||
+    variant.name ||
+    variant.sku ||
+    variant.id ||
+    i18n.t('admin.products.variants.variant_label')
+  )
+}
+
+/**
+ * The saved variants a file can be linked to. A card that links files saves
+ * at once, so it must not offer a variant the merchant removed in the form but
+ * has not saved yet: saving would delete that variant and its files with it.
+ * Variants added but not saved have no id to link to.
+ */
+export function useAssignableVariants<V extends { id: string }>(
+  control: Control<ProductFormValues>,
+  variants: V[] | undefined,
+): V[] {
+  const liveVariants = useWatch({ control, name: 'variants' })
+  const liveVariantIds = new Set((liveVariants ?? []).map((variant) => variant.id).filter(Boolean))
+  return (variants ?? []).filter((variant) => liveVariantIds.has(variant.id))
+}

package/src/products/bulk-variants-dialog.tsx

@@ -1,3 +1,4 @@
+import { DimensionUnit, normalizeMoneyInput, WeightUnit } from '@spree/core'
 import type { ProductFormValues, VariantFormValues } from '@spree/dashboard-core'
 import { useCountries, useCountryDisplayName } from '@spree/dashboard-core'
 import {
@@ -23,9 +24,6 @@ import {
 } from './use-product-form-data'
 import { composeOptionsText } from './variants-matrix'
 
-const WEIGHT_UNITS = ['g', 'kg', 'lb', 'oz'] as const
-const DIMENSION_UNITS = ['mm', 'cm', 'in'] as const
-
 interface Props {
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   form: UseFormReturn<ProductFormValues, any, any>
@@ -171,39 +169,24 @@ export function BulkVariantsDialog({ form, open, onOpenChange }: Props) {
           set(`variants.${idx}.cartons_per_pallet`, change.value)
           break
         case 'cartonWeight': {
-          if (change.value == null || change.value.trim() === '') {
-            set(`variants.${idx}.carton_weight`, null)
-            break
-          }
-          const parsed = Number(change.value.trim().replace(',', '.'))
-          if (!Number.isFinite(parsed) || parsed < 0) break
-          set(`variants.${idx}.carton_weight`, parsed)
+          const parsed = readMeasure(change.value)
+          if (parsed !== undefined) set(`variants.${idx}.carton_weight`, parsed)
           break
         }
         case 'preorderable':
           set(`variants.${idx}.preorderable`, change.value)
           break
         case 'backorderLimit': {
-          if (change.value == null || change.value.trim() === '') {
-            set(`variants.${idx}.backorder_limit`, null)
-            break
+          const parsed = readMeasure(change.value)
+          if (parsed !== undefined) {
+            set(`variants.${idx}.backorder_limit`, parsed === null ? null : Math.trunc(parsed))
           }
-          const parsed = Number(change.value.trim().replace(',', '.'))
-          if (!Number.isFinite(parsed) || parsed < 0) break
-          set(`variants.${idx}.backorder_limit`, Math.trunc(parsed))
           break
         }
         default: {
-          // weight / height / width / depth — decimals. Accept a comma
-          // decimal (the cell ships raw input); ignore anything that doesn't
-          // parse to a non-negative number rather than mangling it.
-          if (change.value == null || change.value.trim() === '') {
-            set(`variants.${idx}.${change.field}`, null)
-            break
-          }
-          const parsed = Number(change.value.trim().replace(',', '.'))
-          if (!Number.isFinite(parsed) || parsed < 0) break
-          set(`variants.${idx}.${change.field}`, parsed)
+          // weight / height / width / depth
+          const parsed = readMeasure(change.value)
+          if (parsed !== undefined) set(`variants.${idx}.${change.field}`, parsed)
           break
         }
       }
@@ -242,8 +225,8 @@ export function BulkVariantsDialog({ form, open, onOpenChange }: Props) {
           <BulkVariantsTable
             rows={rows}
             onChange={handleChange}
-            weightUnitOptions={unitOptions(WEIGHT_UNITS)}
-            dimensionUnitOptions={unitOptions(DIMENSION_UNITS)}
+            weightUnitOptions={unitOptions(Object.values(WeightUnit))}
+            dimensionUnitOptions={unitOptions(Object.values(DimensionUnit))}
             taxCategoryOptions={
               taxCategories.length > 0
                 ? taxCategories.map((c) => ({ value: c.id, label: c.name }))
@@ -293,3 +276,19 @@ export function BulkVariantsDialog({ form, open, onOpenChange }: Props) {
     </Dialog>
   )
 }
+
+// Cells show numbers with a period, so they read back the same way, with
+// comma grouping (`1,500`) or a lone decimal comma (`2,5`) also accepted.
+const MEASURE_INPUT = /^(?:(?:\d{1,3}(?:,\d{3})+|\d+)(?:\.\d+)?|\d+,\d+)$/
+
+/**
+ * A measurement typed or pasted into a cell: `null` when cleared, `undefined`
+ * when it is not a non-negative number, so the cell keeps its value rather
+ * than being mangled.
+ */
+function readMeasure(value: string | null | undefined): number | null | undefined {
+  const typed = value?.trim() ?? ''
+  if (typed === '') return null
+  if (!MEASURE_INPUT.test(typed)) return undefined
+  return Number(normalizeMoneyInput(typed, 'en'))
+}