@wp-playground/blueprints 0.1.46 → 0.1.49

package/lib/steps/client-methods.d.ts

@@ -1,56 +1,230 @@
 import { PHPRunOptions, PHPRequest } from '@php-wasm/universal';
 import { StepHandler } from '.';
+/**
+ * @inheritDoc runPHP
+ * @hasRunnableExample
+ * @example
+ *
+ * <code>
+ * {
+ * 		"step": "runPHP",
+ * 		"code": "<?php echo 'Hello World'; ?>"
+ * }
+ * </code>
+ */
 export interface RunPHPStep {
+    /** The step identifier. */
     step: 'runPHP';
+    /** The PHP code to run. */
     code: string;
 }
+/**
+ * Runs PHP code.
+ */
 export declare const runPHP: StepHandler<RunPHPStep>;
+/**
+ * @inheritDoc runPHP
+ * @hasRunnableExample
+ * @example
+ *
+ * <code>
+ * {
+ * 		"step": "runPHP",
+ * 		"options": {
+ * 			"code": "<?php echo $_SERVER['HTTP_CONTENT_TYPE']; ?>",
+ * 			"headers": {
+ * 				"Content-type": "text/plain"
+ * 			}
+ * 		}
+ * }
+ * </code>
+ */
 export interface RunPHPWithOptionsStep {
     step: 'runPHPWithOptions';
     options: PHPRunOptions;
 }
+/**
+ * Runs PHP code with the given options.
+ */
 export declare const runPHPWithOptions: StepHandler<RunPHPWithOptionsStep>;
+/**
+ * @inheritDoc setPhpIniEntry
+ * @hasRunnableExample
+ * @example
+ *
+ * <code>
+ * {
+ * 		"step": "setPhpIniEntry",
+ * 		"key": "display_errors",
+ * 		"value": "1"
+ * }
+ * </code>
+ */
 export interface SetPhpIniEntryStep {
     step: 'setPhpIniEntry';
     key: string;
     value: string;
 }
+/**
+ * Sets a PHP ini entry.
+ */
 export declare const setPhpIniEntry: StepHandler<SetPhpIniEntryStep>;
+/**
+ * @inheritDoc request
+ * @needsLogin
+ * @hasRunnableExample
+ * @example
+ *
+ * <code>
+ * {
+ * 		"step": "request",
+ * 		"request": {
+ * 			"method": "POST",
+ * 			"url": "/wp-admin/admin-ajax.php",
+ * 			"formData": {
+ * 				"action": "my_action",
+ * 				"foo": "bar"
+ * 			}
+ * 		}
+ * }
+ * </code>
+ */
 export interface RequestStep {
     step: 'request';
     request: PHPRequest;
 }
+/**
+ * Sends a HTTP request to the Playground.
+ */
 export declare const request: StepHandler<RequestStep>;
+/**
+ * @inheritDoc cp
+ * @hasRunnableExample
+ * @landingPage /index2.php
+ * @example
+ *
+ * <code>
+ * {
+ * 		"step": "cp",
+ * 		"fromPath": "/wordpress/index.php",
+ * 		"toPath": "/wordpress/index2.php"
+ * }
+ * </code>
+ */
 export interface CpStep {
     step: 'cp';
     fromPath: string;
     toPath: string;
 }
+/**
+ * Copies a file from one path to another.
+ */
 export declare const cp: StepHandler<CpStep>;
+/**
+ * @inheritDoc mv
+ * @hasRunnableExample
+ * @landingPage /index2.php
+ * @example
+ *
+ * <code>
+ * {
+ * 		"step": "mv",
+ * 		"fromPath": "/wordpress/index.php",
+ * 		"toPath": "/wordpress/index2.php"
+ * }
+ * </code>
+ */
 export interface MvStep {
     step: 'mv';
     fromPath: string;
     toPath: string;
 }
+/**
+ * Moves a file or directory from one path to another.
+ */
 export declare const mv: StepHandler<MvStep>;
+/**
+ * @inheritDoc mkdir
+ * @hasRunnableExample
+ * @example
+ *
+ * <code>
+ * {
+ * 		"step": "mkdir",
+ * 		"path": "/wordpress/my-new-folder"
+ * }
+ * </code>
+ */
 export interface MkdirStep {
     step: 'mkdir';
     path: string;
 }
+/**
+ * Creates a directory at the specified path.
+ */
 export declare const mkdir: StepHandler<MkdirStep>;
+/**
+ * @inheritDoc rm
+ * @hasRunnableExample
+ * @landingPage /index.php
+ * @example
+ *
+ * <code>
+ * {
+ * 		"step": "rm",
+ * 		"path": "/wordpress/index.php"
+ * }
+ * </code>
+ */
 export interface RmStep {
     step: 'rm';
     path: string;
 }
+/**
+ * Removes a file at the specified path.
+ */
 export declare const rm: StepHandler<RmStep>;
+/**
+ * @inheritDoc rmdir
+ * @hasRunnableExample
+ * @landingPage /wp-admin/
+ * @example
+ *
+ * <code>
+ * {
+ * 		"step": "rm",
+ * 		"path": "/wordpress/wp-admin"
+ * }
+ * </code>
+ */
 export interface RmdirStep {
     step: 'rmdir';
     path: string;
 }
+/**
+ * Removes a directory at the specified path.
+ */
 export declare const rmdir: StepHandler<RmdirStep>;
+/**
+ * @inheritDoc writeFile
+ * @hasRunnableExample
+ * @landingPage /test.php
+ * @example
+ *
+ * <code>
+ * {
+ * 		"step": "writeFile",
+ * 		"path": "/wordpress/test.php",
+ * 		"data": "<?php echo 'Hello World!'; ?>"
+ * }
+ * </code>
+ */
 export interface WriteFileStep<ResourceType> {
     step: 'writeFile';
     path: string;
     data: ResourceType | string | Uint8Array;
 }
+/**
+ * Writes data to a file at the specified path.
+ */
 export declare const writeFile: StepHandler<WriteFileStep<File>>;

package/lib/steps/index.d.ts

@@ -21,8 +21,12 @@ export type StepDefinition = Step & {
         caption?: string;
     };
 };
+/**
+ * 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 | DefineVirtualWpConfigConstsStep | 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, 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 { ActivatePluginStep, ActivateThemeStep, ApplyWordPressPatchesStep, CpStep, DefineWpConfigConstsStep, DefineVirtualWpConfigConstsStep, DefineSiteUrlStep, ImportFileStep, InstallPluginStep, InstallPluginOptions, InstallThemeStep, InstallThemeOptions, LoginStep, MkdirStep, MvStep, RequestStep, ReplaceSiteStep, RmStep, RmdirStep, RunPHPStep, RunPHPWithOptionsStep, RunWpInstallationWizardStep, WordPressInstallationOptions, SetPhpIniEntryStep, SetSiteOptionsStep, UnzipStep, UpdateUserMetaStep, WriteFileStep, };
 export type StepHandler<S extends GenericStep<File>> = (
 /**
  * A PHP instance or Playground client.

package/lib/steps/site-data.d.ts

@@ -1,12 +1,55 @@
 import { StepHandler } from '.';
+/**
+ * @inheritDoc setSiteOptions
+ * @hasRunnableExample
+ *
+ * @example
+ *
+ * <code>
+ * {
+ *     "step": "setSiteOptions",
+ *     "options": {
+ *         "blogname": "My Blog",
+ *         "blogdescription": "A great blog"
+ *     }
+ * }
+ * </code>
+ */
 export type SetSiteOptionsStep = {
+    /** The name of the step. Must be "setSiteOptions". */
     step: 'setSiteOptions';
+    /** The options to set on the site. */
     options: Record<string, unknown>;
 };
+/**
+ * Sets site options. This is equivalent to calling `update_option` for each
+ * option in the `options` object.
+ */
 export declare const setSiteOptions: StepHandler<SetSiteOptionsStep>;
+/**
+ * @inheritDoc updateUserMeta
+ * @hasRunnableExample
+ *
+ * @example
+ *
+ * <code>
+ * {
+ *     "step": "updateUserMeta",
+ *     "meta": {
+ * 	       "first_name": "John",
+ * 	       "last_name": "Doe"
+ *     },
+ *     "userId": 1
+ * }
+ * </code>
+ */
 export interface UpdateUserMetaStep {
     step: 'updateUserMeta';
     meta: Record<string, unknown>;
     userId: number;
 }
+/**
+ * Updates user meta. This is equivalent to calling `update_user_meta` for each
+ * meta value in the `meta` object.
+ */
 export declare const updateUserMeta: StepHandler<UpdateUserMetaStep>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wp-playground/blueprints",
-	"version": "0.1.46",
+	"version": "0.1.49",
 	"exports": {
 		".": {
 			"import": "./index.js",
@@ -21,5 +21,5 @@
 		"access": "public",
 		"directory": "../../../dist/packages/playground/blueprints"
 	},
-	"gitHead": "b1e1b4b57b00fb52429f0490af4ccb943f496f74"
+	"gitHead": "93834fa77a89c21be2ade4c1d67430981ed92c83"
 }