@comitor/ui 0.1.0

package/dist/chart/chart.js

@@ -0,0 +1,199 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import * as RechartsPrimitive from "recharts";
+import { cn } from "../lib/cn.js";
+const THEMES = { light: "", dark: ".dark" };
+const ChartContext = React.createContext(null);
+function useChart() {
+  const context = React.useContext(ChartContext);
+  if (!context) {
+    throw new Error("useChart ph\u1EA3i \u0111\u01B0\u1EE3c g\u1ECDi b\xEAn trong <ChartContainer />");
+  }
+  return context;
+}
+function ChartContainer({ id, className, children, config, ...props }) {
+  const uniqueId = React.useId();
+  const chartId = `chart-${id || uniqueId.replace(/:/g, "")}`;
+  return /* @__PURE__ */ jsx(ChartContext.Provider, { value: { config }, children: /* @__PURE__ */ jsxs(
+    "div",
+    {
+      "data-slot": "chart",
+      "data-chart": chartId,
+      className: cn(
+        "[&_.recharts-cartesian-axis-tick_text]:fill-muted-foreground [&_.recharts-cartesian-grid_line[stroke='#ccc']]:stroke-border/50 [&_.recharts-curve.recharts-tooltip-cursor]:stroke-border [&_.recharts-polar-grid_[stroke='#ccc']]:stroke-border [&_.recharts-radial-bar-background-sector]:fill-muted [&_.recharts-rectangle.recharts-tooltip-cursor]:fill-muted [&_.recharts-reference-line_[stroke='#ccc']]:stroke-border flex aspect-video justify-center text-xs [&_.recharts-dot[stroke='#fff']]:stroke-transparent [&_.recharts-layer]:outline-hidden [&_.recharts-sector]:outline-hidden [&_.recharts-sector[stroke='#fff']]:stroke-transparent [&_.recharts-surface]:outline-hidden",
+        className
+      ),
+      ...props,
+      children: [
+        /* @__PURE__ */ jsx(ChartStyle, { id: chartId, config }),
+        /* @__PURE__ */ jsx(RechartsPrimitive.ResponsiveContainer, { children })
+      ]
+    }
+  ) });
+}
+const ChartStyle = ({ id, config }) => {
+  const colorConfig = Object.entries(config).filter(([, itemConfig]) => itemConfig.theme || itemConfig.color);
+  if (!colorConfig.length) {
+    return null;
+  }
+  const css = Object.entries(THEMES).map(([theme, prefix]) => {
+    const declarations = colorConfig.map(([key, itemConfig]) => {
+      const color = itemConfig.theme?.[theme] || itemConfig.color;
+      return color ? `  --color-${key}: ${color};` : null;
+    }).filter(Boolean).join("\n");
+    return `${prefix} [data-chart=${id}] {
+${declarations}
+}`;
+  }).join("\n");
+  return /* @__PURE__ */ jsx("style", { dangerouslySetInnerHTML: { __html: css } });
+};
+const ChartTooltip = RechartsPrimitive.Tooltip;
+function ChartTooltipContent({
+  active,
+  payload,
+  className,
+  indicator = "dot",
+  hideLabel = false,
+  hideIndicator = false,
+  label,
+  labelFormatter,
+  labelClassName,
+  formatter,
+  color,
+  nameKey,
+  labelKey
+}) {
+  const { config } = useChart();
+  const tooltipLabel = React.useMemo(() => {
+    if (hideLabel || !payload?.length) {
+      return null;
+    }
+    const [item] = payload;
+    const key = `${labelKey || item?.dataKey || item?.name || "value"}`;
+    const itemConfig = getPayloadConfigFromPayload(config, item, key);
+    const value = !labelKey && typeof label === "string" ? config[label]?.label || label : itemConfig?.label;
+    if (labelFormatter) {
+      return /* @__PURE__ */ jsx("div", { className: cn("font-medium", labelClassName), children: labelFormatter(value, payload) });
+    }
+    if (!value) {
+      return null;
+    }
+    return /* @__PURE__ */ jsx("div", { className: cn("font-medium", labelClassName), children: value });
+  }, [label, labelFormatter, payload, hideLabel, labelClassName, config, labelKey]);
+  if (!active || !payload?.length) {
+    return null;
+  }
+  const nestLabel = payload.length === 1 && indicator !== "dot";
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn(
+        "border-border/50 bg-background grid min-w-[8rem] items-start gap-1.5 rounded-lg border px-2.5 py-1.5 text-xs shadow-overlay",
+        className
+      ),
+      children: [
+        !nestLabel ? tooltipLabel : null,
+        /* @__PURE__ */ jsx("div", { className: "grid gap-1.5", children: payload.map((item, index) => {
+          const key = `${nameKey || item.name || item.dataKey || "value"}`;
+          const itemConfig = getPayloadConfigFromPayload(config, item, key);
+          const indicatorColor = color || item.payload?.fill || item.color;
+          const rowKey = `${item.dataKey ?? item.name ?? index}`;
+          return /* @__PURE__ */ jsx(
+            "div",
+            {
+              className: cn(
+                "[&>svg]:text-muted-foreground flex w-full flex-wrap items-stretch gap-2 [&>svg]:h-2.5 [&>svg]:w-2.5",
+                indicator === "dot" && "items-center"
+              ),
+              children: formatter && item?.value !== void 0 && item.name ? formatter(item.value, item.name, item, index, payload) : /* @__PURE__ */ jsxs(Fragment, { children: [
+                itemConfig?.icon ? /* @__PURE__ */ jsx(itemConfig.icon, {}) : !hideIndicator && /* @__PURE__ */ jsx(
+                  "div",
+                  {
+                    className: cn("shrink-0 rounded-[2px] border-(--color-border) bg-(--color-bg)", {
+                      "h-2.5 w-2.5": indicator === "dot",
+                      "w-1": indicator === "line",
+                      "w-0 border-[1.5px] border-dashed bg-transparent": indicator === "dashed",
+                      "my-0.5": nestLabel && indicator === "dashed"
+                    }),
+                    style: {
+                      "--color-bg": indicatorColor,
+                      "--color-border": indicatorColor
+                    }
+                  }
+                ),
+                /* @__PURE__ */ jsxs(
+                  "div",
+                  {
+                    className: cn("flex flex-1 justify-between leading-none", nestLabel ? "items-end" : "items-center"),
+                    children: [
+                      /* @__PURE__ */ jsxs("div", { className: "grid gap-1.5", children: [
+                        nestLabel ? tooltipLabel : null,
+                        /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: itemConfig?.label || item.name })
+                      ] }),
+                      item.value !== void 0 && /* @__PURE__ */ jsx("span", { className: "text-foreground font-mono font-medium tabular-nums", children: item.value.toLocaleString("vi-VN") })
+                    ]
+                  }
+                )
+              ] })
+            },
+            rowKey
+          );
+        }) })
+      ]
+    }
+  );
+}
+const ChartLegend = RechartsPrimitive.Legend;
+function ChartLegendContent({
+  className,
+  hideIcon = false,
+  payload,
+  verticalAlign = "bottom",
+  nameKey
+}) {
+  const { config } = useChart();
+  if (!payload?.length) {
+    return null;
+  }
+  return /* @__PURE__ */ jsx("div", { className: cn("flex items-center justify-center gap-4", verticalAlign === "top" ? "pb-3" : "pt-3", className), children: payload.map((item, index) => {
+    const key = `${nameKey || item.dataKey || "value"}`;
+    const itemConfig = getPayloadConfigFromPayload(config, item, key);
+    const rowKey = `${item.value ?? item.dataKey ?? index}`;
+    return /* @__PURE__ */ jsxs("div", { className: "[&>svg]:text-muted-foreground flex items-center gap-1.5 [&>svg]:h-3 [&>svg]:w-3", children: [
+      itemConfig?.icon && !hideIcon ? /* @__PURE__ */ jsx(itemConfig.icon, {}) : /* @__PURE__ */ jsx(
+        "div",
+        {
+          className: "h-2 w-2 shrink-0 rounded-[2px]",
+          style: {
+            backgroundColor: item.color
+          }
+        }
+      ),
+      itemConfig?.label
+    ] }, rowKey);
+  }) });
+}
+function getPayloadConfigFromPayload(config, payload, key) {
+  if (typeof payload !== "object" || payload === null) {
+    return void 0;
+  }
+  const payloadPayload = "payload" in payload && typeof payload.payload === "object" && payload.payload !== null ? payload.payload : void 0;
+  let configLabelKey = key;
+  if (key in payload && typeof payload[key] === "string") {
+    configLabelKey = payload[key];
+  } else if (payloadPayload && key in payloadPayload && typeof payloadPayload[key] === "string") {
+    configLabelKey = payloadPayload[key];
+  }
+  return configLabelKey in config ? config[configLabelKey] : config[key];
+}
+export {
+  ChartContainer,
+  ChartLegend,
+  ChartLegendContent,
+  ChartStyle,
+  ChartTooltip,
+  ChartTooltipContent,
+  useChart
+};
+//# sourceMappingURL=chart.js.map

package/dist/chart/chart.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/chart/chart.tsx"],"sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport * as RechartsPrimitive from \"recharts\";\nimport { cn } from \"../lib/cn.js\";\n\n/**\n * Chart primitive của shadcn/ui (style new-york) — port nguyên trạng từ comitor-ds để\n * `shadcn add` vẫn dùng lại được. Đây là tầng \"thô\": bạn tự lắp recharts bên trong.\n * Muốn dựng nhanh 3 loại biểu đồ quen thuộc thì xem `comitor-chart.tsx`.\n *\n * Cơ chế màu (điểm hay nhất, và cũng dễ hiểu sai nhất):\n * `<ChartContainer>` render kèm `<ChartStyle>` — thẻ này sinh ra biến CSS `--color-<key>`\n * cho từng key trong `config`, giới hạn phạm vi bằng `[data-chart=<id>]`. Series recharts\n * chỉ việc trỏ `fill=\"var(--color-desktop)\"`. Nhờ vậy màu vẫn nằm trong TOKEN (không hex\n * rải trong JSX) và đổi được theo light/dark khi config khai `theme: { light, dark }`.\n */\n\n// Ánh xạ { TÊN_THEME: CSS_SELECTOR }. Chuỗi rỗng = light (không cần selector bọc ngoài).\nconst THEMES = { light: \"\", dark: \".dark\" } as const;\n\n/**\n * Khai báo hiển thị cho từng series: nhãn, icon và màu.\n * Dùng `color` cho màu dùng chung, hoặc `theme` khi cần màu khác nhau giữa light/dark.\n * Giá trị màu nên là token: `\"var(--chart-1)\"`, `\"var(--teal)\"`… — đừng ghi hex.\n */\nexport type ChartConfig = {\n  [k in string]: {\n    label?: React.ReactNode;\n    icon?: React.ComponentType;\n  } & ({ color?: string; theme?: never } | { color?: never; theme: Record<keyof typeof THEMES, string> });\n};\n\ntype ChartContextProps = {\n  config: ChartConfig;\n};\n\nconst ChartContext = React.createContext<ChartContextProps | null>(null);\n\n/** Đọc `config` của `<ChartContainer>` gần nhất. Ném lỗi nếu gọi ngoài container. */\nfunction useChart(): ChartContextProps {\n  const context = React.useContext(ChartContext);\n\n  if (!context) {\n    throw new Error(\"useChart phải được gọi bên trong <ChartContainer />\");\n  }\n\n  return context;\n}\n\nexport type ChartContainerProps = React.ComponentProps<\"div\"> & {\n  /** Khai báo nhãn/màu cho từng series — nguồn của biến `--color-<key>`. */\n  config: ChartConfig;\n  children: React.ComponentProps<typeof RechartsPrimitive.ResponsiveContainer>[\"children\"];\n};\n\n/**\n * Khung biểu đồ: cấp context `config`, bơm biến màu, và bọc sẵn `ResponsiveContainer`.\n * Tỉ lệ mặc định `aspect-video`; muốn cao cố định thì truyền `className=\"h-64 aspect-auto\"`.\n */\nfunction ChartContainer({ id, className, children, config, ...props }: ChartContainerProps) {\n  const uniqueId = React.useId();\n  const chartId = `chart-${id || uniqueId.replace(/:/g, \"\")}`;\n\n  return (\n    <ChartContext.Provider value={{ config }}>\n      <div\n        data-slot=\"chart\"\n        data-chart={chartId}\n        className={cn(\n          \"[&_.recharts-cartesian-axis-tick_text]:fill-muted-foreground [&_.recharts-cartesian-grid_line[stroke='#ccc']]:stroke-border/50 [&_.recharts-curve.recharts-tooltip-cursor]:stroke-border [&_.recharts-polar-grid_[stroke='#ccc']]:stroke-border [&_.recharts-radial-bar-background-sector]:fill-muted [&_.recharts-rectangle.recharts-tooltip-cursor]:fill-muted [&_.recharts-reference-line_[stroke='#ccc']]:stroke-border flex aspect-video justify-center text-xs [&_.recharts-dot[stroke='#fff']]:stroke-transparent [&_.recharts-layer]:outline-hidden [&_.recharts-sector]:outline-hidden [&_.recharts-sector[stroke='#fff']]:stroke-transparent [&_.recharts-surface]:outline-hidden\",\n          className\n        )}\n        {...props}\n      >\n        <ChartStyle id={chartId} config={config} />\n        <RechartsPrimitive.ResponsiveContainer>{children}</RechartsPrimitive.ResponsiveContainer>\n      </div>\n    </ChartContext.Provider>\n  );\n}\n\nexport type ChartStyleProps = {\n  /** Giá trị của thuộc tính `data-chart` trên container — dùng làm phạm vi cho biến màu. */\n  id: string;\n  config: ChartConfig;\n};\n\n/**\n * Sinh thẻ `<style>` chứa `--color-<key>` cho từng series, phạm vi `[data-chart=<id>]`.\n * `ChartContainer` đã render sẵn; chỉ export riêng cho ai tự dựng container.\n */\nconst ChartStyle = ({ id, config }: ChartStyleProps) => {\n  const colorConfig = Object.entries(config).filter(([, itemConfig]) => itemConfig.theme || itemConfig.color);\n\n  if (!colorConfig.length) {\n    return null;\n  }\n\n  // Một khối CSS cho mỗi theme: light không cần selector bọc ngoài, dark bọc bằng `.dark`.\n  const css = Object.entries(THEMES)\n    .map(([theme, prefix]) => {\n      const declarations = colorConfig\n        .map(([key, itemConfig]) => {\n          const color = itemConfig.theme?.[theme as keyof typeof itemConfig.theme] || itemConfig.color;\n          return color ? `  --color-${key}: ${color};` : null;\n        })\n        .filter(Boolean)\n        .join(\"\\n\");\n\n      return `${prefix} [data-chart=${id}] {\\n${declarations}\\n}`;\n    })\n    .join(\"\\n\");\n\n  // biome-ignore lint/security/noDangerouslySetInnerHtml: phải bơm nguyên khối CSS gồm nhiều selector (light + `.dark`) — React không có API nào khác cho việc này; nội dung ghép từ `config` do chính app khai, không phải dữ liệu người dùng nhập.\n  return <style dangerouslySetInnerHTML={{ __html: css }} />;\n};\n\n/** `Tooltip` của recharts — đặt `content={<ChartTooltipContent />}` để có giao diện theo token. */\nconst ChartTooltip = RechartsPrimitive.Tooltip;\n\nexport type ChartTooltipContentProps = React.ComponentProps<typeof RechartsPrimitive.Tooltip> &\n  React.ComponentProps<\"div\"> & {\n    /** Ẩn dòng nhãn (trục X) ở đầu tooltip. */\n    hideLabel?: boolean;\n    /** Ẩn ô màu đứng trước tên series. */\n    hideIndicator?: boolean;\n    /** Kiểu ô màu: chấm tròn / vạch đứng / vạch đứt. */\n    indicator?: \"line\" | \"dot\" | \"dashed\";\n    /** Khoá dùng để tra `config` cho TÊN series (mặc định `name` rồi tới `dataKey`). */\n    nameKey?: string;\n    /** Khoá dùng để tra `config` cho NHÃN trục X. */\n    labelKey?: string;\n  };\n\n/** Nội dung tooltip theo design token Comitor: nền `bg-background`, viền `border-border/50`. */\nfunction ChartTooltipContent({\n  active,\n  payload,\n  className,\n  indicator = \"dot\",\n  hideLabel = false,\n  hideIndicator = false,\n  label,\n  labelFormatter,\n  labelClassName,\n  formatter,\n  color,\n  nameKey,\n  labelKey\n}: ChartTooltipContentProps) {\n  const { config } = useChart();\n\n  const tooltipLabel = React.useMemo(() => {\n    if (hideLabel || !payload?.length) {\n      return null;\n    }\n\n    const [item] = payload;\n    const key = `${labelKey || item?.dataKey || item?.name || \"value\"}`;\n    const itemConfig = getPayloadConfigFromPayload(config, item, key);\n    const value = !labelKey && typeof label === \"string\" ? config[label]?.label || label : itemConfig?.label;\n\n    if (labelFormatter) {\n      return <div className={cn(\"font-medium\", labelClassName)}>{labelFormatter(value, payload)}</div>;\n    }\n\n    if (!value) {\n      return null;\n    }\n\n    return <div className={cn(\"font-medium\", labelClassName)}>{value}</div>;\n  }, [label, labelFormatter, payload, hideLabel, labelClassName, config, labelKey]);\n\n  if (!active || !payload?.length) {\n    return null;\n  }\n\n  // Chỉ một series + không phải chấm tròn → nhét nhãn vào trong hàng cho gọn.\n  const nestLabel = payload.length === 1 && indicator !== \"dot\";\n\n  return (\n    <div\n      className={cn(\n        \"border-border/50 bg-background grid min-w-[8rem] items-start gap-1.5 rounded-lg border px-2.5 py-1.5 text-xs shadow-overlay\",\n        className\n      )}\n    >\n      {!nestLabel ? tooltipLabel : null}\n      <div className=\"grid gap-1.5\">\n        {payload.map((item, index) => {\n          const key = `${nameKey || item.name || item.dataKey || \"value\"}`;\n          const itemConfig = getPayloadConfigFromPayload(config, item, key);\n          const indicatorColor = color || item.payload?.fill || item.color;\n          const rowKey = `${item.dataKey ?? item.name ?? index}`;\n\n          return (\n            <div\n              key={rowKey}\n              className={cn(\n                \"[&>svg]:text-muted-foreground flex w-full flex-wrap items-stretch gap-2 [&>svg]:h-2.5 [&>svg]:w-2.5\",\n                indicator === \"dot\" && \"items-center\"\n              )}\n            >\n              {formatter && item?.value !== undefined && item.name ? (\n                formatter(item.value, item.name, item, index, payload)\n              ) : (\n                <>\n                  {itemConfig?.icon ? (\n                    <itemConfig.icon />\n                  ) : (\n                    !hideIndicator && (\n                      <div\n                        className={cn(\"shrink-0 rounded-[2px] border-(--color-border) bg-(--color-bg)\", {\n                          \"h-2.5 w-2.5\": indicator === \"dot\",\n                          \"w-1\": indicator === \"line\",\n                          \"w-0 border-[1.5px] border-dashed bg-transparent\": indicator === \"dashed\",\n                          \"my-0.5\": nestLabel && indicator === \"dashed\"\n                        })}\n                        style={\n                          {\n                            \"--color-bg\": indicatorColor,\n                            \"--color-border\": indicatorColor\n                          } as React.CSSProperties\n                        }\n                      />\n                    )\n                  )}\n                  <div\n                    className={cn(\"flex flex-1 justify-between leading-none\", nestLabel ? \"items-end\" : \"items-center\")}\n                  >\n                    <div className=\"grid gap-1.5\">\n                      {nestLabel ? tooltipLabel : null}\n                      <span className=\"text-muted-foreground\">{itemConfig?.label || item.name}</span>\n                    </div>\n                    {item.value !== undefined && (\n                      <span className=\"text-foreground font-mono font-medium tabular-nums\">\n                        {item.value.toLocaleString(\"vi-VN\")}\n                      </span>\n                    )}\n                  </div>\n                </>\n              )}\n            </div>\n          );\n        })}\n      </div>\n    </div>\n  );\n}\n\n/** `Legend` của recharts — đặt `content={<ChartLegendContent />}` để lấy nhãn từ `config`. */\nconst ChartLegend = RechartsPrimitive.Legend;\n\nexport type ChartLegendContentProps = React.ComponentProps<\"div\"> &\n  Pick<RechartsPrimitive.LegendProps, \"payload\" | \"verticalAlign\"> & {\n    /** Ẩn icon riêng của series (nếu `config` có khai `icon`). */\n    hideIcon?: boolean;\n    /** Khoá dùng để tra `config` (mặc định `dataKey`). */\n    nameKey?: string;\n  };\n\n/** Chú giải nằm ngang, nhãn lấy từ `config` chứ không phải `dataKey` thô. */\nfunction ChartLegendContent({\n  className,\n  hideIcon = false,\n  payload,\n  verticalAlign = \"bottom\",\n  nameKey\n}: ChartLegendContentProps) {\n  const { config } = useChart();\n\n  if (!payload?.length) {\n    return null;\n  }\n\n  return (\n    <div className={cn(\"flex items-center justify-center gap-4\", verticalAlign === \"top\" ? \"pb-3\" : \"pt-3\", className)}>\n      {payload.map((item, index) => {\n        const key = `${nameKey || item.dataKey || \"value\"}`;\n        const itemConfig = getPayloadConfigFromPayload(config, item, key);\n        const rowKey = `${item.value ?? item.dataKey ?? index}`;\n\n        return (\n          <div key={rowKey} className=\"[&>svg]:text-muted-foreground flex items-center gap-1.5 [&>svg]:h-3 [&>svg]:w-3\">\n            {itemConfig?.icon && !hideIcon ? (\n              <itemConfig.icon />\n            ) : (\n              <div\n                className=\"h-2 w-2 shrink-0 rounded-[2px]\"\n                style={{\n                  backgroundColor: item.color\n                }}\n              />\n            )}\n            {itemConfig?.label}\n          </div>\n        );\n      })}\n    </div>\n  );\n}\n\n/**\n * Tra `config` từ một phần tử payload của recharts.\n * Payload có 2 tầng (`item` và `item.payload`) và khoá tra có thể nằm ở tầng nào cũng được —\n * hàm này thử cả hai trước khi rơi về chính `key`.\n */\nfunction getPayloadConfigFromPayload(config: ChartConfig, payload: unknown, key: string) {\n  if (typeof payload !== \"object\" || payload === null) {\n    return undefined;\n  }\n\n  const payloadPayload =\n    \"payload\" in payload && typeof payload.payload === \"object\" && payload.payload !== null\n      ? payload.payload\n      : undefined;\n\n  let configLabelKey: string = key;\n\n  if (key in payload && typeof payload[key as keyof typeof payload] === \"string\") {\n    configLabelKey = payload[key as keyof typeof payload] as string;\n  } else if (\n    payloadPayload &&\n    key in payloadPayload &&\n    typeof payloadPayload[key as keyof typeof payloadPayload] === \"string\"\n  ) {\n    configLabelKey = payloadPayload[key as keyof typeof payloadPayload] as string;\n  }\n\n  return configLabelKey in config ? config[configLabelKey] : config[key];\n}\n\nexport { ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, useChart };\n"],"mappings":"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","names":[]}

package/dist/chart/comitor-chart.d.ts

@@ -0,0 +1,109 @@
+import * as React from 'react';
+import { TooltipProps } from 'recharts';
+
+/**
+ * Biểu đồ "lắp sẵn" của Comitor — dựng nhanh line/bar/area chỉ với `data` + `series`.
+ * Khác `chart.tsx` (primitive shadcn thô, tự lắp recharts), file này là tầng tiện dụng:
+ * đã chọn sẵn trục, lưới, tooltip và bảng màu theo token.
+ *
+ * ⚠ Tên export ĐÃ ĐỔI so với comitor-ds vì hai file đụng nhau trong cùng entry `/chart`:
+ *   `ChartContainer` → `ComitorChartContainer`, `ChartTooltip` → `ComitorChartTooltip`.
+ *   Tên trần `ChartContainer`/`ChartTooltip` để dành cho primitive shadcn (giữ tương thích
+ *   `shadcn add`). Code mẫu cũ trong trang docs comitor-ds phải sửa theo.
+ */
+/**
+ * Bảng màu series mặc định — trỏ vào `--chart-1…5` trong `styles.css`.
+ *
+ * Vì sao không lấy thẳng `var(--gold-300)`, `var(--teal)`… như comitor-ds: bảng màu biểu đồ
+ * cần đổi ĐỘC LẬP với brand (app đổi `--chart-*` ở `<body>` là xong), và `--chart-3` có bản
+ * dark riêng (navy nguyên bản chìm vào nền tối).
+ *
+ * Dùng `var(--chart-N)` chứ KHÔNG dùng `var(--color-chart-N)`: bản `--chart-*` được khai
+ * tường minh trong `:root` của `styles.css` nên chắc chắn tồn tại, còn `--color-chart-*` là
+ * biến do `@theme inline` của Tailwind sinh ra.
+ */
+declare const CHART_SERIES_COLORS: readonly ["var(--chart-1)", "var(--chart-2)", "var(--chart-3)", "var(--chart-4)", "var(--chart-5)"];
+/**
+ * Màu gọi theo tên — dùng khi muốn chỉ định màu cho một series cụ thể
+ * (`series: [{ key: "loi", color: CHART_COLORS.red }]`).
+ *
+ * ⚠ Khoá `gray` của comitor-ds đổi thành `ash`: thang xám của package là `--ash-*`,
+ * `gray-*` để nguyên cho Tailwind (xem chú thích thang màu trong `styles.css`).
+ */
+declare const CHART_COLORS: {
+    readonly gold: "var(--chart-1)";
+    readonly goldLight: "var(--gold-100)";
+    readonly teal: "var(--chart-2)";
+    readonly navy: "var(--chart-3)";
+    readonly green: "var(--chart-4)";
+    readonly red: "var(--chart-5)";
+    readonly ash: "var(--ash-300)";
+};
+type ChartColorName = keyof typeof CHART_COLORS;
+interface ComitorChartTooltipProps {
+    /** Do recharts bơm vào — đừng truyền tay. */
+    active?: boolean;
+    /** Do recharts bơm vào — đừng truyền tay. */
+    payload?: TooltipProps<number, string>["payload"];
+    /** Do recharts bơm vào — đừng truyền tay. */
+    label?: string;
+    /** Định dạng nhãn trục X (ví dụ đổi "2026-01" → "Th01/2026"). */
+    labelFormatter?: (label: string) => string;
+    /** Định dạng giá trị (ví dụ thêm "₫", "%"). Mặc định: `toLocaleString("vi-VN")`. */
+    valueFormatter?: (value: number) => string;
+}
+/**
+ * Tooltip theo token Comitor. Truyền vào recharts dưới dạng element:
+ * `<Tooltip content={<ComitorChartTooltip valueFormatter={f} />} />`.
+ */
+declare function ComitorChartTooltip({ active, payload, label, labelFormatter, valueFormatter }: ComitorChartTooltipProps): React.JSX.Element | null;
+interface ComitorChartContainerProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Chiều cao khung. Số → px. Mặc định 300. */
+    height?: number | string;
+    ref?: React.Ref<HTMLDivElement>;
+}
+/**
+ * Khung `ResponsiveContainer` cao cố định. Khác `ChartContainer` của shadcn ở chỗ:
+ * không cấp context `config`, không sinh biến `--color-<key>` — chỉ lo kích thước.
+ */
+declare function ComitorChartContainer({ height, className, children, ref, ...props }: ComitorChartContainerProps): React.JSX.Element;
+/** Một series (một đường/cột/vùng) trong biểu đồ. */
+interface DataSeries {
+    /** Tên trường trong `data`. */
+    key: string;
+    /** Nhãn hiển thị ở tooltip/chú giải. Mặc định lấy `key`. */
+    name?: string;
+    /** Màu — nên lấy từ `CHART_COLORS` hoặc `var(--chart-N)`, đừng ghi hex. */
+    color?: string;
+}
+interface BaseChartProps {
+    data: Record<string, unknown>[];
+    /** Tên trường dùng cho trục X. */
+    xAxisKey: string;
+    height?: number | string;
+    className?: string;
+    showGrid?: boolean;
+    showLegend?: boolean;
+    valueFormatter?: (value: number) => string;
+}
+interface ComitorLineChartProps extends BaseChartProps {
+    series: DataSeries[];
+}
+/** Biểu đồ đường — dùng cho xu hướng theo thời gian. */
+declare function ComitorLineChart({ data, xAxisKey, series, height, className, showGrid, showLegend, valueFormatter }: ComitorLineChartProps): React.JSX.Element;
+interface ComitorBarChartProps extends BaseChartProps {
+    series: DataSeries[];
+    /** Chồng các series lên nhau thay vì xếp cạnh. */
+    stacked?: boolean;
+}
+/** Biểu đồ cột — dùng cho so sánh giữa các hạng mục. Lưới chỉ kẻ ngang. */
+declare function ComitorBarChart({ data, xAxisKey, series, height, className, showGrid, showLegend, stacked, valueFormatter }: ComitorBarChartProps): React.JSX.Element;
+interface ComitorAreaChartProps extends BaseChartProps {
+    series: DataSeries[];
+    /** Chồng các series lên nhau (tổng tích luỹ). */
+    stacked?: boolean;
+}
+/** Biểu đồ vùng — xu hướng kèm cảm giác khối lượng; `fillOpacity` 0.15 để chồng lớp còn đọc được. */
+declare function ComitorAreaChart({ data, xAxisKey, series, height, className, showGrid, showLegend, stacked, valueFormatter }: ComitorAreaChartProps): React.JSX.Element;
+
+export { type BaseChartProps, CHART_COLORS, CHART_SERIES_COLORS, type ChartColorName, ComitorAreaChart, type ComitorAreaChartProps, ComitorBarChart, type ComitorBarChartProps, ComitorChartContainer, type ComitorChartContainerProps, ComitorChartTooltip, type ComitorChartTooltipProps, ComitorLineChart, type ComitorLineChartProps, type DataSeries };

package/dist/chart/comitor-chart.js

@@ -0,0 +1,189 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import {
+  Area,
+  AreaChart,
+  Bar,
+  BarChart,
+  CartesianGrid,
+  Legend,
+  Line,
+  LineChart,
+  ResponsiveContainer,
+  Tooltip,
+  XAxis,
+  YAxis
+} from "recharts";
+import { cn } from "../lib/cn.js";
+const CHART_SERIES_COLORS = [
+  "var(--chart-1)",
+  "var(--chart-2)",
+  "var(--chart-3)",
+  "var(--chart-4)",
+  "var(--chart-5)"
+];
+const CHART_COLORS = {
+  gold: "var(--chart-1)",
+  goldLight: "var(--gold-100)",
+  teal: "var(--chart-2)",
+  navy: "var(--chart-3)",
+  green: "var(--chart-4)",
+  red: "var(--chart-5)",
+  ash: "var(--ash-300)"
+};
+function seriesColor(series, index) {
+  return series.color ?? CHART_SERIES_COLORS[index % CHART_SERIES_COLORS.length] ?? CHART_SERIES_COLORS[0];
+}
+function ComitorChartTooltip({
+  active,
+  payload,
+  label,
+  labelFormatter,
+  valueFormatter
+}) {
+  if (!active || !payload?.length) return null;
+  return /* @__PURE__ */ jsxs("div", { "data-slot": "comitor-chart-tooltip", className: "rounded-lg border border-border bg-card px-3 py-2 shadow-card", children: [
+    label && /* @__PURE__ */ jsx("p", { className: "text-xs font-medium text-foreground mb-1.5", children: labelFormatter ? labelFormatter(label) : label }),
+    /* @__PURE__ */ jsx("div", { className: "space-y-1", children: payload.map((entry, i) => {
+      const value = entry.value;
+      const display = value === void 0 ? "\u2014" : valueFormatter?.(value) ?? value.toLocaleString("vi-VN");
+      return /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 text-xs", children: [
+        /* @__PURE__ */ jsx("span", { className: "h-2 w-2 rounded-full shrink-0", style: { backgroundColor: entry.color } }),
+        /* @__PURE__ */ jsxs("span", { className: "text-muted-foreground", children: [
+          entry.name,
+          ":"
+        ] }),
+        /* @__PURE__ */ jsx("span", { className: "font-medium text-foreground", children: display })
+      ] }, `${entry.dataKey ?? entry.name ?? i}`);
+    }) })
+  ] });
+}
+function ComitorChartContainer({
+  height = 300,
+  className,
+  children,
+  ref,
+  ...props
+}) {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ref,
+      "data-slot": "comitor-chart",
+      className: cn("w-full", className),
+      style: { height: typeof height === "number" ? `${height}px` : height },
+      ...props,
+      children: /* @__PURE__ */ jsx(ResponsiveContainer, { width: "100%", height: "100%", children })
+    }
+  );
+}
+const AXIS_TICK = { fontSize: 11, fill: "var(--muted-foreground)" };
+const AXIS_LINE = { stroke: "var(--border)" };
+const CHART_MARGIN = { top: 8, right: 8, left: 0, bottom: 0 };
+function ComitorLineChart({
+  data,
+  xAxisKey,
+  series,
+  height = 300,
+  className,
+  showGrid = true,
+  showLegend = false,
+  valueFormatter
+}) {
+  return /* @__PURE__ */ jsx(ComitorChartContainer, { height, className, children: /* @__PURE__ */ jsxs(LineChart, { data, margin: CHART_MARGIN, children: [
+    showGrid && /* @__PURE__ */ jsx(CartesianGrid, { strokeDasharray: "3 3", stroke: "var(--border)" }),
+    /* @__PURE__ */ jsx(XAxis, { dataKey: xAxisKey, tick: AXIS_TICK, axisLine: AXIS_LINE, tickLine: AXIS_LINE }),
+    /* @__PURE__ */ jsx(YAxis, { tick: AXIS_TICK, axisLine: AXIS_LINE, tickLine: AXIS_LINE }),
+    /* @__PURE__ */ jsx(Tooltip, { content: /* @__PURE__ */ jsx(ComitorChartTooltip, { valueFormatter }) }),
+    showLegend && /* @__PURE__ */ jsx(Legend, {}),
+    series.map((s, i) => /* @__PURE__ */ jsx(
+      Line,
+      {
+        type: "monotone",
+        dataKey: s.key,
+        name: s.name || s.key,
+        stroke: seriesColor(s, i),
+        strokeWidth: 2,
+        dot: false,
+        activeDot: { r: 4, strokeWidth: 0 }
+      },
+      s.key
+    ))
+  ] }) });
+}
+function ComitorBarChart({
+  data,
+  xAxisKey,
+  series,
+  height = 300,
+  className,
+  showGrid = true,
+  showLegend = false,
+  stacked = false,
+  valueFormatter
+}) {
+  return /* @__PURE__ */ jsx(ComitorChartContainer, { height, className, children: /* @__PURE__ */ jsxs(BarChart, { data, margin: CHART_MARGIN, children: [
+    showGrid && /* @__PURE__ */ jsx(CartesianGrid, { strokeDasharray: "3 3", stroke: "var(--border)", vertical: false }),
+    /* @__PURE__ */ jsx(XAxis, { dataKey: xAxisKey, tick: AXIS_TICK, axisLine: AXIS_LINE, tickLine: AXIS_LINE }),
+    /* @__PURE__ */ jsx(YAxis, { tick: AXIS_TICK, axisLine: AXIS_LINE, tickLine: AXIS_LINE }),
+    /* @__PURE__ */ jsx(Tooltip, { content: /* @__PURE__ */ jsx(ComitorChartTooltip, { valueFormatter }) }),
+    showLegend && /* @__PURE__ */ jsx(Legend, {}),
+    series.map((s, i) => /* @__PURE__ */ jsx(
+      Bar,
+      {
+        dataKey: s.key,
+        name: s.name || s.key,
+        fill: seriesColor(s, i),
+        radius: [4, 4, 0, 0],
+        stackId: stacked ? "stack" : void 0
+      },
+      s.key
+    ))
+  ] }) });
+}
+function ComitorAreaChart({
+  data,
+  xAxisKey,
+  series,
+  height = 300,
+  className,
+  showGrid = true,
+  showLegend = false,
+  stacked = false,
+  valueFormatter
+}) {
+  return /* @__PURE__ */ jsx(ComitorChartContainer, { height, className, children: /* @__PURE__ */ jsxs(AreaChart, { data, margin: CHART_MARGIN, children: [
+    showGrid && /* @__PURE__ */ jsx(CartesianGrid, { strokeDasharray: "3 3", stroke: "var(--border)" }),
+    /* @__PURE__ */ jsx(XAxis, { dataKey: xAxisKey, tick: AXIS_TICK, axisLine: AXIS_LINE, tickLine: AXIS_LINE }),
+    /* @__PURE__ */ jsx(YAxis, { tick: AXIS_TICK, axisLine: AXIS_LINE, tickLine: AXIS_LINE }),
+    /* @__PURE__ */ jsx(Tooltip, { content: /* @__PURE__ */ jsx(ComitorChartTooltip, { valueFormatter }) }),
+    showLegend && /* @__PURE__ */ jsx(Legend, {}),
+    series.map((s, i) => {
+      const color = seriesColor(s, i);
+      return /* @__PURE__ */ jsx(
+        Area,
+        {
+          type: "monotone",
+          dataKey: s.key,
+          name: s.name || s.key,
+          stroke: color,
+          fill: color,
+          fillOpacity: 0.15,
+          strokeWidth: 2,
+          stackId: stacked ? "stack" : void 0
+        },
+        s.key
+      );
+    })
+  ] }) });
+}
+export {
+  CHART_COLORS,
+  CHART_SERIES_COLORS,
+  ComitorAreaChart,
+  ComitorBarChart,
+  ComitorChartContainer,
+  ComitorChartTooltip,
+  ComitorLineChart
+};
+//# sourceMappingURL=comitor-chart.js.map

package/dist/chart/comitor-chart.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/chart/comitor-chart.tsx"],"sourcesContent":["\"use client\";\n\nimport type * as React from \"react\";\nimport {\n  Area,\n  AreaChart,\n  Bar,\n  BarChart,\n  CartesianGrid,\n  Legend,\n  Line,\n  LineChart,\n  ResponsiveContainer,\n  Tooltip,\n  type TooltipProps,\n  XAxis,\n  YAxis\n} from \"recharts\";\nimport { cn } from \"../lib/cn.js\";\n\n/**\n * Biểu đồ \"lắp sẵn\" của Comitor — dựng nhanh line/bar/area chỉ với `data` + `series`.\n * Khác `chart.tsx` (primitive shadcn thô, tự lắp recharts), file này là tầng tiện dụng:\n * đã chọn sẵn trục, lưới, tooltip và bảng màu theo token.\n *\n * ⚠ Tên export ĐÃ ĐỔI so với comitor-ds vì hai file đụng nhau trong cùng entry `/chart`:\n *   `ChartContainer` → `ComitorChartContainer`, `ChartTooltip` → `ComitorChartTooltip`.\n *   Tên trần `ChartContainer`/`ChartTooltip` để dành cho primitive shadcn (giữ tương thích\n *   `shadcn add`). Code mẫu cũ trong trang docs comitor-ds phải sửa theo.\n */\n\n/**\n * Bảng màu series mặc định — trỏ vào `--chart-1…5` trong `styles.css`.\n *\n * Vì sao không lấy thẳng `var(--gold-300)`, `var(--teal)`… như comitor-ds: bảng màu biểu đồ\n * cần đổi ĐỘC LẬP với brand (app đổi `--chart-*` ở `<body>` là xong), và `--chart-3` có bản\n * dark riêng (navy nguyên bản chìm vào nền tối).\n *\n * Dùng `var(--chart-N)` chứ KHÔNG dùng `var(--color-chart-N)`: bản `--chart-*` được khai\n * tường minh trong `:root` của `styles.css` nên chắc chắn tồn tại, còn `--color-chart-*` là\n * biến do `@theme inline` của Tailwind sinh ra.\n */\nexport const CHART_SERIES_COLORS = [\n  \"var(--chart-1)\",\n  \"var(--chart-2)\",\n  \"var(--chart-3)\",\n  \"var(--chart-4)\",\n  \"var(--chart-5)\"\n] as const;\n\n/**\n * Màu gọi theo tên — dùng khi muốn chỉ định màu cho một series cụ thể\n * (`series: [{ key: \"loi\", color: CHART_COLORS.red }]`).\n *\n * ⚠ Khoá `gray` của comitor-ds đổi thành `ash`: thang xám của package là `--ash-*`,\n * `gray-*` để nguyên cho Tailwind (xem chú thích thang màu trong `styles.css`).\n */\nexport const CHART_COLORS = {\n  gold: \"var(--chart-1)\",\n  goldLight: \"var(--gold-100)\",\n  teal: \"var(--chart-2)\",\n  navy: \"var(--chart-3)\",\n  green: \"var(--chart-4)\",\n  red: \"var(--chart-5)\",\n  ash: \"var(--ash-300)\"\n} as const;\n\nexport type ChartColorName = keyof typeof CHART_COLORS;\n\n/** Lấy màu cho series thứ `index`: ưu tiên màu tự khai, không có thì xoay vòng bảng mặc định. */\nfunction seriesColor(series: DataSeries, index: number): string {\n  return series.color ?? CHART_SERIES_COLORS[index % CHART_SERIES_COLORS.length] ?? CHART_SERIES_COLORS[0];\n}\n\n// ─── Tooltip ────────────────────────────────────────────────────────────────\n\nexport interface ComitorChartTooltipProps {\n  /** Do recharts bơm vào — đừng truyền tay. */\n  active?: boolean;\n  /** Do recharts bơm vào — đừng truyền tay. */\n  payload?: TooltipProps<number, string>[\"payload\"];\n  /** Do recharts bơm vào — đừng truyền tay. */\n  label?: string;\n  /** Định dạng nhãn trục X (ví dụ đổi \"2026-01\" → \"Th01/2026\"). */\n  labelFormatter?: (label: string) => string;\n  /** Định dạng giá trị (ví dụ thêm \"₫\", \"%\"). Mặc định: `toLocaleString(\"vi-VN\")`. */\n  valueFormatter?: (value: number) => string;\n}\n\n/**\n * Tooltip theo token Comitor. Truyền vào recharts dưới dạng element:\n * `<Tooltip content={<ComitorChartTooltip valueFormatter={f} />} />`.\n */\nexport function ComitorChartTooltip({\n  active,\n  payload,\n  label,\n  labelFormatter,\n  valueFormatter\n}: ComitorChartTooltipProps) {\n  if (!active || !payload?.length) return null;\n\n  return (\n    <div data-slot=\"comitor-chart-tooltip\" className=\"rounded-lg border border-border bg-card px-3 py-2 shadow-card\">\n      {label && (\n        <p className=\"text-xs font-medium text-foreground mb-1.5\">{labelFormatter ? labelFormatter(label) : label}</p>\n      )}\n      <div className=\"space-y-1\">\n        {payload.map((entry, i) => {\n          const value = entry.value;\n          const display = value === undefined ? \"—\" : (valueFormatter?.(value) ?? value.toLocaleString(\"vi-VN\"));\n\n          return (\n            <div key={`${entry.dataKey ?? entry.name ?? i}`} className=\"flex items-center gap-2 text-xs\">\n              <span className=\"h-2 w-2 rounded-full shrink-0\" style={{ backgroundColor: entry.color }} />\n              <span className=\"text-muted-foreground\">{entry.name}:</span>\n              <span className=\"font-medium text-foreground\">{display}</span>\n            </div>\n          );\n        })}\n      </div>\n    </div>\n  );\n}\n\n// ─── Khung ──────────────────────────────────────────────────────────────────\n\nexport interface ComitorChartContainerProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Chiều cao khung. Số → px. Mặc định 300. */\n  height?: number | string;\n  ref?: React.Ref<HTMLDivElement>;\n}\n\n/**\n * Khung `ResponsiveContainer` cao cố định. Khác `ChartContainer` của shadcn ở chỗ:\n * không cấp context `config`, không sinh biến `--color-<key>` — chỉ lo kích thước.\n */\nexport function ComitorChartContainer({\n  height = 300,\n  className,\n  children,\n  ref,\n  ...props\n}: ComitorChartContainerProps) {\n  return (\n    <div\n      ref={ref}\n      data-slot=\"comitor-chart\"\n      className={cn(\"w-full\", className)}\n      style={{ height: typeof height === \"number\" ? `${height}px` : height }}\n      {...props}\n    >\n      <ResponsiveContainer width=\"100%\" height=\"100%\">\n        {children as React.ReactElement}\n      </ResponsiveContainer>\n    </div>\n  );\n}\n\n// ─── Kiểu dùng chung ────────────────────────────────────────────────────────\n\n/** Một series (một đường/cột/vùng) trong biểu đồ. */\nexport interface DataSeries {\n  /** Tên trường trong `data`. */\n  key: string;\n  /** Nhãn hiển thị ở tooltip/chú giải. Mặc định lấy `key`. */\n  name?: string;\n  /** Màu — nên lấy từ `CHART_COLORS` hoặc `var(--chart-N)`, đừng ghi hex. */\n  color?: string;\n}\n\nexport interface BaseChartProps {\n  data: Record<string, unknown>[];\n  /** Tên trường dùng cho trục X. */\n  xAxisKey: string;\n  height?: number | string;\n  className?: string;\n  showGrid?: boolean;\n  showLegend?: boolean;\n  valueFormatter?: (value: number) => string;\n}\n\n/** Style dùng chung cho tick của cả hai trục — gom lại để 3 biểu đồ không lệch nhau. */\nconst AXIS_TICK = { fontSize: 11, fill: \"var(--muted-foreground)\" } as const;\nconst AXIS_LINE = { stroke: \"var(--border)\" } as const;\nconst CHART_MARGIN = { top: 8, right: 8, left: 0, bottom: 0 } as const;\n\n// ─── Line ───────────────────────────────────────────────────────────────────\n\nexport interface ComitorLineChartProps extends BaseChartProps {\n  series: DataSeries[];\n}\n\n/** Biểu đồ đường — dùng cho xu hướng theo thời gian. */\nexport function ComitorLineChart({\n  data,\n  xAxisKey,\n  series,\n  height = 300,\n  className,\n  showGrid = true,\n  showLegend = false,\n  valueFormatter\n}: ComitorLineChartProps) {\n  return (\n    <ComitorChartContainer height={height} className={className}>\n      <LineChart data={data} margin={CHART_MARGIN}>\n        {showGrid && <CartesianGrid strokeDasharray=\"3 3\" stroke=\"var(--border)\" />}\n        <XAxis dataKey={xAxisKey} tick={AXIS_TICK} axisLine={AXIS_LINE} tickLine={AXIS_LINE} />\n        <YAxis tick={AXIS_TICK} axisLine={AXIS_LINE} tickLine={AXIS_LINE} />\n        <Tooltip content={<ComitorChartTooltip valueFormatter={valueFormatter} />} />\n        {showLegend && <Legend />}\n        {series.map((s, i) => (\n          <Line\n            key={s.key}\n            type=\"monotone\"\n            dataKey={s.key}\n            name={s.name || s.key}\n            stroke={seriesColor(s, i)}\n            strokeWidth={2}\n            dot={false}\n            activeDot={{ r: 4, strokeWidth: 0 }}\n          />\n        ))}\n      </LineChart>\n    </ComitorChartContainer>\n  );\n}\n\n// ─── Bar ────────────────────────────────────────────────────────────────────\n\nexport interface ComitorBarChartProps extends BaseChartProps {\n  series: DataSeries[];\n  /** Chồng các series lên nhau thay vì xếp cạnh. */\n  stacked?: boolean;\n}\n\n/** Biểu đồ cột — dùng cho so sánh giữa các hạng mục. Lưới chỉ kẻ ngang. */\nexport function ComitorBarChart({\n  data,\n  xAxisKey,\n  series,\n  height = 300,\n  className,\n  showGrid = true,\n  showLegend = false,\n  stacked = false,\n  valueFormatter\n}: ComitorBarChartProps) {\n  return (\n    <ComitorChartContainer height={height} className={className}>\n      <BarChart data={data} margin={CHART_MARGIN}>\n        {showGrid && <CartesianGrid strokeDasharray=\"3 3\" stroke=\"var(--border)\" vertical={false} />}\n        <XAxis dataKey={xAxisKey} tick={AXIS_TICK} axisLine={AXIS_LINE} tickLine={AXIS_LINE} />\n        <YAxis tick={AXIS_TICK} axisLine={AXIS_LINE} tickLine={AXIS_LINE} />\n        <Tooltip content={<ComitorChartTooltip valueFormatter={valueFormatter} />} />\n        {showLegend && <Legend />}\n        {series.map((s, i) => (\n          <Bar\n            key={s.key}\n            dataKey={s.key}\n            name={s.name || s.key}\n            fill={seriesColor(s, i)}\n            radius={[4, 4, 0, 0]}\n            stackId={stacked ? \"stack\" : undefined}\n          />\n        ))}\n      </BarChart>\n    </ComitorChartContainer>\n  );\n}\n\n// ─── Area ───────────────────────────────────────────────────────────────────\n\nexport interface ComitorAreaChartProps extends BaseChartProps {\n  series: DataSeries[];\n  /** Chồng các series lên nhau (tổng tích luỹ). */\n  stacked?: boolean;\n}\n\n/** Biểu đồ vùng — xu hướng kèm cảm giác khối lượng; `fillOpacity` 0.15 để chồng lớp còn đọc được. */\nexport function ComitorAreaChart({\n  data,\n  xAxisKey,\n  series,\n  height = 300,\n  className,\n  showGrid = true,\n  showLegend = false,\n  stacked = false,\n  valueFormatter\n}: ComitorAreaChartProps) {\n  return (\n    <ComitorChartContainer height={height} className={className}>\n      <AreaChart data={data} margin={CHART_MARGIN}>\n        {showGrid && <CartesianGrid strokeDasharray=\"3 3\" stroke=\"var(--border)\" />}\n        <XAxis dataKey={xAxisKey} tick={AXIS_TICK} axisLine={AXIS_LINE} tickLine={AXIS_LINE} />\n        <YAxis tick={AXIS_TICK} axisLine={AXIS_LINE} tickLine={AXIS_LINE} />\n        <Tooltip content={<ComitorChartTooltip valueFormatter={valueFormatter} />} />\n        {showLegend && <Legend />}\n        {series.map((s, i) => {\n          const color = seriesColor(s, i);\n          return (\n            <Area\n              key={s.key}\n              type=\"monotone\"\n              dataKey={s.key}\n              name={s.name || s.key}\n              stroke={color}\n              fill={color}\n              fillOpacity={0.15}\n              strokeWidth={2}\n              stackId={stacked ? \"stack\" : undefined}\n            />\n          );\n        })}\n      </AreaChart>\n    </ComitorChartContainer>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/chart/index.d.ts

@@ -0,0 +1,4 @@
+export { ChartConfig, ChartContainer, ChartContainerProps, ChartLegend, ChartLegendContent, ChartLegendContentProps, ChartStyle, ChartStyleProps, ChartTooltip, ChartTooltipContent, ChartTooltipContentProps, useChart } from './chart.js';
+export { BaseChartProps, CHART_COLORS, CHART_SERIES_COLORS, ChartColorName, ComitorAreaChart, ComitorAreaChartProps, ComitorBarChart, ComitorBarChartProps, ComitorChartContainer, ComitorChartContainerProps, ComitorChartTooltip, ComitorChartTooltipProps, ComitorLineChart, ComitorLineChartProps, DataSeries } from './comitor-chart.js';
+import 'react';
+import 'recharts';

package/dist/chart/index.js

@@ -0,0 +1,3 @@
+export * from "./chart.js";
+export * from "./comitor-chart.js";
+//# sourceMappingURL=index.js.map

package/dist/chart/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/chart/index.ts"],"sourcesContent":["/**\n * Entry \"@comitor/ui/chart\" — Chart* (shadcn) + ComitorChart* + CHART_COLORS.\n *\n * Tách riêng vì `recharts` nặng (~100KB) và là peer OPTIONAL; đa số trang không vẽ biểu đồ.\n *\n * ⚠ Va tên đã xử lý ở tầng file: `chart.tsx` giữ tên trần `ChartContainer`/`ChartTooltip`\n * (API shadcn); bản tiện dụng của comitor-ds mang tiền tố `ComitorChartContainer`/\n * `ComitorChartTooltip`. Đừng đặt lại tên trần trong `comitor-chart.tsx`, barrel này\n * dùng `export *` nên sẽ vỡ ngay lúc build.\n */\nexport * from \"./chart.js\";\nexport * from \"./comitor-chart.js\";\n"],"mappings":"AAUA,cAAc;AACd,cAAc;","names":[]}

package/dist/components/composite/avatar-group.d.ts

@@ -0,0 +1,33 @@
+import * as React from 'react';
+import { ComponentProps } from 'react';
+import { LetterAvatarSize } from './letter-avatar.js';
+
+interface AvatarGroupItem {
+    id: string;
+    name: string;
+    src?: string | null;
+    /** Dòng phụ trong tooltip (vd email, vai trò) */
+    caption?: string;
+}
+interface AvatarGroupProps extends Omit<ComponentProps<"div">, "children"> {
+    items: AvatarGroupItem[];
+    /** Số avatar hiện tối đa; phần dư gộp vào ô "+k" (mặc định 4) */
+    max?: number;
+    size?: LetterAvatarSize;
+    /** Bấm vào ô "+k" — vd mở danh sách đầy đủ */
+    onOverflowClick?: () => void;
+    /** Nhãn của cả nhóm cho trình đọc màn hình (mặc định "Thành viên") */
+    label?: string;
+}
+/**
+ * Chồng avatar + ô "+k" — dùng cho người thực hiện (Tasks), người tham gia (Chat), người theo dõi (CRM).
+ *
+ * Tooltip hiện tên đầy đủ vì avatar chồng nhau thì initials bị che một phần; không có tooltip
+ * thì nhóm avatar chỉ là trang trí, người dùng không biết ai đang ở trong việc.
+ *
+ * Mỗi avatar là một nút focusable (Tab tới được) và mang tên thành viên cho trình đọc màn hình
+ * — xem chú thích ở trigger bên dưới.
+ */
+declare function AvatarGroup({ items, max, size, onOverflowClick, label, className, ...props }: AvatarGroupProps): React.JSX.Element;
+
+export { AvatarGroup, type AvatarGroupItem, type AvatarGroupProps };