ekm-ui 0.3.2 → 0.3.7

package/src/file-picker/file-picker.tsx

@@ -0,0 +1,458 @@
+// @ts-nocheck
+import { useEffect, useRef, useState, useReducer } from 'react'
+import { Drawer } from '../drawer'
+import { Button } from '../button'
+import { AlertBanner } from '../alert-banner'
+import { Search } from '../search/search'
+import { DragAndDrop } from '../drag-and-drop'
+import { BsFillImageFill } from 'react-icons/bs'
+import { HiOutlineSearch } from 'react-icons/hi'
+import Listing from './file-listing'
+import PropTypes from 'prop-types'
+
+const apiUrl = '/admin/api/common/directoryinformation/'
+const Status = Object.freeze({
+  EMPTY: 'EMPTY',
+  SEARCH_LOADING: 'SEARCH-LOADING',
+  LOADING: 'LOADING',
+  LOADED: 'LOADED',
+  SEARCH_RESULTS: 'SEARCH-RESULTS',
+  SEARCH_EMPTY: 'SEARCH-EMPTY',
+  UPLOAD_ERROR: 'ERROR',
+  DRAGGING: 'DRAGGING',
+})
+
+const initialState = Object.freeze({
+  mode: Status.LOADING,
+  footerBorder: 'border-t',
+  actionBtnTxt: 'I Accept',
+  actionBtnColor: 'success',
+  listSize: 'h-5/6',
+  listBorder: '',
+  searchDisabled: false,
+})
+
+function FilePickerReducer(state, action) {
+  switch (action.type) {
+    case Status.EMPTY:
+      return {
+        mode: Status.EMPTY,
+        footerBorder: 'border-t',
+        actionBtnTxt: 'Add Image',
+        actionBtnColor: 'blue',
+        listSize: 'h-5/6',
+        listBorder: '',
+        searchDisabled: true,
+      }
+    case Status.LOADING:
+      return initialState
+    case Status.LOADED:
+      return {
+        mode: Status.LOADED,
+        footerBorder: '',
+        actionBtnTxt: 'I Accept',
+        actionBtnColor: 'success',
+        listSize: 'h-2/3',
+        listBorder: 'border',
+        searchDisabled: false,
+      }
+    case Status.SEARCH_RESULTS:
+      return {
+        mode: Status.SEARCH_RESULTS,
+        footerBorder: '',
+        actionBtnTxt: 'I Accept',
+        actionBtnColor: 'success',
+        listSize: 'h-5/6',
+        listBorder: 'border',
+        searchDisabled: false,
+      }
+    case Status.SEARCH_EMPTY:
+      return {
+        mode: Status.SEARCH_EMPTY,
+        footerBorder: 'border-t',
+        actionBtnTxt: 'I Accept',
+        actionBtnColor: 'success',
+        listSize: 'h-5/6',
+        listBorder: '',
+        searchDisabled: false,
+      }
+    default:
+      throw new Error('Unknown file picker state: ' + action.page ?? '')
+  }
+}
+
+/**
+ * IMPORTANT TO NOTE
+ * The parent/calling component is responsible for fetching the files. This component should not reallyknow
+ * what the files are, just how to display them. This means that searching and pagination logic should also
+ * be handled by the parent/calling component
+ */
+
+export function FilePicker({ appUrl, uri, show, onClose, callback }) {
+  const searchFieldRef = useRef()
+  const [state, dispatch] = useReducer(FilePickerReducer, { mode: Status.LOADING, footerBorder: 'border-t' })
+  const [totalPages, setTotalPages] = useState(0)
+  const currentPageRef = useRef(1)
+  const [dragging, setDragging] = useState(false)
+  const [err, setErr] = useState(false)
+  const listAttributeRef = useRef({ pages: 0, totalEntries: 0 })
+  const [fetchData, setFetchData] = useState(false)
+  const [search, setSearch] = useState(null)
+  const [selected, setSelected] = useState(null)
+  const [files, setFiles] = useState([])
+  const [uploadedImage, setUploadedImage] = useState('none')
+
+  useEffect(() => {
+    // Workaround to ensure the drawer is cleared when it is first opened as its always on the DOM!
+    if (show) {
+      dispatch({ type: Status.LOADING })
+      setSelected(null)
+      listAttributeRef.current = { pages: 0, totalEntries: 0 }
+      clearState()
+      getFiles(1)
+    }
+  }, [show])
+
+  useEffect(() => {
+    if (show) {
+      currentPageRef.current = 1
+      getFiles()
+      setErr(false)
+    }
+  }, [search])
+
+  useEffect(() => {
+    if (selected) setSelected(null)
+    if (err) setErr(false)
+  }, [state.mode])
+
+  const clearState = () => {
+    setFiles([])
+    setUploadedImage('none')
+    setFetchData(false)
+    setSelected(null)
+    setErr(false)
+  }
+
+  const getFiles = async (cp = 0) => {
+    try {
+      let page = cp === 0 ? currentPageRef.current : cp
+      let searchUri = search?.length > 0 ? `&FileNameIncludesString=${search}` : `&FileNameIncludesString=`
+      const response = await fetch(`${appUrl}${apiUrl}?CurrentPage=${page}&PageSize=10&Uri=${uri}${searchUri}`, {
+        method: 'GET',
+        credentials: 'same-origin',
+        headers: { 'Content-Type': 'application/json' },
+      })
+      const data = await response.json()
+      if (search?.length > 0) dispatch({ type: Status.SEARCH_RESULTS })
+      if (data.Items.Data.length > 0 && page > 1) {
+        setFiles((files) => [...files, ...data.Items.Data])
+      } else {
+        setFiles(data.Items.Data)
+      }
+
+      listAttributeRef.current = { pages: data.Items.NumberOfPages, totalEntries: data.Items.Total }
+      setTotalPages(data.Items.NumberOfPages)
+
+      if (search?.length > 0) {
+        dispatch({ type: data.Items.Data.length > 0 ? Status.SEARCH_RESULTS : Status.SEARCH_EMPTY })
+      } else {
+        dispatch({ type: data.Items.Data.length > 0 ? Status.LOADED : Status.EMPTY })
+      }
+
+      setUploadedImage('none')
+
+      setFetchData(false)
+      setDragging(false)
+    } catch (error) {
+      dispatch({ type: search?.length === 0 ? Status.SEARCH_EMPTY : Status.EMPTY })
+    }
+  }
+
+  const handleDragEnter = (e) => {
+    setDragging(true)
+    searchFieldRef.current.removeFocus()
+    e.preventDefault()
+  }
+
+  const handleDragLeave = (e) => {
+    setDragging(false)
+  }
+
+  const handleSearchRequest = (searchTerm) => {
+    const text = searchTerm.text ?? ''
+    const s = search ?? ''
+    setSearch(searchTerm.text)
+    if ((s.length > 0 && text.length === 0) || (s.length === 0 && text.length > 0 && state.mode !== Status.LOADING))
+      dispatch({ type: Status.LOADING })
+  }
+
+  const handleDropError = () => {
+    setErr(true)
+    setDragging(false)
+    setUploadedImage('none')
+  }
+
+  const handleUseImage = () => {
+    callback(`https://files.ekmcdn.com/${selected.Uri}`)
+    handleClose()
+  }
+
+  const handleClose = () => {
+    clearState()
+    onClose()
+  }
+
+  const handleFileUpload = async (file) => {
+    if (file == null) {
+      setUploadedImage('error')
+      handleDropError()
+      return
+    }
+
+    try {
+      const arr = await getAsByteArray(file)
+      const payload = {
+        Path: `/${uri}/`,
+        Name: file.name,
+        Bytes: getBase64(arr),
+        ForceOverwriteFile: true,
+      }
+      const res = await fetch(`${appUrl}${apiUrl}`, {
+        method: 'POST',
+        credentials: 'same-origin',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+      })
+
+      if (res.status === 200) {
+        setUploadedImage('success')
+        setSearch(null)
+        searchFieldRef.current.clear()
+        // dispatch({ type: Status.LOADED })
+        setFiles([])
+        setErr(false)
+        getFiles(1)
+      } else {
+        setUploadedImage('error')
+      }
+    } catch (error) {
+      setUploadedImage('error')
+    }
+  }
+
+  const handleListActions = (action) => {
+    switch (action.type) {
+      case 'FETCH_DATA':
+        setFetchData(action.payload)
+        if (currentPageRef.current < listAttributeRef.current.pages && !fetchData) {
+          // pass in the current page + 1 to get the next page of data then change state as the state is not updated immediately
+          setFetchData(true)
+          currentPageRef.current = currentPageRef.current + 1
+          getFiles()
+        }
+        break
+      case 'SELECTION':
+        setSelected(action.payload)
+        setErr(false)
+        break
+      default:
+        break
+    }
+  }
+
+  const calculateListSize = () => {
+    if (!err) return state.listSize
+
+    if (state.mode === Status.LOADED) return 'h-2/4'
+    if (state.mode === Status.SEARCH_RESULTS) {
+      return 'h-2/3'
+    } else {
+      return state.listSize
+    }
+  }
+
+  const renderList = () => {
+    switch (state.mode) {
+      case Status.EMPTY:
+        return <EmptyPlaceholder />
+      case Status.LOADING:
+        return <LoadingPlaceholder />
+      case Status.SEARCH_RESULTS:
+      case Status.LOADED:
+        return (
+          <Listing
+            border={calculateListSize()}
+            files={files}
+            isMore={currentPageRef.current < listAttributeRef.current.pages}
+            selected={selected?.Name}
+            page={currentPageRef.current}
+            pages={totalPages}
+            callback={handleListActions}
+          />
+        )
+      case Status.SEARCH_EMPTY:
+        return <SearchEmptyPlaceholder />
+      default:
+        break
+    }
+  }
+
+  const renderContent = () => (
+    <>
+      <Search id="file-search" ref={searchFieldRef} placeholder="Search your images" disabled={state.searchDisabled} callback={handleSearchRequest} />
+      <div className="mt-4 mb-4">
+        {err && (
+          <AlertBanner
+            type="danger"
+            onDismiss={() => {
+              setErr(false)
+            }}
+          >
+            <p className="font-semibold">File could not be uploaded</p>
+            <p>There was an error uploading the file. Please try again.</p>
+          </AlertBanner>
+        )}
+        {state.mode !== Status.SEARCH_RESULTS && state.mode !== Status.SEARCH_EMPTY && (
+          <div className="h-68">
+            <DragAndDrop uploaded={uploadedImage} callback={handleFileUpload} errorCallback={handleDropError} />
+          </div>
+        )}
+        {(state.mode === Status.SEARCH_RESULTS || state.mode === Status.SEARCH_EMPTY) && search?.length > 0 && (
+          <span className="ms-1 text-sm font-medium text-gray-500 md:ms-2 dark:text-gray-400">{`Showing results for..."${search}"`}</span>
+        )}
+      </div>
+
+      {renderList()}
+    </>
+  )
+
+  const renderOversizedDropZone = () => (
+    <div className="h-[90.666667%] w-[93.666667%] z-50 absolute">
+      <DragAndDrop uploaded={uploadedImage} exitCallback={handleDragLeave} callback={handleFileUpload} errorCallback={handleDropError} />
+    </div>
+  )
+
+  return (
+    <Drawer show={show} onClose={handleClose} title="File Picker" onHide={() => {}}>
+      <div className="h-full" onDragEnter={handleDragEnter}>
+        {show && dragging && renderOversizedDropZone()}
+        {show && renderContent()}
+      </div>
+      <div
+        className={`grid grid-cols-2 grid-flow-col gap-4 bottom-0 mt-0 pt-2 ${state.footerBorder} bg-white border-gray-200 dark:border-gray-600`}
+        style={{ marginTop: '-50px' }}
+      >
+        <Button color="light" onClick={handleClose}>
+          Close
+        </Button>
+        <Button color={state.actionBtnColor} onClick={handleUseImage} disabled={selected == null}>
+          {state.actionBtnTxt}
+        </Button>
+      </div>
+    </Drawer>
+  )
+}
+
+
+FilePicker.propTypes = {
+  /** The url of the app */
+  appUrl: PropTypes.string.isRequired,
+  /** The uri of the folder to display */
+  uri: PropTypes.string.isRequired,
+  /** Show the drawer */
+  show: PropTypes.bool.isRequired,
+  /** Callback to close the drawer */
+  onClose: PropTypes.func.isRequired,
+  /** Callback to return the selected image */
+  callback: PropTypes.func.isRequired,
+}
+
+// HELPER FUNCTIONAL COMPONENTS FOR FILE PICKER
+function EmptyPlaceholder() {
+  return (
+    <div className="flex flex-col items-center justify-center mt-5">
+      <h1>
+        <BsFillImageFill className="text-9xl text-gray-700" />
+      </h1>
+      <p className="mt-4 font-semibold text-2xl text-gray-900">You Have No Images</p>
+      <p className="mt-4 text-sm text-gray-500">Images will appear here when you upload them</p>
+    </div>
+  )
+}
+
+function LoadingPlaceholder() {
+  return (
+    <div className="h-2/3 overflow-y-auto flex items-center justify-center">
+      <div className="flex flex-col items-center justify-center">
+        <h1>
+          <Spinner />
+        </h1>
+        <p className="mt-4 font-semibold text-2xl text-gray-900">Loading Files</p>
+        <p className="mt-4 text-sm text-gray-500">Don't worry, this won't take long...</p>
+      </div>
+    </div>
+  )
+}
+
+function SearchEmptyPlaceholder() {
+  return (
+    <div className="h-5/6 overflow-y-auto flex items-center justify-center">
+      <div className="flex flex-col items-center justify-center">
+        <h1>
+          <HiOutlineSearch className="text-9xl text-gray-700" />
+        </h1>
+        <p className="mt-4 font-semibold text-2xl text-gray-900">No Files Found</p>
+        <p className="mt-4 text-sm text-gray-500">No files were found matching your search</p>
+      </div>
+    </div>
+  )
+}
+
+function Spinner() {
+  return (
+    <div role="status">
+      <svg
+        aria-hidden="true"
+        className="inline w-14 h-14 text-gray-200 animate-spin dark:text-gray-600 fill-blue-600"
+        viewBox="0 0 100 101"
+        fill="none"
+        xmlns="http://www.w3.org/2000/svg"
+      >
+        <path
+          d="M100 50.5908C100 78.2051 77.6142 100.591 50 100.591C22.3858 100.591 0 78.2051 0 50.5908C0 22.9766 22.3858 0.59082 50 0.59082C77.6142 0.59082 100 22.9766 100 50.5908ZM9.08144 50.5908C9.08144 73.1895 27.4013 91.5094 50 91.5094C72.5987 91.5094 90.9186 73.1895 90.9186 50.5908C90.9186 27.9921 72.5987 9.67226 50 9.67226C27.4013 9.67226 9.08144 27.9921 9.08144 50.5908Z"
+          fill="currentColor"
+        />
+        <path
+          d="M93.9676 39.0409C96.393 38.4038 97.8624 35.9116 97.0079 33.5539C95.2932 28.8227 92.871 24.3692 89.8167 20.348C85.8452 15.1192 80.8826 10.7238 75.2124 7.41289C69.5422 4.10194 63.2754 1.94025 56.7698 1.05124C51.7666 0.367541 46.6976 0.446843 41.7345 1.27873C39.2613 1.69328 37.813 4.19778 38.4501 6.62326C39.0873 9.04874 41.5694 10.4717 44.0505 10.1071C47.8511 9.54855 51.7191 9.52689 55.5402 10.0491C60.8642 10.7766 65.9928 12.5457 70.6331 15.2552C75.2735 17.9648 79.3347 21.5619 82.5849 25.841C84.9175 28.9121 86.7997 32.2913 88.1811 35.8758C89.083 38.2158 91.5421 39.6781 93.9676 39.0409Z"
+          fill="currentFill"
+        />
+      </svg>
+      <span className="sr-only">Loading...</span>
+    </div>
+  )
+}
+
+// HELPER FUNCTIONS FOR FILE PICKER
+
+async function getAsByteArray(file) {
+  return new Uint8Array(await readFile(file))
+}
+
+function readFile(file) {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader()
+    reader.onloadend = (event) => resolve(event.target.result)
+    reader.onerror = (err) => reject(err)
+    reader.readAsArrayBuffer(file)
+  })
+}
+
+function getBase64(data) {
+  // Helper Funtions to convert a file to a base 64 byte array.
+  return btoa(
+    Array.from(data)
+      .map((b) => String.fromCharCode(b))
+      .join(''),
+  )
+}

package/src/index.tsx

@@ -41,5 +41,9 @@ export { AlertBanner } from "./alert-banner";
 export { Avatar } from "./avatar";
 export { Badge } from "./badge";
 export { Label } from "./label";
+export { ToolTip } from "./tooltip/tooltip";
+export { Radio } from "./radio";
+export { TextInput } from "./textinput";
+export { FilePicker } from "./file-picker/file-picker";;
 
 import "./styles.css";

package/src/page-header.tsx

@@ -1,8 +1,9 @@
+//@ts-nocheck
 import { Breadcrumb } from "flowbite-react";
 
 type Props = {
   title: string;
-  text?: string;
+  text?: string | Element[];
   children?: JSX.Element;
   breadcrumbs: Array<{ linkLabel: string; linkURL: string }>;
 };

package/src/radio.tsx

@@ -0,0 +1,26 @@
+//@ts-nocheck
+import { forwardRef } from "react";
+import PropTypes from "prop-types";
+
+export const Radio = forwardRef(function Radio(props, ref) {
+  return (
+    <div className="flex items-center">
+      <input
+        id={props.id}
+        ref={ref}
+        type="radio"
+        className={`h-4 w-4 rounded-full border-gray-300 bg-gray-100 text-blue-600 focus:ring-2 focus:ring-blue-500 dark:border-gray-600 dark:bg-gray-700 dark:ring-offset-gray-800 dark:focus:ring-blue-600 ${
+          disabled && "opacity-50"
+        }`}
+        {...props}
+      />
+    </div>
+  );
+});
+
+Radio.propTypes = {
+  id: PropTypes.string.isRequired,
+  checked: PropTypes.bool,
+  disabled: PropTypes.bool,
+  onChange: PropTypes.func,
+};

package/src/search/search.tsx

@@ -21,14 +21,10 @@ function useDebounceEffect(effect, delay, deps) {
   }, [callback, delay])
 }
 
-export function Search({
-  categories = [],
-  delay = 1500,
-  placeholder = 'Enter a keyword to search...',
-  callback,
-  disabled = false,
-  initialValue = '',
-}) {
+export const Search = forwardRef(function Search(
+  { id, categories = [], delay = 1500, placeholder = 'Enter a keyword to search...', callback, disabled = false, initialValue = '' },
+  reference,
+) {
   // Create state based on config
   const [state, setState] = useState({
     text: null,
@@ -36,6 +32,17 @@ export function Search({
   })
   const [currentSearchValue, setCurrentSearchValue] = useState(initialValue)
   const [hidden, setHidden] = useState(true)
+
+  useImperativeHandle(reference, () => ({
+    clear: () => {
+      setCurrentSearchValue('')
+      setState({ ...state, text: '' })
+    },
+    removeFocus: () => {
+      document.getElementById(`${id}-search-input`).blur()
+    },
+  }))
+
   const handleSearchChange = (e) => {
     setCurrentSearchValue(e.target.value)
     setState({ ...state, text: e.target.value })
@@ -61,7 +68,7 @@ export function Search({
     [state.text, state.category],
   )
   useEffect(() => {
-    setCurrentSearchValue(initialValue)
+    if (initialValue !== currentSearchValue) setCurrentSearchValue(initialValue)
   }, [initialValue])
 
   const ref = useRef(null)
@@ -81,7 +88,7 @@ export function Search({
   const renderDropdown = () => (
     <>
       <button
-        id="dropdown-button"
+        id={`${id}-dropdown-button`}
         data-dropdown-toggle="dropdown"
         className="absolute top-0 right-0 p-2.5 flex-shrink-0 z-10 inline-flex items-center py-2.5 px-4 text-sm font-medium text-center text-gray-900 bg-white border border-gray-300 dark:border-gray-700 dark:text-white rounded-r-lg hover:bg-gray-200 focus:ring-4 focus:outline-none focus:ring-gray-300 dark:bg-gray-600 dark:hover:bg-gray-700 dark:focus:ring-gray-800"
         type="button"
@@ -93,7 +100,7 @@ export function Search({
         </svg>
       </button>
       <div
-        id="dropdown"
+        id={`${id}-dropdown`}
         ref={ref}
         className={`z-10 ${hidden ? 'hidden' : ''} absolute right-0 bg-white divide-y divide-gray-100 rounded-r-lg shadow w-44 dark:bg-gray-700`}
       >
@@ -120,6 +127,7 @@ export function Search({
     <div className="flex">
       <div className="relative w-full">
         <input
+          ref={reference}
           placeholder={placeholder}
           value={currentSearchValue}
           aria-label="search"
@@ -127,15 +135,14 @@ export function Search({
           onChange={handleSearchChange}
           onKeyDown={handleKeyDown}
           disabled={disabled}
-          type="search"
-          id="search-dropdown"
+          id={`${id}-search-input`}
           className="block p-2.5 w-full text-sm text-gray-900 rounded-lg bg-gray-50  border-r-gray-300  border-r-2 border border-gray-300 focus:ring-blue-500 focus:border-blue-500 dark:bg-gray-700 dark:border-gray-600 dark:placeholder-gray-400 dark:text-white dark:focus:border-blue-500"
         />
         {categories?.length > 0 && renderDropdown()}
       </div>
     </div>
   )
-}
+})
 
 Search.propTypes = {
   /** Optional List of categories that the search term can be applied to. If supplied