@axzydev/axzy_ui_system 1.5.2 → 1.5.3

package/package.json

@@ -4,7 +4,7 @@
   "packageManager": "pnpm@10.34.0",
   "private": false,
   "license": "MIT",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "type": "module",
   "sideEffects": [
     "*.css"

package/src/components/atoms/button/button.props.ts

@@ -7,15 +7,15 @@ export interface ITButtonProps {
   label?: string
   /** Custom content to render inside the button. Takes precedence over `label`. */
   children?: React.ReactNode;
-  /** Icon element rendered before the label. */
+  /** Icon element rendered before the label. With `variant="icon-only"` and no `label`/`children` it becomes the only content and is centered in the square button. */
   icon?: React.ReactNode;
   /** Click handler for the button. */
   onClick?: () => void;
   /** Color theme key. Values come from the semantic color palette (e.g. `"primary"`, `"secondary"`, `"success"`, `"danger"`, `"warning"`, `"info"`, `"purple"`, `"error"`, `"gray"`). @default "primary" */
   color?: ColorsTypes;
-  /** Button size. Valid values: `"sm"`, `"md"`, `"lg"`. @default "md" */
+  /** Button size. Valid values: `"sm"`, `"md"`, `"lg"`. In `variant="icon-only"` it also scales the square padding (`buttonIconPadding`: `sm` 0.5rem, `md` 0.625rem, `lg` 0.75rem). @default "md" */
   size?: SizesTypes;
-  /** Button visual style. Valid values: `"filled"`, `"outlined"`, `"raised"`, `"rounded"`, `"text"`, `"raised-text"`, `"icon-only"`, `"link"`. @default "filled" */
+  /** Button visual style. Valid values: `"filled"`, `"outlined"`, `"raised"`, `"rounded"`, `"text"`, `"raised-text"`, `"icon-only"`, `"link"`. `"icon-only"` renders a centered square icon button; combine it with `icon` and `ariaLabel`. @default "filled" */
   variant?: keyof typeof buttonVariants;
   /** Disables the button interaction and applies reduced opacity. @default false */
   disabled?: boolean;

package/src/components/atoms/button/button.tsx

@@ -1,4 +1,6 @@
 import {
+  buttonIconPadding,
+  buttonIconSizes,
   buttonSizes,
   buttonVariants,
 } from "@/types/button.types";
@@ -35,6 +37,16 @@ export default function ITButton({
 }: ITButtonProps) {
   const [isHovered, setIsHovered] = useState(false);
   const [isFocused, setIsFocused] = useState(false);
+
+  /** La variante `icon-only` siempre es un cuadrado con padding simétrico. */
+  const isIconOnly = variant === "icon-only";
+
+  /**
+   * Contenido "solo icono": hay `icon` y no hay `children`.
+   * En ese caso NO se envuelve el icono en el wrapper con `gap-1.5` ni en un `ITText` vacío,
+   * que lo desplazaban a la izquierda del centro.
+   */
+  const isIconOnlyContent = isIconOnly && Boolean(icon) && !children;
   
   // Get specific button config from theme
   const themeBtn = theme.button as any;
@@ -64,8 +76,11 @@ export default function ITButton({
       style.borderRadius = "9999px";
     }
 
-    if (variant === "icon-only") {
-      style.padding = "0.5rem"; // Square padding override
+    if (isIconOnly) {
+      // Padding simétrico explícito: con `aspect-square` define un cuadrado exacto
+      // y evita que las utilidades `px-*`/`py-*` de `buttonSizes` desalineen el icono.
+      style.padding = buttonIconPadding[size] ?? "0.5rem";
+      style.lineHeight = 1;
     }
 
     if (isSolid) {
@@ -103,7 +118,7 @@ export default function ITButton({
         // Apply variant base styles (border, shadow, rounded-full)
         buttonVariants[variant || "filled"],
         // Apply size classes (padding/font-size)
-        buttonSizes[size],
+        isIconOnly ? buttonIconSizes[size] : buttonSizes[size],
         className,
         { "opacity-50 cursor-not-allowed": disabled }
       )}
@@ -118,10 +133,15 @@ export default function ITButton({
       title={title || ariaLabel || label}
     >
       {children || (
-        <span className={clsx("inline-flex items-center gap-1.5 font-semibold", { "opacity-50": disabled })}>
-          {icon && <span className="flex-shrink-0">{icon}</span>}
-          <ITText as="span">{label}</ITText>
-        </span>
+        isIconOnlyContent ? (
+          // Icono solo: sin wrapper con `gap` ni `ITText` vacío, que lo desplazaban a la izquierda.
+          <span className="inline-flex items-center justify-center leading-none">{icon}</span>
+        ) : (
+          <span className={clsx("inline-flex items-center gap-1.5 font-semibold", { "opacity-50": disabled })}>
+            {icon && <span className="flex-shrink-0">{icon}</span>}
+            <ITText as="span">{label}</ITText>
+          </span>
+        )
       )}
     </button>
   );

package/src/sandbox/i18n.ts

@@ -772,6 +772,7 @@ export const sandboxMessages: ITMessagesByLocale = {
     "showcase.forms.clicksRegistered": "Clicks registrados: {count}",
     "showcase.forms.withIcon": "Con Icono",
     "showcase.forms.galleryWithIcon": "Con Icono",
+    "showcase.forms.galleryIconOnly": "Solo Icono (centrado)",
     "showcase.forms.galleryVariants": "Variantes",
     "showcase.forms.gallerySemanticColors": "Colores Semánticos",
     "showcase.forms.sync": "Sincronizar",
@@ -1714,6 +1715,7 @@ export const sandboxMessages: ITMessagesByLocale = {
     "showcase.forms.clicksRegistered": "Clicks registered: {count}",
     "showcase.forms.withIcon": "With icon",
     "showcase.forms.galleryWithIcon": "With icon",
+    "showcase.forms.galleryIconOnly": "Icon only (centered)",
     "showcase.forms.galleryVariants": "Variants",
     "showcase.forms.gallerySemanticColors": "Semantic colors",
     "showcase.forms.sync": "Sync",

package/src/showcases/FormShowcases.tsx

@@ -158,6 +158,14 @@ export const ButtonShowcase = () => {
               <ITButton label={t("showcase.forms.sync")} icon={<FaSync />} variant="text" />
             </div>
           </div>
+          <div>
+            <h3 className="mb-3 w-fit border-l-2 border-primary-700 pl-2.5 font-mono text-[11px] font-medium uppercase tracking-[0.14em] text-slate-700 dark:border-primary-500 dark:text-slate-200">{t("showcase.forms.galleryIconOnly")}</h3>
+            <div className="flex flex-wrap items-center gap-3">
+              <ITButton variant="icon-only" size="sm" color="primary" icon={<FaEdit />} ariaLabel={t("showcase.common.edit")} />
+              <ITButton variant="icon-only" size="md" color="success" icon={<FaSave />} ariaLabel={t("showcase.common.save")} />
+              <ITButton variant="icon-only" size="lg" color="danger" icon={<FaTrash />} ariaLabel={t("showcase.common.delete")} />
+            </div>
+          </div>
           <div>
             <h3 className="mb-3 w-fit border-l-2 border-primary-700 pl-2.5 font-mono text-[11px] font-medium uppercase tracking-[0.14em] text-slate-700 dark:border-primary-500 dark:text-slate-200">{t("showcase.forms.galleryVariants")}</h3>
             <div className="flex flex-wrap gap-3">
@@ -210,6 +218,7 @@ export const ButtonShowcase = () => {
         notes: [
           "Con children no se renderizan label ni icon.",
           'Usa variant="icon-only" junto a ariaLabel cuando el botón no tenga texto visible.',
+          'Con variant="icon-only" + icon (sin label) el botón es cuadrado y el icono queda centrado; el tamaño del cuadrado sale de buttonIconPadding (sm 0.5rem, md 0.625rem, lg 0.75rem).',
         ],
       }}
     />

package/src/types/button.types.ts

@@ -5,7 +5,8 @@ export const buttonVariants: Record<string, string> = {
   rounded: "border-transparent shadow-sm rounded-full",
   text: "bg-transparent border-transparent shadow-none hover:bg-black/5 dark:hover:bg-white/10",
   "raised-text": "bg-white border border-gray-200 shadow-sm hover:shadow-md",
-  "icon-only": "p-2 aspect-square flex items-center justify-center border-transparent shadow-sm",
+  // No lleva utilidades de padding: el cuadrado lo define `buttonIconPadding` por tamaño.
+  "icon-only": "aspect-square flex items-center justify-center border-transparent shadow-sm",
   link: "bg-transparent border-transparent shadow-none hover:underline px-0",
 };
 
@@ -14,3 +15,20 @@ export const buttonSizes: Record<string, string> = {
   md: "text-[13px] px-3.5 py-1.5",
   lg: "text-sm px-4 py-2",
 };
+
+/**
+ * Tipografía de `icon-only`: solo el tamaño de fuente, sin padding horizontal/vertical,
+ * para que el padding simétrico de `buttonIconPadding` no compita con `buttonSizes`.
+ */
+export const buttonIconSizes: Record<string, string> = {
+  sm: "text-xs",
+  md: "text-[13px]",
+  lg: "text-sm",
+};
+
+/** Padding simétrico (px) del botón `icon-only` por tamaño; define el cuadrado con `aspect-square`. */
+export const buttonIconPadding: Record<string, string> = {
+  sm: "0.5rem",
+  md: "0.625rem",
+  lg: "0.75rem",
+};