@chargeover/docusaurus-theme-redoc/src/types/common.d.ts

Redoc Component for DocusaurusV2

import type { Props as LayoutProps } from '@theme/Layout';
import type { ObjectDescriptionProps } from '@chargeover/redoc';
import type { OpenAPISpec } from '@chargeover/redoc/typings/types';

export type ParsedSpec = OpenAPISpec;

export interface SpecProps {
  spec: ParsedSpec;
  url?: string;
  themeId?: string;
}

export type RedocProps = SpecProps;

export interface MdxProps {
  /**
   * If you have multiple apis, then add a `id` field in the specs array
   * And pass the same here
   */
  id?: string;
}

export type ApiSchemaProps = Omit<
  ObjectDescriptionProps,
  'parser' | 'options' | 'schemaRef'
> &
  MdxProps & {
    /**
     * Show the example or not
     */
    example?: boolean;
    /**
     * Ref to the schema
     */
    pointer: ObjectDescriptionProps['schemaRef'];
  };

export type ApiDocProps = {
  specProps: SpecProps;
  layoutProps?: Omit<LayoutProps, 'children'>;
};