@serenity-js/protractor 3.25.0 → 3.25.1

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.25.1](https://github.com/serenity-js/serenity-js/compare/v3.25.0...v3.25.1) (2024-07-10)
+
+
+### Bug Fixes
+
+* **core:** all the API docs now link to the online Serenity/JS API documentation ([f8f451d](https://github.com/serenity-js/serenity-js/commit/f8f451dffdb4caaa2e31a860f59d59470f4856ad))
+
+
+
+
+
 # [3.25.0](https://github.com/serenity-js/serenity-js/compare/v3.24.1...v3.25.0) (2024-07-03)
 
 

package/README.md

@@ -17,7 +17,7 @@ of complex software systems faster, more collaborative and easier to scale.
 👋 Join the Serenity/JS Community!
 - Meet other Serenity/JS developers and maintainers on the [Serenity/JS Community chat channel](https://matrix.to/#/#serenity-js:gitter.im),
 - Find answers to your Serenity/JS questions on the [Serenity/JS Forum](https://github.com/orgs/serenity-js/discussions/categories/how-do-i),
-- Learn how to [contribute to Serenity/JS](https://serenity-js.org/contributing),
+- Learn how to [contribute to Serenity/JS](https://serenity-js.org/community/contributing/),
 - Support the project and gain access to [Serenity/JS Playbooks](https://github.com/serenity-js/playbooks) by becoming a [Serenity/JS GitHub Sponsor](https://github.com/sponsors/serenity-js)!
 
 ## Serenity/JS Protractor

package/lib/adapter/Config.d.ts

@@ -6,14 +6,14 @@ import type { Config as ProtractorConfig } from 'protractor';
  *
  * ## Learn more
  * - [Protractor config](https://github.com/angular/protractor/blob/master/lib/config.ts)
- * - {@apilink SerenityConfig}
- * - {@apilink configure}
+ * - [`SerenityConfig`](https://serenity-js.org/api/core/class/SerenityConfig/)
+ * - [`configure`](https://serenity-js.org/api/core/function/configure/)
  *
  * @group Configuration
  */
 export interface Config extends ProtractorConfig {
     /**
-     * See {@apilink SerenityConfig}
+     * See [`SerenityConfig`](https://serenity-js.org/api/core/class/SerenityConfig/)
      */
     serenity: SerenityConfig & {
         runner?: string;

package/lib/adapter/reporter/ProtractorReport.d.ts

@@ -1,6 +1,7 @@
 import type { SpecResult } from 'protractor/built/plugins';
 /**
- * A JSON object which needs to be returned to Protractor when {@apilink ProtractorFrameworkAdapter}
+ * A JSON object which needs to be returned to Protractor
+ * when [`ProtractorFrameworkAdapter`](https://serenity-js.org/api/protractor-adapter/function/run/)
  * is done with executing the test scenarios.
  *
  * ## Learn more

package/lib/adapter/reporter/ProtractorReport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProtractorReport.d.ts","sourceRoot":"","sources":["../../../src/adapter/reporter/ProtractorReport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,WAAW,EAAE,KAAK,CAAC,UAAU,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD"}
+{"version":3,"file":"ProtractorReport.d.ts","sourceRoot":"","sources":["../../../src/adapter/reporter/ProtractorReport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,WAAW,EAAE,KAAK,CAAC,UAAU,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD"}

package/lib/adapter/runner/TestRunnerDetector.d.ts

@@ -2,7 +2,7 @@ import type { TestRunnerAdapter } from '@serenity-js/core/lib/adapter';
 import type { Config as ProtractorConfig } from 'protractor';
 import type { TestRunnerLoader } from './TestRunnerLoader';
 /**
- * Detects the {@apilink TestRunnerAdapter} to use,
+ * Detects the [`TestRunnerAdapter`](https://serenity-js.org/api/core-adapter/interface/TestRunnerAdapter/) to use,
  * based on Protractor configuration.
  *
  * @group Integration

package/lib/adapter/runner/TestRunnerDetector.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TestRunnerDetector = void 0;
 /**
- * Detects the {@apilink TestRunnerAdapter} to use,
+ * Detects the [`TestRunnerAdapter`](https://serenity-js.org/api/core-adapter/interface/TestRunnerAdapter/) to use,
  * based on Protractor configuration.
  *
  * @group Integration

package/lib/adapter/runner/TestRunnerLoader.d.ts

@@ -2,7 +2,7 @@ import type { TestRunnerAdapter } from '@serenity-js/core/lib/adapter';
 import { Path } from '@serenity-js/core/lib/io';
 import type { CucumberAdapterConfig } from './CucumberAdapterConfig';
 /**
- * Loads a {@apilink TestRunnerAdapter} needed to invoke
+ * Loads a [`TestRunnerAdapter`](https://serenity-js.org/api/core-adapter/interface/TestRunnerAdapter/) needed to invoke
  * the chosen test runner programmatically.
  *
  * @group Integration
@@ -16,9 +16,9 @@ export declare class TestRunnerLoader {
      * @param cwd
      *  Current working directory; used to resolve glob paths to files for Cucumber.js to `require`,
      *  and instructing Serenity/JS where to look for this module's optional
-     *  dependencies, like [`@serenity-js/cucumber`](/api/cucumber),
-     *  [`@serenity-js/mocha`](/api/mocha),
-     *  [`@serenity-js/jasmine`](/api/jasmine), etc.
+     *  dependencies, like [`@serenity-js/cucumber`](https://serenity-js.org/api/cucumber),
+     *  [`@serenity-js/mocha`](https://serenity-js.org/api/mocha),
+     *  [`@serenity-js/jasmine`](https://serenity-js.org/api/jasmine), etc.
      *
      * @param runnerId
      *  Unique identifier used to differentiate output files produced by native Cucumber.js formatters.
@@ -26,19 +26,19 @@ export declare class TestRunnerLoader {
      */
     constructor(cwd: Path, runnerId: number | string);
     /**
-     * See {@apilink JasmineConfig}
+     * See [`JasmineConfig`](https://serenity-js.org/api/jasmine-adapter/interface/JasmineConfig/)
      *
      * @param jasmineNodeOpts
      */
     forJasmine(jasmineNodeOpts: object): TestRunnerAdapter;
     /**
-     * See {@apilink MochaConfig}
+     * See [`MochaConfig`](https://serenity-js.org/api/mocha-adapter/interface/MochaConfig/)
      *
      * @param mochaOpts
      */
     forMocha(mochaOpts: object): TestRunnerAdapter;
     /**
-     * See {@apilink CucumberConfig}
+     * See [`CucumberConfig`](https://serenity-js.org/api/cucumber-adapter/interface/CucumberConfig/)
      *
      * @param cucumberOpts
      * @param adapterConfig

package/lib/adapter/runner/TestRunnerLoader.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TestRunnerLoader = void 0;
 const io_1 = require("@serenity-js/core/lib/io");
 /**
- * Loads a {@apilink TestRunnerAdapter} needed to invoke
+ * Loads a [`TestRunnerAdapter`](https://serenity-js.org/api/core-adapter/interface/TestRunnerAdapter/) needed to invoke
  * the chosen test runner programmatically.
  *
  * @group Integration
@@ -17,9 +17,9 @@ class TestRunnerLoader {
      * @param cwd
      *  Current working directory; used to resolve glob paths to files for Cucumber.js to `require`,
      *  and instructing Serenity/JS where to look for this module's optional
-     *  dependencies, like [`@serenity-js/cucumber`](/api/cucumber),
-     *  [`@serenity-js/mocha`](/api/mocha),
-     *  [`@serenity-js/jasmine`](/api/jasmine), etc.
+     *  dependencies, like [`@serenity-js/cucumber`](https://serenity-js.org/api/cucumber),
+     *  [`@serenity-js/mocha`](https://serenity-js.org/api/mocha),
+     *  [`@serenity-js/jasmine`](https://serenity-js.org/api/jasmine), etc.
      *
      * @param runnerId
      *  Unique identifier used to differentiate output files produced by native Cucumber.js formatters.
@@ -32,7 +32,7 @@ class TestRunnerLoader {
         this.finder = new io_1.FileFinder(cwd);
     }
     /**
-     * See {@apilink JasmineConfig}
+     * See [`JasmineConfig`](https://serenity-js.org/api/jasmine-adapter/interface/JasmineConfig/)
      *
      * @param jasmineNodeOpts
      */
@@ -41,7 +41,7 @@ class TestRunnerLoader {
         return new JasmineAdapter(jasmineNodeOpts, this.moduleLoader);
     }
     /**
-     * See {@apilink MochaConfig}
+     * See [`MochaConfig`](https://serenity-js.org/api/mocha-adapter/interface/MochaConfig/)
      *
      * @param mochaOpts
      */
@@ -50,7 +50,7 @@ class TestRunnerLoader {
         return new MochaAdapter(mochaOpts, this.moduleLoader);
     }
     /**
-     * See {@apilink CucumberConfig}
+     * See [`CucumberConfig`](https://serenity-js.org/api/cucumber-adapter/interface/CucumberConfig/)
      *
      * @param cucumberOpts
      * @param adapterConfig

package/lib/screenplay/abilities/BrowseTheWebWithProtractor.d.ts

@@ -1,8 +1,8 @@
 import { BrowseTheWeb } from '@serenity-js/web';
 import type * as protractor from 'protractor';
 /**
- * This implementation of the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * enables the {@apilink Actor} to interact with web front-ends using [Protractor](http://www.protractortest.org/#/).
+ * This implementation of the [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * enables the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to interact with web front-ends using [Protractor](http://www.protractortest.org/#/).
  *
  * ## Using Protractor to `BrowseTheWeb`
  *
@@ -28,9 +28,9 @@ import type * as protractor from 'protractor';
  *
  * ## Learn more
  * - [Protractor website](https://www.protractortest.org/)
- * - {@apilink BrowseTheWeb}
- * - {@apilink Ability}
- * - {@apilink Actor}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
+ * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
  *
  * @group Abilities
  */
@@ -83,7 +83,7 @@ export declare class BrowseTheWebWithProtractor extends BrowseTheWeb<protractor.
      * @param path
      *  Either a name or a dot-delimited path to the param.
      *
-     * @throws {@apilink ConfigurationError}
+     * @throws [`ConfigurationError`](https://serenity-js.org/api/core/class/ConfigurationError/)
      *  Throws a `ConfigurationError` if the parameter is `undefined`
      */
     param<T = any>(path: string): T;

package/lib/screenplay/abilities/BrowseTheWebWithProtractor.js

@@ -5,8 +5,8 @@ const core_1 = require("@serenity-js/core");
 const web_1 = require("@serenity-js/web");
 const models_1 = require("../models");
 /**
- * This implementation of the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * enables the {@apilink Actor} to interact with web front-ends using [Protractor](http://www.protractortest.org/#/).
+ * This implementation of the [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * enables the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to interact with web front-ends using [Protractor](http://www.protractortest.org/#/).
  *
  * ## Using Protractor to `BrowseTheWeb`
  *
@@ -32,9 +32,9 @@ const models_1 = require("../models");
  *
  * ## Learn more
  * - [Protractor website](https://www.protractortest.org/)
- * - {@apilink BrowseTheWeb}
- * - {@apilink Ability}
- * - {@apilink Actor}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
+ * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
  *
  * @group Abilities
  */
@@ -92,7 +92,7 @@ class BrowseTheWebWithProtractor extends web_1.BrowseTheWeb {
      * @param path
      *  Either a name or a dot-delimited path to the param.
      *
-     * @throws {@apilink ConfigurationError}
+     * @throws [`ConfigurationError`](https://serenity-js.org/api/core/class/ConfigurationError/)
      *  Throws a `ConfigurationError` if the parameter is `undefined`
      */
     param(path) {

package/lib/screenplay/interactions/UseAngular.d.ts

@@ -1,6 +1,6 @@
 import { Interaction } from '@serenity-js/core';
 /**
- * Instructs the {@apilink Actor} to enable or disable automated synchronisation between Protractor and Angular 1.x application.
+ * Instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to enable or disable automated synchronisation between Protractor and Angular 1.x application.
  *
  * Useful when a test scenario needs to interact with both Angular-based
  * and non-Angular web apps, e.g. use an external sign-in form.
@@ -51,12 +51,12 @@ import { Interaction } from '@serenity-js/core';
  */
 export declare class UseAngular {
     /**
-     * Produces an {@apilink Interaction} that instructs the {@apilink Actor} to disable
+     * Produces an [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) that instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to disable
      * synchronisation between Protractor and an Angular 1.x app.
      */
     static disableSynchronisation(): Interaction;
     /**
-     * Produces an {@apilink Interaction} that instructs the {@apilink Actor} to enable
+     * Produces an [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) that instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to enable
      * synchronisation between Protractor and an Angular 1.x app.
      */
     static enableSynchronisation(): Interaction;

package/lib/screenplay/interactions/UseAngular.js

@@ -4,7 +4,7 @@ exports.UseAngular = void 0;
 const core_1 = require("@serenity-js/core");
 const abilities_1 = require("../abilities");
 /**
- * Instructs the {@apilink Actor} to enable or disable automated synchronisation between Protractor and Angular 1.x application.
+ * Instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to enable or disable automated synchronisation between Protractor and Angular 1.x application.
  *
  * Useful when a test scenario needs to interact with both Angular-based
  * and non-Angular web apps, e.g. use an external sign-in form.
@@ -55,7 +55,7 @@ const abilities_1 = require("../abilities");
  */
 class UseAngular {
     /**
-     * Produces an {@apilink Interaction} that instructs the {@apilink Actor} to disable
+     * Produces an [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) that instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to disable
      * synchronisation between Protractor and an Angular 1.x app.
      */
     static disableSynchronisation() {
@@ -65,7 +65,7 @@ class UseAngular {
         });
     }
     /**
-     * Produces an {@apilink Interaction} that instructs the {@apilink Actor} to enable
+     * Produces an [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) that instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to enable
      * synchronisation between Protractor and an Angular 1.x app.
      */
     static enableSynchronisation() {

package/lib/screenplay/models/ProtractorBrowsingSession.d.ts

@@ -3,7 +3,7 @@ import { BrowsingSession } from '@serenity-js/web';
 import type * as protractor from 'protractor';
 import { ProtractorPage } from '../models';
 /**
- * Protractor-specific implementation of {@apilink BrowsingSession}.
+ * Protractor-specific implementation of [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/).
  *
  * @group Models
  */

package/lib/screenplay/models/ProtractorBrowsingSession.js

@@ -8,7 +8,7 @@ const promised_1 = require("../promised");
 const ProtractorErrorHandler_1 = require("./ProtractorErrorHandler");
 const ProtractorModalDialogHandler_1 = require("./ProtractorModalDialogHandler");
 /**
- * Protractor-specific implementation of {@apilink BrowsingSession}.
+ * Protractor-specific implementation of [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/).
  *
  * @group Models
  */

package/lib/screenplay/models/ProtractorCookie.d.ts

@@ -2,7 +2,7 @@ import type { CookieData } from '@serenity-js/web';
 import { Cookie } from '@serenity-js/web';
 import type { ProtractorBrowser } from 'protractor';
 /**
- * Protractor-specific implementation of {@apilink Cookie}.
+ * Protractor-specific implementation of [`Cookie`](https://serenity-js.org/api/web/class/Cookie/).
  *
  * @group Models
  */

package/lib/screenplay/models/ProtractorCookie.js

@@ -6,7 +6,7 @@ const web_1 = require("@serenity-js/web");
 const tiny_types_1 = require("tiny-types");
 const promised_1 = require("../promised");
 /**
- * Protractor-specific implementation of {@apilink Cookie}.
+ * Protractor-specific implementation of [`Cookie`](https://serenity-js.org/api/web/class/Cookie/).
  *
  * @group Models
  */

package/lib/screenplay/models/ProtractorModalDialogHandler.d.ts

@@ -3,7 +3,7 @@ import { ModalDialogHandler } from '@serenity-js/web';
 import type * as protractor from 'protractor';
 import type { ProtractorErrorHandler } from './ProtractorErrorHandler';
 /**
- * Protractor-specific implementation of {@apilink ModalDialogHandler}.
+ * Protractor-specific implementation of [`ModalDialogHandler`](https://serenity-js.org/api/web/class/ModalDialogHandler/).
  *
  * @group Models
  */

package/lib/screenplay/models/ProtractorModalDialogHandler.js

@@ -5,7 +5,7 @@ const web_1 = require("@serenity-js/web");
 const protractor_1 = require("protractor");
 const promised_1 = require("../promised");
 /**
- * Protractor-specific implementation of {@apilink ModalDialogHandler}.
+ * Protractor-specific implementation of [`ModalDialogHandler`](https://serenity-js.org/api/web/class/ModalDialogHandler/).
  *
  * @group Models
  */

package/lib/screenplay/models/ProtractorPage.d.ts

@@ -7,7 +7,7 @@ import { URL } from 'url';
 import type { ProtractorBrowsingSession } from './ProtractorBrowsingSession';
 import type { ProtractorErrorHandler } from './ProtractorErrorHandler';
 /**
- * Protractor-specific implementation of {@apilink Page}.
+ * Protractor-specific implementation of [`Page`](https://serenity-js.org/api/web/class/Page/).
  *
  * @group Models
  */

package/lib/screenplay/models/ProtractorPage.js

@@ -34,7 +34,7 @@ const ProtractorSelectors_1 = require("./locators/ProtractorSelectors");
 const ProtractorCookie_1 = require("./ProtractorCookie");
 const ProtractorPageElement_1 = require("./ProtractorPageElement");
 /**
- * Protractor-specific implementation of {@apilink Page}.
+ * Protractor-specific implementation of [`Page`](https://serenity-js.org/api/web/class/Page/).
  *
  * @group Models
  */

package/lib/screenplay/models/ProtractorPageElement.d.ts

@@ -2,7 +2,7 @@ import type { SwitchableOrigin } from '@serenity-js/web';
 import { PageElement, SelectOption } from '@serenity-js/web';
 import type { ElementFinder } from 'protractor';
 /**
- * Protractor-specific implementation of {@apilink PageElement}.
+ * Protractor-specific implementation of [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
  * @group Models
  */

package/lib/screenplay/models/ProtractorPageElement.js

@@ -30,7 +30,7 @@ const scripts = __importStar(require("@serenity-js/web/lib/scripts"));
 const protractor_1 = require("protractor");
 const promised_1 = require("../promised");
 /**
- * Protractor-specific implementation of {@apilink PageElement}.
+ * Protractor-specific implementation of [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
  * @group Models
  */

package/lib/screenplay/models/locators/ProtractorLocator.d.ts

@@ -4,7 +4,7 @@ import type * as protractor from 'protractor';
 import type { ProtractorErrorHandler } from '../ProtractorErrorHandler';
 import type { ProtractorRootLocator } from './ProtractorRootLocator';
 /**
- * Protractor-specific implementation of {@apilink Locator}.
+ * Protractor-specific implementation of [`Locator`](https://serenity-js.org/api/web/class/Locator/).
  *
  * @group Models
  */

package/lib/screenplay/models/locators/ProtractorLocator.js

@@ -7,7 +7,7 @@ const unpromisedWebElement_1 = require("../../unpromisedWebElement");
 const ProtractorPageElement_1 = require("../ProtractorPageElement");
 const ProtractorSelectors_1 = require("./ProtractorSelectors");
 /**
- * Protractor-specific implementation of {@apilink Locator}.
+ * Protractor-specific implementation of [`Locator`](https://serenity-js.org/api/web/class/Locator/).
  *
  * @group Models
  */

package/lib/screenplay/models/locators/ProtractorRootLocator.d.ts

@@ -1,7 +1,7 @@
 import { RootLocator } from '@serenity-js/web';
 import type * as protractor from 'protractor';
 /**
- * Protractor-specific implementation of {@apilink RootLocator}.
+ * Protractor-specific implementation of [`RootLocator`](https://serenity-js.org/api/web/class/RootLocator/).
  *
  * @group Models
  */

package/lib/screenplay/models/locators/ProtractorRootLocator.js

@@ -4,7 +4,7 @@ exports.ProtractorRootLocator = void 0;
 const web_1 = require("@serenity-js/web");
 const promised_1 = require("../../promised");
 /**
- * Protractor-specific implementation of {@apilink RootLocator}.
+ * Protractor-specific implementation of [`RootLocator`](https://serenity-js.org/api/web/class/RootLocator/).
  *
  * @group Models
  */

package/lib/screenplay/questions/ProtractorParam.d.ts

@@ -56,7 +56,7 @@ import type { Answerable, QuestionAdapter } from '@serenity-js/core';
  * ```
  *
  * ## Learn more
- * - {@apilink BrowseTheWebWithProtractor.param}
+ * - [`BrowseTheWebWithProtractor.param`](https://serenity-js.org/api/protractor/class/BrowseTheWebWithProtractor/#param)
  *
  * @group Questions
  */

package/lib/screenplay/questions/ProtractorParam.js

@@ -60,7 +60,7 @@ const abilities_1 = require("../abilities");
  * ```
  *
  * ## Learn more
- * - {@apilink BrowseTheWebWithProtractor.param}
+ * - [`BrowseTheWebWithProtractor.param`](https://serenity-js.org/api/protractor/class/BrowseTheWebWithProtractor/#param)
  *
  * @group Questions
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/protractor",
-  "version": "3.25.0",
+  "version": "3.25.1",
   "description": "Test your web apps with Serenity/JS",
   "author": {
     "name": "Jan Molak",
@@ -49,9 +49,9 @@
     "node": "^16.13 || ^18.12 || ^20"
   },
   "dependencies": {
-    "@serenity-js/core": "3.25.0",
-    "@serenity-js/rest": "3.25.0",
-    "@serenity-js/web": "3.25.0",
+    "@serenity-js/core": "3.25.1",
+    "@serenity-js/rest": "3.25.1",
+    "@serenity-js/web": "3.25.1",
     "deepmerge": "4.3.1",
     "query-selector-shadow-dom": "1.0.1",
     "tiny-types": "1.22.0"
@@ -76,11 +76,11 @@
   },
   "devDependencies": {
     "@integration/testing-tools": "3.0.0",
-    "@serenity-js/assertions": "3.25.0",
-    "@serenity-js/cucumber": "3.25.0",
-    "@serenity-js/jasmine": "3.25.0",
-    "@serenity-js/local-server": "3.25.0",
-    "@serenity-js/mocha": "3.25.0",
+    "@serenity-js/assertions": "3.25.1",
+    "@serenity-js/cucumber": "3.25.1",
+    "@serenity-js/jasmine": "3.25.1",
+    "@serenity-js/local-server": "3.25.1",
+    "@serenity-js/mocha": "3.25.1",
     "@serenity-js/web": "3.1.1",
     "@types/chai": "4.3.16",
     "@types/express": "4.17.21",
@@ -99,5 +99,5 @@
     "ts-node": "10.9.2",
     "typescript": "5.2.2"
   },
-  "gitHead": "22657b685b6002f75b2569db54f4bea31ab91d12"
+  "gitHead": "450b994115cf9f1a1547ef92ac9387e0c57821ce"
 }

package/src/adapter/Config.ts

@@ -7,14 +7,14 @@ import type { Config as ProtractorConfig } from 'protractor';
  *
  * ## Learn more
  * - [Protractor config](https://github.com/angular/protractor/blob/master/lib/config.ts)
- * - {@apilink SerenityConfig}
- * - {@apilink configure}
+ * - [`SerenityConfig`](https://serenity-js.org/api/core/class/SerenityConfig/)
+ * - [`configure`](https://serenity-js.org/api/core/function/configure/)
  *
  * @group Configuration
  */
 export interface Config extends ProtractorConfig {
     /**
-     * See {@apilink SerenityConfig}
+     * See [`SerenityConfig`](https://serenity-js.org/api/core/class/SerenityConfig/)
      */
     serenity: SerenityConfig & { runner?: string };
 }

package/src/adapter/reporter/ProtractorReport.ts

@@ -1,7 +1,8 @@
 import type { SpecResult } from 'protractor/built/plugins';
 
 /**
- * A JSON object which needs to be returned to Protractor when {@apilink ProtractorFrameworkAdapter}
+ * A JSON object which needs to be returned to Protractor
+ * when [`ProtractorFrameworkAdapter`](https://serenity-js.org/api/protractor-adapter/function/run/)
  * is done with executing the test scenarios.
  *
  * ## Learn more

package/src/adapter/runner/TestRunnerDetector.ts

@@ -4,7 +4,7 @@ import type { Config as ProtractorConfig } from 'protractor';
 import type { TestRunnerLoader } from './TestRunnerLoader';
 
 /**
- * Detects the {@apilink TestRunnerAdapter} to use,
+ * Detects the [`TestRunnerAdapter`](https://serenity-js.org/api/core-adapter/interface/TestRunnerAdapter/) to use,
  * based on Protractor configuration.
  *
  * @group Integration

package/src/adapter/runner/TestRunnerLoader.ts

@@ -6,7 +6,7 @@ import type { CucumberConfig } from '@serenity-js/cucumber/lib/adapter';
 import type { CucumberAdapterConfig } from './CucumberAdapterConfig';
 
 /**
- * Loads a {@apilink TestRunnerAdapter} needed to invoke
+ * Loads a [`TestRunnerAdapter`](https://serenity-js.org/api/core-adapter/interface/TestRunnerAdapter/) needed to invoke
  * the chosen test runner programmatically.
  *
  * @group Integration
@@ -21,9 +21,9 @@ export class TestRunnerLoader {
      * @param cwd
      *  Current working directory; used to resolve glob paths to files for Cucumber.js to `require`,
      *  and instructing Serenity/JS where to look for this module's optional
-     *  dependencies, like [`@serenity-js/cucumber`](/api/cucumber),
-     *  [`@serenity-js/mocha`](/api/mocha),
-     *  [`@serenity-js/jasmine`](/api/jasmine), etc.
+     *  dependencies, like [`@serenity-js/cucumber`](https://serenity-js.org/api/cucumber),
+     *  [`@serenity-js/mocha`](https://serenity-js.org/api/mocha),
+     *  [`@serenity-js/jasmine`](https://serenity-js.org/api/jasmine), etc.
      *
      * @param runnerId
      *  Unique identifier used to differentiate output files produced by native Cucumber.js formatters.
@@ -36,7 +36,7 @@ export class TestRunnerLoader {
     }
 
     /**
-     * See {@apilink JasmineConfig}
+     * See [`JasmineConfig`](https://serenity-js.org/api/jasmine-adapter/interface/JasmineConfig/)
      *
      * @param jasmineNodeOpts
      */
@@ -46,7 +46,7 @@ export class TestRunnerLoader {
     }
 
     /**
-     * See {@apilink MochaConfig}
+     * See [`MochaConfig`](https://serenity-js.org/api/mocha-adapter/interface/MochaConfig/)
      *
      * @param mochaOpts
      */
@@ -56,7 +56,7 @@ export class TestRunnerLoader {
     }
 
     /**
-     * See {@apilink CucumberConfig}
+     * See [`CucumberConfig`](https://serenity-js.org/api/cucumber-adapter/interface/CucumberConfig/)
      *
      * @param cucumberOpts
      * @param adapterConfig

package/src/screenplay/abilities/BrowseTheWebWithProtractor.ts

@@ -5,8 +5,8 @@ import type * as protractor from 'protractor';
 import { ProtractorBrowsingSession } from '../models';
 
 /**
- * This implementation of the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * enables the {@apilink Actor} to interact with web front-ends using [Protractor](http://www.protractortest.org/#/).
+ * This implementation of the [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * enables the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to interact with web front-ends using [Protractor](http://www.protractortest.org/#/).
  *
  * ## Using Protractor to `BrowseTheWeb`
  *
@@ -32,9 +32,9 @@ import { ProtractorBrowsingSession } from '../models';
  *
  * ## Learn more
  * - [Protractor website](https://www.protractortest.org/)
- * - {@apilink BrowseTheWeb}
- * - {@apilink Ability}
- * - {@apilink Actor}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
+ * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
  *
  * @group Abilities
  */
@@ -93,7 +93,7 @@ export class BrowseTheWebWithProtractor extends BrowseTheWeb<protractor.ElementF
      * @param path
      *  Either a name or a dot-delimited path to the param.
      *
-     * @throws {@apilink ConfigurationError}
+     * @throws [`ConfigurationError`](https://serenity-js.org/api/core/class/ConfigurationError/)
      *  Throws a `ConfigurationError` if the parameter is `undefined`
      */
     param<T = any>(path: string): T {

package/src/screenplay/interactions/UseAngular.ts

@@ -4,7 +4,7 @@ import { BrowseTheWebWithProtractor } from '../abilities';
 import type { ProtractorPage } from '../models';
 
 /**
- * Instructs the {@apilink Actor} to enable or disable automated synchronisation between Protractor and Angular 1.x application.
+ * Instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to enable or disable automated synchronisation between Protractor and Angular 1.x application.
  *
  * Useful when a test scenario needs to interact with both Angular-based
  * and non-Angular web apps, e.g. use an external sign-in form.
@@ -56,7 +56,7 @@ import type { ProtractorPage } from '../models';
 export class UseAngular {
 
     /**
-     * Produces an {@apilink Interaction} that instructs the {@apilink Actor} to disable
+     * Produces an [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) that instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to disable
      * synchronisation between Protractor and an Angular 1.x app.
      */
     static disableSynchronisation(): Interaction {
@@ -68,7 +68,7 @@ export class UseAngular {
     }
 
     /**
-     * Produces an {@apilink Interaction} that instructs the {@apilink Actor} to enable
+     * Produces an [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) that instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to enable
      * synchronisation between Protractor and an Angular 1.x app.
      */
     static enableSynchronisation(): Interaction {

package/src/screenplay/models/ProtractorBrowsingSession.ts

@@ -9,7 +9,7 @@ import { ProtractorErrorHandler } from './ProtractorErrorHandler';
 import { ProtractorModalDialogHandler } from './ProtractorModalDialogHandler';
 
 /**
- * Protractor-specific implementation of {@apilink BrowsingSession}.
+ * Protractor-specific implementation of [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/).
  *
  * @group Models
  */

package/src/screenplay/models/ProtractorCookie.ts

@@ -7,7 +7,7 @@ import { ensure, isDefined } from 'tiny-types';
 import { promised } from '../promised';
 
 /**
- * Protractor-specific implementation of {@apilink Cookie}.
+ * Protractor-specific implementation of [`Cookie`](https://serenity-js.org/api/web/class/Cookie/).
  *
  * @group Models
  */

package/src/screenplay/models/ProtractorModalDialogHandler.ts

@@ -7,7 +7,7 @@ import { promised } from '../promised';
 import type { ProtractorErrorHandler } from './ProtractorErrorHandler';
 
 /**
- * Protractor-specific implementation of {@apilink ModalDialogHandler}.
+ * Protractor-specific implementation of [`ModalDialogHandler`](https://serenity-js.org/api/web/class/ModalDialogHandler/).
  *
  * @group Models
  */

package/src/screenplay/models/ProtractorPage.ts

@@ -15,7 +15,7 @@ import type { ProtractorErrorHandler } from './ProtractorErrorHandler';
 import { ProtractorPageElement } from './ProtractorPageElement';
 
 /**
- * Protractor-specific implementation of {@apilink Page}.
+ * Protractor-specific implementation of [`Page`](https://serenity-js.org/api/web/class/Page/).
  *
  * @group Models
  */

package/src/screenplay/models/ProtractorPageElement.ts

@@ -9,7 +9,7 @@ import { promised } from '../promised';
 import type { ProtractorLocator } from './locators';
 
 /**
- * Protractor-specific implementation of {@apilink PageElement}.
+ * Protractor-specific implementation of [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
  * @group Models
  */

package/src/screenplay/models/locators/ProtractorLocator.ts

@@ -10,7 +10,7 @@ import type { ProtractorRootLocator } from './ProtractorRootLocator';
 import { ProtractorSelectors } from './ProtractorSelectors';
 
 /**
- * Protractor-specific implementation of {@apilink Locator}.
+ * Protractor-specific implementation of [`Locator`](https://serenity-js.org/api/web/class/Locator/).
  *
  * @group Models
  */

package/src/screenplay/models/locators/ProtractorRootLocator.ts

@@ -4,7 +4,7 @@ import type * as protractor from 'protractor';
 import { promised } from '../../promised';
 
 /**
- * Protractor-specific implementation of {@apilink RootLocator}.
+ * Protractor-specific implementation of [`RootLocator`](https://serenity-js.org/api/web/class/RootLocator/).
  *
  * @group Models
  */

package/src/screenplay/questions/ProtractorParam.ts

@@ -61,7 +61,7 @@ import { BrowseTheWebWithProtractor } from '../abilities';
  * ```
  *
  * ## Learn more
- * - {@apilink BrowseTheWebWithProtractor.param}
+ * - [`BrowseTheWebWithProtractor.param`](https://serenity-js.org/api/protractor/class/BrowseTheWebWithProtractor/#param)
  *
  * @group Questions
  */