Psl 1468 css improvements from enes feedback (#26)

* update dev script

* decrease specificity of css selectors

* use exact versions of storybook

* fix docs page formatting

* lower specificity css selectors

* set isOpen to false for no results

* simplify sb docs page layouts

* add autocompleteClassName

* add custom styles stories

* smoother image loading state

* refactor custom styles example code

* update readme image

* add repo workflows to readme

* improve phrasing

Author: deomsj

.storybook/custom-styles-story.css

@@ -0,0 +1,58 @@
+.cio-autocomplete.custom-autocomplete-styles form {
+  height: 44px;
+  width: 600px;
+  border-radius: 8px;
+  background-color: rgb(247, 247, 247);
+}
+
+.cio-autocomplete.custom-autocomplete-styles .cio-input {
+  font-size: 1rem;
+  font-weight: bold;
+}
+
+.cio-autocomplete.custom-autocomplete-styles .cio-form button {
+  width: 44px;
+}
+
+.cio-autocomplete.custom-autocomplete-styles .cio-clear-btn {
+  right: 24px;
+}
+.cio-autocomplete.custom-autocomplete-styles .cio-icon {
+  justify-content: center;
+}
+
+.cio-autocomplete.custom-autocomplete-styles .cio-sectionName {
+  font-size: 1rem;
+  margin: 5px 3px;
+}
+
+.cio-autocomplete.custom-autocomplete-styles .cio-results {
+  width: 620px;
+  max-height: 334px;
+  overflow: hidden;
+  border-radius: 0px 0px 8px 8px;
+  color: rgb(51, 51, 51);
+}
+
+.cio-autocomplete.custom-autocomplete-styles .cio-item-SearchSuggestions {
+  width: 150px;
+}
+
+.cio-autocomplete.custom-autocomplete-styles .Products .cio-item {
+  display: inline-flex;
+  align-items: center;
+  width: 25%;
+  max-height: 140px;
+  height: 140px;
+  margin: 0;
+  padding: 5px 0;
+}
+
+.cio-autocomplete.custom-autocomplete-styles .Products p {
+  padding: 5px 5px 0;
+  overflow: hidden;
+}
+
+.cio-autocomplete.custom-autocomplete-styles .cio-item img {
+  max-height: 100px;
+}

.storybook/main.js

@@ -11,8 +11,6 @@ module.exports = {
     options: {}
   },
   docs: {
-    enabled: false,
-    defaultName: 'Docs',
     autodocs: true
   }
 };

.storybook/preview.jsx

@@ -1,4 +1,6 @@
 import { Title, Description, Stories } from '@storybook/addon-docs';
+import './custom-styles-story.css';
+import './storybook-styles.css';
 
 export const parameters = {
   actions: { argTypesRegex: '^on.*' },

.storybook/storybook-styles.css

@@ -0,0 +1,4 @@
+.docs-story > div:first-child {
+  min-height: 500px;
+  background-color: #212425;
+}

README.md

@@ -6,7 +6,7 @@ This UI Library provides React components that manage fetching and rendering log
 
 [Our storybook docs](https://constructor-io.github.io/cio-autocomplete-ts) are the best place to explore the behavior and configuration options for this UI Library.
 
-![Autocomplete](docs-images/autocomplete.png)
+![Autocomplete](assets/autosuggest-ui.gif)
 
 ## How to use this UI Library
 
@@ -42,11 +42,12 @@ function YourComponent() {
     getLabelProps,
     getInputProps,
     getMenuProps,
-    getItemProps
+    getItemProps,
+    autocompleteClassName
   } = useCioAutocomplete(args);
 
   return (
-    <div className='cio-autocomplete'>
+    <div className={autocompleteClassName}>
       <form {...getFormProps()}>
         <label {...getLabelProps()} hidden>
           Search
@@ -96,16 +97,29 @@ function YourComponent() {
 }
 ```
 
+## Custom Styling
+
+### Library defaults
+
+This library provides some default styles. These default styles can be used as a foundation to build on top of or just as a reference for you to replace completely. All default styles in this library are scoped within the `.cio-autocomplete` css selector.
+
+ - If you would like to remove all default styling, simply pass an empty string or your own custom autocomplete container className as the value for the `autocompleteClassName` option
+ - If you would like to layer your own custom styles on top of the library default styles, you can do so by passing additional className(s) of your choosing `autocompleteClassName='cio-autocomplete custom-autocomplete-container'`
+
 ## Local Development
 
 ### Development scripts
 
 ```bash
 npm ci                  # install dependencies for local dev
-npm run storybook       # start a local dev server for Storybook
+npm run dev             # start a local dev server for Storybook
 npm run lint            # run linter
 ```
 
+### Repo Workflows
+
+ - [Version and Release](https://constructor.slab.com/posts/autosuggest-ui-version-and-release-jqouccw5)
+
 ### Maintain Library
 
 ```bash

assets/autosuggest-ui.gif

@@ -11,7 +11,7 @@
     "lint": "eslint src --ext js,ts,jsx,tsx",
     "copy-files": "copyfiles -u 1 src/**/*.css lib/src",
     "prepare": "husky install",
-    "storybook": "storybook dev -p 6006",
+    "dev": "storybook dev -p 6006",
     "storybook:ci": "storybook dev --ci --quiet -p 6006",
     "test-storybook": "test-storybook",
     "test-storybook:watch": "test-storybook --watch",
@@ -34,7 +34,7 @@
     "@storybook/addon-interactions": "^7.0.0-beta.15",
     "@storybook/addon-links": "^7.0.0-beta.15",
     "@storybook/jest": "^0.0.11-next.0",
-    "@storybook/react-webpack5": "^7.0.0-beta.15",
+    "@storybook/react-webpack5": "7.0.0-beta.15",
     "@storybook/test-runner": "^0.10.0-next.4",
     "@storybook/testing-library": "^0.0.14-next.1",
     "@types/react": "^18.0.20",

docs-images/autocomplete.png

@@ -1,9 +1,11 @@
 .cio-autocomplete {
-  font-family: Arial, Helvetica, sans-serif;
+  position: relative;
+  height: 2rem;
   padding: 20px;
+  font-family: Arial, Helvetica, sans-serif;
 }
 
-.cio-autocomplete .cio-items {
+.cio-autocomplete .cio-section-items {
   padding: 0;
 }
 
@@ -17,22 +19,19 @@
   width: 100%;
 }
 
-.cio-autocomplete .products.cio-section .cio-item {
+.cio-autocomplete .products .cio-item {
   align-items: center;
   justify-content: start;
 }
 
-.cio-autocomplete .products.cio-section .cio-items {
+.cio-autocomplete .products .cio-section-items {
   display: flex;
 }
 
 .cio-autocomplete .cio-form {
   position: relative;
-  z-index: 100;
-  width: 300px;
-  top: 0px;
-  right: -8px;
-  height: 30px;
+  height: 100%;
+  width: 24rem;
 }
 
 .cio-autocomplete .cio-input {
@@ -43,42 +42,44 @@
   border-radius: 3px;
 }
 
-.cio-autocomplete .cio-form .cio-btn,
-.cio-autocomplete .cio-form .cio-clear-btn {
+.cio-autocomplete .cio-submit-btn,
+.cio-autocomplete .cio-clear-btn {
   position: absolute;
   top: 1px;
   bottom: -1px;
   right: -21px;
 }
 
-.cio-autocomplete .cio-form .cio-btn[type='submit'] {
+.cio-autocomplete .cio-submit-btn {
   right: -21px;
 }
 
-.cio-autocomplete .cio-form .cio-clear-btn {
+.cio-autocomplete .cio-clear-btn {
   right: 10px;
 }
 
-.cio-autocomplete .cio-form .cio-icon {
+.cio-autocomplete .cio-icon {
   display: flex;
 }
 
 .cio-autocomplete .cio-results {
+  position: absolute;
   background-color: white;
   gap: 20px;
   padding-left: 0px;
   list-style: none;
   display: flex;
   flex-direction: row;
   z-index: 1000;
+  margin-top: 5px;
 }
 
 .cio-autocomplete .cio-sectionName {
   margin: 15px 0 20px 0;
   font-size: 22px;
 }
 
-.cio-autocomplete .cio-results .cio-section.searchSuggestions .cio-items {
+.cio-autocomplete .searchSuggestions .cio-section-items {
   flex-direction: column;
   min-width: 200px;
 }
@@ -88,27 +89,20 @@
 }
 
 .cio-autocomplete .cio-item {
-  padding: 10px;
+  padding: 5px;
   margin: 1px;
   border-bottom: 3px solid transparent;
 }
 
+.cio-autocomplete .cio-item p {
+  margin: 0;
+}
+
 .cio-autocomplete .cio-item img {
   max-width: 100px;
 }
 
-.cio-autocomplete [aria-selected='true'] {
+.cio-autocomplete .cio-item[aria-selected='true'] {
   background-color: hsl(0, 0%, 90%);
   border-radius: 4px;
 }
-
-.cio-autocomplete .cio-results[role='listbox'].showing-content {
-  position: relative;
-  top: 2px;
-  left: 8px;
-  max-width: 90vw;
-  background: white;
-  margin: 0px;
-  box-shadow: 0 2px 2px 1px grey;
-  overflow: auto;
-}