Release build 4.21.1 [ci release]

Author: shakyShane

.eslintignore

@@ -6,3 +6,7 @@ integration-test/extension/contentScope.js
 integration-test/pages/build
 packages/special-pages/pages/**/public
 script-overload-snapshots/
+packages/special-pages/playwright-report/
+packages/special-pages/test-results/
+/playwright-report
+/test-results

Sources/ContentScopeScripts/dist/contentScope.js

@@ -1328,6 +1328,47 @@
       return parseJSONPointer(fromPointer);
     }
 
+    /**
+     * @module Messaging
+     * @category Libraries
+     * @description
+     *
+     * An abstraction for communications between JavaScript and host platforms.
+     *
+     * 1) First you construct your platform-specific configuration (eg: {@link WebkitMessagingConfig})
+     * 2) Then use that to get an instance of the Messaging utility which allows
+     * you to send and receive data in a unified way
+     * 3) Each platform implements {@link MessagingTransport} along with its own Configuration
+     *     - For example, to learn what configuration is required for Webkit, see: {@link WebkitMessagingConfig}
+     *     - Or, to learn about how messages are sent and received in Webkit, see {@link WebkitMessagingTransport}
+     *
+     * ## Links
+     * Please see the following links for examples
+     *
+     * - Windows: {@link WindowsMessagingConfig}
+     * - Webkit: {@link WebkitMessagingConfig}
+     * - Schema: {@link "Messaging Schema"}
+     *
+     */
+
+    /**
+     * Common options/config that are *not* transport specific.
+     */
+    class MessagingContext {
+        /**
+         * @param {object} params
+         * @param {string} params.context
+         * @param {string} params.featureName
+         * @param {"production" | "development"} params.env
+         * @internal
+         */
+        constructor (params) {
+            this.context = params.context;
+            this.featureName = params.featureName;
+            this.env = params.env;
+        }
+    }
+
     /**
      * @typedef {object} AssetConfig
      * @property {string} regularFontUrl
@@ -1351,6 +1392,8 @@
         #documentOriginIsTracker
         /** @type {Record<string, unknown> | undefined} */
         #bundledfeatureSettings
+        /** @type {MessagingContext} */
+        #messagingContext
 
         /** @type {{ debug?: boolean, featureSettings?: Record<string, unknown>, assets?: AssetConfig | undefined, site: Site  } | null} */
         #args
@@ -1405,6 +1448,19 @@
             return this.#bundledConfig
         }
 
+        /**
+         * @returns {MessagingContext}
+         */
+        get messagingContext () {
+            if (this.#messagingContext) return this.#messagingContext
+            this.#messagingContext = new MessagingContext({
+                context: 'contentScopeScripts',
+                featureName: this.name,
+                env: this.isDebug ? 'development' : 'production'
+            });
+            return this.#messagingContext
+        }
+
         /**
          * Get the value of a config setting.
          * If the value is not set, return the default value.