@tappet/cypress 0.1.0-prealpha.1 → 0.1.0

package/cypress/plugin/index.d.ts

@@ -1,4 +1,4 @@
-import UniterPlugin = require('webpack-uniter-plugin');
+import UniterPlugin from 'webpack-uniter-plugin';
 /**
  * Type of the preprocessor factory function from @cypress/webpack-preprocessor.
  */

package/cypress/plugin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts/cypress/plugin/index.ts"],"names":[],"mappings":"AAUA,OAAO,YAAY,GAAG,QAAQ,uBAAuB,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,EAAE;IAC/C,cAAc,EAAE;QACZ,OAAO,EAAE,OAAO,EAAE,CAAC;KACtB,CAAC;CACL,KAAK,OAAO,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAE1E;;GAEG;AACH,wBAAgB,YAAY,CACxB,mBAAmB,EAAE,0BAA0B,EAC/C,gBAAgB,EAAE,OAAO,YAAY,GACtC,CAAC,EAAE,EAAE,iBAAiB,KAAK,IAAI,CAWjC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAGpD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts/cypress/plugin/index.ts"],"names":[],"mappings":"AAQA,OAAO,YAAY,MAAM,uBAAuB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,EAAE;IAC/C,cAAc,EAAE;QACZ,OAAO,EAAE,OAAO,EAAE,CAAC;KACtB,CAAC;CACL,KAAK,OAAO,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAE1E;;GAEG;AACH,wBAAgB,YAAY,CACxB,mBAAmB,EAAE,0BAA0B,EAC/C,gBAAgB,EAAE,OAAO,YAAY,GACtC,CAAC,EAAE,EAAE,iBAAiB,KAAK,IAAI,CAWjC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAGpD"}

package/cypress/plugin/index.js

@@ -1,4 +1,10 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPlugin = createPlugin;
+exports.register = register;
 /*
  * Tappet Cypress - Enjoyable GUI testing with Tappet, using Cypress
  * Copyright (c) Dan Phillimore (asmblah)
@@ -7,11 +13,7 @@
  * Released under the MIT license.
  * https://github.com/nytris/tappet-cypress/raw/main/MIT-LICENSE.txt
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createPlugin = createPlugin;
-exports.register = register;
-// eslint-disable-next-line @typescript-eslint/no-require-imports
-const UniterPlugin = require("webpack-uniter-plugin");
+const webpack_uniter_plugin_1 = __importDefault(require("webpack-uniter-plugin"));
 /**
  * Creates a Cypress plugin registration function with injectable dependencies.
  */
@@ -42,6 +44,6 @@ function createPlugin(webpackPreprocessor, UniterPluginCtor) {
  */
 function register(on) {
     // eslint-disable-next-line @typescript-eslint/no-require-imports
-    createPlugin(require('@cypress/webpack-preprocessor'), UniterPlugin)(on);
+    createPlugin(require('@cypress/webpack-preprocessor'), webpack_uniter_plugin_1.default)(on);
 }
 //# sourceMappingURL=index.js.map

package/cypress/plugin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ts/cypress/plugin/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAsBH,oCAcC;AAkBD,4BAGC;AAvDD,iEAAiE;AACjE,sDAAuD;AAgBvD;;GAEG;AACH,SAAgB,YAAY,CACxB,mBAA+C,EAC/C,gBAAqC;IAErC,OAAO,CAAC,EAAqB,EAAQ,EAAE;QACnC,EAAE,CACE,mBAAmB,EACnB,mBAAmB,CAAC;YAChB,cAAc,EAAE;gBACZ,OAAO,EAAE,CAAC,IAAI,gBAAgB,EAAE,CAAC;aACpC;SACJ,CAAC,CACL,CAAC;IACN,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,QAAQ,CAAC,EAAqB;IAC1C,iEAAiE;IACjE,YAAY,CAAC,OAAO,CAAC,+BAA+B,CAAC,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;AAC7E,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ts/cypress/plugin/index.ts"],"names":[],"mappings":";;;;;AA2BA,oCAcC;AAkBD,4BAGC;AA9DD;;;;;;;GAOG;AACH,kFAAiD;AAgBjD;;GAEG;AACH,SAAgB,YAAY,CACxB,mBAA+C,EAC/C,gBAAqC;IAErC,OAAO,CAAC,EAAqB,EAAQ,EAAE;QACnC,EAAE,CACE,mBAAmB,EACnB,mBAAmB,CAAC;YAChB,cAAc,EAAE;gBACZ,OAAO,EAAE,CAAC,IAAI,gBAAgB,EAAE,CAAC;aACpC;SACJ,CAAC,CACL,CAAC;IACN,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,QAAQ,CAAC,EAAqB;IAC1C,iEAAiE;IACjE,YAAY,CAAC,OAAO,CAAC,+BAA+B,CAAC,EAAE,+BAAY,CAAC,CAAC,EAAE,CAAC,CAAC;AAC7E,CAAC"}

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.0-prealpha.1",
+  "version": "0.1.0",
   "name": "@tappet/cypress",
   "description": "Enjoyable GUI testing with Tappet, using Cypress",
   "keywords": [
@@ -23,14 +23,14 @@
   "main": "uniter/defineConfig.js",
   "types": "uniter/defineConfig.d.ts",
   "exports": {
-    ".": {
-      "require": "./uniter/defineConfig.js",
-      "types": "./uniter/defineConfig.d.ts"
-    },
     "./cypress/plugin": {
       "require": "./cypress/plugin/index.js",
       "types": "./cypress/plugin/index.d.ts"
     },
+    "./uniter/defineConfig": {
+      "require": "./uniter/defineConfig.js",
+      "types": "./uniter/defineConfig.d.ts"
+    },
     "./uniter/plugin": {
       "require": "./uniter/plugin/index.js",
       "types": "./uniter/plugin/index.d.ts"
@@ -53,6 +53,7 @@
     "test": "npm run lint:eslint:check && npm run lint:tsc:check && npm run mocha"
   },
   "dependencies": {
+    "dotphp": "^3.9.0",
     "webpack-uniter-plugin": "^0.0.1"
   },
   "peerDependencies": {
@@ -71,6 +72,7 @@
     "buildbelt": "^0.3.0",
     "chai": "^4.3.10",
     "chai-as-promised": "^7.1.1",
+    "cypress": "^14",
     "eslint": "^9.25.0",
     "eslint-config-prettier": "^10.1.2",
     "eslint-plugin-prettier": "^5.2.6",

package/uniter/bootstraps/bootstrap.php

@@ -11,13 +11,24 @@
 
 declare(strict_types=1);
 
+use Composer\Autoload\ClassLoader;
 use Tappet\Core\Environment\Environment;
 use Tappet\Core\Fixture\ModelRepository;
+use Tappet\Core\Project\ProjectRootResolver;
 use Tappet\Core\Tappet;
-use Tappet\Cypress\Automation\CypressAutomation;
+use Tappet\Cypress\Suite\CypressSuite;
+use Tappet\Suite\SuiteResolver;
 
-$automation = new CypressAutomation(tappet_get_cypress_api());
+$projectRootResolver = new ProjectRootResolver(new ReflectionClass(ClassLoader::class));
+$suiteResolver = new SuiteResolver(CypressSuite::class, [
+    tappet_get_cypress_project_root(),
+    $projectRootResolver->resolveProjectRoot()
+]);
+
+$suite = $suiteResolver->resolveSuite(tappet_get_suite_name());
+
+$automation = $suite->getAutomation(tappet_get_cypress_api());
 $modelRepository = new ModelRepository(tappet_get_fixture_api());
-$environment = new Environment($modelRepository, $automation);
+$environment = new Environment($modelRepository, $automation, tappet_get_base_url());
 
 Tappet::initialise(tappet_get_describe($modelRepository), $environment);

package/uniter/defineConfig.d.ts

@@ -1,5 +1,9 @@
+import dotPhpFactoryImport = require('dotphp');
 export interface DefineConfigOptions {
+    bootstraps?: string[];
     include?: string[];
+    stub?: Record<string, null>;
+    stubComposerAutoloadFiles?: boolean;
 }
 export interface PhpifySettings {
     bootstraps?: string[];
@@ -27,5 +31,5 @@ export interface UniterConfig {
 /**
  * Creates the Uniter configuration for Tappet Cypress.
  */
-export declare function defineConfig(relativeRootDir: string, { include }?: DefineConfigOptions): UniterConfig;
+export declare function defineConfig(configDir: string, relativeRootDir: string, { bootstraps, include, stub, stubComposerAutoloadFiles, }?: DefineConfigOptions, dotPhpFactory?: typeof dotPhpFactoryImport): UniterConfig;
 //# sourceMappingURL=defineConfig.d.ts.map

package/uniter/defineConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineConfig.d.ts","sourceRoot":"","sources":["../src/ts/uniter/defineConfig.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,mBAAmB;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,YAAY,CACxB,eAAe,EAAE,MAAM,EACvB,EAAE,OAAY,EAAE,GAAE,mBAAwB,GAC3C,YAAY,CA2Cd"}
+{"version":3,"file":"defineConfig.d.ts","sourceRoot":"","sources":["../src/ts/uniter/defineConfig.ts"],"names":[],"mappings":"AAYA,OAAO,mBAAmB,GAAG,QAAQ,QAAQ,CAAC,CAAC;AAI/C,MAAM,WAAW,mBAAmB;IAChC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,YAAY,CACxB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,EACI,UAAe,EACf,OAAY,EACZ,IAAS,EACT,yBAAgC,GACnC,GAAE,mBAAwB,EAC3B,aAAa,GAAE,OAAO,mBAAyC,GAChE,YAAY,CA0Ed"}

package/uniter/defineConfig.js

@@ -48,12 +48,29 @@ exports.defineConfig = defineConfig;
 const uniterPlugin = __importStar(require("./plugin/"));
 const path_1 = __importDefault(require("path"));
 // eslint-disable-next-line @typescript-eslint/no-require-imports
+const dotPhpFactoryImport = require("dotphp");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
 const phpEvalPlugin = require("phpruntime/src/plugin/eval");
 /**
  * Creates the Uniter configuration for Tappet Cypress.
  */
-function defineConfig(relativeRootDir, { include = [] } = {}) {
+function defineConfig(configDir, relativeRootDir, { bootstraps = [], include = [], stub = {}, stubComposerAutoloadFiles = true, } = {}, dotPhpFactory = dotPhpFactoryImport) {
     const bootstrapsDir = path_1.default.join(__dirname, 'bootstraps');
+    if (stubComposerAutoloadFiles) {
+        // Composer autoload files will cause fatal errors if missing from the bundle,
+        // as Composer require()'s them - so we must either include them (and any other modules they require)
+        // or stub them out for the browser build.
+        const dotPhp = dotPhpFactory.create(path_1.default.join(__dirname, 'env/composer/'));
+        const autoloadFilesGetterModule = dotPhp.require(path_1.default.resolve(__dirname, 'env/composer/get_autoload_files.php'));
+        const projectRoot = path_1.default.resolve(configDir, relativeRootDir);
+        const files = autoloadFilesGetterModule().execute().getNative()(projectRoot);
+        for (const file of files) {
+            // Paths must be relative to the project root.
+            const relativeFile = path_1.default.relative(projectRoot, file);
+            include.push(relativeFile);
+            stub[relativeFile] = null;
+        }
+    }
     return {
         plugins: [
             // Install PHP eval(...) support.
@@ -72,17 +89,19 @@ function defineConfig(relativeRootDir, { include = [] } = {}) {
                     // Pull in Composer's autoloader.
                     'vendor/autoload.php',
                     path_1.default.join(bootstrapsDir, 'bootstrap.php'),
+                    ...bootstraps,
                 ],
                 include: [
-                    'tests/tappet/app/**/*.php',
-                    'vendor/autoload.php',
                     'vendor/composer/**/*.php',
                     '!vendor/composer/pcre/**',
-                    'vendor/nytris/tappet/**/*.php',
-                    'vendor/nytris/tappet-cypress/**/*.php',
+                    'vendor/tappet/tappet/src/{Core,Suite}/**/*.php',
+                    'vendor/tappet/cypress/src/php/**/*.php',
                     ...include,
                 ],
                 rootDir: relativeRootDir,
+                stub: {
+                    ...stub,
+                },
             },
             phptojs: {
                 lineNumbers: true,

package/uniter/defineConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"defineConfig.js","sourceRoot":"","sources":["../src/ts/uniter/defineConfig.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,oCA8CC;AA/FD;;;;;;;GAOG;AACH,wDAA0C;AAC1C,gDAAwB;AAExB,iEAAiE;AACjE,4DAA6D;AAkC7D;;GAEG;AACH,SAAgB,YAAY,CACxB,eAAuB,EACvB,EAAE,OAAO,GAAG,EAAE,KAA0B,EAAE;IAE1C,MAAM,aAAa,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAEzD,OAAO;QACH,OAAO,EAAE;YACL,iCAAiC;YACjC,aAAa;YAEb,YAAY;SACf;QACD,QAAQ,EAAE;YACN,OAAO,EAAE;gBACL,8EAA8E;gBAC9E,iEAAiE;gBACjE,aAAa,EAAE,IAAI;aACtB;YACD,MAAM,EAAE;gBACJ,UAAU,EAAE;oBACR,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC;oBACpC,iCAAiC;oBACjC,qBAAqB;oBACrB,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC;iBAC5C;gBACD,OAAO,EAAE;oBACL,2BAA2B;oBAC3B,qBAAqB;oBACrB,0BAA0B;oBAC1B,0BAA0B;oBAC1B,+BAA+B;oBAC/B,uCAAuC;oBAEvC,GAAG,OAAO;iBACb;gBACD,OAAO,EAAE,eAAe;aAC3B;YACD,OAAO,EAAE;gBACL,WAAW,EAAE,IAAI;gBACjB,IAAI,EAAE,OAAO;gBACb,YAAY;gBACZ,aAAa,EAAE,IAAI;aACtB;SACJ;KACJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"defineConfig.js","sourceRoot":"","sources":["../src/ts/uniter/defineConfig.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDA,oCAoFC;AA1ID;;;;;;;GAOG;AACH,wDAA0C;AAC1C,gDAAwB;AAExB,iEAAiE;AACjE,8CAA+C;AAC/C,iEAAiE;AACjE,4DAA6D;AAqC7D;;GAEG;AACH,SAAgB,YAAY,CACxB,SAAiB,EACjB,eAAuB,EACvB,EACI,UAAU,GAAG,EAAE,EACf,OAAO,GAAG,EAAE,EACZ,IAAI,GAAG,EAAE,EACT,yBAAyB,GAAG,IAAI,MACX,EAAE,EAC3B,gBAA4C,mBAAmB;IAE/D,MAAM,aAAa,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAEzD,IAAI,yBAAyB,EAAE,CAAC;QAC5B,8EAA8E;QAC9E,qGAAqG;QACrG,0CAA0C;QAE1C,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAC/B,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CACxC,CAAC;QAEF,MAAM,yBAAyB,GAAG,MAAM,CAAC,OAAO,CAC5C,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,qCAAqC,CAAC,CACjE,CAAC;QAEF,MAAM,WAAW,GAAG,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAE7D,MAAM,KAAK,GAAG,yBAAyB,EAAE,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,CAC3D,WAAW,CACF,CAAC;QAEd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,8CAA8C;YAC9C,MAAM,YAAY,GAAG,cAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAEtD,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3B,IAAI,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;QAC9B,CAAC;IACL,CAAC;IAED,OAAO;QACH,OAAO,EAAE;YACL,iCAAiC;YACjC,aAAa;YAEb,YAAY;SACf;QACD,QAAQ,EAAE;YACN,OAAO,EAAE;gBACL,8EAA8E;gBAC9E,iEAAiE;gBACjE,aAAa,EAAE,IAAI;aACtB;YACD,MAAM,EAAE;gBACJ,UAAU,EAAE;oBACR,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC;oBACpC,iCAAiC;oBACjC,qBAAqB;oBACrB,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC;oBAEzC,GAAG,UAAU;iBAChB;gBACD,OAAO,EAAE;oBACL,0BAA0B;oBAC1B,0BAA0B;oBAC1B,gDAAgD;oBAChD,wCAAwC;oBAExC,GAAG,OAAO;iBACb;gBACD,OAAO,EAAE,eAAe;gBACxB,IAAI,EAAE;oBACF,GAAG,IAAI;iBACV;aACJ;YACD,OAAO,EAAE;gBACL,WAAW,EAAE,IAAI;gBACjB,IAAI,EAAE,OAAO;gBACb,YAAY;gBACZ,aAAa,EAAE,IAAI;aACtB;SACJ;KACJ,CAAC;AACN,CAAC"}

package/uniter/env/composer/get_autoload_files.php

@@ -0,0 +1,24 @@
+<?php
+
+/*
+ * Tappet Cypress - Enjoyable GUI testing with Tappet, using Cypress
+ * Copyright (c) Dan Phillimore (asmblah)
+ * https://github.com/nytris/tappet-cypress/
+ *
+ * Released under the MIT license.
+ * https://github.com/nytris/tappet-cypress/raw/main/MIT-LICENSE.txt
+ */
+
+declare(strict_types=1);
+
+/*
+ * Fetches the autoload _files_ (a list of paths always required,
+ * for defining global functions, which are not autoloaded, for example)
+ * of installed Composer dependencies.
+ */
+
+return function (string $projectRoot) {
+    $autoloadFiles = require $projectRoot . '/vendor/composer/autoload_files.php';
+
+    return array_values($autoloadFiles);
+};

package/uniter/env/composer/uniter.config.js

@@ -0,0 +1,18 @@
+/*
+ * Tappet Cypress - Enjoyable GUI testing with Tappet, using Cypress
+ * Copyright (c) Dan Phillimore (asmblah)
+ * https://github.com/nytris/tappet-cypress/
+ *
+ * Released under the MIT license.
+ * https://github.com/nytris/tappet-cypress/raw/main/MIT-LICENSE.txt
+ */
+
+module.exports = {
+    settings: {
+        phptojs: {
+            // Use sync mode when fetching the Composer autoload files,
+            // as the host application's `uniter.config.js` where this is needed will also be loaded synchronously.
+            mode: 'sync'
+        }
+    }
+};

package/uniter/plugin/phpcore.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"phpcore.config.d.ts","sourceRoot":"","sources":["../../src/ts/uniter/plugin/phpcore.config.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,sBAAsB,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GACzC,IAAI,CAAC;CACX;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE;IACpC,WAAW,EAAE,iBAAiB,CAAC;CAClC,KAAK,IAAI,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;CACzC;AAED;;;;;GAKG;AACH,eAAO,MAAM,MAAM,EAAE,WAAW,EAuH/B,CAAC"}
+{"version":3,"file":"phpcore.config.d.ts","sourceRoot":"","sources":["../../src/ts/uniter/plugin/phpcore.config.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,sBAAsB,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GACzC,IAAI,CAAC;CACX;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE;IACpC,WAAW,EAAE,iBAAiB,CAAC;CAClC,KAAK,IAAI,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;CACzC;AAED;;;;;GAKG;AACH,eAAO,MAAM,MAAM,EAAE,WAAW,EAyO/B,CAAC"}

package/uniter/plugin/phpcore.config.js

@@ -21,49 +21,114 @@ exports.addons = [
             ({ environment }) => {
                 const cypressWindow = window;
                 const { describe, it, cy, Cypress, fetch } = cypressWindow;
-                const apiBaseUrl = Cypress.env('tappetBaseUrl');
+                const apiBaseUrl = Cypress.env('tappetApiBaseUrl');
+                if (!apiBaseUrl) {
+                    throw new Error('Tappet Cypress: Cypress environment variable "tappetApiBaseUrl" not set');
+                }
+                const apiKey = Cypress.env('tappetApiKey');
+                if (!apiKey) {
+                    throw new Error('Tappet Cypress: Cypress environment variable "tappetApiKey" not set');
+                }
+                environment.defineCoercingFunction('tappet_get_base_url', () => {
+                    return Cypress.config('baseUrl');
+                });
                 environment.defineCoercingFunction('tappet_get_fixture_api', () => {
                     return {
-                        loadFixture: async (fixtureFqcn, fixturePayload) => {
-                            return (await fetch(apiBaseUrl + '/load/' + fixtureFqcn, {
+                        loadFixture: async (fixtureClass, fixturePayload) => {
+                            const response = await fetch(apiBaseUrl +
+                                '/.well-known/tappet/fixture/' +
+                                fixtureClass.replace(/\\/g, '--'), {
                                 method: 'POST',
-                                body: fixturePayload,
-                            })).text();
+                                headers: {
+                                    Authorization: `Bearer ${apiKey}`,
+                                    'Content-Type': 'application/json',
+                                },
+                                // JSON-encode the fixture serialisation payload,
+                                // as it may contain special characters.
+                                body: JSON.stringify({
+                                    serialisation: fixturePayload,
+                                }),
+                            });
+                            // Response fixture model's serialisation payload will be JSON-encoded
+                            // to support special characters.
+                            return (await response.json()).serialisation;
                         },
-                        purge: async (modelsToPurge) => {
-                            return (await fetch(apiBaseUrl + '/purge', {
+                        loadMultipleFixtures: async (fixturesPayload) => {
+                            const response = await fetch(apiBaseUrl + '/.well-known/tappet/fixtures', {
                                 method: 'POST',
+                                headers: {
+                                    Authorization: `Bearer ${apiKey}`,
+                                    'Content-Type': 'application/json',
+                                },
+                                // JSON-encode the fixture serialisation payload,
+                                // as it may contain special characters.
+                                body: JSON.stringify({
+                                    serialisation: fixturesPayload,
+                                }),
+                            });
+                            // Response fixture models' serialisation payload will be JSON-encoded
+                            // to support special characters.
+                            return (await response.json()).serialisation;
+                        },
+                        purge: async (modelsToPurge) => {
+                            await fetch(apiBaseUrl + '/.well-known/tappet/fixtures', {
+                                method: 'DELETE',
+                                headers: {
+                                    Authorization: `Bearer ${apiKey}`,
+                                },
                                 body: JSON.stringify(modelsToPurge),
-                            })).text();
+                            });
                         },
                     };
                 });
                 environment.defineCoercingFunction('tappet_get_cypress_api', () => {
                     return cy;
                 });
+                const filterString = Cypress.env('tappetFilter');
+                const filterRegex = filterString
+                    ? new RegExp(filterString)
+                    : null;
                 environment.defineCoercingFunction('tappet_get_describe', (modelRepository) => {
-                    return async (suite) => {
+                    return async (module) => {
                         const scenarios = [];
-                        for (const scenario of await suite.getScenarios()) {
+                        for (const scenario of await module.getScenarios()) {
                             scenarios.push({
                                 description: await scenario.getDescription(),
                                 scenario: scenario,
                             });
                         }
-                        describe(await suite.getDescription(), () => {
+                        const moduleDescription = await module.getDescription();
+                        const moduleMatchesFilter = filterRegex === null ||
+                            filterRegex.test(moduleDescription);
+                        describe(moduleDescription, () => {
                             beforeEach(() => {
                                 // TODO: scenario.beforeEach()?
                                 // Perform cleanup inside Mocha beforeEach so that it happens regardless of errors.
                                 cy.then(() => modelRepository.purge());
                             });
                             for (const { description, scenario, } of scenarios) {
-                                it(description, () => {
+                                const scenarioMatchesFilter = moduleMatchesFilter ||
+                                    filterRegex.test(description);
+                                (scenarioMatchesFilter ? it : it.skip)(description, () => {
                                     return cy.then(() => scenario.perform());
                                 });
                             }
                         });
                     };
                 });
+                const cypressProjectRoot = Cypress.config('projectRoot');
+                const repoRoot = Cypress.config('repoRoot');
+                const projectRoot = cypressProjectRoot.startsWith(repoRoot)
+                    ? cypressProjectRoot.substring(repoRoot.length + 1)
+                    : cypressProjectRoot;
+                environment.defineCoercingFunction('tappet_get_cypress_project_root', () => projectRoot);
+                const suiteName = Cypress.env('tappetSuite');
+                if (!suiteName) {
+                    throw new Error('Tappet Cypress: Cypress environment variable "tappetSuite" not set');
+                }
+                environment.defineCoercingFunction('tappet_get_suite_name', () => {
+                    return suiteName;
+                });
             },
         ],
     },

package/uniter/plugin/phpcore.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"phpcore.config.js","sourceRoot":"","sources":["../../src/ts/uniter/plugin/phpcore.config.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA0BH;;;;;GAKG;AACU,QAAA,MAAM,GAAkB;IACjC;QACI,iBAAiB,EAAE;YACf,CAAC,EAAE,WAAW,EAAsC,EAAQ,EAAE;gBAC1D,MAAM,aAAa,GAAG,MAUrB,CAAC;gBAEF,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,aAAa,CAAC;gBAE3D,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;gBAEhD,WAAW,CAAC,sBAAsB,CAC9B,wBAAwB,EACxB,GAAG,EAAE;oBACD,OAAO;wBACH,WAAW,EAAE,KAAK,EACd,WAAmB,EACnB,cAAsB,EACxB,EAAE;4BACA,OAAO,CACH,MAAM,KAAK,CACP,UAAU,GAAG,QAAQ,GAAG,WAAW,EACnC;gCACI,MAAM,EAAE,MAAM;gCACd,IAAI,EAAE,cAAc;6BACvB,CACJ,CACJ,CAAC,IAAI,EAAE,CAAC;wBACb,CAAC;wBACD,KAAK,EAAE,KAAK,EACR,aAGG,EACL,EAAE;4BACA,OAAO,CACH,MAAM,KAAK,CAAC,UAAU,GAAG,QAAQ,EAAE;gCAC/B,MAAM,EAAE,MAAM;gCACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;6BACtC,CAAC,CACL,CAAC,IAAI,EAAE,CAAC;wBACb,CAAC;qBACJ,CAAC;gBACN,CAAC,CACJ,CAAC;gBAEF,WAAW,CAAC,sBAAsB,CAC9B,wBAAwB,EACxB,GAAG,EAAE;oBACD,OAAO,EAAE,CAAC;gBACd,CAAC,CACJ,CAAC;gBAEF,WAAW,CAAC,sBAAsB,CAC9B,qBAAqB,EACrB,CAAC,eAAwB,EAAE,EAAE;oBACzB,OAAO,KAAK,EAAE,KAQb,EAAE,EAAE;wBACD,MAAM,SAAS,GAKT,EAAE,CAAC;wBAET,KAAK,MAAM,QAAQ,IAAI,MAAM,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC;4BAChD,SAAS,CAAC,IAAI,CAAC;gCACX,WAAW,EACP,MAAM,QAAQ,CAAC,cAAc,EAAE;gCACnC,QAAQ,EAAE,QAAQ;6BACrB,CAAC,CAAC;wBACP,CAAC;wBAED,QAAQ,CAAC,MAAM,KAAK,CAAC,cAAc,EAAE,EAAE,GAAG,EAAE;4BACxC,UAAU,CAAC,GAAG,EAAE;gCACZ,+BAA+B;gCAC/B,mFAAmF;gCACnF,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAEL,eAGH,CAAC,KAAK,EAAE,CACZ,CAAC;4BACN,CAAC,CAAC,CAAC;4BAEH,KAAK,MAAM,EACP,WAAW,EACX,QAAQ,GACX,IAAI,SAAS,EAAE,CAAC;gCACb,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;oCACjB,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAChB,QAAQ,CAAC,OAAO,EAAE,CACrB,CAAC;gCACN,CAAC,CAAC,CAAC;4BACP,CAAC;wBACL,CAAC,CAAC,CAAC;oBACP,CAAC,CAAC;gBACN,CAAC,CACJ,CAAC;YACN,CAAC;SACJ;KACJ;CACJ,CAAC"}
+{"version":3,"file":"phpcore.config.js","sourceRoot":"","sources":["../../src/ts/uniter/plugin/phpcore.config.ts"],"names":[],"mappings":"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"}