@masters-ws/react-seo 1.1.0 → 1.2.1

package/README.md

@@ -131,12 +131,33 @@ All functions are pure (no side effects) and work in any environment:
 | `generateVideoSchema(data)` | Creates VideoObject JSON-LD |
 | `generateEventSchema(data)` | Creates Event JSON-LD |
 | `generateLocalBusinessSchema(data)` | Creates LocalBusiness JSON-LD |
+| `generateSoftwareSchema(data)` | Creates SoftwareApplication JSON-LD |
+| `generateBookSchema(data)` | Creates Book JSON-LD |
+| `generateMovieSchema(data)` | Creates Movie JSON-LD |
+| `generatePodcastSchema(data)` | Creates PodcastSeries JSON-LD |
+| `generatePodcastEpisodeSchema(data)` | Creates PodcastEpisode JSON-LD |
 | `generatePaginationLinks(url, page, total)` | Returns prev/next/canonical URLs |
 | `generateOrganizationSchema(config)` | Creates Organization JSON-LD |
 | `generateWebSiteSchema(config)` | Creates WebSite JSON-LD with SearchAction |
 
 ---
 
+### Image Dimensions (for OpenGraph & Twitter)
+
+For optimal social sharing, specify image dimensions:
+
+```tsx
+toNextMetadata({
+  title: "My Article",
+  image: "/cover.jpg",
+  ogImageWidth: 1200,  // Default: 1200
+  ogImageHeight: 630,  // Default: 630
+  ogImageAlt: "Article cover image"
+}, config);
+```
+
+---
+
 ## Components Reference (Requires react-helmet-async)
 
 | Component | Description |

package/dist/chunk-QD5UVA5B.mjs

@@ -0,0 +1,357 @@
+// 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 (props.alternates && props.alternates.length > 0) {
+    const languages = {};
+    props.alternates.forEach((alt) => {
+      languages[alt.hreflang] = alt.href;
+    });
+    metadata.alternates.languages = languages;
+  }
+  metadata.appleWebApp = {
+    capable: true,
+    title: config.name,
+    statusBarStyle: "default"
+  };
+  if (config.themeColor) metadata.themeColor = config.themeColor;
+  if (config.manifest) metadata.manifest = config.manifest;
+  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;
+}
+
+export {
+  generateOrganizationSchema,
+  generateWebSiteSchema,
+  generateArticleSchema,
+  generateProductSchema,
+  generateFAQSchema,
+  generateBreadcrumbSchema,
+  generateVideoSchema,
+  generateEventSchema,
+  generateLocalBusinessSchema,
+  generateSoftwareSchema,
+  generateBookSchema,
+  generateMovieSchema,
+  generatePodcastSchema,
+  generatePodcastEpisodeSchema,
+  toNextMetadata,
+  generatePaginationLinks,
+  generatePaginatedTitle
+};

package/dist/core/index.d.mts

@@ -1 +1 @@
-export { g as generateArticleSchema, b as generateBreadcrumbSchema, c as generateEventSchema, d as generateFAQSchema, e as generateLocalBusinessSchema, f as generateOrganizationSchema, h as generatePaginatedTitle, i as generatePaginationLinks, j as generateProductSchema, k as generateVideoSchema, l as generateWebSiteSchema, t as toNextMetadata } from '../index-CGVLxGDj.mjs';
+export { g as generateArticleSchema, b as generateBookSchema, c as generateBreadcrumbSchema, d as generateEventSchema, e as generateFAQSchema, f as generateLocalBusinessSchema, h as generateMovieSchema, i as generateOrganizationSchema, j as generatePaginatedTitle, k as generatePaginationLinks, l as generatePodcastEpisodeSchema, m as generatePodcastSchema, n as generateProductSchema, o as generateSoftwareSchema, p as generateVideoSchema, q as generateWebSiteSchema, t as toNextMetadata } from '../index-BEY3UKjK.mjs';

package/dist/core/index.d.ts

@@ -1 +1 @@
-export { g as generateArticleSchema, b as generateBreadcrumbSchema, c as generateEventSchema, d as generateFAQSchema, e as generateLocalBusinessSchema, f as generateOrganizationSchema, h as generatePaginatedTitle, i as generatePaginationLinks, j as generateProductSchema, k as generateVideoSchema, l as generateWebSiteSchema, t as toNextMetadata } from '../index-CGVLxGDj.js';
+export { g as generateArticleSchema, b as generateBookSchema, c as generateBreadcrumbSchema, d as generateEventSchema, e as generateFAQSchema, f as generateLocalBusinessSchema, h as generateMovieSchema, i as generateOrganizationSchema, j as generatePaginatedTitle, k as generatePaginationLinks, l as generatePodcastEpisodeSchema, m as generatePodcastSchema, n as generateProductSchema, o as generateSoftwareSchema, p as generateVideoSchema, q as generateWebSiteSchema, t as toNextMetadata } from '../index-BEY3UKjK.js';

package/dist/core/index.js

@@ -21,14 +21,19 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var core_exports = {};
 __export(core_exports, {
   generateArticleSchema: () => generateArticleSchema,
+  generateBookSchema: () => generateBookSchema,
   generateBreadcrumbSchema: () => generateBreadcrumbSchema,
   generateEventSchema: () => generateEventSchema,
   generateFAQSchema: () => generateFAQSchema,
   generateLocalBusinessSchema: () => generateLocalBusinessSchema,
+  generateMovieSchema: () => generateMovieSchema,
   generateOrganizationSchema: () => generateOrganizationSchema,
   generatePaginatedTitle: () => generatePaginatedTitle,
   generatePaginationLinks: () => generatePaginationLinks,
+  generatePodcastEpisodeSchema: () => generatePodcastEpisodeSchema,
+  generatePodcastSchema: () => generatePodcastSchema,
   generateProductSchema: () => generateProductSchema,
+  generateSoftwareSchema: () => generateSoftwareSchema,
   generateVideoSchema: () => generateVideoSchema,
   generateWebSiteSchema: () => generateWebSiteSchema,
   toNextMetadata: () => toNextMetadata
@@ -192,6 +197,115 @@ function generateLocalBusinessSchema(data) {
     "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) {
@@ -212,7 +326,12 @@ function toNextMetadata(props, config) {
       description: props.ogDescription || description,
       url,
       siteName: config.name,
-      images: props.ogImage || image ? [{ url: props.ogImage || image }] : [],
+      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"
     },
@@ -220,7 +339,10 @@ function toNextMetadata(props, config) {
       card: props.twitterCard || "summary_large_image",
       title: props.twitterTitle || title,
       description: props.twitterDescription || description,
-      images: props.twitterImage || image ? [props.twitterImage || image] : [],
+      images: props.twitterImage || image ? [{
+        url: props.twitterImage || image,
+        alt: props.twitterImageAlt || title
+      }] : [],
       site: config.twitterHandle,
       creator: config.twitterHandle
     },
@@ -258,14 +380,19 @@ function generatePaginatedTitle(title, page, suffix = "\u0635\u0641\u062D\u0629"
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   generateArticleSchema,
+  generateBookSchema,
   generateBreadcrumbSchema,
   generateEventSchema,
   generateFAQSchema,
   generateLocalBusinessSchema,
+  generateMovieSchema,
   generateOrganizationSchema,
   generatePaginatedTitle,
   generatePaginationLinks,
+  generatePodcastEpisodeSchema,
+  generatePodcastSchema,
   generateProductSchema,
+  generateSoftwareSchema,
   generateVideoSchema,
   generateWebSiteSchema,
   toNextMetadata

package/dist/core/index.mjs

@@ -1,27 +1,37 @@
 import {
   generateArticleSchema,
+  generateBookSchema,
   generateBreadcrumbSchema,
   generateEventSchema,
   generateFAQSchema,
   generateLocalBusinessSchema,
+  generateMovieSchema,
   generateOrganizationSchema,
   generatePaginatedTitle,
   generatePaginationLinks,
+  generatePodcastEpisodeSchema,
+  generatePodcastSchema,
   generateProductSchema,
+  generateSoftwareSchema,
   generateVideoSchema,
   generateWebSiteSchema,
   toNextMetadata
-} from "../chunk-AAN7NRZE.mjs";
+} from "../chunk-QD5UVA5B.mjs";
 export {
   generateArticleSchema,
+  generateBookSchema,
   generateBreadcrumbSchema,
   generateEventSchema,
   generateFAQSchema,
   generateLocalBusinessSchema,
+  generateMovieSchema,
   generateOrganizationSchema,
   generatePaginatedTitle,
   generatePaginationLinks,
+  generatePodcastEpisodeSchema,
+  generatePodcastSchema,
   generateProductSchema,
+  generateSoftwareSchema,
   generateVideoSchema,
   generateWebSiteSchema,
   toNextMetadata