csv-charts-ai 1.3.2 → 1.4.0

package/dist/index.js

@@ -1,13 +1,34 @@
 // package.json
 var package_default = {
   name: "csv-charts-ai",
-  version: "1.3.2",
+  version: "1.4.0",
+  description: "AI-powered CSV analysis, chart generation, and interactive visualization. Parse CSV, detect anomalies, suggest charts, and ask questions about your data using any LLM provider.",
   type: "module",
+  license: "MIT",
+  author: "maxgfr",
+  homepage: "https://github.com/maxgfr/csv-ai-analyzer/tree/main/packages/csv-charts-ai#readme",
+  bugs: {
+    url: "https://github.com/maxgfr/csv-ai-analyzer/issues"
+  },
   repository: {
     type: "git",
     url: "https://github.com/maxgfr/csv-ai-analyzer",
     directory: "packages/csv-charts-ai"
   },
+  keywords: [
+    "csv",
+    "ai",
+    "charts",
+    "data-analysis",
+    "visualization",
+    "llm",
+    "openai",
+    "anthropic",
+    "recharts",
+    "tabular-data",
+    "anomaly-detection",
+    "chart-generation"
+  ],
   main: "./dist/index.js",
   types: "./dist/index.d.ts",
   exports: {
@@ -21,7 +42,10 @@ var package_default = {
   ],
   scripts: {
     build: "tsup",
-    dev: "tsup --watch"
+    dev: "tsup --watch",
+    test: "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   peerDependencies: {
     ai: "^5.0.0 || ^6.0.0",
@@ -43,12 +67,14 @@ var package_default = {
   },
   devDependencies: {
     "@types/react": "^19.2.7",
+    "@vitest/coverage-v8": "^4.1.0",
     ai: "^6.0.134",
     "lucide-react": "^0.556.0",
     react: "^19.2.4",
     recharts: "^3.5.1",
     tsup: "^8.5.0",
     typescript: "^5.9.3",
+    vitest: "^4.1.0",
     zod: "^4.1.13"
   },
   publishConfig: {
@@ -62,6 +88,172 @@ var package_default = {
 // src/version.ts
 var VERSION = package_default.version;
 
+// src/csv-parser.ts
+function parseCSV(csv, options = {}) {
+  const { hasHeader = true, skipEmpty = true } = options;
+  const normalized = csv.replace(/^\uFEFF/, "").replace(/\r\n/g, "\n").replace(/\r/g, "\n").trim();
+  if (normalized.length === 0) {
+    return { headers: [], rows: [], columns: [], rowCount: 0 };
+  }
+  const delimiter = options.delimiter ?? detectDelimiter(normalized);
+  const allRows = parseRows(normalized, delimiter, skipEmpty);
+  if (allRows.length === 0) {
+    return { headers: [], rows: [], columns: [], rowCount: 0 };
+  }
+  const expectedCols = allRows[0].length;
+  const normalizedRows = allRows.map((row) => {
+    if (row.length < expectedCols) {
+      return [...row, ...Array(expectedCols - row.length).fill("")];
+    }
+    return row.slice(0, expectedCols);
+  });
+  const headers = hasHeader ? normalizedRows[0] : normalizedRows[0].map((_, i) => `Column ${i + 1}`);
+  const dataRows = hasHeader ? normalizedRows.slice(1) : normalizedRows;
+  const columns = headers.map((name, index) => ({
+    name: name.trim(),
+    type: inferColumnType(dataRows, index),
+    index
+  }));
+  return {
+    headers: headers.map((h) => h.trim()),
+    rows: dataRows,
+    columns,
+    rowCount: dataRows.length
+  };
+}
+function detectDelimiter(csv) {
+  const firstLines = csv.split("\n").slice(0, 5);
+  const candidates = {
+    ",": [],
+    ";": [],
+    "	": [],
+    "|": []
+  };
+  for (const line of firstLines) {
+    let inQuotes = false;
+    const counts = { ",": 0, ";": 0, "	": 0, "|": 0 };
+    for (const char of line) {
+      if (char === '"') {
+        inQuotes = !inQuotes;
+      } else if (!inQuotes && char in counts) {
+        counts[char]++;
+      }
+    }
+    for (const [delim, count] of Object.entries(counts)) {
+      candidates[delim].push(count);
+    }
+  }
+  let best = ",";
+  let bestScore = -1;
+  for (const [delim, counts] of Object.entries(candidates)) {
+    if (counts.length === 0 || counts[0] === 0) continue;
+    const allSame = counts.every((c) => c === counts[0]);
+    const avgCount = counts.reduce((a, b) => a + b, 0) / counts.length;
+    const score = (allSame ? 1e3 : 0) + avgCount;
+    if (score > bestScore) {
+      bestScore = score;
+      best = delim;
+    }
+  }
+  return best;
+}
+function parseRows(csv, delimiter, skipEmpty) {
+  const rows = [];
+  let current = [];
+  let field = "";
+  let inQuotes = false;
+  for (let i = 0; i < csv.length; i++) {
+    const char = csv[i];
+    if (inQuotes) {
+      if (char === '"') {
+        if (i + 1 < csv.length && csv[i + 1] === '"') {
+          field += '"';
+          i++;
+        } else {
+          inQuotes = false;
+        }
+      } else {
+        field += char;
+      }
+    } else {
+      if (char === '"') {
+        inQuotes = true;
+      } else if (char === delimiter) {
+        current.push(field);
+        field = "";
+      } else if (char === "\n") {
+        current.push(field);
+        if (!skipEmpty || current.some((c) => c.trim() !== "")) {
+          rows.push(current);
+        }
+        current = [];
+        field = "";
+      } else {
+        field += char;
+      }
+    }
+  }
+  current.push(field);
+  if (!skipEmpty || current.some((c) => c.trim() !== "")) {
+    rows.push(current);
+  }
+  return rows;
+}
+var BOOLEAN_VALUES = /* @__PURE__ */ new Set([
+  "true",
+  "false",
+  "yes",
+  "no",
+  "vrai",
+  "faux",
+  "oui",
+  "non"
+]);
+var DATE_PATTERNS = [
+  /^\d{4}-\d{2}-\d{2}$/,
+  // 2024-01-15
+  /^\d{2}\/\d{2}\/\d{4}$/,
+  // 01/15/2024
+  /^\d{2}-\d{2}-\d{4}$/,
+  // 01-15-2024
+  /^\d{4}\/\d{2}\/\d{2}$/,
+  // 2024/01/15
+  /^\d{4}-\d{2}-\d{2}T/,
+  // ISO 8601
+  /^\d{2}\.\d{2}\.\d{4}$/,
+  // 15.01.2024
+  /^\w{3,9}\s\d{1,2},?\s\d{4}$/
+  // Jan 15, 2024 / January 15, 2024
+];
+function inferColumnType(rows, colIndex) {
+  const sampleSize = Math.min(rows.length, 100);
+  let numbers = 0;
+  let dates = 0;
+  let booleans = 0;
+  let total = 0;
+  for (let i = 0; i < sampleSize; i++) {
+    const value = rows[i]?.[colIndex]?.trim() ?? "";
+    if (value === "") continue;
+    total++;
+    if (BOOLEAN_VALUES.has(value.toLowerCase())) {
+      booleans++;
+    }
+    const cleaned = value.replace(/[\s,]/g, "");
+    if (cleaned !== "" && !isNaN(Number(cleaned))) {
+      numbers++;
+    }
+    if (DATE_PATTERNS.some((p) => p.test(value))) {
+      dates++;
+    }
+  }
+  if (total === 0) return "string";
+  const threshold = 0.8;
+  if (booleans / total >= threshold && numbers / total < 0.5) return "boolean";
+  if (dates / total >= threshold) return "date";
+  if (numbers / total >= threshold) return "number";
+  return "string";
+}
+
 // src/types.ts
 var defaultDarkTheme = {
   colors: [
@@ -363,31 +555,40 @@ function ChartToolbar({
   onToggleTrendline,
   onExportCSV,
   onExportPNG,
-  onRegenerate
+  onRegenerate,
+  className,
+  unstyled = false
 }) {
   const supportsBrush = chartType === "line" || chartType === "area" || chartType === "bar";
   const supportsTrendline = chartType === "bar" || chartType === "line" || chartType === "area";
-  return /* @__PURE__ */ jsxs("div", { className: "mb-4 flex flex-wrap items-center gap-2 rounded-xl border border-white/10 bg-white/5 p-3", children: [
+  const cls = (defaultCls) => unstyled ? "" : defaultCls;
+  const activeCls = (active, activeCls2, inactiveCls) => unstyled ? "" : `flex items-center gap-1.5 rounded-lg px-3 py-1.5 text-sm transition-colors ${active ? activeCls2 : inactiveCls}`;
+  return /* @__PURE__ */ jsxs("div", { className: unstyled ? className ?? "" : `mb-4 flex flex-wrap items-center gap-2 rounded-xl border border-white/10 bg-white/5 p-3 ${className ?? ""}`.trim(), children: [
     /* @__PURE__ */ jsxs(
       "button",
       {
         onClick: onToggleSort,
-        className: `flex items-center gap-1.5 rounded-lg px-3 py-1.5 text-sm transition-colors ${sortOrder !== "none" ? "border border-violet-500/30 bg-violet-500/20 text-violet-400" : "bg-white/5 text-gray-400 hover:bg-white/10 hover:text-white"}`,
+        className: activeCls(
+          sortOrder !== "none",
+          "border border-violet-500/30 bg-violet-500/20 text-violet-400",
+          "bg-white/5 text-gray-400 hover:bg-white/10 hover:text-white"
+        ),
         title: "Sort by value",
         children: [
-          sortOrder === "asc" ? /* @__PURE__ */ jsx2(SortAsc, { className: "h-4 w-4" }) : sortOrder === "desc" ? /* @__PURE__ */ jsx2(SortDesc, { className: "h-4 w-4" }) : /* @__PURE__ */ jsx2(SortDesc, { className: "h-4 w-4 opacity-50" }),
+          sortOrder === "asc" ? /* @__PURE__ */ jsx2(SortAsc, { className: "h-4 w-4" }) : sortOrder === "desc" ? /* @__PURE__ */ jsx2(SortDesc, { className: "h-4 w-4" }) : /* @__PURE__ */ jsx2(SortDesc, { className: cls("h-4 w-4 opacity-50") }),
           "Sort"
         ]
       }
     ),
-    /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
-      /* @__PURE__ */ jsx2(Filter, { className: "h-4 w-4 text-gray-400" }),
+    /* @__PURE__ */ jsxs("div", { className: cls("flex items-center gap-2"), children: [
+      /* @__PURE__ */ jsx2(Filter, { className: cls("h-4 w-4 text-gray-400"), "aria-hidden": "true" }),
       /* @__PURE__ */ jsxs(
         "select",
         {
           value: limitResults,
           onChange: (e) => onLimitChange(Number(e.target.value)),
-          className: "rounded-lg border border-white/10 bg-white/5 px-2 py-1.5 text-sm text-gray-300 focus:border-violet-500/50 focus:outline-none",
+          "aria-label": "Limit number of results",
+          className: cls("rounded-lg border border-white/10 bg-white/5 px-2 py-1.5 text-sm text-gray-300 focus:border-violet-500/50 focus:outline-none"),
           children: [
             /* @__PURE__ */ jsx2("option", { value: 10, children: "Top 10" }),
             /* @__PURE__ */ jsx2("option", { value: 20, children: "Top 20" }),
@@ -402,7 +603,11 @@ function ChartToolbar({
       "button",
       {
         onClick: onToggleBrush,
-        className: `flex items-center gap-1.5 rounded-lg px-3 py-1.5 text-sm transition-colors ${showBrush ? "border border-cyan-500/30 bg-cyan-500/20 text-cyan-400" : "bg-white/5 text-gray-400 hover:bg-white/10 hover:text-white"}`,
+        className: activeCls(
+          showBrush,
+          "border border-cyan-500/30 bg-cyan-500/20 text-cyan-400",
+          "bg-white/5 text-gray-400 hover:bg-white/10 hover:text-white"
+        ),
         title: "Enable zoom/brush",
         children: [
           /* @__PURE__ */ jsx2(RotateCcw, { className: "h-4 w-4" }),
@@ -414,7 +619,11 @@ function ChartToolbar({
       "button",
       {
         onClick: onToggleTrendline,
-        className: `flex items-center gap-1.5 rounded-lg px-3 py-1.5 text-sm transition-colors ${showTrendline ? "border border-emerald-500/30 bg-emerald-500/20 text-emerald-400" : "bg-white/5 text-gray-400 hover:bg-white/10 hover:text-white"}`,
+        className: activeCls(
+          showTrendline,
+          "border border-emerald-500/30 bg-emerald-500/20 text-emerald-400",
+          "bg-white/5 text-gray-400 hover:bg-white/10 hover:text-white"
+        ),
         title: "Show average line",
         children: [
           /* @__PURE__ */ jsx2(TrendingUp, { className: "h-4 w-4" }),
@@ -422,12 +631,12 @@ function ChartToolbar({
         ]
       }
     ),
-    /* @__PURE__ */ jsx2("div", { className: "flex-1" }),
+    /* @__PURE__ */ jsx2("div", { className: cls("flex-1") }),
     /* @__PURE__ */ jsxs(
       "button",
       {
         onClick: onExportPNG,
-        className: "flex items-center gap-1.5 rounded-lg bg-white/5 px-3 py-1.5 text-sm text-gray-400 transition-colors hover:bg-white/10 hover:text-white",
+        className: cls("flex items-center gap-1.5 rounded-lg bg-white/5 px-3 py-1.5 text-sm text-gray-400 transition-colors hover:bg-white/10 hover:text-white"),
         title: "Export chart as PNG image",
         children: [
           /* @__PURE__ */ jsx2(Image2, { className: "h-4 w-4" }),
@@ -439,7 +648,7 @@ function ChartToolbar({
       "button",
       {
         onClick: onExportCSV,
-        className: "flex items-center gap-1.5 rounded-lg bg-white/5 px-3 py-1.5 text-sm text-gray-400 transition-colors hover:bg-white/10 hover:text-white",
+        className: cls("flex items-center gap-1.5 rounded-lg bg-white/5 px-3 py-1.5 text-sm text-gray-400 transition-colors hover:bg-white/10 hover:text-white"),
         title: "Export chart data as CSV",
         children: [
           /* @__PURE__ */ jsx2(Download, { className: "h-4 w-4" }),
@@ -452,7 +661,7 @@ function ChartToolbar({
       {
         onClick: onRegenerate,
         disabled: isRegenerating,
-        className: "flex items-center gap-1.5 rounded-lg bg-violet-500/20 px-3 py-1.5 text-sm text-violet-400 transition-colors hover:bg-violet-500/30 disabled:opacity-50",
+        className: cls("flex items-center gap-1.5 rounded-lg bg-violet-500/20 px-3 py-1.5 text-sm text-violet-400 transition-colors hover:bg-violet-500/30 disabled:opacity-50"),
         children: [
           /* @__PURE__ */ jsx2(
             RefreshCw,
@@ -469,7 +678,7 @@ function ChartToolbar({
 
 // src/SingleChart.tsx
 import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
-function SingleChart({ data, chart, onRegenerate }) {
+function SingleChart({ data, chart, onRegenerate, className, unstyled = false }) {
   const theme = useChartTheme();
   const chartContainerRef = useRef(null);
   const [isRegenerating, setIsRegenerating] = useState(false);
@@ -851,9 +1060,9 @@ ${rows}`;
     }
   };
   if (processedData.length === 0) {
-    return /* @__PURE__ */ jsx3("div", { className: "flex h-[300px] flex-col items-center justify-center gap-4 text-gray-400", children: /* @__PURE__ */ jsxs2("div", { className: "text-center", children: [
-      /* @__PURE__ */ jsx3("p", { className: "mb-1 font-medium text-red-400", children: "Unable to generate this chart" }),
-      /* @__PURE__ */ jsxs2("p", { className: "mb-4 text-sm text-gray-500", children: [
+    return /* @__PURE__ */ jsx3("div", { className: unstyled ? className ?? "" : `flex h-[300px] flex-col items-center justify-center gap-4 text-gray-400 ${className ?? ""}`.trim(), children: /* @__PURE__ */ jsxs2("div", { className: unstyled ? "" : "text-center", children: [
+      /* @__PURE__ */ jsx3("p", { className: unstyled ? "" : "mb-1 font-medium text-red-400", children: "Unable to generate this chart" }),
+      /* @__PURE__ */ jsxs2("p", { className: unstyled ? "" : "mb-4 text-sm text-gray-500", children: [
         "Columns: ",
         chart.xAxis,
         ", ",
@@ -864,7 +1073,7 @@ ${rows}`;
         {
           onClick: handleRegenerate,
           disabled: isRegenerating,
-          className: "flex items-center gap-2 rounded-lg bg-violet-600 px-4 py-2 text-sm text-white transition-colors hover:bg-violet-500 disabled:opacity-50",
+          className: unstyled ? "" : "flex items-center gap-2 rounded-lg bg-violet-600 px-4 py-2 text-sm text-white transition-colors hover:bg-violet-500 disabled:opacity-50",
           children: [
             /* @__PURE__ */ jsx3(
               RefreshCw2,
@@ -878,7 +1087,7 @@ ${rows}`;
       )
     ] }) });
   }
-  return /* @__PURE__ */ jsxs2("div", { children: [
+  return /* @__PURE__ */ jsxs2("div", { className, children: [
     /* @__PURE__ */ jsx3(
       ChartToolbar,
       {
@@ -895,10 +1104,11 @@ ${rows}`;
         onToggleTrendline: () => setShowTrendline(!showTrendline),
         onExportCSV: handleExportCSV,
         onExportPNG: handleExportPNG,
-        onRegenerate: handleRegenerate
+        onRegenerate: handleRegenerate,
+        unstyled
       }
     ),
-    /* @__PURE__ */ jsx3("div", { className: "h-[450px] w-full", ref: chartContainerRef, children: /* @__PURE__ */ jsx3(
+    /* @__PURE__ */ jsx3("div", { className: unstyled ? "" : "h-[450px] w-full", style: unstyled ? { height: 450, width: "100%" } : void 0, ref: chartContainerRef, children: /* @__PURE__ */ jsx3(
       ResponsiveContainer,
       {
         width: "100%",
@@ -915,25 +1125,25 @@ ${rows}`;
       },
       `chart-${chart.id}-${showBrush ? "brush" : "no-brush"}`
     ) }),
-    /* @__PURE__ */ jsxs2("div", { className: "mt-4 flex flex-wrap gap-2", children: [
-      /* @__PURE__ */ jsxs2("span", { className: "rounded bg-white/10 px-2 py-0.5 text-xs text-gray-400", children: [
+    /* @__PURE__ */ jsxs2("div", { className: unstyled ? "" : "mt-4 flex flex-wrap gap-2", children: [
+      /* @__PURE__ */ jsxs2("span", { className: unstyled ? "" : "rounded bg-white/10 px-2 py-0.5 text-xs text-gray-400", children: [
         "X: ",
         chart.xAxis
       ] }),
-      /* @__PURE__ */ jsxs2("span", { className: "rounded bg-white/10 px-2 py-0.5 text-xs text-gray-400", children: [
+      /* @__PURE__ */ jsxs2("span", { className: unstyled ? "" : "rounded bg-white/10 px-2 py-0.5 text-xs text-gray-400", children: [
         "Y: ",
         chart.yAxis
       ] }),
-      chart.groupBy && /* @__PURE__ */ jsxs2("span", { className: "rounded bg-cyan-500/20 px-2 py-0.5 text-xs text-cyan-300", children: [
+      chart.groupBy && /* @__PURE__ */ jsxs2("span", { className: unstyled ? "" : "rounded bg-cyan-500/20 px-2 py-0.5 text-xs text-cyan-300", children: [
         "Group: ",
         chart.groupBy
       ] }),
-      chart.aggregation && chart.aggregation !== "none" && /* @__PURE__ */ jsx3("span", { className: "rounded bg-violet-500/20 px-2 py-0.5 text-xs text-violet-300", children: chart.aggregation }),
-      /* @__PURE__ */ jsxs2("span", { className: "rounded bg-white/10 px-2 py-0.5 text-xs text-gray-400", children: [
+      chart.aggregation && chart.aggregation !== "none" && /* @__PURE__ */ jsx3("span", { className: unstyled ? "" : "rounded bg-violet-500/20 px-2 py-0.5 text-xs text-violet-300", children: chart.aggregation }),
+      /* @__PURE__ */ jsxs2("span", { className: unstyled ? "" : "rounded bg-white/10 px-2 py-0.5 text-xs text-gray-400", children: [
         processedData.length,
         " items"
       ] }),
-      isMultiSeries && /* @__PURE__ */ jsxs2("span", { className: "rounded bg-emerald-500/20 px-2 py-0.5 text-xs text-emerald-300", children: [
+      isMultiSeries && /* @__PURE__ */ jsxs2("span", { className: unstyled ? "" : "rounded bg-emerald-500/20 px-2 py-0.5 text-xs text-emerald-300", children: [
         seriesKeys.length,
         " series"
       ] })
@@ -954,23 +1164,34 @@ function ChartDisplay({
   charts,
   onRegenerate,
   cardWrapper: CardWrapper = DefaultCard,
-  theme = defaultDarkTheme
+  theme = defaultDarkTheme,
+  className,
+  chartClassName,
+  titleClassName,
+  descriptionClassName,
+  unstyled = false
 }) {
   if (charts.length === 0) return null;
-  return /* @__PURE__ */ jsx4(ChartThemeProvider, { theme, children: /* @__PURE__ */ jsx4("div", { className: "animate-fade-in space-y-6", children: charts.map((chart) => /* @__PURE__ */ jsx4(
+  const containerCls = unstyled ? className ?? "" : `animate-fade-in space-y-6 ${className ?? ""}`.trim();
+  const cardCls = unstyled ? chartClassName ?? "" : `overflow-hidden rounded-2xl border border-white/10 bg-slate-900/50 ${chartClassName ?? ""}`.trim();
+  const titleCls = unstyled ? titleClassName ?? "" : `mb-2 bg-linear-to-r from-violet-400 to-fuchsia-400 bg-clip-text text-xl font-bold text-transparent ${titleClassName ?? ""}`.trim();
+  const descCls = unstyled ? descriptionClassName ?? "" : `mb-4 text-gray-400 ${descriptionClassName ?? ""}`.trim();
+  const innerCls = unstyled ? "" : "p-6";
+  return /* @__PURE__ */ jsx4(ChartThemeProvider, { theme, children: /* @__PURE__ */ jsx4("div", { className: containerCls, children: charts.map((chart) => /* @__PURE__ */ jsx4(
     CardWrapper,
     {
       title: chart.title,
-      className: "overflow-hidden rounded-2xl border border-white/10 bg-slate-900/50",
-      children: /* @__PURE__ */ jsxs3("div", { className: "p-6", children: [
-        /* @__PURE__ */ jsx4("h3", { className: "mb-2 bg-linear-to-r from-violet-400 to-fuchsia-400 bg-clip-text text-xl font-bold text-transparent", children: chart.title }),
-        /* @__PURE__ */ jsx4("p", { className: "mb-4 text-gray-400", children: chart.description }),
+      className: cardCls,
+      children: /* @__PURE__ */ jsxs3("div", { className: innerCls, children: [
+        /* @__PURE__ */ jsx4("h3", { className: titleCls, children: chart.title }),
+        /* @__PURE__ */ jsx4("p", { className: descCls, children: chart.description }),
         /* @__PURE__ */ jsx4(
           SingleChart,
           {
             data,
             chart,
-            onRegenerate
+            onRegenerate,
+            unstyled
           }
         )
       ] })
@@ -1041,6 +1262,10 @@ var SingleChartResponseSchema = z.object({
   chart: ChartSuggestionSchema
 });
 function getAIErrorMessage(error) {
+  if (error instanceof Error && error.name === "ZodError" && "issues" in error) {
+    const issues = error.issues;
+    return `Invalid data: ${issues.map((i) => i.message).join(", ")}`;
+  }
   if (error instanceof Error) {
     const message = error.message.toLowerCase();
     if (message.includes("rate limit") || message.includes("429")) {
@@ -1073,8 +1298,8 @@ function summarizeTabularData(data) {
     if (col.type === "number") {
       const nums = values.map(Number).filter((n) => !isNaN(n));
       if (nums.length > 0) {
-        const min = Math.min(...nums);
-        const max = Math.max(...nums);
+        const min = nums.reduce((a, b) => b < a ? b : a, nums[0]);
+        const max = nums.reduce((a, b) => b > a ? b : a, nums[0]);
         const avg = nums.reduce((a, b) => a + b, 0) / nums.length;
         lines.push(
           `- ${col.name} (${col.type}): min=${min}, max=${max}, avg=${avg.toFixed(2)}, ${nums.length} values`
@@ -1202,10 +1427,10 @@ function mapChartResult(raw, id) {
   };
 }
 async function suggestCharts(options) {
-  const { data, language, temperature = 0.5 } = options;
+  const { data, language, temperature = 0.5, signal } = options;
   const dataSummary = options.dataSummary ?? summarizeTabularData(data);
-  TabularDataSchema.parse(data);
   try {
+    TabularDataSchema.parse(data);
     const model = await resolveModel(options.model);
     const { object } = await generateObject({
       model,
@@ -1214,7 +1439,8 @@ async function suggestCharts(options) {
       prompt: `Analyze this CSV data and suggest the best charts:
 
 ${dataSummary}`,
-      temperature
+      temperature,
+      ...signal && { abortSignal: signal }
     });
     return object.charts.map(
       (s, i) => mapChartResult(s, `chart-${i}-${Date.now()}`)
@@ -1224,10 +1450,10 @@ ${dataSummary}`,
   }
 }
 async function suggestCustomChart(options) {
-  const { data, prompt, language, temperature = 0.5 } = options;
+  const { data, prompt, language, temperature = 0.5, signal } = options;
   const dataSummary = options.dataSummary ?? summarizeTabularData(data);
-  TabularDataSchema.parse(data);
   try {
+    TabularDataSchema.parse(data);
     const model = await resolveModel(options.model);
     const { object } = await generateObject({
       model,
@@ -1237,7 +1463,8 @@ async function suggestCustomChart(options) {
 ${dataSummary}
 
 User request: ${prompt}`,
-      temperature
+      temperature,
+      ...signal && { abortSignal: signal }
     });
     return mapChartResult(object.chart, `chart-custom-${Date.now()}`);
   } catch (error) {
@@ -1250,7 +1477,8 @@ async function repairChart(options) {
     columns,
     errorContext,
     language,
-    temperature = 0.3
+    temperature = 0.3,
+    signal
   } = options;
   try {
     const model = await resolveModel(options.model);
@@ -1264,7 +1492,8 @@ ${JSON.stringify(failedChart, null, 2)}
 Error context: ${errorContext}
 
 Please fix the configuration to use valid columns and aggregation. Available columns: ${columns.join(", ")}`,
-      temperature
+      temperature,
+      ...signal && { abortSignal: signal }
     });
     return mapChartResult(object.chart, failedChart.id);
   } catch (error) {
@@ -1318,14 +1547,20 @@ Analyze ALL rows provided. Return empty array if no anomalies found.`;
 var questionSystemPrompt = (language) => `You are a data analysis expert.${language ? ` Respond in ${language}.` : ""}
 
 The user will ask questions about a CSV dataset. Respond clearly and precisely.`;
+function escapeCSVField(value) {
+  if (value.includes(",") || value.includes('"') || value.includes("\n") || value.includes("\r")) {
+    return `"${value.replace(/"/g, '""')}"`;
+  }
+  return value;
+}
 function buildSampleCSV(data, maxRows = 50) {
-  const header = data.headers.join(",");
-  const rows = data.rows.slice(0, maxRows).map((row) => row.join(",")).join("\n");
+  const header = data.headers.map(escapeCSVField).join(",");
+  const rows = data.rows.slice(0, maxRows).map((row) => row.map(escapeCSVField).join(",")).join("\n");
   return `${header}
 ${rows}`;
 }
 async function summarizeData(options) {
-  const { data, language, temperature = 0.5 } = options;
+  const { data, language, temperature = 0.5, signal } = options;
   const dataSummary = options.dataSummary ?? summarizeTabularData(data);
   try {
     const model = await resolveModel(options.model);
@@ -1336,7 +1571,8 @@ async function summarizeData(options) {
       prompt: `Here is the data to analyze:
 
 ${dataSummary}`,
-      temperature
+      temperature,
+      ...signal && { abortSignal: signal }
     });
     return {
       summary: object.summary,
@@ -1348,7 +1584,7 @@ ${dataSummary}`,
   }
 }
 async function detectAnomalies(options) {
-  const { data, maxRows = 50, language, temperature = 0.3 } = options;
+  const { data, maxRows = 50, language, temperature = 0.3, signal } = options;
   const dataSummary = options.dataSummary ?? summarizeTabularData(data);
   const sampleCSV = buildSampleCSV(data, maxRows);
   try {
@@ -1362,7 +1598,8 @@ ${dataSummary}
 
 Data to analyze (CSV format):
 ${sampleCSV}`,
-      temperature
+      temperature,
+      ...signal && { abortSignal: signal }
     });
     return object.anomalies;
   } catch (error) {
@@ -1370,7 +1607,7 @@ ${sampleCSV}`,
   }
 }
 async function askAboutData(options) {
-  const { data, question, history = [], language, temperature = 0.5 } = options;
+  const { data, question, history = [], language, temperature = 0.5, signal } = options;
   const dataSummary = options.dataSummary ?? summarizeTabularData(data);
   try {
     const model = await resolveModel(options.model);
@@ -1388,7 +1625,8 @@ ${historyText}
 ${dataSummary}
 
 ${contextPrompt}User question: ${question}`,
-      temperature
+      temperature,
+      ...signal && { abortSignal: signal }
     });
     return text;
   } catch (error) {
@@ -1402,6 +1640,7 @@ async function streamAskAboutData(options) {
     history = [],
     language,
     temperature = 0.5,
+    signal,
     onChunk,
     onComplete
   } = options;
@@ -1424,6 +1663,7 @@ ${dataSummary}
 
 ${contextPrompt}User question: ${question}`,
       temperature,
+      ...signal && { abortSignal: signal },
       onError: ({ error }) => {
         streamError = error instanceof Error ? error : new Error(String(error));
       }
@@ -1447,17 +1687,58 @@ async function analyzeData(options) {
   const {
     data,
     language,
+    signal,
     detectAnomalies: runAnomalies = true,
     suggestCharts: runCharts = true
   } = options;
   const dataSummary = options.dataSummary ?? summarizeTabularData(data);
   const [summary, anomalies, charts] = await Promise.all([
-    summarizeData({ model: options.model, data, dataSummary, language }),
-    runAnomalies ? detectAnomalies({ model: options.model, data, dataSummary, language }) : Promise.resolve([]),
-    runCharts ? suggestCharts({ model: options.model, data, dataSummary, language }) : Promise.resolve([])
+    summarizeData({ model: options.model, data, dataSummary, language, signal }),
+    runAnomalies ? detectAnomalies({ model: options.model, data, dataSummary, language, signal }) : Promise.resolve([]),
+    runCharts ? suggestCharts({ model: options.model, data, dataSummary, language, signal }) : Promise.resolve([])
   ]);
   return { summary, anomalies, charts };
 }
+var questionsSystemPrompt = (language) => `You are a data analysis expert.${language ? ` Respond in ${language}.` : ""}
+
+Given a dataset summary, suggest insightful questions that a user could ask to better understand their data. Focus on:
+- Trends and patterns
+- Comparisons and rankings
+- Correlations between columns
+- Outliers and anomalies
+- Actionable business insights
+
+Each question should be specific to the data columns available.`;
+var QuestionsResponseSchema = z2.object({
+  questions: z2.array(
+    z2.object({
+      question: z2.string().describe("The question to ask about the data"),
+      category: z2.enum(["trend", "comparison", "correlation", "anomaly", "insight"]).describe("Category of the question")
+    })
+  ).describe("5-8 suggested questions")
+});
+async function suggestQuestions(options) {
+  const { data, language, count = 6, temperature = 0.7, signal } = options;
+  const dataSummary = options.dataSummary ?? summarizeTabularData(data);
+  try {
+    const model = await resolveModel(options.model);
+    const { object } = await generateObject2({
+      model,
+      schema: QuestionsResponseSchema,
+      system: questionsSystemPrompt(language),
+      prompt: `Here is the dataset to analyze:
+
+${dataSummary}
+
+Suggest ${count} insightful questions about this data.`,
+      temperature,
+      ...signal && { abortSignal: signal }
+    });
+    return object.questions.slice(0, count);
+  } catch (error) {
+    throw new Error(getAIErrorMessage(error));
+  }
+}
 export {
   AIConfigSchema,
   COLORS,
@@ -1474,6 +1755,7 @@ export {
   defaultLightTheme,
   detectAnomalies,
   getAIErrorMessage,
+  parseCSV,
   processChartData,
   processChartDataMultiSeries,
   repairChart,
@@ -1481,6 +1763,7 @@ export {
   streamAskAboutData,
   suggestCharts,
   suggestCustomChart,
+  suggestQuestions,
   summarizeData,
   summarizeTabularData,
   useChartTheme