Indicador.

<figure class="ui-sample ui-chart" data-renderer="cochid-graphs" data-chart="gauge"><figcaption>Ejecución del presupuesto municipal · al 31 de julio de 2026</figcaption><svg viewBox="0 0 320 120" aria-hidden="true"><path d="M98 86A62 62 0 0 1 222 86" class="ui-chart__pista"></path><path d="M98 86A62 62 0 0 1 163.9 24.1" class="ui-chart__avance"></path><path d="M172.9 37.7L179.1 14.5" class="ui-chart__meta"></path><path d="M160 86L162.8 42.1" class="ui-chart__aguja"></path><circle cx="160" cy="86" r="5" class="ui-chart__pivote"></circle><text x="185" y="12" class="ui-chart__rotulo ui-chart__rotulo--chico">Meta 58,3%</text><text x="98" y="101" text-anchor="middle" class="ui-chart__rotulo ui-chart__rotulo--chico">0%</text><text x="222" y="101" text-anchor="middle" class="ui-chart__rotulo ui-chart__rotulo--chico">100%</text><text x="160" y="112" text-anchor="middle" class="ui-chart__valor ui-chart__valor--grande">52,0%</text></svg><p>Fuente: informe de ejecución presupuestaria · julio 2026 · porcentaje del presupuesto vigente</p><details><summary>Ver datos</summary><table><thead><tr><th>Indicador</th><th>Valor</th></tr></thead><tbody><tr><th>Gasto ejecutado</th><td>52,0%</td></tr><tr><th>Meta al 31 de julio</th><td>58,3%</td></tr></tbody></table></details></figure>

<figure class="ui-sample ui-chart border border-slate-300 bg-white p-4 text-slate-950 grid gap-3" data-renderer="cochid-graphs" data-chart="gauge"><figcaption class="text-sm text-slate-600">Ejecución del presupuesto municipal · al 31 de julio de 2026</figcaption><svg class="h-auto w-full" viewBox="0 0 320 120" aria-hidden="true"><path d="M98 86A62 62 0 0 1 222 86" class="ui-chart__pista"></path><path d="M98 86A62 62 0 0 1 163.9 24.1" class="ui-chart__avance"></path><path d="M172.9 37.7L179.1 14.5" class="ui-chart__meta"></path><path d="M160 86L162.8 42.1" class="ui-chart__aguja"></path><circle cx="160" cy="86" r="5" class="ui-chart__pivote"></circle><text x="185" y="12" class="ui-chart__rotulo ui-chart__rotulo--chico">Meta 58,3%</text><text x="98" y="101" text-anchor="middle" class="ui-chart__rotulo ui-chart__rotulo--chico">0%</text><text x="222" y="101" text-anchor="middle" class="ui-chart__rotulo ui-chart__rotulo--chico">100%</text><text x="160" y="112" text-anchor="middle" class="ui-chart__valor ui-chart__valor--grande">52,0%</text></svg><p>Fuente: informe de ejecución presupuestaria · julio 2026 · porcentaje del presupuesto vigente</p><details><summary>Ver datos</summary><table class="w-full border-collapse text-left"><thead><tr><th class="border-b border-slate-300 p-2 align-top">Indicador</th><th class="border-b border-slate-300 p-2 align-top">Valor</th></tr></thead><tbody><tr><th class="border-b border-slate-300 p-2 align-top">Gasto ejecutado</th><td class="border-b border-slate-300 p-2 align-top">52,0%</td></tr><tr><th class="border-b border-slate-300 p-2 align-top">Meta al 31 de julio</th><td class="border-b border-slate-300 p-2 align-top">58,3%</td></tr></tbody></table></details></figure>

import type { ReactNode } from "react";

export interface ChartGaugeRow {
  /** Etiqueta de la fila (período, región, categoría); va en la primera columna como encabezado de fila. */
  label: string;
  /** Una celda por cada columna después de la primera, con el valor ya formateado. */
  values: string[];
}

export interface ChartGaugeProps {
  /** Título del gráfico (`<figcaption>`); vacío lo oculta. */
  title?: string;
  /** SVG del gráfico, con `aria-hidden="true"`; sin él se dibuja el esquema de la muestra. */
  children?: ReactNode;
  /** Línea de fuente, período y unidad bajo el gráfico; vacía la oculta. */
  source?: string;
  /** Encabezados de la tabla de datos; el primero corresponde a la etiqueta de cada fila. */
  columns?: string[];
  /** Filas de la tabla de datos, con los mismos valores que dibuja el gráfico; sin filas no hay tabla. */
  rows?: ChartGaugeRow[];
  /** Texto del control que despliega la tabla. */
  dataLabel?: string;
  /** Muestra la tabla desplegada (atributo nativo `open` de `<details>`). */
  dataOpen?: boolean;
  /** Renderer que produjo el SVG (`data-renderer`); vacío omite el atributo. */
  renderer?: string;
  className?: string;
}

// Colores y tipografía con clases del kit (ui-chart__*), no con style: un atributo
// de presentación SVG no acepta var() y un sitio con CSP estricto bloquea el style en línea.

// Arco de 0 % (izquierda) a 100 % (derecha), radio 62; aguja y arco azul en 52 %, marca de meta en 58,3 %.
const ESQUEMA = (
  <svg viewBox="0 0 320 120" aria-hidden="true">
    <path d="M98 86A62 62 0 0 1 222 86" className="ui-chart__pista" />
    <path d="M98 86A62 62 0 0 1 163.9 24.1" className="ui-chart__avance" />
    <path d="M172.9 37.7L179.1 14.5" className="ui-chart__meta" />
    <path d="M160 86L162.8 42.1" className="ui-chart__aguja" />
    <circle cx="160" cy="86" r="5" className="ui-chart__pivote" />
    <text x="185" y="12" className="ui-chart__rotulo ui-chart__rotulo--chico">Meta 58,3%</text>
    <text x="98" y="101" textAnchor="middle" className="ui-chart__rotulo ui-chart__rotulo--chico">0%</text>
    <text x="222" y="101" textAnchor="middle" className="ui-chart__rotulo ui-chart__rotulo--chico">100%</text>
    <text x="160" y="112" textAnchor="middle" className="ui-chart__valor ui-chart__valor--grande">52,0%</text>
  </svg>
);

const FILAS: ChartGaugeRow[] = [
  { label: "Gasto ejecutado", values: ["52,0%"] },
  { label: "Meta al 31 de julio", values: ["58,3%"] },
];

/**
 * Indicador de aguja: un valor único sobre un arco graduado, para mostrar el avance hacia una meta o la distancia a un umbral.
 *
 * El SVG llega como `children` desde cochid-graphs u otro renderer y va oculto a lectores de pantalla: la tabla bajo «Ver datos» es la versión accesible y debe traer los mismos datos. `data-chart="gauge"` identifica el tipo de gráfico.
 *
 * @example <ChartGauge title="Ejecución presupuestaria · jul 2026" columns={["Indicador", "Valor"]} rows={[{ label: "Ejecutado", values: ["58%"] }, { label: "Meta anual", values: ["100%"] }]}>{indicador}</ChartGauge>
 */
export function ChartGauge({
  title = "Ejecución del presupuesto municipal · al 31 de julio de 2026",
  children = ESQUEMA,
  source = "Fuente: informe de ejecución presupuestaria · julio 2026 · porcentaje del presupuesto vigente",
  columns = ["Indicador", "Valor"],
  rows = FILAS,
  dataLabel = "Ver datos",
  dataOpen,
  renderer = "cochid-graphs",
  className,
}: ChartGaugeProps) {
  return (
    <figure className={["ui-chart", className].filter(Boolean).join(" ")} data-renderer={renderer || undefined} data-chart="gauge">
      {title ? <figcaption>{title}</figcaption> : null}
      {children}
      {source ? <p>{source}</p> : null}
      {rows.length ? (
        <details open={dataOpen}>
          <summary>{dataLabel}</summary>
          <table>
            {columns.length ? (
              <thead>
                <tr>{columns.map((columna, i) => <th key={i}>{columna}</th>)}</tr>
              </thead>
            ) : null}
            <tbody>
              {rows.map((fila, i) => (
                <tr key={i}>
                  <th>{fila.label}</th>
                  {fila.values.map((valor, j) => <td key={j}>{valor}</td>)}
                </tr>
              ))}
            </tbody>
          </table>
        </details>
      ) : null}
    </figure>
  );
}