Reference

import { imagesPlugin } from '@pro-laico/payload-images'

// Every option at its default. This is the zero-config behaviour, written out.
imagesPlugin({
  enabled: true,
  collections: {
    images: {
      // slug: 'media',              // optional, no default: renames the collection (references follow)
      // overrides: { /* … */ },     // optional, no default: a Payload CollectionConfig merged onto it
      options: {
        focalUI: {}, // or { previewRatios: ['16:9', '9:16', '1:1', '4:3', '3:2', '21:9'] }
        folders: true,
        // localizeAlt: false,       // default: whether your config sets `localization`
        mimeTypes: ['image/avif', 'image/webp', 'image/jpeg', 'image/png'],
        // maxOriginalSize: 4096,    // optional, no default: off (the original is kept untouched)
      },
    },
    // generatedImages: { slug: 'variant-cache' }, // optional: rename / override the variant cache
    // renderProfiles: { slug: 'render-shapes' },   // optional: rename / override the prewarm registry
  },
  options: {
    transform: {
      cdnCacheControl: true,
      maxDimension: 4096,
      defaultQuality: 90,
      qualityRange: [40, 95],
      defaultFormat: 'auto',
      formats: ['auto', 'avif', 'webp', 'jpeg', 'png'],
      preferAvif: false,
      maxInputPixels: 100_000_000,
      // maxConcurrency: cpus - 1,  // default (computed from host CPUs, or IMAGES_TRANSFORM_CONCURRENCY)
      sharpConcurrency: 1,
      fallback: true,
    },
    prewarm: {
      // or false to opt out; `strategy: 'default'` ≡ `strategy: {}` ≡ this, written out:
      strategy: {
        widths: { every: 5 }, // the numeric-grid default — 'srcset' with an array pixelStep, or an explicit number[]
        builtIns: true,   // warm src / thumbnailURL / placeholderURL
        learned: true,    // warm observed render profiles
        seeds: [{ aspectRatio: '1:1', quality: 80 }], // declaring your own replaces this default; [] disables
        onUpload: true,   // enqueue on create / file replace / focal edit
        autoRun: '*/5 * * * *', // the plugin runs its own jobs: this cron on long-lived processes, upload kicks + traffic drains on serverless — false turns all three off
        autoRunLimit: 50, // jobs (images) per cron firing / upload kick
        queue: 'images-prewarm', // plugin-owned, so the plugin's runners only ever run its own jobs
      },
      formats: ['webp'],  // +'avif' automatically when transform.preferAvif
      maxVariantsPerImage: 32,
    },
    pixelStep: 50, // the dense grid — or an array ladder, e.g. [640, 750, 828, 1080, 1200, 1920, 2048, 3840]
    presetTemplates: {
      // both ship by default; your own entries merge on top
      og: { width: 1200, height: 630, fit: 'cover', quality: 80, format: 'jpeg' },
      thumbnail: { width: 160, height: 160, fit: 'cover', quality: 70, format: 'webp' },
    },
    variantLimit: 200,
    // access: {                    // per-endpoint gates for the plugin's HTTP endpoints
    //   manage: ({ user }) => Boolean(user), // default: any logged-in user (source read still enforced)
    //   serve:  () => true,                  // default: public (source read still applies)
    // },
  },
})