@digi-frontend/dgate-api-documentation 1.0.39 → 1.0.50

package/src/layout/docsComponents/DocsHeader/DocsHeader.module.scss

@@ -0,0 +1,271 @@
+.api_docs_header {
+  height: 2.625rem;
+  background-color: #f0f1f2;
+  display: flex;
+  align-items: center;
+  padding: 0 1rem;
+
+  .header_content {
+    width: 100%;
+    display: flex;
+    align-items: center;
+  }
+
+  .nav_buttons {
+    display: flex;
+    gap: 1rem;
+    margin-left: 2.9375rem;
+  }
+
+  .search_filter_btn {
+    background-color: #ffffff !important;
+    border: 1px solid #e8e9ee !important;
+    width: 10.4375rem;
+    height: 2.25rem;
+    font-weight: 400;
+    font-size: 1rem;
+    line-height: 1.25rem;
+
+    &:hover:not(:disabled) {
+      color: #000000;
+    }
+
+    &:hover {
+      color: #000;
+    }
+
+    svg {
+      margin-left: 0.5rem;
+    }
+  }
+
+  :global(.guide-btn) {
+    background-color: #ffffff !important;
+    border: 0.82px solid #b8bfca !important;
+    width: 5.658rem;
+    font-size: 0.9175rem;
+    font-weight: 400;
+    line-height: 1.234rem;
+    height: 2.25rem;
+
+    &:disabled {
+      opacity: 0.7;
+      background-color: #ffffff !important;
+      color: #667085 !important;
+    }
+
+    svg {
+      margin-right: 0.4075rem;
+    }
+  }
+
+  .api_btn {
+    background-color: #ffffff !important;
+    display: flex;
+    flex-direction: row;
+    align-items: center;
+    border: none !important;
+    box-shadow: 0px 1px 2px rgba(16, 24, 40, 0.05);
+    padding: 0.4rem;
+    width: 8.4875rem;
+    font-size: 0.8125rem;
+    font-weight: 400;
+    line-height: 1.234rem;
+    height: 2.25rem;
+
+    &:hover:not(:disabled) {
+      color: #000000;
+    }
+
+    svg {
+      margin-right: 0.4075rem;
+    }
+  }
+}
+
+.tippy_box_color {
+  margin-left: 2rem;
+  background-color: #000 !important;
+  border: none;
+  height: 1.875rem;
+  border-radius: 0.75rem;
+  margin-top: -0.5rem;
+}
+
+:global(.tippy-arrow) {
+  transform: translateX(12px) !important;
+}
+
+:global(.tippy-content) {
+  padding: 0.5rem;
+  text-align: center;
+  font-size: 0.875rem;
+  font-weight: 600;
+  color: #ffffff;
+}
+
+/* Global styles  */
+:global {
+  .search-filter-form {
+    display: flex;
+    flex-direction: column;
+    width: 100%;
+    gap: 2.25rem;
+    padding: 1.75rem 1.75rem 0rem 1.75rem;
+    min-height: 17.687rem;
+    transition: min-height 0.3s ease;
+    &.expanded {
+      min-height: 34.375rem;
+    }
+  }
+
+  .search-filter-form.expanded {
+    min-height: 34.375rem;
+  }
+
+  .search-filter-form__header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: 0.5rem;
+  }
+
+  .search-filter-form__header__title {
+    font-size: 1.25rem;
+    font-weight: 400;
+    line-height: 1.75rem;
+    color: #9ca1aa;
+    margin: 0;
+  }
+
+  .search-filter-form__header svg {
+    cursor: pointer;
+  }
+
+  .name-input {
+    // border-color: #bbbec5 !important;
+    width: 27.875rem;
+    height: 2.5rem;
+    border-radius: 0.5rem;
+    border: 0.0625rem solid #bbbec5;
+    padding-top: 0.5rem;
+    padding-bottom: 0.5rem;
+
+    > div.inputWrapper {
+      border: 0px !important;
+    }
+  }
+
+  .methodList {
+    width: 27.875rem;
+    border-radius: 0.5rem;
+    border: 0.0625rem solid #f0f1f2;
+
+    .method-item {
+      display: flex;
+      flex-direction: row;
+      justify-content: flex-start;
+      align-items: center;
+      gap: 0.5rem;
+      padding-left: 0.75rem;
+      padding-right: 0.75rem;
+      padding-top: 0.5rem;
+      border-radius: 0.5rem;
+      padding-bottom: 0.5rem;
+      border-bottom: 1px solid #f0f1f2;
+      span {
+        font-weight: 400;
+        font-size: 0.875rem;
+      }
+      input {
+        cursor: pointer;
+        width: 1.25rem;
+        height: 1.25rem;
+        border-radius: 0.25rem;
+        border: 1px solid #64748b;
+      }
+    }
+  }
+
+  .method-container {
+    display: flex;
+    flex-direction: column;
+    gap: 0.5rem;
+    position: relative;
+    z-index: 10;
+
+    .typeDdl {
+      cursor: pointer;
+      width: 27.875rem;
+      height: 2.5rem;
+      border-radius: 0.5rem;
+      border: 0.0625rem solid #bbbec5;
+      padding-top: 0.5rem;
+      padding-bottom: 0.5rem;
+      padding-left: 1.3rem;
+      padding-right: 0.75rem;
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+
+      span {
+        font-weight: 400;
+        font-size: 0.875rem;
+        color: #8390a2;
+      }
+    }
+  }
+
+  .method-container label {
+    font-size: 0.75rem;
+    font-weight: 400;
+    color: #000000;
+  }
+
+  #react-select-menu-portal {
+    z-index: 9999 !important;
+  }
+
+  .button-container {
+    display: flex;
+    justify-content: center;
+    width: 100%;
+    padding-top: 0 !important;
+    padding: 1.5rem 0;
+  }
+
+  .dialog-submit-btn {
+    width: 100% !important;
+    background-color: #4d75d9 !important;
+    color: white !important;
+    border-radius: 0.5rem !important;
+    height: 2.25rem !important;
+    box-shadow: 1px 1px 0.25rem 0px #00000040 inset !important;
+    font-weight: 400;
+  }
+
+  .close-icon {
+    position: absolute !important;
+    top: 3.2rem !important;
+    right: 3rem !important;
+    cursor: pointer !important;
+  }
+  .custom-select-border > div {
+    border: 1px solid #f0f1f2 !important;
+    border-radius: 0.5rem !important;
+  }
+  .multiSelectGroup .optionsList .option {
+    border-top: 1px solid #f0f1f2 !important;
+  }
+  .multiSelectGroup .optionsList .optionsContainer.optionsContainerWithSearch {
+    max-height: 56.25rem !important;
+  }
+  .inputContainer .inputWrapper {
+    border: 1px solid #f0f1f2 !important;
+  }
+  .rootContentWrapper {
+    opacity: 1 !important;
+    backdrop-filter: blur(0.5rem);
+    background-color: rgba(0, 0, 0, 0.281) !important;
+  }
+}

package/src/layout/docsComponents/DocsHeader/DocsHeader.tsx

@@ -0,0 +1,156 @@
+import React, { useState, useRef } from 'react'
+import { Button, Size, Input, SelectGroup } from 'digitinary-ui'
+import SVGLoader from '../../../components/SVGLoader/SVGLoader'
+import {
+  FilterIcon,
+  BookIcon,
+  ApiIcon,
+  SearchIcon,
+  arrowDownGray,
+  UpArrowIcon,
+  DownArrowIcon,
+} from '../../../assets/icons'
+import Tooltip from '../../../components/Tooltip/Tooltip'
+import CommonDialog from '../../../components/dialog/index'
+import { METHOD_OPTIONS } from '../../../constants/methods.constant'
+import styles from './DocsHeader.module.scss'
+
+const DocsHeader: React.FC = () => {
+  const [showSearchFilter, setShowSearchFilter] = useState<boolean>(false)
+  const [apiName, setApiName] = useState<string>('')
+  const [selectedMethods, setSelectedMethods] = useState<any[]>([])
+  const [methodListOpened, setMethodListOpened] = useState(false)
+  const [isMethodDropdownOpen, setIsMethodDropdownOpen] = useState<boolean>(false)
+  const selectRef = useRef<any>(null)
+
+  const handleOpenSearchFilter = (): void => {
+    setShowSearchFilter(true)
+  }
+
+  const handleCloseSearchFilter = (): void => {
+    setShowSearchFilter(false)
+    setIsMethodDropdownOpen(false)
+  }
+
+  const handleApplyFilters = (): void => {
+    setShowSearchFilter(false)
+  }
+
+  const handleCheckMethod = (e, method: (typeof METHOD_OPTIONS)[0]) => {
+    const {
+      target: { checked },
+    } = e
+    if (checked) {
+      setSelectedMethods((prev) => [...prev, method.value])
+    } else {
+      if (selectedMethods.includes(method.value)) {
+        setSelectedMethods((prev) => prev.filter((_m) => _m != method.value))
+      }
+    }
+  }
+
+  return (
+    <>
+      <header className={styles.api_docs_header}>
+        <div className={styles.header_content}>
+          <Button
+            variant="outlined"
+            size="small"
+            className={styles.search_filter_btn}
+            onClick={handleOpenSearchFilter}
+          >
+            Search & Filter
+            <SVGLoader src={FilterIcon} />
+          </Button>
+          <div className={styles.nav_buttons}>
+            <Tooltip
+              placement="bottom"
+              delay={[0, 0]}
+              className={`guides-tooltip ${styles.tippy_box_color}`}
+              content={<div>Coming Soon</div>}
+            >
+              <Button variant="outlined" size="small" className="guide-btn" disabled={true}>
+                <SVGLoader src={BookIcon} />
+                GUIDES
+              </Button>
+            </Tooltip>
+            <Button variant="outlined" size="small" className={styles.api_btn}>
+              <SVGLoader src={ApiIcon} /> &nbsp; API reference
+            </Button>
+          </div>
+        </div>
+      </header>
+      <CommonDialog
+        size="sm"
+        open={showSearchFilter}
+        onClose={handleCloseSearchFilter}
+        icon={false}
+        withClose={false}
+        noActions
+        content={
+          <div className={`search-filter-form ${isMethodDropdownOpen ? 'expanded' : ''}`}>
+            <div className="search-filter-form__header">
+              <p className="search-filter-form__header__title">Search & Filter</p>
+            </div>
+            <Input
+              className="name-input"
+              placeholder="Search by API name"
+              value={apiName}
+              onChange={(value) => setApiName(value as string)}
+              size={Size.Medium}
+              clearable
+              endAdornment={<SVGLoader src={SearchIcon} />}
+            />
+            <div className="method-container">
+              <label>Method</label>
+              {/* <SelectGroup
+                isMultiple={true}
+                size={Size.Medium}
+                placeholder="Select Method"
+                value={selectedMethods}
+                onChange={(value) => setSelectedMethods(value || [])}
+                options={[
+                  
+                ]}
+                withSearch={false}
+                className="method-select custom-select-border"
+              /> */}
+              <div className="typeDdl" onClick={() => setIsMethodDropdownOpen((prev) => !prev)}>
+                <span>Select Method</span>
+                <SVGLoader src={!isMethodDropdownOpen ? DownArrowIcon : UpArrowIcon} />
+              </div>
+              {isMethodDropdownOpen && (
+                <div className="methodList">
+                  {METHOD_OPTIONS.map((_m) => (
+                    <div className="method-item">
+                      <input
+                        type="checkbox"
+                        className="agreement-checkbox"
+                        checked={selectedMethods.includes(_m.value)}
+                        onChange={(e) => handleCheckMethod(e, _m)}
+                      />
+                      <span style={{ color: _m.color }}>{_m.label}</span>
+                    </div>
+                  ))}
+                </div>
+              )}
+            </div>
+            <div className="button-container">
+              <Button
+                variant="contained"
+                color="primary"
+                size="large"
+                onClick={handleApplyFilters}
+                className="dialog-submit-btn"
+              >
+                Apply
+              </Button>
+            </div>
+          </div>
+        }
+      />
+    </>
+  )
+}
+
+export default DocsHeader

package/src/layout/docsComponents/DocsSideMenuTree/DocsSideMenuTree.tsx

@@ -0,0 +1,188 @@
+import './style.scss'
+import React, { useState } from 'react'
+import SVGLoader from '../../../components/SVGLoader/SVGLoader'
+import { arrowDownGray, arrowRightGray, document, eye } from '../../../assets/icons'
+
+const DocsSideMenuTree = ({
+  apis,
+  setActiveItemData,
+  isFirstApiExpanded,
+  setIsFirstApiExpanded,
+  setActiveType,
+}) => {
+  const [expandedSections, setExpandedSections] = useState({})
+
+  const toggleSection = (apiId, sectionId: string, resetOthers?: boolean, key?: string[]) => {
+    isFirstApiExpanded && setIsFirstApiExpanded(false)
+    if (resetOthers && key) {
+      const filteredExpandedSections = Object.fromEntries(
+        Object.entries({ ...expandedSections }).filter(([expandKey, _]) => {
+          // Close other APIs sections
+          if (!expandKey.includes(apiId)) return false
+          // always return the clicked on section
+          else if (expandKey === sectionId) return true
+          // filter all sections containing the key
+          else if (key.some((k) => expandKey.includes(k))) return false
+          else return true
+        })
+      )
+
+      setExpandedSections({
+        ...filteredExpandedSections,
+        [sectionId]: !expandedSections[sectionId],
+      })
+    } else {
+      setExpandedSections((prev) => ({
+        ...prev,
+        [sectionId]: !prev[sectionId],
+      }))
+    }
+  }
+
+  const renderEndpoints = (endpoints, api) => {
+    return endpoints.map((endpoint, index) => {
+      const isResourceExpanded = expandedSections[`api-${api.id}-resource-${endpoint.id}`]
+
+      return (
+        <div
+          key={index}
+          className={`api-docs-api-tree__endpoint api-docs-api-tree__endpoint--${endpoint.method.toLowerCase()}`}
+          onClick={() => {
+            if (!isResourceExpanded) {
+              setActiveItemData({
+                ...endpoint,
+                api: {
+                  id: api.id,
+                  title: api.title,
+                  description: api.description,
+                  version: api.version,
+                },
+              })
+              setActiveType('ENDPOINT')
+              toggleSection(api.id, `api-${api.id}-resource-${endpoint.id}`, true, [
+                'resource',
+                'overview',
+              ])
+            }
+          }}
+          data-active={isResourceExpanded}
+        >
+          <span className="api-docs-api-tree__endpoint-method">{endpoint.method}</span>
+          <span className="api-docs-api-tree__endpoint-name">{endpoint.path}</span>
+        </div>
+      )
+    })
+  }
+
+  const renderApiSection = (api, index) => {
+    const isApiExpanded = expandedSections[`api-${api.id}-section`]
+    const isEndpointActive = Object.keys(expandedSections).some((k) =>
+      k.includes(`api-${api.id}-resource`)
+    )
+    const isEndpointsExpanded = expandedSections[`api-${api.id}-endpoints`]
+    const isOverviewExpanded = expandedSections[`api-${api.id}-overview`]
+
+    if (isFirstApiExpanded && index === 0 && !isApiExpanded) {
+      toggleSection(api.id, `api-${api.id}-section`)
+      toggleSection(api.id, `api-${api.id}-overview`)
+      setActiveItemData(api)
+      setActiveType('OVERVIEW')
+    }
+
+    return (
+      <div
+        key={api.id}
+        className="api-docs-api-tree__section"
+        data-active={isEndpointActive || isOverviewExpanded}
+      >
+        <div
+          className="api-docs-api-tree__section-header"
+          onClick={() => toggleSection(api.id, `api-${api.id}-section`)}
+        >
+          {isApiExpanded ? <SVGLoader src={arrowDownGray} /> : <SVGLoader src={arrowRightGray} />}
+          <SVGLoader src={document} />
+          <span className="api-docs-api-tree__section-title">{api.title}</span>
+        </div>
+
+        {isApiExpanded && (
+          <>
+            <div
+              className={`api-docs-api-tree__section__overview`}
+              onClick={() => {
+                if (!isOverviewExpanded) {
+                  toggleSection(api.id, `api-${api.id}-overview`, true, ['resource'])
+                  setActiveItemData(api)
+                  setActiveType('OVERVIEW')
+                }
+              }}
+              data-active={isOverviewExpanded}
+            >
+              {<SVGLoader src={eye} />}
+              <span>Overview</span>
+            </div>
+            <div
+              className="api-docs-api-tree__section__endpoints"
+              onClick={() => {
+                toggleSection(api.id, `api-${api.id}-endpoints`)
+              }}
+              data-active={isEndpointActive && !isOverviewExpanded}
+            >
+              {isEndpointsExpanded ? (
+                <SVGLoader src={arrowDownGray} />
+              ) : (
+                <SVGLoader src={arrowRightGray} />
+              )}
+              <span>Endpoints</span>
+            </div>
+            {isEndpointsExpanded && (
+              <div className="api-docs-api-tree__subsections">
+                {Object.entries(api.tags)
+                  .sort(([a], [b]) => {
+                    if (a === 'default') return 1
+                    if (b === 'default') return -1
+                    return a.localeCompare(b)
+                  })
+                  .map(([tagName, data], index) => renderSubSection(tagName, data, api, index))}
+              </div>
+            )}
+          </>
+        )}
+      </div>
+    )
+  }
+
+  const renderSubSection = (tagName, data, api, sectionIndex) => {
+    const sectionKey = `api-${api.id}-section-${sectionIndex}`
+    const isSectionExpanded = expandedSections[sectionKey]
+
+    return (
+      <div key={sectionKey} className="api-docs-api-tree__subsection">
+        <>
+          <div
+            className="api-docs-api-tree__subsection-header"
+            onClick={() => toggleSection(api.id, sectionKey)}
+          >
+            {isSectionExpanded ? (
+              <SVGLoader src={arrowDownGray} />
+            ) : (
+              <SVGLoader src={arrowRightGray} />
+            )}
+            <span className="api-docs-api-tree__subsection-title">{tagName}</span>
+          </div>
+
+          {isSectionExpanded && (
+            <div className="api-docs-api-tree__endpoints">{renderEndpoints(data, api)}</div>
+          )}
+        </>
+      </div>
+    )
+  }
+
+  return (
+    <aside className="api-docs-api-tree">
+      {apis.map((api, index) => renderApiSection(api, index))}
+    </aside>
+  )
+}
+
+export default DocsSideMenuTree