@giddaa-housing/ui 0.1.0

package/dist/photo-gallery.d.ts

@@ -0,0 +1,42 @@
+import * as React from 'react';
+
+/**
+ * A single property photo. `src` is optional so the gallery can render a
+ * "Property Image" placeholder in previews / while imagery is still loading.
+ */
+type PhotoGalleryImage = {
+    src?: string;
+    alt?: string;
+};
+type PhotoGalleryProps = Omit<React.ComponentProps<"div">, "onClick"> & {
+    images: PhotoGalleryImage[];
+    /** Controlled active index. Omit to let the gallery manage it internally. */
+    index?: number;
+    onIndexChange?: (index: number) => void;
+    /** Called when the hero image is activated — wire this to open fullscreen. */
+    onImageClick?: (index: number) => void;
+};
+/**
+ * Inline property gallery: a swipeable hero image (drag / touch / ← →) with a
+ * counter pill, navigation arrows, and a thumbnail strip below. Built on
+ * {@link Carousel}. Standalone — pass `onImageClick` to open it into a
+ * {@link PhotoGalleryFullscreen} viewer, but neither surface needs the other.
+ */
+declare function PhotoGallery({ images, index, onIndexChange, onImageClick, className, ...props }: PhotoGalleryProps): React.JSX.Element;
+type PhotoGalleryFullscreenProps = {
+    images: PhotoGalleryImage[];
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** Controlled active index. Omit to let the viewer manage it internally. */
+    index?: number;
+    onIndexChange?: (index: number) => void;
+};
+/**
+ * Fullscreen lightbox: takes over the viewport over a `bg-canvas` surface for
+ * distraction-free browsing. Swipeable (drag / touch) with ← → key navigation
+ * and ESC to close. Built on {@link Carousel}; controlled via `open` /
+ * `onOpenChange` and usable without the inline gallery.
+ */
+declare function PhotoGalleryFullscreen({ images, open, onOpenChange, index, onIndexChange, }: PhotoGalleryFullscreenProps): React.JSX.Element;
+
+export { PhotoGallery, PhotoGalleryFullscreen, type PhotoGalleryFullscreenProps, type PhotoGalleryImage, type PhotoGalleryProps };