@boyernick/standard-ui-react 0.1.1-canary.19 → 0.1.1-canary.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boyernick/standard-ui-react",
-  "version": "0.1.1-canary.19",
+  "version": "0.1.1-canary.20",
   "description": "React components for StandardUI",
   "license": "MIT",
   "type": "module",

package/src/breadcrumb.tsx

@@ -14,7 +14,7 @@ const breadcrumbSeparatorVariants = cva("text-fg-tertiary", {
   variants: {
     variant: {
       chevron: "[&_svg]:size-3.5",
-      slash: "px-0.5",
+      slash: "",
     },
   },
   defaultVariants: {
@@ -39,7 +39,7 @@ export const BreadcrumbList = ({
   ...props
 }: BreadcrumbListProps) => (
   <ol
-    className={cn("flex flex-wrap items-center gap-0.5", className)}
+    className={cn("flex flex-wrap items-center gap-x-2 gap-y-1.5", className)}
     {...props}
   />
 )
@@ -49,7 +49,7 @@ export const BreadcrumbItem = ({
   ...props
 }: BreadcrumbItemProps) => (
   <li
-    className={cn("inline-flex items-center gap-1.5 px-1", className)}
+    className={cn("inline-flex items-center gap-1.5", className)}
     {...props}
   />
 )

package/src/command.tsx

@@ -384,6 +384,15 @@ export const CommandTitle = ({ className, children }: CommandTitleProps) => (
   <span className={cn("min-w-0 truncate", className)}>{children}</span>
 )
 
+export type CommandMetaProps = HTMLAttributes<HTMLSpanElement>
+
+export const CommandMeta = ({ className, ...props }: CommandMetaProps) => (
+  <span
+    className={cn("shrink-0 text-xs font-normal text-fg-tertiary", className)}
+    {...props}
+  />
+)
+
 export const CommandDialogTitle = ({
   className,
   ...props

package/src/icons.tsx

@@ -1,6 +1,7 @@
 "use client"
 
 import type { CentralIconBaseProps } from "@central-icons-react/round-outlined-radius-2-stroke-2/CentralIconBase"
+import { IconArrowDown as IconArrowDownBase } from "@central-icons-react/round-outlined-radius-2-stroke-2/IconArrowDown"
 import { IconBell as IconBellBase } from "@central-icons-react/round-outlined-radius-2-stroke-2/IconBell"
 import { IconCalendar1 as IconCalendar1Base } from "@central-icons-react/round-outlined-radius-2-stroke-2/IconCalendar1"
 import { IconChainLink1 as IconChainLink1Base } from "@central-icons-react/round-outlined-radius-2-stroke-2/IconChainLink1"
@@ -54,6 +55,7 @@ export const withCentralIconDefaults = (
   return CentralIcon
 }
 
+export const IconArrowDown = withCentralIconDefaults(IconArrowDownBase)
 export const IconBell = withCentralIconDefaults(IconBellBase)
 export const IconCalendar1 = withCentralIconDefaults(IconCalendar1Base)
 export const IconChainLink1 = withCentralIconDefaults(IconChainLink1Base)

package/src/image-modal.tsx

@@ -1,7 +1,25 @@
 "use client"
 
-import type { ComponentProps, ImgHTMLAttributes } from "react"
-import { Button } from "./button"
+import { cva, type VariantProps } from "class-variance-authority"
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useEffect,
+  useState,
+  type ComponentProps,
+  type ImgHTMLAttributes,
+  type KeyboardEvent,
+  type ReactElement,
+  type ReactNode,
+} from "react"
+import { Button, buttonVariants } from "./button"
+import {
+  Carousel,
+  CarouselContent,
+  CarouselItem,
+  type CarouselApi,
+} from "./carousel"
 import {
   Dialog,
   DialogBackdrop,
@@ -11,18 +29,103 @@ import {
   DialogTitle,
   DialogTrigger,
 } from "./dialog"
+import {
+  IconArrowDown,
+  IconChevronRightSmall,
+  IconCrossSmall,
+} from "./icons"
 import { cn } from "./lib/cn"
 import { motion } from "./lib/motion"
+import {
+  Tooltip,
+  TooltipPopup,
+  TooltipPortal,
+  TooltipPositioner,
+  TooltipProvider,
+  TooltipTrigger,
+  type TooltipPositionerProps,
+} from "./tooltip"
+
+const TRACKPAD_LABEL =
+  "Swipe, use the arrow keys, or use the controls to navigate"
+
+const imageModalControlClassName =
+  "border-border-inverted bg-surface-inverted/60 text-fg-inverted shadow-md backdrop-blur-md hover:bg-surface-inverted/80 hover:text-fg-inverted focus-visible:border-ring focus-visible:ring-border-inverted focus-visible:ring-offset-surface-inverted"
+
+export const imageModalContentVariants = cva(
+  "h-dvh max-h-dvh w-screen max-w-none gap-0 overflow-hidden rounded-none border-0 bg-transparent p-0 shadow-none max-sm:max-w-none",
+  {
+    variants: {
+      variant: {
+        default: "[&_[data-slot=image-modal-stage]]:pb-0",
+        caption: "[&_[data-slot=image-modal-stage]]:pb-20",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+    },
+  },
+)
 
 export type ImageModalProps = ComponentProps<typeof Dialog>
 export type ImageModalTriggerProps = ComponentProps<typeof DialogTrigger>
-export type ImageModalContentProps = ComponentProps<typeof DialogPopup> & {
+export type ImageModalContentProps = Omit<
+  ComponentProps<typeof DialogPopup>,
+  "children"
+> &
+  VariantProps<typeof imageModalContentVariants> & {
+    src: string
+    alt: string
+    caption?: ReactNode
+    downloadSrc?: string
+    downloadName?: string
+    imgProps?: Omit<ImgHTMLAttributes<HTMLImageElement>, "src" | "alt">
+    children?: ReactNode
+  }
+
+export type ImageModalItem = {
   src: string
   alt: string
-  caption?: string
+  caption?: ReactNode
+  downloadSrc?: string
+  downloadName?: string
   imgProps?: Omit<ImgHTMLAttributes<HTMLImageElement>, "src" | "alt">
 }
 
+export type ImageModalGalleryProps = Omit<ImageModalProps, "children"> &
+  VariantProps<typeof imageModalContentVariants> & {
+    images: readonly ImageModalItem[]
+    children: ReactNode
+    loop?: boolean
+    contentClassName?: string
+  }
+
+export type ImageModalGalleryTriggerProps = ImageModalTriggerProps & {
+  index: number
+}
+
+type ImageModalTriggerClickEvent = Parameters<
+  NonNullable<ImageModalTriggerProps["onClick"]>
+>[0]
+
+type ImageModalGalleryContextValue = {
+  images: readonly ImageModalItem[]
+  setActiveIndex: (index: number) => void
+}
+
+const ImageModalGalleryContext =
+  createContext<ImageModalGalleryContextValue | null>(null)
+
+const useImageModalGallery = () => {
+  const context = useContext(ImageModalGalleryContext)
+  if (!context) {
+    throw new Error(
+      "ImageModalGalleryTrigger must be used within <ImageModalGallery>",
+    )
+  }
+  return context
+}
+
 export const ImageModal = (props: ImageModalProps) => <Dialog {...props} />
 
 export const ImageModalTrigger = ({
@@ -38,73 +141,361 @@ export const ImageModalTrigger = ({
   />
 )
 
+const ImageModalBackdrop = () => (
+  <DialogBackdrop className="bg-surface-inverted/95" />
+)
+
+const ImageModalBackground = ({ src }: { src: string }) => (
+  <div
+    aria-hidden="true"
+    className="pointer-events-none absolute inset-0 overflow-hidden"
+  >
+    {/* Consumers may use any image host, so this package deliberately renders
+        the platform-neutral image element rather than Next.js Image. */}
+    {/* eslint-disable-next-line @next/next/no-img-element */}
+    <img
+      src={src}
+      alt=""
+      className="size-full scale-110 object-cover opacity-25 blur-3xl"
+    />
+    <div className="absolute inset-0 bg-surface-inverted/65" />
+  </div>
+)
+
+const ImageModalImage = ({
+  src,
+  alt,
+  imgProps,
+}: Pick<ImageModalItem, "src" | "alt" | "imgProps">) => {
+  const { className, ...props } = imgProps ?? {}
+
+  return (
+    // eslint-disable-next-line @next/next/no-img-element
+    <img
+      src={src}
+      alt={alt}
+      draggable={false}
+      className={cn(
+        "max-h-[82dvh] max-w-[88vw] rounded-lg object-contain shadow-lg select-none max-sm:max-h-[calc(100dvh-2rem)] max-sm:max-w-[calc(100vw-2rem)]",
+        className,
+      )}
+      {...props}
+    />
+  )
+}
+
+const ImageModalControlTooltip = ({
+  label,
+  side = "bottom",
+  children,
+}: {
+  label: string
+  side?: TooltipPositionerProps["side"]
+  children: ReactElement
+}) => (
+  <Tooltip>
+    <TooltipTrigger render={children} />
+    <TooltipPortal>
+      <TooltipPositioner side={side}>
+        <TooltipPopup variant="inverted">{label}</TooltipPopup>
+      </TooltipPositioner>
+    </TooltipPortal>
+  </Tooltip>
+)
+
+const ImageModalDownload = ({
+  src,
+  name,
+}: {
+  src: string
+  name?: string
+}) => (
+  <ImageModalControlTooltip label="Download image">
+    <a
+      href={src}
+      download={name ?? ""}
+      aria-label="Download image"
+      className={cn(
+        buttonVariants({
+          variant: "ghost",
+          size: "md",
+          rounded: true,
+          iconOnly: true,
+        }),
+        imageModalControlClassName,
+        "absolute top-4 right-4 z-20",
+      )}
+    >
+      <IconArrowDown aria-hidden />
+    </a>
+  </ImageModalControlTooltip>
+)
+
+const ImageModalDismiss = () => (
+  <ImageModalControlTooltip label="Close image">
+    <DialogClose
+      render={
+        <Button
+          type="button"
+          variant="ghost"
+          size="md"
+          iconOnly
+          rounded
+          aria-label="Close image"
+          className={cn(
+            imageModalControlClassName,
+            "absolute top-4 left-4 z-20",
+          )}
+        />
+      }
+    >
+      <IconCrossSmall aria-hidden />
+    </DialogClose>
+  </ImageModalControlTooltip>
+)
+
+const ImageModalCaption = ({ children }: { children: ReactNode }) => (
+  <div className="absolute inset-x-0 bottom-0 z-10 flex min-h-20 items-center justify-center bg-surface-inverted/65 px-6 py-4 text-center text-sm text-fg-inverted-secondary backdrop-blur-md">
+    {children}
+  </div>
+)
+
 export const ImageModalContent = ({
   src,
   alt,
   caption,
+  downloadSrc,
+  downloadName,
+  variant = "default",
   className,
   imgProps,
   children,
   ...props
 }: ImageModalContentProps) => (
   <DialogPortal>
-    <DialogBackdrop className="bg-black/70 dark:bg-black/80" />
+    <ImageModalBackdrop />
     <DialogPopup
       data-slot="image-modal-content"
       className={cn(
-        "max-h-[90vh] w-full max-w-4xl gap-0 overflow-hidden border-border-primary bg-surface p-0 shadow-lg max-sm:max-w-[calc(100vw-1.5rem)]",
+        imageModalContentVariants({ variant }),
         motion.popupCenter,
         className,
       )}
       {...props}
     >
-      <div className="relative">
+      <TooltipProvider delay={250}>
+        <ImageModalBackground src={src} />
         <DialogTitle className="sr-only">{alt}</DialogTitle>
-        {/* eslint-disable-next-line @next/next/no-img-element */}
-        <img
-          src={src}
-          alt={alt}
-          className={cn(
-            "max-h-[min(80vh,56rem)] w-full object-contain bg-background-secondary",
-            imgProps?.className,
-          )}
-          {...imgProps}
-        />
-        <DialogClose
-          render={
-            <Button
-              type="button"
-              variant="secondary"
-              size="sm"
-              iconOnly
-              rounded
-              aria-label="Close"
-              className="absolute top-3 right-3"
-            />
-          }
+        <div
+          data-slot="image-modal-stage"
+          className="relative z-10 flex size-full items-center justify-center p-4"
         >
-          <CloseIcon />
-        </DialogClose>
-      </div>
-      {caption || children ? (
-        <div className="border-t border-border-primary px-4 py-3">
-          {caption ? (
-            <p className="text-sm text-fg-secondary">{caption}</p>
-          ) : null}
-          {children}
+          <ImageModalImage src={src} alt={alt} imgProps={imgProps} />
         </div>
-      ) : null}
+        <ImageModalDismiss />
+        <ImageModalDownload
+          src={downloadSrc ?? src}
+          name={downloadName}
+        />
+        {variant === "caption" && (caption || children) ? (
+          <ImageModalCaption>{caption ?? children}</ImageModalCaption>
+        ) : null}
+      </TooltipProvider>
     </DialogPopup>
   </DialogPortal>
 )
 
-const CloseIcon = () => (
-  <svg viewBox="0 0 24 24" fill="none" className="size-4" aria-hidden>
-    <path
-      d="M7 7l10 10M17 7 7 17"
-      stroke="currentColor"
-      strokeWidth="2"
-      strokeLinecap="round"
-    />
-  </svg>
-)
+export const ImageModalGalleryTrigger = ({
+  index,
+  onClick,
+  ...props
+}: ImageModalGalleryTriggerProps) => {
+  const { images, setActiveIndex } = useImageModalGallery()
+
+  const handleClick = (event: ImageModalTriggerClickEvent) => {
+    onClick?.(event)
+    if (!event.defaultPrevented && images[index]) setActiveIndex(index)
+  }
+
+  return <ImageModalTrigger onClick={handleClick} {...props} />
+}
+
+const ImageModalGalleryContent = ({
+  images,
+  activeIndex,
+  setActiveIndex,
+  loop,
+  variant,
+  className,
+}: {
+  images: readonly ImageModalItem[]
+  activeIndex: number
+  setActiveIndex: (index: number) => void
+  loop: boolean
+  variant: "default" | "caption"
+  className?: string
+}) => {
+  const [api, setApi] = useState<CarouselApi>()
+  const activeImage = images[activeIndex]
+
+  useEffect(() => {
+    api?.scrollTo(activeIndex, true)
+  }, [activeIndex, api])
+
+  useEffect(() => {
+    if (!api) return
+    const syncIndex = () => setActiveIndex(api.selectedScrollSnap())
+    api.on("select", syncIndex)
+    api.on("reInit", syncIndex)
+    return () => {
+      api.off("select", syncIndex)
+      api.off("reInit", syncIndex)
+    }
+  }, [api, setActiveIndex])
+
+  const handleKeyDown = (event: KeyboardEvent<HTMLDivElement>) => {
+    if (event.key === "ArrowLeft") {
+      event.preventDefault()
+      api?.scrollPrev()
+    } else if (event.key === "ArrowRight") {
+      event.preventDefault()
+      api?.scrollNext()
+    }
+  }
+
+  if (!activeImage) return null
+
+  return (
+    <DialogPortal>
+      <ImageModalBackdrop />
+      <DialogPopup
+        data-slot="image-modal-gallery-content"
+        aria-describedby={undefined}
+        onKeyDownCapture={handleKeyDown}
+        className={cn(
+          imageModalContentVariants({ variant }),
+          motion.popupCenter,
+          className,
+        )}
+      >
+        <TooltipProvider delay={250}>
+          <ImageModalBackground src={activeImage.src} />
+          <DialogTitle className="sr-only">{activeImage.alt}</DialogTitle>
+          <p className="sr-only" aria-live="polite">
+            Image {activeIndex + 1} of {images.length}. {TRACKPAD_LABEL}.
+          </p>
+          <Carousel
+            setApi={setApi}
+            opts={{ loop, startIndex: activeIndex, duration: 24 }}
+            data-slot="image-modal-stage"
+            className="relative z-10 size-full"
+            aria-label="Image gallery"
+          >
+            <CarouselContent className="h-full -ml-0">
+              {images.map((image, index) => (
+                <CarouselItem
+                  key={`${image.src}-${index}`}
+                  className="flex h-full items-center justify-center pl-0 p-4"
+                  aria-label={`${index + 1} of ${images.length}`}
+                >
+                  <ImageModalImage {...image} />
+                </CarouselItem>
+              ))}
+            </CarouselContent>
+          </Carousel>
+          <ImageModalDismiss />
+          <ImageModalDownload
+            src={activeImage.downloadSrc ?? activeImage.src}
+            name={activeImage.downloadName}
+          />
+          {images.length > 1 ? (
+            <>
+              <ImageModalControlTooltip label="Previous image" side="right">
+                <Button
+                  type="button"
+                  variant="ghost"
+                  size="lg"
+                  iconOnly
+                  rounded
+                  aria-label="Previous image"
+                  disabled={!loop && !api?.canScrollPrev()}
+                  onClick={() => api?.scrollPrev()}
+                  className={cn(
+                    imageModalControlClassName,
+                    "absolute top-1/2 left-4 z-20 -translate-y-1/2 active:!-translate-y-1/2",
+                  )}
+                >
+                  <IconChevronRightSmall className="rotate-180" aria-hidden />
+                </Button>
+              </ImageModalControlTooltip>
+              <ImageModalControlTooltip label="Next image" side="left">
+                <Button
+                  type="button"
+                  variant="ghost"
+                  size="lg"
+                  iconOnly
+                  rounded
+                  aria-label="Next image"
+                  disabled={!loop && !api?.canScrollNext()}
+                  onClick={() => api?.scrollNext()}
+                  className={cn(
+                    imageModalControlClassName,
+                    "absolute top-1/2 right-4 z-20 -translate-y-1/2 active:!-translate-y-1/2",
+                  )}
+                >
+                  <IconChevronRightSmall aria-hidden />
+                </Button>
+              </ImageModalControlTooltip>
+            </>
+          ) : null}
+          {variant === "caption" && activeImage.caption ? (
+            <ImageModalCaption>{activeImage.caption}</ImageModalCaption>
+          ) : null}
+        </TooltipProvider>
+      </DialogPopup>
+    </DialogPortal>
+  )
+}
+
+export const ImageModalGallery = ({
+  images,
+  children,
+  loop = true,
+  variant = "default",
+  contentClassName,
+  ...props
+}: ImageModalGalleryProps) => {
+  const [activeIndex, setActiveIndex] = useState(0)
+  const safeIndex = images.length
+    ? Math.min(activeIndex, images.length - 1)
+    : 0
+  const setSafeActiveIndex = useCallback(
+    (index: number) => {
+      if (images[index]) setActiveIndex(index)
+    },
+    [images],
+  )
+
+  return (
+    <Dialog {...props}>
+      <ImageModalGalleryContext.Provider
+        value={{
+          images,
+          setActiveIndex: setSafeActiveIndex,
+        }}
+      >
+        {children}
+        {images.length ? (
+          <ImageModalGalleryContent
+            images={images}
+            activeIndex={safeIndex}
+            setActiveIndex={setSafeActiveIndex}
+            loop={loop}
+            variant={variant ?? "default"}
+            className={contentClassName}
+          />
+        ) : null}
+      </ImageModalGalleryContext.Provider>
+    </Dialog>
+  )
+}

package/src/index.ts

@@ -172,6 +172,7 @@ export {
   CommandItem,
   CommandEmpty,
   CommandTitle,
+  CommandMeta,
   CommandDialogTitle,
   type CommandProps,
   type CommandTriggerProps,
@@ -191,6 +192,7 @@ export {
   type CommandItemProps,
   type CommandEmptyProps,
   type CommandTitleProps,
+  type CommandMetaProps,
   type CommandDialogTitleProps,
 } from "./command";
 export {
@@ -873,9 +875,15 @@ export {
   ImageModal,
   ImageModalTrigger,
   ImageModalContent,
+  ImageModalGallery,
+  ImageModalGalleryTrigger,
+  imageModalContentVariants,
   type ImageModalProps,
   type ImageModalTriggerProps,
   type ImageModalContentProps,
+  type ImageModalGalleryProps,
+  type ImageModalGalleryTriggerProps,
+  type ImageModalItem,
 } from "./image-modal";
 export {
   Ticker,
@@ -922,6 +930,7 @@ export {
   CENTRAL_ICON_SIZE,
   withCentralIconDefaults,
   iconGallery,
+  IconArrowDown,
   IconBell,
   IconCalendar1,
   IconChainLink1,