ESPDocs/components/PinRestrictions.jsx

import Link from "next/link";
import {
	AlertTriangle,
	ArrowDownToLine,
	HardDrive,
	Power,
	Bug,
	Usb,
	Zap,
	ArrowRight,
} from "lucide-react";

/**
 * Restrições de pinos por série.
 *
 * Os grupos são DERIVADOS de public/conexoes/<serie>.json, o mesmo arquivo que
 * alimenta o diagrama de conexões. Nada aqui é escrito à mão, então a seção e o
 * diagrama nunca divergem: corrigir um pino no JSON corrige os dois.
 */

const GRUPOS = [
	{
		id: "entrada",
		titulo: "Somente entrada",
		icone: ArrowDownToLine,
		cor: "text-accent",
		explicacao:
			"Aceitam apenas leitura. Não podem ser configurados como saída e não possuem resistores de pull-up ou pull-down internos. Se precisar de um, coloque no circuito.",
		combina: (avisos) => /apenas de entrada|input only/.test(avisos),
	},
	{
		id: "flash",
		titulo: "Ligados à memória flash/PSRAM",
		icone: HardDrive,
		cor: "text-copper",
		explicacao:
			"Já estão conectados à memória de onde o firmware é lido. Usá-los como GPIO comum normalmente trava o chip ou corrompe a execução. Em módulos com flash interna eles nem chegam ao encapsulamento.",
		combina: (avisos) =>
			/(flash|psram)/.test(avisos) &&
			/(dedicad|utilizado pela mem|não deve ser utilizado|não é recomendado)/.test(avisos),
	},
	{
		id: "strapping",
		titulo: "Strapping (modo de boot)",
		icone: Power,
		cor: "text-gold",
		explicacao:
			"O chip lê o nível destes pinos no instante do reset para decidir como inicializar. Dá para usá-los depois do boot, mas o circuito externo não pode forçar o nível errado durante o reset, senão a placa não inicia ou entra em modo de gravação sozinha.",
		combina: (avisos, cats) =>
			cats.includes("Strapping") ||
			/strapping|modo de boot|modo de inicialização/.test(avisos),
	},
	{
		id: "debug",
		titulo: "Gravação e depuração",
		icone: Bug,
		cor: "text-accent",
		explicacao:
			"São a UART de gravação e as linhas de JTAG. Continuam utilizáveis como GPIO, mas ao reaproveitá-los você perde o caminho de gravar e depurar a placa sem desconectar o que estiver ali.",
		combina: (avisos, cats) => /debugging/.test(avisos) || cats.includes("JTAG"),
	},
	{
		id: "usb",
		titulo: "USB nativo",
		icone: Usb,
		cor: "text-accent",
		explicacao:
			"Saem de fábrica ligados ao USB Serial/JTAG interno. Para usá-los como GPIO é preciso desativar essa função, o que também remove a gravação por USB direto.",
		combina: (avisos) => /usb serial\/jtag|usb_d[+-]/.test(avisos),
	},
	{
		id: "eletrico",
		titulo: "Não podem ficar flutuando",
		icone: Zap,
		cor: "text-gold",
		explicacao:
			"Precisam de nível definido por hardware: pull-up externo ou circuito RC de atraso. Deixá-los soltos causa reset aleatório ou inicialização instável.",
		combina: (avisos) => /flutuando/.test(avisos),
	},
];

/** Nome do pino + o GPIO correspondente, quando o nome é uma função (ex.: SENSOR_VP). */
function rotuloDoPino(pino) {
	const gpio = (pino.funcoes || []).find((f) => /^GPIO\d+$/.test(f));
	return gpio && gpio !== pino.nome ? `${pino.nome} · ${gpio}` : pino.nome;
}

function derivarGrupos(conexoes) {
	return GRUPOS.map((grupo) => {
		const vistos = new Map();
		for (const pino of conexoes) {
			if (!["io", "analog", "dedicated"].includes(pino.tipo)) continue;
			const avisos = (pino.avisos || []).join(" ").toLowerCase();
			const cats = pino.categorias || [];
			if (grupo.combina(avisos, cats)) {
				const rotulo = rotuloDoPino(pino);
				if (!vistos.has(rotulo)) vistos.set(rotulo, pino);
			}
		}
		return { ...grupo, pinos: [...vistos.keys()] };
	}).filter((g) => g.pinos.length > 0);
}

export default function PinRestrictions({ conexoes, serieKey }) {
	if (!conexoes?.length) return null;

	const grupos = derivarGrupos(conexoes);
	if (!grupos.length) return null;

	const totalPinos = new Set(grupos.flatMap((g) => g.pinos)).size;

	return (
		<section id="restricoes" aria-labelledby="restricoes-titulo" className="card mt-5 scroll-mt-28 p-5 sm:p-7">
			<h2 id="restricoes-titulo" className="flex items-center gap-3 font-display text-xl font-semibold tracking-[-0.03em] text-ink">
				<span className="grid h-9 w-9 place-items-center rounded-full bg-gold-soft text-gold">
					<AlertTriangle className="h-4 w-4" aria-hidden="true" />
				</span>
				Pinos com restrição de uso
			</h2>

			<p className="mt-3 max-w-3xl text-sm leading-relaxed text-muted">
				Nem todo pino do {serieKey} está livre para uso geral. {totalPinos} deles têm alguma
				condição: já estão ocupados por memória, são lidos durante o boot ou só funcionam
				como entrada. Vale conferir antes de fechar o esquemático.
			</p>

			<div className="mt-6 grid gap-4 md:grid-cols-2">
				{grupos.map(({ id, titulo, icone: Icone, cor: corIcone, explicacao, pinos }) => (
					<div key={id} className="tile">
						<div className="flex items-center gap-2.5">
							<Icone className={`h-4 w-4 shrink-0 ${corIcone}`} aria-hidden="true" />
							<h3 className="text-sm font-semibold text-ink">{titulo}</h3>
							<span className="ml-auto text-xs text-muted tabular-nums">
								{pinos.length} {pinos.length === 1 ? "pino" : "pinos"}
							</span>
						</div>

						<ul className="mt-3 flex flex-wrap gap-1.5">
							{pinos.map((p) => (
								<li key={p} className="rounded-md border border-line bg-surface px-2 py-1 font-mono text-xs text-ink-soft">
									{p}
								</li>
							))}
						</ul>

						<p className="mt-3 text-sm leading-relaxed text-muted">{explicacao}</p>
					</div>
				))}
			</div>

			<div className="mt-6 flex flex-col justify-between gap-4 border-t border-line pt-5 sm:flex-row sm:items-center">
				<p className="max-w-xl text-sm leading-relaxed text-muted">
					Estes grupos vêm dos mesmos dados do diagrama de conexões. Lá você vê pino a pino
					todas as funções, o domínio de alimentação e os avisos completos.
				</p>
				<Link href="#connections" className="btn btn-ghost shrink-0">
					Abrir diagrama de pinos
					<ArrowRight className="h-4 w-4" aria-hidden="true" />
				</Link>
			</div>
		</section>
	);
}