@gugacoder/agentic-chat 0.2.0

package/src/display/CarouselRenderer.tsx

@@ -0,0 +1,141 @@
+import type { DisplayCarousel } from "@gugacoder/agentic-sdk";
+import useEmblaCarousel from "embla-carousel-react";
+import { ChevronLeft, ChevronRight } from "lucide-react";
+import { useCallback, useEffect, useState } from "react";
+import { Badge } from "../ui/badge";
+import { Button } from "../ui/button";
+import { Card, CardContent } from "../ui/card";
+import { cn } from "../lib/utils";
+
+function formatPrice(value: number, currency: string): string {
+  return new Intl.NumberFormat("pt-BR", { style: "currency", currency }).format(value);
+}
+
+export function CarouselRenderer({ title, items }: DisplayCarousel) {
+  const [emblaRef, emblaApi] = useEmblaCarousel({ loop: false, dragFree: false });
+  const [selectedIndex, setSelectedIndex] = useState(0);
+  const [canScrollPrev, setCanScrollPrev] = useState(false);
+  const [canScrollNext, setCanScrollNext] = useState(false);
+
+  const onSelect = useCallback(() => {
+    if (!emblaApi) return;
+    setSelectedIndex(emblaApi.selectedScrollSnap());
+    setCanScrollPrev(emblaApi.canScrollPrev());
+    setCanScrollNext(emblaApi.canScrollNext());
+  }, [emblaApi]);
+
+  useEffect(() => {
+    if (!emblaApi) return;
+    onSelect();
+    emblaApi.on("select", onSelect);
+    emblaApi.on("reInit", onSelect);
+    return () => {
+      emblaApi.off("select", onSelect);
+      emblaApi.off("reInit", onSelect);
+    };
+  }, [emblaApi, onSelect]);
+
+  const scrollPrev = useCallback(() => emblaApi?.scrollPrev(), [emblaApi]);
+  const scrollNext = useCallback(() => emblaApi?.scrollNext(), [emblaApi]);
+
+  return (
+    <div className="flex flex-col gap-3">
+      {title && <p className="text-sm font-medium text-foreground">{title}</p>}
+
+      <div className="flex items-center gap-2">
+        <Button
+          variant="outline"
+          size="icon"
+          className="rounded-full shrink-0"
+          onClick={scrollPrev}
+          disabled={!canScrollPrev}
+          aria-label="Anterior"
+          type="button"
+        >
+          <ChevronLeft className="h-4 w-4" />
+        </Button>
+
+        <div className="overflow-hidden flex-1" ref={emblaRef}>
+          <div className="flex">
+            {items.map((item, index) => (
+              <div key={index} className="flex-[0_0_80%] min-w-0 pl-3 first:pl-0">
+                {item.url ? (
+                  <a href={item.url} target="_blank" rel="noopener noreferrer" className="block">
+                    <CarouselCard item={item} />
+                  </a>
+                ) : (
+                  <CarouselCard item={item} />
+                )}
+              </div>
+            ))}
+          </div>
+        </div>
+
+        <Button
+          variant="outline"
+          size="icon"
+          className="rounded-full shrink-0"
+          onClick={scrollNext}
+          disabled={!canScrollNext}
+          aria-label="Próximo"
+          type="button"
+        >
+          <ChevronRight className="h-4 w-4" />
+        </Button>
+      </div>
+
+      {items.length > 1 && (
+        <div className="flex items-center justify-center gap-1.5" role="tablist" aria-label="Slides">
+          {items.map((_, index) => (
+            <button
+              key={index}
+              className={cn(
+                "w-2 h-2 rounded-full transition-colors",
+                index === selectedIndex ? "bg-primary" : "bg-muted"
+              )}
+              onClick={() => emblaApi?.scrollTo(index)}
+              role="tab"
+              aria-selected={index === selectedIndex}
+              aria-label={`Slide ${index + 1}`}
+              type="button"
+            />
+          ))}
+        </div>
+      )}
+    </div>
+  );
+}
+
+type CarouselItem = DisplayCarousel["items"][number];
+
+function CarouselCard({ item }: { item: CarouselItem }) {
+  return (
+    <Card className="overflow-hidden">
+      {item.image && (
+        <div className="aspect-video overflow-hidden">
+          <img src={item.image} alt={item.title} loading="lazy" className="w-full h-full object-cover" />
+        </div>
+      )}
+      <CardContent className="p-3 space-y-1">
+        <p className="font-medium text-sm text-foreground">{item.title}</p>
+        {item.subtitle && (
+          <p className="text-xs text-muted-foreground">{item.subtitle}</p>
+        )}
+        {item.price && (
+          <p className="text-sm font-bold text-foreground">
+            {formatPrice(item.price.value, item.price.currency)}
+          </p>
+        )}
+        {item.badges && item.badges.length > 0 && (
+          <div className="flex flex-wrap gap-1 pt-1">
+            {item.badges.map((badge, i) => (
+              <Badge key={i} variant={(badge.variant as string) === "destructive" ? "destructive" : (badge.variant as string) === "secondary" ? "secondary" : "default"}>
+                {badge.label}
+              </Badge>
+            ))}
+          </div>
+        )}
+      </CardContent>
+    </Card>
+  );
+}

package/src/display/ChartRenderer.tsx

@@ -0,0 +1,195 @@
+import type { DisplayChart } from "@gugacoder/agentic-sdk";
+import {
+  AreaChart,
+  Area,
+  BarChart,
+  Bar,
+  LineChart,
+  Line,
+  PieChart,
+  Pie,
+  Cell,
+  CartesianGrid,
+  Tooltip,
+  ResponsiveContainer,
+  XAxis,
+  YAxis,
+} from "recharts";
+import { Card } from "../ui/card";
+
+const CHART_COLORS = [
+  "var(--chart-1)",
+  "var(--chart-2)",
+  "var(--chart-3)",
+  "var(--chart-4)",
+  "var(--chart-5)",
+];
+
+const AXIS_PROPS = {
+  stroke: "var(--border)",
+  tick: { fill: "var(--muted-foreground)", fontSize: 12 },
+};
+
+const TOOLTIP_STYLE = {
+  contentStyle: {
+    background: "var(--card)",
+    border: "1px solid var(--border)",
+    color: "var(--card-foreground)",
+    borderRadius: "0.375rem",
+    fontSize: "0.75rem",
+  },
+};
+
+function formatValue(value: number, format?: DisplayChart["format"]): string {
+  if (!format) return String(value);
+  const locale = format.locale ?? "pt-BR";
+  const prefix = format.prefix ?? "";
+  const suffix = format.suffix ?? "";
+  if (prefix.includes("R$") || prefix.includes("$") || prefix.includes("€")) {
+    const currencyMap: Record<string, string> = {
+      "R$": "BRL",
+      "$": "USD",
+      "€": "EUR",
+    };
+    const currency = Object.keys(currencyMap).find(k => prefix.includes(k));
+    if (currency) {
+      return new Intl.NumberFormat(locale, { style: "currency", currency: currencyMap[currency] }).format(value);
+    }
+  }
+  if (suffix.includes("%")) {
+    return new Intl.NumberFormat(locale, { style: "percent", maximumFractionDigits: 1 }).format(value / 100);
+  }
+  const formatted = new Intl.NumberFormat(locale).format(value);
+  return `${prefix}${formatted}${suffix}`;
+}
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function makeTooltipFormatter(format?: DisplayChart["format"]): any {
+  return (value: number | string | undefined): [string, string] => [
+    typeof value === "number" ? formatValue(value, format) : String(value ?? ""),
+    "",
+  ];
+}
+
+export function ChartRenderer({ type, title, data, format }: DisplayChart) {
+  const chartData = data.map((d) => ({ name: d.label, value: d.value, color: d.color }));
+  const tooltipFormatter = makeTooltipFormatter(format);
+
+  const sharedProps = {
+    data: chartData,
+    margin: { top: 4, right: 8, left: 8, bottom: 4 },
+  };
+
+  return (
+    <Card className="p-4">
+      {title && <p className="text-sm font-medium text-foreground mb-4">{title}</p>}
+      <div className="min-h-[200px]">
+        <ResponsiveContainer width="100%" height={200}>
+          {renderChart(type, chartData, sharedProps, tooltipFormatter)}
+        </ResponsiveContainer>
+      </div>
+    </Card>
+  );
+}
+
+function renderChart(
+  type: DisplayChart["type"],
+  data: Array<{ name: string; value: number; color?: string }>,
+  sharedProps: { data: typeof data; margin: { top: number; right: number; left: number; bottom: number } },
+  tooltipFormatter: (v: number | string | undefined) => [string, string]
+) {
+  switch (type) {
+    case "bar":
+      return (
+        <BarChart {...sharedProps}>
+          <CartesianGrid strokeDasharray="3 3" stroke="var(--border)" />
+          <XAxis dataKey="name" {...AXIS_PROPS} />
+          <YAxis width={48} {...AXIS_PROPS} />
+          <Tooltip formatter={tooltipFormatter} {...TOOLTIP_STYLE} />
+          <Bar dataKey="value" radius={[4, 4, 0, 0]}>
+            {data.map((entry, index) => (
+              <Cell key={index} fill={entry.color ?? CHART_COLORS[index % CHART_COLORS.length]} />
+            ))}
+          </Bar>
+        </BarChart>
+      );
+
+    case "line":
+      return (
+        <LineChart {...sharedProps}>
+          <CartesianGrid strokeDasharray="3 3" stroke="var(--border)" />
+          <XAxis dataKey="name" {...AXIS_PROPS} />
+          <YAxis width={48} {...AXIS_PROPS} />
+          <Tooltip formatter={tooltipFormatter} {...TOOLTIP_STYLE} />
+          <Line
+            type="monotone"
+            dataKey="value"
+            stroke={CHART_COLORS[0]}
+            strokeWidth={2}
+            dot={{ r: 4, fill: CHART_COLORS[0] }}
+          />
+        </LineChart>
+      );
+
+    case "area":
+      return (
+        <AreaChart {...sharedProps}>
+          <CartesianGrid strokeDasharray="3 3" stroke="var(--border)" />
+          <XAxis dataKey="name" {...AXIS_PROPS} />
+          <YAxis width={48} {...AXIS_PROPS} />
+          <Tooltip formatter={tooltipFormatter} {...TOOLTIP_STYLE} />
+          <Area
+            type="monotone"
+            dataKey="value"
+            stroke={CHART_COLORS[0]}
+            fill={CHART_COLORS[0]}
+            fillOpacity={0.2}
+            strokeWidth={2}
+          />
+        </AreaChart>
+      );
+
+    case "pie":
+      return (
+        <PieChart>
+          <Tooltip formatter={tooltipFormatter} {...TOOLTIP_STYLE} />
+          <Pie
+            data={data}
+            dataKey="value"
+            nameKey="name"
+            cx="50%"
+            cy="50%"
+            outerRadius="70%"
+            label={({ name }) => name}
+            labelLine={{ stroke: "var(--muted-foreground)" }}
+          >
+            {data.map((entry, index) => (
+              <Cell key={index} fill={entry.color ?? CHART_COLORS[index % CHART_COLORS.length]} />
+            ))}
+          </Pie>
+        </PieChart>
+      );
+
+    case "donut":
+      return (
+        <PieChart>
+          <Tooltip formatter={tooltipFormatter} {...TOOLTIP_STYLE} />
+          <Pie
+            data={data}
+            dataKey="value"
+            nameKey="name"
+            cx="50%"
+            cy="50%"
+            innerRadius="40%"
+            outerRadius="70%"
+            label={({ name }) => name}
+            labelLine={{ stroke: "var(--muted-foreground)" }}
+          >
+            {data.map((entry, index) => (
+              <Cell key={index} fill={entry.color ?? CHART_COLORS[index % CHART_COLORS.length]} />
+            ))}
+          </Pie>
+        </PieChart>
+      );
+  }
+}

package/src/display/ChoiceButtonsRenderer.tsx

@@ -0,0 +1,114 @@
+import type { DisplayChoices } from "@gugacoder/agentic-sdk";
+import { useState } from "react";
+import { Button } from "../ui/button.js";
+import { Card } from "../ui/card.js";
+import { cn } from "../lib/utils.js";
+
+type ChoiceButtonsProps = DisplayChoices & {
+  onChoiceSelect?: (value: string) => void;
+};
+
+export function ChoiceButtonsRenderer({
+  question,
+  choices,
+  layout,
+  onChoiceSelect,
+}: ChoiceButtonsProps) {
+  const [selected, setSelected] = useState<string | null>(null);
+
+  function handleSelect(id: string) {
+    setSelected(id);
+    onChoiceSelect?.(id);
+  }
+
+  return (
+    <div className="space-y-3 w-fit">
+      {question && <p className="text-sm font-medium text-foreground">{question}</p>}
+
+      <div
+        className={cn(
+          layout === "buttons" && "flex flex-wrap gap-2",
+          layout === "cards" && "grid grid-cols-1 sm:grid-cols-2 gap-2",
+          layout === "list" && "flex flex-col gap-1"
+        )}
+        role="group"
+        aria-label={question ?? "Escolha uma opção"}
+      >
+        {choices.map((choice) => {
+          const isSelected = selected === choice.id;
+
+          if (layout === "buttons") {
+            return (
+              <Button
+                key={choice.id}
+                variant="outline"
+                size="sm"
+                onClick={() => handleSelect(choice.id)}
+                aria-pressed={isSelected}
+                className={cn(isSelected && "ring-2 ring-ring")}
+              >
+                {choice.icon && (
+                  <span aria-hidden="true">{choice.icon}</span>
+                )}
+                {choice.label}
+              </Button>
+            );
+          }
+
+          if (layout === "cards") {
+            return (
+              <Card
+                key={choice.id}
+                className={cn(
+                  "p-3 cursor-pointer hover:bg-muted/50 transition-colors",
+                  isSelected && "ring-2 ring-ring"
+                )}
+                onClick={() => handleSelect(choice.id)}
+                role="button"
+                aria-pressed={isSelected}
+              >
+                {choice.icon && (
+                  <span className="text-base" aria-hidden="true">{choice.icon}</span>
+                )}
+                <span className="block font-medium text-sm text-foreground">{choice.label}</span>
+                {choice.description && (
+                  <span className="block text-xs text-muted-foreground mt-1">{choice.description}</span>
+                )}
+              </Card>
+            );
+          }
+
+          // list
+          return (
+            <button
+              key={choice.id}
+              className={cn(
+                "flex items-center gap-3 w-full rounded-md px-3 py-2 text-sm text-left hover:bg-muted transition-colors",
+                isSelected && "bg-muted ring-1 ring-ring"
+              )}
+              onClick={() => handleSelect(choice.id)}
+              aria-pressed={isSelected}
+            >
+              <span
+                className={cn(
+                  "w-4 h-4 rounded-full border-2 border-input flex-shrink-0",
+                  isSelected && "border-primary bg-primary"
+                )}
+                aria-hidden="true"
+              />
+              <span className="flex items-center gap-2 flex-1 min-w-0">
+                {choice.icon && (
+                  <span aria-hidden="true">{choice.icon}</span>
+                )}
+                <span className="font-medium text-foreground">{choice.label}</span>
+                {choice.description && (
+                  <span className="text-xs text-muted-foreground ml-auto">{choice.description}</span>
+                )}
+              </span>
+            </button>
+          );
+        })}
+      </div>
+    </div>
+  );
+}

package/src/display/CodeBlockRenderer.tsx

@@ -0,0 +1,49 @@
+import type { DisplayCode } from "@gugacoder/agentic-sdk";
+import { Check, Copy } from "lucide-react";
+import { useState } from "react";
+import { Button } from "../ui/button.js";
+import { cn } from "../lib/utils.js";
+
+export function CodeBlockRenderer({ language, code, title, lineNumbers }: DisplayCode) {
+  const [copied, setCopied] = useState(false);
+
+  async function handleCopy() {
+    await navigator.clipboard.writeText(code);
+    setCopied(true);
+    setTimeout(() => setCopied(false), 2000);
+  }
+
+  const displayLines = lineNumbers
+    ? code.split("\n").map((line, i) => (
+        <span key={i} className="flex gap-4">
+          <span className="select-none text-muted-foreground w-6 text-right shrink-0">{i + 1}</span>
+          <span>{line}</span>
+        </span>
+      ))
+    : code;
+
+  return (
+    <div className={cn("rounded-md border border-border bg-muted/30 overflow-hidden")}>
+      <div className="flex items-center justify-between px-3 py-1.5 border-b border-border">
+        <span className="text-xs text-muted-foreground font-mono">{title ?? language}</span>
+        <Button
+          variant="ghost"
+          size="sm"
+          onClick={handleCopy}
+          aria-label={copied ? "Copiado!" : "Copiar código"}
+          className="h-7 gap-1.5"
+        >
+          {copied ? <Check className="h-3 w-3" /> : <Copy className="h-3 w-3" />}
+          <span className="text-xs">{copied ? "Copiado!" : "Copiar"}</span>
+        </Button>
+      </div>
+      <pre className="p-4 overflow-x-auto font-mono text-sm">
+        {lineNumbers ? (
+          <code>{displayLines}</code>
+        ) : (
+          <code>{code}</code>
+        )}
+      </pre>
+    </div>
+  );
+}

package/src/display/ComparisonTableRenderer.tsx

@@ -0,0 +1,132 @@
+import { useState } from "react";
+import type { DisplayComparison } from "@gugacoder/agentic-sdk";
+import { CheckCircle } from "lucide-react";
+import { ScrollArea, ScrollBar } from "../ui/scroll-area.js";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "../ui/table.js";
+import { cn } from "../lib/utils.js";
+
+function formatMoney(value: number, currency = "BRL") {
+  return new Intl.NumberFormat("pt-BR", { style: "currency", currency }).format(value);
+}
+
+export function ComparisonTableRenderer({ title, items, attributes }: DisplayComparison) {
+  const [bestIdx, setBestIdx] = useState<number | null>(null);
+
+  // Auto-detect best value by lowest price if no manual selection
+  const lowestPriceIdx = items.reduce<number | null>((acc, item, i) => {
+    if (!item.price) return acc;
+    if (acc === null) return i;
+    const best = items[acc]?.price;
+    return best && item.price.value < best.value ? i : acc;
+  }, null);
+
+  const highlightIdx = bestIdx ?? lowestPriceIdx;
+
+  return (
+    <div className="space-y-2">
+      {title && <h3 className="text-sm font-semibold text-foreground">{title}</h3>}
+
+      <ScrollArea className="w-full">
+        <Table>
+          <TableHeader>
+            <TableRow>
+              <TableHead className="font-semibold text-center">Atributo</TableHead>
+              {items.map((item, i) => (
+                <TableHead
+                  key={i}
+                  className={cn(
+                    "font-semibold text-center",
+                    i === highlightIdx && "bg-muted"
+                  )}
+                >
+                  <button
+                    className="flex flex-col items-center gap-0.5 w-full cursor-pointer hover:opacity-80"
+                    onClick={() => setBestIdx(i === bestIdx ? null : i)}
+                    title="Marcar como melhor"
+                  >
+                    {i === highlightIdx && (
+                      <CheckCircle className="h-3.5 w-3.5 text-primary" />
+                    )}
+                    <span className="font-semibold">{item.title}</span>
+                    {item.price && (
+                      <span className="text-xs text-muted-foreground font-normal">
+                        {formatMoney(item.price.value, item.price.currency)}
+                      </span>
+                    )}
+                  </button>
+                </TableHead>
+              ))}
+            </TableRow>
+          </TableHeader>
+
+          <TableBody>
+            {attributes && attributes.length > 0 ? (
+              attributes.map((attr, ri) => (
+                <TableRow key={ri}>
+                  <TableCell className="font-medium">{attr.label}</TableCell>
+                  {items.map((item, ci) => {
+                    const val = (item as Record<string, unknown>)[attr.key];
+                    return (
+                      <TableCell
+                        key={ci}
+                        className={cn(
+                          "text-center",
+                          ci === highlightIdx && "bg-muted/50"
+                        )}
+                      >
+                        {val === true ? "✓" : val === false ? "✗" : val != null ? String(val) : "—"}
+                      </TableCell>
+                    );
+                  })}
+                </TableRow>
+              ))
+            ) : (
+              <>
+                {items.some((i) => i.rating) && (
+                  <TableRow>
+                    <TableCell className="font-medium">Avaliação</TableCell>
+                    {items.map((item, ci) => (
+                      <TableCell
+                        key={ci}
+                        className={cn(
+                          "text-center",
+                          ci === highlightIdx && "bg-muted/50"
+                        )}
+                      >
+                        {item.rating ? `${item.rating.score}/5 (${item.rating.count})` : "—"}
+                      </TableCell>
+                    ))}
+                  </TableRow>
+                )}
+                {items.some((i) => i.description) && (
+                  <TableRow>
+                    <TableCell className="font-medium">Descrição</TableCell>
+                    {items.map((item, ci) => (
+                      <TableCell
+                        key={ci}
+                        className={cn(
+                          "text-center",
+                          ci === highlightIdx && "bg-muted/50"
+                        )}
+                      >
+                        {item.description ?? "—"}
+                      </TableCell>
+                    ))}
+                  </TableRow>
+                )}
+              </>
+            )}
+          </TableBody>
+        </Table>
+        <ScrollBar orientation="horizontal" />
+      </ScrollArea>
+    </div>
+  );
+}