csv-charts-ai 1.7.0 → 1.9.0

package/README.md

@@ -7,10 +7,12 @@ AI-powered CSV analysis, chart generation, and interactive visualization. Built
 ## Installation
 
 ```bash
-pnpm add csv-charts-ai ai zod
+pnpm add csv-charts-ai
 ```
 
-**Peer dependencies:** `ai`, `zod` (required). `react`, `recharts`, `lucide-react` (optional — only needed for React chart components).
+All AI SDKs (`ai`, `zod`, `@ai-sdk/openai`, `@ai-sdk/anthropic`, `@ai-sdk/google`, `@ai-sdk/mistral`) and `read-excel-file` are bundled — no extra installs needed.
+
+**Optional peer dependencies** (only for React chart components): `react`, `recharts`, `lucide-react`.
 
 ## Quick Start
 
@@ -67,6 +69,33 @@ console.log(data.columns);   // [{ name: "name", type: "string", index: 0 }, ...
 
 > For very large files or exotic encodings, consider using [PapaParse](https://www.papaparse.com/) and passing the result as `TabularData` directly.
 
+## XLSX Parsing
+
+Parse Excel (.xlsx) files into the same `TabularData` format. `read-excel-file` is bundled.
+
+### Browser
+
+```ts
+import { parseXLSX } from "csv-charts-ai";
+
+const data = await parseXLSX(file); // File from <input> or drag-and-drop
+console.log(data.headers, data.rowCount);
+```
+
+### Node.js / Universal
+
+Use `convertXLSXRows` with any XLSX reader — it takes raw row arrays and has zero dependencies:
+
+```ts
+import readXlsxFile from "read-excel-file/node";
+import { convertXLSXRows } from "csv-charts-ai";
+
+const rows = await readXlsxFile("data.xlsx");
+const data = convertXLSXRows(rows);
+```
+
+Options: `{ hasHeader?: boolean, skipEmpty?: boolean }` — same defaults as `parseCSV`.
+
 ## AI Functions
 
 All AI functions accept either a simple config object or a pre-built `LanguageModel` from the Vercel AI SDK. All support an optional `signal` (AbortSignal) for cancellation.
@@ -247,14 +276,19 @@ useEffect(() => {
 }, [data]);
 ```
 
-## React Components
+## React Components (`csv-charts-ai/charts`)
 
-> **Requires** `react`, `recharts`, `lucide-react`, and **Tailwind CSS** for styling.
+Chart components are available as a **separate entry point** so projects that only need AI/parsing don't pull in React, Recharts, or Lucide.
+
+```bash
+# Optional peer dependencies — only needed if you import from csv-charts-ai/charts
+pnpm add react recharts lucide-react
+```
 
 ### Display Charts
 
 ```tsx
-import { ChartDisplay } from "csv-charts-ai";
+import { ChartDisplay } from "csv-charts-ai/charts";
 
 <ChartDisplay data={data} charts={charts} />
 ```
@@ -262,7 +296,7 @@ import { ChartDisplay } from "csv-charts-ai";
 ### With Theme
 
 ```tsx
-import { ChartDisplay, defaultLightTheme } from "csv-charts-ai";
+import { ChartDisplay, defaultLightTheme } from "csv-charts-ai/charts";
 
 <ChartDisplay data={data} charts={charts} theme={defaultLightTheme} />
 ```
@@ -270,6 +304,9 @@ import { ChartDisplay, defaultLightTheme } from "csv-charts-ai";
 ### Custom Card Wrapper
 
 ```tsx
+import { ChartDisplay } from "csv-charts-ai/charts";
+import { repairChart } from "csv-charts-ai";
+
 <ChartDisplay
   data={data}
   charts={charts}
@@ -309,7 +346,7 @@ You can also pass `className` to any component to add classes alongside the buil
 
 ### Headless Usage (No React)
 
-The AI functions and CSV parsing work without React — use them in Node.js scripts, APIs, or CLI tools:
+The core entry point (`csv-charts-ai`) works without React — use it in Node.js scripts, APIs, or CLI tools:
 
 ```ts
 import { parseCSV, analyzeData } from "csv-charts-ai";
@@ -326,7 +363,7 @@ const result = await analyzeData({
 console.log(result.summary.keyInsights);
 ```
 
-## Components Reference
+## Components Reference (`csv-charts-ai/charts`)
 
 | Export | Description |
 |--------|-------------|
@@ -355,9 +392,14 @@ console.log(result.summary.keyInsights);
 | Export | Description |
 |--------|-------------|
 | `parseCSV(csv, options?)` | Parse CSV string into `TabularData` |
+| `parseXLSX(file, options?)` | Parse XLSX file into `TabularData` (browser) |
+| `convertXLSXRows(rows, options?)` | Convert raw XLSX rows into `TabularData` (universal) |
+| `computeDiff(dataA, dataB, options)` | Compare two datasets (index, key, or content matching) |
 | `createModel(config)` | Create a LanguageModel from an AIConfig |
-| `resolveModel(input)` | Resolve AIConfig or LanguageModel to LanguageModel |
-| `summarizeTabularData(data)` | Generate text summary for AI consumption |
+| `createAppModel(config)` | Create a LanguageModel from multi-provider app config |
+| `resolveModel(input)` | Resolve AIConfig, AppModelConfig, or LanguageModel |
+| `generateDataSummary(data)` | Detailed human-readable data summary with sample rows |
+| `summarizeTabularData(data)` | Compact data summary for AI prompt consumption |
 | `getAIErrorMessage(error)` | Extract user-friendly error messages |
 | `processChartData(data, chart)` | Process and aggregate chart data |
 | `processChartDataMultiSeries(data, chart)` | Multi-series data processing |
@@ -380,16 +422,37 @@ Multi-series supported via `groupBy` for bar, line, and area charts.
 
 `sum` | `avg` | `count` | `min` | `max` | `none`
 
+## CSV Diff
+
+Compare two datasets and detect added, removed, and changed rows:
+
+```ts
+import { computeDiff } from "csv-charts-ai";
+
+const diff = computeDiff(dataA, dataB, { matchMode: "key", keyColumn: "id" });
+
+console.log(diff.counts); // { same: 10, changed: 3, added: 2, removed: 1 }
+diff.rows.forEach(r => {
+  if (r.status === "changed") {
+    console.log(`Row ${r.indexA}: changed columns: ${[...r.changedCols].join(", ")}`);
+  }
+});
+```
+
+Match modes: `"index"` (positional), `"key"` (by column value), `"content"` (full row match).
+
 ## Provider Support
 
-| Provider | Config | Extra install |
-|----------|--------|---------------|
-| OpenAI | `{ apiKey, model }` | None (bundled) |
-| Ollama / vLLM / LM Studio | `{ apiKey: "", model, baseURL }` | None |
-| Mistral (via OpenAI compat) | `{ apiKey, model, baseURL: "https://api.mistral.ai/v1" }` | None |
-| Anthropic | `{ provider: "anthropic", apiKey, model }` | `@ai-sdk/anthropic` |
-| Google | `{ provider: "google", apiKey, model }` | `@ai-sdk/google` |
-| Any LanguageModel | Pass instance directly | Provider SDK |
+All provider SDKs are bundled — no extra installs needed.
+
+| Provider | Config |
+|----------|--------|
+| OpenAI | `{ apiKey, model }` |
+| Anthropic | `{ provider: "anthropic", apiKey, model }` |
+| Google | `{ provider: "google", apiKey, model }` |
+| Mistral | `{ provider: "mistral", apiKey, model }` |
+| Ollama / vLLM / LM Studio | `{ apiKey: "", model, baseURL }` |
+| Any LanguageModel | Pass instance directly |
 
 ## License
 

package/dist/charts.d.ts

@@ -0,0 +1,69 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { T as TabularData, C as ChartConfig, c as ChartTheme, d as ChartType, S as SortOrder } from './constants-hUsrIT8W.js';
+export { A as AggregationType, a as COLORS, b as ChartDataPoint, P as ProcessedChartResult, e as defaultDarkTheme, f as defaultLightTheme, p as processChartData, g as processChartDataMultiSeries } from './constants-hUsrIT8W.js';
+
+interface ChartDisplayProps {
+    data: TabularData;
+    charts: ChartConfig[];
+    onRegenerate?: (chart: ChartConfig) => Promise<void>;
+    /** Optional wrapper component for each chart card */
+    cardWrapper?: React.ComponentType<{
+        children: React.ReactNode;
+        title?: string;
+        className?: string;
+    }>;
+    /** Optional theme override */
+    theme?: ChartTheme;
+    /** Additional CSS class for the outer container */
+    className?: string;
+    /** Additional CSS class for each chart card */
+    chartClassName?: string;
+    /** Additional CSS class for chart title */
+    titleClassName?: string;
+    /** Additional CSS class for chart description */
+    descriptionClassName?: string;
+    /** When true, removes all built-in Tailwind classes. You must style everything yourself. */
+    unstyled?: boolean;
+}
+declare function ChartDisplay({ data, charts, onRegenerate, cardWrapper: CardWrapper, theme, className, chartClassName, titleClassName, descriptionClassName, unstyled, }: ChartDisplayProps): react_jsx_runtime.JSX.Element | null;
+
+interface SingleChartProps {
+    data: TabularData;
+    chart: ChartConfig;
+    onRegenerate?: (chart: ChartConfig) => Promise<void>;
+    /** Additional CSS class for the chart container */
+    className?: string;
+    /** When true, removes all built-in Tailwind classes from toolbar and metadata tags */
+    unstyled?: boolean;
+}
+declare function SingleChart({ data, chart, onRegenerate, className, unstyled }: SingleChartProps): react_jsx_runtime.JSX.Element;
+
+interface ChartToolbarProps {
+    chartType: ChartType;
+    sortOrder: SortOrder;
+    limitResults: number;
+    showBrush: boolean;
+    showTrendline: boolean;
+    isRegenerating: boolean;
+    hasRegenerate: boolean;
+    onToggleSort: () => void;
+    onLimitChange: (limit: number) => void;
+    onToggleBrush: () => void;
+    onToggleTrendline: () => void;
+    onExportCSV: () => void;
+    onExportPNG: () => void;
+    onRegenerate: () => void;
+    /** Additional CSS class for the toolbar container */
+    className?: string;
+    /** When true, removes all built-in Tailwind classes */
+    unstyled?: boolean;
+}
+declare function ChartToolbar({ chartType, sortOrder, limitResults, showBrush, showTrendline, isRegenerating, hasRegenerate, onToggleSort, onLimitChange, onToggleBrush, onToggleTrendline, onExportCSV, onExportPNG, onRegenerate, className, unstyled, }: ChartToolbarProps): react_jsx_runtime.JSX.Element;
+
+declare function ChartThemeProvider({ theme, children, }: {
+    theme: ChartTheme;
+    children: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+declare function useChartTheme(): ChartTheme;
+
+export { ChartConfig, ChartDisplay, type ChartDisplayProps, ChartTheme, ChartThemeProvider, ChartToolbar, ChartType, SingleChart, type SingleChartProps, SortOrder, TabularData, useChartTheme };