metalsmith-optimize-images 0.9.3 → 0.10.0

package/lib/index.js

@@ -860,6 +860,12 @@ function replacePictureElement($, $img, variants, config) {
  */
 async function processHtmlFile(htmlFile, fileData, files, metalsmith, processedImages, debug, config) {
   debug(`Processing HTML file: ${htmlFile}`);
+
+  // Validate file.contents before processing
+  if (!fileData.contents || !Buffer.isBuffer(fileData.contents)) {
+    debug(`Skipping ${htmlFile}: invalid or missing file contents`);
+    return;
+  }
   const content = fileData.contents.toString();
 
   // Parse HTML
@@ -1089,33 +1095,8 @@ function injectProgressiveAssets($) {
  * Creates a responsive images plugin for Metalsmith
  * Generates multiple sizes and formats of images and replaces img tags with picture elements
  *
- * @param {Object} options - Configuration options for the plugin
- * @param {number[]} [options.widths] - Array of image widths to generate
- * @param {string[]} [options.formats] - Array of image formats to generate (in order of preference)
- * @param {Object} [options.formatOptions] - Format-specific compression settings
- * @param {Object} [options.formatOptions.avif] - AVIF compression options
- * @param {Object} [options.formatOptions.webp] - WebP compression options
- * @param {Object} [options.formatOptions.jpeg] - JPEG compression options
- * @param {Object} [options.formatOptions.png] - PNG compression options
- * @param {string} [options.htmlPattern] - Glob pattern to match HTML files
- * @param {string} [options.imgSelector] - CSS selector for images to process
- * @param {string} [options.outputDir] - Output directory for processed images
- * @param {string} [options.outputPattern] - Output naming pattern
- * @param {boolean} [options.skipLarger] - Whether to skip generating sizes larger than original
- * @param {boolean} [options.lazy] - Whether to add loading="lazy" to images
- * @param {boolean} [options.dimensionAttributes] - Whether to add width/height attributes
- * @param {string} [options.sizes] - Default sizes attribute
- * @param {number} [options.concurrency] - Maximum number of images to process in parallel
- * @param {boolean} [options.generateMetadata] - Whether to generate a metadata JSON file
- * @param {boolean} [options.isProgressive] - Whether to use progressive image loading (default: true)
- * @param {Object} [options.placeholder] - Placeholder image settings for progressive loading
- * @param {number} [options.placeholder.width] - Placeholder image width (default: 50)
- * @param {number} [options.placeholder.quality] - Placeholder image quality (default: 30)
- * @param {number} [options.placeholder.blur] - Placeholder image blur amount (default: 10)
- * @param {boolean} [options.processUnusedImages] - Whether to process unused images for background use (default: true)
- * @param {string} [options.imagePattern] - Glob pattern to find images for background processing (default: `**\/*.{jpg,jpeg,png,gif,webp,avif}`)
- * @param {string} [options.imageFolder] - Folder to scan for background images, relative to source (default: 'lib/assets/images')
- * @return {Function} - Metalsmith plugin function
+ * @param {Options} [options={}] - Configuration options for the plugin
+ * @returns {import('metalsmith').Plugin} - Metalsmith plugin function
  */
 function optimizeImagesPlugin(options = {}) {
   // Build configuration with defaults and user options
@@ -1541,5 +1522,10 @@ function generateBackgroundVariantPath(originalPath, width, format, config) {
   return path.join(config.outputDir, outputName);
 }
 
+// Set function name for better debugging
+Object.defineProperty(optimizeImagesPlugin, 'name', {
+  value: 'metalsmith-optimize-images'
+});
+
 export { optimizeImagesPlugin as default };
 //# sourceMappingURL=index.js.map