@masters-ws/react-seo 1.2.1 → 1.4.0

package/dist/chunk-6RBCF5I5.mjs

@@ -0,0 +1,567 @@
+// src/core/schemas.ts
+function generateOrganizationSchema(config) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "Organization",
+    "name": config.name,
+    "url": config.url,
+    "logo": config.logo,
+    "sameAs": config.socialLinks || []
+  };
+}
+function generateWebSiteSchema(config) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "WebSite",
+    "name": config.name,
+    "url": config.url,
+    "potentialAction": {
+      "@type": "SearchAction",
+      "target": `${config.url}/search?q={search_term_string}`,
+      "query-input": "required name=search_term_string"
+    }
+  };
+}
+function generateArticleSchema(data, config) {
+  const org = generateOrganizationSchema(config);
+  return {
+    "@context": "https://schema.org",
+    "@type": "NewsArticle",
+    "headline": data.title,
+    "description": data.description,
+    "image": data.image || config.logo,
+    "datePublished": data.publishedTime,
+    "dateModified": data.modifiedTime || data.publishedTime,
+    "mainEntityOfPage": data.url,
+    "author": data.author ? {
+      "@type": "Person",
+      "name": data.author.name,
+      "url": data.author.url
+    } : org,
+    "publisher": org
+  };
+}
+function generateProductSchema(data) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "Product",
+    "name": data.name,
+    "description": data.description,
+    "image": data.image,
+    "sku": data.sku,
+    "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"
+    },
+    "aggregateRating": data.rating ? {
+      "@type": "AggregateRating",
+      "ratingValue": data.rating,
+      "reviewCount": data.reviewCount || 1
+    } : void 0
+  };
+}
+function generateFAQSchema(questions) {
+  return {
+    "@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 {
+    "@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) {
+  return {
+    "@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 {
+    "@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 {
+    "@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 {
+    "@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 {
+    "@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 {
+    "@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 {
+    "@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 {
+    "@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
+  };
+}
+
+// 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 = "\u0635\u0641\u062D\u0629") {
+  return page > 1 ? `${title} - ${suffix} ${page}` : title;
+}
+
+// src/core/JsonLd.tsx
+import { Fragment, jsx } from "react/jsx-runtime";
+function JsonLd({ schema }) {
+  const schemas = Array.isArray(schema) ? schema : [schema];
+  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 seoData = {
+    title: product.metaTitle || product.name,
+    description: product.metaDescription || product.description,
+    image: product.ogImage || product.image,
+    canonical: product.canonical || product.url,
+    type: "product",
+    noindex: product.noindex,
+    ogTitle: product.name,
+    ogDescription: product.description,
+    ogImage: product.ogImage || product.image,
+    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;
+    }
+  }
+  const productSchema = generateProductSchema({
+    name: product.name,
+    description: product.description,
+    image: product.image,
+    sku: product.sku,
+    brand: product.brand,
+    price: product.price,
+    currency: product.currency,
+    availability: product.availability,
+    rating: product.rating,
+    reviewCount: product.reviewCount,
+    url: product.url
+  });
+  const breadcrumbItems = product.breadcrumbs || [
+    { name: "\u0627\u0644\u0631\u0626\u064A\u0633\u064A\u0629", item: config.url },
+    { name: "\u0627\u0644\u0645\u062A\u062C\u0631", 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 seoData = {
+    title: article.metaTitle || article.title,
+    description: article.metaDescription || article.description,
+    image: article.ogImage || article.image,
+    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 || article.image,
+    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
+  }, config);
+  const breadcrumbItems = article.breadcrumbs || [
+    { name: "\u0627\u0644\u0631\u0626\u064A\u0633\u064A\u0629", 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
+  };
+}
+
+export {
+  generateOrganizationSchema,
+  generateWebSiteSchema,
+  generateArticleSchema,
+  generateProductSchema,
+  generateFAQSchema,
+  generateBreadcrumbSchema,
+  generateVideoSchema,
+  generateEventSchema,
+  generateLocalBusinessSchema,
+  generateSoftwareSchema,
+  generateBookSchema,
+  generateMovieSchema,
+  generatePodcastSchema,
+  generatePodcastEpisodeSchema,
+  toNextMetadata,
+  generatePaginationLinks,
+  generatePaginatedTitle,
+  JsonLd,
+  generateProductMetadata,
+  generateArticleMetadata
+};