Merge main (v1.8.9) into develop

THIRD-PARTY-NOTICES

@@ -1192,6 +1192,7 @@ limitations under the License.
 The following NPM packages may be included in this product:
 
  - @tailwindcss/forms@0.5.10
+ - @tailwindcss/typography@0.5.16
  - tailwindcss@3.4.17
 
 These packages each contain the following license and notice below:
@@ -3435,6 +3436,7 @@ THE SOFTWARE.
 The following NPM packages may be included in this product:
 
  - lodash-es@4.17.21
+ - lodash.merge@4.6.2
  - lodash@4.17.21
 
 These packages each contain the following license and notice below:
@@ -3489,6 +3491,94 @@ terms above.
 
 -----------
 
+The following NPM package may be included in this product:
+
+ - lodash.castarray@4.4.0
+
+This package contains the following license and notice below:
+
+The MIT License (MIT)
+
+Copyright 2012-2016 The Dojo Foundation <http://dojofoundation.org/>
+Based on Underscore.js, copyright 2009-2016 Jeremy Ashkenas,
+DocumentCloud and Investigative Reporters & Editors <http://underscorejs.org/>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+-----------
+
+The following NPM package may be included in this product:
+
+ - lodash.isplainobject@4.0.6
+
+This package contains the following license and notice below:
+
+Copyright jQuery Foundation and other contributors <https://jquery.org/>
+
+Based on Underscore.js, copyright Jeremy Ashkenas,
+DocumentCloud and Investigative Reporters & Editors <http://underscorejs.org/>
+
+This software consists of voluntary contributions made by many
+individuals. For exact contribution history, see the revision history
+available at https://github.com/lodash/lodash
+
+The following license applies to all parts of this software except as
+documented below:
+
+====
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+====
+
+Copyright and related rights for sample code are waived via CC0. Sample
+code is defined as all source code displayed within the prose of the
+documentation.
+
+CC0: http://creativecommons.org/publicdomain/zero/1.0/
+
+====
+
+Files located in the node_modules and vendor directories are externally
+maintained libraries used by this software which have their own
+licenses; we recommend you read them, as their terms may differ from the
+terms above.
+
+-----------
+
 The following NPM packages may be included in this product:
 
  - longest-streak@2.0.4
@@ -4680,11 +4770,12 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 -----------
 
-The following NPM package may be included in this product:
+The following NPM packages may be included in this product:
 
+ - postcss-selector-parser@6.0.10
  - postcss-selector-parser@6.1.2
 
-This package contains the following license and notice below:
+These packages each contain the following license and notice below:
 
 Copyright (c) Ben Briggs <beneb.info@gmail.com> (http://beneb.info)
 

docs/search-ui-react.mapboxmap.md

@@ -9,7 +9,7 @@ A component that renders a map with markers to show result locations using Mapbo
 **Signature:**
 
 ```typescript
-declare function MapboxMap<T>({ mapboxAccessToken, mapboxOptions, PinComponent, renderPin, getCoordinate, onDrag, iframeWindow, allowUpdates, }: MapboxMapProps<T>): JSX.Element;
+declare function MapboxMap<T>({ mapboxAccessToken, mapboxOptions, PinComponent, renderPin, getCoordinate, onDrag, iframeWindow, allowUpdates, onPinClick, markerOptionsOverride, }: MapboxMapProps<T>): JSX.Element;
 ```
 
 ## Parameters
@@ -32,7 +32,7 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
-{ mapboxAccessToken, mapboxOptions, PinComponent, renderPin, getCoordinate, onDrag, iframeWindow, allowUpdates, }
+{ mapboxAccessToken, mapboxOptions, PinComponent, renderPin, getCoordinate, onDrag, iframeWindow, allowUpdates, onPinClick, markerOptionsOverride, }
 
 
 </td><td>

docs/search-ui-react.mapboxmapprops.markeroptionsoverride.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@yext/search-ui-react](./search-ui-react.md) &gt; [MapboxMapProps](./search-ui-react.mapboxmapprops.md) &gt; [markerOptionsOverride](./search-ui-react.mapboxmapprops.markeroptionsoverride.md)
+
+## MapboxMapProps.markerOptionsOverride property
+
+The options to apply to the map markers based on whether it is selected.
+
+**Signature:**
+
+```typescript
+markerOptionsOverride?: (selected: boolean) => MarkerOptions;
+```

docs/search-ui-react.mapboxmapprops.md

@@ -129,6 +129,25 @@ Omit<mapboxgl.MapboxOptions, 'container'>
 _(Optional)_ Interface for map customization derived from Mapbox GL's Map options.
 
 
+</td></tr>
+<tr><td>
+
+[markerOptionsOverride?](./search-ui-react.mapboxmapprops.markeroptionsoverride.md)
+
+
+</td><td>
+
+
+</td><td>
+
+(selected: boolean) =&gt; MarkerOptions
+
+
+</td><td>
+
+_(Optional)_ The options to apply to the map markers based on whether it is selected.
+
+
 </td></tr>
 <tr><td>
 
@@ -145,7 +164,26 @@ _(Optional)_ Interface for map customization derived from Mapbox GL's Map option
 
 </td><td>
 
-_(Optional)_ A function which is called when user drag the map.
+_(Optional)_ A function which is called when user drags or zooms the map.
+
+
+</td></tr>
+<tr><td>
+
+[onPinClick?](./search-ui-react.mapboxmapprops.onpinclick.md)
+
+
+</td><td>
+
+
+</td><td>
+
+(result: Result&lt;T&gt; \| undefined) =&gt; void
+
+
+</td><td>
+
+_(Optional)_ A function that handles a pin click event.
 
 
 </td></tr>

docs/search-ui-react.mapboxmapprops.ondrag.md

@@ -4,7 +4,7 @@
 
 ## MapboxMapProps.onDrag property
 
-A function which is called when user drag the map.
+A function which is called when user drags or zooms the map.
 
 **Signature:**
 

docs/search-ui-react.mapboxmapprops.onpinclick.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@yext/search-ui-react](./search-ui-react.md) &gt; [MapboxMapProps](./search-ui-react.mapboxmapprops.md) &gt; [onPinClick](./search-ui-react.mapboxmapprops.onpinclick.md)
+
+## MapboxMapProps.onPinClick property
+
+A function that handles a pin click event.
+
+**Signature:**
+
+```typescript
+onPinClick?: (result: Result<T> | undefined) => void;
+```

docs/search-ui-react.md

@@ -239,7 +239,7 @@ A React Component which displays and collects location information in order to b
 </td></tr>
 <tr><td>
 
-[MapboxMap({ mapboxAccessToken, mapboxOptions, PinComponent, renderPin, getCoordinate, onDrag, iframeWindow, allowUpdates, })](./search-ui-react.mapboxmap.md)
+[MapboxMap({ mapboxAccessToken, mapboxOptions, PinComponent, renderPin, getCoordinate, onDrag, iframeWindow, allowUpdates, onPinClick, markerOptionsOverride, })](./search-ui-react.mapboxmap.md)
 
 
 </td><td>
@@ -1433,7 +1433,7 @@ The data associated with the currently focused item.
 
 </td><td>
 
-A function which is called when user drag the map.
+A function which is called when user drags or zooms the map.
 
 
 </td></tr>

docs/search-ui-react.ondraghandler.md

@@ -4,7 +4,7 @@
 
 ## OnDragHandler type
 
-A function which is called when user drag the map.
+A function which is called when user drags or zooms the map.
 
 **Signature:**
 

docs/search-ui-react.pincomponentprops.md

@@ -13,5 +13,6 @@ type PinComponentProps<T> = {
     index: number;
     mapbox: mapboxgl.Map;
     result: Result<T>;
+    selected?: boolean;
 };
 ```

docs/search-ui-react.verticalresultsprops.md

@@ -91,5 +91,24 @@ boolean
 _(Optional)_ Whether or not all results should be displayed when there are none returned from the search. Defaults to true.
 
 
+</td></tr>
+<tr><td>
+
+[setResultsRef?](./search-ui-react.verticalresultsprops.setresultsref.md)
+
+
+</td><td>
+
+
+</td><td>
+
+(index: number) =&gt; ((result: HTMLDivElement) =&gt; void) \| null
+
+
+</td><td>
+
+_(Optional)_ set individual result refs.
+
+
 </td></tr>
 </tbody></table>

docs/search-ui-react.verticalresultsprops.setresultsref.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@yext/search-ui-react](./search-ui-react.md) &gt; [VerticalResultsProps](./search-ui-react.verticalresultsprops.md) &gt; [setResultsRef](./search-ui-react.verticalresultsprops.setresultsref.md)
+
+## VerticalResultsProps.setResultsRef property
+
+set individual result refs.
+
+**Signature:**
+
+```typescript
+setResultsRef?: (index: number) => ((result: HTMLDivElement) => void) | null;
+```

etc/search-ui-react.api.md

@@ -14,6 +14,7 @@ import { FilterSearchResponse } from '@yext/search-headless-react';
 import { GenerativeDirectAnswerResponse } from '@yext/search-headless-react';
 import { HighlightedValue } from '@yext/search-headless-react';
 import { default as mapboxgl_2 } from 'mapbox-gl';
+import { MarkerOptions } from 'mapbox-gl';
 import { Matcher } from '@yext/search-headless-react';
 import { NumberRangeValue } from '@yext/search-headless-react';
 import { PropsWithChildren } from 'react';
@@ -490,7 +491,7 @@ export interface LocationBiasProps {
 }
 
 // @public
-export function MapboxMap<T>({ mapboxAccessToken, mapboxOptions, PinComponent, renderPin, getCoordinate, onDrag, iframeWindow, allowUpdates, }: MapboxMapProps<T>): JSX.Element;
+export function MapboxMap<T>({ mapboxAccessToken, mapboxOptions, PinComponent, renderPin, getCoordinate, onDrag, iframeWindow, allowUpdates, onPinClick, markerOptionsOverride, }: MapboxMapProps<T>): JSX.Element;
 
 // @public
 export interface MapboxMapProps<T> {
@@ -499,7 +500,9 @@ export interface MapboxMapProps<T> {
     iframeWindow?: Window;
     mapboxAccessToken: string;
     mapboxOptions?: Omit<mapboxgl_2.MapboxOptions, 'container'>;
+    markerOptionsOverride?: (selected: boolean) => MarkerOptions;
     onDrag?: OnDragHandler;
+    onPinClick?: (result: Result<T> | undefined) => void;
     PinComponent?: PinComponent<T>;
     renderPin?: (props: PinComponentProps<T> & {
         container: HTMLElement;
@@ -595,6 +598,7 @@ export type PinComponentProps<T> = {
     index: number;
     mapbox: mapboxgl_2.Map;
     result: Result<T>;
+    selected?: boolean;
 };
 
 // @public
@@ -980,6 +984,7 @@ export interface VerticalResultsProps<T> {
     CardComponent: CardComponent<T>;
     customCssClasses?: VerticalResultsCssClasses;
     displayAllOnNoResults?: boolean;
+    setResultsRef?: (index: number) => ((result: HTMLDivElement) => void) | null;
 }
 
 // @public