@blocklet/payment-react 1.18.18 → 1.18.19

package/lib/hooks/keyboard.d.ts

@@ -0,0 +1,44 @@
+import { KeyboardEvent, RefObject } from 'react';
+type TabNavigationOptions<T> = {
+    /** whether to include custom option as the last item */
+    includeCustom?: boolean;
+    /** the value or index of the current selected item */
+    currentValue?: T | number;
+    /** whether the current selected item is custom */
+    isCustomSelected?: boolean;
+    /** a function to compare values, used to determine the current selected item */
+    compareValue?: (item: T, value: any) => boolean;
+    /** whether to allow Tab key navigation */
+    enabled?: boolean;
+    /** a selector to find navigable elements */
+    selector?: string;
+    /** an element container reference, limiting the query DOM range to improve performance */
+    containerRef?: RefObject<HTMLElement>;
+    /** the type of the current value, can be 'index' or 'value' */
+    valueType?: 'index' | 'value';
+};
+/**
+ * Tab key navigation hook - implement Tab key circular navigation between a set of options
+ *
+ * @param items an array of options, can be a simple type (string, number) array or an object array
+ * @param onSelect callback when an item is selected
+ * @param options configuration options
+ * @returns an object containing the event handler and control functions
+ *
+ * @example
+ * // simple string array
+ * const { handleKeyDown } = useTabNavigation(['10', '20', '50'], handleSelect);
+ *
+ * // object array
+ * const { handleKeyDown } = useTabNavigation(
+ *   [{id: 1, name: 'A'}, {id: 2, name: 'B'}],
+ *   handleSelect,
+ *   { compareValue: (item, value) => item.id === value.id }
+ * );
+ */
+export declare const useTabNavigation: <T>(items: T[], onSelect: (item: T | "custom", index: number) => void, options?: TabNavigationOptions<T>) => {
+    handleKeyDown: (e: KeyboardEvent) => void;
+    resetTabNavigation: () => void;
+    isTabNavigationActive: boolean;
+};
+export {};

package/lib/hooks/keyboard.js

@@ -0,0 +1,85 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useTabNavigation = void 0;
+var _react = require("react");
+const useTabNavigation = (items, onSelect, options) => {
+  const {
+    valueType = "value",
+    includeCustom = false,
+    currentValue,
+    isCustomSelected = false,
+    compareValue = (item, value) => item === value,
+    enabled = true,
+    selector = ".tab-navigable-card button",
+    containerRef
+  } = options || {};
+  const hasTabbed = (0, _react.useRef)(false);
+  const findNavigableElements = (0, _react.useCallback)(() => {
+    if (containerRef?.current) {
+      return containerRef.current.querySelectorAll(selector);
+    }
+    return document.querySelectorAll(selector);
+  }, [containerRef, selector]);
+  const determineCurrentIndex = (0, _react.useCallback)(() => {
+    const allOptions = includeCustom ? [...items, "custom"] : items;
+    if (allOptions.length === 0) return -1;
+    if (!hasTabbed.current) {
+      if (isCustomSelected && includeCustom) {
+        return items.length;
+      }
+      if (currentValue !== void 0) {
+        if (valueType === "index" && typeof currentValue === "number") {
+          return currentValue >= 0 && currentValue < items.length ? currentValue : -1;
+        }
+        return items.findIndex(item => compareValue(item, currentValue));
+      }
+    } else {
+      const focusedElement = document.activeElement;
+      const navigableElements = findNavigableElements();
+      for (let i = 0; i < navigableElements.length; i++) {
+        if (navigableElements[i] === focusedElement) {
+          return i;
+        }
+      }
+    }
+    return -1;
+  }, [items, includeCustom, isCustomSelected, currentValue, valueType, compareValue, findNavigableElements]);
+  const getNextIndex = (0, _react.useCallback)((currentIndex, isShiftKey) => {
+    const totalOptions = includeCustom ? items.length + 1 : items.length;
+    if (currentIndex === -1) {
+      return 0;
+    }
+    if (isShiftKey) {
+      return currentIndex === 0 ? totalOptions - 1 : currentIndex - 1;
+    }
+    return currentIndex === totalOptions - 1 ? 0 : currentIndex + 1;
+  }, [items, includeCustom]);
+  const handleKeyDown = (0, _react.useCallback)(e => {
+    if (!enabled || e.key !== "Tab") return;
+    e.preventDefault();
+    e.stopPropagation();
+    const currentIndex = determineCurrentIndex();
+    const nextIndex = getNextIndex(currentIndex, e.shiftKey);
+    hasTabbed.current = true;
+    const selectedItem = nextIndex === items.length ? "custom" : items[nextIndex];
+    onSelect(selectedItem, nextIndex);
+    setTimeout(() => {
+      const elements = findNavigableElements();
+      if (elements[nextIndex]) {
+        elements[nextIndex].focus();
+      }
+    }, 0);
+  }, [items, onSelect, enabled, determineCurrentIndex, getNextIndex, findNavigableElements]);
+  const resetTabNavigation = (0, _react.useCallback)(() => {
+    hasTabbed.current = false;
+  }, []);
+  return {
+    handleKeyDown,
+    resetTabNavigation,
+    isTabNavigationActive: hasTabbed.current
+  };
+};
+exports.useTabNavigation = useTabNavigation;

package/lib/index.d.ts

@@ -42,5 +42,6 @@ export * from './hooks/subscription';
 export * from './hooks/mobile';
 export * from './hooks/table';
 export * from './hooks/scroll';
+export * from './hooks/keyboard';
 export { translations, createTranslator } from './locales';
 export { createLazyComponent, api, dayjs, FormInput, PhoneInput, AddressForm, StripeForm, Status, Livemode, Switch, ConfirmDialog, CheckoutForm, CheckoutTable, CheckoutDonate, CurrencySelector, Payment, PaymentSummary, PricingTable, ProductSkeleton, Amount, CustomerInvoiceList, CustomerPaymentList, TxLink, TxGas, SafeGuard, PricingItem, CountrySelect, Table, TruncatedText, Link, OverdueInvoicePayment, PaymentBeneficiaries, LoadingButton, DonateDetails, };

package/lib/index.js

@@ -418,6 +418,18 @@ Object.keys(_scroll).forEach(function (key) {
     }
   });
 });
+var _keyboard = require("./hooks/keyboard");
+Object.keys(_keyboard).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _keyboard[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _keyboard[key];
+    }
+  });
+});
 var _locales = require("./locales");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }

package/lib/locales/en.js

@@ -168,7 +168,7 @@ module.exports = (0, _flat.default)({
         payment: "Thanks for your purchase",
         subscription: "Thanks for your subscribing",
         setup: "Thanks for your subscribing",
-        donate: "Thanks for your support",
+        donate: "Thanks for your tip",
         tip: "A payment to {payee} has been completed. You can view the details of this payment in your account."
       },
       confirm: "Confirming allows {payee} to charge or reduce your staking. You can cancel or revoke staking anytime.",

package/lib/payment/form/index.js

@@ -409,6 +409,17 @@ function PaymentForm({
       stripePaying: false
     });
   };
+  (0, _react.useEffect)(() => {
+    const handleKeyDown = e => {
+      if (e.key === "Enter" && !state.submitting && !state.paying && !state.stripePaying && quantityInventoryStatus && payable) {
+        onAction();
+      }
+    };
+    window.addEventListener("keydown", handleKeyDown);
+    return () => {
+      window.removeEventListener("keydown", handleKeyDown);
+    };
+  }, [state.submitting, state.paying, state.stripePaying, quantityInventoryStatus, payable]);
   if (onlyShowBtn) {
     return /* @__PURE__ */(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
       children: [/* @__PURE__ */(0, _jsxRuntime.jsx)(_material.Box, {

package/lib/payment/product-donation.js

@@ -12,6 +12,12 @@ var _react = require("react");
 var _util = require("../libs/util");
 var _payment = require("../contexts/payment");
 var _scroll = require("../hooks/scroll");
+var _keyboard = require("../hooks/keyboard");
+const DONATION_PRESET_KEY_BASE = "payment-donation-preset";
+const DONATION_CUSTOM_AMOUNT_KEY_BASE = "payment-donation-custom-amount";
+const formatAmount = amount => {
+  return String(amount);
+};
 function ProductDonation({
   item,
   settings,
@@ -23,20 +29,109 @@ function ProductDonation({
     locale
   } = (0, _context.useLocaleContext)();
   const {
-    setPayable
+    setPayable,
+    session
   } = (0, _payment.usePaymentContext)();
   (0, _scroll.usePreventWheel)();
-  const presets = settings?.amount?.presets || [];
-  const preset = settings?.amount?.preset || presets?.[0] || "0";
+  const presets = (settings?.amount?.presets || []).map(formatAmount);
+  const getUserStorageKey = base => {
+    const userDid = session?.user?.did;
+    return userDid ? `${base}:${userDid}` : base;
+  };
+  const getSavedCustomAmount = () => {
+    try {
+      return localStorage.getItem(getUserStorageKey(DONATION_CUSTOM_AMOUNT_KEY_BASE)) || "";
+    } catch (e) {
+      console.warn("Failed to access localStorage", e);
+      return "";
+    }
+  };
+  const getDefaultPreset = () => {
+    if (settings?.amount?.preset) {
+      return formatAmount(settings.amount.preset);
+    }
+    try {
+      const savedPreset = localStorage.getItem(getUserStorageKey(DONATION_PRESET_KEY_BASE));
+      if (savedPreset) {
+        if (presets.includes(formatAmount(savedPreset))) {
+          return formatAmount(savedPreset);
+        }
+        if (savedPreset === "custom" && supportCustom) {
+          return "custom";
+        }
+      }
+    } catch (e) {
+      console.warn("Failed to access localStorage", e);
+    }
+    if (presets.length > 0) {
+      const middleIndex = Math.floor(presets.length / 2);
+      return presets[middleIndex] || presets[0];
+    }
+    return "0";
+  };
   const supportPreset = presets.length > 0;
   const supportCustom = !!settings?.amount?.custom;
+  const defaultPreset = getDefaultPreset();
+  const defaultCustomAmount = defaultPreset === "custom" ? getSavedCustomAmount() : "";
   const [state, setState] = (0, _ahooks.useSetState)({
-    selected: preset,
-    input: "",
-    custom: !supportPreset,
+    selected: defaultPreset === "custom" ? "" : defaultPreset,
+    input: defaultCustomAmount,
+    custom: !supportPreset || defaultPreset === "custom",
     error: ""
   });
   const customInputRef = (0, _react.useRef)(null);
+  const containerRef = (0, _react.useRef)(null);
+  const handleSelect = amount => {
+    setPayable(true);
+    setState({
+      selected: formatAmount(amount),
+      custom: false,
+      error: ""
+    });
+    onChange({
+      priceId: item.price_id,
+      amount: formatAmount(amount)
+    });
+    localStorage.setItem(getUserStorageKey(DONATION_PRESET_KEY_BASE), formatAmount(amount));
+  };
+  const handleCustomSelect = () => {
+    setState({
+      custom: true,
+      selected: "",
+      error: ""
+    });
+    const savedCustomAmount = getSavedCustomAmount();
+    if (savedCustomAmount) {
+      setState({
+        input: savedCustomAmount
+      });
+      onChange({
+        priceId: item.price_id,
+        amount: savedCustomAmount
+      });
+      setPayable(true);
+    } else if (!state.input) {
+      setPayable(false);
+    }
+    localStorage.setItem(getUserStorageKey(DONATION_PRESET_KEY_BASE), "custom");
+  };
+  const handleTabSelect = selectedItem => {
+    if (selectedItem === "custom") {
+      handleCustomSelect();
+    } else {
+      handleSelect(selectedItem);
+    }
+  };
+  const {
+    handleKeyDown
+  } = (0, _keyboard.useTabNavigation)(presets, handleTabSelect, {
+    includeCustom: supportCustom,
+    currentValue: state.custom ? void 0 : state.selected,
+    isCustomSelected: state.custom,
+    enabled: true,
+    selector: ".tab-navigable-card button",
+    containerRef
+  });
   (0, _react.useEffect)(() => {
     if (settings.amount.preset) {
       setState({
@@ -48,35 +143,38 @@ function ProductDonation({
         amount: settings.amount.preset
       });
     } else if (settings.amount.presets && settings.amount.presets.length > 0) {
+      const isCustom = defaultPreset === "custom";
       setState({
-        selected: settings.amount.presets[0],
-        custom: false
-      });
-      onChange({
-        priceId: item.price_id,
-        amount: settings.amount.presets[0]
+        selected: isCustom ? "" : defaultPreset,
+        custom: isCustom,
+        input: isCustom ? getSavedCustomAmount() : ""
       });
+      if (!isCustom) {
+        onChange({
+          priceId: item.price_id,
+          amount: defaultPreset
+        });
+      } else if (defaultCustomAmount) {
+        onChange({
+          priceId: item.price_id,
+          amount: defaultCustomAmount
+        });
+        setPayable(true);
+      } else {
+        setPayable(false);
+      }
     }
   }, [settings.amount.preset, settings.amount.presets]);
   (0, _react.useEffect)(() => {
+    if (containerRef.current) {
+      containerRef.current.focus();
+    }
     if (state.custom) {
       setTimeout(() => {
         customInputRef.current?.focus();
       }, 0);
     }
   }, [state.custom]);
-  const handleSelect = amount => {
-    setPayable(true);
-    setState({
-      selected: amount,
-      custom: false,
-      error: ""
-    });
-    onChange({
-      priceId: item.price_id,
-      amount
-    });
-  };
   const handleInput = event => {
     const {
       value
@@ -110,32 +208,31 @@ function ProductDonation({
     });
     onChange({
       priceId: item.price_id,
-      amount: value
+      amount: formatAmount(value)
     });
-  };
-  const handleCustomSelect = () => {
-    setState({
-      custom: true,
-      error: ""
-    });
-    if (!state.input) {
-      setPayable(false);
-    }
+    localStorage.setItem(getUserStorageKey(DONATION_CUSTOM_AMOUNT_KEY_BASE), formatAmount(value));
   };
   return /* @__PURE__ */(0, _jsxRuntime.jsxs)(_material.Box, {
+    ref: containerRef,
     display: "flex",
     flexDirection: "column",
     alignItems: "flex-start",
     gap: 1.5,
+    onKeyDown: handleKeyDown,
+    tabIndex: 0,
+    sx: {
+      outline: "none"
+    },
     children: [supportPreset && /* @__PURE__ */(0, _jsxRuntime.jsxs)(_material.Grid, {
       container: true,
       spacing: 2,
-      children: [settings.amount.presets && settings.amount.presets.length > 0 && settings.amount.presets.map(amount => /* @__PURE__ */(0, _jsxRuntime.jsx)(_material.Grid, {
+      children: [presets.map(amount => /* @__PURE__ */(0, _jsxRuntime.jsx)(_material.Grid, {
         item: true,
         xs: 6,
         sm: 3,
         children: /* @__PURE__ */(0, _jsxRuntime.jsx)(_material.Card, {
           variant: "outlined",
+          className: "tab-navigable-card",
           sx: {
             minWidth: 115,
             textAlign: "center",
@@ -145,14 +242,19 @@ function ProductDonation({
               transform: "translateY(-4px)",
               boxShadow: 3
             },
+            ".MuiCardActionArea-focusHighlight": {
+              backgroundColor: "transparent"
+            },
             height: "42px",
-            ...(state.selected === amount && !state.custom ? {
+            ...(formatAmount(state.selected) === formatAmount(amount) && !state.custom ? {
               borderColor: "primary.main",
               borderWidth: 1
             } : {})
           },
           children: /* @__PURE__ */(0, _jsxRuntime.jsx)(_material.CardActionArea, {
             onClick: () => handleSelect(amount),
+            tabIndex: 0,
+            "aria-selected": formatAmount(state.selected) === formatAmount(amount) && !state.custom,
             children: /* @__PURE__ */(0, _jsxRuntime.jsxs)(_material.Stack, {
               direction: "row",
               sx: {
@@ -187,13 +289,14 @@ function ProductDonation({
               })]
             })
           })
-        }, amount)
+        })
       }, amount)), supportCustom && /* @__PURE__ */(0, _jsxRuntime.jsx)(_material.Grid, {
         item: true,
         xs: 6,
         sm: 3,
         children: /* @__PURE__ */(0, _jsxRuntime.jsx)(_material.Card, {
           variant: "outlined",
+          className: "tab-navigable-card",
           sx: {
             textAlign: "center",
             transition: "all 0.3s",
@@ -202,6 +305,9 @@ function ProductDonation({
               transform: "translateY(-4px)",
               boxShadow: 3
             },
+            ".MuiCardActionArea-focusHighlight": {
+              backgroundColor: "transparent"
+            },
             height: "42px",
             ...(state.custom ? {
               borderColor: "primary.main",
@@ -209,7 +315,9 @@ function ProductDonation({
             } : {})
           },
           children: /* @__PURE__ */(0, _jsxRuntime.jsx)(_material.CardActionArea, {
-            onClick: () => handleCustomSelect(),
+            onClick: handleCustomSelect,
+            tabIndex: 0,
+            "aria-selected": state.custom,
             children: /* @__PURE__ */(0, _jsxRuntime.jsx)(_material.Stack, {
               direction: "row",
               sx: {
@@ -229,7 +337,7 @@ function ProductDonation({
               })
             })
           })
-        }, "custom")
+        })
       }, "custom")]
     }), state.custom && /* @__PURE__ */(0, _jsxRuntime.jsx)(_material.TextField, {
       type: "number",
@@ -262,7 +370,7 @@ function ProductDonation({
         autoComplete: "off"
       },
       sx: {
-        mt: preset !== "0" ? 0 : 1
+        mt: defaultPreset !== "0" ? 0 : 1
       }
     })]
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blocklet/payment-react",
-  "version": "1.18.18",
+  "version": "1.18.19",
   "description": "Reusable react components for payment kit v2",
   "keywords": [
     "react",
@@ -54,10 +54,10 @@
     }
   },
   "dependencies": {
-    "@arcblock/did-connect": "^2.12.26",
-    "@arcblock/ux": "^2.12.26",
+    "@arcblock/did-connect": "^2.12.36",
+    "@arcblock/ux": "^2.12.36",
     "@arcblock/ws": "^1.19.15",
-    "@blocklet/ui-react": "^2.12.26",
+    "@blocklet/ui-react": "^2.12.36",
     "@mui/icons-material": "^5.16.6",
     "@mui/lab": "^5.0.0-alpha.173",
     "@mui/material": "^5.16.6",
@@ -93,7 +93,7 @@
     "@babel/core": "^7.25.2",
     "@babel/preset-env": "^7.25.2",
     "@babel/preset-react": "^7.24.7",
-    "@blocklet/payment-types": "1.18.18",
+    "@blocklet/payment-types": "1.18.19",
     "@storybook/addon-essentials": "^7.6.20",
     "@storybook/addon-interactions": "^7.6.20",
     "@storybook/addon-links": "^7.6.20",
@@ -124,5 +124,5 @@
     "vite-plugin-babel": "^1.2.0",
     "vite-plugin-node-polyfills": "^0.21.0"
   },
-  "gitHead": "511a531693837c4e0784d4961f8755e5818a27d5"
+  "gitHead": "eabd58598ad349a5177dca2e6302c82117d9b687"
 }

package/src/components/livemode.tsx

@@ -16,8 +16,8 @@ export default function Livemode({ color, backgroundColor, sx }: Props) {
       color="warning"
       sx={{
         ml: 2,
-        height: 18,
-        lineHeight: 1.2,
+        height: '18px',
+        lineHeight: '18px',
         textTransform: 'uppercase',
         fontSize: '0.7rem',
         fontWeight: 'bold',