import * as React from 'react';
import { P as PageSpeedFormConfig } from './forms-BCcwNFhk.js';

/**
 * Link item for the newsletter social link page
 */
interface NewsletterSocialLink {
    id: string;
    label: string;
    href: string;
    icon?: string;
}
/**
 * Social link for the newsletter social link page
 */
interface NewsletterSocialSocialLink {
    id: string;
    platform: string;
    href: string;
    icon: string;
}
/**
 * Props for the LinkPageNewsletterSocial component
 */
interface LinkPageNewsletterSocialProps {
    /**
     * Profile name displayed at the top
     */
    name: string;
    /**
     * Optional bio or description
     */
    bio?: string;
    /**
     * Avatar image URL
     */
    avatarUrl?: string;
    /**
     * Newsletter section heading
     */
    newsletterHeading?: string;
    /**
     * Newsletter section description
     */
    newsletterDescription?: string;
    /**
     * Email input placeholder text
     */
    emailPlaceholder?: string;
    /**
     * Submit button text
     */
    buttonText?: string;
    /**
     * Array of links to display below the newsletter
     */
    links?: NewsletterSocialLink[];
    /**
     * Array of social media links
     */
    socialLinks?: NewsletterSocialSocialLink[];
    /**
     * Additional CSS classes
     */
    className?: string;
    /**
     * Theme variation: "light" or "dark"
     */
    theme?: "light" | "dark";
    /**
     * 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 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, campaign: "link-page" })
     *   });
     * }}
     */
    onSubmit?: (email: string) => void | Promise<void>;
    /**
     * 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;
}
/**
 * LinkPageNewsletterSocial - A link page with integrated newsletter signup form.
 *
 * This component provides a link page with:
 * - Profile section with avatar, name, and bio
 * - Newsletter signup form with email validation
 * - Form integration with @page-speed/forms library
 * - Links section below the newsletter
 * - Social media links
 * - Light and dark theme support
 *
 * The newsletter form supports:
 * - Universal REST API integration via formConfig
 * - Custom submission handlers via onSubmit
 * - Success and error callbacks
 * - DashTrack Rails backend integration
 *
 * @example
 * ```tsx
 * // Basic usage
 * <LinkPageNewsletterSocial
 *   name="Content Creator"
 *   bio="Weekly tips on growing your audience"
 *   newsletterHeading="Join my newsletter"
 *   formConfig={{ endpoint: "/api/subscribe" }}
 * />
 *
 * // With custom submission handler
 * <LinkPageNewsletterSocial
 *   name="Content Creator"
 *   onSubmit={async (email) => {
 *     await myCustomApi.subscribe(email);
 *   }}
 *   onSuccess={() => toast.success("Subscribed!")}
 * />
 * ```
 */
declare function LinkPageNewsletterSocial({ name, bio, avatarUrl, newsletterHeading, newsletterDescription, emailPlaceholder, buttonText, links, socialLinks, className, theme, formConfig, onSubmit, onSuccess, onError, }: LinkPageNewsletterSocialProps): React.JSX.Element;

export { LinkPageNewsletterSocial, type LinkPageNewsletterSocialProps, type NewsletterSocialLink, type NewsletterSocialSocialLink };
