@particle-academy/react-fancy 4.3.0 → 4.4.0

package/dist/index.d.cts

@@ -59,6 +59,16 @@ interface ButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "col
     disabled?: boolean;
     /** Render as anchor tag */
     href?: string;
+    /**
+     * Collapse to icon-only when squeezed — injects the minimal Tailwind classes
+     * (`sr-only sm:not-sr-only`) onto the label so it stays screen-reader
+     * accessible but visually hidden on small screens. The label is also directly
+     * targetable via `data-react-fancy-button-label` for a custom breakpoint, e.g.
+     * `className="[&_[data-react-fancy-button-label]]:hidden md:[&_[data-react-fancy-button-label]]:inline"`.
+     */
+    responsive?: boolean;
+    /** Extra classes for the label wrapper — alignment, responsive hiding, etc. */
+    labelClassName?: string;
 }
 /**
  * @deprecated Renamed to {@link ButtonProps}. `ActionProps` remains as an alias

package/dist/index.d.ts

@@ -59,6 +59,16 @@ interface ButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "col
     disabled?: boolean;
     /** Render as anchor tag */
     href?: string;
+    /**
+     * Collapse to icon-only when squeezed — injects the minimal Tailwind classes
+     * (`sr-only sm:not-sr-only`) onto the label so it stays screen-reader
+     * accessible but visually hidden on small screens. The label is also directly
+     * targetable via `data-react-fancy-button-label` for a custom breakpoint, e.g.
+     * `className="[&_[data-react-fancy-button-label]]:hidden md:[&_[data-react-fancy-button-label]]:inline"`.
+     */
+    responsive?: boolean;
+    /** Extra classes for the label wrapper — alignment, responsive hiding, etc. */
+    labelClassName?: string;
 }
 /**
  * @deprecated Renamed to {@link ButtonProps}. `ActionProps` remains as an alias

package/dist/index.js

@@ -2375,6 +2375,8 @@ var Button = forwardRef(
     loading = false,
     disabled,
     href,
+    responsive,
+    labelClassName,
     ...props
   }, ref) => {
     const isCircle = variant === "circle";
@@ -2486,7 +2488,10 @@ var Button = forwardRef(
     const trailingAlert = renderAlertIcon(true);
     if (trailingAlert) trailingElements.push(trailingAlert);
     const classes = cn(
-      "inline-flex items-center justify-center font-medium transition-all duration-200",
+      // `text-left` overrides the UA <button> center default so a wrapped,
+      // width-constrained multi-word label stacks left-aligned. Overridable —
+      // twMerge lets a `text-center` / `text-right` in `className` win.
+      "inline-flex items-center justify-center text-left font-medium transition-all duration-200",
       "focus:outline-none focus:ring-2 focus:ring-offset-1",
       "disabled:opacity-50 disabled:cursor-not-allowed",
       isCircle ? "rounded-full" : "rounded-lg",
@@ -2508,7 +2513,22 @@ var Button = forwardRef(
       }
     ) : icon ? /* @__PURE__ */ jsx(Icon, { name: icon, size: iconSizeMap[size] }) : children }) : /* @__PURE__ */ jsxs(Fragment, { children: [
       leadingElements,
-      children != null && /* @__PURE__ */ jsx("span", { children }),
+      children != null && /* @__PURE__ */ jsx(
+        "span",
+        {
+          "data-react-fancy-button-label": "",
+          className: cn(
+            // min-w-0 lets the label shrink + wrap inside the flex row instead
+            // of overflowing and shoving the icon out of place.
+            "min-w-0",
+            // `responsive` collapses to icon-only when squeezed, while keeping
+            // the label readable to screen readers.
+            responsive && "sr-only sm:not-sr-only",
+            labelClassName
+          ),
+          children
+        }
+      ),
       trailingElements
     ] });
     const safeHref = sanitizeHref(href);