algolia-experiences 1.8.13 → 1.8.14

package/dist/algolia-experiences.development.js

@@ -1,4 +1,4 @@
-/*! algolia-experiences 1.8.13 | © Algolia, Inc. and contributors; MIT License | https://github.com/algolia/instantsearch */
+/*! algolia-experiences 1.8.14 | © Algolia, Inc. and contributors; MIT License | https://github.com/algolia/instantsearch */
 (function (factory) {
     typeof define === 'function' && define.amd ? define(factory) :
     factory();
@@ -4987,7 +4987,7 @@
     function requireVersion() {
         if (hasRequiredVersion) return version$1;
         hasRequiredVersion = 1;
-        version$1 = '3.29.1';
+        version$1 = '3.29.2';
         return version$1;
     }
 
@@ -6886,6 +6886,8 @@
         });
     }
 
+    var version = '4.105.0';
+
     var ANONYMOUS_TOKEN_COOKIE_KEY = '_ALGOLIA';
     function getCookie(name) {
         if ((typeof document === "undefined" ? "undefined" : _type_of(document)) !== 'object' || typeof document.cookie !== 'string') {
@@ -6908,6 +6910,232 @@
         return getCookie(ANONYMOUS_TOKEN_COOKIE_KEY);
     }
 
+    function serializePayload(payload) {
+        return btoa(encodeURIComponent(JSON.stringify(payload)));
+    }
+    function deserializePayload(serialized) {
+        return JSON.parse(decodeURIComponent(atob(serialized)));
+    }
+
+    var USAGE_SESSION_KEY = 'ais.usage.sessionId';
+    // Cache the id for the lifetime of the runtime so repeated calls don't hit
+    // `sessionStorage` again, and so we always return the same id even when
+    // storage is unavailable (SSR, privacy mode) and we fall back to a fresh UUID.
+    var usageSessionId = null;
+    function getUsageSessionId() {
+        if (usageSessionId) {
+            return usageSessionId;
+        }
+        try {
+            var existing = sessionStorage.getItem(USAGE_SESSION_KEY);
+            if (existing) {
+                usageSessionId = existing;
+                return usageSessionId;
+            }
+            usageSessionId = createUUID();
+            sessionStorage.setItem(USAGE_SESSION_KEY, usageSessionId);
+            return usageSessionId;
+        } catch (unused) {
+            // sessionStorage unavailable (SSR, privacy mode, etc.)
+            usageSessionId = createUUID();
+            return usageSessionId;
+        }
+    }
+    /** @deprecated use bindEvent instead */ function readDataAttributes(domElement) {
+        var method = domElement.getAttribute('data-insights-method');
+        var serializedPayload = domElement.getAttribute('data-insights-payload');
+        if (typeof serializedPayload !== 'string') {
+            throw new Error('The insights helper expects `data-insights-payload` to be a base64-encoded JSON string.');
+        }
+        try {
+            var payload = deserializePayload(serializedPayload);
+            return {
+                method: method,
+                payload: payload
+            };
+        } catch (error) {
+            throw new Error('The insights helper was unable to parse `data-insights-payload`.');
+        }
+    }
+    /** @deprecated use bindEvent instead */ function writeDataAttributes(param) {
+        var method = param.method, payload = param.payload;
+        if ((typeof payload === "undefined" ? "undefined" : _type_of(payload)) !== 'object') {
+            throw new Error("The insights helper expects the payload to be an object.");
+        }
+        var serializedPayload;
+        try {
+            serializedPayload = serializePayload(payload);
+        } catch (error) {
+            throw new Error("Could not JSON serialize the payload object.");
+        }
+        return 'data-insights-method="'.concat(method, '" data-insights-payload="').concat(serializedPayload, '"');
+    }
+    /**
+     * @deprecated This function will be still supported in 4.x releases, but not further. It is replaced by the `insights` middleware. For more information, visit https://www.algolia.com/doc/guides/getting-insights-and-analytics/search-analytics/click-through-and-conversions/how-to/send-click-and-conversion-events-with-instantsearch/js/
+     */ function insights(method, payload) {
+        return writeDataAttributes({
+            method: method,
+            payload: payload
+        });
+    }
+
+    var now = typeof performance !== 'undefined' ? function() {
+        return performance.now();
+    } : function() {
+        return Date.now();
+    };
+
+    var indexWidgetTypes = [
+        'ais.index',
+        'ais.feedContainer'
+    ];
+
+    function isIndexWidget(widget) {
+        return indexWidgetTypes.includes(widget.$$type);
+    }
+
+    function createInitArgs(instantSearchInstance, parent, uiState) {
+        var helper = parent.getHelper();
+        return {
+            uiState: uiState,
+            helper: helper,
+            parent: parent,
+            instantSearchInstance: instantSearchInstance,
+            state: helper.state,
+            renderState: instantSearchInstance.renderState,
+            templatesConfig: instantSearchInstance.templatesConfig,
+            createURL: parent.createURL,
+            scopedResults: [],
+            searchMetadata: {
+                isSearchStalled: instantSearchInstance.status === 'stalled'
+            },
+            status: instantSearchInstance.status,
+            error: instantSearchInstance.error
+        };
+    }
+    function createRenderArgs(instantSearchInstance, parent, widget) {
+        var results = parent.getResultsForWidget(widget);
+        var helper = parent.getHelper();
+        return {
+            helper: helper,
+            parent: parent,
+            instantSearchInstance: instantSearchInstance,
+            results: results,
+            scopedResults: parent.getScopedResults(),
+            state: results && '_state' in results ? results._state : helper.state,
+            renderState: instantSearchInstance.renderState,
+            templatesConfig: instantSearchInstance.templatesConfig,
+            createURL: parent.createURL,
+            searchMetadata: {
+                isSearchStalled: instantSearchInstance.status === 'stalled'
+            },
+            status: instantSearchInstance.status,
+            error: instantSearchInstance.error
+        };
+    }
+    function storeRenderState(param) {
+        var renderState = param.renderState, instantSearchInstance = param.instantSearchInstance, parent = param.parent;
+        var parentIndexName = parent ? parent.getIndexId() : instantSearchInstance.mainIndex.getIndexId();
+        instantSearchInstance.renderState = _object_spread_props(_object_spread({}, instantSearchInstance.renderState), _define_property({}, parentIndexName, _object_spread({}, instantSearchInstance.renderState[parentIndexName], renderState)));
+    }
+
+    function serializeParamValue(value) {
+        if (value === undefined || value === null) {
+            return null;
+        }
+        var t = typeof value === "undefined" ? "undefined" : _type_of(value);
+        if (t === 'string' || t === 'number' || t === 'boolean') {
+            return {
+                value: String(value),
+                type: t
+            };
+        }
+        if (Array.isArray(value) || t === 'object') {
+            var type = Array.isArray(value) ? 'array' : 'object';
+            try {
+                return {
+                    value: JSON.stringify(value),
+                    type: type
+                };
+            } catch (unused) {
+                return {
+                    type: type
+                };
+            }
+        }
+        if (t === 'function') {
+            return {
+                value: value.name,
+                type: 'function'
+            };
+        }
+        // symbols, DOM elements: name only
+        return null;
+    }
+    /**
+     * Turns a `widgetParams`-style record into the serialized `WidgetTreeParam[]`
+     * shape used throughout the usage events. Shared between the widget tree and
+     * the root `ais.instantSearch` node so every node reports params identically.
+     */ function serializeWidgetParams(widgetParams) {
+        var params = [];
+        Object.keys(widgetParams).forEach(function(key) {
+            var raw = widgetParams[key];
+            if (raw === undefined) {
+                return;
+            }
+            var serialized = serializeParamValue(raw);
+            if (serialized) {
+                params.push(_object_spread({
+                    name: key
+                }, serialized));
+            } else {
+                params.push({
+                    name: key
+                });
+            }
+        });
+        return params;
+    }
+    function buildWidgetTree(widgets, instantSearchInstance) {
+        var parent = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : instantSearchInstance.mainIndex;
+        var initOptions = createInitArgs(instantSearchInstance, parent, instantSearchInstance._initialUiState);
+        return widgets.map(function(widget) {
+            var widgetParams = {};
+            if (widget.getWidgetRenderState) {
+                var renderState = widget.getWidgetRenderState(initOptions);
+                if (renderState && renderState.widgetParams) {
+                    widgetParams = renderState.widgetParams;
+                }
+            }
+            var params = serializeWidgetParams(widgetParams);
+            var children = isIndexWidget(widget) ? buildWidgetTree(widget.getWidgets(), instantSearchInstance, widget) : [];
+            return {
+                type: widget.$$widgetType || widget.$$type || 'unknown',
+                params: params,
+                children: children
+            };
+        });
+    }
+
+    /**
+     * Creates a new object with the same keys as the original object, but without the excluded keys.
+     * @param source original object
+     * @param excluded keys to remove from the original object
+     * @returns the new object
+     */ function omit(source, excluded) {
+        if (source === null || source === undefined) {
+            return source;
+        }
+        return Object.keys(source).reduce(function(target, key) {
+            if (excluded.indexOf(key) >= 0) {
+                return target;
+            }
+            var validKey = key;
+            target[validKey] = source[validKey];
+            return target;
+        }, {});
+    }
+
     // eslint-disable-next-line no-restricted-globals
     /**
      * Runs code on browser environments safely.
@@ -6981,8 +7209,20 @@
         }
     }
 
+    function getAlgoliaAgent(client) {
+        var clientTyped = client;
+        return clientTyped.transporter && clientTyped.transporter.userAgent ? clientTyped.transporter.userAgent.value : clientTyped._ua;
+    }
+
     var ALGOLIA_INSIGHTS_VERSION = '2.17.2';
     var ALGOLIA_INSIGHTS_SRC = "https://cdn.jsdelivr.net/npm/search-insights@".concat(ALGOLIA_INSIGHTS_VERSION, "/dist/search-insights.min.js");
+    // InstantSearch options that must never be sent in usage events because
+    // they carry credentials or end-user data. Everything else is reported as-is.
+    var SENSITIVE_OPTIONS = [
+        'searchClient',
+        'insightsClient',
+        'initialUiState'
+    ];
     function createInsightsMiddleware() {
         var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         var _insightsClient = props.insightsClient, insightsInitParams = props.insightsInitParams, onEvent = props.onEvent, _props_$$internal = props.$$internal, $$internal = _props_$$internal === void 0 ? false : _props_$$internal, _props_$$automatic = props.$$automatic, $$automatic = _props_$$automatic === void 0 ? false : _props_$$automatic;
@@ -7072,6 +7312,7 @@
             }
             var initialParameters;
             var helper;
+            var removeStartEventListener = null;
             return {
                 $$type: 'ais.insights',
                 $$internal: $$internal,
@@ -7246,8 +7487,65 @@
                             insightsClientWithLocalCredentials(event.insightsMethod, event.payload);
                         } else ;
                     };
+                    // usage tracking (browser-only)
+                    safelyRunOnBrowser(function() {
+                        var usageSessionId = getUsageSessionId();
+                        function sendUsageEvent(event) {
+                            var _helper_state;
+                            var userToken = (_helper_state = helper.state) === null || _helper_state === void 0 ? void 0 : _helper_state.userToken;
+                            insightsClientWithLocalCredentials('sendEvents', [
+                                _object_spread({
+                                    eventType: 'instantsearch',
+                                    timestamp: Date.now(),
+                                    sessionID: usageSessionId,
+                                    userToken: userToken ? String(userToken) : undefined
+                                }, event)
+                            ]);
+                        }
+                        // Send the start event on the first `render`, by which point every
+                        // flavor has registered its widgets. `bootstrapMs` then measures the
+                        // time between the constructor running and that point, so for flavors
+                        // that register widgets right at start (e.g. React) it captures the
+                        // cost of adding them.
+                        var sendStartEvent = function sendStartEvent() {
+                            try {
+                                var bootstrapMs = Math.round(now() - instantSearchInstance._createdAt);
+                                sendUsageEvent({
+                                    eventName: '__start__',
+                                    algoliaAgent: getAlgoliaAgent(instantSearchInstance.client),
+                                    version: version,
+                                    applicationId: appId,
+                                    performance: {
+                                        bootstrapMs: bootstrapMs
+                                    },
+                                    widgets: [
+                                        {
+                                            type: 'ais.instantSearch',
+                                            // The options the instance was created with, serialized the
+                                            // same way every widget's params are. Derived dynamically from
+                                            // `_initialOptions` so new options are reported automatically,
+                                            // minus the keys that carry credentials or user data. Functions
+                                            // (`onStateChange`, `searchFunction`) report their `fn.name`
+                                            // when present, tagged `type: 'function'`.
+                                            params: instantSearchInstance._initialOptions ? serializeWidgetParams(omit(instantSearchInstance._initialOptions, _to_consumable_array(SENSITIVE_OPTIONS))) : [],
+                                            children: buildWidgetTree(instantSearchInstance.mainIndex.getWidgets(), instantSearchInstance)
+                                        }
+                                    ]
+                                });
+                            } catch (unused) {
+                            // usage tracking must never crash the host app
+                            }
+                        };
+                        instantSearchInstance.once('render', sendStartEvent);
+                        removeStartEventListener = function removeStartEventListener() {
+                            return instantSearchInstance.removeListener('render', sendStartEvent);
+                        };
+                    });
                 },
                 unsubscribe: function unsubscribe() {
+                    if (removeStartEventListener) {
+                        removeStartEventListener();
+                    }
                     insightsClient('onUserTokenChange', undefined);
                     instantSearchInstance.sendEventToInsights = noop;
                     if (helper && initialParameters) {
@@ -7295,67 +7593,9 @@
         return typeof userToken === 'number' ? userToken.toString() : userToken;
     }
 
-    var indexWidgetTypes = [
-        'ais.index',
-        'ais.feedContainer'
-    ];
-
-    function isIndexWidget(widget) {
-        return indexWidgetTypes.includes(widget.$$type);
-    }
-
-    function getAlgoliaAgent(client) {
-        var clientTyped = client;
-        return clientTyped.transporter && clientTyped.transporter.userAgent ? clientTyped.transporter.userAgent.value : clientTyped._ua;
-    }
-
-    function createInitArgs(instantSearchInstance, parent, uiState) {
-        var helper = parent.getHelper();
-        return {
-            uiState: uiState,
-            helper: helper,
-            parent: parent,
-            instantSearchInstance: instantSearchInstance,
-            state: helper.state,
-            renderState: instantSearchInstance.renderState,
-            templatesConfig: instantSearchInstance.templatesConfig,
-            createURL: parent.createURL,
-            scopedResults: [],
-            searchMetadata: {
-                isSearchStalled: instantSearchInstance.status === 'stalled'
-            },
-            status: instantSearchInstance.status,
-            error: instantSearchInstance.error
-        };
-    }
-    function createRenderArgs(instantSearchInstance, parent, widget) {
-        var results = parent.getResultsForWidget(widget);
-        var helper = parent.getHelper();
-        return {
-            helper: helper,
-            parent: parent,
-            instantSearchInstance: instantSearchInstance,
-            results: results,
-            scopedResults: parent.getScopedResults(),
-            state: results && '_state' in results ? results._state : helper.state,
-            renderState: instantSearchInstance.renderState,
-            templatesConfig: instantSearchInstance.templatesConfig,
-            createURL: parent.createURL,
-            searchMetadata: {
-                isSearchStalled: instantSearchInstance.status === 'stalled'
-            },
-            status: instantSearchInstance.status,
-            error: instantSearchInstance.error
-        };
-    }
-    function storeRenderState(param) {
-        var renderState = param.renderState, instantSearchInstance = param.instantSearchInstance, parent = param.parent;
-        var parentIndexName = parent ? parent.getIndexId() : instantSearchInstance.mainIndex.getIndexId();
-        instantSearchInstance.renderState = _object_spread_props(_object_spread({}, instantSearchInstance.renderState), _define_property({}, parentIndexName, _object_spread({}, instantSearchInstance.renderState[parentIndexName], renderState)));
-    }
-
     function extractWidgetPayload(widgets, instantSearchInstance, payload) {
-        var initOptions = createInitArgs(instantSearchInstance, instantSearchInstance.mainIndex, instantSearchInstance._initialUiState);
+        var parent = arguments.length > 3 && arguments[3] !== void 0 ? arguments[3] : instantSearchInstance.mainIndex;
+        var initOptions = createInitArgs(instantSearchInstance, parent, instantSearchInstance._initialUiState);
         widgets.forEach(function(widget) {
             var widgetParams = {};
             if (widget.getWidgetRenderState) {
@@ -7375,10 +7615,11 @@
                 params: params
             });
             if (isIndexWidget(widget)) {
-                extractWidgetPayload(widget.getWidgets(), instantSearchInstance, payload);
+                extractWidgetPayload(widget.getWidgets(), instantSearchInstance, payload, widget);
             }
         });
     }
+
     function isMetadataEnabled() {
         return safelyRunOnBrowser(function(param) {
             var window = param.window;
@@ -9876,51 +10117,6 @@
         return reverseHighlightedValue.replace(new RegExp(TAG_REPLACEMENT.highlightPreTag, 'g'), "<".concat(highlightedTagName, ' class="').concat(className, '">')).replace(new RegExp(TAG_REPLACEMENT.highlightPostTag, 'g'), "</".concat(highlightedTagName, ">"));
     }
 
-    function serializePayload(payload) {
-        return btoa(encodeURIComponent(JSON.stringify(payload)));
-    }
-    function deserializePayload(serialized) {
-        return JSON.parse(decodeURIComponent(atob(serialized)));
-    }
-
-    /** @deprecated use bindEvent instead */ function readDataAttributes(domElement) {
-        var method = domElement.getAttribute('data-insights-method');
-        var serializedPayload = domElement.getAttribute('data-insights-payload');
-        if (typeof serializedPayload !== 'string') {
-            throw new Error('The insights helper expects `data-insights-payload` to be a base64-encoded JSON string.');
-        }
-        try {
-            var payload = deserializePayload(serializedPayload);
-            return {
-                method: method,
-                payload: payload
-            };
-        } catch (error) {
-            throw new Error('The insights helper was unable to parse `data-insights-payload`.');
-        }
-    }
-    /** @deprecated use bindEvent instead */ function writeDataAttributes(param) {
-        var method = param.method, payload = param.payload;
-        if ((typeof payload === "undefined" ? "undefined" : _type_of(payload)) !== 'object') {
-            throw new Error("The insights helper expects the payload to be an object.");
-        }
-        var serializedPayload;
-        try {
-            serializedPayload = serializePayload(payload);
-        } catch (error) {
-            throw new Error("Could not JSON serialize the payload object.");
-        }
-        return 'data-insights-method="'.concat(method, '" data-insights-payload="').concat(serializedPayload, '"');
-    }
-    /**
-     * @deprecated This function will be still supported in 4.x releases, but not further. It is replaced by the `insights` middleware. For more information, visit https://www.algolia.com/doc/guides/getting-insights-and-analytics/search-analytics/click-through-and-conversions/how-to/send-click-and-conversion-events-with-instantsearch/js/
-     */ function insights(method, payload) {
-        return writeDataAttributes({
-            method: method,
-            payload: payload
-        });
-    }
-
     function hoganHelpers(param) {
         var numberLocale = param.numberLocale;
         return {
@@ -9982,8 +10178,6 @@
         };
     }
 
-    var version = '4.104.0';
-
     function getServerResults(entry) {
         var _entry_compositionFeedsResults;
         return ((_entry_compositionFeedsResults = entry.compositionFeedsResults) === null || _entry_compositionFeedsResults === void 0 ? void 0 : _entry_compositionFeedsResults.length) ? entry.compositionFeedsResults : entry.results || [];
@@ -10142,7 +10336,14 @@
         function InstantSearch(options) {
             _class_call_check(this, InstantSearch);
             var _this;
-            _this = _call_super(this, InstantSearch), _define_property(_this, "client", void 0), _define_property(_this, "indexName", void 0), _define_property(_this, "compositionID", void 0), _define_property(_this, "insightsClient", void 0), _define_property(_this, "onStateChange", null), _define_property(_this, "future", void 0), _define_property(_this, "helper", void 0), _define_property(_this, "mainHelper", void 0), _define_property(_this, "mainIndex", void 0), _define_property(_this, "started", void 0), _define_property(_this, "templatesConfig", void 0), _define_property(_this, "renderState", {}), _define_property(_this, "_stalledSearchDelay", void 0), _define_property(_this, "_searchStalledTimer", void 0), _define_property(_this, "_initialUiState", void 0), _define_property(_this, "_initialResults", void 0), _define_property(_this, "_manuallyResetScheduleSearch", false), _define_property(_this, "_resetScheduleSearch", void 0), _define_property(_this, "_createURL", void 0), _define_property(_this, "_searchFunction", void 0), _define_property(_this, "_mainHelperSearch", void 0), _define_property(_this, "_hasSearchWidget", false), _define_property(_this, "_hasRecommendWidget", false), _define_property(_this, "_insights", void 0), _define_property(_this, "middleware", []), _define_property(_this, "sendEventToInsights", void 0), /**
+            _this = _call_super(this, InstantSearch), _define_property(_this, "client", void 0), _define_property(_this, "indexName", void 0), _define_property(_this, "compositionID", void 0), _define_property(_this, "insightsClient", void 0), _define_property(_this, "onStateChange", null), _define_property(_this, "future", void 0), _define_property(_this, "helper", void 0), _define_property(_this, "mainHelper", void 0), _define_property(_this, "mainIndex", void 0), _define_property(_this, "started", void 0), _define_property(_this, "templatesConfig", void 0), _define_property(_this, "renderState", {}), _define_property(_this, "_stalledSearchDelay", void 0), _define_property(_this, "_searchStalledTimer", void 0), _define_property(_this, "_initialUiState", void 0), _define_property(_this, "_initialResults", void 0), _define_property(_this, "_manuallyResetScheduleSearch", false), _define_property(_this, "_resetScheduleSearch", void 0), _define_property(_this, "_createURL", void 0), _define_property(_this, "_searchFunction", void 0), _define_property(_this, "_mainHelperSearch", void 0), _define_property(_this, "_hasSearchWidget", false), _define_property(_this, "_hasRecommendWidget", false), _define_property(_this, "_insights", void 0), /**
+       * The options the instance was created with, kept verbatim so consumers
+       * (e.g. usage events) can introspect the configuration without the class
+       * having to enumerate every option by hand. Typed without the class generics
+       * on purpose: referencing `TUiState`/`TRouteState` here (they sit in
+       * contravariant positions inside `InstantSearchOptions`) would break the
+       * assignability of `InstantSearch<SpecificUiState>` to `InstantSearch`.
+       */ _define_property(_this, "_initialOptions", void 0), _define_property(_this, "middleware", []), _define_property(_this, "sendEventToInsights", void 0), _define_property(_this, "_createdAt", now()), /**
        * The status of the search. Can be "idle", "loading", "stalled", or "error".
        */ _define_property(_this, "status", 'idle'), /**
        * The last returned error from the Search API.
@@ -10190,6 +10391,7 @@
             if (insightsClient && typeof insightsClient !== 'function') {
                 throw new Error(withUsage$J('The `insightsClient` option should be a function.'));
             }
+            _this._initialOptions = options;
             _this.client = searchClient;
             _this.future = future;
             _this.insightsClient = insightsClient;
@@ -10562,6 +10764,9 @@
                         var instance = param.instance;
                         instance.unsubscribe();
                     });
+                    // Cleared after unsubscribe so in-flight readers (e.g. the insights
+                    // start-event listener) have detached before the reference goes away.
+                    this._initialOptions = null;
                 }
             },
             {
@@ -11143,25 +11348,6 @@
         return widget.$$type === 'ais.dynamicWidgets' || widget.$$type === 'ais.feeds';
     }
 
-    /**
-     * Creates a new object with the same keys as the original object, but without the excluded keys.
-     * @param source original object
-     * @param excluded keys to remove from the original object
-     * @returns the new object
-     */ function omit(source, excluded) {
-        if (source === null || source === undefined) {
-            return source;
-        }
-        return Object.keys(source).reduce(function(target, key) {
-            if (excluded.indexOf(key) >= 0) {
-                return target;
-            }
-            var validKey = key;
-            target[validKey] = source[validKey];
-            return target;
-        }, {});
-    }
-
     function range(param) {
         var _param_start = param.start, start = _param_start === void 0 ? 0 : _param_start, end = param.end, _param_step = param.step, step = _param_step === void 0 ? 1 : _param_step;
         // We can't divide by 0 so we re-assign the step to 1 if it happens.
@@ -13963,6 +14149,8 @@
         isSearchStalled: false,
         disabled: false,
         ariaLabel: 'Search',
+        submitTitle: 'Submit the search query',
+        resetTitle: 'Clear the search query',
         onChange: noop,
         onSubmit: noop,
         onReset: noop,
@@ -14102,7 +14290,8 @@
                         rootProps: {
                             className: cssClasses.submit,
                             type: 'submit',
-                            title: 'Submit the search query',
+                            title: this.props.submitTitle,
+                            'aria-label': this.props.submitTitle,
                             hidden: !showSubmit
                         },
                         templates: templates,
@@ -14115,7 +14304,8 @@
                         rootProps: {
                             className: cssClasses.reset,
                             type: 'reset',
-                            title: 'Clear the search query',
+                            title: this.props.resetTitle,
+                            'aria-label': this.props.resetTitle,
                             hidden: !(showReset && this.state.query.trim() && !isSearchStalled)
                         },
                         templates: templates,
@@ -14340,7 +14530,9 @@
                         rootProps: {
                             className: showMoreButtonClassName,
                             disabled: !this.props.canToggleShowMore,
-                            onClick: this.props.toggleShowMore
+                            onClick: this.props.toggleShowMore,
+                            'aria-expanded': Boolean(this.props.isShowingMore),
+                            'aria-label': this.props.showMoreButtonLabel
                         },
                         data: {
                             isShowingMore: this.props.isShowingMore
@@ -16480,6 +16672,7 @@
             rootProps: {
                 className: cssClasses.link,
                 'aria-label': ariaLabel,
+                'aria-current': isSelected ? 'page' : undefined,
                 href: createURL(pageNumber),
                 onClick: createClickHandler(pageNumber)
             },
@@ -19050,7 +19243,7 @@
     var suit$4 = component('RefinementList');
     var searchBoxSuit = component('SearchBox');
     var renderer$6 = function renderer(param) {
-        var containerNode = param.containerNode, cssClasses = param.cssClasses, templates = param.templates, searchBoxTemplates = param.searchBoxTemplates, renderState = param.renderState, showMore = param.showMore, searchable = param.searchable, searchablePlaceholder = param.searchablePlaceholder, searchableIsAlwaysActive = param.searchableIsAlwaysActive, searchableSelectOnSubmit = param.searchableSelectOnSubmit;
+        var containerNode = param.containerNode, cssClasses = param.cssClasses, templates = param.templates, searchBoxTemplates = param.searchBoxTemplates, renderState = param.renderState, showMore = param.showMore, showMoreButtonLabel = param.showMoreButtonLabel, searchable = param.searchable, searchablePlaceholder = param.searchablePlaceholder, searchableIsAlwaysActive = param.searchableIsAlwaysActive, searchableSelectOnSubmit = param.searchableSelectOnSubmit;
         return function(param, isFirstRendering) {
             var refine = param.refine, items = param.items, createURL = param.createURL, searchForItems = param.searchForItems, isFromSearch = param.isFromSearch, instantSearchInstance = param.instantSearchInstance, toggleShowMore = param.toggleShowMore, isShowingMore = param.isShowingMore, hasExhaustiveItems = param.hasExhaustiveItems, canToggleShowMore = param.canToggleShowMore;
             if (isFirstRendering) {
@@ -19078,6 +19271,7 @@
                 searchIsAlwaysActive: searchableIsAlwaysActive,
                 isFromSearch: isFromSearch,
                 showMore: showMore && !isFromSearch && items.length > 0,
+                showMoreButtonLabel: showMoreButtonLabel,
                 toggleShowMore: toggleShowMore,
                 isShowingMore: isShowingMore,
                 hasExhaustiveItems: hasExhaustiveItems,
@@ -19105,7 +19299,7 @@
      *
      * If you also want to use search for facet values on this attribute, you need to make it searchable using the [dashboard](https://www.algolia.com/explorer/display/) or using the [API](https://www.algolia.com/doc/guides/searching/faceting/#search-for-facet-values).
      */ var refinementList = function refinementList(widgetParams) {
-        var _ref = widgetParams || {}, container = _ref.container, attribute = _ref.attribute, operator = _ref.operator, sortBy = _ref.sortBy, limit = _ref.limit, showMore = _ref.showMore, showMoreLimit = _ref.showMoreLimit, _ref_searchable = _ref.searchable, searchable = _ref_searchable === void 0 ? false : _ref_searchable, _ref_searchablePlaceholder = _ref.searchablePlaceholder, searchablePlaceholder = _ref_searchablePlaceholder === void 0 ? 'Search...' : _ref_searchablePlaceholder, _ref_searchableEscapeFacetValues = _ref.searchableEscapeFacetValues, searchableEscapeFacetValues = _ref_searchableEscapeFacetValues === void 0 ? true : _ref_searchableEscapeFacetValues, _ref_searchableIsAlwaysActive = _ref.searchableIsAlwaysActive, searchableIsAlwaysActive = _ref_searchableIsAlwaysActive === void 0 ? true : _ref_searchableIsAlwaysActive, _ref_searchableSelectOnSubmit = _ref.searchableSelectOnSubmit, searchableSelectOnSubmit = _ref_searchableSelectOnSubmit === void 0 ? true : _ref_searchableSelectOnSubmit, tmp = _ref.cssClasses, userCssClasses = tmp === void 0 ? {} : tmp, _ref_templates = _ref.templates, templates = _ref_templates === void 0 ? {} : _ref_templates, transformItems = _ref.transformItems;
+        var _ref = widgetParams || {}, container = _ref.container, attribute = _ref.attribute, operator = _ref.operator, sortBy = _ref.sortBy, limit = _ref.limit, showMore = _ref.showMore, showMoreLimit = _ref.showMoreLimit, showMoreButtonLabel = _ref.showMoreButtonLabel, _ref_searchable = _ref.searchable, searchable = _ref_searchable === void 0 ? false : _ref_searchable, _ref_searchablePlaceholder = _ref.searchablePlaceholder, searchablePlaceholder = _ref_searchablePlaceholder === void 0 ? 'Search...' : _ref_searchablePlaceholder, _ref_searchableEscapeFacetValues = _ref.searchableEscapeFacetValues, searchableEscapeFacetValues = _ref_searchableEscapeFacetValues === void 0 ? true : _ref_searchableEscapeFacetValues, _ref_searchableIsAlwaysActive = _ref.searchableIsAlwaysActive, searchableIsAlwaysActive = _ref_searchableIsAlwaysActive === void 0 ? true : _ref_searchableIsAlwaysActive, _ref_searchableSelectOnSubmit = _ref.searchableSelectOnSubmit, searchableSelectOnSubmit = _ref_searchableSelectOnSubmit === void 0 ? true : _ref_searchableSelectOnSubmit, tmp = _ref.cssClasses, userCssClasses = tmp === void 0 ? {} : tmp, _ref_templates = _ref.templates, templates = _ref_templates === void 0 ? {} : _ref_templates, transformItems = _ref.transformItems;
         if (!container) {
             throw new Error(withUsage$d('The `container` option is required.'));
         }
@@ -19193,7 +19387,8 @@
             searchablePlaceholder: searchablePlaceholder,
             searchableIsAlwaysActive: searchableIsAlwaysActive,
             searchableSelectOnSubmit: searchableSelectOnSubmit,
-            showMore: showMore
+            showMore: showMore,
+            showMoreButtonLabel: showMoreButtonLabel
         });
         var makeWidget = connectRefinementList(specializedRenderer, function() {
             return P(null, containerNode);
@@ -19218,7 +19413,7 @@
     var suit$3 = component('SearchBox');
     var aiModeSuit = component('AiModeButton');
     var renderer$5 = function renderer(param) {
-        var containerNode = param.containerNode, cssClasses = param.cssClasses, placeholder = param.placeholder, templates = param.templates, autofocus = param.autofocus, searchAsYouType = param.searchAsYouType, ignoreCompositionEvents = param.ignoreCompositionEvents, showReset = param.showReset, showSubmit = param.showSubmit, showLoadingIndicator = param.showLoadingIndicator, aiMode = param.aiMode;
+        var containerNode = param.containerNode, cssClasses = param.cssClasses, placeholder = param.placeholder, templates = param.templates, autofocus = param.autofocus, searchAsYouType = param.searchAsYouType, ignoreCompositionEvents = param.ignoreCompositionEvents, showReset = param.showReset, showSubmit = param.showSubmit, showLoadingIndicator = param.showLoadingIndicator, submitTitle = param.submitTitle, resetTitle = param.resetTitle, aiMode = param.aiMode;
         return function(param) {
             var refine = param.refine, query = param.query, isSearchStalled = param.isSearchStalled, instantSearchInstance = param.instantSearchInstance;
             var getChatRenderState = function getChatRenderState() {
@@ -19246,6 +19441,8 @@
                 showSubmit: showSubmit,
                 showReset: showReset,
                 showLoadingIndicator: showLoadingIndicator,
+                submitTitle: submitTitle,
+                resetTitle: resetTitle,
                 isSearchStalled: isSearchStalled,
                 cssClasses: cssClasses,
                 onAiModeClick: onAiModeClick,
@@ -19254,7 +19451,7 @@
         };
     };
     var searchBox = function searchBox(widgetParams) {
-        var _ref = widgetParams || {}, container = _ref.container, _ref_placeholder = _ref.placeholder, placeholder = _ref_placeholder === void 0 ? '' : _ref_placeholder, tmp = _ref.cssClasses, userCssClasses = tmp === void 0 ? {} : tmp, _ref_autofocus = _ref.autofocus, autofocus = _ref_autofocus === void 0 ? false : _ref_autofocus, _ref_searchAsYouType = _ref.searchAsYouType, searchAsYouType = _ref_searchAsYouType === void 0 ? true : _ref_searchAsYouType, _ref_ignoreCompositionEvents = _ref.ignoreCompositionEvents, ignoreCompositionEvents = _ref_ignoreCompositionEvents === void 0 ? false : _ref_ignoreCompositionEvents, _ref_showReset = _ref.showReset, showReset = _ref_showReset === void 0 ? true : _ref_showReset, _ref_showSubmit = _ref.showSubmit, showSubmit = _ref_showSubmit === void 0 ? true : _ref_showSubmit, _ref_showLoadingIndicator = _ref.showLoadingIndicator, showLoadingIndicator = _ref_showLoadingIndicator === void 0 ? true : _ref_showLoadingIndicator, queryHook = _ref.queryHook, tmp1 = _ref.templates, userTemplates = tmp1 === void 0 ? {} : tmp1, aiMode = _ref.aiMode;
+        var _ref = widgetParams || {}, container = _ref.container, _ref_placeholder = _ref.placeholder, placeholder = _ref_placeholder === void 0 ? '' : _ref_placeholder, tmp = _ref.cssClasses, userCssClasses = tmp === void 0 ? {} : tmp, _ref_autofocus = _ref.autofocus, autofocus = _ref_autofocus === void 0 ? false : _ref_autofocus, _ref_searchAsYouType = _ref.searchAsYouType, searchAsYouType = _ref_searchAsYouType === void 0 ? true : _ref_searchAsYouType, _ref_ignoreCompositionEvents = _ref.ignoreCompositionEvents, ignoreCompositionEvents = _ref_ignoreCompositionEvents === void 0 ? false : _ref_ignoreCompositionEvents, _ref_showReset = _ref.showReset, showReset = _ref_showReset === void 0 ? true : _ref_showReset, _ref_showSubmit = _ref.showSubmit, showSubmit = _ref_showSubmit === void 0 ? true : _ref_showSubmit, _ref_showLoadingIndicator = _ref.showLoadingIndicator, showLoadingIndicator = _ref_showLoadingIndicator === void 0 ? true : _ref_showLoadingIndicator, _ref_submitTitle = _ref.submitTitle, submitTitle = _ref_submitTitle === void 0 ? 'Submit the search query' : _ref_submitTitle, _ref_resetTitle = _ref.resetTitle, resetTitle = _ref_resetTitle === void 0 ? 'Clear the search query' : _ref_resetTitle, queryHook = _ref.queryHook, tmp1 = _ref.templates, userTemplates = tmp1 === void 0 ? {} : tmp1, aiMode = _ref.aiMode;
         if (!container) {
             throw new Error(withUsage$c('The `container` option is required.'));
         }
@@ -19305,6 +19502,8 @@
             showReset: showReset,
             showSubmit: showSubmit,
             showLoadingIndicator: showLoadingIndicator,
+            submitTitle: submitTitle,
+            resetTitle: resetTitle,
             aiMode: aiMode
         });
         var widgetFactory = connectSearchBox(specializedRenderer, function() {
@@ -19538,13 +19737,70 @@
         });
     };
 
+    // Delay before announcing an update, so that rapid changes (e.g. typing in the
+    // search box) settle into a single announcement instead of piling up. Mirrors
+    // the debounce used by GOV.UK's accessible-autocomplete.
+    var ANNOUNCEMENT_DELAY = 1400;
+    var visuallyHiddenStyle = {
+        position: 'absolute',
+        width: '1px',
+        height: '1px',
+        padding: 0,
+        margin: '-1px',
+        overflow: 'hidden',
+        clip: 'rect(0, 0, 0, 0)',
+        whiteSpace: 'nowrap',
+        border: 0
+    };
+    // Result count without the volatile details (such as the processing time) that
+    // are part of the visible text, so that only the meaningful count is announced.
+    function getAnnouncement(nbHits, nbSortedHits, areHitsSorted) {
+        if (areHitsSorted) {
+            var suffix = "sorted out of ".concat(formatNumber(nbHits));
+            if (nbSortedHits === 0) {
+                return "No relevant results ".concat(suffix);
+            }
+            if (nbSortedHits === 1) {
+                return "1 relevant result ".concat(suffix);
+            }
+            return "".concat(formatNumber(nbSortedHits || 0), " relevant results ").concat(suffix);
+        }
+        if (nbHits === 0) {
+            return 'No results';
+        }
+        if (nbHits === 1) {
+            return '1 result';
+        }
+        return "".concat(formatNumber(nbHits), " results");
+    }
     var Stats = function Stats(_0) {
-        var nbHits = _0.nbHits, nbSortedHits = _0.nbSortedHits, cssClasses = _0.cssClasses, templateProps = _0.templateProps, rest = _object_without_properties(_0, [
+        var nbHits = _0.nbHits, nbSortedHits = _0.nbSortedHits, areHitsSorted = _0.areHitsSorted, cssClasses = _0.cssClasses, templateProps = _0.templateProps, rest = _object_without_properties(_0, [
             "nbHits",
             "nbSortedHits",
+            "areHitsSorted",
             "cssClasses",
             "templateProps"
         ]);
+        var nextAnnouncement = getAnnouncement(nbHits, nbSortedHits, areHitsSorted);
+        var _useState = _sliced_to_array(y(''), 2), announcement = _useState[0], setAnnouncement = _useState[1];
+        var timerRef = A();
+        var isInitialRef = A(true);
+        s(function() {
+            // Don't announce the initial results, only subsequent changes.
+            if (isInitialRef.current) {
+                isInitialRef.current = false;
+                return undefined;
+            }
+            clearTimeout(timerRef.current);
+            timerRef.current = setTimeout(function() {
+                setAnnouncement(nextAnnouncement);
+            }, ANNOUNCEMENT_DELAY);
+            return function() {
+                return clearTimeout(timerRef.current);
+            };
+        }, [
+            nextAnnouncement
+        ]);
         return /*#__PURE__*/ h$1("div", {
             className: cx(cssClasses.root)
         }, /*#__PURE__*/ h$1(Template, _object_spread_props(_object_spread({}, templateProps), {
@@ -19562,9 +19818,16 @@
                 hasOneResult: nbHits === 1,
                 nbHits: nbHits,
                 nbSortedHits: nbSortedHits,
+                areHitsSorted: areHitsSorted,
                 cssClasses: cssClasses
             }, rest)
-        })));
+        })), /*#__PURE__*/ h$1("span", {
+            className: "ais-Stats-announcement",
+            role: "status",
+            "aria-live": "polite",
+            "aria-atomic": "true",
+            style: visuallyHiddenStyle
+        }, announcement));
     };
 
     var withUsage$9 = createDocumentationMessageGenerator({