@masters-ws/react-seo 1.2.0 → 1.4.0

package/dist/index-CkB-Wt4c.d.ts

@@ -0,0 +1,1272 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface SiteConfig {
+    name: string;
+    description: string;
+    url: string;
+    logo?: string;
+    publisher?: string;
+    twitterHandle?: string;
+    facebookAppId?: string;
+    language?: string;
+    socialLinks?: string[];
+    googleAnalyticsId?: string;
+    gtmId?: string;
+    facebookPixelId?: string;
+    yandexMetricaId?: string;
+    themeColor?: string;
+    manifest?: string;
+}
+interface SEOData {
+    title?: string;
+    description?: string;
+    image?: string;
+    canonical?: string;
+    type?: 'website' | 'article' | 'product' | 'profile' | 'video' | 'faq';
+    robots?: string;
+    noindex?: boolean;
+    keywords?: string[];
+    prev?: string;
+    next?: string;
+    alternates?: Array<{
+        hreflang: string;
+        href: string;
+    }>;
+    ogTitle?: string;
+    ogDescription?: string;
+    ogImage?: string;
+    ogImageWidth?: number;
+    ogImageHeight?: number;
+    ogImageAlt?: string;
+    ogType?: string;
+    ogLocale?: string;
+    twitterCard?: 'summary' | 'summary_large_image' | 'app' | 'player';
+    twitterTitle?: string;
+    twitterDescription?: string;
+    twitterImage?: string;
+    twitterImageAlt?: string;
+    publishedTime?: string;
+    modifiedTime?: string;
+    author?: {
+        name: string;
+        url?: string;
+        image?: string;
+    };
+    tags?: string[];
+    section?: string;
+    readingTime?: number;
+    product?: {
+        sku?: string;
+        brand?: string;
+        price?: number;
+        currency?: string;
+        availability?: string;
+        rating?: number;
+        reviewCount?: number;
+    };
+    dnsPrefetch?: string[];
+    preconnect?: string[];
+    prefetch?: string[];
+    preload?: Array<{
+        href: string;
+        as: string;
+        type?: string;
+    }>;
+    whatsappImage?: string;
+    whatsappDescription?: string;
+    schema?: any;
+}
+interface BreadcrumbItem {
+    name: string;
+    item: string;
+}
+
+/**
+ * Generate Organization Schema
+ */
+declare function generateOrganizationSchema(config: SiteConfig): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    url: string;
+    logo: string | undefined;
+    description: string;
+    sameAs: string[];
+};
+/**
+ * Generate WebSite Schema with SearchAction
+ */
+declare function generateWebSiteSchema(config: SiteConfig): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    url: string;
+    description: string;
+    publisher: {
+        "@type": string;
+        name: string;
+        logo: string | undefined;
+    };
+    potentialAction: {
+        "@type": string;
+        target: string;
+        "query-input": string;
+    };
+};
+/**
+ * Generate WebPage Schema
+ */
+declare function generateWebPageSchema(data: {
+    name: string;
+    description: string;
+    url: string;
+    image?: string;
+    datePublished?: string;
+    dateModified?: string;
+    breadcrumb?: Array<{
+        name: string;
+        item: string;
+    }>;
+}, config: SiteConfig): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    description: string;
+    url: string;
+    image: string | undefined;
+    datePublished: string | undefined;
+    dateModified: string | undefined;
+    isPartOf: {
+        "@type": string;
+        name: string;
+        url: string;
+    };
+    breadcrumb: {
+        "@context": string;
+        "@type": string;
+        itemListElement: {
+            "@type": string;
+            position: number;
+            name: string;
+            item: string;
+        }[];
+    } | undefined;
+};
+/**
+ * Generate CollectionPage Schema (for category / archive pages)
+ */
+declare function generateCollectionPageSchema(data: {
+    name: string;
+    description: string;
+    url: string;
+    image?: string;
+    numberOfItems?: number;
+}, config: SiteConfig): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    description: string;
+    url: string;
+    image: string | undefined;
+    numberOfItems: number | undefined;
+    isPartOf: {
+        "@type": string;
+        name: string;
+        url: string;
+    };
+};
+/**
+ * Generate ItemList Schema (for product listings, search results, etc.)
+ *
+ * @example
+ * generateItemListSchema({
+ *   name: "Electronics",
+ *   url: "https://store.com/electronics",
+ *   items: products.map(p => ({
+ *     name: p.name,
+ *     url: `https://store.com/products/${p.slug}`,
+ *     image: p.image,
+ *     position: p.index + 1,
+ *   })),
+ * });
+ */
+declare function generateItemListSchema(data: {
+    name?: string;
+    url?: string;
+    itemListOrder?: 'ascending' | 'descending' | 'unordered';
+    items: Array<{
+        url: string;
+        name: string;
+        image?: string;
+        position?: number;
+    }>;
+}): {
+    "@context": string;
+    "@type": string;
+    name: string | undefined;
+    url: string | undefined;
+    itemListOrder: string;
+    numberOfItems: number;
+    itemListElement: {
+        "@type": string;
+        position: number;
+        name: string;
+        url: string;
+        image: string | undefined;
+    }[];
+};
+/**
+ * Generate NewsArticle Schema
+ */
+declare function generateArticleSchema(data: {
+    title: string;
+    description: string;
+    image?: string | string[];
+    publishedTime?: string;
+    modifiedTime?: string;
+    author?: {
+        name: string;
+        url?: string;
+    };
+    url?: string;
+    wordCount?: number;
+}, config: SiteConfig): {
+    "@context": string;
+    "@type": string;
+    headline: string;
+    description: string;
+    image: string | string[] | undefined;
+    datePublished: string | undefined;
+    dateModified: string | undefined;
+    mainEntityOfPage: string | undefined;
+    wordCount: number | undefined;
+    author: {
+        "@context": string;
+        "@type": string;
+        name: string;
+        url: string;
+        logo: string | undefined;
+        description: string;
+        sameAs: string[];
+    } | {
+        "@type": string;
+        name: string;
+        url: string | undefined;
+    };
+    publisher: {
+        "@context": string;
+        "@type": string;
+        name: string;
+        url: string;
+        logo: string | undefined;
+        description: string;
+        sameAs: string[];
+    };
+};
+/**
+ * Product review for use in Product schema
+ */
+interface ProductReview {
+    author: string;
+    datePublished?: string;
+    reviewBody?: string;
+    ratingValue: number;
+    bestRating?: number;
+}
+/**
+ * Merchant return policy for Product schema
+ */
+interface MerchantReturnPolicy {
+    returnPolicyCategory?: 'MerchantReturnFiniteReturnWindow' | 'MerchantReturnNotPermitted' | 'MerchantReturnUnlimitedWindow';
+    returnWithin?: number;
+    returnMethod?: 'ReturnByMail' | 'ReturnInStore' | 'ReturnAtKiosk';
+    returnFees?: 'FreeReturn' | 'ReturnFeesCustomerResponsibility' | 'OriginalShippingFees';
+}
+/**
+ * Shipping details for Product schema
+ */
+interface ShippingDetails {
+    shippingRate?: {
+        value: number;
+        currency: string;
+    };
+    shippingDestination?: string;
+    deliveryTime?: {
+        minDays: number;
+        maxDays: number;
+    };
+    freeShippingThreshold?: number;
+}
+/**
+ * Product offer variant
+ */
+interface ProductVariant {
+    name: string;
+    sku?: string;
+    price: number;
+    currency?: string;
+    availability?: string;
+    url?: string;
+    image?: string;
+}
+/**
+ * Generate Product Schema
+ * Supports multi-image, individual reviews, return policy, shipping, and variants.
+ */
+declare function generateProductSchema(data: {
+    name: string;
+    description: string;
+    image?: string | string[];
+    sku?: string;
+    gtin?: string;
+    mpn?: string;
+    brand?: string;
+    price?: number;
+    currency?: string;
+    availability?: string;
+    rating?: number;
+    reviewCount?: number;
+    url?: string;
+    condition?: 'NewCondition' | 'UsedCondition' | 'RefurbishedCondition' | 'DamagedCondition';
+    reviews?: ProductReview[];
+    returnPolicy?: MerchantReturnPolicy;
+    shipping?: ShippingDetails;
+    variants?: ProductVariant[];
+    seller?: {
+        name: string;
+        url?: string;
+    };
+}): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    description: string;
+    image: string | string[] | undefined;
+    sku: string | undefined;
+    gtin: string | undefined;
+    mpn: string | undefined;
+    brand: {
+        "@type": string;
+        name: string;
+    } | undefined;
+    offers: any;
+    aggregateRating: {
+        "@type": string;
+        ratingValue: number;
+        reviewCount: number;
+    } | undefined;
+    review: {
+        "@type": string;
+        author: {
+            "@type": string;
+            name: string;
+        };
+        datePublished: string | undefined;
+        reviewBody: string | undefined;
+        reviewRating: {
+            "@type": string;
+            ratingValue: number;
+            bestRating: number;
+        };
+    }[] | undefined;
+};
+/**
+ * Generate FAQ Schema
+ */
+declare function generateFAQSchema(questions: Array<{
+    q: string;
+    a: string;
+}>): {
+    "@context": string;
+    "@type": string;
+    mainEntity: {
+        "@type": string;
+        name: string;
+        acceptedAnswer: {
+            "@type": string;
+            text: string;
+        };
+    }[];
+};
+/**
+ * Generate Breadcrumb Schema
+ */
+declare function generateBreadcrumbSchema(items: Array<{
+    name: string;
+    item: string;
+}>): {
+    "@context": string;
+    "@type": string;
+    itemListElement: {
+        "@type": string;
+        position: number;
+        name: string;
+        item: string;
+    }[];
+};
+/**
+ * Generate Video Schema
+ */
+declare function generateVideoSchema(data: {
+    name: string;
+    description: string;
+    thumbnailUrl: string;
+    uploadDate: string;
+    duration?: string;
+    contentUrl?: string;
+    embedUrl?: string;
+}): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    description: string;
+    thumbnailUrl: string;
+    uploadDate: string;
+    duration: string | undefined;
+    contentUrl: string | undefined;
+    embedUrl: string | undefined;
+};
+/**
+ * Generate Event Schema
+ */
+declare function generateEventSchema(data: {
+    name: string;
+    description: string;
+    startDate: string;
+    endDate?: string;
+    location?: {
+        name: string;
+        address: string;
+    } | {
+        url: string;
+    };
+    image?: string;
+    offers?: {
+        price: number;
+        currency: string;
+        url: string;
+    };
+}): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    description: string;
+    startDate: string;
+    endDate: string | undefined;
+    eventAttendanceMode: string;
+    location: {
+        "@type": string;
+        url: string;
+        name?: undefined;
+        address?: undefined;
+    } | {
+        "@type": string;
+        name: string;
+        address: string;
+        url?: undefined;
+    } | undefined;
+    image: string | undefined;
+    offers: {
+        "@type": string;
+        price: number;
+        priceCurrency: string;
+        url: string;
+    } | undefined;
+};
+/**
+ * Generate LocalBusiness Schema
+ */
+declare function generateLocalBusinessSchema(data: {
+    name: string;
+    description: string;
+    image?: string;
+    telephone?: string;
+    address: {
+        street: string;
+        city: string;
+        region?: string;
+        postalCode?: string;
+        country: string;
+    };
+    geo?: {
+        lat: number;
+        lng: number;
+    };
+    openingHours?: string[];
+    priceRange?: string;
+}): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    description: string;
+    image: string | undefined;
+    telephone: string | undefined;
+    address: {
+        "@type": string;
+        streetAddress: string;
+        addressLocality: string;
+        addressRegion: string | undefined;
+        postalCode: string | undefined;
+        addressCountry: string;
+    };
+    geo: {
+        "@type": string;
+        latitude: number;
+        longitude: number;
+    } | undefined;
+    openingHours: string[] | undefined;
+    priceRange: string | undefined;
+};
+/**
+ * Generate SoftwareApplication Schema
+ */
+declare function generateSoftwareSchema(data: {
+    name: string;
+    description: string;
+    operatingSystem?: string;
+    applicationCategory?: string;
+    offers?: {
+        price: number;
+        currency: string;
+    };
+    rating?: number;
+    reviewCount?: number;
+    downloadUrl?: string;
+    screenshot?: string;
+}): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    description: string;
+    operatingSystem: string | undefined;
+    applicationCategory: string | undefined;
+    offers: {
+        "@type": string;
+        price: number;
+        priceCurrency: string;
+    } | undefined;
+    aggregateRating: {
+        "@type": string;
+        ratingValue: number;
+        reviewCount: number;
+    } | undefined;
+    downloadUrl: string | undefined;
+    screenshot: string | undefined;
+};
+/**
+ * Generate Book Schema
+ */
+declare function generateBookSchema(data: {
+    name: string;
+    author: string | {
+        name: string;
+        url?: string;
+    };
+    description: string;
+    isbn?: string;
+    numberOfPages?: number;
+    publisher?: string;
+    datePublished?: string;
+    image?: string;
+    inLanguage?: string;
+    genre?: string;
+}): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    author: {
+        "@type": string;
+        name: string;
+        url?: undefined;
+    } | {
+        "@type": string;
+        name: string;
+        url: string | undefined;
+    };
+    description: string;
+    isbn: string | undefined;
+    numberOfPages: number | undefined;
+    publisher: {
+        "@type": string;
+        name: string;
+    } | undefined;
+    datePublished: string | undefined;
+    image: string | undefined;
+    inLanguage: string | undefined;
+    genre: string | undefined;
+};
+/**
+ * Generate Movie Schema
+ */
+declare function generateMovieSchema(data: {
+    name: string;
+    description: string;
+    image?: string;
+    director?: string;
+    actor?: string[];
+    dateCreated?: string;
+    duration?: string;
+    genre?: string[];
+    rating?: number;
+    reviewCount?: number;
+}): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    description: string;
+    image: string | undefined;
+    director: {
+        "@type": string;
+        name: string;
+    } | undefined;
+    actor: {
+        "@type": string;
+        name: string;
+    }[] | undefined;
+    dateCreated: string | undefined;
+    duration: string | undefined;
+    genre: string[] | undefined;
+    aggregateRating: {
+        "@type": string;
+        ratingValue: number;
+        reviewCount: number;
+    } | undefined;
+};
+/**
+ * Generate Podcast Schema (PodcastSeries)
+ */
+declare function generatePodcastSchema(data: {
+    name: string;
+    description: string;
+    image?: string;
+    author?: string;
+    webFeed?: string;
+    url?: string;
+    genre?: string;
+}): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    description: string;
+    image: string | undefined;
+    author: {
+        "@type": string;
+        name: string;
+    } | undefined;
+    webFeed: string | undefined;
+    url: string | undefined;
+    genre: string | undefined;
+};
+/**
+ * Generate PodcastEpisode Schema
+ */
+declare function generatePodcastEpisodeSchema(data: {
+    name: string;
+    description: string;
+    datePublished: string;
+    duration?: string;
+    url?: string;
+    audio?: string;
+    partOfSeries?: {
+        name: string;
+        url: string;
+    };
+}): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    description: string;
+    datePublished: string;
+    timeRequired: string | undefined;
+    url: string | undefined;
+    associatedMedia: {
+        "@type": string;
+        contentUrl: string;
+    } | undefined;
+    partOfSeries: {
+        "@type": string;
+        name: string;
+        url: string;
+    } | undefined;
+};
+/**
+ * Generate HowTo Schema
+ */
+declare function generateHowToSchema(data: {
+    name: string;
+    description?: string;
+    image?: string;
+    totalTime?: string;
+    estimatedCost?: {
+        currency: string;
+        value: number;
+    };
+    supply?: string[];
+    tool?: string[];
+    steps: Array<{
+        name?: string;
+        text: string;
+        image?: string;
+        url?: string;
+    }> | string[];
+}): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    description: string | undefined;
+    image: string | undefined;
+    totalTime: string | undefined;
+    estimatedCost: {
+        "@type": string;
+        currency: string;
+        value: number;
+    } | undefined;
+    supply: {
+        "@type": string;
+        name: string;
+    }[] | undefined;
+    tool: {
+        "@type": string;
+        name: string;
+    }[] | undefined;
+    step: ({
+        "@type": string;
+        position: number;
+        name: string | undefined;
+        text: string;
+        image: string | undefined;
+        url: string | undefined;
+    } | {
+        "@type": string;
+        position: number;
+        text: string;
+    })[];
+};
+/**
+ * Generate Recipe Schema
+ */
+declare function generateRecipeSchema(data: {
+    name: string;
+    description: string;
+    image: string | string[];
+    author: string;
+    publishedDate?: string;
+    prepTime?: string;
+    cookTime?: string;
+    totalTime?: string;
+    recipeYield?: string;
+    recipeCategory?: string;
+    recipeCuisine?: string;
+    ingredients: string[];
+    instructions: Array<{
+        name?: string;
+        text: string;
+        image?: string;
+    }>;
+    rating?: number;
+    reviewCount?: number;
+}): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    description: string;
+    image: string | string[];
+    author: {
+        "@type": string;
+        name: string;
+    };
+    datePublished: string | undefined;
+    prepTime: string | undefined;
+    cookTime: string | undefined;
+    totalTime: string | undefined;
+    recipeYield: string | undefined;
+    recipeCategory: string | undefined;
+    recipeCuisine: string | undefined;
+    recipeIngredient: string[];
+    recipeInstructions: {
+        "@type": string;
+        name: string | undefined;
+        text: string;
+        image: string | undefined;
+    }[];
+    aggregateRating: {
+        "@type": string;
+        ratingValue: number;
+        reviewCount: number;
+    } | undefined;
+};
+/**
+ * Generate JobPosting Schema
+ */
+declare function generateJobPostingSchema(data: {
+    title: string;
+    description: string;
+    datePosted: string;
+    validThrough?: string;
+    employmentType?: string | string[];
+    hiringOrganization: {
+        name: string;
+        sameAs?: string;
+        logo?: string;
+    };
+    jobLocation: {
+        streetAddress: string;
+        addressLocality: string;
+        addressRegion?: string;
+        postalCode?: string;
+        addressCountry: string;
+    };
+    remote?: boolean;
+    baseSalary?: {
+        currency: string;
+        value: number | {
+            minValue: number;
+            maxValue: number;
+        };
+        unitText?: string;
+    };
+}): {
+    "@context": string;
+    "@type": string;
+    title: string;
+    description: string;
+    datePosted: string;
+    validThrough: string | undefined;
+    employmentType: string | string[] | undefined;
+    jobLocationType: string | undefined;
+    hiringOrganization: {
+        "@type": string;
+        name: string;
+        sameAs: string | undefined;
+        logo: string | undefined;
+    };
+    jobLocation: {
+        "@type": string;
+        address: {
+            "@type": string;
+            streetAddress: string;
+            addressLocality: string;
+            addressRegion: string | undefined;
+            postalCode: string | undefined;
+            addressCountry: string;
+        };
+    };
+    baseSalary: {
+        "@type": string;
+        currency: string;
+        value: {
+            "@type": string;
+            value: number;
+            unitText: string;
+            minValue?: undefined;
+            maxValue?: undefined;
+        } | {
+            "@type": string;
+            minValue: number;
+            maxValue: number;
+            unitText: string;
+            value?: undefined;
+        };
+    } | undefined;
+};
+
+/**
+ * Converts SEOData and SiteConfig to a Next.js compatible Metadata object.
+ * This is designed to be used in Server Components (App Router).
+ *
+ * @example
+ * // In page.tsx (Server Component - no 'use client')
+ * import { toNextMetadata } from '@masters-ws/react-seo/core';
+ *
+ * export async function generateMetadata({ params }) {
+ *   const post = await getPost(params.id);
+ *   return toNextMetadata({ title: post.title, ... }, siteConfig);
+ * }
+ */
+declare function toNextMetadata(props: SEOData, config: SiteConfig): any;
+/**
+ * Generates pagination links for category/tag pages.
+ * Returns { prev, next, canonical } URLs.
+ */
+declare function generatePaginationLinks(baseUrl: string, currentPage: number, totalPages: number): {
+    next: string | undefined;
+    prev: string | undefined;
+    canonical: string;
+};
+/**
+ * Generates title with page number suffix for paginated pages.
+ */
+declare function generatePaginatedTitle(title: string, page: number, suffix?: string): string;
+
+/**
+ * Deep-cleans a schema object by removing all undefined and null values.
+ * This prevents invalid JSON-LD output like {"sku": undefined}.
+ *
+ * @example
+ * const schema = cleanSchema({
+ *   "@type": "Product",
+ *   "name": "Shirt",
+ *   "sku": undefined,      // ← removed
+ *   "brand": null,          // ← removed
+ *   "offers": {
+ *     "@type": "Offer",
+ *     "price": 29.99,
+ *     "seller": undefined   // ← removed
+ *   }
+ * });
+ */
+declare function cleanSchema<T extends Record<string, any>>(obj: T): T;
+/**
+ * SEO validation warnings for development mode.
+ * Only logs in development (process.env.NODE_ENV !== 'production').
+ *
+ * @example
+ * validateSEO('Product', {
+ *   name: product.name,
+ *   price: product.price,
+ * }, ['name', 'price', 'image']);
+ */
+declare function validateSEO(schemaType: string, data: Record<string, any>, requiredFields: string[]): string[];
+
+/**
+ * Server-safe JSON-LD component for Next.js App Router.
+ * Renders schema markup as <script type="application/ld+json"> in server-rendered HTML.
+ *
+ * Unlike Helmet-based components, this works in Server Components,
+ * so Google sees the schemas on first crawl without JavaScript execution.
+ *
+ * @example
+ * // Single schema
+ * <JsonLd schema={productSchema} />
+ *
+ * // Multiple schemas (separate <script> tags)
+ * <JsonLd schema={[productSchema, breadcrumbSchema]} />
+ *
+ * // Multiple schemas using @graph pattern (single <script> tag — recommended)
+ * <JsonLd schema={[productSchema, breadcrumbSchema]} graph />
+ */
+interface JsonLdProps {
+    /** A single schema object or an array of schema objects */
+    schema: Record<string, any> | Record<string, any>[];
+    /**
+     * If true, combines all schemas into a single <script> using the @graph pattern.
+     * This is Google's recommended approach for pages with multiple related schemas.
+     *
+     * When graph is true, individual @context properties are removed from each schema
+     * and a single @context is added at the top level.
+     *
+     * @default false
+     */
+    graph?: boolean;
+}
+declare function JsonLd({ schema, graph }: JsonLdProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Product metadata input for convenience helper
+ */
+interface ProductMetadataInput {
+    name: string;
+    description: string;
+    image?: string | string[];
+    sku?: string;
+    gtin?: string;
+    mpn?: string;
+    brand?: string;
+    price?: number;
+    currency?: string;
+    availability?: string;
+    rating?: number;
+    reviewCount?: number;
+    url: string;
+    condition?: 'NewCondition' | 'UsedCondition' | 'RefurbishedCondition' | 'DamagedCondition';
+    metaTitle?: string;
+    metaDescription?: string;
+    canonical?: string;
+    noindex?: boolean;
+    breadcrumbs?: Array<{
+        name: string;
+        item: string;
+    }>;
+    category?: string;
+    ogImage?: string;
+    ogImageWidth?: number;
+    ogImageHeight?: number;
+    reviews?: ProductReview[];
+    returnPolicy?: MerchantReturnPolicy;
+    shipping?: ShippingDetails;
+    variants?: ProductVariant[];
+    seller?: {
+        name: string;
+        url?: string;
+    };
+}
+/**
+ * Result from generateProductMetadata
+ */
+interface ProductMetadataResult {
+    /** Next.js Metadata object - use as return from generateMetadata() */
+    metadata: any;
+    /** All JSON-LD schemas for the product page */
+    schemas: Record<string, any>[];
+    /** Individual schemas for granular control */
+    productSchema: Record<string, any>;
+    breadcrumbSchema: Record<string, any>;
+    organizationSchema: Record<string, any>;
+    websiteSchema: Record<string, any>;
+}
+/**
+ * All-in-one helper for product pages in Next.js App Router.
+ * Generates both the Metadata object AND all JSON-LD schemas in one call.
+ *
+ * @example
+ * ```tsx
+ * // app/products/[slug]/page.tsx (Server Component)
+ * import { generateProductMetadata, JsonLd } from '@masters-ws/react-seo/core';
+ *
+ * const siteConfig = { name: 'My Store', url: 'https://store.com', ... };
+ *
+ * export async function generateMetadata({ params }) {
+ *   const product = await fetchProduct(params.slug);
+ *   const { metadata } = generateProductMetadata(product, siteConfig);
+ *   return metadata;
+ * }
+ *
+ * export default async function ProductPage({ params }) {
+ *   const product = await fetchProduct(params.slug);
+ *   const { schemas } = generateProductMetadata(product, siteConfig);
+ *   return (
+ *     <>
+ *       <JsonLd schema={schemas} graph />
+ *       <ProductDetailClient product={product} />
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+declare function generateProductMetadata(product: ProductMetadataInput, config: SiteConfig): ProductMetadataResult;
+
+/**
+ * Article metadata input for convenience helper
+ */
+interface ArticleMetadataInput {
+    title: string;
+    description: string;
+    image?: string | string[];
+    publishedTime: string;
+    modifiedTime?: string;
+    author?: {
+        name: string;
+        url?: string;
+        image?: string;
+    };
+    url: string;
+    category?: string;
+    tags?: string[];
+    readingTime?: number;
+    wordCount?: number;
+    metaTitle?: string;
+    metaDescription?: string;
+    canonical?: string;
+    noindex?: boolean;
+    breadcrumbs?: Array<{
+        name: string;
+        item: string;
+    }>;
+    ogImage?: string;
+    ogImageWidth?: number;
+    ogImageHeight?: number;
+}
+/**
+ * Result from generateArticleMetadata
+ */
+interface ArticleMetadataResult {
+    /** Next.js Metadata object - use as return from generateMetadata() */
+    metadata: any;
+    /** All JSON-LD schemas for the article page */
+    schemas: Record<string, any>[];
+    /** Individual schemas for granular control */
+    articleSchema: Record<string, any>;
+    breadcrumbSchema: Record<string, any>;
+    organizationSchema: Record<string, any>;
+    websiteSchema: Record<string, any>;
+}
+/**
+ * All-in-one helper for article pages in Next.js App Router.
+ * Generates both the Metadata object AND all JSON-LD schemas in one call.
+ *
+ * @example
+ * ```tsx
+ * // app/news/[slug]/page.tsx (Server Component)
+ * import { generateArticleMetadata, JsonLd } from '@masters-ws/react-seo/core';
+ *
+ * export async function generateMetadata({ params }) {
+ *   const article = await fetchArticle(params.slug);
+ *   const { metadata } = generateArticleMetadata(article, siteConfig);
+ *   return metadata;
+ * }
+ *
+ * export default async function ArticlePage({ params }) {
+ *   const article = await fetchArticle(params.slug);
+ *   const { schemas } = generateArticleMetadata(article, siteConfig);
+ *   return (
+ *     <>
+ *       <JsonLd schema={schemas} graph />
+ *       <article>...</article>
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+declare function generateArticleMetadata(article: ArticleMetadataInput, config: SiteConfig): ArticleMetadataResult;
+
+/**
+ * Category/Collection metadata input
+ */
+interface CategoryMetadataInput {
+    name: string;
+    description: string;
+    image?: string;
+    url: string;
+    page?: number;
+    totalPages?: number;
+    metaTitle?: string;
+    metaDescription?: string;
+    noindex?: boolean;
+    breadcrumbs?: Array<{
+        name: string;
+        item: string;
+    }>;
+    parentCategory?: string;
+    items?: Array<{
+        url: string;
+        name: string;
+        image?: string;
+        position?: number;
+    }>;
+    pageSuffix?: string;
+}
+/**
+ * Result from generateCategoryMetadata
+ */
+interface CategoryMetadataResult {
+    /** Next.js Metadata object */
+    metadata: any;
+    /** All JSON-LD schemas */
+    schemas: Record<string, any>[];
+    /** Individual schemas */
+    collectionPageSchema: Record<string, any>;
+    breadcrumbSchema: Record<string, any>;
+    organizationSchema: Record<string, any>;
+    itemListSchema?: Record<string, any>;
+}
+/**
+ * All-in-one helper for category/collection pages in Next.js App Router.
+ * Handles pagination, ItemList schema, and CollectionPage schema.
+ *
+ * @example
+ * ```tsx
+ * // app/categories/[slug]/page.tsx (Server Component)
+ * import { generateCategoryMetadata, JsonLd } from '@masters-ws/react-seo/core';
+ *
+ * export async function generateMetadata({ params, searchParams }) {
+ *   const page = Number(searchParams.page) || 1;
+ *   const category = await fetchCategory(params.slug);
+ *   const { metadata } = generateCategoryMetadata({
+ *     name: category.name,
+ *     description: category.description,
+ *     url: `https://store.com/categories/${params.slug}`,
+ *     page,
+ *     totalPages: category.totalPages,
+ *     items: category.products.map((p, i) => ({
+ *       name: p.name,
+ *       url: `https://store.com/products/${p.slug}`,
+ *       image: p.image,
+ *       position: i + 1,
+ *     })),
+ *   }, siteConfig);
+ *   return metadata;
+ * }
+ * ```
+ */
+declare function generateCategoryMetadata(category: CategoryMetadataInput, config: SiteConfig): CategoryMetadataResult;
+
+/**
+ * Homepage metadata input
+ */
+interface HomepageMetadataInput {
+    title?: string;
+    description?: string;
+    image?: string;
+    canonical?: string;
+    ogImage?: string;
+    ogImageWidth?: number;
+    ogImageHeight?: number;
+    localBusiness?: {
+        name: string;
+        description: string;
+        image?: string;
+        telephone?: string;
+        address: {
+            street: string;
+            city: string;
+            region?: string;
+            postalCode?: string;
+            country: string;
+        };
+        geo?: {
+            lat: number;
+            lng: number;
+        };
+        openingHours?: string[];
+        priceRange?: string;
+    };
+    socialLinks?: string[];
+}
+/**
+ * Result from generateHomepageMetadata
+ */
+interface HomepageMetadataResult {
+    /** Next.js Metadata object */
+    metadata: any;
+    /** All JSON-LD schemas */
+    schemas: Record<string, any>[];
+    /** Individual schemas */
+    webPageSchema: Record<string, any>;
+    organizationSchema: Record<string, any>;
+    websiteSchema: Record<string, any>;
+    localBusinessSchema?: Record<string, any>;
+}
+/**
+ * All-in-one helper for homepage / landing pages in Next.js App Router.
+ *
+ * @example
+ * ```tsx
+ * // app/page.tsx (Homepage — Server Component)
+ * import { generateHomepageMetadata, JsonLd } from '@masters-ws/react-seo/core';
+ *
+ * const siteConfig = {
+ *   name: "My Company",
+ *   url: "https://mycompany.com",
+ *   description: "We build amazing things",
+ *   logo: "https://mycompany.com/logo.png",
+ * };
+ *
+ * export async function generateMetadata() {
+ *   const { metadata } = generateHomepageMetadata({}, siteConfig);
+ *   return metadata;
+ * }
+ *
+ * export default function HomePage() {
+ *   const { schemas } = generateHomepageMetadata({}, siteConfig);
+ *   return (
+ *     <>
+ *       <JsonLd schema={schemas} graph />
+ *       <main>...</main>
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+declare function generateHomepageMetadata(input: HomepageMetadataInput, config: SiteConfig): HomepageMetadataResult;
+
+export { type ArticleMetadataInput as A, type BreadcrumbItem as B, type CategoryMetadataInput as C, generatePaginationLinks as D, generatePodcastEpisodeSchema as E, generatePodcastSchema as F, generateProductMetadata as G, type HomepageMetadataInput as H, generateProductSchema as I, JsonLd as J, generateRecipeSchema as K, generateSoftwareSchema as L, type MerchantReturnPolicy as M, generateVideoSchema as N, generateWebPageSchema as O, type ProductMetadataInput as P, generateWebSiteSchema as Q, toNextMetadata as R, type SiteConfig as S, validateSEO as T, type SEOData as a, type ArticleMetadataResult as b, type CategoryMetadataResult as c, type HomepageMetadataResult as d, type JsonLdProps as e, type ProductMetadataResult as f, type ProductReview as g, type ProductVariant as h, type ShippingDetails as i, cleanSchema as j, generateArticleMetadata as k, generateArticleSchema as l, generateBookSchema as m, generateBreadcrumbSchema as n, generateCategoryMetadata as o, generateCollectionPageSchema as p, generateEventSchema as q, generateFAQSchema as r, generateHomepageMetadata as s, generateHowToSchema as t, generateItemListSchema as u, generateJobPostingSchema as v, generateLocalBusinessSchema as w, generateMovieSchema as x, generateOrganizationSchema as y, generatePaginatedTitle as z };