From b55d2d6402288a26b6f8be1e5a307d69b3ad2d75 Mon Sep 17 00:00:00 2001
From: Jamie Henson <jamie.henson@ably.com>
Date: Wed, 10 Jul 2024 17:30:29 +0100
Subject: [PATCH] chore: add means to style links as buttons with disabled
 state, port button docs to story

---
 package.json                                  |   2 +-
 .../styles/Button.stories.tsx}                | 109 ++++++++++++------
 src/core/styles/buttons.css                   |  15 +++
 tailwind.config.js                            |   2 +-
 4 files changed, 92 insertions(+), 36 deletions(-)
 rename src/{pages/Buttons.mdx => core/styles/Button.stories.tsx} (67%)

diff --git a/package.json b/package.json
index 28105b8b5..d7096ff63 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ably/ui",
-  "version": "14.1.3",
+  "version": "14.1.4",
   "description": "Home of the Ably design system library ([design.ably.com](https://design.ably.com)). It provides a showcase, development/test environment and a publishing pipeline for different distributables.",
   "repository": {
     "type": "git",
diff --git a/src/pages/Buttons.mdx b/src/core/styles/Button.stories.tsx
similarity index 67%
rename from src/pages/Buttons.mdx
rename to src/core/styles/Button.stories.tsx
index b79d621b7..5f59b499a 100644
--- a/src/pages/Buttons.mdx
+++ b/src/core/styles/Button.stories.tsx
@@ -1,16 +1,13 @@
-import { Meta, Unstyled } from "@storybook/blocks";
-import Icon from "../core/Icon";
+import React from "react";
+import Icon from "../Icon";
 
-<Meta title="Brand/Buttons" />
+export default {
+  title: "CSS/Button",
+};
 
-<Unstyled>
-  <h2 className="ui-text-h1 mb-32">Buttons</h2>
-  <div className="flex flex-wrap">
-    <p className="ui-text-p1 mb-32">Different size buttons can be achieved by using padding and text utilities, see
-      examples below.</p>
-
-    <div className="p-16 mb-16 mr-16 border rounded grid justify-items-start auto-rows-min gap-16">
-      <h3 className="ui-text-h3">Standard</h3>
+export const Standard = {
+  render: () => (
+    <div className="flex flex-col gap-16 max-w-[300px]">
       <button type="button" className="ui-btn">
         Primary button
       </button>
@@ -30,9 +27,12 @@ import Icon from "../core/Icon";
         Unavailable secondary button
       </button>
     </div>
+  ),
+};
 
-    <div className="p-16 mb-16 mr-16 border rounded grid justify-items-start auto-rows-min gap-16 bg-cool-black">
-      <h3 className="ui-text-h3 text-white">Inverted</h3>
+export const Inverted = {
+  render: () => (
+    <div className="flex flex-col gap-16 max-w-[300px]">
       <button type="button" className="ui-btn-invert">
         Primary button
       </button>
@@ -46,9 +46,12 @@ import Icon from "../core/Icon";
         Unavailable secondary button
       </button>
     </div>
+  ),
+};
 
-    <div className="p-16 mb-16 mr-16 border rounded grid justify-items-start auto-rows-min gap-16">
-      <h3 className="ui-text-h3">With icons</h3>
+export const WithIcons = {
+  render: () => (
+    <div className="flex flex-col gap-16 max-w-[300px]">
       <button type="button" className="ui-btn">
         <Icon name="icon-gui-search" size="1rem" additionalCSS="ui-btn-icon" />
         Primary button with icon
@@ -74,28 +77,58 @@ import Icon from "../core/Icon";
         Unavailable secondary button with icon
       </button>
     </div>
+  ),
+};
 
-  </div>
+export const LinkStyledAsButton = {
+  render: () => (
+    <div className="flex flex-col gap-16 max-w-[300px]">
+      <a href="#" role="button" className="ui-btn">
+        Link
+      </a>
+      <a href="#" role="button" className="ui-btn ui-btn-disabled">
+        Disabled link
+      </a>
+    </div>
+  ),
+};
 
-  <div className="flex flex-wrap">
-    <div className="p-16 mb-16 mr-16 border rounded grid justify-items-start auto-rows-min gap-16">
-      <h3 className="ui-text-h3">Extra small</h3>
-      <button type="button" className="ui-btn p-btn-xsmall text-btn4">Primary button</button>
+export const ExtraSmall = {
+  render: () => (
+    <div className="flex flex-col gap-16 max-w-[300px]">
+      <button type="button" className="ui-btn p-btn-xsmall text-btn4">
+        Primary button
+      </button>
       <button type="button" className="ui-btn p-btn-xsmall text-btn4">
-        <Icon name="icon-gui-search" size="1rem" additionalCSS="ui-btn-icon-xsmall" />
+        <Icon
+          name="icon-gui-search"
+          size="1rem"
+          additionalCSS="ui-btn-icon-xsmall"
+        />
         Primary button with icon
       </button>
-      <button type="button" className="ui-btn-alt p-btn-xsmall text-btn4">Primary button alternative</button>
-      <button type="button" className="ui-btn-secondary p-btn-xsmall text-btn4">Secondary button</button>
+      <button type="button" className="ui-btn-alt p-btn-xsmall text-btn4">
+        Primary button alternative
+      </button>
+      <button type="button" className="ui-btn-secondary p-btn-xsmall text-btn4">
+        Secondary button
+      </button>
     </div>
+  ),
+};
 
-    <div className="p-16 mb-16 mr-16 border rounded grid justify-items-start auto-rows-min gap-16">
-      <h3 className="ui-text-h3">Small</h3>
+export const Small = {
+  render: () => (
+    <div className="flex flex-col gap-16 max-w-[300px]">
       <button type="button" className="ui-btn p-btn-small text-btn3">
         Primary button
       </button>
       <button type="button" className="ui-btn p-btn-small text-btn3">
-        <Icon name="icon-gui-search" size="1rem" additionalCSS="ui-btn-icon-small" />
+        <Icon
+          name="icon-gui-search"
+          size="1rem"
+          additionalCSS="ui-btn-icon-small"
+        />
         Primary button with icon
       </button>
       <button type="button" className="ui-btn-alt p-btn-small text-btn3">
@@ -105,17 +138,25 @@ import Icon from "../core/Icon";
         Secondary button
       </button>
     </div>
+  ),
+};
 
-    <div className="p-16 mb-16 mr-16 border rounded grid justify-items-start auto-rows-min gap-16">
-      <h3 className="ui-text-h3">Large</h3>
-      <button type="button" className="ui-btn p-btn-large text-btn1">Primary button</button>
+export const Large = {
+  render: () => (
+    <div className="flex flex-col gap-16 max-w-[300px]">
+      <button type="button" className="ui-btn p-btn-large text-btn1">
+        Primary button
+      </button>
       <button type="button" className="ui-btn p-btn-large text-btn1">
         <Icon name="icon-gui-search" size="1rem" additionalCSS="ui-btn-icon" />
         Primary button with icon
       </button>
-      <button type="button" className="ui-btn-alt p-btn-large text-btn1">Primary button alternative</button>
-      <button type="button" className="ui-btn-secondary p-btn-large text-btn1">Secondary button</button>
+      <button type="button" className="ui-btn-alt p-btn-large text-btn1">
+        Primary button alternative
+      </button>
+      <button type="button" className="ui-btn-secondary p-btn-large text-btn1">
+        Secondary button
+      </button>
     </div>
-
-  </div>
-</Unstyled>
+  ),
+};
diff --git a/src/core/styles/buttons.css b/src/core/styles/buttons.css
index ebc5528f6..23c53a6f7 100644
--- a/src/core/styles/buttons.css
+++ b/src/core/styles/buttons.css
@@ -121,4 +121,19 @@
   .ui-chip-alt[data-selected]:focus {
     @apply bg-gui-active text-white;
   }
+
+  .ui-btn.ui-btn-disabled,
+  .ui-btn-invert.ui-btn-disabled,
+  .ui-chip.ui-btn-disabled,
+  .ui-chip-alt.ui-btn-disabled {
+    @apply text-mid-grey bg-gui-unavailable cursor-not-allowed pointer-events-none select-none;
+  }
+
+  .ui-btn-secondary.ui-btn-disabled {
+    @apply text-gui-unavailable border-gui-unavailable bg-white cursor-not-allowed pointer-events-none select-none;
+  }
+
+  .ui-btn-secondary-invert.ui-btn-disabled {
+    @apply text-gui-unavailable border-gui-unavailable cursor-not-allowed pointer-events-none select-none;
+  }
 }
diff --git a/tailwind.config.js b/tailwind.config.js
index 687e45123..f1ad30381 100644
--- a/tailwind.config.js
+++ b/tailwind.config.js
@@ -1,5 +1,5 @@
 module.exports = {
-  content: ["./src/**/*.{js,ts,tsx,mdx}"],
+  content: ["./src/**/*.{js,ts,tsx,mdx,stories.tsx}"],
   safelist: [
     "w-1/2",
     "w-1/3",