Skip to main content

vocs

Vocs formatter for GraphQL documentation output.

Produces MDX compatible with Vite/Vocs using its native callout syntax and Material UI Chip components for badges.

mdxDeclaration​

const mdxDeclaration: MDXString;

Defined in: vocs/index.ts:28

MDX import statement and inline component definitions prepended to every generated file.

mdxExtension​

const mdxExtension: ".mdx";

Defined in: vocs/index.ts:35

File extension used for generated pages.

createMDXFormatter()​

function createMDXFormatter(_meta?): Formatter;

Defined in: vocs/index.ts:111

Creates a Vocs formatter.

Parameters​

_meta?​

Maybe<MetaInfo>

Unused metadata parameter

Returns​

Formatter

A complete Formatter implementation for Vocs MDX output

formatMDXAdmonition()​

function formatMDXAdmonition(admonition, _meta): MDXString;

Defined in: vocs/index.ts:55

Formats an admonition using Vocs native callout syntax (:::type[title]). Maps warning type to warning; all other types use info.

Parameters​

admonition​

AdmonitionType

Admonition data with text, title, and type

_meta​

Maybe<MetaInfo>

Unused metadata parameter

Returns​

MDXString

Formatted Vocs callout string

formatMDXBadge()​

function formatMDXBadge(badge): MDXString;

Defined in: vocs/index.ts:43

Formats a badge using the Material UI <Chip> component. Maps DEPRECATED classname to warning color; all others use info.

Parameters​

badge​

Badge

Badge data containing text and optional classname

Returns​

MDXString

Formatted MUI Chip component string

formatMDXBullet()​

function formatMDXBullet(text?): MDXString;

Defined in: vocs/index.ts:68

Formats a bullet point using the inline <Bullet/> component defined in mdxDeclaration.

Parameters​

text?​

string = ""

Optional text to append after the bullet

Returns​

MDXString

Formatted Bullet component string

function formatMDXLink(link): TypeLink;

Defined in: vocs/index.ts:77

Appends .mdx to internal link URLs.

Parameters​

TypeLink

Link data with URL and text

Returns​

TypeLink

Link with .mdx extension appended to the URL

formatMDXNameEntity()​

function formatMDXNameEntity(name, parentType?): MDXString;

Defined in: vocs/index.ts:90

Formats a named entity as a JSX span with styled code elements.

Parameters​

name​

string

Entity name

parentType?​

Maybe<string>

Optional parent type name for qualified references

Returns​

MDXString

Formatted JSX entity reference string