feat(seo): enhance json-ld schema with image dimensions

- Enhanced the JSON-LD schema for blog posts to include 'width' and 'height' properties for the 'heroImage'. This provides more detailed image metadata to search engines, improving the potential for rich snippet representation.

- Added the 'image-size' package to 'devDependencies' to dynamically read image dimensions during the build process.

Author: leonism

CHANGELOG

@@ -5,8 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.0.11] - 2026-01-11
+## [1.0.12] - 2026-01-11
+
+### Added
+
+- **feat(seo):** Enhanced the JSON-LD schema for blog posts to include `width` and `height` properties for the `heroImage`. This provides more detailed image metadata to search engines, improving the potential for rich snippet representation.
 
+### Changed
+
+- **build(deps):** Added the `image-size` package to `devDependencies` to dynamically read image dimensions during the build process.
+
+## [1.0.11] - 2026-01-11
 ### Fixed
 
 - **fix(sitemap):** Resolved an issue where non-ASCII characters in blog tags were incorrectly URL-encoded in the sitemap (e.g., `%E3%82%A2...`). The `slugifyTag` utility now correctly transliterates and sanitizes tags to create clean, readable URLs.

package-lock.json

@@ -37,6 +37,7 @@
     "csso": "^5.0.5",
     "glob": "^11.0.3",
     "html-minifier-terser": "^7.2.0",
+    "image-size": "^2.0.2",
     "imagemin": "^9.0.1",
     "imagemin-avif": "^0.1.6",
     "imagemin-mozjpeg": "^10.0.0",

package.json

@@ -1,4 +1,8 @@
 ---
+import { imageSize } from 'image-size';
+import path from 'path';
+import fs from 'fs';
+
 export interface Props {
   title: string;
   description: string;
@@ -27,23 +31,42 @@ const siteUrl = Astro.site ? Astro.site.href : 'https://astro-batavia.pages.dev'
 const canonicalUrl = new URL(Astro.url.pathname, siteUrl).href;
 const imageUrl = image ? new URL(image, siteUrl).href : new URL('/og-default.jpg', siteUrl).href;
 
+let imageDimensions = null;
+if (image) {
+  const imagePath = path.join(process.cwd(), 'public', image);
+  if (fs.existsSync(imagePath)) {
+    try {
+      imageDimensions = imageSize(imagePath);
+    } catch (e) {
+      console.error(`Error getting image dimensions for ${imagePath}:`, e);
+    }
+  }
+}
+
 let schema: Record<string, any> = {
   "@context": "https://schema.org",
 };
 
 if (type === 'article' || type === 'blog') {
+  let imageSchema: Record<string, any> = {
+    "@type": "ImageObject",
+    "url": imageUrl,
+    "caption": imageAlt || title,
+    "representativeOfPage": "true"
+  };
+
+  if (imageDimensions) {
+    imageSchema.width = imageDimensions.width;
+    imageSchema.height = imageDimensions.height;
+  }
+
   schema = {
     ...schema,
     "@type": "BlogPosting",
     "headline": title,
     "description": description,
     "url": canonicalUrl,
-    "image": {
-      "@type": "ImageObject",
-      "url": imageUrl,
-      "caption": imageAlt || title,
-      "representativeOfPage": "true"
-    },
+    "image": imageSchema,
     "datePublished": date ? new Date(date).toISOString() : new Date().toISOString(),
     "dateModified": modifiedTime ? new Date(modifiedTime).toISOString() : (date ? new Date(date).toISOString() : new Date().toISOString()),
     "author": {