@masters-ws/react-seo 1.2.1 → 1.4.1

package/dist/chunk-FFE2ZOOC.mjs

@@ -0,0 +1,945 @@
+// 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 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 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 cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "NewsArticle",
+    "headline": data.title,
+    "description": data.description,
+    "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) {
+  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": offers,
+    "aggregateRating": data.rating ? {
+      "@type": "AggregateRating",
+      "ratingValue": data.rating,
+      "reviewCount": data.reviewCount || 1
+    } : void 0,
+    "review": reviewList && reviewList.length > 0 ? reviewList : void 0
+  });
+}
+function generateFAQSchema(questions) {
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "FAQPage",
+    "mainEntity": questions.map((item) => ({
+      "@type": "Question",
+      "name": item.q,
+      "acceptedAnswer": {
+        "@type": "Answer",
+        "text": item.a
+      }
+    }))
+  });
+}
+function generateBreadcrumbSchema(items) {
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "BreadcrumbList",
+    "itemListElement": items.map((item, index) => ({
+      "@type": "ListItem",
+      "position": index + 1,
+      "name": item.name,
+      "item": item.item
+    }))
+  });
+}
+function generateVideoSchema(data) {
+  validateSEO("VideoObject", data, ["name", "description", "thumbnailUrl", "uploadDate"]);
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "VideoObject",
+    "name": data.name,
+    "description": data.description,
+    "thumbnailUrl": data.thumbnailUrl,
+    "uploadDate": data.uploadDate,
+    "duration": data.duration,
+    "contentUrl": data.contentUrl,
+    "embedUrl": data.embedUrl
+  });
+}
+function generateEventSchema(data) {
+  const isOnline = data.location && "url" in data.location;
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "Event",
+    "name": data.name,
+    "description": data.description,
+    "startDate": data.startDate,
+    "endDate": data.endDate,
+    "eventAttendanceMode": isOnline ? "https://schema.org/OnlineEventAttendanceMode" : "https://schema.org/OfflineEventAttendanceMode",
+    "location": isOnline ? {
+      "@type": "VirtualLocation",
+      "url": data.location.url
+    } : data.location ? {
+      "@type": "Place",
+      "name": data.location.name,
+      "address": data.location.address
+    } : void 0,
+    "image": data.image,
+    "offers": data.offers ? {
+      "@type": "Offer",
+      "price": data.offers.price,
+      "priceCurrency": data.offers.currency,
+      "url": data.offers.url
+    } : void 0
+  });
+}
+function generateLocalBusinessSchema(data) {
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "LocalBusiness",
+    "name": data.name,
+    "description": data.description,
+    "image": data.image,
+    "telephone": data.telephone,
+    "address": {
+      "@type": "PostalAddress",
+      "streetAddress": data.address.street,
+      "addressLocality": data.address.city,
+      "addressRegion": data.address.region,
+      "postalCode": data.address.postalCode,
+      "addressCountry": data.address.country
+    },
+    "geo": data.geo ? {
+      "@type": "GeoCoordinates",
+      "latitude": data.geo.lat,
+      "longitude": data.geo.lng
+    } : void 0,
+    "openingHours": data.openingHours,
+    "priceRange": data.priceRange
+  });
+}
+function generateSoftwareSchema(data) {
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "SoftwareApplication",
+    "name": data.name,
+    "description": data.description,
+    "operatingSystem": data.operatingSystem,
+    "applicationCategory": data.applicationCategory,
+    "offers": data.offers ? {
+      "@type": "Offer",
+      "price": data.offers.price,
+      "priceCurrency": data.offers.currency
+    } : void 0,
+    "aggregateRating": data.rating ? {
+      "@type": "AggregateRating",
+      "ratingValue": data.rating,
+      "reviewCount": data.reviewCount || 1
+    } : void 0,
+    "downloadUrl": data.downloadUrl,
+    "screenshot": data.screenshot
+  });
+}
+function generateBookSchema(data) {
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "Book",
+    "name": data.name,
+    "author": typeof data.author === "string" ? {
+      "@type": "Person",
+      "name": data.author
+    } : {
+      "@type": "Person",
+      "name": data.author.name,
+      "url": data.author.url
+    },
+    "description": data.description,
+    "isbn": data.isbn,
+    "numberOfPages": data.numberOfPages,
+    "publisher": data.publisher ? {
+      "@type": "Organization",
+      "name": data.publisher
+    } : void 0,
+    "datePublished": data.datePublished,
+    "image": data.image,
+    "inLanguage": data.inLanguage,
+    "genre": data.genre
+  });
+}
+function generateMovieSchema(data) {
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "Movie",
+    "name": data.name,
+    "description": data.description,
+    "image": data.image,
+    "director": data.director ? {
+      "@type": "Person",
+      "name": data.director
+    } : void 0,
+    "actor": data.actor?.map((name) => ({
+      "@type": "Person",
+      "name": name
+    })),
+    "dateCreated": data.dateCreated,
+    "duration": data.duration,
+    "genre": data.genre,
+    "aggregateRating": data.rating ? {
+      "@type": "AggregateRating",
+      "ratingValue": data.rating,
+      "reviewCount": data.reviewCount || 1
+    } : void 0
+  });
+}
+function generatePodcastSchema(data) {
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "PodcastSeries",
+    "name": data.name,
+    "description": data.description,
+    "image": data.image,
+    "author": data.author ? {
+      "@type": "Person",
+      "name": data.author
+    } : void 0,
+    "webFeed": data.webFeed,
+    "url": data.url,
+    "genre": data.genre
+  });
+}
+function generatePodcastEpisodeSchema(data) {
+  return cleanSchema({
+    "@context": "https://schema.org",
+    "@type": "PodcastEpisode",
+    "name": data.name,
+    "description": data.description,
+    "datePublished": data.datePublished,
+    "timeRequired": data.duration,
+    "url": data.url,
+    "associatedMedia": data.audio ? {
+      "@type": "AudioObject",
+      "contentUrl": data.audio
+    } : void 0,
+    "partOfSeries": data.partOfSeries ? {
+      "@type": "PodcastSeries",
+      "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
+function toNextMetadata(props, config) {
+  const title = props.title ? `${props.title} | ${config.name}` : config.name;
+  const description = props.description || config.description;
+  const url = props.canonical || config.url;
+  const image = props.image || config.logo;
+  const metadata = {
+    title,
+    description,
+    keywords: props.keywords,
+    robots: props.noindex ? "noindex, nofollow" : props.robots || "index, follow",
+    alternates: {
+      canonical: props.noindex ? void 0 : url
+    },
+    openGraph: {
+      title: props.ogTitle || title,
+      description: props.ogDescription || description,
+      url,
+      siteName: config.name,
+      images: props.ogImage || image ? [{
+        url: props.ogImage || image,
+        width: props.ogImageWidth || 1200,
+        height: props.ogImageHeight || 630,
+        alt: props.ogImageAlt || title
+      }] : [],
+      type: props.ogType || (props.type === "article" ? "article" : "website"),
+      locale: props.ogLocale || config.language || "ar_SA"
+    },
+    twitter: {
+      card: props.twitterCard || "summary_large_image",
+      title: props.twitterTitle || title,
+      description: props.twitterDescription || description,
+      images: props.twitterImage || image ? [{
+        url: props.twitterImage || image,
+        alt: props.twitterImageAlt || title
+      }] : [],
+      site: config.twitterHandle,
+      creator: config.twitterHandle
+    },
+    other: {}
+  };
+  if (config.facebookAppId) {
+    metadata.other["fb:app_id"] = config.facebookAppId;
+  }
+  if (props.alternates && props.alternates.length > 0) {
+    const languages = {};
+    props.alternates.forEach((alt) => {
+      languages[alt.hreflang] = alt.href;
+    });
+    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,
+    statusBarStyle: "default"
+  };
+  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) {
+  const hasNext = currentPage < totalPages;
+  const hasPrev = currentPage > 1;
+  const cleanBase = baseUrl.split("?")[0];
+  return {
+    next: hasNext ? `${cleanBase}?page=${currentPage + 1}` : void 0,
+    prev: hasPrev ? currentPage === 2 ? cleanBase : `${cleanBase}?page=${currentPage - 1}` : void 0,
+    canonical: currentPage === 1 ? cleanBase : `${cleanBase}?page=${currentPage}`
+  };
+}
+function generatePaginatedTitle(title, page, suffix = "Page") {
+  return page > 1 ? `${title} - ${suffix} ${page}` : title;
+}
+
+// src/core/JsonLd.tsx
+import { Fragment, jsx } from "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__ */ jsx(
+      "script",
+      {
+        type: "application/ld+json",
+        dangerouslySetInnerHTML: { __html: JSON.stringify(graphData) }
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx(Fragment, { children: schemas.map((s, i) => /* @__PURE__ */ 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
+  };
+}
+
+export {
+  cleanSchema,
+  validateSEO,
+  generateOrganizationSchema,
+  generateWebSiteSchema,
+  generateWebPageSchema,
+  generateCollectionPageSchema,
+  generateItemListSchema,
+  generateArticleSchema,
+  generateProductSchema,
+  generateFAQSchema,
+  generateBreadcrumbSchema,
+  generateVideoSchema,
+  generateEventSchema,
+  generateLocalBusinessSchema,
+  generateSoftwareSchema,
+  generateBookSchema,
+  generateMovieSchema,
+  generatePodcastSchema,
+  generatePodcastEpisodeSchema,
+  generateHowToSchema,
+  generateRecipeSchema,
+  generateJobPostingSchema,
+  toNextMetadata,
+  generatePaginationLinks,
+  generatePaginatedTitle,
+  JsonLd,
+  generateProductMetadata,
+  generateArticleMetadata,
+  generateCategoryMetadata
+};