{
  lib,
  helpers,
  config,
  pkgs,
  ...
}:
with lib;
  (
    import ./_helpers.nix {inherit lib helpers config pkgs;}
  )
  .mkExtension {
    name = "media-files";
    extensionName = "media_files";
    defaultPackage = pkgs.vimPlugins.telescope-media-files-nvim;

    # TODO: introduced 2024-03-24, remove on 2024-05-24
    imports = let
      telescopeExtensionsPath = ["plugins" "telescope" "extensions"];
    in
      mapAttrsToList
      (
        oldOptionName: newOptionPath:
          mkRenamedOptionModule
          (telescopeExtensionsPath ++ ["media_files" oldOptionName])
          (telescopeExtensionsPath ++ ["media-files"] ++ newOptionPath)
      )
      {
        enable = ["enable"];
        package = ["package"];
        filetypes = ["settings" "filetypes"];
        find_cmd = ["settings" "find_cmd"];
      };

    extraOptions = {
      dependencies = let
        mkDepOption = {
          name,
          desc,
          package ? pkgs.${name},
          enabledByDefault ? false,
        }: {
          enable = mkOption {
            type = types.bool;
            default = enabledByDefault;
            description = ''
              Whether to install the ${name} dependency.
              ${desc}
            '';
          };

          package = mkOption {
            type = types.package;
            default = package;
            description = "The package to use for the ${name} dependency.";
          };
        };
      in {
        chafa = mkDepOption {
          name = "chafa";
          enabledByDefault = true;
          desc = "Required for image support.";
        };

        imageMagick = mkDepOption {
          name = "ImageMagick";
          package = pkgs.imagemagick;
          desc = "Required for svg previews.";
        };

        ffmpegthumbnailer = mkDepOption {
          name = "ffmpegthumbnailer";
          desc = "Required for video preview support.";
        };

        pdftoppm = mkDepOption {
          name = "pdmtoppm";
          package = pkgs.poppler_utils;
          desc = "Required for pdf preview support.";
        };

        epub-thumbnailer = mkDepOption {
          name = "epub-thumbnailer";
          desc = "Required for epub preview support";
        };

        fontpreview = mkDepOption {
          name = "fontpreview";
          desc = "Required for font preview support.";
        };
      };
    };

    extraConfig = cfg: {
      extraPackages = flatten (
        mapAttrsToList
        (
          name: {
            enable,
            package,
          }:
            optional enable package
        )
        cfg.dependencies
      );
    };

    settingsOptions = {
      filetypes =
        helpers.defaultNullOpts.mkListOf types.str
        ''
          [
            "png"
            "jpg"
            "gif"
            "mp4"
            "webm"
            "pdf"
          ]
        ''
        "Filetypes whitelist.";

      find_cmd = helpers.defaultNullOpts.mkStr "fd" ''
        Which find command to use.
      '';
    };

    settingsExample = {
      filetypes = ["png" "webp" "jpg" "jpeg"];
      find_cmd = "rg";
    };
  }