import { Plugin } from 'vite';

/**
 * SVG loader options.
 *
 * **Paths**
 *
 * Both file name and its path relative to the project's root with leading slash will be compared.
 *
 * For example, if you have a file `/src/assets/icons/menu.svg` then following strings will be checked:
 *
 * 1. `/assets/icons/menu.svg` - note that it doesn't start with `/src`
 * 2. `menu.svg`
 *
 * To avoid transforming multiple files with the same name, always include path into each entry.
 *
 * Examples:
 *
 * ```js
 * plugins: [
 *   viteReBinSvgLoader({
 *     preserveLineWidthList: [
 *       // Recommended formats:
 *       /\/img\/icons/, // Matches all paths containing "/img/line-art/"
 *       "/assets/img/logo.svg", // Matches single file "/assets/img/logo.svg".
 *
 *       // Not recommended formats:
 *       "splash.svg", // Matches all files named "splash.svg"
 *       /\/icons\/plus\.svg/, // Matches all paths containing "/icons/plus.svg"
 *     ],
 *   }),
 * ],
 * ```
 */
interface SvgLoaderOptions {
    /**
     * Temporary directory where SVG files will be stored in dev mode.
     *
     * @default "temp"
     */
    tempDir?: string;
    /**
     * A list of files or directories to preserve line width of, i.e. to set `vector-effect="non-scaling-stroke"`.
     *
     * This option is primarily for icons and line art.
     *
     * This also can be done in an import: `import imageSrc from "./path/to/image.svg?preserve-line-width"`.
     */
    preserveLineWidthList?: (string | RegExp)[];
    /**
     * A list of files or directories to disable preserving line width of. Overrides {@link preserveLineWidthList}.
     */
    skipPreserveLineWidthList?: (string | RegExp)[];
    /**
     * A list of CSS selectors to disable {@link preserveLineWidthList} for. Use it to leave specific elements stroke
     * width as-is.
     *
     * Can be a list of selectors or selectors-per-files specifiers.
     *
     * Unlike {@link skipSetCurrentColorSelectors} and {@link skipTransformsSelectors}, doesn't impact build performance.
     */
    skipPreserveLineWidthSelectors?: (string | SelectorsPerFiles)[];
    /**
     * A list of files or directories to replace fill, stroke and `<stop>` colors with `currentColor` (default) or other
     * colors (if {@link ColorMapPerFiles} or {@link ColorMap} is specified), i.e.:
     *
     * 1. `fill`, `stroke` and `stop-color` attributes and CSS identifiers will be replaced with `currentColor` or other
     * given color.
     * 2. `none`, `transparent` or `currentColor` values will not be replaced.
     *
     * Opacity (i.e. `rgba()`) won't be preserved.
     * You have to manually set opacity by setting `fill-opacity` and `stroke-opacity` attributes.
     *
     * This is done because opacity may be handled with a stylesheet selector. This case is hard to implement, and it may
     * slow down build process. This behavior might be changed in future, but it shouldn't break your project.
     *
     * Setting `currentColor` can be done with an import: `import imageSrc from "./path/to/image.svg?set-current-color"`.
     *
     * Replacements priority:
     *
     * 1. {@link ColorMapPerFiles}
     * 1. {@link ColorMap}
     * 1. `string | RegExp`
     */
    replaceColorsList?: (string | RegExp | ColorMap | ColorMapPerFiles)[];
    /**
     * A list of files or directories to disable color replacements of. Overrides {@link replaceColorsList}.
     */
    skipReplaceColorsList?: (string | RegExp)[];
    /**
     * A list of CSS selectors to disable {@link skipReplaceColorsList} for. Use it to leave specific elements colors
     * as-is.
     *
     * Can be a list of selectors or selectors-per-files specifiers.
     *
     * **You probably don't need this option.** Think of other ways to solve your problem. "Recipes" section
     * in the demos may help you.
     *
     * **Heavy usage may significantly slow down build time.** Limit selectors to specific files to improve performance.
     */
    skipReplaceColorsSelectors?: (string | SelectorsPerFiles)[];
    /**
     * A list of files to skip while transforming.
     *
     * For example, if you add a directory to {@link preserveLineWidthList} and add a file in that directory to this list,
     * line width of added file won't be preserved.
     *
     * SVGO is still applied to the added files.
     */
    skipTransformsList?: (string | RegExp)[];
    /**
     * A list of CSS selectors to disable all transforms for. Use it to leave specific elements as-is.
     *
     * Can be a list of selectors or selectors-per-files specifiers.
     *
     * **You probably don't need this option.** Think of other ways to solve your problem. "Recipes" section
     * in the demos may help you.
     *
     * **Heavy usage may significantly slow down build time.** Limit selectors to specific files to improve performance.
     */
    skipTransformsSelectors?: (string | SelectorsPerFiles)[];
    /**
     * A list of files to skip loading of. Useful for passing original files to another loader.
     *
     * This also can be done in an import: `import imageSrc from "./path/to/image.svg?skip-transforms"`.
     */
    skipFilesList?: (string | RegExp)[];
    /**
     * Default import type, i.e. what you get without specifying anything in the import URL.
     *
     * This also can be done in an import:
     *
     * ```ts
     * // Source code
     * import imageSrc from "./path/to/image.svg?source";
     *
     * // URL
     * import imageUrl from "./path/to/image.svg?url";
     *
     * // Source code Data URI
     * import imageSrcDataUri from "./path/to/image.svg?source-data-uri";
     *
     * // Base64
     * import imageBase64 from "./path/to/image.svg?base-64";
     *
     * // Base64 data URI
     * import imageBase64DataUri from "./path/to/image.svg?base-64-data-uri";
     * ```
     *
     * @default "source"
     */
    defaultImport?: ImportType;
    /**
     * A list of files or directories to replace fill, stroke and `<stop>` colors of with `currentColor`.
     *
     * Overrides {@link replaceColorsList}.
     *
     * @deprecated Deprecated in favor of {@link replaceColorsList}
     */
    setCurrentColorList?: (string | RegExp)[];
    /**
     * A list of files or directories to disable setting current color of. Overrides {@link setCurrentColorList} and
     * {@link replaceColorsList}.
     *
     * @deprecated Deprecated in favor of {@link replaceColorsList}
     */
    skipSetCurrentColorList?: (string | RegExp)[];
    /**
     * A list of CSS selectors to disable {@link setCurrentColorList} for.Overrides {@link setCurrentColorList},
     * {@link replaceColorsList} and {@link skipReplaceColorsSelectors}.
     *
     * @deprecated Deprecated in favor of {@link skipReplaceColorsSelectors}
     */
    skipSetCurrentColorSelectors?: (string | SelectorsPerFiles)[];
}
type ImportType = "url" | "source" | "source-data-uri" | "base64" | "base64-data-uri";
/**
 * CSS selector per file or files
 */
interface SelectorsPerFiles {
    /**
     * List of filenames and/or paths matchers
     */
    files: (string | RegExp)[];
    /**
     * List of selectors
     */
    selectors: string[];
}
/**
 * Maps original SVG colors (case-insensitive) to their replacements
 */
type ColorMap = Record<string, string>;
/**
 * Maps original SVG colors (case-insensitive) to their replacements. Can be applied to specific files via {@link files} property.
 *
 * @example
 *
 * {
 *   // Optional list of files to apply replacements to.
 *   files: ["my-file.svg", /icon\-*.\.svg/],
 *
 *   // Will replace all colors with "red" value with "var(--primary-color)".
 *   // It'll replace only "red". HEX ("#ff0000"), RGB ("rgb(255, 0, 0)") and other values won't be replaced.
 *   "red": "var(--primary-color)",
 *
 *   // Same as above: this HEX value (case-insensitive) will be replaced with "var(--secondary-color)".
 *   // Just "blue" or any other values with the same resulting color won't be replaced.
 *   "#0000ff": "var(--secondary-color)",
 *
 *   // Again, only this value (case-insensitive) will be replaced with "var(--tertiary-color)". Any other value will be
 *   // left as-is.
 *   "rgb(0, 255, 0)": "var(--tertiary-color)",
 * }
 */
interface ColorMapPerFiles {
    /**
     * A list of files to apply replacements to. If omitted, replacements will be applied to all files
     */
    files: (string | RegExp)[];
    /**
     * Maps original SVG colors (case-insensitive) to their replacements
     */
    replacements: ColorMap;
    /**
     * Replacement for other colors. Set to empty string to leave colors as-is.
     *
     * @default "currentColor"
     */
    default?: string;
}

/**
 * A Vite plugin that:
 *
 * 1. Can import SVGs (see also: {@link SvgLoaderOptions.defaultImport}) as:
 *    1. Source code (default import type): `import imageSrc from "./path/to/image.svg"`.
 *    1. URL: `import imageUrl from "./path/to/image.svg?url"`.
 *    1. Source code data URI: `import imageSrcDataUri from "./path/to/image.svg?source-data-uri"`.
 *    1. Source code Base64: `import imageBase64 from "./path/to/image.svg?base64"`.
 *    1. Source code Base64 data URI: `import imageBase64DataUri from "./path/to/image.svg?base64-data-uri"`.
 *
 * 1. Can preserve line width (make icons and line art have same line width when scaling):
 * `import imageSrc from "./path/to/image.svg?preserve-line-width"`.
 * Can be configured via {@link SvgLoaderOptions.preserveLineWidthList}.
 *
 * 1. Can replace colors with `currentColor` (or a custom color via {@link SvgLoaderOptions.replaceColorsList}):
 * `import imageSrc from "./path/to/image.svg?set-current-color"`.
 * Can be configured via {@link SvgLoaderOptions.replaceColorsList}.
 *
 * 1. Will automatically minimize your SVGs using [SVGO](https://github.com/svg/svgo).
 *
 * 1. Allows you to create SVG sprites using provided integrations.
 *
 * @param options Plugin options
 */
declare function viteAwesomeSvgLoader(options?: SvgLoaderOptions): Plugin;

export { type ColorMap, type ColorMapPerFiles, type ImportType, type SelectorsPerFiles, type SvgLoaderOptions, viteAwesomeSvgLoader };
import "./declarations";