@opensite/ui 1.3.2 → 1.3.4

package/dist/offer-modal-membership-image.d.cts

@@ -0,0 +1,194 @@
+import * as React from 'react';
+import { P as PageSpeedFormConfig } from './forms-BCcwNFhk.cjs';
+import { f as SectionBackground } from './community-initiatives-Bz_A5vLU.cjs';
+import { I as ImageItem, O as OptixFlowConfig } from './blocks-Cohq4eio.cjs';
+import 'react/jsx-runtime';
+import 'class-variance-authority';
+import './button-variants-lRElsmTc.cjs';
+import 'class-variance-authority/types';
+
+interface OfferModalMembershipImageProps {
+    /**
+     * Overline/eyebrow content displayed above the title
+     */
+    overline?: React.ReactNode;
+    /**
+     * Main title content for the offer
+     */
+    title?: React.ReactNode;
+    /**
+     * Description content displayed below the form
+     */
+    description?: React.ReactNode;
+    /**
+     * Image configuration for the header
+     */
+    image?: ImageItem;
+    /**
+     * Custom slot for rendering the image (overrides image prop)
+     */
+    imageSlot?: React.ReactNode;
+    /**
+     * Placeholder text for the email input
+     */
+    emailPlaceholder?: string;
+    /**
+     * Text for the submit button
+     */
+    buttonText?: React.ReactNode;
+    /**
+     * Custom slot for the close button (overrides default close button)
+     */
+    closeButtonSlot?: React.ReactNode;
+    /**
+     * Custom slot for the form (overrides default form)
+     */
+    formSlot?: React.ReactNode;
+    /**
+     * Custom slot for the footer/description area (overrides description)
+     */
+    footerSlot?: React.ReactNode;
+    /**
+     * Whether the dialog is open (controlled mode)
+     */
+    open?: boolean;
+    /**
+     * Callback when the dialog open state changes
+     */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Whether the dialog is open by default (uncontrolled mode)
+     */
+    defaultOpen?: boolean;
+    /**
+     * Optional custom submission handler for maximum flexibility.
+     *
+     * Use this when you need complete control over the submission logic,
+     * such as custom API calls, analytics tracking, or multi-step workflows.
+     *
+     * Can be used alone or in combination with `formConfig` for hybrid approaches.
+     *
+     * @example
+     * onSubmit={async (email) => {
+     *   await fetch("/api/subscribe", {
+     *     method: "POST",
+     *     body: JSON.stringify({ email, membership: "premium" })
+     *   });
+     * }}
+     */
+    onSubmit?: (email: string) => void | Promise<void>;
+    /**
+     * Optional form submission configuration.
+     *
+     * **Universal Usage**: Works with ANY REST API endpoint. Simply provide an `endpoint` URL
+     * and the form will submit to it in JSON format.
+     *
+     * @example
+     * // Works with any API
+     * formConfig={{ endpoint: "https://api.mysite.com/subscribe", format: "json" }}
+     *
+     * @example
+     * // With custom headers (e.g., authentication)
+     * formConfig={{
+     *   endpoint: "/api/newsletter",
+     *   headers: { "Authorization": "Bearer token123" }
+     * }}
+     *
+     * **Note**: The `apiKey`, `contactCategoryToken`, and other platform-specific fields
+     * are OPTIONAL and only needed when integrating with DashTrack's Rails backend.
+     * For generic REST APIs, just use `endpoint`, `method`, `format`, and `headers`.
+     *
+     * See `FORMS_INTEGRATION_GUIDE.md` for complete examples with Next.js, React, and more.
+     */
+    formConfig?: PageSpeedFormConfig;
+    /**
+     * Optional success callback invoked after successful submission.
+     *
+     * Called after `formConfig` submission and/or `onSubmit` completes successfully.
+     * Use for showing success messages, redirecting, analytics tracking, etc.
+     */
+    onSuccess?: (data: unknown) => void;
+    /**
+     * Optional error callback invoked if submission fails.
+     *
+     * Receives the error object for custom error handling, logging, or user notifications.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Additional CSS classes for the dialog content wrapper
+     */
+    className?: string;
+    /**
+     * Additional CSS classes for the image wrapper
+     */
+    imageWrapperClassName?: string;
+    /**
+     * Additional CSS classes for the image element
+     */
+    imageClassName?: string;
+    /**
+     * Additional CSS classes for the content area (below image)
+     */
+    contentClassName?: string;
+    /**
+     * Additional CSS classes for the overline text
+     */
+    overlineClassName?: string;
+    /**
+     * Additional CSS classes for the title
+     */
+    titleClassName?: string;
+    /**
+     * Additional CSS classes for the description
+     */
+    descriptionClassName?: string;
+    /**
+     * Additional CSS classes for the form
+     */
+    formClassName?: string;
+    /**
+     * Additional CSS classes for the email input
+     */
+    inputClassName?: string;
+    /**
+     * Additional CSS classes for the submit button
+     */
+    submitClassName?: string;
+    /**
+     * Additional CSS classes for the close button
+     */
+    closeClassName?: string;
+    /**
+     * Additional CSS classes for the footer
+     */
+    footerClassName?: string;
+    /**
+     * Optional configuration for OptixFlow image optimization
+     */
+    optixFlowConfig?: OptixFlowConfig;
+    /**
+     * Background style variant for the section
+     * @default "default"
+     */
+    background?: SectionBackground;
+}
+/**
+ * OfferModalMembershipImage - A visually rich membership offer modal featuring a header image,
+ * overline text, compelling title, email signup form with icon, and descriptive footer text.
+ * Includes responsive design with mobile-optimized layout and hover animations on the close button.
+ * Ideal for e-commerce membership programs, exclusive offers, or premium newsletter signups.
+ *
+ * @example
+ * ```tsx
+ * <OfferModalMembershipImage
+ *   overline="Treat Yourself!"
+ *   title="Become a Member & Enjoy 20% Off"
+ *   description="Sign up to receive our latest updates."
+ *   image={{ src: "/promo.jpg", alt: "Promotional image" }}
+ *   onSubmit={(email) => console.log('Subscribed:', email)}
+ * />
+ * ```
+ */
+declare function OfferModalMembershipImage({ overline, title, description, image, imageSlot, emailPlaceholder, buttonText, closeButtonSlot, formSlot, footerSlot, open, onOpenChange, defaultOpen, onSubmit, formConfig, onSuccess, onError, className, imageWrapperClassName, imageClassName, contentClassName, overlineClassName, titleClassName, descriptionClassName, formClassName, inputClassName, submitClassName, closeClassName, footerClassName, optixFlowConfig, background, }: OfferModalMembershipImageProps): React.JSX.Element;
+
+export { OfferModalMembershipImage, type OfferModalMembershipImageProps };

package/dist/offer-modal-membership-image.d.ts

@@ -0,0 +1,194 @@
+import * as React from 'react';
+import { P as PageSpeedFormConfig } from './forms-BCcwNFhk.js';
+import { f as SectionBackground } from './community-initiatives-Bi_ClKrO.js';
+import { I as ImageItem, O as OptixFlowConfig } from './blocks-k17uluAz.js';
+import 'react/jsx-runtime';
+import 'class-variance-authority';
+import './button-variants-lRElsmTc.js';
+import 'class-variance-authority/types';
+
+interface OfferModalMembershipImageProps {
+    /**
+     * Overline/eyebrow content displayed above the title
+     */
+    overline?: React.ReactNode;
+    /**
+     * Main title content for the offer
+     */
+    title?: React.ReactNode;
+    /**
+     * Description content displayed below the form
+     */
+    description?: React.ReactNode;
+    /**
+     * Image configuration for the header
+     */
+    image?: ImageItem;
+    /**
+     * Custom slot for rendering the image (overrides image prop)
+     */
+    imageSlot?: React.ReactNode;
+    /**
+     * Placeholder text for the email input
+     */
+    emailPlaceholder?: string;
+    /**
+     * Text for the submit button
+     */
+    buttonText?: React.ReactNode;
+    /**
+     * Custom slot for the close button (overrides default close button)
+     */
+    closeButtonSlot?: React.ReactNode;
+    /**
+     * Custom slot for the form (overrides default form)
+     */
+    formSlot?: React.ReactNode;
+    /**
+     * Custom slot for the footer/description area (overrides description)
+     */
+    footerSlot?: React.ReactNode;
+    /**
+     * Whether the dialog is open (controlled mode)
+     */
+    open?: boolean;
+    /**
+     * Callback when the dialog open state changes
+     */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Whether the dialog is open by default (uncontrolled mode)
+     */
+    defaultOpen?: boolean;
+    /**
+     * Optional custom submission handler for maximum flexibility.
+     *
+     * Use this when you need complete control over the submission logic,
+     * such as custom API calls, analytics tracking, or multi-step workflows.
+     *
+     * Can be used alone or in combination with `formConfig` for hybrid approaches.
+     *
+     * @example
+     * onSubmit={async (email) => {
+     *   await fetch("/api/subscribe", {
+     *     method: "POST",
+     *     body: JSON.stringify({ email, membership: "premium" })
+     *   });
+     * }}
+     */
+    onSubmit?: (email: string) => void | Promise<void>;
+    /**
+     * Optional form submission configuration.
+     *
+     * **Universal Usage**: Works with ANY REST API endpoint. Simply provide an `endpoint` URL
+     * and the form will submit to it in JSON format.
+     *
+     * @example
+     * // Works with any API
+     * formConfig={{ endpoint: "https://api.mysite.com/subscribe", format: "json" }}
+     *
+     * @example
+     * // With custom headers (e.g., authentication)
+     * formConfig={{
+     *   endpoint: "/api/newsletter",
+     *   headers: { "Authorization": "Bearer token123" }
+     * }}
+     *
+     * **Note**: The `apiKey`, `contactCategoryToken`, and other platform-specific fields
+     * are OPTIONAL and only needed when integrating with DashTrack's Rails backend.
+     * For generic REST APIs, just use `endpoint`, `method`, `format`, and `headers`.
+     *
+     * See `FORMS_INTEGRATION_GUIDE.md` for complete examples with Next.js, React, and more.
+     */
+    formConfig?: PageSpeedFormConfig;
+    /**
+     * Optional success callback invoked after successful submission.
+     *
+     * Called after `formConfig` submission and/or `onSubmit` completes successfully.
+     * Use for showing success messages, redirecting, analytics tracking, etc.
+     */
+    onSuccess?: (data: unknown) => void;
+    /**
+     * Optional error callback invoked if submission fails.
+     *
+     * Receives the error object for custom error handling, logging, or user notifications.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Additional CSS classes for the dialog content wrapper
+     */
+    className?: string;
+    /**
+     * Additional CSS classes for the image wrapper
+     */
+    imageWrapperClassName?: string;
+    /**
+     * Additional CSS classes for the image element
+     */
+    imageClassName?: string;
+    /**
+     * Additional CSS classes for the content area (below image)
+     */
+    contentClassName?: string;
+    /**
+     * Additional CSS classes for the overline text
+     */
+    overlineClassName?: string;
+    /**
+     * Additional CSS classes for the title
+     */
+    titleClassName?: string;
+    /**
+     * Additional CSS classes for the description
+     */
+    descriptionClassName?: string;
+    /**
+     * Additional CSS classes for the form
+     */
+    formClassName?: string;
+    /**
+     * Additional CSS classes for the email input
+     */
+    inputClassName?: string;
+    /**
+     * Additional CSS classes for the submit button
+     */
+    submitClassName?: string;
+    /**
+     * Additional CSS classes for the close button
+     */
+    closeClassName?: string;
+    /**
+     * Additional CSS classes for the footer
+     */
+    footerClassName?: string;
+    /**
+     * Optional configuration for OptixFlow image optimization
+     */
+    optixFlowConfig?: OptixFlowConfig;
+    /**
+     * Background style variant for the section
+     * @default "default"
+     */
+    background?: SectionBackground;
+}
+/**
+ * OfferModalMembershipImage - A visually rich membership offer modal featuring a header image,
+ * overline text, compelling title, email signup form with icon, and descriptive footer text.
+ * Includes responsive design with mobile-optimized layout and hover animations on the close button.
+ * Ideal for e-commerce membership programs, exclusive offers, or premium newsletter signups.
+ *
+ * @example
+ * ```tsx
+ * <OfferModalMembershipImage
+ *   overline="Treat Yourself!"
+ *   title="Become a Member & Enjoy 20% Off"
+ *   description="Sign up to receive our latest updates."
+ *   image={{ src: "/promo.jpg", alt: "Promotional image" }}
+ *   onSubmit={(email) => console.log('Subscribed:', email)}
+ * />
+ * ```
+ */
+declare function OfferModalMembershipImage({ overline, title, description, image, imageSlot, emailPlaceholder, buttonText, closeButtonSlot, formSlot, footerSlot, open, onOpenChange, defaultOpen, onSubmit, formConfig, onSuccess, onError, className, imageWrapperClassName, imageClassName, contentClassName, overlineClassName, titleClassName, descriptionClassName, formClassName, inputClassName, submitClassName, closeClassName, footerClassName, optixFlowConfig, background, }: OfferModalMembershipImageProps): React.JSX.Element;
+
+export { OfferModalMembershipImage, type OfferModalMembershipImageProps };