[Question] Is there a way to generate the "@example" tag contents from an external source file?

For example,

Here's the source file:

/* source/add.ts */

/**
 * Adds two numbers.
 *
 * @param x - First number.
 * @param y - Second number
 * @returns The sum of x and y.
 */
const add = (x: number, y: number): number => x + y

Here's the example source file:

/* examples/add.ts */

import { add } from '@source/add'

add(2, 3) // 5

Is there a way to reference the example source file in TSDoc?

Ideally via something like this:

/* pseudo-code */

/**
 * @example {@ref(./examples/add.ts)}
 */

The key benefit to have such ability is to have a single source of example without any duplications to be able to present it in a multiple ways simultaneously, like running it and listing its source at the same time.

Start by reviewing the TSDoc @example tag and the source/add.ts and examples/add.ts examples described in the issue. Determine how an external-file reference would preserve one example source for both execution and displayed documentation. Done means the supported behavior and its limitations are defined clearly enough to document or implement.