Improve local dev setup with Composer and PHPUnit in Docker container

- Remove dependency on globally installed Composer
- Provide a way to install and run Composer and PHPUnit in the container created by wp-env
- Start basic PHPUnit tests in addition to existing unit tests (using wp-now) and E2E tests (Playwright)
- Document local dev/test/build setup

Author: eliot-akira

.gitignore

@@ -1,197 +1,23 @@
+/artifacts
 /publish
 /vendor
 node_modules
-.idea
 *.log
 *.local.js
 
-# Support any package manager
-composer.lock
+# Ignore lock files to allow any package manager
+bun.lock
+bun.lockb
 package-lock.json
 yarn.lock
-bun.lockb
 
+# Testing
+/.phpunit.cache
+/.wp-env.override.json
 /artifacts
-*.swp
 /coverage
-/.phpunit.cache
-/wordpress-develop
-
-# https://developer.wordpress.org/block-editor/reference-guides/packages/packages-env/#wp-env-override-json
-.wp-env.override.json
-
-# Based on https://raw.githubusercontent.com/github/gitignore/main/Node.gitignore
-
-# Logs
-
-logs
-_.log
-npm-debug.log_
-yarn-debug.log*
-yarn-error.log*
-lerna-debug.log*
-.pnpm-debug.log*
-
-# Diagnostic reports (https://nodejs.org/api/report.html)
-
-report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
-
-# Runtime data
-
-pids
-_.pid
-_.seed
-\*.pid.lock
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-
-lib-cov
-
-# Coverage directory used by tools like istanbul
-
-coverage
-\*.lcov
-
-# nyc test coverage
-
-.nyc_output
-
-# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
-
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-
-bower_components
-
-# node-waf configuration
-
-.lock-wscript
-
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-
-build/Release
-
-# Dependency directories
-
-node_modules/
-jspm_packages/
-
-# Snowpack dependency directory (https://snowpack.dev/)
-
-web_modules/
-
-# TypeScript cache
-
-\*.tsbuildinfo
-
-# Optional npm cache directory
-
-.npm
-
-# Optional eslint cache
-
-.eslintcache
-
-# Optional stylelint cache
-
-.stylelintcache
+/test-results
+wordpress-develop
 
-# Microbundle cache
-
-.rpt2_cache/
-.rts2_cache_cjs/
-.rts2_cache_es/
-.rts2_cache_umd/
-
-# Optional REPL history
-
-.node_repl_history
-
-# Output of 'npm pack'
-
-\*.tgz
-
-# Yarn Integrity file
-
-.yarn-integrity
-
-# dotenv environment variable files
-
-.env
-.env.development.local
-.env.test.local
-.env.production.local
-.env.local
-
-# parcel-bundler cache (https://parceljs.org/)
-
-.cache
-.parcel-cache
-
-# Next.js build output
-
-.next
-out
-
-# Nuxt.js build / generate output
-
-.nuxt
-dist
-
-# Gatsby files
-
-.cache/
-
-# Comment in the public line in if your project uses Gatsby and not Next.js
-
-# https://nextjs.org/blog/next-9-1#public-directory-support
-
-# public
-
-# vuepress build output
-
-.vuepress/dist
-
-# vuepress v2.x temp and cache directory
-
-.temp
-.cache
-
-# Docusaurus cache and generated files
-
-.docusaurus
-
-# Serverless directories
-
-.serverless/
-
-# FuseBox cache
-
-.fusebox/
-
-# DynamoDB Local files
-
-.dynamodb/
-
-# TernJS port file
-
-.tern-port
-
-# Stores VSCode versions used for testing VSCode extensions
-
-.vscode-test
-
-# yarn v2
-
-.yarn/cache
-.yarn/unplugged
-.yarn/build-state.yml
-.yarn/install-state.gz
-.pnp.\*
-
-# IntelliJ based IDEs
+*.swp
 .idea
-
-# Finder (MacOS) folder config
-.DS_Store

.prettierrc

@@ -0,0 +1,6 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "useTabs": false
+}

.wp-env.json

@@ -1,10 +1,7 @@
 {
   "core": "WordPress/WordPress",
   "phpVersion": "8.2",
-  "plugins": [
-    "."
-  ],
+  "plugins": ["."],
   "mappings": {
-    "wp-content/plugins/e2e-plugin": "./vendor/tangible/framework/env/e2e-plugin"
   }
 }

assets/build/admin.min.css

@@ -1,17 +1,28 @@
 {
   "landingPage": "/wp-admin/options-general.php?page=example-plugin-settings",
   "steps": [
+    {
+      "step": "setSiteOptions",
+      "options": {
+        "blogname": "Example Plugin",
+        "blogdescription": ""
+      }
+    },
     {
       "step": "defineWpConfigConsts",
       "consts": {
-          "WP_DEBUG": true
+        "WP_DEBUG": true
       },
       "method": "rewrite-wp-config"
     },
+    {
+      "step": "login",
+      "username": "admin"
+    },
     {
       "step": "activatePlugin",
-      "pluginName": "E2E",
-      "pluginPath": "/var/www/html/wp-content/plugins/e2e-plugin"
+      "pluginName": "Example Plugin",
+      "pluginPath": "/var/www/html/wp-content/plugins/example-plugin"
     }
   ]
 }

assets/build/admin.min.css.map

@@ -0,0 +1,7 @@
+{
+  "require-dev": {
+    "phpunit/phpunit": "9.6.x-dev",
+    "yoast/phpunit-polyfills": "2.x-dev"
+  },
+  "minimum-stability": "dev"
+}