@ably/ui 7.10.0-dev.e6f7622 → 8.0.0

package/src/core/Meganav/component.js

@@ -18,6 +18,7 @@ import MeganavControlMobileDropdown from "../MeganavControlMobileDropdown/compon
 import MobilePanelOpenClick from "../MeganavControlMobilePanelOpen/component";
 import MobilePanelCloseClick from "../MeganavControlMobilePanelClose/component";
 import MeganavSearchAutocomplete from "../MeganavSearchAutocomplete/component";
+import MeganavSearchSuggestions from "../MeganavSearchSuggestions/component";
 
 // Close menu when user clicks outside of viewport
 const windowOnBlur = (closeAll) => {
@@ -117,6 +118,7 @@ export default function Meganav({ themeName } = { themeName: null }) {
   const panelOpenControls = MobilePanelOpenClick();
   const panelCloseControls = MobilePanelCloseClick();
   const search = MeganavSearchAutocomplete();
+  const searchSuggestions = MeganavSearchSuggestions();
 
   const mobileDropdownControl = MeganavControlMobileDropdown({
     clearPanels: () =>
@@ -126,6 +128,7 @@ export default function Meganav({ themeName } = { themeName: null }) {
   const closeAll = () =>
     [
       mobileDropdownControl,
+      searchSuggestions,
       ...panelOpenControls,
       ...panelCloseControls,
       ...controls,
@@ -137,6 +140,7 @@ export default function Meganav({ themeName } = { themeName: null }) {
     documentClick(closeAll),
     windowOnBlur(closeAll),
     mobileDropdownControl,
+    searchSuggestions,
     ...controls,
     ...panelOpenControls,
     ...panelCloseControls,

package/src/core/MeganavControlMobileDropdown/component.js

@@ -7,8 +7,6 @@ const MeganavControlMobileDropdown = ({ clearPanels }) => {
   const dropdown = queryId("meganav-mobile-dropdown");
   const menuIcon = queryId("meganav-control-mobile-dropdown-menu");
   const closeIcon = queryId("meganav-control-mobile-dropdown-close");
-  const meganavSearchSuggestionsToggle = queryId("meganav-mobile-search-input");
-  const meganavSearchSuggestions = queryId("meganav-mobile-search-suggestions");
 
   const clickHandler = () => {
     const ariaExpanded = control.getAttribute("aria-expanded");
@@ -28,40 +26,12 @@ const MeganavControlMobileDropdown = ({ clearPanels }) => {
     closeIcon.classList.toggle("hidden");
   };
 
-  const focusSuggestionsHandler = () => {
-    meganavSearchSuggestions.classList.add("max-h-96");
-  };
-  const blurSuggestionsHandler = (event) => {
-    if (
-      event.relatedTarget === meganavSearchSuggestions.querySelectorAll("a")[0]
-    ) {
-      return;
-    }
-    meganavSearchSuggestions.classList.remove("max-h-96");
-  };
-
   control.addEventListener("click", clickHandler);
-  meganavSearchSuggestionsToggle.addEventListener(
-    "focus",
-    focusSuggestionsHandler
-  );
-  meganavSearchSuggestionsToggle.addEventListener(
-    "blur",
-    blurSuggestionsHandler
-  );
 
   return {
     teardown: () => {
       control.removeEventListener("click", clickHandler);
       scrollLock.enablePageScroll();
-      meganavSearchSuggestionsToggle.removeEventListener(
-        "focus",
-        focusSuggestionsHandler
-      );
-      meganavSearchSuggestionsToggle.removeEventListener(
-        "blur",
-        blurSuggestionsHandler
-      );
     },
     clear: () => {
       dropdown.classList.replace("visible", "invisible");
@@ -69,7 +39,6 @@ const MeganavControlMobileDropdown = ({ clearPanels }) => {
       menuIcon.classList.remove("hidden");
       closeIcon.classList.add("hidden");
       scrollLock.enablePageScroll();
-      meganavSearchSuggestions.classList.remove("max-h-96");
     },
   };
 };

package/src/core/MeganavSearch/component.html.erb

@@ -2,12 +2,12 @@
   type="button"
   data-id="meganav-control"
   data-control="search"
-  class="h-64 w-24 px-24 pr-48 py-20"
+  class="h-64 w-24 px-24 pr-48 py-20 group focus:outline-none"
   aria-expanded="false"
   aria-controls="panel-search"
   aria-label="Show Search Panel"
 >
-  <%= render(AblyUi::Core::Icon.new(name: "icon-gui-search", size: "1.5rem", color: "text-cool-black", additional_css: "hover:text-gui-hover")) %>
+  <%= render(AblyUi::Core::Icon.new(name: "icon-gui-search", size: "1.5rem", color: "text-cool-black", additional_css: "group-hover:text-gui-hover group-focus:text-gui-focus")) %>
 </button>
 
 <div class="ui-meganav-panel invisible" id="panel-search" data-id="meganav-panel">

package/src/core/MeganavSearch/component.jsx

@@ -11,12 +11,12 @@ const MeganavSearch = ({ absUrl }) => {
         type="button"
         data-id="meganav-control"
         data-control="search"
-        className="h-64 w-24 px-24 pr-48 py-20"
+        className="h-64 w-24 px-24 pr-48 py-20 group focus:outline-none"
         aria-expanded="false"
         aria-controls="panel-search"
         aria-label={`Show Search Panel`}
       >
-        <Icon name="icon-gui-search" color="text-cool-black" size="1.5rem" additionalCSS="hover:text-gui-hover" />
+        <Icon name="icon-gui-search" color="text-cool-black" size="1.5rem" additionalCSS="group-hover:text-gui-hover group-focus:text-gui-focus" />
       </button>
 
       <div className="ui-meganav-panel invisible" id="panel-search" data-id="meganav-panel">

package/src/core/MeganavSearchAutocomplete/component.js

@@ -84,11 +84,11 @@ const init = ({ input, container, listContainer, clear, client }) => {
           const key = e.key;
 
           if (key === "ArrowDown") {
-            focusNext();
+            focusNext(index);
           } else if (key === "ArrowUp" && index - 1 < 0) {
             input.focus();
           } else if (key === "ArrowUp" && index - 1 >= 0) {
-            focusPrevious();
+            focusPrevious(index);
           } else if (key === "Enter" || key === "Space") {
             navigateToUrl(suggestion.value);
           }

package/src/core/MeganavSearchSuggestions/component.html.erb

@@ -3,16 +3,16 @@
 <div class="flex justify-between items-center overflow-x-scroll md:overflow-auto">
   <ul class="flex">
     <li class="py-12 pr-8 flex-shrink-0">
-      <%= link_to 'How does Ably work?', abs_url("/docs/how-ably-works"), class: "ui-text-p2" %>
+      <%= link_to 'How does Ably work?', abs_url("/docs/how-ably-works"), class: "ui-text-p2 hover:text-gui-hover active:text-gui-active focus:text-gui-focus" %>
     </li>
     <li class="py-12 px-8 flex-shrink-0">
-      <%= link_to 'Quickstart guide', abs_url("/docs/quick-start-guide"), class: "ui-text-p2" %>
+      <%= link_to 'Quickstart guide', abs_url("/docs/quick-start-guide"), class: "ui-text-p2 hover:text-gui-hover active:text-gui-active focus:text-gui-focus" %>
     </li>
     <li class="py-12 px-8 flex-shrink-0">
-      <%= link_to 'Publish/Subscribe Messaging', abs_url("/docs/core-features/pubsub"), class: "ui-text-p2" %>
+      <%= link_to 'Publish/Subscribe Messaging', abs_url("/docs/core-features/pubsub"), class: "ui-text-p2 hover:text-gui-hover active:text-gui-active focus:text-gui-focus" %>
     </li>
     <li class="py-12 pl-8 flex-shrink-0">
-      <%= link_to 'Platform', abs_url("/docs/how-ably-works"), class: "ui-text-p2" %>
+      <%= link_to 'Platform', abs_url("/docs/how-ably-works"), class: "ui-text-p2 hover:text-gui-hover active:text-gui-active focus:text-gui-focus" %>
     </li>
   </ul>
 

package/src/core/MeganavSearchSuggestions/component.js

@@ -0,0 +1,123 @@
+import { queryId } from "../dom-query";
+
+const DRAG_BUFFER = 5;
+
+const getTranslateX = (node) =>
+  new DOMMatrix(window.getComputedStyle(node).transform).e;
+
+const updateTranslateX = (node, value) =>
+  (node.style.transform = `translateX(${value}px)`);
+
+const dragLeftBoundary = (translateX, threshold) => translateX >= threshold;
+
+const dragRightBoundary = (translateX, itemsWidth, windowWidth, threshold) =>
+  Math.abs(translateX - windowWidth + threshold) > itemsWidth;
+
+const getDistance = (e, touchStartX) =>
+  e.changedTouches[0]?.clientX - touchStartX;
+
+const withinBuffer = (distance) => Math.abs(distance) < DRAG_BUFFER;
+
+const MeganavSearchSuggestions = () => {
+  const suggestionsToggle = queryId("meganav-mobile-search-input");
+  const suggestions = queryId("meganav-mobile-search-suggestions");
+  const list = suggestions.querySelector("ul");
+  const listItems = list.querySelectorAll("li");
+
+  const itemsTotalWidth = Array.from(listItems)
+    .map((item) => item.getBoundingClientRect().width)
+    .reduce((acc, val) => acc + val, 0);
+
+  const dragLeft = (distance, threshold) => {
+    const currentTranslateX = getTranslateX(list);
+    const translateX = Math.round(currentTranslateX + distance);
+    if (dragLeftBoundary(translateX, threshold)) return;
+    updateTranslateX(list, translateX);
+  };
+
+  const dragLeftEnd = (distance, threshold) => {
+    const currentTranslateX = getTranslateX(list);
+    let translateX = Math.round(currentTranslateX + distance);
+
+    if (dragLeftBoundary(translateX, threshold)) {
+      translateX = 0;
+    }
+
+    updateTranslateX(list, translateX);
+  };
+
+  const dragRight = (distance, threshold) => {
+    const listWidth = list.getBoundingClientRect().width;
+    const currentTranslateX = getTranslateX(list);
+    const translateX = Math.round(currentTranslateX + distance);
+
+    if (dragRightBoundary(translateX, itemsTotalWidth, listWidth, threshold)) {
+      return;
+    }
+
+    updateTranslateX(list, translateX);
+  };
+
+  const dragRightEnd = (distance, threshold) => {
+    const listWidth = list.getBoundingClientRect().width;
+    const currentTranslateX = getTranslateX(list);
+    let translateX = Math.round(currentTranslateX + distance);
+
+    if (dragRightBoundary(translateX, itemsTotalWidth, listWidth, threshold)) {
+      translateX = -(itemsTotalWidth - listWidth + threshold);
+    }
+
+    updateTranslateX(list, translateX);
+  };
+
+  let touchStartX;
+
+  const touchstartHandler = (e) => {
+    touchStartX = e.touches[0]?.clientX;
+  };
+
+  const touchmoveHandler = (e) => {
+    const distance = getDistance(e, touchStartX);
+    if (withinBuffer(distance)) return;
+    distance > 0 ? dragLeft(distance, 24) : dragRight(distance, 96);
+  };
+
+  const touchendHandler = (e) => {
+    const distance = getDistance(e, touchStartX);
+    if (withinBuffer(distance)) return;
+    distance > 0 ? dragLeftEnd(distance, 24) : dragRightEnd(distance, 48);
+  };
+
+  const focusSuggestionsHandler = () => {
+    suggestions.classList.add("max-h-96");
+  };
+
+  const blurSuggestionsHandler = (e) => {
+    if (e.relatedTarget === suggestions.querySelectorAll("a")[0]) {
+      return;
+    }
+    suggestions.classList.remove("max-h-96");
+  };
+
+  suggestionsToggle.addEventListener("focus", focusSuggestionsHandler);
+  suggestionsToggle.addEventListener("blur", blurSuggestionsHandler);
+  suggestions.addEventListener("touchstart", touchstartHandler);
+  suggestions.addEventListener("touchmove", touchmoveHandler);
+  suggestions.addEventListener("touchend", touchendHandler);
+
+  return {
+    teardown: () => {
+      suggestionsToggle.removeEventListener("focus", focusSuggestionsHandler);
+      suggestionsToggle.removeEventListener("blur", blurSuggestionsHandler);
+      suggestions.removeEventListener("touchstart", touchstartHandler);
+      suggestions.removeEventListener("touchmove", touchmoveHandler);
+      suggestions.removeEventListener("touchend", touchendHandler);
+    },
+    clear: () => {
+      suggestions.classList.remove("max-h-96");
+      list.style.transform = `translateX(0px)`;
+    },
+  };
+};
+
+export default MeganavSearchSuggestions;

package/src/core/MeganavSearchSuggestions/component.jsx

@@ -8,25 +8,25 @@ const MeganavSearchSuggestions = ({ absUrl, displaySupportLink }) => {
     <>
       <p className="ui-text-overline2 text-cool-black py-12">Popular pages</p>
 
-      <div className="flex justify-between items-center overflow-x-scroll md:overflow-auto">
-        <ul className="flex">
+      <div className="flex justify-between items-center overflow-hidden">
+        <ul className="flex transition-transform">
           <li className="py-12 pr-8 flex-shrink-0">
-            <a href={absUrl("/docs/how-ably-works")} className="ui-text-p2">
+            <a href={absUrl("/docs/how-ably-works")} className="ui-text-p2 hover:text-gui-hover active:text-gui-active focus:text-gui-focus">
               How does Ably work?
             </a>
           </li>
           <li className="py-12 px-8 flex-shrink-0">
-            <a href={absUrl("/docs/quick-start-guide")} className="ui-text-p2">
+            <a href={absUrl("/docs/quick-start-guide")} className="ui-text-p2 hover:text-gui-hover active:text-gui-active focus:text-gui-focus">
               Quickstart guide
             </a>
           </li>
           <li className="py-12 px-8 flex-shrink-0">
-            <a href={absUrl("/docs/core-features/pubsub")} className="ui-text-p2">
+            <a href={absUrl("/docs/core-features/pubsub")} className="ui-text-p2 hover:text-gui-hover active:text-gui-active focus:text-gui-focus">
               Publish/Subscribe Messaging
             </a>
           </li>
           <li className="py-12 pl-8 flex-shrink-0">
-            <a href={absUrl("/platform")} className="ui-text-p2">
+            <a href={absUrl("/platform")} className="ui-text-p2 hover:text-gui-hover active:text-gui-active focus:text-gui-focus">
               Platform
             </a>
           </li>

package/src/core/fonts/source-code-pro.css

@@ -0,0 +1,3 @@
+@layer base {
+  @import url("https://fonts.googleapis.com/css2?family=Source+Code+Pro:wght@600&display=swap");
+}

package/src/core/styles/properties.css

@@ -15,9 +15,10 @@
     --color-charcoal-grey: #292831;
     --color-gui-default: #0073e6;
     --color-gui-hover: #0867c4;
-    --color-gui-focus: #80b9f2;
+    --color-gui-focus: #0073e6;
+    --color-gui-focus-outline: #80b9f2;
     --color-gui-active: #074095;
-    --color-gui-viewed: #4887c2;
+    --color-gui-visited: #4887c2;
     --color-gui-unavailable: #a8a8a8;
     --color-gui-error: #fb0c0c;
     --color-gui-success: #11cb24;
@@ -157,7 +158,7 @@
     /* In components, when looking at implementing viewport margin and spacing between elements,
        the values in the comments can be used as guide as they represent the grid the elements (should) sit on.
        alternatively, look for ui-grid-* helpers. */
-    --bp-xs: 375px; /* gutters 8px, side-margin 24px */
+    --bp-xs: 428px; /* gutters 8px, side-margin 24px */
     --bp-sm: 768px; /* gutters 16px, side-margin 32px */
     --bp-md: 1040px; /* gutters 24px, side-margin 40px, meganav desktop */
     --bp-lg: 1280px; /* gutters 24px, side-margin 64px */

package/src/core/styles/text.css

@@ -30,17 +30,17 @@
   }
 
   .ui-text-p1 {
-    @apply font-sans font-light text-cool-black;
+    @apply font-sans font-light text-charcoal-grey;
     @apply text-p1;
   }
 
   .ui-text-p2 {
-    @apply font-sans font-light text-cool-black;
+    @apply font-sans font-light text-charcoal-grey;
     @apply text-p2;
   }
 
   .ui-text-p3 {
-    @apply font-sans font-light text-cool-black;
+    @apply font-sans font-light text-charcoal-grey;
     @apply text-p3;
   }
 
@@ -146,21 +146,17 @@
     @apply list-square;
   }
 
-  /* visited needs to come before :hover et all else it overrides them */
-  .ui-link:visited {
-    @apply text-gui-viewed;
-  }
-
   .ui-link {
-    @apply hover:text-active-orange active:text-red-orange;
-    text-decoration-color: var(--color-active-orange);
-    text-underline-offset: 4px; /* px used here as behaves weird with rem's */
-    text-decoration-line: underline;
-    text-decoration-thickness: 0.125rem;
+    @apply visited:text-gui-visited;
+    @apply hover:text-gui-hover active:text-gui-active disabled:text-gui-unavailable;
+    @apply focus:text-gui-focus focus:outline-gui-focus;
+    @apply underline;
   }
 
-  .ui-link:focus {
-    @apply focus:text-white focus:bg-active-orange focus:outline-none;
-    text-decoration: none;
+  .ui-link-neutral {
+    @apply visited:text-dark-grey;
+    @apply hover:text-dark-grey active:text-cool-black disabled:text-gui-unavailable;
+    @apply focus:text-gui-focus focus:outline-gui-focus-neutral;
+    @apply underline;
   }
 }

package/tailwind.config.js

@@ -17,7 +17,7 @@ module.exports = {
   theme: {
     screens: {
       // CSS custom properties can't be used in media queries
-      xs: "375px",
+      xs: "428px",
       sm: "768px",
       md: "1040px",
       lg: "1280px",
@@ -74,7 +74,7 @@ module.exports = {
       "gui-hover": "var(--color-gui-hover)",
       "gui-focus": "var(--color-gui-focus)",
       "gui-active": "var(--color-gui-active)",
-      "gui-viewed": "var(--color-gui-viewed)",
+      "gui-visited": "var(--color-gui-visited)",
       "gui-unavailable": "var(--color-gui-unavailable)",
       "gui-error": "var(--color-gui-error)",
       "gui-success": "var(--color-gui-success)",
@@ -183,7 +183,8 @@ module.exports = {
         filter: "filter",
       },
       outline: {
-        "gui-focus": "4px solid var(--color-gui-focus)",
+        "gui-focus": "1.5px solid var(--color-gui-focus-outline)",
+        "gui-focus-neutral": "2px solid var(--color-white)",
       },
       width: {
         "extend-8": "calc(100% + var(--spacing-8))",
@@ -210,7 +211,14 @@ module.exports = {
   variants: {
     extend: {
       borderColor: ["hover", "focus", "active", "group-focus", "disabled"],
-      textColor: ["hover", "focus", "active", "group-focus", "disabled"],
+      textColor: [
+        "hover",
+        "focus",
+        "active",
+        "group-focus",
+        "disabled",
+        "visited",
+      ],
       display: ["group-focus"],
       backgroundColor: ["hover", "focus", "active", "group-focus", "disabled"],
       backgroundImage: ["hover", "active", "focus"],