schlechtenburg/packages/docgen/support/generate-pkg-md.mjs

const getTypeParamString = (params) => `<${params.map(p => p.name).join(', ')}>`;

const generateComponentDoc = (docs) => `
## ${docs.exportName}

${docs.description || ''}

- **Type**: \`Component\`

### Props

${(docs.props || []).map(prop => `
#### ${prop.name}

${prop.description || ''}

${prop.type ? `
- **Type** \`${prop.type.name}\`
` : ''}
${prop.defaultValue ? `
- **Default value** \`${prop.defaultValue.value}\`
` : ''}

`).join('\n')}
`;

const generateMembersDocs = (children) => children ? `
- **Members**
${(children)
  .map((child) => `   - **${child.name}**: \`${child.type?.name}\``)
  .join('\n')}
` : '';

const generateTSDocs = (docs) => `
## ${docs.name}${docs.typeParameters ? getTypeParamString(docs.typeParameters) : ''}

${docs.comment?.shortText || ''}

- **Type** \`${docs.kindString}\`

${generateMembersDocs(docs.children)}
`;

const generateChildren = (
  children = [],
  components,
) => children.map((child) => {
  const componentDocs = components.find((c) => c.exportName === child.name);
  if (componentDocs) {
    return generateComponentDoc(componentDocs);
  }

  return generateTSDocs(child);
}).join('');

/**
 * Generate the full markdown for a package
 *
 * Takes the package name (e.g. @schlechtenburg/core) and outputs a markdown string ready to be
 * consumed by vitepress
 */
export default ({ lib, components }) => {
  const markdown = `
# ${lib.name}

${lib.comment ? lib.comment : ''}

${generateChildren(lib.children, components)}

  `;

  return markdown
    .trim()
    .replace(/\n\n+/, '\n\n');
}