feat(CompactMap): add autoExpandOnCarouselClick prop for opt-in auto-expand

Adds explicit control over auto-expand behavior with a new prop.

New Prop:
- autoExpandOnCarouselClick: boolean (default: false)
- When true: clicking carousel card auto-expands to fullscreen
- When false: users must click expand button manually

Benefits:
- Backward compatible (default: false preserves existing behavior)
- Explicit opt-in for auto-expand UX
- Developers can choose based on their use case
- Doesn't force auto-expand on all CompactMap instances

Implementation:
- Added prop to CompactMapProps interface
- Wrapped carousel onLocationSelect to conditionally call onExpand
- Only triggers when prop is true AND location is selected AND onExpand exists

Usage:
<CompactMap
  locations={locations}
  onExpand={handleExpand}
  autoExpandOnCarouselClick={true}  // Opt-in
/>

Author: JakeLin

packages/ui/src/components/Map/CompactMap.tsx

@@ -50,6 +50,14 @@ export interface CompactMapProps extends Omit<MapViewProps, 'className' | 'style
    * Callback when user clicks the expand button to enter fullscreen.
    */
   onExpand?: () => void;
+
+  /**
+   * Auto-expand to fullscreen when user clicks a carousel card.
+   * When true, selecting a location from the carousel automatically triggers onExpand.
+   * When false, users must click the expand button manually.
+   * @default false
+   */
+  autoExpandOnCarouselClick?: boolean;
 }
 
 const DEFAULT_HEIGHT = '478px';
@@ -76,6 +84,7 @@ export const CompactMap: React.FC<CompactMapProps> = ({
   mapStyle,
   carouselProps,
   onExpand,
+  autoExpandOnCarouselClick = false,
 }) => {
   const containerStyle: React.CSSProperties = {
     ...style,
@@ -121,7 +130,15 @@ export const CompactMap: React.FC<CompactMapProps> = ({
       <LocationCarousel
         locations={locations}
         selectedId={selectedId}
-        onLocationSelect={onLocationSelect}
+        onLocationSelect={(id) => {
+          // Set selection first
+          onLocationSelect?.(id);
+
+          // Then trigger fullscreen if auto-expand is enabled
+          if (autoExpandOnCarouselClick && id !== undefined && onExpand) {
+            onExpand();
+          }
+        }}
         loading={loading}
         error={error}
         {...carouselProps}