@momo-webplatform/mobase 0.2.110 → 0.2.112

package/dist/cjs/index.d.cts

@@ -140,7 +140,34 @@ interface ActionButtonProps extends ButtonProps {
     onPushTrackingEvent?: () => void;
 }
 
-declare const ActionButton: ({ action, newTab, offset, dialogQrProps, className, children, onPushTrackingEvent, ...props }: ActionButtonProps) => react_jsx_runtime.JSX.Element;
+/**
+ * ActionButton handles different click behaviors based on environment:
+ *
+ * - MoMo App:          action (priority) → qrLink (fallback), via window.open
+ * - Desktop (non-app): hasQrLink → DialogQr  |  no qrLink → action
+ * - Mobile (non-app):  hasQrLink → navigate to qrLink (unless isQrForAll → DialogQr)  |  no qrLink → action
+ *
+ * Supports `asChild` to delegate all action behavior onto a custom child element.
+ * When `asChild` is true, bare Radix Slot is used — Button styles are stripped,
+ * only onClick and data-umami-event/data-umami-event-text are merged onto the child.
+ *
+ * @example
+ * // Default usage
+ * <ActionButton action="https://...">Click me</ActionButton>
+ *
+ * @example
+ * // asChild — child receives onClick + data-umami-event, no Button styles
+ * <ActionButton asChild action="https://..." dataUmamiEvent="banner-click">
+ *   <img src="banner.jpg" alt="Banner" />
+ * </ActionButton>
+ *
+ * @example
+ * // asChild + QR dialog on desktop
+ * <ActionButton asChild dialogQrProps={{ qrLink: "momo://..." }}>
+ *   <img src="banner.jpg" alt="Banner" />
+ * </ActionButton>
+ */
+declare const ActionButton: ({ action, newTab, offset, dialogQrProps, className, children, onPushTrackingEvent, asChild, dataUmamiEvent, dataUmamiEventText, ...props }: ActionButtonProps) => react_jsx_runtime.JSX.Element;
 
 declare const Breadcrumb: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & {
     separator?: React$1.ReactNode;

package/dist/esm/index.d.ts

@@ -140,7 +140,34 @@ interface ActionButtonProps extends ButtonProps {
     onPushTrackingEvent?: () => void;
 }
 
-declare const ActionButton: ({ action, newTab, offset, dialogQrProps, className, children, onPushTrackingEvent, ...props }: ActionButtonProps) => react_jsx_runtime.JSX.Element;
+/**
+ * ActionButton handles different click behaviors based on environment:
+ *
+ * - MoMo App:          action (priority) → qrLink (fallback), via window.open
+ * - Desktop (non-app): hasQrLink → DialogQr  |  no qrLink → action
+ * - Mobile (non-app):  hasQrLink → navigate to qrLink (unless isQrForAll → DialogQr)  |  no qrLink → action
+ *
+ * Supports `asChild` to delegate all action behavior onto a custom child element.
+ * When `asChild` is true, bare Radix Slot is used — Button styles are stripped,
+ * only onClick and data-umami-event/data-umami-event-text are merged onto the child.
+ *
+ * @example
+ * // Default usage
+ * <ActionButton action="https://...">Click me</ActionButton>
+ *
+ * @example
+ * // asChild — child receives onClick + data-umami-event, no Button styles
+ * <ActionButton asChild action="https://..." dataUmamiEvent="banner-click">
+ *   <img src="banner.jpg" alt="Banner" />
+ * </ActionButton>
+ *
+ * @example
+ * // asChild + QR dialog on desktop
+ * <ActionButton asChild dialogQrProps={{ qrLink: "momo://..." }}>
+ *   <img src="banner.jpg" alt="Banner" />
+ * </ActionButton>
+ */
+declare const ActionButton: ({ action, newTab, offset, dialogQrProps, className, children, onPushTrackingEvent, asChild, dataUmamiEvent, dataUmamiEventText, ...props }: ActionButtonProps) => react_jsx_runtime.JSX.Element;
 
 declare const Breadcrumb: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & {
     separator?: React$1.ReactNode;