@nucleux/chart 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nucleux
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# @nucleux/chart
+
+Composable chart primitives — Nucleux agentic UI for React.
+
+Part of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** — agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).
+
+## Install
+
+```bash
+pnpm add @nucleux/chart @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { Chart } from "@nucleux/chart";
+```
+
+Requires the theme once in your app: `import "@nucleux/tokens/styles.css";`
+and the Tailwind preset from `@nucleux/tokens/preset`.
+
+## License
+
+MIT © Nucleux

package/dist/index.cjs

@@ -0,0 +1,120 @@
+"use client";
+'use strict';
+
+var React = require('react');
+var recharts = require('recharts');
+var utils = require('@nucleux/utils');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+// src/index.tsx
+var ChartTooltip = recharts.Tooltip;
+var ChartLegend = recharts.Legend;
+var ChartContainer = React__namespace.forwardRef(
+  ({ config, className, children, style, ...props }, ref) => {
+    const colorVars = React__namespace.useMemo(() => {
+      const vars = {};
+      for (const [key, cfg] of Object.entries(config)) {
+        if (cfg.color) vars[`--color-${key}`] = cfg.color;
+      }
+      return vars;
+    }, [config]);
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        ref,
+        "data-chart": "",
+        className: utils.cn(
+          "flex aspect-video justify-center text-xs [&_.recharts-cartesian-grid_line]:stroke-border/50 [&_.recharts-text]:fill-muted-foreground",
+          className
+        ),
+        style: { ...colorVars, ...style },
+        ...props,
+        children: /* @__PURE__ */ jsxRuntime.jsx(recharts.ResponsiveContainer, { width: "100%", height: "100%", children })
+      }
+    );
+  }
+);
+ChartContainer.displayName = "ChartContainer";
+var ChartTooltipContent = React__namespace.forwardRef(
+  ({ active, payload, label, config }, ref) => {
+    if (!active || !payload?.length) return null;
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      "div",
+      {
+        ref,
+        className: "min-w-32 rounded-lg border border-border bg-background px-3 py-2 text-sm shadow-md",
+        children: [
+          label != null && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "mb-1 font-medium text-foreground", children: label }),
+          /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex flex-col gap-1", children: payload.map((item, i) => {
+            const key = String(item.dataKey ?? item.name ?? i);
+            const name = config?.[key]?.label ?? item.name ?? key;
+            return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center justify-between gap-3", children: [
+              /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex items-center gap-1.5 text-muted-foreground", children: [
+                /* @__PURE__ */ jsxRuntime.jsx(
+                  "span",
+                  {
+                    "aria-hidden": true,
+                    className: "h-2 w-2 rounded-[2px]",
+                    style: { background: item.color ?? `var(--color-${key})` }
+                  }
+                ),
+                name
+              ] }),
+              /* @__PURE__ */ jsxRuntime.jsx("span", { className: "font-medium tabular-nums text-foreground", children: item.value })
+            ] }, i);
+          }) })
+        ]
+      }
+    );
+  }
+);
+ChartTooltipContent.displayName = "ChartTooltipContent";
+var ChartLegendContent = React__namespace.forwardRef(
+  ({ payload, config }, ref) => {
+    if (!payload?.length) return null;
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: "flex flex-wrap items-center justify-center gap-4 pt-3", children: payload.map((item, i) => {
+      const key = String(item.dataKey ?? item.value ?? i);
+      const name = config?.[key]?.label ?? item.value ?? key;
+      return /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex items-center gap-1.5 text-xs text-muted-foreground", children: [
+        /* @__PURE__ */ jsxRuntime.jsx(
+          "span",
+          {
+            "aria-hidden": true,
+            className: "h-2 w-2 rounded-[2px]",
+            style: { background: item.color ?? `var(--color-${key})` }
+          }
+        ),
+        name
+      ] }, i);
+    }) });
+  }
+);
+ChartLegendContent.displayName = "ChartLegendContent";
+
+exports.ChartContainer = ChartContainer;
+exports.ChartLegend = ChartLegend;
+exports.ChartLegendContent = ChartLegendContent;
+exports.ChartTooltip = ChartTooltip;
+exports.ChartTooltipContent = ChartTooltipContent;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":["Tooltip","Legend","React","jsx","cn","ResponsiveContainer","jsxs"],"mappings":"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","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { Legend, ResponsiveContainer, Tooltip } from \"recharts\";\nimport { cn } from \"@nucleux/utils\";\n\nexport interface ChartSeriesConfig {\n  label?: React.ReactNode;\n  /** CSS color; exposed to children as `var(--color-<key>)`. */\n  color?: string;\n}\nexport type ChartConfig = Record<string, ChartSeriesConfig>;\n\n/** Re-exported recharts Tooltip — pair with {@link ChartTooltipContent}. */\nexport const ChartTooltip = Tooltip;\n/** Re-exported recharts Legend — pair with {@link ChartLegendContent}. */\nexport const ChartLegend = Legend;\n\nexport interface ChartContainerProps extends React.HTMLAttributes<HTMLDivElement> {\n  config: ChartConfig;\n  /** A single recharts chart element (BarChart, LineChart, …). */\n  children: React.ReactElement;\n}\n\n/**\n * Wraps a recharts chart in a responsive, token-aware container. Each config key\n * becomes a `--color-<key>` CSS variable for series `fill`/`stroke`.\n */\nexport const ChartContainer = React.forwardRef<HTMLDivElement, ChartContainerProps>(\n  ({ config, className, children, style, ...props }, ref) => {\n    const colorVars = React.useMemo(() => {\n      const vars: Record<string, string> = {};\n      for (const [key, cfg] of Object.entries(config)) {\n        if (cfg.color) vars[`--color-${key}`] = cfg.color;\n      }\n      return vars;\n    }, [config]);\n\n    return (\n      <div\n        ref={ref}\n        data-chart=\"\"\n        className={cn(\n          \"flex aspect-video justify-center text-xs [&_.recharts-cartesian-grid_line]:stroke-border/50 [&_.recharts-text]:fill-muted-foreground\",\n          className,\n        )}\n        style={{ ...colorVars, ...style }}\n        {...props}\n      >\n        <ResponsiveContainer width=\"100%\" height=\"100%\">\n          {children}\n        </ResponsiveContainer>\n      </div>\n    );\n  },\n);\nChartContainer.displayName = \"ChartContainer\";\n\ninterface TooltipPayloadItem {\n  name?: string | number;\n  value?: string | number;\n  color?: string;\n  dataKey?: string | number;\n}\n\nexport interface ChartTooltipContentProps {\n  active?: boolean;\n  payload?: TooltipPayloadItem[];\n  label?: React.ReactNode;\n  config?: ChartConfig;\n}\n\n/** A tokenized tooltip body for recharts. Pass to `<ChartTooltip content={…} />`. */\nexport const ChartTooltipContent = React.forwardRef<HTMLDivElement, ChartTooltipContentProps>(\n  ({ active, payload, label, config }, ref) => {\n    if (!active || !payload?.length) return null;\n    return (\n      <div\n        ref={ref}\n        className=\"min-w-32 rounded-lg border border-border bg-background px-3 py-2 text-sm shadow-md\"\n      >\n        {label != null && <div className=\"mb-1 font-medium text-foreground\">{label}</div>}\n        <div className=\"flex flex-col gap-1\">\n          {payload.map((item, i) => {\n            const key = String(item.dataKey ?? item.name ?? i);\n            const name = config?.[key]?.label ?? item.name ?? key;\n            return (\n              <div key={i} className=\"flex items-center justify-between gap-3\">\n                <span className=\"flex items-center gap-1.5 text-muted-foreground\">\n                  <span\n                    aria-hidden\n                    className=\"h-2 w-2 rounded-[2px]\"\n                    style={{ background: item.color ?? `var(--color-${key})` }}\n                  />\n                  {name}\n                </span>\n                <span className=\"font-medium tabular-nums text-foreground\">{item.value}</span>\n              </div>\n            );\n          })}\n        </div>\n      </div>\n    );\n  },\n);\nChartTooltipContent.displayName = \"ChartTooltipContent\";\n\ninterface LegendPayloadItem {\n  value?: string | number;\n  color?: string;\n  dataKey?: string | number;\n}\n\nexport interface ChartLegendContentProps {\n  payload?: LegendPayloadItem[];\n  config?: ChartConfig;\n}\n\n/** A tokenized legend for recharts. Pass to `<ChartLegend content={…} />`. */\nexport const ChartLegendContent = React.forwardRef<HTMLDivElement, ChartLegendContentProps>(\n  ({ payload, config }, ref) => {\n    if (!payload?.length) return null;\n    return (\n      <div ref={ref} className=\"flex flex-wrap items-center justify-center gap-4 pt-3\">\n        {payload.map((item, i) => {\n          const key = String(item.dataKey ?? item.value ?? i);\n          const name = config?.[key]?.label ?? item.value ?? key;\n          return (\n            <span key={i} className=\"flex items-center gap-1.5 text-xs text-muted-foreground\">\n              <span\n                aria-hidden\n                className=\"h-2 w-2 rounded-[2px]\"\n                style={{ background: item.color ?? `var(--color-${key})` }}\n              />\n              {name}\n            </span>\n          );\n        })}\n      </div>\n    );\n  },\n);\nChartLegendContent.displayName = \"ChartLegendContent\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,50 @@
+import * as React from 'react';
+import { Legend, Tooltip } from 'recharts';
+
+interface ChartSeriesConfig {
+    label?: React.ReactNode;
+    /** CSS color; exposed to children as `var(--color-<key>)`. */
+    color?: string;
+}
+type ChartConfig = Record<string, ChartSeriesConfig>;
+/** Re-exported recharts Tooltip — pair with {@link ChartTooltipContent}. */
+declare const ChartTooltip: typeof Tooltip;
+/** Re-exported recharts Legend — pair with {@link ChartLegendContent}. */
+declare const ChartLegend: typeof Legend;
+interface ChartContainerProps extends React.HTMLAttributes<HTMLDivElement> {
+    config: ChartConfig;
+    /** A single recharts chart element (BarChart, LineChart, …). */
+    children: React.ReactElement;
+}
+/**
+ * Wraps a recharts chart in a responsive, token-aware container. Each config key
+ * becomes a `--color-<key>` CSS variable for series `fill`/`stroke`.
+ */
+declare const ChartContainer: React.ForwardRefExoticComponent<ChartContainerProps & React.RefAttributes<HTMLDivElement>>;
+interface TooltipPayloadItem {
+    name?: string | number;
+    value?: string | number;
+    color?: string;
+    dataKey?: string | number;
+}
+interface ChartTooltipContentProps {
+    active?: boolean;
+    payload?: TooltipPayloadItem[];
+    label?: React.ReactNode;
+    config?: ChartConfig;
+}
+/** A tokenized tooltip body for recharts. Pass to `<ChartTooltip content={…} />`. */
+declare const ChartTooltipContent: React.ForwardRefExoticComponent<ChartTooltipContentProps & React.RefAttributes<HTMLDivElement>>;
+interface LegendPayloadItem {
+    value?: string | number;
+    color?: string;
+    dataKey?: string | number;
+}
+interface ChartLegendContentProps {
+    payload?: LegendPayloadItem[];
+    config?: ChartConfig;
+}
+/** A tokenized legend for recharts. Pass to `<ChartLegend content={…} />`. */
+declare const ChartLegendContent: React.ForwardRefExoticComponent<ChartLegendContentProps & React.RefAttributes<HTMLDivElement>>;
+
+export { type ChartConfig, ChartContainer, type ChartContainerProps, ChartLegend, ChartLegendContent, type ChartLegendContentProps, type ChartSeriesConfig, ChartTooltip, ChartTooltipContent, type ChartTooltipContentProps };

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+import * as React from 'react';
+import { Legend, Tooltip } from 'recharts';
+
+interface ChartSeriesConfig {
+    label?: React.ReactNode;
+    /** CSS color; exposed to children as `var(--color-<key>)`. */
+    color?: string;
+}
+type ChartConfig = Record<string, ChartSeriesConfig>;
+/** Re-exported recharts Tooltip — pair with {@link ChartTooltipContent}. */
+declare const ChartTooltip: typeof Tooltip;
+/** Re-exported recharts Legend — pair with {@link ChartLegendContent}. */
+declare const ChartLegend: typeof Legend;
+interface ChartContainerProps extends React.HTMLAttributes<HTMLDivElement> {
+    config: ChartConfig;
+    /** A single recharts chart element (BarChart, LineChart, …). */
+    children: React.ReactElement;
+}
+/**
+ * Wraps a recharts chart in a responsive, token-aware container. Each config key
+ * becomes a `--color-<key>` CSS variable for series `fill`/`stroke`.
+ */
+declare const ChartContainer: React.ForwardRefExoticComponent<ChartContainerProps & React.RefAttributes<HTMLDivElement>>;
+interface TooltipPayloadItem {
+    name?: string | number;
+    value?: string | number;
+    color?: string;
+    dataKey?: string | number;
+}
+interface ChartTooltipContentProps {
+    active?: boolean;
+    payload?: TooltipPayloadItem[];
+    label?: React.ReactNode;
+    config?: ChartConfig;
+}
+/** A tokenized tooltip body for recharts. Pass to `<ChartTooltip content={…} />`. */
+declare const ChartTooltipContent: React.ForwardRefExoticComponent<ChartTooltipContentProps & React.RefAttributes<HTMLDivElement>>;
+interface LegendPayloadItem {
+    value?: string | number;
+    color?: string;
+    dataKey?: string | number;
+}
+interface ChartLegendContentProps {
+    payload?: LegendPayloadItem[];
+    config?: ChartConfig;
+}
+/** A tokenized legend for recharts. Pass to `<ChartLegend content={…} />`. */
+declare const ChartLegendContent: React.ForwardRefExoticComponent<ChartLegendContentProps & React.RefAttributes<HTMLDivElement>>;
+
+export { type ChartConfig, ChartContainer, type ChartContainerProps, ChartLegend, ChartLegendContent, type ChartLegendContentProps, type ChartSeriesConfig, ChartTooltip, ChartTooltipContent, type ChartTooltipContentProps };

package/dist/index.js

@@ -0,0 +1,94 @@
+"use client";
+import * as React from 'react';
+import { ResponsiveContainer, Legend, Tooltip } from 'recharts';
+import { cn } from '@nucleux/utils';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+// src/index.tsx
+var ChartTooltip = Tooltip;
+var ChartLegend = Legend;
+var ChartContainer = React.forwardRef(
+  ({ config, className, children, style, ...props }, ref) => {
+    const colorVars = React.useMemo(() => {
+      const vars = {};
+      for (const [key, cfg] of Object.entries(config)) {
+        if (cfg.color) vars[`--color-${key}`] = cfg.color;
+      }
+      return vars;
+    }, [config]);
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref,
+        "data-chart": "",
+        className: cn(
+          "flex aspect-video justify-center text-xs [&_.recharts-cartesian-grid_line]:stroke-border/50 [&_.recharts-text]:fill-muted-foreground",
+          className
+        ),
+        style: { ...colorVars, ...style },
+        ...props,
+        children: /* @__PURE__ */ jsx(ResponsiveContainer, { width: "100%", height: "100%", children })
+      }
+    );
+  }
+);
+ChartContainer.displayName = "ChartContainer";
+var ChartTooltipContent = React.forwardRef(
+  ({ active, payload, label, config }, ref) => {
+    if (!active || !payload?.length) return null;
+    return /* @__PURE__ */ jsxs(
+      "div",
+      {
+        ref,
+        className: "min-w-32 rounded-lg border border-border bg-background px-3 py-2 text-sm shadow-md",
+        children: [
+          label != null && /* @__PURE__ */ jsx("div", { className: "mb-1 font-medium text-foreground", children: label }),
+          /* @__PURE__ */ jsx("div", { className: "flex flex-col gap-1", children: payload.map((item, i) => {
+            const key = String(item.dataKey ?? item.name ?? i);
+            const name = config?.[key]?.label ?? item.name ?? key;
+            return /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-3", children: [
+              /* @__PURE__ */ jsxs("span", { className: "flex items-center gap-1.5 text-muted-foreground", children: [
+                /* @__PURE__ */ jsx(
+                  "span",
+                  {
+                    "aria-hidden": true,
+                    className: "h-2 w-2 rounded-[2px]",
+                    style: { background: item.color ?? `var(--color-${key})` }
+                  }
+                ),
+                name
+              ] }),
+              /* @__PURE__ */ jsx("span", { className: "font-medium tabular-nums text-foreground", children: item.value })
+            ] }, i);
+          }) })
+        ]
+      }
+    );
+  }
+);
+ChartTooltipContent.displayName = "ChartTooltipContent";
+var ChartLegendContent = React.forwardRef(
+  ({ payload, config }, ref) => {
+    if (!payload?.length) return null;
+    return /* @__PURE__ */ jsx("div", { ref, className: "flex flex-wrap items-center justify-center gap-4 pt-3", children: payload.map((item, i) => {
+      const key = String(item.dataKey ?? item.value ?? i);
+      const name = config?.[key]?.label ?? item.value ?? key;
+      return /* @__PURE__ */ jsxs("span", { className: "flex items-center gap-1.5 text-xs text-muted-foreground", children: [
+        /* @__PURE__ */ jsx(
+          "span",
+          {
+            "aria-hidden": true,
+            className: "h-2 w-2 rounded-[2px]",
+            style: { background: item.color ?? `var(--color-${key})` }
+          }
+        ),
+        name
+      ] }, i);
+    }) });
+  }
+);
+ChartLegendContent.displayName = "ChartLegendContent";
+
+export { ChartContainer, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;;AAYO,IAAM,YAAA,GAAe;AAErB,IAAM,WAAA,GAAc;AAYpB,IAAM,cAAA,GAAuB,KAAA,CAAA,UAAA;AAAA,EAClC,CAAC,EAAE,MAAA,EAAQ,SAAA,EAAW,UAAU,KAAA,EAAO,GAAG,KAAA,EAAM,EAAG,GAAA,KAAQ;AACzD,IAAA,MAAM,SAAA,GAAkB,cAAQ,MAAM;AACpC,MAAA,MAAM,OAA+B,EAAC;AACtC,MAAA,KAAA,MAAW,CAAC,GAAA,EAAK,GAAG,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AAC/C,QAAA,IAAI,IAAI,KAAA,EAAO,IAAA,CAAK,WAAW,GAAG,CAAA,CAAE,IAAI,GAAA,CAAI,KAAA;AAAA,MAC9C;AACA,MAAA,OAAO,IAAA;AAAA,IACT,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,IAAA,uBACE,GAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,YAAA,EAAW,EAAA;AAAA,QACX,SAAA,EAAW,EAAA;AAAA,UACT,sIAAA;AAAA,UACA;AAAA,SACF;AAAA,QACA,KAAA,EAAO,EAAE,GAAG,SAAA,EAAW,GAAG,KAAA,EAAM;AAAA,QAC/B,GAAG,KAAA;AAAA,QAEJ,8BAAC,mBAAA,EAAA,EAAoB,KAAA,EAAM,MAAA,EAAO,MAAA,EAAO,QACtC,QAAA,EACH;AAAA;AAAA,KACF;AAAA,EAEJ;AACF;AACA,cAAA,CAAe,WAAA,GAAc,gBAAA;AAiBtB,IAAM,mBAAA,GAA4B,KAAA,CAAA,UAAA;AAAA,EACvC,CAAC,EAAE,MAAA,EAAQ,SAAS,KAAA,EAAO,MAAA,IAAU,GAAA,KAAQ;AAC3C,IAAA,IAAI,CAAC,MAAA,IAAU,CAAC,OAAA,EAAS,QAAQ,OAAO,IAAA;AACxC,IAAA,uBACE,IAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAU,oFAAA;AAAA,QAET,QAAA,EAAA;AAAA,UAAA,KAAA,IAAS,IAAA,oBAAQ,GAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,oCAAoC,QAAA,EAAA,KAAA,EAAM,CAAA;AAAA,0BAC3E,GAAA,CAAC,SAAI,SAAA,EAAU,qBAAA,EACZ,kBAAQ,GAAA,CAAI,CAAC,MAAM,CAAA,KAAM;AACxB,YAAA,MAAM,MAAM,MAAA,CAAO,IAAA,CAAK,OAAA,IAAW,IAAA,CAAK,QAAQ,CAAC,CAAA;AACjD,YAAA,MAAM,OAAO,MAAA,GAAS,GAAG,CAAA,EAAG,KAAA,IAAS,KAAK,IAAA,IAAQ,GAAA;AAClD,YAAA,uBACE,IAAA,CAAC,KAAA,EAAA,EAAY,SAAA,EAAU,yCAAA,EACrB,QAAA,EAAA;AAAA,8BAAA,IAAA,CAAC,MAAA,EAAA,EAAK,WAAU,iDAAA,EACd,QAAA,EAAA;AAAA,gCAAA,GAAA;AAAA,kBAAC,MAAA;AAAA,kBAAA;AAAA,oBACC,aAAA,EAAW,IAAA;AAAA,oBACX,SAAA,EAAU,uBAAA;AAAA,oBACV,OAAO,EAAE,UAAA,EAAY,KAAK,KAAA,IAAS,CAAA,YAAA,EAAe,GAAG,CAAA,CAAA,CAAA;AAAI;AAAA,iBAC3D;AAAA,gBACC;AAAA,eAAA,EACH,CAAA;AAAA,8BACA,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,0CAAA,EAA4C,eAAK,KAAA,EAAM;AAAA,aAAA,EAAA,EAT/D,CAUV,CAAA;AAAA,UAEJ,CAAC,CAAA,EACH;AAAA;AAAA;AAAA,KACF;AAAA,EAEJ;AACF;AACA,mBAAA,CAAoB,WAAA,GAAc,qBAAA;AAc3B,IAAM,kBAAA,GAA2B,KAAA,CAAA,UAAA;AAAA,EACtC,CAAC,EAAE,OAAA,EAAS,MAAA,IAAU,GAAA,KAAQ;AAC5B,IAAA,IAAI,CAAC,OAAA,EAAS,MAAA,EAAQ,OAAO,IAAA;AAC7B,IAAA,uBACE,GAAA,CAAC,SAAI,GAAA,EAAU,SAAA,EAAU,yDACtB,QAAA,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAC,IAAA,EAAM,CAAA,KAAM;AACxB,MAAA,MAAM,MAAM,MAAA,CAAO,IAAA,CAAK,OAAA,IAAW,IAAA,CAAK,SAAS,CAAC,CAAA;AAClD,MAAA,MAAM,OAAO,MAAA,GAAS,GAAG,CAAA,EAAG,KAAA,IAAS,KAAK,KAAA,IAAS,GAAA;AACnD,MAAA,uBACE,IAAA,CAAC,MAAA,EAAA,EAAa,SAAA,EAAU,yDAAA,EACtB,QAAA,EAAA;AAAA,wBAAA,GAAA;AAAA,UAAC,MAAA;AAAA,UAAA;AAAA,YACC,aAAA,EAAW,IAAA;AAAA,YACX,SAAA,EAAU,uBAAA;AAAA,YACV,OAAO,EAAE,UAAA,EAAY,KAAK,KAAA,IAAS,CAAA,YAAA,EAAe,GAAG,CAAA,CAAA,CAAA;AAAI;AAAA,SAC3D;AAAA,QACC;AAAA,OAAA,EAAA,EANQ,CAOX,CAAA;AAAA,IAEJ,CAAC,CAAA,EACH,CAAA;AAAA,EAEJ;AACF;AACA,kBAAA,CAAmB,WAAA,GAAc,oBAAA","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { Legend, ResponsiveContainer, Tooltip } from \"recharts\";\nimport { cn } from \"@nucleux/utils\";\n\nexport interface ChartSeriesConfig {\n  label?: React.ReactNode;\n  /** CSS color; exposed to children as `var(--color-<key>)`. */\n  color?: string;\n}\nexport type ChartConfig = Record<string, ChartSeriesConfig>;\n\n/** Re-exported recharts Tooltip — pair with {@link ChartTooltipContent}. */\nexport const ChartTooltip = Tooltip;\n/** Re-exported recharts Legend — pair with {@link ChartLegendContent}. */\nexport const ChartLegend = Legend;\n\nexport interface ChartContainerProps extends React.HTMLAttributes<HTMLDivElement> {\n  config: ChartConfig;\n  /** A single recharts chart element (BarChart, LineChart, …). */\n  children: React.ReactElement;\n}\n\n/**\n * Wraps a recharts chart in a responsive, token-aware container. Each config key\n * becomes a `--color-<key>` CSS variable for series `fill`/`stroke`.\n */\nexport const ChartContainer = React.forwardRef<HTMLDivElement, ChartContainerProps>(\n  ({ config, className, children, style, ...props }, ref) => {\n    const colorVars = React.useMemo(() => {\n      const vars: Record<string, string> = {};\n      for (const [key, cfg] of Object.entries(config)) {\n        if (cfg.color) vars[`--color-${key}`] = cfg.color;\n      }\n      return vars;\n    }, [config]);\n\n    return (\n      <div\n        ref={ref}\n        data-chart=\"\"\n        className={cn(\n          \"flex aspect-video justify-center text-xs [&_.recharts-cartesian-grid_line]:stroke-border/50 [&_.recharts-text]:fill-muted-foreground\",\n          className,\n        )}\n        style={{ ...colorVars, ...style }}\n        {...props}\n      >\n        <ResponsiveContainer width=\"100%\" height=\"100%\">\n          {children}\n        </ResponsiveContainer>\n      </div>\n    );\n  },\n);\nChartContainer.displayName = \"ChartContainer\";\n\ninterface TooltipPayloadItem {\n  name?: string | number;\n  value?: string | number;\n  color?: string;\n  dataKey?: string | number;\n}\n\nexport interface ChartTooltipContentProps {\n  active?: boolean;\n  payload?: TooltipPayloadItem[];\n  label?: React.ReactNode;\n  config?: ChartConfig;\n}\n\n/** A tokenized tooltip body for recharts. Pass to `<ChartTooltip content={…} />`. */\nexport const ChartTooltipContent = React.forwardRef<HTMLDivElement, ChartTooltipContentProps>(\n  ({ active, payload, label, config }, ref) => {\n    if (!active || !payload?.length) return null;\n    return (\n      <div\n        ref={ref}\n        className=\"min-w-32 rounded-lg border border-border bg-background px-3 py-2 text-sm shadow-md\"\n      >\n        {label != null && <div className=\"mb-1 font-medium text-foreground\">{label}</div>}\n        <div className=\"flex flex-col gap-1\">\n          {payload.map((item, i) => {\n            const key = String(item.dataKey ?? item.name ?? i);\n            const name = config?.[key]?.label ?? item.name ?? key;\n            return (\n              <div key={i} className=\"flex items-center justify-between gap-3\">\n                <span className=\"flex items-center gap-1.5 text-muted-foreground\">\n                  <span\n                    aria-hidden\n                    className=\"h-2 w-2 rounded-[2px]\"\n                    style={{ background: item.color ?? `var(--color-${key})` }}\n                  />\n                  {name}\n                </span>\n                <span className=\"font-medium tabular-nums text-foreground\">{item.value}</span>\n              </div>\n            );\n          })}\n        </div>\n      </div>\n    );\n  },\n);\nChartTooltipContent.displayName = \"ChartTooltipContent\";\n\ninterface LegendPayloadItem {\n  value?: string | number;\n  color?: string;\n  dataKey?: string | number;\n}\n\nexport interface ChartLegendContentProps {\n  payload?: LegendPayloadItem[];\n  config?: ChartConfig;\n}\n\n/** A tokenized legend for recharts. Pass to `<ChartLegend content={…} />`. */\nexport const ChartLegendContent = React.forwardRef<HTMLDivElement, ChartLegendContentProps>(\n  ({ payload, config }, ref) => {\n    if (!payload?.length) return null;\n    return (\n      <div ref={ref} className=\"flex flex-wrap items-center justify-center gap-4 pt-3\">\n        {payload.map((item, i) => {\n          const key = String(item.dataKey ?? item.value ?? i);\n          const name = config?.[key]?.label ?? item.value ?? key;\n          return (\n            <span key={i} className=\"flex items-center gap-1.5 text-xs text-muted-foreground\">\n              <span\n                aria-hidden\n                className=\"h-2 w-2 rounded-[2px]\"\n                style={{ background: item.color ?? `var(--color-${key})` }}\n              />\n              {name}\n            </span>\n          );\n        })}\n      </div>\n    );\n  },\n);\nChartLegendContent.displayName = \"ChartLegendContent\";\n"]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@nucleux/chart",
+  "version": "0.2.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Composable chart primitives — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "chart"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "dependencies": {
+    "recharts": "^2.15.0",
+    "@nucleux/utils": "0.2.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "@types/react": "^18.3.18",
+    "react": "^18.3.1",
+    "lucide-react": "^0.469.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intelligaia-open-labs/nucleux.git",
+    "directory": "packages/chart"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
+}