Function useValidatedCodePaths

packages/ui/hooks/useValidatedCodePaths.ts:29–85

(
	markdown: string,
	baseDir?: string,
)

 * demoted to plain text.
 */
export function useValidatedCodePaths(
	markdown: string,
	baseDir?: string,
): { validated: ValidatedMap; ready: boolean } {
	const [validated, setValidated] = useState<ValidatedMap>(new Map());
	const [ready, setReady] = useState<boolean>(false);

	useEffect(() => {
		setValidated(new Map());
		setReady(false);

		const candidates = extractCandidateCodePaths(markdown);
		if (candidates.length === 0) {
			setReady(true);
			return;
		}

		let cancelled = false;
		(async () => {
			try {
				const res = await fetch("/api/doc/exists", {
					method: "POST",
					headers: { "Content-Type": "application/json" },
					body: JSON.stringify(
						baseDir ? { paths: candidates, base: baseDir } : { paths: candidates },
					),
				});
				if (cancelled) return;
				if (!res.ok) {
					setReady(true);
					return;
				}
				const data = (await res.json()) as {
					results: Record<string, ValidationEntry>;
				};
				if (cancelled) return;
				const next: ValidatedMap = new Map();
				for (const [k, v] of Object.entries(data.results ?? {})) {
					next.set(k, v);
				}
				setValidated(next);
				setReady(true);
			} catch {
				if (!cancelled) setReady(true);
			}
		})();

		return () => {
			cancelled = true;
		};
	}, [markdown, baseDir]);

	// Stable reference: only changes when validated/ready actually change.
	// Without memoization, the parent provider's value is a fresh object every
	// render, forcing all context consumers (every InlineMarkdown) to re-render.
	return useMemo(() => ({ validated, ready }), [validated, ready]);
}