import type { AllPHPVersion } from '@php-wasm/universal';
import type { StepDefinition } from '../steps';
import type { FileReference } from './resources';
import type { StreamedFile } from '@php-wasm/stream-compression';
import type { BlueprintBundle } from '../types';
export type ExtraLibrary = 'wp-cli';
export type PHPConstants = Record<string, string | boolean | number>;
export type StreamBundledFile = (relativePath: string) => Promise<StreamedFile>;
export type BlueprintV1 = BlueprintV1Declaration | BlueprintBundle;
/**
 * PHP versions accepted in Blueprint schema.
 * Includes deprecated versions (7.2, 7.3) which are automatically
 * upgraded to 7.4 during compilation.
 */
export type BlueprintPHPVersion = AllPHPVersion | '7.2' | '7.3';
/**
 * The Blueprint declaration, typically stored in a blueprint.json file.
 */
export type BlueprintV1Declaration = {
    /**
     * The URL to navigate to after the blueprint has been run.
     */
    landingPage?: string;
    /**
     * Optional description. It doesn't do anything but is exposed as
     * a courtesy to developers who may want to document which blueprint
     * file does what.
     *
     * @deprecated Use meta.description instead.
     */
    description?: string;
    /**
     * Optional metadata. Used by the Blueprints gallery at https://github.com/WordPress/blueprints
     */
    meta?: {
        /**
         * A clear and concise name for your Blueprint.
         */
        title: string;
        /**
         * A brief explanation of what your Blueprint offers.
         */
        description?: string;
        /**
         * A GitHub username of the author of this Blueprint.
         */
        author: string;
        /**
         * Relevant categories to help users find your Blueprint in the future
         * Blueprints section on WordPress.org.
         */
        categories?: string[];
    };
    /**
     * The preferred PHP and WordPress versions to use.
     */
    preferredVersions?: {
        /**
         * The preferred PHP version to use.
         * If not specified, the latest supported version will be used.
         *
         * Note: PHP 7.2 and 7.3 are deprecated and will be automatically upgraded to 7.4.
         */
        php: BlueprintPHPVersion | 'latest';
        /**
         * The preferred WordPress version to use, or `false` to boot a
         * PHP-only Playground without downloading or installing WordPress.
         * If not specified, the latest supported version will be used.
         *
         * When set to `false`, WordPress-specific Blueprint fields
         * (`plugins`, `siteOptions`, `login`, and WordPress-only steps)
         * are rejected at compile time.
         */
        wp: string | 'latest' | false;
    };
    features?: {
        /** Should boot with support for Intl dynamic extension */
        intl?: boolean;
        /** Should boot with support for network request via wp_safe_remote_get? */
        networking?: boolean;
    };
    /**
     * Extra libraries to preload into the Playground instance.
     */
    extraLibraries?: ExtraLibrary[];
    /**
     * PHP Constants to define on every request
     */
    constants?: PHPConstants;
    /**
     * WordPress plugins to install and activate
     */
    plugins?: Array<string | FileReference>;
    /**
     * WordPress site options to define
     */
    siteOptions?: Record<string, string> & {
        /** The site title */
        blogname?: string;
    };
    /**
     * User to log in as.
     * If true, logs the user in as admin/password.
     */
    login?: boolean | {
        username: string;
        password: string;
    };
    /**
     * @deprecated No longer used. Feel free to remove it from your Blueprint.
     */
    phpExtensionBundles?: any;
    /**
     * The steps to run after every other operation in this Blueprint was
     * executed.
     */
    steps?: Array<StepDefinition | string | undefined | false | null>;
};