@djangocfg/ui-core 2.1.428 → 2.1.429

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/ui-core",
-  "version": "2.1.428",
+  "version": "2.1.429",
   "description": "Pure React UI component library without Next.js dependencies - for Electron, Vite, CRA apps",
   "keywords": [
     "ui-components",
@@ -106,7 +106,7 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/i18n": "^2.1.428",
+    "@djangocfg/i18n": "^2.1.429",
     "consola": "^3.4.2",
     "lucide-react": "^0.545.0",
     "moment": "^2.30.1",
@@ -180,8 +180,8 @@
     "@chenglou/pretext": "*"
   },
   "devDependencies": {
-    "@djangocfg/i18n": "^2.1.428",
-    "@djangocfg/typescript-config": "^2.1.428",
+    "@djangocfg/i18n": "^2.1.429",
+    "@djangocfg/typescript-config": "^2.1.429",
     "@types/node": "^25.2.3",
     "@types/react": "^19.2.15",
     "@types/react-dom": "^19.2.3",

package/src/components/forms/button/index.tsx

@@ -119,6 +119,14 @@ Button.displayName = "Button"
  * cmd-click, and the Next.js adapter (if mounted) all work out of the box.
  * Drop-in replacement for the previous native-`<a>` version.
  */
+/**
+ * ButtonLink — anchor styled as a Button.
+ *
+ * **Disabled / loading.** An `<a>` has no native `disabled`, so we emulate it
+ * the shadcn-recommended way: `aria-disabled` + `tabIndex={-1}` +
+ * `pointer-events-none opacity-50`, and we cancel the click. `loading` adds the
+ * same inert state plus a spinner — keeping parity with `<Button>`.
+ */
 export interface ButtonLinkProps
   extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'>,
     VariantProps<typeof buttonVariants> {
@@ -129,21 +137,46 @@ export interface ButtonLinkProps
   scroll?: boolean
   /** Hint for the host framework's prefetcher (Next.js). */
   prefetch?: boolean | null
+  /** Inert + dimmed; click is cancelled and it's removed from tab order. */
+  disabled?: boolean
+  /** Inert + dimmed + spinner (e.g. while an action resolves). */
+  loading?: boolean
 }
 
 const ButtonLink = React.forwardRef<HTMLAnchorElement, ButtonLinkProps>(
-  ({ className, variant, size, elevated, href, replace, scroll, prefetch, children, ...props }, ref) => {
+  (
+    { className, variant, size, elevated, href, replace, scroll, prefetch, disabled = false, loading = false, onClick, children, ...props },
+    ref,
+  ) => {
+    // `<a>` can't be natively disabled — emulate it (aria + tab-order + no
+    // pointer events) and hard-cancel the click so navigation can't fire.
+    const inert = disabled || loading
+    const handleClick = (e: React.MouseEvent<HTMLAnchorElement>) => {
+      if (inert) {
+        e.preventDefault()
+        return
+      }
+      onClick?.(e)
+    }
+
     return (
       <Link
         href={href}
         replace={replace}
         scroll={scroll}
         prefetch={prefetch}
-        className={cn(buttonVariants({ variant, size, elevated, className }))}
+        className={cn(
+          buttonVariants({ variant, size, elevated, className }),
+          inert && 'pointer-events-none opacity-50',
+        )}
         ref={ref}
+        onClick={handleClick}
+        aria-disabled={inert || undefined}
+        tabIndex={inert ? -1 : undefined}
         {...props}
       >
-        {children}
+        {loading && <Loader2 className="size-4 animate-spin" />}
+        {loading ? filterIcons(children) : children}
       </Link>
     )
   }