1import React, { useContext } from 'react'; 2 3import DocumentationPageContext from '~/components/DocumentationPageContext'; 4import { P } from '~/components/base/paragraph'; 5import { GeneratedData } from '~/components/plugins/api/APIDataTypes'; 6import APISectionConstants from '~/components/plugins/api/APISectionConstants'; 7import APISectionEnums from '~/components/plugins/api/APISectionEnums'; 8import APISectionInterfaces from '~/components/plugins/api/APISectionInterfaces'; 9import APISectionMethods from '~/components/plugins/api/APISectionMethods'; 10import APISectionProps from '~/components/plugins/api/APISectionProps'; 11import APISectionTypes from '~/components/plugins/api/APISectionTypes'; 12import { TypeDocKind } from '~/components/plugins/api/APISectionUtils'; 13 14const LATEST_VERSION = `v${require('~/package.json').version}`; 15 16type Props = { 17 packageName: string; 18 apiName?: string; 19}; 20 21const filterDataByKind = ( 22 entries: GeneratedData[], 23 kind: TypeDocKind, 24 additionalCondition: (entry: GeneratedData) => boolean = () => true 25) => 26 entries 27 ? entries.filter((entry: GeneratedData) => entry.kind === kind && additionalCondition(entry)) 28 : []; 29 30const renderAPI = ( 31 packageName: string, 32 version: string = 'unversioned', 33 apiName?: string 34): JSX.Element => { 35 try { 36 const data = require(`~/public/static/data/${version}/${packageName}.json`).children; 37 38 const methods = filterDataByKind(data, TypeDocKind.Function); 39 const types = filterDataByKind( 40 data, 41 TypeDocKind.TypeAlias, 42 entry => !!(entry.type.declaration || entry.type.types) 43 ); 44 const props = filterDataByKind(data, TypeDocKind.TypeAlias, entry => 45 entry.name.includes('Props') 46 ); 47 const defaultProps = filterDataByKind( 48 data 49 .filter((entry: GeneratedData) => entry.kind === TypeDocKind.Class) 50 .map((entry: GeneratedData) => entry.children) 51 .flat(), 52 TypeDocKind.Property, 53 entry => entry.name === 'defaultProps' 54 )[0]; 55 const enums = filterDataByKind(data, TypeDocKind.Enum); 56 const interfaces = filterDataByKind(data, TypeDocKind.Interface); 57 const constants = filterDataByKind(data, TypeDocKind.Variable, entry => entry.flags.isConst); 58 59 return ( 60 <> 61 <APISectionConstants data={constants} apiName={apiName} /> 62 <APISectionMethods data={methods} apiName={apiName} /> 63 <APISectionProps data={props} defaultProps={defaultProps} /> 64 <APISectionTypes data={types} /> 65 <APISectionInterfaces data={interfaces} /> 66 <APISectionEnums data={enums} /> 67 </> 68 ); 69 } catch (error) { 70 return <P>No API data file found, sorry!</P>; 71 } 72}; 73 74const APISection: React.FC<Props> = ({ packageName, apiName }) => { 75 const { version } = useContext(DocumentationPageContext); 76 const resolvedVersion = 77 version === 'unversioned' ? version : version === 'latest' ? LATEST_VERSION : version; 78 return renderAPI(packageName, resolvedVersion, apiName); 79}; 80 81export default APISection; 82