@masters-ws/react-seo 1.2.0 → 1.4.0

package/dist/core/index.js

@@ -20,11 +20,20 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/core/index.ts
 var core_exports = {};
 __export(core_exports, {
+  JsonLd: () => JsonLd,
+  cleanSchema: () => cleanSchema,
+  generateArticleMetadata: () => generateArticleMetadata,
   generateArticleSchema: () => generateArticleSchema,
   generateBookSchema: () => generateBookSchema,
   generateBreadcrumbSchema: () => generateBreadcrumbSchema,
+  generateCategoryMetadata: () => generateCategoryMetadata,
+  generateCollectionPageSchema: () => generateCollectionPageSchema,
   generateEventSchema: () => generateEventSchema,
   generateFAQSchema: () => generateFAQSchema,
+  generateHomepageMetadata: () => generateHomepageMetadata,
+  generateHowToSchema: () => generateHowToSchema,
+  generateItemListSchema: () => generateItemListSchema,
+  generateJobPostingSchema: () => generateJobPostingSchema,
   generateLocalBusinessSchema: () => generateLocalBusinessSchema,
   generateMovieSchema: () => generateMovieSchema,
   generateOrganizationSchema: () => generateOrganizationSchema,
@@ -32,82 +41,266 @@ __export(core_exports, {
   generatePaginationLinks: () => generatePaginationLinks,
   generatePodcastEpisodeSchema: () => generatePodcastEpisodeSchema,
   generatePodcastSchema: () => generatePodcastSchema,
+  generateProductMetadata: () => generateProductMetadata,
   generateProductSchema: () => generateProductSchema,
+  generateRecipeSchema: () => generateRecipeSchema,
   generateSoftwareSchema: () => generateSoftwareSchema,
   generateVideoSchema: () => generateVideoSchema,
+  generateWebPageSchema: () => generateWebPageSchema,
   generateWebSiteSchema: () => generateWebSiteSchema,
-  toNextMetadata: () => toNextMetadata
+  toNextMetadata: () => toNextMetadata,
+  validateSEO: () => validateSEO
 });
 module.exports = __toCommonJS(core_exports);
 
+// src/core/utils.ts
+function cleanSchema(obj) {
+  if (Array.isArray(obj)) {
+    return obj.filter((item) => item !== void 0 && item !== null).map((item) => typeof item === "object" ? cleanSchema(item) : item);
+  }
+  const cleaned = {};
+  for (const [key, value] of Object.entries(obj)) {
+    if (value === void 0 || value === null) continue;
+    if (Array.isArray(value)) {
+      const cleanedArr = value.filter((item) => item !== void 0 && item !== null).map((item) => typeof item === "object" && item !== null ? cleanSchema(item) : item);
+      if (cleanedArr.length > 0) {
+        cleaned[key] = cleanedArr;
+      }
+    } else if (typeof value === "object") {
+      cleaned[key] = cleanSchema(value);
+    } else {
+      cleaned[key] = value;
+    }
+  }
+  return cleaned;
+}
+function validateSEO(schemaType, data, requiredFields) {
+  const warnings = [];
+  for (const field of requiredFields) {
+    const value = data[field];
+    if (value === void 0 || value === null || value === "") {
+      warnings.push(`[react-seo] Warning: "${field}" is missing in ${schemaType} schema. Google may not show rich results.`);
+    }
+  }
+  if (warnings.length > 0 && typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" && globalThis.process.env?.NODE_ENV !== "production") {
+    warnings.forEach((w) => console.warn(w));
+  }
+  return warnings;
+}
+
 // src/core/schemas.ts
 function generateOrganizationSchema(config) {
-  return {
+  return cleanSchema({
     "@context": "https://schema.org",
     "@type": "Organization",
     "name": config.name,
     "url": config.url,
     "logo": config.logo,
+    "description": config.description,
     "sameAs": config.socialLinks || []
-  };
+  });
 }
 function generateWebSiteSchema(config) {
-  return {
+  return cleanSchema({
     "@context": "https://schema.org",
     "@type": "WebSite",
     "name": config.name,
     "url": config.url,
+    "description": config.description,
+    "publisher": {
+      "@type": "Organization",
+      "name": config.name,
+      "logo": config.logo
+    },
     "potentialAction": {
       "@type": "SearchAction",
       "target": `${config.url}/search?q={search_term_string}`,
       "query-input": "required name=search_term_string"
     }
-  };
+  });
+}
+function generateWebPageSchema(data, config) {
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "WebPage",
+    "name": data.name,
+    "description": data.description,
+    "url": data.url,
+    "image": data.image,
+    "datePublished": data.datePublished,
+    "dateModified": data.dateModified,
+    "isPartOf": {
+      "@type": "WebSite",
+      "name": config.name,
+      "url": config.url
+    },
+    "breadcrumb": data.breadcrumb ? generateBreadcrumbSchema(data.breadcrumb) : void 0
+  });
+}
+function generateCollectionPageSchema(data, config) {
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "CollectionPage",
+    "name": data.name,
+    "description": data.description,
+    "url": data.url,
+    "image": data.image,
+    "numberOfItems": data.numberOfItems,
+    "isPartOf": {
+      "@type": "WebSite",
+      "name": config.name,
+      "url": config.url
+    }
+  });
+}
+function generateItemListSchema(data) {
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "ItemList",
+    "name": data.name,
+    "url": data.url,
+    "itemListOrder": data.itemListOrder === "ascending" ? "https://schema.org/ItemListOrderAscending" : data.itemListOrder === "descending" ? "https://schema.org/ItemListOrderDescending" : "https://schema.org/ItemListUnordered",
+    "numberOfItems": data.items.length,
+    "itemListElement": data.items.map((item, index) => ({
+      "@type": "ListItem",
+      "position": item.position || index + 1,
+      "name": item.name,
+      "url": item.url,
+      "image": item.image
+    }))
+  });
 }
 function generateArticleSchema(data, config) {
+  validateSEO("NewsArticle", data, ["title", "description", "image", "publishedTime", "author"]);
   const org = generateOrganizationSchema(config);
-  return {
+  return cleanSchema({
     "@context": "https://schema.org",
     "@type": "NewsArticle",
     "headline": data.title,
     "description": data.description,
-    "image": data.image || config.logo,
+    "image": data.image,
     "datePublished": data.publishedTime,
     "dateModified": data.modifiedTime || data.publishedTime,
     "mainEntityOfPage": data.url,
+    "wordCount": data.wordCount,
     "author": data.author ? {
       "@type": "Person",
       "name": data.author.name,
       "url": data.author.url
     } : org,
     "publisher": org
-  };
+  });
 }
 function generateProductSchema(data) {
-  return {
+  validateSEO("Product", data, ["name", "description", "image", "price"]);
+  let offers;
+  if (data.variants && data.variants.length > 0) {
+    const prices = data.variants.map((v) => v.price);
+    offers = {
+      "@type": "AggregateOffer",
+      "lowPrice": Math.min(...prices),
+      "highPrice": Math.max(...prices),
+      "priceCurrency": data.currency || data.variants[0]?.currency || "USD",
+      "offerCount": data.variants.length,
+      "offers": data.variants.map((v) => cleanSchema({
+        "@type": "Offer",
+        "name": v.name,
+        "sku": v.sku,
+        "price": v.price,
+        "priceCurrency": v.currency || data.currency || "USD",
+        "availability": v.availability || data.availability || "https://schema.org/InStock",
+        "url": v.url || data.url,
+        "image": v.image,
+        "itemCondition": data.condition ? `https://schema.org/${data.condition}` : void 0
+      }))
+    };
+  } else {
+    offers = cleanSchema({
+      "@type": "Offer",
+      "url": data.url,
+      "priceCurrency": data.currency || "USD",
+      "price": data.price,
+      "availability": data.availability || "https://schema.org/InStock",
+      "itemCondition": data.condition ? `https://schema.org/${data.condition}` : void 0,
+      "seller": data.seller ? {
+        "@type": "Organization",
+        "name": data.seller.name,
+        "url": data.seller.url
+      } : void 0,
+      "hasMerchantReturnPolicy": data.returnPolicy ? cleanSchema({
+        "@type": "MerchantReturnPolicy",
+        "applicableCountry": data.shipping?.shippingDestination,
+        "returnPolicyCategory": data.returnPolicy.returnPolicyCategory ? `https://schema.org/${data.returnPolicy.returnPolicyCategory}` : "https://schema.org/MerchantReturnFiniteReturnWindow",
+        "merchantReturnDays": data.returnPolicy.returnWithin,
+        "returnMethod": data.returnPolicy.returnMethod ? `https://schema.org/${data.returnPolicy.returnMethod}` : void 0,
+        "returnFees": data.returnPolicy.returnFees ? `https://schema.org/${data.returnPolicy.returnFees}` : void 0
+      }) : void 0,
+      "shippingDetails": data.shipping ? cleanSchema({
+        "@type": "OfferShippingDetails",
+        "shippingRate": data.shipping.shippingRate ? {
+          "@type": "MonetaryAmount",
+          "value": data.shipping.shippingRate.value,
+          "currency": data.shipping.shippingRate.currency
+        } : void 0,
+        "shippingDestination": data.shipping.shippingDestination ? {
+          "@type": "DefinedRegion",
+          "addressCountry": data.shipping.shippingDestination
+        } : void 0,
+        "deliveryTime": data.shipping.deliveryTime ? {
+          "@type": "ShippingDeliveryTime",
+          "handlingTime": {
+            "@type": "QuantitativeValue",
+            "minValue": 0,
+            "maxValue": 1,
+            "unitCode": "DAY"
+          },
+          "transitTime": {
+            "@type": "QuantitativeValue",
+            "minValue": data.shipping.deliveryTime.minDays,
+            "maxValue": data.shipping.deliveryTime.maxDays,
+            "unitCode": "DAY"
+          }
+        } : void 0,
+        "freeShippingThreshold": data.shipping.freeShippingThreshold ? {
+          "@type": "MonetaryAmount",
+          "value": data.shipping.freeShippingThreshold,
+          "currency": data.shipping.shippingRate?.currency || data.currency || "USD"
+        } : void 0
+      }) : void 0
+    });
+  }
+  const reviewList = data.reviews?.map((r) => cleanSchema({
+    "@type": "Review",
+    "author": { "@type": "Person", "name": r.author },
+    "datePublished": r.datePublished,
+    "reviewBody": r.reviewBody,
+    "reviewRating": {
+      "@type": "Rating",
+      "ratingValue": r.ratingValue,
+      "bestRating": r.bestRating || 5
+    }
+  }));
+  return cleanSchema({
     "@context": "https://schema.org",
     "@type": "Product",
     "name": data.name,
     "description": data.description,
     "image": data.image,
     "sku": data.sku,
+    "gtin": data.gtin,
+    "mpn": data.mpn,
     "brand": data.brand ? { "@type": "Brand", "name": data.brand } : void 0,
-    "offers": {
-      "@type": "Offer",
-      "url": data.url,
-      "priceCurrency": data.currency || "USD",
-      "price": data.price,
-      "availability": data.availability || "https://schema.org/InStock"
-    },
+    "offers": offers,
     "aggregateRating": data.rating ? {
       "@type": "AggregateRating",
       "ratingValue": data.rating,
       "reviewCount": data.reviewCount || 1
-    } : void 0
-  };
+    } : void 0,
+    "review": reviewList && reviewList.length > 0 ? reviewList : void 0
+  });
 }
 function generateFAQSchema(questions) {
-  return {
+  return cleanSchema({
     "@context": "https://schema.org",
     "@type": "FAQPage",
     "mainEntity": questions.map((item) => ({
@@ -118,10 +311,10 @@ function generateFAQSchema(questions) {
         "text": item.a
       }
     }))
-  };
+  });
 }
 function generateBreadcrumbSchema(items) {
-  return {
+  return cleanSchema({
     "@context": "https://schema.org",
     "@type": "BreadcrumbList",
     "itemListElement": items.map((item, index) => ({
@@ -130,10 +323,11 @@ function generateBreadcrumbSchema(items) {
       "name": item.name,
       "item": item.item
     }))
-  };
+  });
 }
 function generateVideoSchema(data) {
-  return {
+  validateSEO("VideoObject", data, ["name", "description", "thumbnailUrl", "uploadDate"]);
+  return cleanSchema({
     "@context": "https://schema.org",
     "@type": "VideoObject",
     "name": data.name,
@@ -143,11 +337,11 @@ function generateVideoSchema(data) {
     "duration": data.duration,
     "contentUrl": data.contentUrl,
     "embedUrl": data.embedUrl
-  };
+  });
 }
 function generateEventSchema(data) {
   const isOnline = data.location && "url" in data.location;
-  return {
+  return cleanSchema({
     "@context": "https://schema.org",
     "@type": "Event",
     "name": data.name,
@@ -170,10 +364,10 @@ function generateEventSchema(data) {
       "priceCurrency": data.offers.currency,
       "url": data.offers.url
     } : void 0
-  };
+  });
 }
 function generateLocalBusinessSchema(data) {
-  return {
+  return cleanSchema({
     "@context": "https://schema.org",
     "@type": "LocalBusiness",
     "name": data.name,
@@ -195,10 +389,10 @@ function generateLocalBusinessSchema(data) {
     } : void 0,
     "openingHours": data.openingHours,
     "priceRange": data.priceRange
-  };
+  });
 }
 function generateSoftwareSchema(data) {
-  return {
+  return cleanSchema({
     "@context": "https://schema.org",
     "@type": "SoftwareApplication",
     "name": data.name,
@@ -217,10 +411,10 @@ function generateSoftwareSchema(data) {
     } : void 0,
     "downloadUrl": data.downloadUrl,
     "screenshot": data.screenshot
-  };
+  });
 }
 function generateBookSchema(data) {
-  return {
+  return cleanSchema({
     "@context": "https://schema.org",
     "@type": "Book",
     "name": data.name,
@@ -243,10 +437,10 @@ function generateBookSchema(data) {
     "image": data.image,
     "inLanguage": data.inLanguage,
     "genre": data.genre
-  };
+  });
 }
 function generateMovieSchema(data) {
-  return {
+  return cleanSchema({
     "@context": "https://schema.org",
     "@type": "Movie",
     "name": data.name,
@@ -268,10 +462,10 @@ function generateMovieSchema(data) {
       "ratingValue": data.rating,
       "reviewCount": data.reviewCount || 1
     } : void 0
-  };
+  });
 }
 function generatePodcastSchema(data) {
-  return {
+  return cleanSchema({
     "@context": "https://schema.org",
     "@type": "PodcastSeries",
     "name": data.name,
@@ -284,10 +478,10 @@ function generatePodcastSchema(data) {
     "webFeed": data.webFeed,
     "url": data.url,
     "genre": data.genre
-  };
+  });
 }
 function generatePodcastEpisodeSchema(data) {
-  return {
+  return cleanSchema({
     "@context": "https://schema.org",
     "@type": "PodcastEpisode",
     "name": data.name,
@@ -304,7 +498,109 @@ function generatePodcastEpisodeSchema(data) {
       "name": data.partOfSeries.name,
       "url": data.partOfSeries.url
     } : void 0
-  };
+  });
+}
+function generateHowToSchema(data) {
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "HowTo",
+    "name": data.name,
+    "description": data.description,
+    "image": data.image,
+    "totalTime": data.totalTime,
+    "estimatedCost": data.estimatedCost ? {
+      "@type": "MonetaryAmount",
+      "currency": data.estimatedCost.currency,
+      "value": data.estimatedCost.value
+    } : void 0,
+    "supply": data.supply?.map((s) => ({ "@type": "HowToSupply", "name": s })),
+    "tool": data.tool?.map((t) => ({ "@type": "HowToTool", "name": t })),
+    "step": data.steps.map((step, index) => {
+      if (typeof step === "string") {
+        return { "@type": "HowToStep", "position": index + 1, "text": step };
+      }
+      return cleanSchema({
+        "@type": "HowToStep",
+        "position": index + 1,
+        "name": step.name,
+        "text": step.text,
+        "image": step.image,
+        "url": step.url
+      });
+    })
+  });
+}
+function generateRecipeSchema(data) {
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "Recipe",
+    "name": data.name,
+    "description": data.description,
+    "image": data.image,
+    "author": { "@type": "Person", "name": data.author },
+    "datePublished": data.publishedDate,
+    "prepTime": data.prepTime,
+    "cookTime": data.cookTime,
+    "totalTime": data.totalTime,
+    "recipeYield": data.recipeYield,
+    "recipeCategory": data.recipeCategory,
+    "recipeCuisine": data.recipeCuisine,
+    "recipeIngredient": data.ingredients,
+    "recipeInstructions": data.instructions.map((step) => cleanSchema({
+      "@type": "HowToStep",
+      "name": step.name,
+      "text": step.text,
+      "image": step.image
+    })),
+    "aggregateRating": data.rating ? {
+      "@type": "AggregateRating",
+      "ratingValue": data.rating,
+      "reviewCount": data.reviewCount || 1
+    } : void 0
+  });
+}
+function generateJobPostingSchema(data) {
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "JobPosting",
+    "title": data.title,
+    "description": data.description,
+    "datePosted": data.datePosted,
+    "validThrough": data.validThrough,
+    "employmentType": data.employmentType,
+    "jobLocationType": data.remote ? "TELECOMMUTE" : void 0,
+    "hiringOrganization": {
+      "@type": "Organization",
+      "name": data.hiringOrganization.name,
+      "sameAs": data.hiringOrganization.sameAs,
+      "logo": data.hiringOrganization.logo
+    },
+    "jobLocation": {
+      "@type": "Place",
+      "address": {
+        "@type": "PostalAddress",
+        "streetAddress": data.jobLocation.streetAddress,
+        "addressLocality": data.jobLocation.addressLocality,
+        "addressRegion": data.jobLocation.addressRegion,
+        "postalCode": data.jobLocation.postalCode,
+        "addressCountry": data.jobLocation.addressCountry
+      }
+    },
+    "baseSalary": data.baseSalary ? {
+      "@type": "MonetaryAmount",
+      "currency": data.baseSalary.currency,
+      "value": typeof data.baseSalary.value === "number" ? {
+        "@type": "QuantitativeValue",
+        "value": data.baseSalary.value,
+        "unitText": data.baseSalary.unitText || "MONTH"
+      } : {
+        "@type": "QuantitativeValue",
+        "minValue": data.baseSalary.value.minValue,
+        "maxValue": data.baseSalary.value.maxValue,
+        "unitText": data.baseSalary.unitText || "MONTH"
+      }
+    } : void 0
+  });
 }
 
 // src/core/metadata.ts
@@ -348,6 +644,9 @@ function toNextMetadata(props, config) {
     },
     other: {}
   };
+  if (config.facebookAppId) {
+    metadata.other["fb:app_id"] = config.facebookAppId;
+  }
   if (props.alternates && props.alternates.length > 0) {
     const languages = {};
     props.alternates.forEach((alt) => {
@@ -355,6 +654,12 @@ function toNextMetadata(props, config) {
     });
     metadata.alternates.languages = languages;
   }
+  if (props.prev) {
+    metadata.alternates.prev = props.prev;
+  }
+  if (props.next) {
+    metadata.alternates.next = props.next;
+  }
   metadata.appleWebApp = {
     capable: true,
     title: config.name,
@@ -362,6 +667,45 @@ function toNextMetadata(props, config) {
   };
   if (config.themeColor) metadata.themeColor = config.themeColor;
   if (config.manifest) metadata.manifest = config.manifest;
+  if (props.type === "article") {
+    if (props.publishedTime) {
+      metadata.openGraph.publishedTime = props.publishedTime;
+    }
+    if (props.modifiedTime) {
+      metadata.openGraph.modifiedTime = props.modifiedTime;
+    }
+    if (props.author) {
+      metadata.openGraph.authors = [props.author.name];
+    }
+    if (props.section) {
+      metadata.openGraph.section = props.section;
+    }
+    if (props.tags?.length) {
+      metadata.openGraph.tags = props.tags;
+    }
+  }
+  if (props.type === "product" && props.product) {
+    if (props.product.price !== void 0 && props.product.currency) {
+      metadata.other["product:price:amount"] = props.product.price.toString();
+      metadata.other["product:price:currency"] = props.product.currency;
+    }
+    if (props.product.availability) {
+      metadata.other["product:availability"] = props.product.availability;
+    }
+    if (props.product.brand) {
+      metadata.other["product:brand"] = props.product.brand;
+    }
+  }
+  if (props.readingTime) {
+    metadata.other["twitter:label1"] = "Reading time";
+    metadata.other["twitter:data1"] = `${props.readingTime} min`;
+  }
+  if (props.whatsappImage) {
+    metadata.other["og:image:secure_url"] = props.whatsappImage;
+  }
+  if (Object.keys(metadata.other).length === 0) {
+    delete metadata.other;
+  }
   return metadata;
 }
 function generatePaginationLinks(baseUrl, currentPage, totalPages) {
@@ -374,16 +718,312 @@ function generatePaginationLinks(baseUrl, currentPage, totalPages) {
     canonical: currentPage === 1 ? cleanBase : `${cleanBase}?page=${currentPage}`
   };
 }
-function generatePaginatedTitle(title, page, suffix = "\u0635\u0641\u062D\u0629") {
+function generatePaginatedTitle(title, page, suffix = "Page") {
   return page > 1 ? `${title} - ${suffix} ${page}` : title;
 }
+
+// src/core/JsonLd.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function JsonLd({ schema, graph = false }) {
+  const schemas = Array.isArray(schema) ? schema : [schema];
+  if (graph && schemas.length > 1) {
+    const graphData = {
+      "@context": "https://schema.org",
+      "@graph": schemas.map((s) => {
+        const { "@context": _, ...rest } = s;
+        return rest;
+      })
+    };
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      "script",
+      {
+        type: "application/ld+json",
+        dangerouslySetInnerHTML: { __html: JSON.stringify(graphData) }
+      }
+    );
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: schemas.map((s, i) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "script",
+    {
+      type: "application/ld+json",
+      dangerouslySetInnerHTML: { __html: JSON.stringify(s) }
+    },
+    i
+  )) });
+}
+
+// src/core/product-metadata.ts
+function generateProductMetadata(product, config) {
+  const primaryImage = Array.isArray(product.image) ? product.image[0] : product.image;
+  const seoData = {
+    title: product.metaTitle || product.name,
+    description: product.metaDescription || product.description,
+    image: product.ogImage || primaryImage,
+    canonical: product.canonical || product.url,
+    type: "product",
+    noindex: product.noindex,
+    ogTitle: product.name,
+    ogDescription: product.description,
+    ogImage: product.ogImage || primaryImage,
+    ogImageWidth: product.ogImageWidth || 1200,
+    ogImageHeight: product.ogImageHeight || 630,
+    ogType: "product",
+    product: {
+      sku: product.sku,
+      brand: product.brand,
+      price: product.price,
+      currency: product.currency,
+      availability: product.availability,
+      rating: product.rating,
+      reviewCount: product.reviewCount
+    }
+  };
+  const metadata = toNextMetadata(seoData, config);
+  if (product.price !== void 0 && product.currency) {
+    metadata.other = {
+      ...metadata.other,
+      "product:price:amount": product.price.toString(),
+      "product:price:currency": product.currency
+    };
+    if (product.availability) {
+      metadata.other["product:availability"] = product.availability;
+    }
+    if (product.brand) {
+      metadata.other["product:brand"] = product.brand;
+    }
+    if (product.condition) {
+      metadata.other["product:condition"] = product.condition;
+    }
+  }
+  const productSchema = generateProductSchema({
+    name: product.name,
+    description: product.description,
+    image: product.image,
+    sku: product.sku,
+    gtin: product.gtin,
+    mpn: product.mpn,
+    brand: product.brand,
+    price: product.price,
+    currency: product.currency,
+    availability: product.availability,
+    rating: product.rating,
+    reviewCount: product.reviewCount,
+    url: product.url,
+    condition: product.condition,
+    reviews: product.reviews,
+    returnPolicy: product.returnPolicy,
+    shipping: product.shipping,
+    variants: product.variants,
+    seller: product.seller
+  });
+  const breadcrumbItems = product.breadcrumbs || [
+    { name: "Home", item: config.url },
+    { name: "Shop", item: `${config.url}/shop` },
+    ...product.category ? [{ name: product.category, item: `${config.url}/categories/${encodeURIComponent(product.category)}` }] : [],
+    { name: product.name, item: product.url }
+  ];
+  const breadcrumbSchema = generateBreadcrumbSchema(breadcrumbItems);
+  const organizationSchema = generateOrganizationSchema(config);
+  const websiteSchema = generateWebSiteSchema(config);
+  return {
+    metadata,
+    schemas: [productSchema, breadcrumbSchema, organizationSchema, websiteSchema],
+    productSchema,
+    breadcrumbSchema,
+    organizationSchema,
+    websiteSchema
+  };
+}
+
+// src/core/article-metadata.ts
+function generateArticleMetadata(article, config) {
+  const primaryImage = Array.isArray(article.image) ? article.image[0] : article.image;
+  const seoData = {
+    title: article.metaTitle || article.title,
+    description: article.metaDescription || article.description,
+    image: article.ogImage || primaryImage,
+    canonical: article.canonical || article.url,
+    type: "article",
+    noindex: article.noindex,
+    publishedTime: article.publishedTime,
+    modifiedTime: article.modifiedTime,
+    author: article.author,
+    section: article.category,
+    tags: article.tags,
+    readingTime: article.readingTime,
+    ogTitle: article.title,
+    ogDescription: article.description,
+    ogImage: article.ogImage || primaryImage,
+    ogImageWidth: article.ogImageWidth || 1200,
+    ogImageHeight: article.ogImageHeight || 630,
+    ogType: "article"
+  };
+  const metadata = toNextMetadata(seoData, config);
+  if (article.publishedTime) {
+    metadata.other = {
+      ...metadata.other,
+      "article:published_time": article.publishedTime
+    };
+  }
+  if (article.modifiedTime) {
+    metadata.other = {
+      ...metadata.other,
+      "article:modified_time": article.modifiedTime
+    };
+  }
+  if (article.category) {
+    metadata.other = {
+      ...metadata.other,
+      "article:section": article.category
+    };
+  }
+  if (article.tags?.length) {
+    metadata.other = {
+      ...metadata.other,
+      "article:tag": article.tags.join(",")
+    };
+  }
+  const articleSchema = generateArticleSchema({
+    title: article.title,
+    description: article.description,
+    image: article.image,
+    publishedTime: article.publishedTime,
+    modifiedTime: article.modifiedTime,
+    author: article.author,
+    url: article.url,
+    wordCount: article.wordCount
+  }, config);
+  const breadcrumbItems = article.breadcrumbs || [
+    { name: "Home", item: config.url },
+    ...article.category ? [{ name: article.category, item: `${config.url}/category/${encodeURIComponent(article.category)}` }] : [],
+    { name: article.title, item: article.url }
+  ];
+  const breadcrumbSchema = generateBreadcrumbSchema(breadcrumbItems);
+  const organizationSchema = generateOrganizationSchema(config);
+  const websiteSchema = generateWebSiteSchema(config);
+  return {
+    metadata,
+    schemas: [articleSchema, breadcrumbSchema, organizationSchema, websiteSchema],
+    articleSchema,
+    breadcrumbSchema,
+    organizationSchema,
+    websiteSchema
+  };
+}
+
+// src/core/category-metadata.ts
+function generateCategoryMetadata(category, config) {
+  const page = category.page || 1;
+  const totalPages = category.totalPages || 1;
+  const pageSuffix = category.pageSuffix || "Page";
+  const pagination = generatePaginationLinks(category.url, page, totalPages);
+  const title = generatePaginatedTitle(
+    category.metaTitle || category.name,
+    page,
+    pageSuffix
+  );
+  const seoData = {
+    title,
+    description: category.metaDescription || category.description,
+    image: category.image,
+    canonical: pagination.canonical,
+    type: "website",
+    noindex: category.noindex,
+    prev: pagination.prev,
+    next: pagination.next
+  };
+  const metadata = toNextMetadata(seoData, config);
+  const collectionPageSchema = generateCollectionPageSchema({
+    name: category.name,
+    description: category.description,
+    url: pagination.canonical || category.url,
+    image: category.image,
+    numberOfItems: category.items?.length
+  }, config);
+  const breadcrumbItems = category.breadcrumbs || [
+    { name: "Home", item: config.url },
+    ...category.parentCategory ? [{ name: category.parentCategory, item: `${config.url}/categories` }] : [],
+    { name: category.name, item: category.url }
+  ];
+  const breadcrumbSchema = generateBreadcrumbSchema(breadcrumbItems);
+  const organizationSchema = generateOrganizationSchema(config);
+  let itemListSchema;
+  if (category.items && category.items.length > 0) {
+    itemListSchema = generateItemListSchema({
+      name: category.name,
+      url: pagination.canonical || category.url,
+      items: category.items
+    });
+  }
+  const schemas = [collectionPageSchema, breadcrumbSchema, organizationSchema];
+  if (itemListSchema) schemas.push(itemListSchema);
+  return {
+    metadata,
+    schemas,
+    collectionPageSchema,
+    breadcrumbSchema,
+    organizationSchema,
+    itemListSchema
+  };
+}
+
+// src/core/homepage-metadata.ts
+function generateHomepageMetadata(input, config) {
+  const seoData = {
+    title: input.title || config.name,
+    description: input.description || config.description,
+    image: input.ogImage || input.image || config.logo,
+    canonical: input.canonical || config.url,
+    type: "website",
+    ogTitle: input.title || config.name,
+    ogDescription: input.description || config.description,
+    ogImage: input.ogImage || input.image || config.logo,
+    ogImageWidth: input.ogImageWidth || 1200,
+    ogImageHeight: input.ogImageHeight || 630
+  };
+  const metadata = toNextMetadata(seoData, config);
+  const webPageSchema = generateWebPageSchema({
+    name: input.title || config.name,
+    description: input.description || config.description,
+    url: config.url,
+    image: input.image || config.logo
+  }, config);
+  const organizationSchema = generateOrganizationSchema({
+    ...config,
+    socialLinks: input.socialLinks || config.socialLinks
+  });
+  const websiteSchema = generateWebSiteSchema(config);
+  const schemas = [webPageSchema, organizationSchema, websiteSchema];
+  let localBusinessSchema;
+  if (input.localBusiness) {
+    localBusinessSchema = generateLocalBusinessSchema(input.localBusiness);
+    schemas.push(localBusinessSchema);
+  }
+  return {
+    metadata,
+    schemas,
+    webPageSchema,
+    organizationSchema,
+    websiteSchema,
+    localBusinessSchema
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  JsonLd,
+  cleanSchema,
+  generateArticleMetadata,
   generateArticleSchema,
   generateBookSchema,
   generateBreadcrumbSchema,
+  generateCategoryMetadata,
+  generateCollectionPageSchema,
   generateEventSchema,
   generateFAQSchema,
+  generateHomepageMetadata,
+  generateHowToSchema,
+  generateItemListSchema,
+  generateJobPostingSchema,
   generateLocalBusinessSchema,
   generateMovieSchema,
   generateOrganizationSchema,
@@ -391,9 +1031,13 @@ function generatePaginatedTitle(title, page, suffix = "\u0635\u0641\u062D\u0629"
   generatePaginationLinks,
   generatePodcastEpisodeSchema,
   generatePodcastSchema,
+  generateProductMetadata,
   generateProductSchema,
+  generateRecipeSchema,
   generateSoftwareSchema,
   generateVideoSchema,
+  generateWebPageSchema,
   generateWebSiteSchema,
-  toNextMetadata
+  toNextMetadata,
+  validateSEO
 });