Files
2026-07-13 12:38:34 +08:00

115 lines
3.5 KiB
TypeScript

import { createPatch } from 'diff';
import { getSingularPatch } from '@pierre/diffs';
import { preloadFileDiff } from '@pierre/diffs/ssr';
import { DiffView, HIDE_DIFF_STATS_CSS } from './diff-view';
import { FILE_BUILDS } from '@/lib/file-builds';
async function diffFor(file: string, prev: string, code: string) {
const fileDiff = getSingularPatch(createPatch(file, prev, code, '', ''));
const { prerenderedHTML } = await preloadFileDiff({
fileDiff,
options: { diffStyle: 'unified', unsafeCSS: HIDE_DIFF_STATS_CSS },
});
return { fileDiff, prerenderedHTML };
}
function StepCard({
n,
title,
file,
description,
fileDiff,
prerenderedHTML,
code,
}: {
n: number;
title: string;
file: string;
description?: string;
fileDiff: any;
prerenderedHTML: string;
code: string;
}) {
return (
<div className="overflow-hidden rounded-sm border border-fd-border bg-fd-background">
<div className="flex items-center gap-2.5 border-b border-fd-border px-3 py-2">
<span className="flex size-5 shrink-0 items-center justify-center rounded-sm bg-[var(--composio-brand)]/10 font-mono text-[11px] font-medium text-[var(--composio-brand)]">
{n}
</span>
<span className="text-[13px] font-medium text-fd-foreground">{title}</span>
<span className="ml-auto font-mono text-[10px] uppercase tracking-[0.06em] text-fd-foreground/40">
{file}
</span>
</div>
{description ? (
<p className="px-3 pt-2.5 text-[13px] leading-snug text-fd-foreground/65">{description}</p>
) : null}
<div className="p-3">
<DiffView fileDiff={fileDiff} prerenderedHTML={prerenderedHTML} code={code} />
</div>
</div>
);
}
/**
* FileBuildup — renders one of the example's files growing a piece at a time.
* Each step is a diff against the previous stage (powered by @pierre/diffs).
*
* Pass `step` (1-indexed) to render just that one step's diff, so the prose for
* a concept can sit right next to the code that adds it. Without `step`, renders
* every step with its built-in description.
*
* `name` keys into the merged FILE_BUILDS registry (see lib/file-builds.ts),
* which carries every example's stages under unique keys.
*/
export async function FileBuildup({
name,
step,
}: {
name: keyof typeof FILE_BUILDS;
step?: number;
}) {
const build = FILE_BUILDS[name];
if (!build) return null;
if (typeof step === 'number') {
const i = step - 1;
const stage = build.stages[i];
if (!stage) return null;
const prev = i > 0 ? build.stages[i - 1].code : '';
const { fileDiff, prerenderedHTML } = await diffFor(build.file, prev, stage.code);
// The heading above and the diff's own filename header already name it, so
// render just the diff with no extra card chrome.
return (
<div className="not-prose my-6">
<DiffView fileDiff={fileDiff} prerenderedHTML={prerenderedHTML} code={stage.code} />
</div>
);
}
const steps = [];
let prev = '';
for (const stage of build.stages) {
steps.push({ ...stage, ...(await diffFor(build.file, prev, stage.code)) });
prev = stage.code;
}
return (
<div className="not-prose my-6 flex flex-col gap-5">
{steps.map((s, i) => (
<StepCard
key={s.title}
n={i + 1}
title={s.title}
file={build.file}
description={s.description}
fileDiff={s.fileDiff}
prerenderedHTML={s.prerenderedHTML}
code={s.code}
/>
))}
</div>
);
}