@digi-frontend/dgate-api-documentation 1.0.1 → 1.0.5

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

@@ -1,187 +0,0 @@
-import React, { useState, useRef } from 'react'
-import { Button, Size, Input } from 'digitinary-ui'
-import SVGLoader from '../../../components/SVGLoader/SVGLoader'
-import {
-  FilterIcon,
-  BookIcon,
-  ApiIcon,
-  SearchIcon,
-  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'
-import { OverviewData } from '../../../../src/layout/docsLayout'
-
-const DocsHeader = ({
-  transformedOpenApis,
-  updateFilteredData,
-}: {
-  transformedOpenApis: OverviewData[]
-  updateFilteredData: (filteredItems: OverviewData[], isReset?: boolean) => void
-}) => {
-  const [showSearchFilter, setShowSearchFilter] = useState<boolean>(false)
-  const [apiName, setApiName] = useState<string>('')
-  const [selectedMethods, setSelectedMethods] = useState<any[]>([])
-  const [isMethodDropdownOpen, setIsMethodDropdownOpen] = useState<boolean>(false)
-
-  const handleOpenSearchFilter = (): void => {
-    setShowSearchFilter(true)
-  }
-
-  const handleCloseSearchFilter = (): void => {
-    setShowSearchFilter(false)
-    setIsMethodDropdownOpen(false)
-  }
-
-  const handleApplyFilters = (): void => {
-    // Reset: no filters applied
-    if (!apiName?.trim() && (!selectedMethods || selectedMethods.length === 0)) {
-      updateFilteredData(transformedOpenApis, true)
-      setShowSearchFilter(false)
-      return
-    }
-
-    let filteredItems = [...transformedOpenApis]
-
-    // Filter by API name
-    if (apiName?.trim()) {
-      const lowerApiName = apiName.toLowerCase()
-      filteredItems = filteredItems.filter((api) => api.title.toLowerCase().includes(lowerApiName))
-    }
-
-    // Filter by selected HTTP methods
-    if (selectedMethods?.length) {
-      filteredItems = filteredItems.filter((api) => {
-        const allMethods = Object.values(api.tags || {})
-          .flat()
-          .map((endpoint: any) => endpoint.method?.toLowerCase())
-
-        return selectedMethods.some((method) => allMethods.includes(method.toLowerCase()))
-      })
-    }
-
-    updateFilteredData(filteredItems)
-    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

@@ -1,229 +0,0 @@
-import './style.scss'
-import React, { useEffect, useRef } from 'react'
-import SVGLoader from '../../../components/SVGLoader/SVGLoader'
-import { arrowDownGray, arrowRightGray, document, eye } from '../../../assets/icons'
-import { EndpointData, OverviewData } from 'src/layout/docsLayout'
-import { SectionEnum, useSectionToggle } from '../../../../src/context/SectionToggleContext'
-
-const DocsSideMenuTree = ({
-  apis,
-  setActiveItemData,
-  isFirstApiExpanded,
-  setIsFirstApiExpanded,
-  setActiveType,
-  canSelectFirstApi,
-  canFocusSection,
-  setCanFocusSection,
-  activeApiId,
-  setCanSelectFirstApi,
-}: {
-  apis: OverviewData[]
-  setActiveItemData: React.Dispatch<React.SetStateAction<OverviewData | EndpointData>>
-  activeItemData: OverviewData | EndpointData
-  isFirstApiExpanded: boolean
-  setIsFirstApiExpanded: React.Dispatch<React.SetStateAction<boolean>>
-  setActiveType: React.Dispatch<React.SetStateAction<'OVERVIEW' | 'ENDPOINT'>>
-  activeType: 'OVERVIEW' | 'ENDPOINT'
-  canSelectFirstApi?: boolean
-  canFocusSection: boolean
-  setCanFocusSection: React.Dispatch<React.SetStateAction<boolean>>
-  activeApiId: string
-  setCanSelectFirstApi: React.Dispatch<React.SetStateAction<boolean>>
-}) => {
-  const { expandedSections, toggleSection, generateSectionKey } = useSectionToggle()
-  const sectionRefs = useRef<Record<string, HTMLDivElement | null>>({})
-
-  // Auto-expand first API only once
-  useEffect(() => {
-    if (canSelectFirstApi || !apis?.length || !isFirstApiExpanded) return
-
-    const firstApi = apis[0]
-    toggleSection(firstApi?.apiSpecId, [
-      { type: SectionEnum.API_SECTION, setTo: true },
-      { type: SectionEnum.OVERVIEW, setTo: true },
-    ])
-
-    setActiveItemData(firstApi)
-    setActiveType('OVERVIEW')
-    setIsFirstApiExpanded(false)
-  }, [apis, isFirstApiExpanded])
-
-  useEffect(() => {
-    const activeApi = apis?.find((api) => api.apiSpecId === activeApiId)
-    if (activeApiId && apis.length > 0 && !!activeApi) {
-      toggleSection(activeApi.apiSpecId, [
-        { type: SectionEnum.API_SECTION, setTo: true },
-        { type: SectionEnum.OVERVIEW, setTo: true },
-      ])
-
-      setActiveItemData(activeApi)
-      setActiveType('OVERVIEW')
-      setIsFirstApiExpanded(false)
-      setCanSelectFirstApi(true)
-      setCanFocusSection(true)
-    }
-  }, [activeApiId, apis])
-
-  const renderEndpoints = (endpoints: EndpointData[], api: OverviewData) =>
-    endpoints.map((endpoint, index) => {
-      const key = generateSectionKey({
-        apiId: api.apiSpecId,
-        type: SectionEnum.RESOURCE,
-        id: endpoint.id,
-      })
-      const isExpanded = expandedSections[key]
-
-      return (
-        <div
-          key={index}
-          className={`api-docs-api-tree__endpoint api-docs-api-tree__endpoint--${endpoint.method.toLowerCase()}`}
-          onClick={() => {
-            if (!isExpanded) {
-              setActiveItemData({
-                ...endpoint,
-                api,
-              })
-              setActiveType('ENDPOINT')
-              toggleSection(api.apiSpecId, [{ type: SectionEnum.RESOURCE, id: endpoint.id }], {
-                resetOthers: true,
-                filterKeys: [SectionEnum.RESOURCE, SectionEnum.OVERVIEW],
-              })
-            }
-          }}
-          data-active={isExpanded}
-        >
-          <span className="api-docs-api-tree__endpoint-method">{endpoint.method}</span>
-          <span className="api-docs-api-tree__endpoint-name">{endpoint.path}</span>
-        </div>
-      )
-    })
-
-  const renderSubSection = (
-    tagName: string,
-    data: EndpointData[],
-    api: OverviewData,
-    sectionIndex: number
-  ) => {
-    const sectionKey = generateSectionKey({
-      apiId: api.apiSpecId,
-      type: SectionEnum.TAG_SECTION,
-      index: 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.apiSpecId, [{ type: SectionEnum.TAG_SECTION, index: sectionIndex }])
-          }
-        >
-          {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>
-    )
-  }
-
-  const renderApiSection = (api: OverviewData) => {
-    const sectionKey = generateSectionKey({ apiId: api.apiSpecId, type: SectionEnum.API_SECTION })
-    const endpointsKey = generateSectionKey({
-      apiId: api.apiSpecId,
-      type: SectionEnum.ENDPOINTS_SECTION,
-    })
-    const overviewKey = generateSectionKey({ apiId: api.apiSpecId, type: SectionEnum.OVERVIEW })
-
-    const isApiExpanded = expandedSections[sectionKey]
-    const isEndpointActive = expandedSections[endpointsKey]
-    const isOverviewExpanded = expandedSections[overviewKey]
-    // Scroll to the section if it's expanded
-    if (canFocusSection) {
-      const sectionEl = sectionRefs.current[api.apiSpecId]
-      sectionEl?.scrollIntoView({ behavior: 'smooth', block: 'start' })
-      setCanFocusSection(false)
-    }
-
-    return (
-      <div
-        key={api.apiSpecId}
-        className="api-docs-api-tree__section"
-        data-active={isEndpointActive || isOverviewExpanded}
-        ref={(el) => {
-          sectionRefs.current[api.apiSpecId] = el
-        }}
-      >
-        <div
-          className="api-docs-api-tree__section-header"
-          onClick={() => toggleSection(api.apiSpecId, [{ type: SectionEnum.API_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.apiSpecId, [{ type: SectionEnum.OVERVIEW }], {
-                    resetOthers: true,
-                    filterKeys: [SectionEnum.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.apiSpecId, [{ type: SectionEnum.ENDPOINTS_SECTION }])
-              }
-              data-active={isEndpointActive && !isOverviewExpanded}
-            >
-              {expandedSections[endpointsKey] ? (
-                <SVGLoader src={arrowDownGray} />
-              ) : (
-                <SVGLoader src={arrowRightGray} />
-              )}
-              <span>Endpoints</span>
-            </div>
-
-            {expandedSections[endpointsKey] && (
-              <div className="api-docs-api-tree__subsections">
-                {Object.entries(api.tags)
-                  .filter(([, endpoints]) => endpoints.length > 0)
-                  .sort(([a], [b]) =>
-                    a === 'default' ? 1 : b === 'default' ? -1 : a.localeCompare(b)
-                  )
-                  .map(([tagName, data], i) =>
-                    renderSubSection(tagName, data as EndpointData[], api, i)
-                  )}
-              </div>
-            )}
-          </>
-        )}
-      </div>
-    )
-  }
-
-  return <aside className="api-docs-api-tree">{apis.map((api) => renderApiSection(api))}</aside>
-}
-
-export default DocsSideMenuTree

package/src/layout/docsComponents/DocsSideMenuTree/style.scss

@@ -1,195 +0,0 @@
-.api-docs-api-tree {
-  width: 100%;
-  max-width: 12.5rem;
-  padding: 3rem 1.25rem;
-  box-sizing: border-box;
-
-  > * {
-    box-sizing: border-box;
-  }
-
-  &__section {
-    &-header {
-      display: flex;
-      align-items: center;
-      gap: 0.25rem;
-      padding-inline: 0.5rem;
-      cursor: pointer;
-      user-select: none;
-      height: 2.5rem;
-
-      &:hover {
-        background-color: #f3f4f6;
-      }
-
-      svg:first-child {
-        path {
-          stroke: #bbbec5;
-        }
-      }
-    }
-
-    &-title {
-      font-size: 0.75rem;
-      line-height: 0.875rem;
-      font-weight: 500;
-      color: #000;
-      margin-left: 0.25rem;
-    }
-
-    &__overview {
-      display: flex;
-      align-items: center;
-      gap: 0.5rem;
-      padding: 0.5rem 1.75rem;
-      border-radius: 0.25rem;
-      cursor: pointer;
-
-      &:hover {
-        background-color: #f3f4f6;
-      }
-
-      span {
-        font-size: 0.75rem;
-        line-height: 0.875rem;
-        color: #000000;
-      }
-
-      &[data-active='true'] {
-        background-color: #f0f1f2;
-      }
-    }
-
-    &__endpoints {
-      display: flex;
-      align-items: center;
-      height: 1.5rem;
-      gap: 0.5rem;
-      border-radius: 0.25rem;
-      padding-inline: 1.75rem;
-      cursor: pointer;
-
-      span {
-        font-size: 0.75rem;
-        line-height: 0.875rem;
-        color: #000000;
-      }
-
-      &[data-active='true'] {
-        background-color: #f0f1f2;
-      }
-    }
-
-    &[data-active='true'] {
-      .api-docs-api-tree__section-title {
-        color: #616874;
-      }
-    }
-  }
-
-  &__endpoints {
-    display: flex;
-    flex-direction: column;
-    align-items: start;
-    gap: 0.5rem;
-    border-radius: 0.25rem;
-
-    cursor: pointer;
-
-    span {
-      font-size: 0.75rem;
-      line-height: 0.875rem;
-      color: #000000;
-    }
-
-    &[data-active='true'] {
-      background-color: #f0f1f2;
-    }
-  }
-
-  &__subsection {
-    &-header {
-      height: 2rem;
-      display: flex;
-      align-items: center;
-      gap: 0.875rem;
-      padding-inline: 0.5rem;
-      cursor: pointer;
-      user-select: none;
-
-      svg {
-        color: #6b7280;
-      }
-    }
-
-    &-title {
-      font-size: 0.75rem;
-      line-height: 0.875rem;
-      color: #616874;
-    }
-  }
-
-  &__endpoint {
-    display: flex;
-    align-items: center;
-    gap: 0.25rem;
-    padding: 0.5rem 0.75rem;
-    text-transform: capitalize;
-    width: 100%;
-    cursor: pointer;
-
-    &[data-active='true'] {
-      background-color: #f0f1f2;
-    }
-
-    &:hover {
-      background-color: #f3f4f6;
-    }
-
-    &-method {
-      font-size: 0.75rem;
-      line-height: 0.875rem;
-      font-weight: 400;
-      text-align: start;
-    }
-
-    &-name {
-      font-size: 0.75rem;
-      line-height: 0.875rem;
-      color: #3b3f46;
-      display: -webkit-box;
-      -webkit-box-orient: vertical;
-      -webkit-line-clamp: 1;
-      overflow: hidden;
-      text-overflow: ellipsis;
-    }
-
-    &--get .api-docs-api-tree__endpoint-method {
-      color: #3a6cd1;
-    }
-
-    &--post .api-docs-api-tree__endpoint-method {
-      color: #3aaa35;
-    }
-
-    &--put .api-docs-api-tree__endpoint-method {
-      color: #faad14;
-    }
-
-    &--delete .api-docs-api-tree__endpoint-method {
-      color: #da3f3f;
-    }
-
-    &--option .api-docs-api-tree__endpoint-method {
-      color: #495d97;
-    }
-
-    &--head .api-docs-api-tree__endpoint-method {
-      color: #9461c9;
-    }
-
-    &--patch .api-docs-api-tree__endpoint-method {
-      color: #58e2c2;
-    }
-  }
-}

package/src/layout/docsComponents/index.scss

@@ -1,49 +0,0 @@
-.api-docs-layout {
-  @import url('https://fonts.googleapis.com/css2?family=Cascadia+Code:ital,wght@0,200..700;1,200..700&display=swap');
-
-  display: grid;
-  height: 100vh;
-  max-height: 100%;
-  width: 100%;
-  overflow: hidden;
-  grid-template: 2.625rem auto / 12.5rem 1fr auto;
-  padding: 0 !important;
-
-  * {
-    scrollbar-width: thin;
-    scrollbar-color: #bbbec5 #d1d3d8;
-    scroll-behavior: smooth;
-  }
-
-  aside.api-docs-api-tree {
-    grid-row: 2;
-    grid-column: 1;
-    border-right: 1px solid #bbbec5;
-    background-color: white;
-  }
-
-  aside.api-docs-aside {
-    grid-row: 2;
-    grid-column: 3;
-    width: 22.5rem;
-    max-width: 22.5rem;
-    overflow-x: clip;
-  }
-
-  aside,
-  main {
-    max-height: 100%;
-    overflow: auto;
-  }
-
-  header {
-    grid-column: 1 / -1;
-    border-bottom: 1px solid #bbbec5;
-  }
-
-  main {
-    grid-row: 2;
-    grid-column: 2;
-    background-color: white;
-  }
-}

package/src/layout/docsComponents/index.tsx

@@ -1,28 +0,0 @@
-import React from 'react'
-import DocsHeader from './DocsHeader/DocsHeader'
-import DocsSideMenuTree from './DocsSideMenuTree/DocsSideMenuTree'
-import DocsContent from './DocsContent/DocsContent'
-import DocsAside from './DocsAside/DocsAside'
-import './index.scss'
-
-type LayoutProps = {
-  children: React.ReactNode
-}
-
-type CompoundLayout = React.FC<LayoutProps> & {
-  DocsHeader: typeof DocsHeader
-  DocsSideMenuTree: typeof DocsSideMenuTree
-  DocsContent: typeof DocsContent
-  DocsAside: typeof DocsAside
-}
-
-const Layout = (({ children }: LayoutProps) => {
-  return <div className="api-docs-layout">{children}</div>
-}) as CompoundLayout
-
-Layout.DocsHeader = DocsHeader
-Layout.DocsSideMenuTree = DocsSideMenuTree
-Layout.DocsContent = DocsContent
-Layout.DocsAside = DocsAside
-
-export default Layout