react-instantsearch 7.37.0 → 7.39.0

package/dist/umd/ReactInstantSearch.js

@@ -1,4 +1,4 @@
-/*! React InstantSearch 7.37.0 | © Algolia, Inc. and contributors; MIT License | https://github.com/algolia/instantsearch */
+/*! React InstantSearch 7.39.0 | © Algolia, Inc. and contributors; MIT License | https://github.com/algolia/instantsearch */
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('react')) :
     typeof define === 'function' && define.amd ? define(['exports', 'react'], factory) :
@@ -24,7 +24,7 @@
 
     var React__namespace = /*#__PURE__*/_interopNamespaceDefault(React);
 
-    var version$2 = '7.37.0';
+    var version$2 = '7.39.0';
 
     function _define_property(obj, key, value) {
         if (key in obj) {
@@ -571,10 +571,10 @@
         return objectHasKeys_1;
     }
 
-    var omit;
+    var omit$1;
     var hasRequiredOmit;
     function requireOmit() {
-        if (hasRequiredOmit) return omit;
+        if (hasRequiredOmit) return omit$1;
         hasRequiredOmit = 1;
         // https://github.com/babel/babel/blob/3aaafae053fa75febb3aa45d45b6f00646e30ba4/packages/babel-helpers/src/helpers.js#L604-L620
         function _objectWithoutPropertiesLoose(source, excluded) {
@@ -591,8 +591,8 @@
             }
             return target;
         }
-        omit = _objectWithoutPropertiesLoose;
-        return omit;
+        omit$1 = _objectWithoutPropertiesLoose;
+        return omit$1;
     }
 
     var RecommendParameters_1;
@@ -3919,7 +3919,7 @@
     function requireVersion() {
         if (hasRequiredVersion) return version$1;
         hasRequiredVersion = 1;
-        version$1 = '3.29.1';
+        version$1 = '3.29.2';
         return version$1;
     }
 
@@ -6890,10 +6890,11 @@
 
     var hasAlphanumeric = new RegExp(/\w/i);
     function getHighlightFromSiblings(parts, i) {
+        var _ref, _ref1;
         var _parts_, _parts_1;
         var current = parts[i];
-        var isNextHighlighted = ((_parts_ = parts[i + 1]) === null || _parts_ === void 0 ? void 0 : _parts_.isHighlighted) || true;
-        var isPreviousHighlighted = ((_parts_1 = parts[i - 1]) === null || _parts_1 === void 0 ? void 0 : _parts_1.isHighlighted) || true;
+        var isNextHighlighted = (_ref = (_parts_ = parts[i + 1]) === null || _parts_ === void 0 ? void 0 : _parts_.isHighlighted) !== null && _ref !== void 0 ? _ref : true;
+        var isPreviousHighlighted = (_ref1 = (_parts_1 = parts[i - 1]) === null || _parts_1 === void 0 ? void 0 : _parts_1.isHighlighted) !== null && _ref1 !== void 0 ? _ref1 : true;
         if (!hasAlphanumeric.test(unescape$1(current.value)) && isPreviousHighlighted === isNextHighlighted) {
             return isPreviousHighlighted;
         }
@@ -7258,19 +7259,23 @@
      * This is used to log issues in development environment only.
      */ var warn = noop;
 
-    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.
-        var limitStep = step === 0 ? 1 : step;
-        // In some cases the array to create has a decimal length.
-        // We therefore need to round the value.
-        // Example:
-        //   { start: 1, end: 5000, step: 500 }
-        //   => Array length = (5000 - 1) / 500 = 9.998
-        var arrayLength = Math.round((end - start) / limitStep);
-        return _to_consumable_array(Array(arrayLength)).map(function(_, current) {
-            return start + current * limitStep;
-        });
+    /**
+     * 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 createInitArgs(instantSearchInstance, parent, uiState) {
@@ -7318,6 +7323,132 @@
         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
+            };
+        });
+    }
+
+    function extractWidgetPayload(widgets, instantSearchInstance, payload) {
+        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) {
+                var renderState = widget.getWidgetRenderState(initOptions);
+                if (renderState && renderState.widgetParams) {
+                    // casting, as we just earlier checked widgetParams exists, and thus an object
+                    widgetParams = renderState.widgetParams;
+                }
+            }
+            // since we destructure in all widgets, the parameters with defaults are set to "undefined"
+            var params = Object.keys(widgetParams).filter(function(key) {
+                return widgetParams[key] !== undefined;
+            });
+            payload.widgets.push({
+                type: widget.$$type,
+                widgetType: widget.$$widgetType,
+                params: params
+            });
+            if (isIndexWidget(widget)) {
+                extractWidgetPayload(widget.getWidgets(), instantSearchInstance, payload, widget);
+            }
+        });
+    }
+
+    var now = typeof performance !== 'undefined' ? function() {
+        return performance.now();
+    } : function() {
+        return Date.now();
+    };
+
+    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.
+        var limitStep = step === 0 ? 1 : step;
+        // In some cases the array to create has a decimal length.
+        // We therefore need to round the value.
+        // Example:
+        //   { start: 1, end: 5000, step: 500 }
+        //   => Array length = (5000 - 1) / 500 = 9.998
+        var arrayLength = Math.round((end - start) / limitStep);
+        return _to_consumable_array(Array(arrayLength)).map(function(_, current) {
+            return start + current * limitStep;
+        });
+    }
+
     function resolveSearchParameters(current) {
         var parent = current.getParent();
         var states = [
@@ -9029,6 +9160,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') {
@@ -9051,8 +9184,61 @@
         return getCookie(ANONYMOUS_TOKEN_COOKIE_KEY);
     }
 
+    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 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 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;
@@ -9142,6 +9328,7 @@
             }
             var initialParameters;
             var helper;
+            var removeStartEventListener = null;
             return {
                 $$type: 'ais.insights',
                 $$internal: $$internal,
@@ -9316,8 +9503,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) {
@@ -9365,31 +9609,6 @@
         return typeof userToken === 'number' ? userToken.toString() : userToken;
     }
 
-    function extractWidgetPayload(widgets, instantSearchInstance, payload) {
-        var initOptions = createInitArgs(instantSearchInstance, instantSearchInstance.mainIndex, instantSearchInstance._initialUiState);
-        widgets.forEach(function(widget) {
-            var widgetParams = {};
-            if (widget.getWidgetRenderState) {
-                var renderState = widget.getWidgetRenderState(initOptions);
-                if (renderState && renderState.widgetParams) {
-                    // casting, as we just earlier checked widgetParams exists, and thus an object
-                    widgetParams = renderState.widgetParams;
-                }
-            }
-            // since we destructure in all widgets, the parameters with defaults are set to "undefined"
-            var params = Object.keys(widgetParams).filter(function(key) {
-                return widgetParams[key] !== undefined;
-            });
-            payload.widgets.push({
-                type: widget.$$type,
-                widgetType: widget.$$widgetType,
-                params: params
-            });
-            if (isIndexWidget(widget)) {
-                extractWidgetPayload(widget.getWidgets(), instantSearchInstance, payload);
-            }
-        });
-    }
     function isMetadataEnabled() {
         return safelyRunOnBrowser(function(param) {
             var window = param.window;
@@ -10738,28 +10957,6 @@
         return reverseHighlightedValue.replace(new RegExp(TAG_REPLACEMENT.highlightPreTag, 'g'), "<".concat(highlightedTagName, ' class="').concat(className, '">')).replace(new RegExp(TAG_REPLACEMENT.highlightPostTag, 'g'), "</".concat(highlightedTagName, ">"));
     }
 
-    /** @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 {
@@ -10821,8 +11018,6 @@
         };
     }
 
-    var version = '4.103.0';
-
     var withUsage$r = createDocumentationMessageGenerator({
         name: 'instantsearch'
     });
@@ -10842,7 +11037,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.
@@ -10890,6 +11092,7 @@
             if (insightsClient && typeof insightsClient !== 'function') {
                 throw new Error(withUsage$r('The `insightsClient` option should be a function.'));
             }
+            _this._initialOptions = options;
             _this.client = searchClient;
             _this.future = future;
             _this.insightsClient = insightsClient;
@@ -11262,6 +11465,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;
                 }
             },
             {
@@ -13884,12 +14090,10 @@
             var _chatInstance;
             var input = '';
             var open = false;
-            var isClearing = false;
             var sendEvent;
             var setInput;
             var setOpen;
             var focusInput;
-            var setIsClearing;
             var setFeedbackState;
             var hasValidatedEntryPoints = false;
             var agentId = 'agentId' in options ? options.agentId : undefined;
@@ -13919,21 +14123,17 @@
                 _chatInstance.messages = messagesParam;
             };
             var clearMessages = function clearMessages() {
-                if (!_chatInstance.messages || _chatInstance.messages.length === 0) {
-                    return;
-                }
                 var status = _chatInstance.status;
                 if (status === 'submitted' || status === 'streaming') {
                     _chatInstance.stop();
                 }
-                setIsClearing(true);
-            };
-            var onClearTransitionEnd = function onClearTransitionEnd() {
+                // Reset the non-reactive state first: `setMessages` and `clearError` emit
+                // ChatState callbacks that synchronously re-render, so they must run last
+                // for that render to see the cleared feedback and rotated conversation id.
+                feedbackState = {};
+                _chatInstance.resetConversationId();
                 setMessages([]);
                 _chatInstance.clearError();
-                _chatInstance.resetConversationId();
-                feedbackState = {};
-                setIsClearing(false);
             };
             var validateEntryPoints = function validateEntryPoints(instantSearchInstance) {
                 if (disableTriggerValidation || hasValidatedEntryPoints) {
@@ -13999,22 +14199,37 @@
                     }));
                 }
                 if ('agentId' in options && options.agentId) {
+                    var _options_requestOptions, _options_requestOptions1;
                     if (!appId || !apiKey) {
                         throw new Error(withUsage$o('Could not extract Algolia credentials from the search client.'));
                     }
-                    var baseApi = "https://".concat(appId, ".algolia.net/agent-studio/1/agents/").concat(agentId, "/completions?compatibilityMode=ai-sdk-5");
+                    var createApi = function createApi() {
+                        var bypassCache = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : false;
+                        var _options_requestOptions;
+                        var api = new URL("https://".concat(appId, ".algolia.net/agent-studio/1/agents/").concat(agentId, "/completions"));
+                        var queryParameters = _object_spread(_object_spread_props(_object_spread({}, (_options_requestOptions = options.requestOptions) === null || _options_requestOptions === void 0 ? void 0 : _options_requestOptions.queryParameters), {
+                            compatibilityMode: 'ai-sdk-5'
+                        }), bypassCache ? {
+                            cache: false
+                        } : {});
+                        api.search = new URLSearchParams(queryParameters).toString();
+                        return api.toString();
+                    };
+                    var baseApi = createApi();
                     transport = new DefaultChatTransport({
                         api: baseApi,
-                        headers: {
+                        headers: _object_spread_props(_object_spread({}, _instanceof((_options_requestOptions = options.requestOptions) === null || _options_requestOptions === void 0 ? void 0 : _options_requestOptions.headers, Headers) ? Object.fromEntries(options.requestOptions.headers.entries()) : (_options_requestOptions1 = options.requestOptions) === null || _options_requestOptions1 === void 0 ? void 0 : _options_requestOptions1.headers), {
+                            // Preserve the required Algolia identity headers and chat agent
+                            // marker, even when requestOptions.headers contains the same keys.
                             'x-algolia-application-id': appId,
                             'x-algolia-api-key': apiKey,
                             'x-algolia-agent': "".concat(getAlgoliaAgent(client), "; chat")
-                        },
+                        }),
                         prepareSendMessagesRequest: function prepareSendMessagesRequest(param) {
                             var id = param.id, messages = param.messages, trigger = param.trigger, messageId = param.messageId;
                             return {
                                 // Bypass cache when regenerating to ensure fresh responses
-                                api: trigger === 'regenerate-message' ? "".concat(baseApi, "&cache=false") : baseApi,
+                                api: trigger === 'regenerate-message' ? createApi(true) : baseApi,
                                 body: {
                                     id: id,
                                     messageId: messageId,
@@ -14099,10 +14314,6 @@
                         input = i;
                         render();
                     };
-                    setIsClearing = function setIsClearing(value) {
-                        isClearing = value;
-                        render();
-                    };
                     setFeedbackState = function setFeedbackState(messageId, state) {
                         feedbackState = _object_spread_props(_object_spread({}, feedbackState), _define_property({}, messageId, state));
                         render();
@@ -14221,9 +14432,7 @@
                         focusInput: focusInput,
                         setMessages: setMessages,
                         suggestions: getSuggestionsFromMessages(_chatInstance.messages),
-                        isClearing: isClearing,
                         clearMessages: clearMessages,
-                        onClearTransitionEnd: onClearTransitionEnd,
                         tools: toolsWithAddToolResult,
                         sendChatMessageFeedback: _sendChatMessageFeedback,
                         feedbackState: feedbackState,
@@ -20448,9 +20657,8 @@
             Fragment: Fragment
         });
         // Skip re-rendering (and re-compiling the markdown of) completed messages on
-        // every streaming delta. Falls back to the plain component when the host
-        // renderer doesn't provide a `memo` HOC.
-        var MemoizedDefaultMessage = memo ? memo(DefaultMessageComponent, areMessagePropsEqual) : DefaultMessageComponent;
+        // every streaming delta.
+        var MemoizedDefaultMessage = memo(DefaultMessageComponent, areMessagePropsEqual);
         var DefaultLoaderComponent = createChatMessageLoaderComponent({
             createElement: createElement
         });
@@ -20827,8 +21035,11 @@
         };
     }
 
+    function prefersReducedMotion() {
+        return typeof window !== 'undefined' && typeof window.matchMedia === 'function' && window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+    }
     function createChatComponent(param) {
-        var createElement = param.createElement, Fragment = param.Fragment, memo = param.memo;
+        var createElement = param.createElement, Fragment = param.Fragment, memo = param.memo, useState = param.useState;
         var ChatHeader = createChatHeaderComponent({
             createElement: createElement,
             Fragment: Fragment
@@ -20869,11 +21080,38 @@
                 "stop",
                 "error"
             ]);
+            var _useState = _sliced_to_array(useState(false), 2), isClearing = _useState[0], setIsClearing = _useState[1];
+            var commitClear = headerProps.onClear || messagesProps.onNewConversation;
+            var startClear = function startClear() {
+                if (!commitClear) {
+                    return;
+                }
+                // Reduced motion disables the transition, so `transitionend` never fires;
+                // commit immediately instead of waiting for it.
+                if (prefersReducedMotion()) {
+                    commitClear();
+                    return;
+                }
+                // Stop streaming now so the assistant stops immediately, not after the fade.
+                if (messagesProps.status === 'submitted' || messagesProps.status === 'streaming') {
+                    stop();
+                }
+                setIsClearing(true);
+            };
+            var finishClear = function finishClear() {
+                commitClear === null || commitClear === void 0 ? void 0 : commitClear();
+                setIsClearing(false);
+            };
             var headerComponent = createElement(HeaderComponent || ChatHeader, _object_spread_props(_object_spread({}, headerProps), {
+                onClear: commitClear ? startClear : headerProps.onClear,
+                canClear: headerProps.canClear && !isClearing,
                 classNames: classNames.header,
                 maximized: maximized
             }));
             var messagesComponent = /*#__PURE__*/ createElement(ChatMessages, _object_spread_props(_object_spread({}, messagesProps), {
+                isClearing: isClearing,
+                onClearTransitionEnd: finishClear,
+                onNewConversation: commitClear ? startClear : messagesProps.onNewConversation,
                 error: error,
                 classNames: classNames.messages,
                 messageClassNames: classNames.message,
@@ -20898,9 +21136,9 @@
                 messages: messagesProps.messages,
                 status: messagesProps.status,
                 tools: messagesProps.tools,
-                isClearing: messagesProps.isClearing,
-                clearMessages: headerProps.onClear,
-                onClearTransitionEnd: messagesProps.onClearTransitionEnd,
+                isClearing: isClearing,
+                clearMessages: commitClear ? startClear : headerProps.onClear,
+                onClearTransitionEnd: finishClear,
                 suggestions: suggestionsProps.suggestions,
                 sendMessage: sendMessage,
                 regenerate: regenerate,
@@ -23395,7 +23633,8 @@
     var ChatUiComponent = createChatComponent({
         createElement: React.createElement,
         Fragment: React.Fragment,
-        memo: React.memo
+        memo: React.memo,
+        useState: React.useState
     });
     function createDefaultTools(itemComponent, getSearchPageURL) {
         var _obj;
@@ -23460,7 +23699,7 @@
             tools: tools,
             disableTriggerValidation: effectiveDisableTriggerValidation
         }));
-        var messages = chatState.messages, sendMessage = chatState.sendMessage, status = chatState.status, regenerate = chatState.regenerate, stop = chatState.stop, error = chatState.error, input = chatState.input, setInput = chatState.setInput, open = chatState.open, setOpen = chatState.setOpen, isClearing = chatState.isClearing, clearMessages = chatState.clearMessages, onClearTransitionEnd = chatState.onClearTransitionEnd, toolsFromConnector = chatState.tools, suggestions = chatState.suggestions, onFeedback = chatState.sendChatMessageFeedback, feedbackState = chatState.feedbackState;
+        var messages = chatState.messages, sendMessage = chatState.sendMessage, status = chatState.status, regenerate = chatState.regenerate, stop = chatState.stop, error = chatState.error, input = chatState.input, setInput = chatState.setInput, open = chatState.open, setOpen = chatState.setOpen, clearMessages = chatState.clearMessages, toolsFromConnector = chatState.tools, suggestions = chatState.suggestions, onFeedback = chatState.sendChatMessageFeedback, feedbackState = chatState.feedbackState;
         React.useImperativeHandle(ref, function() {
             return {
                 setOpen: setOpen,
@@ -23524,7 +23763,7 @@
                     return setMaximized(!maximized);
                 },
                 onClear: clearMessages,
-                canClear: Boolean(messages === null || messages === void 0 ? void 0 : messages.length) && !isClearing,
+                canClear: Boolean(messages === null || messages === void 0 ? void 0 : messages.length),
                 titleIconComponent: headerTitleIconComponent,
                 closeIconComponent: headerCloseIconComponent,
                 minimizeIconComponent: headerMinimizeIconComponent,
@@ -23550,8 +23789,6 @@
                 tools: toolsFromConnector,
                 indexUiState: indexUiState,
                 setIndexUiState: setIndexUiState,
-                isClearing: isClearing,
-                onClearTransitionEnd: onClearTransitionEnd,
                 isScrollAtBottom: isAtBottom,
                 scrollRef: scrollRef,
                 contentRef: contentRef,
@@ -23806,7 +24043,10 @@
             "isShowingMore",
             "translations"
         ]);
-        return /*#__PURE__*/ React.createElement("button", props, translations.showMoreButtonText({
+        return /*#__PURE__*/ React.createElement("button", _object_spread_props(_object_spread({}, props), {
+            "aria-expanded": isShowingMore,
+            "aria-label": translations.showMoreButtonLabel
+        }), translations.showMoreButtonText({
             isShowingMore: isShowingMore
         }));
     }
@@ -24336,6 +24576,7 @@
                     currentPage: page + 1,
                     nbPages: nbPages
                 }),
+                "aria-current": page === currentPage ? 'page' : undefined,
                 href: createURL(page),
                 onClick: function onClick() {
                     return onNavigate(page);
@@ -24804,13 +25045,15 @@
         })), /*#__PURE__*/ React.createElement("button", {
             className: cx('ais-SearchBox-submit', classNames.submit),
             type: "submit",
-            title: translations.submitButtonTitle
+            title: translations.submitButtonTitle,
+            "aria-label": translations.submitButtonTitle
         }, /*#__PURE__*/ React.createElement(SubmitIcon, {
             classNames: classNames
         })), /*#__PURE__*/ React.createElement("button", {
             className: cx('ais-SearchBox-reset', classNames.reset),
             type: "reset",
             title: translations.resetButtonTitle,
+            "aria-label": translations.resetButtonTitle,
             hidden: value.length === 0 || isSearchStalled
         }, /*#__PURE__*/ React.createElement(ResetIcon, {
             classNames: classNames
@@ -24922,7 +25165,8 @@
             onToggleShowMore: toggleShowMore,
             isShowingMore: isShowingMore,
             translations: {
-                showMoreButtonText: mergedTranslations.showMoreButtonText
+                showMoreButtonText: mergedTranslations.showMoreButtonText,
+                showMoreButtonLabel: translations === null || translations === void 0 ? void 0 : translations.showMoreButtonLabel
             }
         };
         return /*#__PURE__*/ React.createElement(RefinementList$1, _object_spread_props(_object_spread({}, props, uiProps), {
@@ -25146,6 +25390,21 @@
         return /*#__PURE__*/ React.createElement(SortBy$1, _object_spread({}, props, uiProps));
     }
 
+    // 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: 1,
+        height: 1,
+        padding: 0,
+        margin: -1,
+        overflow: 'hidden',
+        clip: 'rect(0, 0, 0, 0)',
+        whiteSpace: 'nowrap',
+        border: 0
+    };
     function Stats$1(_0) {
         var _0_classNames = _0.classNames, classNames = _0_classNames === void 0 ? {} : _0_classNames, nbHits = _0.nbHits, processingTimeMS = _0.processingTimeMS, nbSortedHits = _0.nbSortedHits, areHitsSorted = _0.areHitsSorted, translations = _0.translations, props = _object_without_properties(_0, [
             "classNames",
@@ -25161,11 +25420,37 @@
             nbSortedHits: nbSortedHits,
             areHitsSorted: areHitsSorted
         };
+        var nextAnnouncement = translations.announcementText ? translations.announcementText(translationOptions) : '';
+        var _useState = _sliced_to_array(React.useState(''), 2), announcement = _useState[0], setAnnouncement = _useState[1];
+        var timerRef = React.useRef(undefined);
+        var isInitialRef = React.useRef(true);
+        React.useEffect(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__*/ React.createElement("div", _object_spread_props(_object_spread({}, props), {
             className: cx('ais-Stats', classNames.root, props.className)
         }), /*#__PURE__*/ React.createElement("span", {
             className: "ais-Stats-text"
-        }, translations.rootElementText(translationOptions)));
+        }, translations.rootElementText(translationOptions)), /*#__PURE__*/ React.createElement("span", {
+            className: "ais-Stats-announcement",
+            role: "status",
+            "aria-live": "polite",
+            "aria-atomic": "true",
+            style: visuallyHiddenStyle
+        }, announcement));
     }
 
     function Stats(_0) {
@@ -25183,6 +25468,9 @@
             translations: _object_spread({
                 rootElementText: function rootElementText(options) {
                     return "".concat(options.areHitsSorted ? getSortedResultsSentence(options) : getResultsSentence(options), " found in ").concat(options.processingTimeMS.toLocaleString(), "ms");
+                },
+                announcementText: function announcementText(options) {
+                    return options.areHitsSorted ? getSortedResultsSentence(options) : getResultsSentence(options);
                 }
             }, translations)
         };