fix(core): moved source link inline and exposed to all parent symbols

Author: tgreyuk

.changeset/healthy-camels-jump.md

@@ -0,0 +1,5 @@
+---
+'typedoc-plugin-markdown': minor
+---
+
+- Moved source link inline and exposed to all parent symbols (#746).

packages/typedoc-plugin-markdown/src/theme/context/partials/member.accessor.ts

@@ -100,21 +100,11 @@ export function accessor(
 
   if (showSources && !this.options.getValue('disableSources')) {
     if (model.getSignature?.sources) {
-      md.push(
-        this.partials.sources(model.getSignature, {
-          headingLevel: options.headingLevel,
-        }),
-      );
+      md.push(this.partials.sources(model.getSignature));
     } else if (model.setSignature?.sources) {
-      md.push(
-        this.partials.sources(model.setSignature, {
-          headingLevel: options.headingLevel,
-        }),
-      );
+      md.push(this.partials.sources(model.setSignature));
     } else {
-      md.push(
-        this.partials.sources(model, { headingLevel: options.headingLevel }),
-      );
+      md.push(this.partials.sources(model));
     }
   }
 

packages/typedoc-plugin-markdown/src/theme/context/partials/member.declaration.ts

@@ -29,6 +29,14 @@ export function declaration(
 
   md.push(this.partials.declarationTitle(model));
 
+  if (
+    !opts.nested &&
+    model.sources &&
+    !this.options.getValue('disableSources')
+  ) {
+    md.push(this.partials.sources(model));
+  }
+
   if (model?.documents) {
     md.push(
       this.partials.documents(model, {
@@ -147,13 +155,5 @@ export function declaration(
     this.partials.inheritance(model, { headingLevel: opts.headingLevel }),
   );
 
-  if (
-    !opts.nested &&
-    model.sources &&
-    !this.options.getValue('disableSources')
-  ) {
-    md.push(this.partials.sources(model, { headingLevel: opts.headingLevel }));
-  }
-
   return md.join('\n\n');
 }

packages/typedoc-plugin-markdown/src/theme/context/partials/member.enumMembersTable.ts

@@ -59,7 +59,7 @@ export function enumMembersTable(
     }
 
     if (hasSources) {
-      row.push(this.partials.sources(property, { headingLevel: -1 }));
+      row.push(this.partials.sources(property, { hideLabel: true }));
     }
 
     rows.push(row);

packages/typedoc-plugin-markdown/src/theme/context/partials/member.memberWithGroups.ts

@@ -12,6 +12,10 @@ export function memberWithGroups(
 ): string {
   const md: string[] = [];
 
+  if (model.sources && !this.options.getValue('disableSources')) {
+    md.push(this.partials.sources(model));
+  }
+
   if (model.comment) {
     md.push(
       this.partials.comment(model.comment, {

packages/typedoc-plugin-markdown/src/theme/context/partials/member.propertiesTable.ts

@@ -159,7 +159,7 @@ export function propertiesTable(
     }
 
     if (hasSources) {
-      row.push(this.partials.sources(property, { headingLevel: -1 }));
+      row.push(this.partials.sources(property, { hideLabel: true }));
     }
 
     rows.push(row);

packages/typedoc-plugin-markdown/src/theme/context/partials/member.signature.ts

@@ -22,6 +22,14 @@ export function signature(
     );
   }
 
+  if (
+    !options.nested &&
+    model.sources &&
+    !this.options.getValue('disableSources')
+  ) {
+    md.push(this.partials.sources(model));
+  }
+
   let modelComments = options.multipleSignatures
     ? model.comment
     : model.comment || model.parent?.comment;
@@ -120,15 +128,5 @@ export function signature(
     this.partials.inheritance(model, { headingLevel: options.headingLevel }),
   );
 
-  if (
-    !options.nested &&
-    model.sources &&
-    !this.options.getValue('disableSources')
-  ) {
-    md.push(
-      this.partials.sources(model, { headingLevel: options.headingLevel }),
-    );
-  }
-
   return md.join('\n\n');
 }

packages/typedoc-plugin-markdown/src/theme/context/partials/member.sources.ts

@@ -1,18 +1,19 @@
-import { heading, link } from '@plugin/libs/markdown/index.js';
+import { bold, link } from '@plugin/libs/markdown/index.js';
 import { escapeChars } from '@plugin/libs/utils/index.js';
 import { MarkdownThemeContext } from '@plugin/theme/index.js';
 import { DeclarationReflection, SignatureReflection } from 'typedoc';
 
 export function sources(
   this: MarkdownThemeContext,
   model: DeclarationReflection | SignatureReflection,
-  options: { headingLevel: number },
+  options?: { hideLabel: boolean },
 ): string {
   const md: string[] = [];
 
-  if (options.headingLevel !== -1) {
-    md.push(heading(options.headingLevel, this.i18n.theme_defined_in()));
+  if (!options?.hideLabel) {
+    md.push(`${bold(this.i18n.theme_defined_in())}:`);
   }
+
   model.sources?.forEach((source, index) => {
     if (index === 0) {
       if (source.url) {
@@ -24,5 +25,6 @@ export function sources(
       }
     }
   });
-  return md.join('\n\n');
+
+  return md.join(' ');
 }

packages/typedoc-plugin-markdown/src/theme/context/partials/member.typeDeclarationTable.ts

@@ -107,7 +107,7 @@ export function typeDeclarationTable(
     }
 
     if (hasSources) {
-      row.push(this.partials.sources(declaration, { headingLevel: -1 }));
+      row.push(this.partials.sources(declaration, { hideLabel: true }));
     }
 
     rows.push(row);

packages/typedoc-plugin-markdown/src/theme/context/resources.ts

@@ -193,7 +193,7 @@ There is no association list partial for properties as these are handled as a st
     ) => partials.signatures.apply(context, [model, options]) as string,
     sources: (
       model: DeclarationReflection | SignatureReflection,
-      options: { headingLevel: number },
+      options?: { hideLabel: boolean } | undefined,
     ) => partials.sources.apply(context, [model, options]) as string,
     member: (
       model: DeclarationReflection,