@veevarts/design-system 1.12.6 → 1.12.8

package/dist/patterns/CashTenderForm/types.d.ts

@@ -60,6 +60,30 @@ export interface CashTenderFormProps {
      * Disable interactions (e.g. while submitting).
      */
     isDisabled?: boolean;
+    /**
+     * Hard upper bound for the received amount, in MAJOR units (same unit
+     * as `dueAmount.value`). A keystroke that would push the parsed value
+     * above this is REJECTED (the field keeps its prior value) — so a
+     * cashier can't enter a pathological amount that overflows the PSP
+     * integer range downstream. A character `maxLength` can't enforce this
+     * (e.g. `99999999` is only 8 chars yet far over a $999,999.99 cap), so
+     * the guard is value-based. Omit for no cap.
+     */
+    maxAmount?: number;
+    /**
+     * Auto-focus the Cash Received field when this component mounts.
+     * Pair with `key={...}` from the host to re-trigger focus on every
+     * sub-payment (the form re-mounts and `autoFocus` fires again).
+     * The built-in `onFocus` already selects the value, so a cashier
+     * landing here can overwrite the existing amount with a single
+     * keystroke.
+     *
+     * Default `false` — the field is unfocused at mount. Hosts opt in
+     * when their flow guarantees the cashier just navigated TO this
+     * tender (e.g. selecting Cash from the method picker, advancing to
+     * the next split sub-payment).
+     */
+    autoFocus?: boolean;
     /**
      * Inline test id forwarded to the root element.
      */

package/dist/patterns/CheckTenderForm/types.d.ts

@@ -37,6 +37,26 @@ export interface CheckTenderFormProps {
     /** Hide the bank name field when the host doesn't care. */
     hideBankName?: boolean;
     isDisabled?: boolean;
+    /**
+     * Character cap for the Check Number field. Guards against pathological
+     * paste / extreme input. Default `34` (the length of the longest IBAN,
+     * a generous ceiling for any cheque / international reference).
+     */
+    checkNumberMaxLength?: number;
+    /**
+     * Character cap for the Bank Name field. Default `100`.
+     */
+    bankNameMaxLength?: number;
+    /**
+     * Auto-focus the Check Number field when this component mounts.
+     * Pair with `key={...}` from the host to re-trigger focus on every
+     * sub-payment (the form re-mounts and `autoFocus` fires again).
+     * Default `false` — the field is unfocused at mount. Hosts opt in
+     * when their flow guarantees the cashier just navigated TO this
+     * tender (e.g. selecting Check from the method picker, advancing
+     * to the next split sub-payment).
+     */
+    autoFocus?: boolean;
     'data-testid'?: string;
     className?: string;
 }

package/dist/patterns/PaymentSubAmountInput/PaymentSubAmountInput.d.ts

@@ -25,6 +25,30 @@ export interface PaymentSubAmountInputProps {
      * + locale).
      */
     errorMessage?: string;
+    /**
+     * Auto-focus the amount field when this component mounts. Pair
+     * with `key={...}` from the host to re-trigger focus on every
+     * sub-payment (the input re-mounts each time and `autoFocus`
+     * fires again). The built-in `onFocus` already selects the
+     * value, so a cashier landing here can overwrite the placeholder
+     * with a single keystroke.
+     *
+     * Default `false` — the input is unfocused at mount. Hosts opt in
+     * when their flow guarantees the cashier just navigated TO this
+     * step (e.g. opening Split, advancing to Payment #N).
+     */
+    autoFocus?: boolean;
+    /**
+     * Hard upper bound for the typed amount, in the same MAJOR-unit scale
+     * the host parses the emitted string with. A keystroke that would push
+     * the parsed value above this is REJECTED (the controlled `value` is
+     * left unchanged, so the input reverts the offending character). Keeps
+     * the cashier from entering an amount that overflows the PSP integer
+     * range downstream. A character `maxLength` can't enforce this (e.g.
+     * `99999999` is only 8 chars yet far over a $999,999.99 cap), so the
+     * guard is value-based. Omit for no cap.
+     */
+    maxAmount?: number;
     'data-testid'?: string;
     className?: string;
 }

package/dist/patterns/PaymentSubAmountInput/__test__/PaymentSubAmountInput.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * PaymentSubAmountInput unit tests
+ */
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@veevarts/design-system",
     "private": false,
-    "version": "1.12.6",
+    "version": "1.12.8",
     "type": "module",
     "main": "dist/index.js",
     "module": "dist/index.js",