@wordpress/e2e-test-utils-playwright 1.46.0 → 1.48.0

package/build-types/admin/index.d.ts

@@ -10,6 +10,7 @@ import { getPageError } from './get-page-error';
 import { visitAdminPage } from './visit-admin-page';
 import { editPost } from './edit-post';
 import { visitSiteEditor } from './visit-site-editor';
+import { waitForSiteEditor } from './wait-for-site-editor';
 import type { PageUtils } from '../page-utils';
 import type { Editor } from '../editor';
 type AdminConstructorProps = {
@@ -34,6 +35,8 @@ export declare class Admin {
     visitAdminPage: typeof visitAdminPage;
     /** @borrows visitSiteEditor as this.visitSiteEditor */
     visitSiteEditor: typeof visitSiteEditor;
+    /** @borrows waitForSiteEditor as this.waitForSiteEditor */
+    waitForSiteEditor: typeof waitForSiteEditor;
 }
 export {};
 //# sourceMappingURL=index.d.ts.map

package/build-types/admin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEtE;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,KAAK,qBAAqB,GAAG;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,qBAAa,KAAK;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IAEf,YAAa,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,qBAAqB,EAM9D;IAED,mDAAmD;IACnD,aAAa,EAAE,OAAO,aAAa,CAA8B;IACjE,yCAAyC;IACzC,QAAQ,EAAE,OAAO,QAAQ,CAAyB;IAClD,iDAAiD;IACjD,YAAY,EAAE,OAAO,YAAY,CAA6B;IAC9D,qDAAqD;IACrD,cAAc,EAAE,OAAO,cAAc,CAA+B;IACpE,uDAAuD;IACvD,eAAe,EAAE,OAAO,eAAe,CAAgC;CACvE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEtE;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,KAAK,qBAAqB,GAAG;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,qBAAa,KAAK;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IAEf,YAAa,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,qBAAqB,EAM9D;IAED,mDAAmD;IACnD,aAAa,EAAE,OAAO,aAAa,CAA8B;IACjE,yCAAyC;IACzC,QAAQ,EAAE,OAAO,QAAQ,CAAyB;IAClD,iDAAiD;IACjD,YAAY,EAAE,OAAO,YAAY,CAA6B;IAC9D,qDAAqD;IACrD,cAAc,EAAE,OAAO,cAAc,CAA+B;IACpE,uDAAuD;IACvD,eAAe,EAAE,OAAO,eAAe,CAAgC;IACvE,2DAA2D;IAC3D,iBAAiB,EAAE,OAAO,iBAAiB,CACX;CAChC"}

package/build-types/admin/visit-site-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"visit-site-editor.d.ts","sourceRoot":"","sources":["../../src/admin/visit-site-editor.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAEhC,UAAU,iBAAiB;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACpC,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,iBAAsB,iBA6E/B"}
+{"version":3,"file":"visit-site-editor.d.ts","sourceRoot":"","sources":["../../src/admin/visit-site-editor.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAEhC,UAAU,iBAAiB;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACpC,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,iBAAsB,iBAuC/B"}

package/build-types/admin/wait-for-site-editor.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Internal dependencies
+ */
+import type { Admin } from './';
+/**
+ * Waits for the Site Editor to finish loading, i.e., for all resolvers
+ * in the `core` store to finish and then pause for a short period.
+ *
+ * @param this
+ */
+export declare function waitForSiteEditor(this: Admin): Promise<void>;
+//# sourceMappingURL=wait-for-site-editor.d.ts.map

package/build-types/admin/wait-for-site-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-site-editor.d.ts","sourceRoot":"","sources":["../../src/admin/wait-for-site-editor.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAEhC;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAE,IAAI,EAAE,KAAK,iBAwCnD"}

package/build-types/metrics/index.d.ts

@@ -1,6 +1,3 @@
-/**
- * External dependencies
- */
 import type { Page, Browser } from '@playwright/test';
 type EventType = 'click' | 'focus' | 'focusin' | 'keydown' | 'keypress' | 'keyup' | 'mouseout' | 'mouseover';
 interface TraceEvent {
@@ -82,13 +79,33 @@ export declare class Metrics {
     /**
      * Starts Chromium tracing with predefined options for performance testing.
      *
+     * The category set mirrors what Chrome DevTools enables when recording in
+     * the Performance panel: `devtools.timeline` provides the top-level event
+     * tree, and the `disabled-by-default-v8.cpu_profiler` + companion
+     * `devtools.timeline.stack` categories enable the V8 sampler that
+     * populates JavaScript call stacks. Without the latter, the saved trace
+     * shows only opaque "Function call" blocks with no JS frames inside.
+     *
      * @param options Options to pass to `browser.startTracing()`.
      */
     startTracing(options?: {}): Promise<void>;
     /**
-     * Stops Chromium tracing and saves the trace.
+     * Stops Chromium tracing.
+     *
+     * When `name` is a non-empty string and the `WP_ARTIFACTS_PATH` environment
+     * variable is set, the raw trace is written to
+     * `${WP_ARTIFACTS_PATH}/traces/<name>.trace.json`. The resulting file can
+     * be opened in Chrome DevTools (Performance panel → "Load profile…") to
+     * inspect the flame graph. Pass a falsy value (or omit the argument) to
+     * just parse the trace into `this.trace` without writing — this is the
+     * default for iteration loops, where you typically want to save only one
+     * representative sample. Callers pick which iteration that is, e.g.
+     * `i === Math.floor( iterations / 2 ) && 'post-editor-first-block'`.
+     *
+     * @param name File name (without extension) identifying the scenario, or
+     *             `false`/`undefined` to skip writing.
      */
-    stopTracing(): Promise<void>;
+    stopTracing(name?: string | false): Promise<void>;
     /**
      * @return Durations of all traced `keydown`, `keypress`, and `keyup`
      * events.

package/build-types/metrics/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAOtD,KAAK,SAAS,GACX,OAAO,GACP,OAAO,GACP,SAAS,GACT,SAAS,GACT,UAAU,GACV,OAAO,GACP,UAAU,GACV,WAAW,CAAC;AAEf,UAAU,UAAU;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QACL,IAAI,CAAC,EAAE;YACN,IAAI,EAAE,SAAS,CAAC;SAChB,CAAC;KACF,CAAC;CACF;AAED,UAAU,KAAK;IACd,WAAW,EAAE,UAAU,EAAE,CAAC;CAC1B;AAED,KAAK,uBAAuB,GAAG;IAC9B,IAAI,EAAE,IAAI,CAAC;CACX,CAAC;AAEF,UAAU,qBAAqB;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,OAAO;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IAEb,SAAS,EAAE,qBAAqB,CAAM;IAEtC,YAAa,EAAE,IAAI,EAAE,EAAE,uBAAuB,EAI7C;IAED;;;;OAIG;IACG,eAAe,CAAE,MAAM,GAAE,MAAM,EAAO,mCAkB3C;IAED;;;;;;OAMG;IACG,kBAAkB,oBASvB;IAED;;;;;;;OAOG;IACG,yBAAyB,oBAgB9B;IAED;;;;;;;OAOG;IACG,wBAAwB,oBAsB7B;IAED;;;;;OAKG;IACG,mBAAmB;;;;;;;OAsCxB;IAED;;;;OAIG;IACG,YAAY,CAAE,OAAO,KAAK,iBAM/B;IAED;;OAEG;IACG,WAAW,kBAKhB;IAED;;;OAGG;IACH,uBAAuB,eAMtB;IAED;;OAEG;IACH,0BAA0B,eAKzB;IAED;;OAEG;IACH,sBAAsB,eAErB;IAED;;OAEG;IACH,sBAAsB,eAKrB;IAED;;;OAGG;IACH,iBAAiB,CAAE,SAAS,EAAE,SAAS,YAgBtC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,aAAa,CAAE,MAAM,UAAO,iBAwCjC;IAED;;;;;;;;;OASG;IACG,YAAY,mCAiBjB;CACD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAMtD,KAAK,SAAS,GACX,OAAO,GACP,OAAO,GACP,SAAS,GACT,SAAS,GACT,UAAU,GACV,OAAO,GACP,UAAU,GACV,WAAW,CAAC;AAEf,UAAU,UAAU;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QACL,IAAI,CAAC,EAAE;YACN,IAAI,EAAE,SAAS,CAAC;SAChB,CAAC;KACF,CAAC;CACF;AAED,UAAU,KAAK;IACd,WAAW,EAAE,UAAU,EAAE,CAAC;CAC1B;AAED,KAAK,uBAAuB,GAAG;IAC9B,IAAI,EAAE,IAAI,CAAC;CACX,CAAC;AAEF,UAAU,qBAAqB;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,OAAO;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IAEb,SAAS,EAAE,qBAAqB,CAAM;IAEtC,YAAa,EAAE,IAAI,EAAE,EAAE,uBAAuB,EAI7C;IAED;;;;OAIG;IACG,eAAe,CAAE,MAAM,GAAE,MAAM,EAAO,mCAkB3C;IAED;;;;;;OAMG;IACG,kBAAkB,oBASvB;IAED;;;;;;;OAOG;IACG,yBAAyB,oBAgB9B;IAED;;;;;;;OAOG;IACG,wBAAwB,oBAsB7B;IAED;;;;;OAKG;IACG,mBAAmB;;;;;;;OAsCxB;IAED;;;;;;;;;;;OAWG;IACG,YAAY,CAAE,OAAO,KAAK,iBAY/B;IAED;;;;;;;;;;;;;;;OAeG;IACG,WAAW,CAAE,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,iBAmCvC;IAED;;;OAGG;IACH,uBAAuB,eAMtB;IAED;;OAEG;IACH,0BAA0B,eAKzB;IAED;;OAEG;IACH,sBAAsB,eAErB;IAED;;OAEG;IACH,sBAAsB,eAKrB;IAED;;;OAGG;IACH,iBAAiB,CAAE,SAAS,EAAE,SAAS,YAgBtC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,aAAa,CAAE,MAAM,UAAO,iBAwCjC;IAED;;;;;;;;;OASG;IACG,YAAY,mCAiBjB;CACD"}

package/build-types/request-utils/index.d.ts

@@ -13,7 +13,7 @@ import { createPost, deleteAllPosts } from './posts';
 import { createClassicMenu, createNavigationMenu, deleteAllMenus, getNavigationMenus } from './menus';
 import { deleteAllPages, createPage } from './pages';
 import { createRecord } from './records';
-import { resetPreferences } from './preferences';
+import { resetPreferences, setPreferences } from './preferences';
 import { getSiteSettings, updateSiteSettings } from './site-settings';
 import { deleteAllWidgets, addWidgetBlock } from './widgets';
 import { setGutenbergExperiments } from './gutenberg-experiments';
@@ -88,6 +88,8 @@ declare class RequestUtils {
     createTemplate: typeof createTemplate;
     /** @borrows resetPreferences as this.resetPreferences */
     resetPreferences: typeof resetPreferences;
+    /** @borrows setPreferences as this.setPreferences */
+    setPreferences: typeof setPreferences;
     /** @borrows listMedia as this.listMedia */
     listMedia: typeof listMedia;
     /** @borrows uploadMedia as this.uploadMedia */

package/build-types/request-utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/request-utils/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/request-utils/index.ts"],"names":[],"mappings":"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"}

package/build-types/request-utils/preferences.d.ts

@@ -8,4 +8,15 @@ import type { RequestUtils } from './index';
  * @param this Request utils.
  */
 export declare function resetPreferences(this: RequestUtils): Promise<void>;
+/**
+ * Set scoped user preferences via the REST API.
+ *
+ * Reads the current persisted preferences, merges the new values under the
+ * given scope, and writes them back.
+ *
+ * @param this        Request utils.
+ * @param scope       The preference scope (e.g. 'core/edit-post').
+ * @param preferences Key/value map of preference names to values.
+ */
+export declare function setPreferences(this: RequestUtils, scope: string, preferences: Record<string, any>): Promise<void>;
 //# sourceMappingURL=preferences.d.ts.map

package/build-types/request-utils/preferences.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../src/request-utils/preferences.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAE,IAAI,EAAE,YAAY,iBAUzD"}
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../src/request-utils/preferences.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAE,IAAI,EAAE,YAAY,iBAUzD;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CACnC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,CAAE,MAAM,EAAE,GAAG,CAAE,iBA2BlC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/e2e-test-utils-playwright",
-	"version": "1.46.0",
+	"version": "1.48.0",
 	"description": "End-To-End (E2E) test utils for WordPress.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -25,14 +25,13 @@
 		"npm": ">=8.19.2"
 	},
 	"files": [
-		"build",
+		"src",
 		"build-types"
 	],
-	"main": "./build/index.cjs",
 	"exports": {
 		".": {
 			"types": "./build-types/index.d.ts",
-			"default": "./build/index.cjs"
+			"default": "./src/index.ts"
 		},
 		"./package.json": "./package.json"
 	},
@@ -55,5 +54,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "51264e33b95fadff9a06b68141e674ce9cde9675"
+	"gitHead": "e7856693aeb4e2522d13608cd32c994e4a97cb9c"
 }

package/src/admin/create-new-post.ts

@@ -0,0 +1,47 @@
+/**
+ * Internal dependencies
+ */
+import type { Admin } from './';
+
+interface NewPostOptions {
+	postType?: string;
+	title?: string;
+	content?: string;
+	excerpt?: string;
+	showWelcomeGuide?: boolean;
+	fullscreenMode?: boolean;
+}
+
+/**
+ * Creates new post.
+ *
+ * @param this
+ * @param options Options to create new post.
+ */
+export async function createNewPost(
+	this: Admin,
+	options: NewPostOptions = {}
+) {
+	const query = new URLSearchParams();
+	const { postType, title, content, excerpt } = options;
+
+	if ( postType ) {
+		query.set( 'post_type', postType );
+	}
+	if ( title ) {
+		query.set( 'post_title', title );
+	}
+	if ( content ) {
+		query.set( 'content', content );
+	}
+	if ( excerpt ) {
+		query.set( 'excerpt', excerpt );
+	}
+
+	await this.visitAdminPage( 'post-new.php', query.toString() );
+
+	await this.editor.setPreferences( 'core/edit-post', {
+		welcomeGuide: options.showWelcomeGuide ?? false,
+		fullscreenMode: options.fullscreenMode ?? false,
+	} );
+}

package/src/admin/edit-post.ts

@@ -0,0 +1,24 @@
+/**
+ * Internal dependencies
+ */
+import type { Admin } from '.';
+
+/**
+ * Open the post with given ID in the editor.
+ *
+ * @param this
+ * @param postId Post ID to visit.
+ */
+export async function editPost( this: Admin, postId: string | number ) {
+	const query = new URLSearchParams();
+
+	query.set( 'post', String( postId ) );
+	query.set( 'action', 'edit' );
+
+	await this.visitAdminPage( 'post.php', query.toString() );
+
+	await this.editor.setPreferences( 'core/edit-post', {
+		welcomeGuide: false,
+		fullscreenMode: false,
+	} );
+}

package/{build/admin/get-page-error.js → src/admin/get-page-error.ts}

@@ -1,12 +1,16 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPageError = getPageError;
+/**
+ * Internal dependencies
+ */
+import type { Admin } from './';
+
 /**
  * Regular expression matching a displayed PHP error within a markup string.
  *
  * @see https://github.com/php/php-src/blob/598175e/main/main.c#L1257-L1297
  */
-const REGEXP_PHP_ERROR = /(<b>)?(Fatal error|Recoverable fatal error|Warning|Parse error|Notice|Strict Standards|Deprecated|Unknown error)(<\/b>)?: (.*?) in (.*?) on line (<b>)?\d+(<\/b>)?/;
+const REGEXP_PHP_ERROR =
+	/(<b>)?(Fatal error|Recoverable fatal error|Warning|Parse error|Notice|Strict Standards|Deprecated|Unknown error)(<\/b>)?: (.*?) in (.*?) on line (<b>)?\d+(<\/b>)?/;
+
 /**
  * Returns a promise resolving to one of either a string or null. A string will
  * be resolved if an error message is present in the contents of the page. If no
@@ -18,9 +22,8 @@ const REGEXP_PHP_ERROR = /(<b>)?(Fatal error|Recoverable fatal error|Warning|Par
  * @param this
  * @return Promise resolving to a string or null, depending whether a page error is present.
  */
-async function getPageError() {
-    const content = await this.page.content();
-    const match = content.match(REGEXP_PHP_ERROR);
-    return match ? match[0] : null;
+export async function getPageError( this: Admin ) {
+	const content = await this.page.content();
+	const match = content.match( REGEXP_PHP_ERROR );
+	return match ? match[ 0 ] : null;
 }
-//# sourceMappingURL=get-page-error.js.map

package/src/admin/index.ts

@@ -0,0 +1,52 @@
+/**
+ * External dependencies
+ */
+import type { Browser, Page, BrowserContext } from '@playwright/test';
+
+/**
+ * Internal dependencies
+ */
+import { createNewPost } from './create-new-post';
+import { getPageError } from './get-page-error';
+import { visitAdminPage } from './visit-admin-page';
+import { editPost } from './edit-post';
+import { visitSiteEditor } from './visit-site-editor';
+import { waitForSiteEditor } from './wait-for-site-editor';
+import type { PageUtils } from '../page-utils';
+import type { Editor } from '../editor';
+
+type AdminConstructorProps = {
+	page: Page;
+	pageUtils: PageUtils;
+	editor: Editor;
+};
+
+export class Admin {
+	page: Page;
+	context: BrowserContext;
+	browser: Browser;
+	pageUtils: PageUtils;
+	editor: Editor;
+
+	constructor( { page, pageUtils, editor }: AdminConstructorProps ) {
+		this.page = page;
+		this.context = page.context();
+		this.browser = this.context.browser()!;
+		this.pageUtils = pageUtils;
+		this.editor = editor;
+	}
+
+	/** @borrows createNewPost as this.createNewPost */
+	createNewPost: typeof createNewPost = createNewPost.bind( this );
+	/** @borrows editPost as this.editPost */
+	editPost: typeof editPost = editPost.bind( this );
+	/** @borrows getPageError as this.getPageError */
+	getPageError: typeof getPageError = getPageError.bind( this );
+	/** @borrows visitAdminPage as this.visitAdminPage */
+	visitAdminPage: typeof visitAdminPage = visitAdminPage.bind( this );
+	/** @borrows visitSiteEditor as this.visitSiteEditor */
+	visitSiteEditor: typeof visitSiteEditor = visitSiteEditor.bind( this );
+	/** @borrows waitForSiteEditor as this.waitForSiteEditor */
+	waitForSiteEditor: typeof waitForSiteEditor =
+		waitForSiteEditor.bind( this );
+}

package/src/admin/visit-admin-page.ts

@@ -0,0 +1,43 @@
+/**
+ * External dependencies
+ */
+import { join } from 'path';
+
+/**
+ * Internal dependencies
+ */
+import type { Admin } from './';
+
+/**
+ * Visits admin page and handle errors.
+ *
+ * @param this
+ * @param adminPath String to be serialized as pathname.
+ * @param query     String to be serialized as query portion of URL.
+ */
+export async function visitAdminPage(
+	this: Admin,
+	adminPath: string,
+	query?: string
+) {
+	await this.page.goto(
+		join( 'wp-admin', adminPath ) + ( query ? `?${ query }` : '' )
+	);
+
+	// Handle upgrade required screen
+	if ( this.pageUtils.isCurrentURL( 'wp-admin/upgrade.php' ) ) {
+		// Click update
+		await this.page.click( '.button.button-large.button-primary' );
+		// Click continue
+		await this.page.click( '.button.button-large' );
+	}
+
+	if ( this.pageUtils.isCurrentURL( 'wp-login.php' ) ) {
+		throw new Error( 'Not logged in' );
+	}
+
+	const error = await this.getPageError();
+	if ( error ) {
+		throw new Error( 'Unexpected error in page content: ' + error );
+	}
+}

package/src/admin/visit-site-editor.ts

@@ -0,0 +1,62 @@
+/**
+ * Internal dependencies
+ */
+import type { Admin } from './';
+
+interface SiteEditorOptions {
+	postId?: string | number;
+	postType?: string;
+	path?: string;
+	canvas?: string;
+	activeView?: string;
+	showWelcomeGuide?: boolean;
+}
+
+/**
+ * Visits the Site Editor main page.
+ *
+ * @param this
+ * @param options Options to visit the site editor.
+ */
+export async function visitSiteEditor(
+	this: Admin,
+	options: SiteEditorOptions = {}
+) {
+	const { postId, postType, path, canvas, activeView } = options;
+	const query = new URLSearchParams();
+
+	if ( postId ) {
+		query.set( 'postId', String( postId ) );
+	}
+	if ( postType ) {
+		query.set( 'postType', postType );
+	}
+	if ( path ) {
+		query.set( 'path', path );
+	}
+	if ( canvas ) {
+		query.set( 'canvas', canvas );
+	}
+	if ( activeView ) {
+		query.set( 'activeView', activeView );
+	}
+
+	await this.visitAdminPage( 'site-editor.php', query.toString() );
+
+	if ( ! options.showWelcomeGuide ) {
+		await this.editor.setPreferences( 'core/edit-site', {
+			welcomeGuide: false,
+			welcomeGuideStyles: false,
+			welcomeGuidePage: false,
+			welcomeGuideTemplate: false,
+		} );
+	}
+
+	/**
+	 * Wait until the editor is loaded. The logic is a copy of the
+	 * `waitWhileSiteEditorLoading` function in the `edit-site` package.
+	 */
+	if ( ! query.size || postId || canvas === 'edit' ) {
+		await this.waitForSiteEditor();
+	}
+}

package/src/admin/wait-for-site-editor.ts

@@ -0,0 +1,52 @@
+/**
+ * Internal dependencies
+ */
+import type { Admin } from './';
+
+/**
+ * Waits for the Site Editor to finish loading, i.e., for all resolvers
+ * in the `core` store to finish and then pause for a short period.
+ *
+ * @param this
+ */
+export async function waitForSiteEditor( this: Admin ) {
+	await this.page.evaluate( () => {
+		const MAX_LOADING_TIME = 10000;
+		const MAX_PAUSE_TIME = 100;
+
+		return new Promise< void >( ( resolve ) => {
+			let pauseTimeout: ReturnType< typeof setTimeout > | undefined;
+
+			function finish() {
+				unsubscribe();
+				clearTimeout( pauseTimeout );
+				clearTimeout( maxTimeout );
+				resolve();
+			}
+
+			const maxTimeout = setTimeout( finish, MAX_LOADING_TIME );
+
+			function checkResolving() {
+				const isResolving = window.wp.data
+					.select( 'core' )
+					.hasResolvingSelectors();
+
+				if ( isResolving ) {
+					clearTimeout( pauseTimeout );
+					pauseTimeout = undefined;
+					return;
+				}
+
+				if ( ! pauseTimeout ) {
+					pauseTimeout = setTimeout( finish, MAX_PAUSE_TIME );
+				}
+			}
+
+			const unsubscribe = window.wp.data.subscribe(
+				checkResolving,
+				'core'
+			);
+			checkResolving();
+		} );
+	} );
+}

package/src/config.ts

@@ -0,0 +1,12 @@
+const {
+	WP_USERNAME = 'admin',
+	WP_PASSWORD = 'password',
+	WP_BASE_URL = 'http://localhost:8889',
+} = process.env;
+
+const WP_ADMIN_USER = {
+	username: WP_USERNAME,
+	password: WP_PASSWORD,
+} as const;
+
+export { WP_ADMIN_USER, WP_USERNAME, WP_PASSWORD, WP_BASE_URL };

package/src/editor/click-block-options-menu-item.ts

@@ -0,0 +1,18 @@
+/**
+ * Internal dependencies
+ */
+import type { Editor } from './index';
+
+/**
+ * Clicks a block toolbar button.
+ *
+ * @param this
+ * @param label The text string of the button label.
+ */
+export async function clickBlockOptionsMenuItem( this: Editor, label: string ) {
+	await this.clickBlockToolbarButton( 'Options' );
+	await this.page
+		.getByRole( 'menu', { name: 'Options' } )
+		.getByRole( 'menuitem', { name: label } )
+		.click();
+}

package/src/editor/click-block-toolbar-button.ts

@@ -0,0 +1,21 @@
+/**
+ * Internal dependencies
+ */
+import type { Editor } from './index';
+
+/**
+ * Clicks a block toolbar button.
+ *
+ * @param this
+ * @param label The text string of the button label.
+ */
+export async function clickBlockToolbarButton( this: Editor, label: string ) {
+	await this.showBlockToolbar();
+
+	const blockToolbar = this.page.locator(
+		'role=toolbar[name="Block tools"i]'
+	);
+	const button = blockToolbar.locator( `role=button[name="${ label }"]` );
+
+	await button.click();
+}

package/src/editor/get-blocks.ts

@@ -0,0 +1,75 @@
+/**
+ * Internal dependencies
+ */
+import type { Editor } from './index';
+
+type Block = {
+	name: string;
+	attributes: Record< string, unknown >;
+	innerBlocks: Block[];
+};
+
+/**
+ * Returns the edited blocks.
+ *
+ * @param options
+ * @param options.clientId Limit the results to be only under a partial tree of the specified clientId.
+ * @param options.full     Whether to return the full block data or just the name and attributes.
+ *
+ * @return  The blocks.
+ */
+export async function getBlocks(
+	this: Editor,
+	{ clientId, full = false }: { clientId?: string; full?: boolean } = {}
+) {
+	await this.page.waitForFunction(
+		() => window?.wp?.blocks && window?.wp?.data
+	);
+
+	return await this.page.evaluate(
+		( [ _full, _clientId ] ) => {
+			// Serialize serializable attributes of blocks.
+			function serializeAttributes(
+				attributes: Record< string, unknown >
+			) {
+				return Object.fromEntries(
+					Object.entries( attributes ).map( ( [ key, value ] ) => {
+						// Serialize RichTextData to string.
+						if (
+							value instanceof window.wp.richText.RichTextData
+						) {
+							return [ key, ( value as string ).toString() ];
+						}
+						return [ key, value ];
+					} )
+				);
+			}
+
+			// Remove other unpredictable properties like clientId from blocks for testing purposes.
+			function recursivelyTransformBlocks( blocks: Block[] ): Block[] {
+				return blocks.map( ( block ) => ( {
+					name: block.name,
+					attributes: serializeAttributes( block.attributes ),
+					innerBlocks: recursivelyTransformBlocks(
+						block.innerBlocks
+					),
+				} ) );
+			}
+
+			const blocks = window.wp.data
+				.select( 'core/block-editor' )
+				.getBlocks( _clientId ) as Block[];
+
+			// The editor might still contain an unmodified empty block even when it's technically "empty".
+			if (
+				blocks.length === 1 &&
+				window.wp.blocks.isUnmodifiedDefaultBlock( blocks[ 0 ] )
+			) {
+				return [];
+			}
+
+			return _full ? blocks : recursivelyTransformBlocks( blocks );
+		},
+		[ full, clientId ]
+	);
+}

package/src/editor/get-edited-post-content.ts

@@ -0,0 +1,19 @@
+/**
+ * Internal dependencies
+ */
+import type { Editor } from './index';
+
+/**
+ * Returns a promise which resolves with the edited post content (HTML string).
+ *
+ * @param this
+ *
+ * @return Promise resolving with post content markup.
+ */
+export async function getEditedPostContent( this: Editor ) {
+	await this.page.waitForFunction( () => window?.wp?.data );
+
+	return await this.page.evaluate( () =>
+		window.wp.data.select( 'core/editor' ).getEditedPostContent()
+	);
+}