@cparra/apexdocs 2.25.0-alpha.8 → 3.0.0-alpha.1

package/src/core/markdown/__test__/test-helpers.ts

@@ -1,8 +1,8 @@
-import { SourceFile } from '../../shared/types';
+import { UnparsedSourceFile } from '../../shared/types';
 import { generateDocs as gen, MarkdownGeneratorConfig } from '../generate-docs';
 import { referenceGuideTemplate } from '../templates/reference-guide';
 
-export function apexBundleFromRawString(raw: string, rawMetadata?: string): SourceFile {
+export function apexBundleFromRawString(raw: string, rawMetadata?: string): UnparsedSourceFile {
   return {
     filePath: 'test.cls',
     content: raw,
@@ -10,7 +10,7 @@ export function apexBundleFromRawString(raw: string, rawMetadata?: string): Sour
   };
 }
 
-export function generateDocs(apexBundles: SourceFile[], config?: Partial<MarkdownGeneratorConfig>) {
+export function generateDocs(apexBundles: UnparsedSourceFile[], config?: Partial<MarkdownGeneratorConfig>) {
   return gen(apexBundles, {
     targetDir: 'target',
     scope: ['global', 'public'],
@@ -18,5 +18,6 @@ export function generateDocs(apexBundles: SourceFile[], config?: Partial<Markdow
     sortMembersAlphabetically: true,
     referenceGuideTemplate: referenceGuideTemplate,
     ...config,
+    documentationRootDir: '',
   });
 }

package/src/core/markdown/adapters/__tests__/interface-adapter.spec.ts

@@ -15,13 +15,21 @@ const defaultMarkdownGeneratorConfig: MarkdownGeneratorConfig = {
   defaultGroupName: 'Miscellaneous',
   referenceGuideTemplate: '',
   sortMembersAlphabetically: false,
+  documentationRootDir: '',
 };
 
 describe('Conversion from InterfaceMirror to InterfaceSource understandable by the templating engine', () => {
   it('converts the name', () => {
     const interfaceMirror = new InterfaceMirrorBuilder().withName('SampleInterface').build();
     const interfaceSource = typeToRenderable(
-      { filePath: '', type: interfaceMirror },
+      {
+        source: {
+          filePath: '',
+          type: 'interface',
+          name: 'SampleInterface',
+        },
+        type: interfaceMirror,
+      },
       linkGenerator,
       defaultMarkdownGeneratorConfig,
     );
@@ -32,7 +40,14 @@ describe('Conversion from InterfaceMirror to InterfaceSource understandable by t
   it('converts the access modifier', () => {
     const interfaceMirror = new InterfaceMirrorBuilder().build();
     const interfaceSource = typeToRenderable(
-      { filePath: '', type: interfaceMirror },
+      {
+        source: {
+          filePath: '',
+          type: 'interface',
+          name: 'SampleInterface',
+        },
+        type: interfaceMirror,
+      },
       linkGenerator,
       defaultMarkdownGeneratorConfig,
     );
@@ -45,7 +60,14 @@ describe('Conversion from InterfaceMirror to InterfaceSource understandable by t
       .addAnnotation(new AnnotationBuilder().withName('MyAnnotation').build())
       .build();
     const interfaceSource = typeToRenderable(
-      { filePath: '', type: interfaceMirror },
+      {
+        source: {
+          filePath: '',
+          type: 'interface',
+          name: 'SampleInterface',
+        },
+        type: interfaceMirror,
+      },
       linkGenerator,
       defaultMarkdownGeneratorConfig,
     );
@@ -67,7 +89,14 @@ describe('Conversion from InterfaceMirror to InterfaceSource understandable by t
       .build();
 
     const interfaceSource = typeToRenderable(
-      { filePath: '', type: interfaceMirror },
+      {
+        source: {
+          filePath: '',
+          type: 'interface',
+          name: 'SampleInterface',
+        },
+        type: interfaceMirror,
+      },
       linkGenerator,
       defaultMarkdownGeneratorConfig,
     );
@@ -99,7 +128,14 @@ describe('Conversion from InterfaceMirror to InterfaceSource understandable by t
       .build();
 
     const interfaceSource = typeToRenderable(
-      { filePath: '', type: interfaceMirror },
+      {
+        source: {
+          filePath: '',
+          type: 'interface',
+          name: 'SampleInterface',
+        },
+        type: interfaceMirror,
+      },
       linkGenerator,
       defaultMarkdownGeneratorConfig,
     );

package/src/core/markdown/adapters/apex-types.ts

@@ -15,6 +15,7 @@ import { adaptDescribable, adaptDocumentable } from './documentables';
 import { adaptConstructor, adaptMethod } from './methods-and-constructors';
 import { adaptFieldOrProperty } from './fields-and-properties';
 import { MarkdownGeneratorConfig } from '../generate-docs';
+import { SourceFileMetadata } from '../../shared/types';
 
 type GetReturnRenderable<T extends Type> = T extends InterfaceMirror
   ? RenderableInterface
@@ -23,7 +24,7 @@ type GetReturnRenderable<T extends Type> = T extends InterfaceMirror
     : RenderableEnum;
 
 export function typeToRenderable<T extends Type>(
-  parsedFile: { filePath: string; type: T },
+  parsedFile: { source: SourceFileMetadata; type: T },
   linkGenerator: GetRenderableContentByTypeName,
   config: MarkdownGeneratorConfig,
 ): GetReturnRenderable<T> & { filePath: string; namespace?: string } {
@@ -41,7 +42,7 @@ export function typeToRenderable<T extends Type>(
 
   return {
     ...(getRenderable() as GetReturnRenderable<T>),
-    filePath: parsedFile.filePath,
+    filePath: parsedFile.source.filePath,
     namespace: config.namespace,
   };
 }

package/src/core/markdown/adapters/reference-guide.ts

@@ -0,0 +1,35 @@
+import { MarkdownGeneratorConfig } from '../generate-docs';
+import { DocPageReference, ParsedFile } from '../../shared/types';
+import { Type } from '@cparra/apex-reflection';
+
+export function parsedFilesToReferenceGuide(
+  config: MarkdownGeneratorConfig,
+  parsedFiles: ParsedFile[],
+): Record<string, DocPageReference> {
+  return parsedFiles.reduce<Record<string, DocPageReference>>((acc, parsedFile) => {
+    acc[parsedFile.type.name] = parsedFileToDocPageReference(config, parsedFile);
+    return acc;
+  }, {});
+}
+
+function parsedFileToDocPageReference(config: MarkdownGeneratorConfig, parsedFile: ParsedFile): DocPageReference {
+  return {
+    source: parsedFile.source,
+    displayName: parsedFile.type.name,
+    pathFromRoot: `${slugify(getTypeGroup(parsedFile.type, config))}/${parsedFile.type.name}.md`,
+  };
+}
+
+function getTypeGroup(type: Type, config: MarkdownGeneratorConfig): string {
+  const groupAnnotation = type.docComment?.annotations.find((annotation) => annotation.name.toLowerCase() === 'group');
+  return groupAnnotation?.body ?? config.defaultGroupName;
+}
+
+function slugify(text: string): string {
+  return text
+    .toLowerCase()
+    .replace(/[^a-z0-9\s-]/g, '') // Remove non-alphanumeric characters except spaces and hyphens
+    .trim()
+    .replace(/\s+/g, '-') // Replace spaces with hyphens
+    .replace(/-+/g, '-'); // Replace multiple hyphens with a single hyphen
+}

package/src/core/markdown/adapters/renderable-bundle.ts

@@ -1,144 +1,78 @@
-import { ParsedFile } from '../../shared/types';
-import { Link, RenderableBundle, StringOrLink } from './types';
+import { DocPageReference, ParsedFile } from '../../shared/types';
+import { Link, ReferenceGuideReference, Renderable, RenderableBundle, StringOrLink } from './types';
 import { typeToRenderable } from './apex-types';
 import { adaptDescribable } from './documentables';
-import { Type } from '@cparra/apex-reflection';
 import { MarkdownGeneratorConfig } from '../generate-docs';
+import { apply } from '#utils/fp';
+import { Type } from '@cparra/apex-reflection';
+import * as path from 'path';
 
 export function parsedFilesToRenderableBundle(
   config: MarkdownGeneratorConfig,
   parsedFiles: ParsedFile[],
+  references: Record<string, DocPageReference>,
 ): RenderableBundle {
-  return parsedFiles.reduce<RenderableBundle>(
-    (acc, parsedFile) => {
-      const renderable = typeToRenderable(
-        parsedFile,
-        (referenceName) => {
-          return linkFromTypeNameGenerator(
-            parsedFile.type,
-            parsedFiles.map((file) => file.type),
-            referenceName,
-            config,
-          );
-        },
-        config,
-      );
-      acc.renderables.push(renderable);
+  const referenceFinder = apply(linkGenerator, references, config.documentationRootDir);
 
-      const descriptionLines = parsedFile.type.docComment?.descriptionLines;
-      const reference = {
-        typeName: parsedFile.type.name,
-        directory: getDirectoryFromRoot(config, parsedFile.type),
-        title: getLinkFromRoot(config, parsedFile.type),
-        description: adaptDescribable(descriptionLines, (referenceName) =>
-          getPossibleLinkFromRoot(
-            config,
-            referenceName,
-            findType(
-              parsedFiles.map((file) => file.type),
-              referenceName,
-            ),
-          ),
-        ).description,
-      };
-
-      const group = getTypeGroup(parsedFile.type, config);
-      if (!acc.references[group]) {
-        acc.references[group] = [];
-      }
-      acc.references[group].push(reference);
+  function toReferenceGuide(parsedFiles: ParsedFile[]): Record<string, ReferenceGuideReference[]> {
+    return parsedFiles.reduce<Record<string, ReferenceGuideReference[]>>(
+      addToReferenceGuide(referenceFinder, config, references),
+      {},
+    );
+  }
 
+  function toRenderables(parsedFiles: ParsedFile[]): Renderable[] {
+    return parsedFiles.reduce<Renderable[]>((acc, parsedFile) => {
+      const renderable = typeToRenderable(parsedFile, referenceFinder, config);
+      acc.push(renderable);
       return acc;
-    },
-    {
-      references: {},
-      renderables: [],
-    },
-  );
-}
-
-function linkFromTypeNameGenerator(
-  typeBeingDocumented: Type,
-  repository: Type[],
-  referenceName: string,
-  config: MarkdownGeneratorConfig,
-): StringOrLink {
-  const type = findType(repository, referenceName);
-  if (!type) {
-    // If the type is not found, we return the type name as a string.
-    return referenceName;
+    }, []);
   }
 
-  const [fullClassName, fileLink] = getFileLinkTuple(typeBeingDocumented, type, config);
   return {
-    __type: 'link',
-    title: fullClassName,
-    url: fileLink,
+    referencesByGroup: toReferenceGuide(parsedFiles),
+    renderables: toRenderables(parsedFiles),
   };
 }
 
-function getPossibleLinkFromRoot(config: MarkdownGeneratorConfig, fallback: string, type?: Type): StringOrLink {
-  if (!type) {
-    return fallback;
-  }
-  const namespacePrefix = config.namespace ? `${config.namespace}.` : '';
-  const title = `${namespacePrefix}${type.name}`;
-  return {
-    __type: 'link',
-    title: title,
-    url: `${getDirectoryFromRoot(config, type)}/${title}.md`,
-  };
-}
-
-function getDirectoryFromRoot(config: MarkdownGeneratorConfig, type?: Type): string {
-  if (!type) {
-    return '';
-  }
-  return `./${getSanitizedGroup(type, config)}`;
-}
+function addToReferenceGuide(
+  findLinkFromHome: (referenceName: string) => string | Link,
+  config: MarkdownGeneratorConfig,
+  references: Record<string, DocPageReference>,
+) {
+  return (acc: Record<string, ReferenceGuideReference[]>, parsedFile: ParsedFile) => {
+    const group: string = getTypeGroup(parsedFile.type, config);
+    if (!acc[group]) {
+      acc[group] = [];
+    }
+    acc[group].push({
+      reference: references[parsedFile.type.name],
+      title: findLinkFromHome(parsedFile.type.name) as Link,
+      description: adaptDescribable(parsedFile.type.docComment?.descriptionLines, findLinkFromHome).description ?? null,
+    });
 
-function findType(repository: Type[], referenceName: string) {
-  return repository.find((currentType: Type) => currentType.name.toLowerCase() === referenceName.toLowerCase());
+    return acc;
+  };
 }
 
-function getFileLinkTuple(
-  typeBeingDocumented: Type,
-  referencedType: Type,
-  config: MarkdownGeneratorConfig,
-): [string, string] {
-  const namespacePrefix = config.namespace ? `${config.namespace}.` : '';
-  const directoryRoot = `${getDirectoryRoot(typeBeingDocumented, referencedType, config)}`;
-  // TODO: Instead of adding a "." to the name when there is a namespace, maybe we want to create a folder for everything
-  // within that namespace and put the files in there.
-  const fullClassName = `${namespacePrefix}${referencedType.name}`;
-  return [fullClassName, `${directoryRoot}${fullClassName}.md`];
-}
+const linkGenerator = (
+  references: Record<string, DocPageReference>,
+  documentationRootDir: string,
+  referenceName: string,
+): StringOrLink => {
+  const reference: DocPageReference | undefined = references[referenceName];
 
-function getDirectoryRoot(typeBeingDocumented: Type, referencedType: Type, config: MarkdownGeneratorConfig) {
-  if (getTypeGroup(typeBeingDocumented, config) === getTypeGroup(referencedType, config)) {
-    // If the types the same groups then we simply link directly to that file
-    return './';
-  } else {
-    // If the types have different groups, then we have to go up a directory
-    return `../${getSanitizedGroup(referencedType, config)}/`;
-  }
-}
+  return reference
+    ? // Starting the path with a "/" will ensure the link will always be relative to the root of the site.
+      {
+        __type: 'link',
+        title: reference.displayName,
+        url: path.join('/', documentationRootDir, reference.pathFromRoot),
+      }
+    : referenceName;
+};
 
 function getTypeGroup(type: Type, config: MarkdownGeneratorConfig): string {
   const groupAnnotation = type.docComment?.annotations.find((annotation) => annotation.name.toLowerCase() === 'group');
   return groupAnnotation?.body ?? config.defaultGroupName;
 }
-
-function getSanitizedGroup(classModel: Type, config: MarkdownGeneratorConfig) {
-  return getTypeGroup(classModel, config).replace(/ /g, '-').replace('.', '');
-}
-
-function getLinkFromRoot(config: MarkdownGeneratorConfig, type: Type): Link {
-  const namespacePrefix = config.namespace ? `${config.namespace}.` : '';
-  const title = `${namespacePrefix}${type.name}`;
-  return {
-    __type: 'link',
-    title: title,
-    url: `${getDirectoryFromRoot(config, type)}/${title}.md`,
-  };
-}

package/src/core/markdown/adapters/renderable-to-page-data.ts

@@ -5,19 +5,20 @@ import { CompilationRequest, Template } from '../templates/template';
 import { enumMarkdownTemplate } from '../templates/enum-template';
 import { interfaceMarkdownTemplate } from '../templates/interface-template';
 import { classMarkdownTemplate } from '../templates/class-template';
+import { defaults } from '../../../defaults';
 
 export const convertToDocumentationBundle = (
   referenceGuideTemplate: string,
-  { references, renderables }: RenderableBundle,
+  { referencesByGroup, renderables }: RenderableBundle,
 ): DocumentationBundle => ({
   referenceGuide: {
-    directory: '',
     frontmatter: null,
-    content: referencesToReferenceGuideContent(references, referenceGuideTemplate),
-    fileExtension: 'md',
-    fileName: 'index',
+    content: referencesToReferenceGuideContent(referencesByGroup, referenceGuideTemplate),
+    filePath: 'index.md',
   },
-  docs: renderables.map((renderable: Renderable) => renderableToPageData(Object.values(references).flat(), renderable)),
+  docs: renderables.map((renderable: Renderable) =>
+    renderableToPageData(Object.values(referencesByGroup).flat(), renderable),
+  ),
 });
 
 function referencesToReferenceGuideContent(
@@ -45,11 +46,9 @@ function referencesToReferenceGuideContent(
 
 function renderableToPageData(referenceGuideReference: ReferenceGuideReference[], renderable: Renderable): DocPageData {
   function buildDocOutput(renderable: Renderable, docContents: string): DocPageData {
-    const reference = referenceGuideReference.find(
-      (ref) => ref.typeName.toLowerCase() === renderable.name.toLowerCase(),
-    );
-
-    const namespacePrefix = renderable.namespace ? `${renderable.namespace}.` : '';
+    const reference: ReferenceGuideReference = referenceGuideReference.find(
+      (ref) => ref.reference.source.name.toLowerCase() === renderable.name.toLowerCase(),
+    )!;
 
     return {
       source: {
@@ -57,12 +56,10 @@ function renderableToPageData(referenceGuideReference: ReferenceGuideReference[]
         name: renderable.name,
         type: renderable.type,
       },
-      fileName: `${namespacePrefix}${renderable.name}`,
-      fileExtension: 'md',
-      directory: `${reference?.directory}`,
+      filePath: reference!.reference.pathFromRoot,
       frontmatter: null,
       content: docContents,
-      group: renderable.doc.group ?? 'Miscellaneous',
+      group: renderable.doc.group ?? defaults.defaultGroupName,
     };
   }
 

package/src/core/markdown/adapters/types.d.ts

@@ -7,6 +7,7 @@ import {
   MethodMirror,
   PropertyMirror,
 } from '@cparra/apex-reflection';
+import { DocPageReference } from '../../shared/types';
 
 export type Describable = string[] | undefined;
 
@@ -24,17 +25,14 @@ export type MethodMirrorWithInheritance = MethodMirror & InheritanceSupport;
 // Renderable types
 
 export type ReferenceGuideReference = {
-  typeName: string;
-  directory: string;
+  reference: DocPageReference;
   title: Link;
-  description: RenderableContent[] | undefined;
+  description: RenderableContent[] | null;
 };
 
 export type RenderableBundle = {
   // References are grouped by their defined @group annotation
-  references: {
-    [key: string]: ReferenceGuideReference[];
-  };
+  referencesByGroup: Record<string, ReferenceGuideReference[]>;
   renderables: Renderable[];
 };
 

package/src/core/markdown/generate-docs.ts

@@ -10,11 +10,14 @@ import {
   Frontmatter,
   PostHookDocumentationBundle,
   ReferenceGuidePageData,
-  SourceFile,
+  UnparsedSourceFile,
   TransformDocPage,
   TransformDocs,
   TransformReferenceGuide,
   UserDefinedMarkdownConfig,
+  DocPageReference,
+  TransformReference,
+  ParsedFile,
 } from '../shared/types';
 import { parsedFilesToRenderableBundle } from './adapters/renderable-bundle';
 import { reflectSourceCode } from './reflection/reflect-source';
@@ -27,6 +30,7 @@ import { Template } from './templates/template';
 import { hookableTemplate } from './templates/hookable';
 import { sortMembers } from './reflection/sort-members';
 import { isSkip } from '../shared/utils';
+import { parsedFilesToReferenceGuide } from './adapters/reference-guide';
 
 export type MarkdownGeneratorConfig = Pick<
   UserDefinedMarkdownConfig,
@@ -37,6 +41,8 @@ export type MarkdownGeneratorConfig = Pick<
   | 'transformReferenceGuide'
   | 'transformDocs'
   | 'transformDocPage'
+  | 'transformReference'
+  | 'documentationRootDir'
 > & {
   referenceGuideTemplate: string;
   sortMembersAlphabetically: boolean;
@@ -48,8 +54,9 @@ export class HookError {
   constructor(public error: unknown) {}
 }
 
-export function generateDocs(apexBundles: SourceFile[], config: MarkdownGeneratorConfig) {
+export function generateDocs(apexBundles: UnparsedSourceFile[], config: MarkdownGeneratorConfig) {
   const filterOutOfScope = apply(filterScope, config.scope);
+  const convertToReferences = apply(parsedFilesToReferenceGuide, config);
   const convertToRenderableBundle = apply(parsedFilesToRenderableBundle, config);
   const convertToDocumentationBundleForTemplate = apply(convertToDocumentationBundle, config.referenceGuideTemplate);
   const sortTypeMembers = apply(sortMembers, config.sortMembersAlphabetically);
@@ -62,53 +69,45 @@ export function generateDocs(apexBundles: SourceFile[], config: MarkdownGenerato
     E.map(addInheritedMembersToTypes),
     E.map(addInheritanceChainToTypes),
     E.map(sortTypeMembers),
-    E.map(convertToRenderableBundle),
-    E.map(convertToDocumentationBundleForTemplate),
+    E.bindTo('parsedFiles'),
+    E.bind('references', ({ parsedFiles }) => E.right(convertToReferences(parsedFiles))),
     TE.fromEither,
-    TE.flatMap((bundle) =>
-      TE.tryCatch(
-        () => documentationBundleHook(bundle, config),
-        (error) => new HookError(error),
-      ),
-    ),
-    TE.map((bundle: PostHookDocumentationBundle) => ({
-      referenceGuide: isSkip(bundle.referenceGuide)
-        ? bundle.referenceGuide
-        : {
-            ...bundle.referenceGuide,
-            content: Template.getInstance().compile({
-              source: {
-                frontmatter: toFrontmatterString(bundle.referenceGuide.frontmatter),
-                content: bundle.referenceGuide.content,
-              },
-              template: hookableTemplate,
-            }),
-          },
-      docs: bundle.docs.map((doc) => ({
-        ...doc,
-        content: Template.getInstance().compile({
-          source: {
-            frontmatter: toFrontmatterString(doc.frontmatter),
-            content: doc.content,
-          },
-          template: hookableTemplate,
-        }),
-      })),
-    })),
+    TE.flatMap(({ parsedFiles, references }) => transformReferenceHook(config)({ references, parsedFiles })),
+    TE.map(({ parsedFiles, references }) => convertToRenderableBundle(parsedFiles, references)),
+    TE.map(convertToDocumentationBundleForTemplate),
+    TE.flatMap(transformDocumentationBundleHook(config)),
+    TE.map(postHookCompile),
   );
 }
 
-function toFrontmatterString(frontmatter: Frontmatter): string {
-  if (typeof frontmatter === 'string') {
-    return frontmatter;
+function transformReferenceHook(config: MarkdownGeneratorConfig) {
+  async function _execute(
+    references: Record<string, DocPageReference>,
+    parsedFiles: ParsedFile[],
+    transformReference?: TransformReference | undefined,
+  ): Promise<{
+    references: Record<string, DocPageReference>;
+    parsedFiles: ParsedFile[];
+  }> {
+    return {
+      references: await execTransformReferenceHook(Object.values(references), transformReference),
+      parsedFiles,
+    };
   }
 
-  if (!frontmatter) {
-    return '';
-  }
+  return ({ references, parsedFiles }: { references: Record<string, DocPageReference>; parsedFiles: ParsedFile[] }) =>
+    TE.tryCatch(
+      () => _execute(references, parsedFiles, config.transformReference),
+      (error) => new HookError(error),
+    );
+}
 
-  const yamlString = yaml.dump(frontmatter);
-  return `---\n${yamlString}---\n`;
+function transformDocumentationBundleHook(config: MarkdownGeneratorConfig) {
+  return (bundle: DocumentationBundle) =>
+    TE.tryCatch(
+      () => documentationBundleHook(bundle, config),
+      (error) => new HookError(error),
+    );
 }
 
 // Configurable hooks
@@ -116,6 +115,25 @@ function passThroughHook<T>(value: T): T {
   return value;
 }
 
+const execTransformReferenceHook = async (
+  references: DocPageReference[],
+  hook: TransformReference = passThroughHook,
+): Promise<Record<string, DocPageReference>> => {
+  const hooked = references.map<Promise<DocPageReference>>(async (reference) => {
+    const hookedResult = await hook(reference);
+    return {
+      ...reference,
+      ...hookedResult,
+    };
+  });
+  const awaited = await Promise.all(hooked);
+
+  return awaited.reduce<Record<string, DocPageReference>>((acc, reference) => {
+    acc[reference.source.name] = reference;
+    return acc;
+  }, {});
+};
+
 const documentationBundleHook = async (
   bundle: DocumentationBundle,
   config: MarkdownGeneratorConfig,
@@ -156,3 +174,43 @@ const transformDocPage = async (doc: DocPageData, hook: TransformDocPage = passT
     ...(await hook(doc)),
   };
 };
+
+function postHookCompile(bundle: PostHookDocumentationBundle) {
+  return {
+    referenceGuide: isSkip(bundle.referenceGuide)
+      ? bundle.referenceGuide
+      : {
+          ...bundle.referenceGuide,
+          content: Template.getInstance().compile({
+            source: {
+              frontmatter: toFrontmatterString(bundle.referenceGuide.frontmatter),
+              content: bundle.referenceGuide.content,
+            },
+            template: hookableTemplate,
+          }),
+        },
+    docs: bundle.docs.map((doc) => ({
+      ...doc,
+      content: Template.getInstance().compile({
+        source: {
+          frontmatter: toFrontmatterString(doc.frontmatter),
+          content: doc.content,
+        },
+        template: hookableTemplate,
+      }),
+    })),
+  };
+}
+
+function toFrontmatterString(frontmatter: Frontmatter): string {
+  if (typeof frontmatter === 'string') {
+    return frontmatter;
+  }
+
+  if (!frontmatter) {
+    return '';
+  }
+
+  const yamlString = yaml.dump(frontmatter);
+  return `---\n${yamlString}---\n`;
+}

package/src/core/markdown/reflection/inheritance-chain-expanion.ts

@@ -3,7 +3,7 @@ import { createInheritanceChain } from './inheritance-chain';
 import { ParsedFile } from '../../shared/types';
 import { parsedFilesToTypes } from '../utils';
 
-export const addInheritanceChainToTypes = (parsedFiles: ParsedFile[]) =>
+export const addInheritanceChainToTypes = (parsedFiles: ParsedFile[]): ParsedFile[] =>
   parsedFiles.map((parsedFile) => ({
     ...parsedFile,
     type: addInheritanceChain(parsedFile.type, parsedFilesToTypes(parsedFiles)),