// Type definitions for postcss-url 10.0
// Project: https://github.com/postcss/postcss-url
// Definitions by: Silas Rech <https://github.com/lenovouser>
//                 Remco Haszing <https://github.com/remcohaszing>
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
// TypeScript Version: 2.8

/// <reference types="node" />

import { PluginCreator } from 'postcss';

declare namespace url {
    type CustomTransformFunction = (
        asset: {
            /**
             * Original URL.
             */
            url: string;

            /**
             * URL pathname.
             */
            pathname?: string | undefined;

            /**
             * Absolute path to asset.
             */
            absolutePath?: string | undefined;

            /**
             * Current relative path to asset.
             */
            relativePath?: string | undefined;

            /**
             * Querystring from URL.
             */
            search?: string | undefined;

            /**
             * Hash from URL.
             */
            hash?: string | undefined;
        },
        dir: {
            /**
             * PostCSS from option.
             */
            from?: string | undefined;

            /**
             * PostCSS to option.
             */
            to?: string | undefined;

            /**
             * File path.
             */
            file?: string | undefined;
        },
    ) => string;
    type CustomHashFunction = (file: Buffer) => string;
    type CustomFilterFunction = (file: string) => boolean;

    interface Options {
        /**
         * URL rewriting mechanism.
         *
         * @default 'rebase'
         */
        url?: 'copy' | 'inline' | 'rebase' | CustomTransformFunction | undefined;

        /**
         * Specify the maximum file size to inline (in kilobytes).
         */
        maxSize?: number | undefined;

        /**
         * Do not warn when an SVG URL with a fragment is inlined.
         * PostCSS-URL does not support partial inlining.
         * The entire SVG file will be inlined.
         * By default a warning will be issued when this occurs.
         *
         * @default false
         */
        ignoreFragmentWarning?: boolean | undefined;

        /**
         * Reduce size of inlined svg (IE9+, Android 3+)
         *
         * @default false
         */
        optimizeSvgEncode?: boolean | undefined;

        /**
         * Determine wether a file should be inlined.
         */
        filter?: RegExp | CustomFilterFunction | string | undefined;

        /**
         * Specifies whether the URL's fragment identifer value, if present, will be added to the inlined data URI.
         *
         * @default false
         */
        includeUriFragment?: boolean | undefined;

        /**
         * The fallback method to use if the maximum size is exceeded or the URL contains a hash.
         */
        fallback?: CustomTransformFunction | undefined;

        /**
         * Specify the base path or list of base paths where to search images from.
         */
        basePath?: string | string[] | undefined;

        /**
         * The assets files will be copied in that destination.
         *
         * @default false
         */
        assetsPath?: boolean | string | undefined;

        /**
         * Rename the path of the files by a hash name.
         *
         * @default false
         */
        useHash?: boolean | undefined;

        /**
         * Hash options
         */
        hashOptions?:
            | {
                  /**
                   * Hashing method or custom function.
                   */
                  method?: 'xxhash32' | 'xxhash64' | CustomHashFunction | undefined;

                  /**
                   * Shrink hast to certain length.
                   */
                  shrink?: number | undefined;

                  /**
                   * Append the original filename in resulting filename.
                   */
                  append?: boolean | undefined;
              }
            | undefined;
    }

    type Url = PluginCreator<Options | Options[]>;
}

declare const url: url.Url;
export = url;