@wp-playground/blueprints 0.3.0 → 0.5.1

package/lib/steps/apply-wordpress-patches/index.d.ts

@@ -1,4 +1,4 @@
-import { UniversalPHP } from '@php-wasm/universal';
+import { UniversalPHP } from '../../../../../../php-wasm/universal/src/index.ts';
 import { StepHandler } from '..';
 /**
  * @private
@@ -13,6 +13,7 @@ export interface ApplyWordPressPatchesStep {
     disableWpNewBlogNotification?: boolean;
     makeEditorFrameControlled?: boolean;
     prepareForRunningInsideWebBrowser?: boolean;
+    addFetchNetworkTransport?: boolean;
 }
 export declare const applyWordPressPatches: StepHandler<ApplyWordPressPatchesStep>;
 /**

package/lib/steps/common.d.ts

@@ -1,10 +1,13 @@
-import type { UniversalPHP } from '@php-wasm/universal';
+import type { UniversalPHP } from '../../../../../php-wasm/universal/src/index.ts';
+/**
+ * Used by the export step to exclude the Playground-specific files
+ * from the zip file. Keep it in sync with the list of files created
+ * by WordPressPatcher.
+ */
+export declare const wpContentFilesExcludedFromExport: string[];
 export declare function zipNameToHumanName(zipName: string): string;
 type PatchFileCallback = (contents: string) => string | Uint8Array;
 export declare function updateFile(php: UniversalPHP, path: string, callback: PatchFileCallback): Promise<void>;
 export declare function fileToUint8Array(file: File): Promise<Uint8Array>;
-declare const FileWithArrayBuffer: {
-    new (fileBits: BlobPart[], fileName: string, options?: FilePropertyBag | undefined): File;
-    prototype: File;
-};
-export { FileWithArrayBuffer as File };
+export declare function runPhpWithZipFunctions(playground: UniversalPHP, code: string): Promise<import('../../../../../php-wasm/universal/src/index.ts').PHPResponse>;
+export {};

package/lib/steps/define-wp-config-consts.d.ts

@@ -1,5 +1,4 @@
 import { StepHandler } from '.';
-export declare const VFS_TMP_DIRECTORY = "/vfs-blueprints";
 /**
  * @inheritDoc defineWpConfigConsts
  * @hasRunnableExample
@@ -10,8 +9,7 @@ export declare const VFS_TMP_DIRECTORY = "/vfs-blueprints";
  * 		"step": "defineWpConfigConsts",
  * 		"consts": {
  *          "WP_DEBUG": true
- *      },
- *      "virtualize": true
+ *      }
  * }
  * </code>
  */
@@ -20,15 +18,16 @@ export interface DefineWpConfigConstsStep {
     /** The constants to define */
     consts: Record<string, unknown>;
     /**
-     * Enables the virtualization of wp-config.php and playground-consts.json files, leaving the local system files untouched.
-     * The variables defined in the /vfs-blueprints/playground-consts.json file are loaded via the auto_prepend_file directive in the php.ini file.
-     * @default false
-     * @see https://www.php.net/manual/en/ini.core.php#ini.auto-prepend-file
+     * @deprecated This option is noop and will be removed in a future version.
+     * This option is only kept in here to avoid breaking Blueprint schema validation
+     * for existing apps using this option.
      */
     virtualize?: boolean;
 }
 /**
- * Defines the wp-config.php constants
+ * Defines constants to be used in wp-config.php file.
+ *
+ * This step can be called multiple times, and the constants will be merged.
  *
  * @param playground The playground client.
  * @param wpConfigConst

package/lib/steps/export-wxr.d.ts

@@ -0,0 +1,9 @@
+import { UniversalPHP } from '../../../../../php-wasm/universal/src/index.ts';
+/**
+ * Exports the WordPress database as a WXR file using
+ * the core WordPress export tool.
+ *
+ * @param playground Playground client
+ * @returns WXR file
+ */
+export declare function exportWXR(playground: UniversalPHP): Promise<File>;

package/lib/steps/export-wxz.d.ts

@@ -0,0 +1,9 @@
+import { UniversalPHP } from '../../../../../php-wasm/universal/src/index.ts';
+/**
+ * Exports the WordPress database as a WXZ file using
+ * the export-wxz plugin from https://github.com/akirk/export-wxz.
+ *
+ * @param playground Playground client
+ * @returns WXZ file
+ */
+export declare function exportWXZ(playground: UniversalPHP): Promise<File>;

package/lib/steps/handlers.d.ts

@@ -3,6 +3,7 @@ export { activateTheme } from './activate-theme';
 export { applyWordPressPatches } from './apply-wordpress-patches';
 export { runPHP } from './run-php';
 export { runPHPWithOptions } from './run-php-with-options';
+export { runSql } from './run-sql';
 export { setPhpIniEntry } from './set-php-ini-entry';
 export { request } from './request';
 export { cp } from './cp';
@@ -12,10 +13,15 @@ export { mkdir } from './mkdir';
 export { rmdir } from './rmdir';
 export { writeFile } from './write-file';
 export { defineSiteUrl } from './define-site-url';
-export { importFile, unzip, replaceSite, zipEntireSite } from './import-export';
+export { importFile } from './import-file';
+export { importWordPressFiles } from './import-wp-content';
+export { exportWXR } from './export-wxr';
+export { exportWXZ } from './export-wxz';
+export { unzip } from './unzip';
 export { installPlugin } from './install-plugin';
 export { installTheme } from './install-theme';
 export { login } from './login';
 export { runWpInstallationWizard } from './run-wp-installation-wizard';
 export { setSiteOptions, updateUserMeta } from './site-data';
 export { defineWpConfigConsts } from './define-wp-config-consts';
+export { zipWpContent } from './zip-wp-content';

package/lib/steps/import-file.d.ts

@@ -0,0 +1,29 @@
+import { StepHandler } from '.';
+/**
+ * @inheritDoc importFile
+ * @example
+ *
+ * <code>
+ * {
+ * 		"step": "importFile",
+ * 		"file": {
+ * 			"resource": "url",
+ * 			"url": "https://your-site.com/starter-content.wxz"
+ * 		}
+ * }
+ * </code>
+ */
+export interface ImportFileStep<ResourceType> {
+    step: 'importFile';
+    /** The file to import */
+    file: ResourceType;
+}
+/**
+ * Uploads a file to the WordPress importer and returns the response.
+ * Supports both WXR and WXZ files.
+ *
+ * @see https://github.com/WordPress/wordpress-importer/compare/master...akirk:wordpress-importer:import-wxz.patch
+ * @param playground Playground client.
+ * @param file The file to import.
+ */
+export declare const importFile: StepHandler<ImportFileStep<File>>;

package/lib/steps/import-wp-content.d.ts

@@ -0,0 +1,41 @@
+import { StepHandler } from '.';
+/**
+ * @inheritDoc importWordPressFiles
+ * @example
+ *
+ * <code>
+ * {
+ * 		"step": "importWordPressFilesStep",
+ * 		"wordPressFilesZip": {
+ * 		"resource": "fetch",
+ * 		"url": "https://mysite.com/import.zip"
+ *      }
+ * }
+ * </code>
+ */
+export interface ImportWordPressFilesStep<ResourceType> {
+    step: 'importWordPressFiles';
+    /**
+     * The zip file containing the top-level WordPress files and
+     * directories.
+     */
+    wordPressFilesZip: ResourceType;
+    /**
+     * The path inside the zip file where the WordPress files are.
+     */
+    pathInZip?: string;
+}
+/**
+ * Imports top-level WordPress files from a given zip file into
+ * the documentRoot. For example, if a zip file contains the
+ * `wp-content` and `wp-includes` directories, they will replace
+ * the corresponding directories in Playground's documentRoot.
+ *
+ * Any files that Playground recognizes as "excluded from the export"
+ * will carry over from the existing document root into the imported
+ * directories. For example, the sqlite-database-integration plugin.
+ *
+ * @param playground Playground client.
+ * @param wordPressFilesZip Zipped WordPress site.
+ */
+export declare const importWordPressFiles: StepHandler<ImportWordPressFilesStep<File>>;

package/lib/steps/index.d.ts

@@ -1,10 +1,9 @@
-import { ProgressTracker } from '@php-wasm/progress';
-import { UniversalPHP } from '@php-wasm/universal';
+import { ProgressTracker } from '../../../../../php-wasm/progress/src/index.ts';
+import { UniversalPHP } from '../../../../../php-wasm/universal/src/index.ts';
 import { FileReference } from '../resources';
 import { ActivatePluginStep } from './activate-plugin';
 import { ApplyWordPressPatchesStep } from './apply-wordpress-patches';
 import { DefineSiteUrlStep } from './define-site-url';
-import { ImportFileStep, ReplaceSiteStep, UnzipStep } from './import-export';
 import { InstallPluginStep, InstallPluginOptions } from './install-plugin';
 import { InstallThemeStep, InstallThemeOptions } from './install-theme';
 import { LoginStep } from './login';
@@ -13,6 +12,7 @@ import { SetSiteOptionsStep, UpdateUserMetaStep } from './site-data';
 import { RmStep } from './rm';
 import { CpStep } from './cp';
 import { RmdirStep } from './rmdir';
+import { RunSqlStep } from './run-sql';
 import { MkdirStep } from './mkdir';
 import { MvStep } from './mv';
 import { SetPhpIniEntryStep } from './set-php-ini-entry';
@@ -22,6 +22,9 @@ import { RequestStep } from './request';
 import { WriteFileStep } from './write-file';
 import { DefineWpConfigConstsStep } from './define-wp-config-consts';
 import { ActivateThemeStep } from './activate-theme';
+import { UnzipStep } from './unzip';
+import { ImportWordPressFilesStep } from './import-wp-content';
+import { ImportFileStep } from './import-file';
 export type Step = GenericStep<FileReference>;
 export type StepDefinition = Step & {
     progress?: {
@@ -29,12 +32,13 @@ export type StepDefinition = Step & {
         caption?: string;
     };
 };
+export { wpContentFilesExcludedFromExport } from './common';
 /**
  * If you add a step here, make sure to also
  * add it to the exports below.
  */
-export type GenericStep<Resource> = ActivatePluginStep | ActivateThemeStep | ApplyWordPressPatchesStep | CpStep | DefineWpConfigConstsStep | DefineSiteUrlStep | ImportFileStep<Resource> | InstallPluginStep<Resource> | InstallThemeStep<Resource> | LoginStep | MkdirStep | MvStep | RequestStep | ReplaceSiteStep<Resource> | RmStep | RmdirStep | RunPHPStep | RunPHPWithOptionsStep | RunWpInstallationWizardStep | SetPhpIniEntryStep | SetSiteOptionsStep | UnzipStep | UpdateUserMetaStep | WriteFileStep<Resource>;
-export type { ActivatePluginStep, ActivateThemeStep, ApplyWordPressPatchesStep, CpStep, DefineWpConfigConstsStep, DefineSiteUrlStep, ImportFileStep, InstallPluginStep, InstallPluginOptions, InstallThemeStep, InstallThemeOptions, LoginStep, MkdirStep, MvStep, RequestStep, ReplaceSiteStep, RmStep, RmdirStep, RunPHPStep, RunPHPWithOptionsStep, RunWpInstallationWizardStep, WordPressInstallationOptions, SetPhpIniEntryStep, SetSiteOptionsStep, UnzipStep, UpdateUserMetaStep, WriteFileStep, };
+export type GenericStep<Resource> = ActivatePluginStep | ActivateThemeStep | ApplyWordPressPatchesStep | CpStep | DefineWpConfigConstsStep | DefineSiteUrlStep | ImportFileStep<Resource> | ImportWordPressFilesStep<Resource> | InstallPluginStep<Resource> | InstallThemeStep<Resource> | LoginStep | MkdirStep | MvStep | RequestStep | RmStep | RmdirStep | RunPHPStep | RunPHPWithOptionsStep | RunWpInstallationWizardStep | RunSqlStep<Resource> | SetPhpIniEntryStep | SetSiteOptionsStep | UnzipStep | UpdateUserMetaStep | WriteFileStep<Resource>;
+export type { ActivatePluginStep, ActivateThemeStep, ApplyWordPressPatchesStep, CpStep, DefineWpConfigConstsStep, DefineSiteUrlStep, ImportFileStep, ImportWordPressFilesStep, InstallPluginStep, InstallPluginOptions, InstallThemeStep, InstallThemeOptions, LoginStep, MkdirStep, MvStep, RequestStep, RmStep, RmdirStep, RunPHPStep, RunPHPWithOptionsStep, RunWpInstallationWizardStep, RunSqlStep, WordPressInstallationOptions, SetPhpIniEntryStep, SetSiteOptionsStep, UnzipStep, UpdateUserMetaStep, WriteFileStep, };
 /**
  * Progress reporting details.
  */

package/lib/steps/install-asset.d.ts

@@ -1,4 +1,4 @@
-import type { UniversalPHP } from '@php-wasm/universal';
+import type { UniversalPHP } from '../../../../../php-wasm/universal/src/index.ts';
 export interface InstallAssetOptions {
     /**
      * The zip file to install.

package/lib/steps/request.d.ts

@@ -1,4 +1,4 @@
-import { PHPRequest } from '@php-wasm/universal';
+import { PHPRequest } from '../../../../../php-wasm/universal/src/index.ts';
 import { StepHandler } from '.';
 /**
  * @inheritDoc request

package/lib/steps/run-php-with-options.d.ts

@@ -1,5 +1,5 @@
 import { StepHandler } from '.';
-import { PHPRunOptions } from '@php-wasm/universal';
+import { PHPRunOptions } from '../../../../../php-wasm/universal/src/index.ts';
 /**
  * @inheritDoc runPHP
  * @hasRunnableExample

package/lib/steps/run-sql.d.ts

@@ -0,0 +1,35 @@
+import { StepHandler } from '.';
+/**
+ * @inheritDoc runSql
+ * @hasRunnableExample
+ * @example
+ *
+ * <code>
+ * {
+ *		"step": "runSql",
+ *		"sql": {
+ *			"resource": "literal",
+ *			"name": "schema.sql",
+ *			"contents": "DELETE FROM wp_posts"
+ *		}
+ * }
+ * </code>
+ */
+export interface RunSqlStep<ResourceType> {
+    /**
+     * The step identifier.
+     */
+    step: 'runSql';
+    /**
+     * The SQL to run. Each non-empty line must contain a valid SQL query.
+     */
+    sql: ResourceType;
+}
+/**
+ * Run one or more SQL queries.
+ *
+ * This step will treat each non-empty line in the input SQL as a query and
+ * try to execute it using `$wpdb`. Queries spanning multiple lines are not
+ * yet supported.
+ */
+export declare const runSql: StepHandler<RunSqlStep<File>>;

package/lib/steps/unzip.d.ts

@@ -0,0 +1,28 @@
+import { StepHandler } from '.';
+/**
+ * @inheritDoc unzip
+ * @example
+ *
+ * <code>
+ * {
+ * 		"step": "unzip",
+ * 		"zipPath": "/wordpress/data.zip",
+ * 		"extractToPath": "/wordpress"
+ * }
+ * </code>
+ */
+export interface UnzipStep {
+    step: 'unzip';
+    /** The zip file to extract */
+    zipPath: string;
+    /** The path to extract the zip file to */
+    extractToPath: string;
+}
+/**
+ * Unzip a zip file.
+ *
+ * @param playground Playground client.
+ * @param zipPath The zip file to unzip.
+ * @param extractTo The directory to extract the zip file to.
+ */
+export declare const unzip: StepHandler<UnzipStep>;

package/lib/steps/zip-wp-content.d.ts

@@ -0,0 +1,17 @@
+import { UniversalPHP } from '../../../../../php-wasm/universal/src/index.ts';
+interface ZipWpContentOptions {
+    /**
+     * @private
+     * A temporary workaround to enable including the WordPress default theme
+     * in the exported zip file.
+     */
+    selfContained?: boolean;
+}
+/**
+ * Replace the current wp-content directory with one from the provided zip file.
+ *
+ * @param playground Playground client.
+ * @param wpContentZip Zipped WordPress site.
+ */
+export declare const zipWpContent: (playground: UniversalPHP, { selfContained }?: ZipWpContentOptions) => Promise<Uint8Array>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wp-playground/blueprints",
-	"version": "0.3.0",
+	"version": "0.5.1",
 	"exports": {
 		".": {
 			"import": "./index.js",
@@ -21,7 +21,7 @@
 		"access": "public",
 		"directory": "../../../dist/packages/playground/blueprints"
 	},
-	"gitHead": "6890ff9243f9a10f0b86755fead101647a8c8535",
+	"gitHead": "6c2256a8f3b6bafb2d9a5860f236b00832839769",
 	"engines": {
 		"node": ">=16.15.1",
 		"npm": ">=8.11.0"

package/lib/blueprint.d.ts

@@ -1,31 +0,0 @@
-import { SupportedPHPExtensionBundle, SupportedPHPVersion } from '@php-wasm/universal';
-import { StepDefinition } from './steps';
-export interface Blueprint {
-    /**
-     * The URL to navigate to after the blueprint has been run.
-     */
-    landingPage?: 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
-         */
-        php: SupportedPHPVersion | 'latest';
-        /**
-         * The preferred WordPress version to use.
-         * If not specified, the latest supported version will be used
-         */
-        wp: string | 'latest';
-    };
-    /**
-     * The PHP extensions to use.
-     */
-    phpExtensionBundles?: SupportedPHPExtensionBundle[];
-    /**
-     * The steps to run.
-     */
-    steps?: Array<StepDefinition | string | undefined | false | null>;
-}

package/lib/compile.d.ts

@@ -1,43 +0,0 @@
-import { ProgressTracker } from '@php-wasm/progress';
-import { Semaphore } from '@php-wasm/util';
-import { SupportedPHPExtension, SupportedPHPVersion, UniversalPHP } from '@php-wasm/universal';
-import { StepDefinition } from './steps';
-import { Blueprint } from './blueprint';
-export type CompiledStep = (php: UniversalPHP) => Promise<void> | void;
-export interface CompiledBlueprint {
-    /** The requested versions of PHP and WordPress for the blueprint */
-    versions: {
-        php: SupportedPHPVersion;
-        wp: string;
-    };
-    /** The requested PHP extensions to load */
-    phpExtensions: SupportedPHPExtension[];
-    /** The compiled steps for the blueprint */
-    run: (playground: UniversalPHP) => Promise<void>;
-}
-export type OnStepCompleted = (output: any, step: StepDefinition) => any;
-export interface CompileBlueprintOptions {
-    /** Optional progress tracker to monitor progress */
-    progress?: ProgressTracker;
-    /** Optional semaphore to control access to a shared resource */
-    semaphore?: Semaphore;
-    /** Optional callback with step output */
-    onStepCompleted?: OnStepCompleted;
-}
-/**
- * Compiles Blueprint into a form that can be executed.
- *
- * @param playground The PlaygroundClient to use for the compilation
- * @param blueprint The bBueprint to compile
- * @param options Additional options for the compilation
- * @returns The compiled blueprint
- */
-export declare function compileBlueprint(blueprint: Blueprint, { progress, semaphore, onStepCompleted, }?: CompileBlueprintOptions): CompiledBlueprint;
-export declare function validateBlueprint(blueprintMaybe: object): {
-    valid: true;
-    errors?: undefined;
-} | {
-    valid: false;
-    errors: import("ajv").ErrorObject<string, Record<string, any>, unknown>[] | undefined;
-};
-export declare function runBlueprintSteps(compiledBlueprint: CompiledBlueprint, playground: UniversalPHP): Promise<void>;

package/lib/resources.d.ts

@@ -1,211 +0,0 @@
-import { ProgressTracker } from '@php-wasm/progress';
-import { UniversalPHP } from '@php-wasm/universal';
-import { Semaphore } from '@php-wasm/util';
-export declare const ResourceTypes: readonly ["vfs", "literal", "wordpress.org/themes", "wordpress.org/plugins", "url"];
-export type VFSReference = {
-    /** Identifies the file resource as Virtual File System (VFS) */
-    resource: 'vfs';
-    /** The path to the file in the VFS */
-    path: string;
-};
-export type LiteralReference = {
-    /** Identifies the file resource as a literal file */
-    resource: 'literal';
-    /** The name of the file */
-    name: string;
-    /** The contents of the file */
-    contents: string | Uint8Array;
-};
-export type CoreThemeReference = {
-    /** Identifies the file resource as a WordPress Core theme */
-    resource: 'wordpress.org/themes';
-    /** The slug of the WordPress Core theme */
-    slug: string;
-};
-export type CorePluginReference = {
-    /** Identifies the file resource as a WordPress Core plugin */
-    resource: 'wordpress.org/plugins';
-    /** The slug of the WordPress Core plugin */
-    slug: string;
-};
-export type UrlReference = {
-    /** Identifies the file resource as a URL */
-    resource: 'url';
-    /** The URL of the file */
-    url: string;
-    /** Optional caption for displaying a progress message */
-    caption?: string;
-};
-export type FileReference = VFSReference | LiteralReference | CoreThemeReference | CorePluginReference | UrlReference;
-export declare function isFileReference(ref: any): ref is FileReference;
-export interface ResourceOptions {
-    /** Optional semaphore to limit concurrent downloads */
-    semaphore?: Semaphore;
-    progress?: ProgressTracker;
-}
-export declare abstract class Resource {
-    /** Optional progress tracker to monitor progress */
-    abstract progress?: ProgressTracker;
-    /** A Promise that resolves to the file contents */
-    protected promise?: Promise<File>;
-    protected playground?: UniversalPHP;
-    /**
-     * Creates a new Resource based on the given file reference
-     *
-     * @param ref The file reference to create the Resource for
-     * @param options Additional options for the Resource
-     * @returns A new Resource instance
-     */
-    static create(ref: FileReference, { semaphore, progress }: ResourceOptions): Resource;
-    setPlayground(playground: UniversalPHP): void;
-    /**
-     * Resolves the file contents
-     * @returns The resolved file.
-     */
-    abstract resolve(): Promise<File>;
-    /** The name of the referenced file */
-    abstract get name(): string;
-    /** Whether this Resource is loaded asynchronously */
-    get isAsync(): boolean;
-}
-/**
- * A `Resource` that represents a file in the VFS (virtual file system) of the playground.
- */
-export declare class VFSResource extends Resource {
-    private resource;
-    progress?: ProgressTracker | undefined;
-    /**
-     * Creates a new instance of `VFSResource`.
-     * @param playground The playground client.
-     * @param resource The VFS reference.
-     * @param progress The progress tracker.
-     */
-    constructor(resource: VFSReference, progress?: ProgressTracker | undefined);
-    /** @inheritDoc */
-    resolve(): Promise<File>;
-    /** @inheritDoc */
-    get name(): string;
-}
-/**
- * A `Resource` that represents a literal file.
- */
-export declare class LiteralResource extends Resource {
-    private resource;
-    progress?: ProgressTracker | undefined;
-    /**
-     * Creates a new instance of `LiteralResource`.
-     * @param resource The literal reference.
-     * @param progress The progress tracker.
-     */
-    constructor(resource: LiteralReference, progress?: ProgressTracker | undefined);
-    /** @inheritDoc */
-    resolve(): Promise<File>;
-    /** @inheritDoc */
-    get name(): string;
-}
-/**
- * A base class for `Resource`s that require fetching data from a remote URL.
- */
-export declare abstract class FetchResource extends Resource {
-    progress?: ProgressTracker | undefined;
-    /**
-     * Creates a new instance of `FetchResource`.
-     * @param progress The progress tracker.
-     */
-    constructor(progress?: ProgressTracker | undefined);
-    /** @inheritDoc */
-    resolve(): Promise<File>;
-    /**
-     * Gets the URL to fetch the data from.
-     * @returns The URL.
-     */
-    protected abstract getURL(): string;
-    /**
-     * Gets the caption for the progress tracker.
-     * @returns The caption.
-     */
-    protected get caption(): string;
-    /** @inheritDoc */
-    get name(): string;
-    /** @inheritDoc */
-    get isAsync(): boolean;
-}
-/**
- * A `Resource` that represents a file available from a URL.
- */
-export declare class UrlResource extends FetchResource {
-    private resource;
-    /**
-     * Creates a new instance of `UrlResource`.
-     * @param resource The URL reference.
-     * @param progress The progress tracker.
-     */
-    constructor(resource: UrlReference, progress?: ProgressTracker);
-    /** @inheritDoc */
-    getURL(): string;
-    /** @inheritDoc */
-    protected get caption(): string;
-}
-export declare function setPluginProxyURL(url: string): void;
-/**
- * A `Resource` that represents a WordPress core theme.
- */
-export declare class CoreThemeResource extends FetchResource {
-    private resource;
-    constructor(resource: CoreThemeReference, progress?: ProgressTracker);
-    get name(): string;
-    getURL(): string;
-}
-/**
- * A resource that fetches a WordPress plugin from wordpress.org.
- */
-export declare class CorePluginResource extends FetchResource {
-    private resource;
-    constructor(resource: CorePluginReference, progress?: ProgressTracker);
-    /** @inheritDoc */
-    get name(): string;
-    /** @inheritDoc */
-    getURL(): string;
-}
-/**
- * Transforms a plugin slug into a directory zip name.
- * If the input already ends with ".zip", returns it unchanged.
- * Otherwise, appends ".latest-stable.zip".
- */
-export declare function toDirectoryZipName(rawInput: string): string;
-/**
- * A decorator for a resource that adds functionality such as progress tracking and caching.
- */
-export declare class DecoratedResource<T extends Resource> extends Resource {
-    private resource;
-    constructor(resource: T);
-    /** @inheritDoc */
-    resolve(): Promise<File>;
-    /** @inheritDoc */
-    setPlayground(playground: UniversalPHP): Promise<void>;
-    /** @inheritDoc */
-    get progress(): ProgressTracker | undefined;
-    /** @inheritDoc */
-    set progress(value: ProgressTracker | undefined);
-    /** @inheritDoc */
-    get name(): string;
-    /** @inheritDoc */
-    get isAsync(): boolean;
-}
-/**
- * A decorator for a resource that adds caching functionality.
- */
-export declare class CachedResource<T extends Resource> extends DecoratedResource<T> {
-    protected promise?: Promise<File>;
-    /** @inheritDoc */
-    resolve(): Promise<File>;
-}
-/**
- * A decorator for a resource that adds concurrency control functionality through a semaphore.
- */
-export declare class SemaphoreResource<T extends Resource> extends DecoratedResource<T> {
-    private readonly semaphore;
-    constructor(resource: T, semaphore: Semaphore);
-    /** @inheritDoc */
-    resolve(): Promise<File>;
-}