@tinybigui/react 0.21.1 → 0.22.0

package/README.md

@@ -12,7 +12,7 @@ A modern, accessible React component library implementing Google's Material Desi
 
 ## ✅ Status
 
-> **Latest Release: v0.21.1** (2026-06-10)
+> **Latest Release: v0.22.0** (2026-06-10)
 >
 > **29 MD3 components** published to npm with full TypeScript support and WCAG 2.1 AA accessibility.
 >
@@ -159,14 +159,14 @@ See [THEMING.md](./THEMING.md) for the full customization guide.
 
 ### Phase 3: Feedback ✅
 
-| Component     | Status | Description                                                                        |
-| ------------- | ------ | ---------------------------------------------------------------------------------- |
-| `Dialog`      | ✅     | Basic and fullscreen modal dialogs                                                 |
-| `Snackbar`    | ✅     | MD3 slot-based architecture, inverse-surface state layers, spring motion (v0.20.0) |
-| `Menu`        | ✅     | Dropdown, context menu, submenus                                                   |
-| `Progress`    | ✅     | MD3 expressive slot CVA, colorful tokens, wavy shape, thick track (v0.16.0)        |
-| `BottomSheet` | ✅     | MD3 expressive handle, variants-vs-states architecture (v0.11.0)                   |
-| `Tooltip`     | ✅     | Slot-based MD3 styling, reduced-motion guard, rich tooltip token fixes (v0.21.1)   |
+| Component     | Status | Description                                                                         |
+| ------------- | ------ | ----------------------------------------------------------------------------------- |
+| `Dialog`      | ✅     | MD3 expressive motion, hero icon, scroll dividers, reduced-motion support (v0.22.0) |
+| `Snackbar`    | ✅     | MD3 slot-based architecture, inverse-surface state layers, spring motion (v0.20.0)  |
+| `Menu`        | ✅     | Dropdown, context menu, submenus                                                    |
+| `Progress`    | ✅     | MD3 expressive slot CVA, colorful tokens, wavy shape, thick track (v0.16.0)         |
+| `BottomSheet` | ✅     | MD3 expressive handle, variants-vs-states architecture (v0.11.0)                    |
+| `Tooltip`     | ✅     | Slot-based MD3 styling, reduced-motion guard, rich tooltip token fixes (v0.21.1)    |
 
 ### Phase 4: Data Display ✅
 

package/dist/index.cjs

@@ -7721,13 +7721,14 @@ var DialogPanel = ({
   headlineId,
   contentId,
   onClose,
-  onTransitionEnd,
+  onAnimationEnd,
   variant,
   isDismissable,
   wrapperClassName,
   className,
   animationState,
   getAnimationClassName,
+  icon,
   children
 }) => {
   const panelRef = React.useRef(null);
@@ -7750,9 +7751,10 @@ var DialogPanel = ({
     panelRef
   );
   const panelClassName = cn(className, getAnimationClassName?.(animationState));
+  const hasIcon = icon !== void 0 && icon !== null && variant === "basic";
   return (
     // Centering/positioning wrapper — structural only, no ARIA role
-    /* @__PURE__ */ jsxRuntime.jsx("div", { className: wrapperClassName, children: /* @__PURE__ */ jsxRuntime.jsx(
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: wrapperClassName, children: /* @__PURE__ */ jsxRuntime.jsxs(
       "div",
       {
         ...utils.mergeProps(overlayProps, dialogProps),
@@ -7761,8 +7763,12 @@ var DialogPanel = ({
         className: panelClassName,
         "data-animation-state": animationState,
         "data-variant": variant,
-        onTransitionEnd,
-        children
+        "data-with-icon": hasIcon ? "" : void 0,
+        onAnimationEnd,
+        children: [
+          hasIcon && icon,
+          children
+        ]
       }
     ) })
   );
@@ -7775,9 +7781,11 @@ var DialogHeadless = React.forwardRef(
     defaultOpen = false,
     onOpenChange,
     "aria-label": ariaLabel,
+    icon,
     children,
     className,
-    scrimClassName,
+    wrapperClassName,
+    getScrimClassName,
     getAnimationClassName
   }, _ref) {
     const state = reactStately.useOverlayTriggerState({
@@ -7811,7 +7819,7 @@ var DialogHeadless = React.forwardRef(
             closedRef.current = true;
             setAnimationState("exited");
           }
-        }, 150);
+        }, 250);
       }
     }, [isOpen, animationState]);
     React.useEffect(
@@ -7822,16 +7830,20 @@ var DialogHeadless = React.forwardRef(
       },
       []
     );
-    const handleTransitionEnd = React.useCallback(() => {
-      if (animationState === "exiting" && !closedRef.current) {
-        if (exitFallbackRef.current !== null) {
-          clearTimeout(exitFallbackRef.current);
-          exitFallbackRef.current = null;
+    const handleAnimationEnd = React.useCallback(
+      (e) => {
+        if (e.target !== e.currentTarget) return;
+        if (animationState === "exiting" && !closedRef.current) {
+          if (exitFallbackRef.current !== null) {
+            clearTimeout(exitFallbackRef.current);
+            exitFallbackRef.current = null;
+          }
+          closedRef.current = true;
+          setAnimationState("exited");
         }
-        closedRef.current = true;
-        setAnimationState("exited");
-      }
-    }, [animationState]);
+      },
+      [animationState]
+    );
     const baseId = React.useId();
     const headlineId = `${baseId}-dialog-headline`;
     const contentId = `${baseId}-dialog-content`;
@@ -7846,6 +7858,8 @@ var DialogHeadless = React.forwardRef(
         close();
       }
     }, [variant, close]);
+    const resolvedWrapperClass = wrapperClassName ?? (variant === "basic" ? "fixed inset-0 z-50 flex items-center justify-center px-4" : "fixed inset-0 z-50");
+    const resolvedScrimClass = getScrimClassName?.(animationState) ?? "fixed inset-0 z-40 bg-scrim/32";
     if (!isOpen && animationState === "exited") {
       return null;
     }
@@ -7854,7 +7868,7 @@ var DialogHeadless = React.forwardRef(
         "div",
         {
           "data-testid": "dialog-scrim",
-          className: scrimClassName,
+          className: resolvedScrimClass,
           onClick: handleScrimClick,
           "aria-hidden": "true"
         }
@@ -7866,13 +7880,14 @@ var DialogHeadless = React.forwardRef(
           headlineId,
           contentId,
           onClose: close,
-          onTransitionEnd: handleTransitionEnd,
+          onAnimationEnd: handleAnimationEnd,
           variant,
           isDismissable: variant === "basic",
-          wrapperClassName: variant === "basic" ? "fixed inset-0 z-50 flex items-center justify-center px-4" : "fixed inset-0 z-50",
+          wrapperClassName: resolvedWrapperClass,
           className,
           animationState,
           getAnimationClassName,
+          icon,
           children
         }
       ) })
@@ -7882,16 +7897,28 @@ var DialogHeadless = React.forwardRef(
   }
 );
 DialogHeadless.displayName = "DialogHeadless";
-var dialogScrimVariants = classVarianceAuthority.cva([
-  "fixed",
-  "inset-0",
-  "z-40",
-  "bg-scrim",
-  "opacity-32",
-  "transition-opacity",
-  "duration-medium2",
-  "ease-standard"
-]);
+var dialogScrimVariants = classVarianceAuthority.cva(
+  [
+    "fixed",
+    "inset-0",
+    "z-40",
+    // MD3 scrim: bg-scrim at 32% opacity — always set so instant-show works in reduced-motion
+    "bg-scrim/32"
+  ],
+  {
+    variants: {
+      animationState: {
+        entering: ["opacity-0"],
+        visible: ["animate-md-fade-in"],
+        exiting: ["animate-md-fade-out"],
+        exited: ["opacity-0", "pointer-events-none"]
+      }
+    },
+    defaultVariants: {
+      animationState: "entering"
+    }
+  }
+);
 var dialogPanelVariants = classVarianceAuthority.cva(
   [
     // Stacking above scrim
@@ -7901,9 +7928,10 @@ var dialogPanelVariants = classVarianceAuthority.cva(
     // Flex column layout for slots
     "flex",
     "flex-col",
-    // Transition for animation state changes
-    "transition-[opacity,transform]",
-    "will-change-[opacity,transform]"
+    // Compositor hint for keyframe animation
+    "will-change-[opacity,transform]",
+    // group scope — lets child slots consume data-with-icon via group-data-[with-icon]/dialog:
+    "group/dialog"
   ],
   {
     variants: {
@@ -7917,11 +7945,11 @@ var dialogPanelVariants = classVarianceAuthority.cva(
           "min-w-70",
           "max-w-dialog-max",
           "w-full",
-          // Internal spacing
+          // Internal spacing: 24dp padding, headline mb-4, content mb-6, actions pt-3
           "pt-6",
           "pb-3",
           "px-6",
-          // Positioned in viewport center
+          // Positioning (centering wrapper handles the viewport centering)
           "relative"
         ],
         fullscreen: [
@@ -7932,7 +7960,6 @@ var dialogPanelVariants = classVarianceAuthority.cva(
           "rounded-none",
           // No elevation shadow on fullscreen
           "shadow-none",
-          // Positioned to fill portal
           "relative"
         ]
       }
@@ -7942,7 +7969,7 @@ var dialogPanelVariants = classVarianceAuthority.cva(
     }
   }
 );
-classVarianceAuthority.cva([], {
+var dialogWrapperVariants = classVarianceAuthority.cva([], {
   variants: {
     variant: {
       basic: ["fixed", "inset-0", "z-50", "flex", "items-center", "justify-center", "px-4"],
@@ -7956,9 +7983,13 @@ classVarianceAuthority.cva([], {
 var dialogAnimationVariants = classVarianceAuthority.cva("", {
   variants: {
     animationState: {
+      // initial mount frame before the animation starts — rendered invisible
       entering: [],
+      // entry animation active
       visible: [],
+      // exit animation active
       exiting: [],
+      // fully dismissed; portal gate will remove the element
       exited: []
     },
     variant: {
@@ -7967,53 +7998,55 @@ var dialogAnimationVariants = classVarianceAuthority.cva("", {
     }
   },
   compoundVariants: [
-    // Basic: entering — start scaled down + transparent
+    // ── Basic ────────────────────────────────────────────────────────────────
+    // entering: start invisible (animate-md-scale-in keyframe starts from scale(0.85)/opacity:0)
     {
       animationState: "entering",
       variant: "basic",
-      className: ["scale-90", "opacity-0"]
+      className: ["opacity-0"]
     },
-    // Basic: visible — scale to full + fade in
+    // visible: composite scale-in keyframe (expressive-fast-spatial 350ms)
     {
       animationState: "visible",
       variant: "basic",
-      className: ["scale-100", "opacity-100", "duration-medium4", "ease-emphasized-decelerate"]
+      className: ["animate-md-scale-in"]
     },
-    // Basic: exiting — fade out (scale stays at 1)
+    // exiting: composite scale-out keyframe (emphasized-accelerate 200ms)
     {
       animationState: "exiting",
       variant: "basic",
-      className: ["scale-100", "opacity-0", "duration-short2", "ease-emphasized-accelerate"]
+      className: ["animate-md-scale-out"]
     },
-    // Basic: exited — fully transparent
+    // exited: keep hidden until portal gate removes it
     {
       animationState: "exited",
       variant: "basic",
-      className: ["scale-100", "opacity-0"]
+      className: ["opacity-0", "pointer-events-none"]
     },
-    // Fullscreen: entering — start below viewport + transparent
+    // ── Fullscreen ───────────────────────────────────────────────────────────
+    // entering: start off-screen below (slide-in-bottom starts from translateY(100%)/opacity:0)
     {
       animationState: "entering",
       variant: "fullscreen",
-      className: ["translate-y-full", "opacity-0"]
+      className: ["opacity-0"]
     },
-    // Fullscreen: visible — slide up + fade in
+    // visible: composite slide-in-bottom keyframe (standard-default-spatial 500ms)
     {
       animationState: "visible",
       variant: "fullscreen",
-      className: ["translate-y-0", "opacity-100", "duration-medium4", "ease-emphasized-decelerate"]
+      className: ["animate-md-slide-in-bottom"]
     },
-    // Fullscreen: exiting — slide down + fade out
+    // exiting: composite slide-out-bottom keyframe (emphasized-accelerate 200ms)
     {
       animationState: "exiting",
       variant: "fullscreen",
-      className: ["translate-y-full", "opacity-0", "duration-short2", "ease-emphasized-accelerate"]
+      className: ["animate-md-slide-out-bottom"]
     },
-    // Fullscreen: exited — fully off-screen
+    // exited: keep hidden until portal gate removes it
     {
       animationState: "exited",
       variant: "fullscreen",
-      className: ["translate-y-full", "opacity-0"]
+      className: ["opacity-0", "pointer-events-none"]
     }
   ],
   defaultVariants: {
@@ -8021,10 +8054,26 @@ var dialogAnimationVariants = classVarianceAuthority.cva("", {
     variant: "basic"
   }
 });
+classVarianceAuthority.cva([
+  // Center the icon in the panel
+  "flex",
+  "items-center",
+  "justify-center",
+  // Bottom margin separating icon from headline
+  "mb-4",
+  // MD3 spec: icon color = secondary
+  "text-secondary",
+  // 24dp icon size (children — typically an SVG — should be 24×24)
+  "size-6"
+]);
 var dialogHeadlineVariants = classVarianceAuthority.cva(["text-headline-small", "text-on-surface"], {
   variants: {
     variant: {
-      basic: ["mb-4"],
+      basic: [
+        "mb-4",
+        // Center headline text when hero icon is present
+        "group-data-[with-icon]/dialog:text-center"
+      ],
       fullscreen: [
         // Top app bar row in fullscreen: flex, items-center, gap
         "flex",
@@ -8049,7 +8098,19 @@ var dialogHeadlineTitleVariants = classVarianceAuthority.cva([
   "truncate"
 ]);
 var dialogContentVariants = classVarianceAuthority.cva(
-  ["text-body-medium", "text-on-surface-variant", "overflow-y-auto", "flex-1"],
+  [
+    "text-body-medium",
+    "text-on-surface-variant",
+    "overflow-y-auto",
+    "flex-1",
+    // Center supporting text when hero icon is present
+    "group-data-[with-icon]/dialog:text-center",
+    // Scroll dividers — activated by DialogContent's scroll handler
+    "data-[scroll-divider-top]:border-t",
+    "data-[scroll-divider-top]:border-outline-variant",
+    "data-[scroll-divider-bottom]:border-b",
+    "data-[scroll-divider-bottom]:border-outline-variant"
+  ],
   {
     variants: {
       variant: {
@@ -8076,11 +8137,31 @@ var Dialog = React.forwardRef(function Dialog2({
   defaultOpen = false,
   onOpenChange,
   "aria-label": ariaLabel,
+  icon,
   children,
   className
 }, _ref) {
-  const panelClassName = cn(dialogPanelVariants({ variant }), className);
-  const scrimClass = dialogScrimVariants();
+  const reducedMotion = useReducedMotion();
+  const panelClassName = cn(
+    dialogPanelVariants({ variant }),
+    reducedMotion && "transition-none",
+    className
+  );
+  const wrapperClassName = dialogWrapperVariants({ variant });
+  const getScrimClassName = React.useCallback(
+    (state) => {
+      if (reducedMotion) return "fixed inset-0 z-40 bg-scrim/32";
+      return dialogScrimVariants({ animationState: state });
+    },
+    [reducedMotion]
+  );
+  const getAnimationClassName = React.useCallback(
+    (state) => {
+      if (reducedMotion) return "";
+      return dialogAnimationVariants({ animationState: state, variant });
+    },
+    [reducedMotion, variant]
+  );
   return /* @__PURE__ */ jsxRuntime.jsx(
     DialogHeadless,
     {
@@ -8089,9 +8170,11 @@ var Dialog = React.forwardRef(function Dialog2({
       ...defaultOpen !== void 0 ? { defaultOpen } : {},
       ...onOpenChange !== void 0 ? { onOpenChange } : {},
       ...ariaLabel ? { "aria-label": ariaLabel } : {},
+      ...icon !== void 0 ? { icon } : {},
       className: panelClassName,
-      scrimClassName: scrimClass,
-      getAnimationClassName: (state) => dialogAnimationVariants({ animationState: state, variant }),
+      wrapperClassName,
+      getScrimClassName,
+      getAnimationClassName,
       children
     }
   );
@@ -8102,7 +8185,7 @@ var DialogHeadline = React.forwardRef(
     const { headlineId, variant } = useDialogContext();
     if (variant === "fullscreen") {
       return (
-        // Top app bar row for fullscreen variant
+        // Top app bar row for fullscreen variant — always has border-b border-outline-variant
         /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cn(dialogHeadlineVariants({ variant: "fullscreen" }), className), children: [
           closeButton,
           /* @__PURE__ */ jsxRuntime.jsx("h2", { id: headlineId, className: dialogHeadlineTitleVariants(), children }),
@@ -8110,21 +8193,72 @@ var DialogHeadline = React.forwardRef(
         ] })
       );
     }
-    return /* @__PURE__ */ jsxRuntime.jsx(
-      "h2",
-      {
-        ref,
-        id: headlineId,
-        className: cn(dialogHeadlineVariants({ variant: "basic" }), className),
-        children
-      }
+    return (
+      // Basic variant: text-headline-small, text-on-surface, mb-4
+      // group-data-[with-icon]/dialog:text-center is applied via the CVA base classes
+      // when the parent panel root has data-with-icon set by DialogHeadless.
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "h2",
+        {
+          ref,
+          id: headlineId,
+          className: cn(dialogHeadlineVariants({ variant: "basic" }), className),
+          children
+        }
+      )
     );
   }
 );
 DialogHeadline.displayName = "DialogHeadline";
-var DialogContent = React.forwardRef(function DialogContent2({ children, className }, ref) {
+var DialogContent = React.forwardRef(function DialogContent2({ children, className }, forwardedRef) {
   const { contentId, variant } = useDialogContext();
-  return /* @__PURE__ */ jsxRuntime.jsx("div", { ref, id: contentId, className: cn(dialogContentVariants({ variant }), className), children });
+  const internalRef = React.useRef(null);
+  const setRef = React.useCallback(
+    (node) => {
+      internalRef.current = node;
+      if (typeof forwardedRef === "function") {
+        forwardedRef(node);
+      } else if (forwardedRef !== null && forwardedRef !== void 0) {
+        forwardedRef.current = node;
+      }
+    },
+    [forwardedRef]
+  );
+  const updateDividers = React.useCallback(() => {
+    const el = internalRef.current;
+    if (!el) return;
+    const isScrollable = el.scrollHeight > el.clientHeight;
+    if (!isScrollable) {
+      el.removeAttribute("data-scroll-divider-top");
+      el.removeAttribute("data-scroll-divider-bottom");
+      return;
+    }
+    const scrolledFromTop = el.scrollTop > 1;
+    const scrolledToBottom = el.scrollTop + el.clientHeight >= el.scrollHeight - 1;
+    if (scrolledFromTop) {
+      el.setAttribute("data-scroll-divider-top", "");
+    } else {
+      el.removeAttribute("data-scroll-divider-top");
+    }
+    if (!scrolledToBottom) {
+      el.setAttribute("data-scroll-divider-bottom", "");
+    } else {
+      el.removeAttribute("data-scroll-divider-bottom");
+    }
+  }, []);
+  React.useEffect(() => {
+    const el = internalRef.current;
+    if (!el) return;
+    updateDividers();
+    el.addEventListener("scroll", updateDividers, { passive: true });
+    const observer = new ResizeObserver(updateDividers);
+    observer.observe(el);
+    return () => {
+      el.removeEventListener("scroll", updateDividers);
+      observer.disconnect();
+    };
+  }, [updateDividers]);
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { ref: setRef, id: contentId, className: cn(dialogContentVariants({ variant }), className), children });
 });
 DialogContent.displayName = "DialogContent";
 var DialogActions = React.forwardRef(function DialogActions2({ children, className }, ref) {