Something went wrong. Try again.
[READ-ONLY] Mirror of https://github.com/lukebennett88/luke-ui. ui.lukebennett.dev
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112import { readFileSync } from 'node:fs';import { resolve } from 'node:path';import { fileURLToPath } from 'node:url';
/** Minimal shape of an mdast node, enough to narrow to an MDX JSX element. */interface MdastNode { type: string;}
interface MdxJsxAttributeValueExpression { type: 'mdxJsxAttributeValueExpression'; value: string;}
interface MdxJsxAttribute { name: string; type: 'mdxJsxAttribute'; value: string | MdxJsxAttributeValueExpression;}
interface MdxJsxExpressionAttribute { type: 'mdxJsxExpressionAttribute'; value: string;}
interface MdxJsxElementNode { attributes: Array<MdxJsxAttribute | MdxJsxExpressionAttribute>; name?: string | null; type: 'mdxJsxFlowElement' | 'mdxJsxTextElement';}
const docsAppRoot = fileURLToPath(new URL('../..', import.meta.url));const repoRoot = resolve(docsAppRoot, '..', '..');
export type ExampleTagName = 'ExampleBlock' | 'SourceCodeBlock';
// Repo-relative directory each tag's `src` prop resolves against.const SOURCE_DIRS_BY_TAG: Readonly<Record<ExampleTagName, string>> = { ExampleBlock: 'src/examples', SourceCodeBlock: 'src/samples',};
/** Repo-relative path and trimmed source contents for one inlined example block. */export function expectedInlinedExampleBlock( tagName: ExampleTagName, src: string,): { content: string; repoRelativePath: string } { const sourceDir = SOURCE_DIRS_BY_TAG[tagName]; // A `.ts` sample names its extension. Every other `src` is a `.tsx` file. const file = src.endsWith('.ts') ? src : `${src}.tsx`; const repoRelativePath = `apps/docs/${sourceDir}/${file}`;
return { repoRelativePath, content: readSourceFile(repoRelativePath, tagName, src), };}
const fileContentsCache = new Map<string, string>();
/** * Markdown that replaces an `<ExampleBlock>` or `<SourceCodeBlock>` tag with the source it * renders, so `llms-full.txt` carries real code instead of a literal tag. Returns `undefined` for * any other node. `remarkInlineExampleSource` records this text with `replaceSource`. */export function inlineExampleSource(node: MdastNode): string | undefined { if (!isMdxJsxElement(node)) return;
const tagName = node.name; if (tagName !== 'ExampleBlock' && tagName !== 'SourceCodeBlock') return;
const src = readSrcAttribute(node); if (src === undefined) return;
const { content, repoRelativePath } = expectedInlinedExampleBlock(tagName, src);
return `${repoRelativePath}\n\n\`\`\`tsx\n${content}\n\`\`\``;}
function isMdxJsxElement(node: MdastNode): node is MdxJsxElementNode { return node.type === 'mdxJsxFlowElement' || node.type === 'mdxJsxTextElement';}
function readSrcAttribute(node: MdxJsxElementNode): string | undefined { const srcAttr = node.attributes.find((attr): attr is MdxJsxAttribute => { return attr.type === 'mdxJsxAttribute' && attr.name === 'src'; });
if (!srcAttr || typeof srcAttr.value !== 'string') return; return srcAttr.value;}
function readSourceFile(repoRelativePath: string, tagName: string, src: string): string { const cached = fileContentsCache.get(repoRelativePath); if (cached !== undefined) return cached;
const absolutePath = resolve(repoRoot, repoRelativePath);
let raw: string; try { raw = readFileSync(absolutePath, 'utf8'); } catch { throw new Error( `<${tagName} src="${src}"> could not be inlined: no file at ${repoRelativePath}`, ); }
const contents = raw.trimEnd(); fileContentsCache.set(repoRelativePath, contents); return contents;}