@dreamtree-org/twreact-ui 1.3.1 → 1.3.2

package/dist/esm/components/charts/ChartFrame.js

@@ -0,0 +1,170 @@
+'use client';
+import { objectWithoutProperties as _objectWithoutProperties, objectSpread2 as _objectSpread2 } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { jsx, jsxs } from 'react/jsx-runtime';
+import React, { useId } from 'react';
+import { cn } from '../../utils/cn.js';
+
+var _excluded = ["className", "title", "description", "defaultTitle", "data", "height", "emptyState", "legend", "accessibleTable", "tableColumns", "children", "aria-label"];
+// The swatch colour arrives as a custom property so a token (`rgb(var(--dt-*))`)
+// and a resolved rgb() string both work.
+var swatch = function swatch(size) {
+  return cn("inline-block shrink-0 rounded-full bg-[color:var(--dt-chart-color)]", size);
+};
+var sizeStyle = function sizeStyle(height) {
+  return {
+    height: typeof height === "number" ? "".concat(height, "px") : height
+  };
+};
+function ChartLegend(_ref) {
+  var items = _ref.items;
+  return jsx("ul", {
+    className: "mt-3 flex flex-wrap items-center justify-center gap-x-4 gap-y-1 text-xs text-gray-600 dark:text-gray-300",
+    "data-testid": "chart-legend",
+    children: items.map(function (item) {
+      return jsxs("li", {
+        className: "inline-flex items-center gap-1.5",
+        children: [jsx("span", {
+          className: swatch("h-2.5 w-2.5"),
+          style: {
+            "--dt-chart-color": item.color
+          },
+          "aria-hidden": "true"
+        }), jsx("span", {
+          children: item.name
+        })]
+      }, item.name);
+    })
+  });
+}
+function ChartTooltipContent(_ref2) {
+  var active = _ref2.active,
+    payload = _ref2.payload,
+    label = _ref2.label,
+    valueFormatter = _ref2.valueFormatter,
+    _ref2$hideLabel = _ref2.hideLabel,
+    hideLabel = _ref2$hideLabel === void 0 ? false : _ref2$hideLabel;
+  if (!active || !payload || !payload.length) return null;
+  return jsxs("div", {
+    className: "rounded-md border border-gray-200 bg-white px-3 py-2 text-xs text-gray-900 shadow-md dark:border-gray-700 dark:bg-gray-900 dark:text-gray-100",
+    children: [!hideLabel && label != null && label !== "" && jsx("p", {
+      className: "mb-1 font-medium",
+      children: label
+    }), jsx("ul", {
+      className: "space-y-0.5",
+      children: payload.map(function (entry) {
+        var _entry$payload;
+        return jsxs("li", {
+          className: "flex items-center gap-2",
+          children: [jsx("span", {
+            className: swatch("h-2 w-2"),
+            style: {
+              "--dt-chart-color": entry.color || ((_entry$payload = entry.payload) === null || _entry$payload === void 0 ? void 0 : _entry$payload.fill)
+            },
+            "aria-hidden": "true"
+          }), jsx("span", {
+            className: "text-gray-600 dark:text-gray-300",
+            children: entry.name
+          }), jsx("span", {
+            className: "ml-auto pl-3 font-medium tabular-nums",
+            children: valueFormatter(entry.value)
+          })]
+        }, "".concat(entry.dataKey, "-").concat(entry.name));
+      })
+    })]
+  });
+}
+function ChartDataTable(_ref3) {
+  var caption = _ref3.caption,
+    columns = _ref3.columns,
+    rows = _ref3.rows;
+  return jsxs("table", {
+    className: "sr-only",
+    "data-testid": "chart-data-table",
+    children: [caption && jsx("caption", {
+      children: caption
+    }), jsx("thead", {
+      children: jsx("tr", {
+        children: columns.map(function (c) {
+          return jsx("th", {
+            scope: "col",
+            children: c.label
+          }, c.key);
+        })
+      })
+    }), jsx("tbody", {
+      children: rows.map(function (row, r) {
+        return jsx("tr", {
+          children: columns.map(function (c, i) {
+            return i === 0 ? jsx("th", {
+              scope: "row",
+              children: c.format(row[c.key])
+            }, c.key) : jsx("td", {
+              children: c.format(row[c.key])
+            }, c.key);
+          })
+        }, r);
+      })
+    })]
+  });
+}
+/**
+ * The accessible shell every chart renders: the SVG lives in a `role="img"`
+ * region named by `title` and described by `description`; the numbers are
+ * repeated in a visually-hidden table (recharts' SVG has no accessible content).
+ */
+var ChartFrame = /*#__PURE__*/React.forwardRef(function ChartFrame(_ref4, ref) {
+  var className = _ref4.className,
+    title = _ref4.title,
+    description = _ref4.description,
+    defaultTitle = _ref4.defaultTitle,
+    data = _ref4.data,
+    height = _ref4.height,
+    _ref4$emptyState = _ref4.emptyState,
+    emptyState = _ref4$emptyState === void 0 ? "No data to display" : _ref4$emptyState,
+    legend = _ref4.legend,
+    _ref4$accessibleTable = _ref4.accessibleTable,
+    accessibleTable = _ref4$accessibleTable === void 0 ? true : _ref4$accessibleTable,
+    tableColumns = _ref4.tableColumns,
+    children = _ref4.children,
+    ariaLabel = _ref4["aria-label"],
+    rest = _objectWithoutProperties(_ref4, _excluded);
+  var descriptionId = useId();
+  var name = title || ariaLabel || defaultTitle;
+  if (!Array.isArray(data) || data.length === 0) {
+    return jsx("div", _objectSpread2(_objectSpread2({
+      ref: ref,
+      className: cn("flex w-full items-center justify-center rounded-md border border-dashed border-gray-300 text-sm text-gray-500 dark:border-gray-700 dark:text-gray-400", className),
+      style: sizeStyle(height),
+      role: "status",
+      "aria-label": name,
+      "data-empty": "true"
+    }, rest), {}, {
+      children: emptyState
+    }));
+  }
+  return jsxs("div", _objectSpread2(_objectSpread2({
+    ref: ref,
+    className: cn("w-full", className)
+  }, rest), {}, {
+    children: [jsx("div", {
+      role: "img",
+      "aria-label": name,
+      "aria-describedby": description ? descriptionId : undefined,
+      className: "w-full text-gray-500 dark:text-gray-400",
+      style: sizeStyle(height),
+      children: children
+    }), description && jsx("p", {
+      id: descriptionId,
+      className: "sr-only",
+      children: description
+    }), legend && legend.length > 0 && jsx(ChartLegend, {
+      items: legend
+    }), accessibleTable && jsx(ChartDataTable, {
+      caption: name,
+      columns: tableColumns,
+      rows: data
+    })]
+  }));
+});
+
+export { ChartFrame, ChartLegend, ChartTooltipContent };

package/dist/esm/components/charts/DonutChart.js

@@ -0,0 +1,119 @@
+'use client';
+import { objectWithoutProperties as _objectWithoutProperties, objectSpread2 as _objectSpread2 } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { jsx, jsxs } from 'react/jsx-runtime';
+import React from 'react';
+import { ResponsiveContainer, PieChart, Tooltip, Pie } from 'recharts';
+import { ChartFrame, ChartTooltipContent } from './ChartFrame.js';
+import { useChartTheme, useReducedMotion, defaultValueFormatter } from './chartTheme.js';
+
+var _excluded = ["data", "index", "category", "colors", "valueFormatter", "variant", "innerRadius", "outerRadius", "centerLabel", "height", "showLegend", "showTooltip", "animate", "title", "description", "emptyState", "accessibleTable", "className"];
+var DonutChart = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
+  var data = _ref.data,
+    _ref$index = _ref.index,
+    index = _ref$index === void 0 ? "name" : _ref$index,
+    _ref$category = _ref.category,
+    category = _ref$category === void 0 ? "value" : _ref$category,
+    colors = _ref.colors,
+    _ref$valueFormatter = _ref.valueFormatter,
+    valueFormatter = _ref$valueFormatter === void 0 ? defaultValueFormatter : _ref$valueFormatter,
+    _ref$variant = _ref.variant,
+    variant = _ref$variant === void 0 ? "donut" : _ref$variant,
+    _ref$innerRadius = _ref.innerRadius,
+    innerRadius = _ref$innerRadius === void 0 ? "60%" : _ref$innerRadius,
+    _ref$outerRadius = _ref.outerRadius,
+    outerRadius = _ref$outerRadius === void 0 ? "90%" : _ref$outerRadius,
+    centerLabel = _ref.centerLabel,
+    _ref$height = _ref.height,
+    height = _ref$height === void 0 ? 240 : _ref$height,
+    _ref$showLegend = _ref.showLegend,
+    showLegend = _ref$showLegend === void 0 ? true : _ref$showLegend,
+    _ref$showTooltip = _ref.showTooltip,
+    showTooltip = _ref$showTooltip === void 0 ? true : _ref$showTooltip,
+    _ref$animate = _ref.animate,
+    animate = _ref$animate === void 0 ? true : _ref$animate,
+    title = _ref.title,
+    description = _ref.description,
+    emptyState = _ref.emptyState,
+    _ref$accessibleTable = _ref.accessibleTable,
+    accessibleTable = _ref$accessibleTable === void 0 ? true : _ref$accessibleTable,
+    className = _ref.className,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var rows = Array.isArray(data) ? data : [];
+  var names = rows.map(function (row) {
+    return String(row[index]);
+  });
+  var _useChartTheme = useChartTheme(names, colors),
+    chrome = _useChartTheme.chrome,
+    series = _useChartTheme.series;
+  var reducedMotion = useReducedMotion();
+  var slices = rows.map(function (row, i) {
+    return _objectSpread2(_objectSpread2({}, row), {}, {
+      fill: series[i]
+    });
+  });
+  var isDonut = variant !== "pie";
+  return jsx(ChartFrame, _objectSpread2(_objectSpread2({
+    ref: ref,
+    className: className,
+    title: title,
+    description: description,
+    defaultTitle: isDonut ? "Donut chart" : "Pie chart",
+    data: data,
+    height: height,
+    emptyState: emptyState,
+    accessibleTable: accessibleTable,
+    legend: showLegend ? names.map(function (name, i) {
+      return {
+        name: name,
+        color: series[i]
+      };
+    }) : null,
+    tableColumns: [{
+      key: index,
+      label: index,
+      format: function format(v) {
+        return v == null ? "" : String(v);
+      }
+    }, {
+      key: category,
+      label: category,
+      format: valueFormatter
+    }]
+  }, rest), {}, {
+    children: jsxs("div", {
+      className: "relative h-full w-full",
+      children: [jsx(ResponsiveContainer, {
+        width: "100%",
+        height: "100%",
+        minWidth: 0,
+        children: jsxs(PieChart, {
+          accessibilityLayer: false,
+          children: [showTooltip && jsx(Tooltip, {
+            isAnimationActive: false,
+            content: jsx(ChartTooltipContent, {
+              valueFormatter: valueFormatter,
+              hideLabel: true
+            })
+          }), jsx(Pie, {
+            data: slices,
+            dataKey: category,
+            nameKey: index,
+            innerRadius: isDonut ? innerRadius : 0,
+            outerRadius: outerRadius,
+            paddingAngle: isDonut && rows.length > 1 ? 1 : 0,
+            stroke: chrome.surface,
+            strokeWidth: 2,
+            isAnimationActive: animate && !reducedMotion
+          })]
+        })
+      }), isDonut && centerLabel != null && jsx("div", {
+        className: "pointer-events-none absolute inset-0 flex items-center justify-center text-center text-sm font-semibold text-gray-900 dark:text-gray-100",
+        "aria-hidden": "true",
+        children: centerLabel
+      })]
+    })
+  }));
+});
+DonutChart.displayName = "DonutChart";
+
+export { DonutChart as default };

package/dist/esm/components/charts/LineChart.js

@@ -0,0 +1,16 @@
+'use client';
+import { objectSpread2 as _objectSpread2 } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { jsx } from 'react/jsx-runtime';
+import React from 'react';
+import CartesianChart from './CartesianChart.js';
+
+var LineChart = /*#__PURE__*/React.forwardRef(function (props, ref) {
+  return jsx(CartesianChart, _objectSpread2(_objectSpread2({
+    ref: ref
+  }, props), {}, {
+    kind: "line"
+  }));
+});
+LineChart.displayName = "LineChart";
+
+export { LineChart as default };

package/dist/esm/components/charts/Sparkline.js

@@ -0,0 +1,110 @@
+'use client';
+import { objectWithoutProperties as _objectWithoutProperties, objectSpread2 as _objectSpread2, toConsumableArray as _toConsumableArray } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { jsx, jsxs } from 'react/jsx-runtime';
+import React from 'react';
+import { ResponsiveContainer, AreaChart, LineChart, YAxis, Tooltip, Area, Line } from 'recharts';
+import { ChartFrame, ChartTooltipContent } from './ChartFrame.js';
+import { useChartTheme, useReducedMotion, defaultValueFormatter } from './chartTheme.js';
+
+var _excluded = ["data", "category", "index", "color", "type", "valueFormatter", "height", "showTooltip", "animate", "title", "description", "emptyState", "accessibleTable", "className"];
+/** A word-sized trend line: no axes, grid or legend — just the shape of the data. */
+var Sparkline = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
+  var data = _ref.data,
+    _ref$category = _ref.category,
+    category = _ref$category === void 0 ? "value" : _ref$category,
+    index = _ref.index,
+    _ref$color = _ref.color,
+    color = _ref$color === void 0 ? "primary" : _ref$color,
+    _ref$type = _ref.type,
+    type = _ref$type === void 0 ? "line" : _ref$type,
+    _ref$valueFormatter = _ref.valueFormatter,
+    valueFormatter = _ref$valueFormatter === void 0 ? defaultValueFormatter : _ref$valueFormatter,
+    _ref$height = _ref.height,
+    height = _ref$height === void 0 ? 40 : _ref$height,
+    _ref$showTooltip = _ref.showTooltip,
+    showTooltip = _ref$showTooltip === void 0 ? false : _ref$showTooltip,
+    _ref$animate = _ref.animate,
+    animate = _ref$animate === void 0 ? false : _ref$animate,
+    title = _ref.title,
+    description = _ref.description,
+    _ref$emptyState = _ref.emptyState,
+    emptyState = _ref$emptyState === void 0 ? "No data" : _ref$emptyState,
+    _ref$accessibleTable = _ref.accessibleTable,
+    accessibleTable = _ref$accessibleTable === void 0 ? true : _ref$accessibleTable,
+    className = _ref.className,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var _useChartTheme = useChartTheme([category], [color]),
+    series = _useChartTheme.series;
+  var reducedMotion = useReducedMotion();
+  var stroke = series[0];
+  var Root = type === "area" ? AreaChart : LineChart;
+  var common = {
+    dataKey: category,
+    name: category,
+    type: "monotone",
+    stroke: stroke,
+    strokeWidth: 2,
+    dot: false,
+    activeDot: showTooltip ? {
+      r: 3,
+      strokeWidth: 0,
+      fill: stroke
+    } : false,
+    isAnimationActive: animate && !reducedMotion
+  };
+  return jsx(ChartFrame, _objectSpread2(_objectSpread2({
+    ref: ref,
+    className: className,
+    title: title,
+    description: description,
+    defaultTitle: "Sparkline",
+    data: data,
+    height: height,
+    emptyState: emptyState,
+    accessibleTable: accessibleTable,
+    tableColumns: [].concat(_toConsumableArray(index ? [{
+      key: index,
+      label: index,
+      format: function format(v) {
+        return v == null ? "" : String(v);
+      }
+    }] : []), [{
+      key: category,
+      label: category,
+      format: valueFormatter
+    }])
+  }, rest), {}, {
+    children: jsx(ResponsiveContainer, {
+      width: "100%",
+      height: "100%",
+      minWidth: 0,
+      children: jsxs(Root, {
+        data: data,
+        margin: {
+          top: 2,
+          right: 2,
+          bottom: 2,
+          left: 2
+        },
+        accessibilityLayer: false,
+        children: [jsx(YAxis, {
+          hide: true,
+          domain: ["dataMin", "dataMax"]
+        }), showTooltip && jsx(Tooltip, {
+          isAnimationActive: false,
+          cursor: false,
+          content: jsx(ChartTooltipContent, {
+            valueFormatter: valueFormatter,
+            hideLabel: !index
+          })
+        }), type === "area" ? jsx(Area, _objectSpread2(_objectSpread2({}, common), {}, {
+          fill: stroke,
+          fillOpacity: 0.15
+        })) : jsx(Line, _objectSpread2({}, common))]
+      })
+    })
+  }));
+});
+Sparkline.displayName = "Sparkline";
+
+export { Sparkline as default };

package/dist/esm/components/charts/chartTheme.js

@@ -0,0 +1,109 @@
+'use client';
+import { slicedToArray as _slicedToArray } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { useState, useEffect } from 'react';
+import { prefersReducedMotion } from '../../utils/position.js';
+
+var CHART_PALETTES = ["primary", "secondary", "success", "warning", "error", "info", "gray"];
+var DEFAULT_CHART_COLORS = ["primary", "success", "warning", "error", "info", "secondary", "gray"];
+var TOKEN_RE = new RegExp("^(".concat(CHART_PALETTES.join("|"), ")(?:-(50|[1-9]00|950))?$"));
+var CHROME_VARS = {
+  grid: "--dt-line",
+  axis: "--dt-muted",
+  surface: "--dt-surface",
+  text: "--dt-foreground"
+};
+/** `"primary"` → `"--dt-primary-500"`, `"error-300"` → `"--dt-error-300"`; null for anything else. */
+function tokenVar(color) {
+  var m = TOKEN_RE.exec(String(color || ""));
+  return m ? "--dt-".concat(m[1], "-").concat(m[2] || "500") : null;
+}
+function readVar(name) {
+  if (typeof window === "undefined" || typeof window.getComputedStyle !== "function") return "";
+  return window.getComputedStyle(document.documentElement).getPropertyValue(name).trim();
+}
+// SVG presentation attributes do not resolve var() in every engine, so a token is
+// turned into a concrete rgb() string when the browser can tell us its value. The
+// var() form is the SSR / jsdom fallback.
+function resolveVar(name) {
+  var value = readVar(name);
+  return value ? "rgb(".concat(value.split(/[\s,]+/).join(" "), ")") : "rgb(var(".concat(name, "))");
+}
+/**
+ * A series colour: a palette token (`primary`, `success-600`, …) resolves to the
+ * matching `--dt-*` variable; any other string is treated as a CSS colour supplied
+ * by the consumer (e.g. a colour stored with the data).
+ */
+function resolveColor(color) {
+  var name = tokenVar(color);
+  return name ? resolveVar(name) : color;
+}
+function seriesColors(categories, colors) {
+  var palette = colors && colors.length ? colors : DEFAULT_CHART_COLORS;
+  return categories.map(function (_, i) {
+    return resolveColor(palette[i % palette.length]);
+  });
+}
+function readChrome() {
+  return Object.fromEntries(Object.entries(CHROME_VARS).map(function (_ref) {
+    var _ref2 = _slicedToArray(_ref, 2),
+      k = _ref2[0],
+      v = _ref2[1];
+    return [k, resolveVar(v)];
+  }));
+}
+/**
+ * Chart chrome + series colours, re-read whenever the theme flips (the `dark`
+ * class or `data-theme` on <html>) so axes and series follow dark mode without
+ * a remount.
+ */
+function useChartTheme(categories, colors) {
+  var _useState = useState(0),
+    _useState2 = _slicedToArray(_useState, 2);
+    _useState2[0];
+    var setVersion = _useState2[1];
+  useEffect(function () {
+    if (typeof MutationObserver !== "function") return undefined;
+    var observer = new MutationObserver(function () {
+      return setVersion(function (v) {
+        return v + 1;
+      });
+    });
+    observer.observe(document.documentElement, {
+      attributes: true,
+      attributeFilter: ["class", "data-theme", "style"]
+    });
+    return function () {
+      return observer.disconnect();
+    };
+  }, []);
+  return {
+    chrome: readChrome(),
+    series: seriesColors(categories, colors)
+  };
+}
+/** `true` while the user asks the OS for reduced motion; follows changes live. */
+function useReducedMotion() {
+  var _useState3 = useState(prefersReducedMotion),
+    _useState4 = _slicedToArray(_useState3, 2),
+    reduced = _useState4[0],
+    setReduced = _useState4[1];
+  useEffect(function () {
+    var _query$addEventListen;
+    if (typeof window === "undefined" || typeof window.matchMedia !== "function") return undefined;
+    var query = window.matchMedia("(prefers-reduced-motion: reduce)");
+    var update = function update() {
+      return setReduced(query.matches);
+    };
+    (_query$addEventListen = query.addEventListener) === null || _query$addEventListen === void 0 || _query$addEventListen.call(query, "change", update);
+    return function () {
+      var _query$removeEventLis;
+      return (_query$removeEventLis = query.removeEventListener) === null || _query$removeEventLis === void 0 ? void 0 : _query$removeEventLis.call(query, "change", update);
+    };
+  }, []);
+  return reduced;
+}
+var defaultValueFormatter = function defaultValueFormatter(value) {
+  return typeof value === "number" ? value.toLocaleString() : value == null ? "" : String(value);
+};
+
+export { CHART_PALETTES, DEFAULT_CHART_COLORS, defaultValueFormatter, resolveColor, seriesColors, tokenVar, useChartTheme, useReducedMotion };