@multiplatform.one/table 6.0.0

package/dist/esm/components/DataTableGrouping/index.mjs

@@ -0,0 +1,697 @@
+import { ChartBarIcon, CalculatorIcon, CaretDownIcon, CaretRightIcon, CaretUpIcon, HashIcon, MinusIcon, PlusIcon, GearIcon } from "@phosphor-icons/react";
+import { useResolvedKnobs } from "@multiplatform.one/theme";
+import { useCallback, useMemo, useState } from "react";
+import { Button, Select } from "@multiplatform.one/forms";
+import { Popover, Separator, Text, View, XStack, YStack } from "tamagui";
+import { useDataTableState } from "../DataTable/DataTableStateContext.mjs";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { createElement } from "react";
+function DataTableGrouping(props) {
+  const ctx = useDataTableState();
+  const data = props.data ?? ctx?.computed.filteredData ?? [];
+  const columns = props.columns ?? (ctx ? ctx.table.getAllColumns().map(col => ({
+    id: col.id,
+    accessorKey: col.id,
+    header: typeof col.columnDef.header === "string" ? col.columnDef.header : col.id
+  })) : []);
+  const {
+    groupBy = [],
+    aggregations = [],
+    renderGroupHeader,
+    renderGroupFooter,
+    showAggregations = true,
+    expandedGroups = /* @__PURE__ */new Set(),
+    onExpandedGroupsChange,
+    maxDepth = 5
+  } = props;
+  const groupedData = useMemo(() => {
+    if (!groupBy.length) return null;
+    return groupData(data, groupBy, aggregations, maxDepth);
+  }, [data, groupBy, aggregations, maxDepth]);
+  const toggleGroupExpansion = useCallback(groupKey => {
+    const newExpanded = new Set(expandedGroups);
+    if (newExpanded.has(groupKey)) {
+      newExpanded.delete(groupKey);
+    } else {
+      newExpanded.add(groupKey);
+    }
+    onExpandedGroupsChange?.(newExpanded);
+  }, [expandedGroups, onExpandedGroupsChange]);
+  if (!groupedData) return null;
+  return /* @__PURE__ */jsx(GroupedDataRenderer, {
+    groupedData,
+    columns,
+    level: 0,
+    aggregations,
+    showAggregations,
+    expandedGroups,
+    onToggleExpansion: toggleGroupExpansion,
+    renderGroupHeader,
+    renderGroupFooter
+  });
+}
+function GroupedDataRenderer({
+  groupedData,
+  columns,
+  level,
+  aggregations,
+  showAggregations,
+  expandedGroups,
+  onToggleExpansion,
+  renderGroupHeader,
+  renderGroupFooter
+}) {
+  return /* @__PURE__ */jsx(YStack, {
+    children: groupedData.map(group => {
+      const groupKey = getGroupKey(group);
+      const isExpanded = expandedGroups.has(groupKey);
+      const hasChildren = group.children && group.children.length > 0;
+      return /* @__PURE__ */jsxs(YStack, {
+        children: [/* @__PURE__ */jsx(GroupHeader, {
+          group,
+          level,
+          isExpanded,
+          hasChildren: !!hasChildren,
+          aggregations,
+          showAggregations: showAggregations ?? true,
+          onToggleExpansion: () => onToggleExpansion(groupKey),
+          renderCustomHeader: renderGroupHeader
+        }), isExpanded && /* @__PURE__ */jsx(YStack, {
+          marginLeft: level * 20,
+          children: group.children && group.children.length > 0 ? /* @__PURE__ */jsx(GroupedDataRenderer, {
+            groupedData: group.children,
+            columns,
+            level: level + 1,
+            aggregations,
+            showAggregations,
+            expandedGroups,
+            onToggleExpansion,
+            renderGroupHeader,
+            renderGroupFooter
+          }) : /* @__PURE__ */jsx(GroupItems, {
+            items: group.items,
+            columns
+          })
+        }), renderGroupFooter && isExpanded && /* @__PURE__ */jsx(GroupFooter, {
+          group,
+          level,
+          renderCustomFooter: renderGroupFooter
+        })]
+      }, groupKey);
+    })
+  });
+}
+function GroupHeader({
+  group,
+  level,
+  isExpanded,
+  hasChildren,
+  aggregations,
+  showAggregations,
+  onToggleExpansion,
+  renderCustomHeader
+}) {
+  const {
+    knobProps
+  } = useResolvedKnobs();
+  if (renderCustomHeader) {
+    return /* @__PURE__ */jsx(View, {
+      children: renderCustomHeader(group, level)
+    });
+  }
+  return /* @__PURE__ */jsxs(XStack, {
+    ...knobProps.borderRadius,
+    alignItems: "center",
+    padding: "$3",
+    ...{
+      backgroundColor: "$color2"
+    },
+    borderLeftWidth: 4,
+    borderLeftColor: "$color6",
+    cursor: "pointer",
+    hoverStyle: {
+      backgroundColor: level === 0 ? "$accentBackground" : {
+        backgroundColor: "$color2"
+      }.backgroundColor
+    },
+    onPress: onToggleExpansion,
+    children: [/* @__PURE__ */jsx(View, {
+      width: 20,
+      alignItems: "center",
+      children: hasChildren && (isExpanded ? /* @__PURE__ */jsx(CaretDownIcon, {
+        size: 16
+      }) : /* @__PURE__ */jsx(CaretRightIcon, {
+        size: 16
+      }))
+    }), /* @__PURE__ */jsxs(YStack, {
+      flex: 1,
+      children: [/* @__PURE__ */jsxs(XStack, {
+        alignItems: "center",
+        gap: "$2",
+        children: [/* @__PURE__ */jsx(Text, {
+          fontSize: "$4",
+          fontWeight: "600",
+          children: group.value || "No Value"
+        }), /* @__PURE__ */jsxs(Text, {
+          fontSize: "$3",
+          color: "$color10",
+          children: ["(", group.count, " item", group.count !== 1 ? "s" : "", ")"]
+        })]
+      }), showAggregations && aggregations.length > 0 && /* @__PURE__ */jsx(XStack, {
+        gap: "$4",
+        marginTop: "$2",
+        children: aggregations.map((agg, index) => /* @__PURE__ */jsxs(XStack, {
+          alignItems: "center",
+          gap: "$1",
+          children: [/* @__PURE__ */jsxs(Text, {
+            fontSize: "$3",
+            color: "$color10",
+            children: [agg.label || `${agg.function}(${agg.column})`, ":"]
+          }), /* @__PURE__ */jsx(Text, {
+            fontSize: "$3",
+            fontWeight: "500",
+            children: group.aggregations[agg.column]?.[agg.function] || 0
+          })]
+        }, index))
+      })]
+    })]
+  });
+}
+function GroupItems({
+  items,
+  columns = []
+}) {
+  const {
+    knobProps
+  } = useResolvedKnobs();
+  return /* @__PURE__ */jsx(YStack, {
+    children: items.map((item, index) => /* @__PURE__ */createElement(XStack, {
+      ...knobProps.borderRadius,
+      key: index,
+      padding: "$2",
+      paddingLeft: "$4",
+      backgroundColor: index % 2 === 0 ? "$background" : "$color2",
+      borderBottomWidth: 1,
+      borderBottomColor: "$borderColor"
+    }, columns.length > 0 ? columns.map((column, colIndex) => {
+      const key = column.accessorKey || column.id || `col-${colIndex}`;
+      const value = item[key];
+      return /* @__PURE__ */jsx(View, {
+        flex: 1,
+        children: /* @__PURE__ */jsx(Text, {
+          fontSize: "$3",
+          children: String(value ?? "")
+        })
+      }, key);
+    }) : /* @__PURE__ */jsx(Text, {
+      fontSize: "$3",
+      children: JSON.stringify(item, null, 2)
+    })))
+  });
+}
+function GroupFooter({
+  group,
+  level,
+  renderCustomFooter
+}) {
+  return /* @__PURE__ */jsx(View, {
+    marginLeft: level * 20,
+    children: renderCustomFooter(group, level)
+  });
+}
+function DataTableGroupingConfig(props) {
+  const ctx = useDataTableState();
+  const columns = props.columns ?? (ctx ? ctx.table.getAllColumns().map(col => ({
+    id: col.id,
+    accessorKey: col.id,
+    header: typeof col.columnDef.header === "string" ? col.columnDef.header : col.id
+  })) : []);
+  const {
+    currentConfig,
+    onConfigChange,
+    disabled = false
+  } = props;
+  const {
+    knobProps
+  } = useResolvedKnobs();
+  const sz = knobProps.sizeToken;
+  const popoverMinWidth = sz === "$3" ? 320 : sz === "$5" ? 480 : 400;
+  const popoverMaxWidth = sz === "$3" ? 400 : sz === "$5" ? 560 : 500;
+  const [isOpen, setIsOpen] = useState(false);
+  const availableColumns = columns.filter(col => {
+    const key = col.accessorKey || col.id || "";
+    return key && !currentConfig.columns.includes(key);
+  });
+  const aggregatableColumns = columns.filter(col => {
+    const type = "type" in col && col.type != null ? col.type : "string";
+    return ["number", "date"].includes(type);
+  });
+  const handleAddGroupBy = columnKey => {
+    const newConfig = {
+      ...currentConfig,
+      columns: [...currentConfig.columns, columnKey]
+    };
+    onConfigChange(newConfig);
+  };
+  const handleRemoveGroupBy = columnKey => {
+    const newConfig = {
+      ...currentConfig,
+      columns: currentConfig.columns.filter(col => col !== columnKey)
+    };
+    onConfigChange(newConfig);
+  };
+  const handleAddAggregation = aggregation => {
+    const newConfig = {
+      ...currentConfig,
+      aggregations: [...currentConfig.aggregations, aggregation]
+    };
+    onConfigChange(newConfig);
+  };
+  const handleRemoveAggregation = index => {
+    const newConfig = {
+      ...currentConfig,
+      aggregations: currentConfig.aggregations.filter((_, i) => i !== index)
+    };
+    onConfigChange(newConfig);
+  };
+  return /* @__PURE__ */jsxs(Popover, {
+    open: isOpen,
+    onOpenChange: setIsOpen,
+    children: [/* @__PURE__ */jsx(Popover.Trigger, {
+      asChild: true,
+      children: /* @__PURE__ */jsx(Button, {
+        size: knobProps.sizeToken,
+        variant: "outlined",
+        icon: /* @__PURE__ */jsx(GearIcon, {
+          size: 16
+        }),
+        disabled,
+        "aria-label": "Grouping configuration",
+        children: /* @__PURE__ */jsxs(XStack, {
+          alignItems: "center",
+          gap: "$2",
+          children: [/* @__PURE__ */jsx(ChartBarIcon, {
+            size: 16
+          }), /* @__PURE__ */jsx(Text, {
+            children: "Group & Aggregate"
+          }), (currentConfig.columns.length > 0 || currentConfig.aggregations.length > 0) && /* @__PURE__ */jsx(View, {
+            backgroundColor: "$color6",
+            borderRadius: knobProps.borderRadius.borderRadius,
+            paddingHorizontal: "$1",
+            paddingVertical: 2,
+            minWidth: 20,
+            alignItems: "center",
+            children: /* @__PURE__ */jsx(Text, {
+              fontSize: "$2",
+              color: "white",
+              fontWeight: "600",
+              children: currentConfig.columns.length + currentConfig.aggregations.length
+            })
+          })]
+        })
+      })
+    }), /* @__PURE__ */jsx(Popover.Content, {
+      ...knobProps.borderRadius,
+      borderWidth: 1,
+      borderColor: "$borderColor",
+      enterStyle: {
+        x: 0,
+        y: -10,
+        opacity: 0
+      },
+      exitStyle: {
+        x: 0,
+        y: -10,
+        opacity: 0
+      },
+      minWidth: popoverMinWidth,
+      maxWidth: popoverMaxWidth,
+      children: /* @__PURE__ */jsxs(YStack, {
+        ...knobProps.panelPadding,
+        gap: "$4",
+        children: [/* @__PURE__ */jsx(Text, {
+          fontSize: "$5",
+          fontWeight: "600",
+          children: "Grouping & Aggregation"
+        }), /* @__PURE__ */jsxs(YStack, {
+          gap: "$3",
+          children: [/* @__PURE__ */jsxs(XStack, {
+            justifyContent: "space-between",
+            alignItems: "center",
+            children: [/* @__PURE__ */jsx(Text, {
+              fontSize: "$4",
+              fontWeight: "500",
+              children: "Group By"
+            }), /* @__PURE__ */jsxs(Text, {
+              fontSize: "$2",
+              color: "$color10",
+              children: [currentConfig.columns.length, " selected"]
+            })]
+          }), /* @__PURE__ */jsx(YStack, {
+            gap: "$1",
+            children: currentConfig.columns.map((columnKey, index) => {
+              const column = columns.find(col => (col.accessorKey || col.id) === columnKey);
+              return /* @__PURE__ */jsxs(XStack, {
+                alignItems: "center",
+                gap: "$2",
+                padding: "$2",
+                ...{
+                  backgroundColor: "$color2"
+                },
+                borderRadius: knobProps.borderRadius.borderRadius,
+                children: [/* @__PURE__ */jsxs(Text, {
+                  fontSize: "$3",
+                  flex: 1,
+                  children: [column?.header || columnKey, " (", index + 1, ")"]
+                }), /* @__PURE__ */jsx(Button, {
+                  size: knobProps.sizeToken,
+                  variant: "outlined",
+                  icon: /* @__PURE__ */jsx(MinusIcon, {
+                    size: 16
+                  }),
+                  onPress: () => handleRemoveGroupBy(columnKey),
+                  "aria-label": `Remove grouping by ${column?.header || columnKey}`
+                })]
+              }, columnKey);
+            })
+          }), availableColumns.length > 0 && /* @__PURE__ */jsxs(XStack, {
+            gap: "$2",
+            children: [/* @__PURE__ */jsx(Text, {
+              fontSize: "$3",
+              color: "$color10",
+              children: "Add:"
+            }), availableColumns.slice(0, 3).map(column => {
+              const key = column.accessorKey || column.id || "";
+              return /* @__PURE__ */jsx(Button, {
+                size: "$2",
+                variant: "outlined",
+                onPress: () => handleAddGroupBy(key),
+                children: column.header || key
+              }, key);
+            })]
+          })]
+        }), /* @__PURE__ */jsx(Separator, {}), /* @__PURE__ */jsxs(YStack, {
+          gap: "$3",
+          children: [/* @__PURE__ */jsxs(XStack, {
+            justifyContent: "space-between",
+            alignItems: "center",
+            children: [/* @__PURE__ */jsx(Text, {
+              fontSize: "$4",
+              fontWeight: "500",
+              children: "Aggregations"
+            }), /* @__PURE__ */jsxs(Text, {
+              fontSize: "$2",
+              color: "$color10",
+              children: [currentConfig.aggregations.length, " configured"]
+            })]
+          }), /* @__PURE__ */jsx(YStack, {
+            gap: "$1",
+            children: currentConfig.aggregations.map((agg, index) => /* @__PURE__ */jsxs(XStack, {
+              alignItems: "center",
+              gap: "$2",
+              padding: "$2",
+              ...{
+                backgroundColor: "$color2"
+              },
+              borderRadius: knobProps.borderRadius.borderRadius,
+              children: [/* @__PURE__ */jsxs(Text, {
+                fontSize: "$3",
+                flex: 1,
+                children: [agg.function, "(", agg.column, ")", agg.label && ` as "${agg.label}"`]
+              }), /* @__PURE__ */jsx(Button, {
+                size: knobProps.sizeToken,
+                variant: "outlined",
+                icon: /* @__PURE__ */jsx(MinusIcon, {
+                  size: 16
+                }),
+                onPress: () => handleRemoveAggregation(index),
+                "aria-label": `Remove ${agg.function} aggregation on ${agg.column}`
+              })]
+            }, index))
+          }), /* @__PURE__ */jsx(AggregationSelector, {
+            columns: aggregatableColumns,
+            onAddAggregation: handleAddAggregation
+          })]
+        }), (currentConfig.columns.length > 0 || currentConfig.aggregations.length > 0) && /* @__PURE__ */jsxs(Fragment, {
+          children: [/* @__PURE__ */jsx(Separator, {}), /* @__PURE__ */jsx(Button, {
+            size: knobProps.sizeToken,
+            variant: "outlined",
+            theme: "red",
+            onPress: () => onConfigChange({
+              columns: [],
+              aggregations: []
+            }),
+            "aria-label": "Clear all grouping and aggregation",
+            children: "Clear All Grouping"
+          })]
+        })]
+      })
+    })]
+  });
+}
+function AggregationSelector({
+  columns,
+  onAddAggregation
+}) {
+  const [selectedColumn, setSelectedColumn] = useState("");
+  const [selectedFunction, setSelectedFunction] = useState("count");
+  const aggregationFunctions = [{
+    value: "count",
+    label: "Count",
+    icon: /* @__PURE__ */jsx(HashIcon, {
+      size: 16
+    })
+  }, {
+    value: "sum",
+    label: "Sum",
+    icon: /* @__PURE__ */jsx(PlusIcon, {
+      size: 16
+    })
+  }, {
+    value: "avg",
+    label: "Average",
+    icon: /* @__PURE__ */jsx(CalculatorIcon, {
+      size: 16
+    })
+  }, {
+    value: "min",
+    label: "Minimum",
+    icon: /* @__PURE__ */jsx(MinusIcon, {
+      size: 16
+    })
+  }, {
+    value: "max",
+    label: "Maximum",
+    icon: /* @__PURE__ */jsx(CaretUpIcon, {
+      size: 16
+    })
+  }];
+  const columnOptions = useMemo(() => columns.map(column => {
+    const key = column.accessorKey || column.id || "";
+    return {
+      value: key,
+      label: typeof column.header === "string" ? column.header : key
+    };
+  }), [columns]);
+  const functionOptions = useMemo(() => aggregationFunctions.map(func => ({
+    value: func.value,
+    label: func.label
+  })), []);
+  const handleAdd = () => {
+    if (!selectedColumn) return;
+    const column = columns.find(col => (col.accessorKey || col.id) === selectedColumn);
+    const aggregation = {
+      column: selectedColumn,
+      function: selectedFunction,
+      label: `${selectedFunction} of ${column?.header || selectedColumn}`
+    };
+    onAddAggregation(aggregation);
+    setSelectedColumn("");
+    setSelectedFunction("count");
+  };
+  return /* @__PURE__ */jsxs(YStack, {
+    gap: "$2",
+    children: [/* @__PURE__ */jsx(Text, {
+      fontSize: "$3",
+      fontWeight: "500",
+      children: "Add Aggregation"
+    }), /* @__PURE__ */jsxs(XStack, {
+      gap: "$2",
+      alignItems: "flex-end",
+      children: [/* @__PURE__ */jsx(View, {
+        flex: 1,
+        children: /* @__PURE__ */jsx(Select, {
+          value: selectedColumn,
+          onValueChange: v => {
+            if (typeof v === "string") {
+              setSelectedColumn(v);
+            }
+          },
+          options: columnOptions,
+          placeholder: "Select column...",
+          compact: true,
+          "aria-label": "Aggregation column"
+        })
+      }), /* @__PURE__ */jsx(View, {
+        width: 140,
+        children: /* @__PURE__ */jsx(Select, {
+          value: selectedFunction,
+          onValueChange: v => {
+            if (typeof v === "string") {
+              setSelectedFunction(v);
+            }
+          },
+          options: functionOptions,
+          compact: true,
+          "aria-label": "Aggregation function"
+        })
+      }), /* @__PURE__ */jsx(Button, {
+        size: "$2",
+        variant: "outlined",
+        disabled: !selectedColumn,
+        onPress: handleAdd,
+        children: "Add"
+      })]
+    })]
+  });
+}
+function groupData(data, groupByColumns, aggregations, maxDepth = 5) {
+  if (!groupByColumns.length) return null;
+  const grouped = /* @__PURE__ */new Map();
+  data.forEach(item => {
+    const firstGroupValue = item[groupByColumns[0]];
+    const key = String(firstGroupValue || "null");
+    if (!grouped.has(key)) {
+      grouped.set(key, {
+        items: [],
+        key: firstGroupValue,
+        path: [firstGroupValue]
+      });
+    }
+    const groupData2 = grouped.get(key);
+    if (groupData2) {
+      groupData2.items.push(item);
+    }
+  });
+  const result = Array.from(grouped.entries()).map(([key, group]) => {
+    const aggregationsResult = {};
+    aggregations.forEach(agg => {
+      if (!aggregationsResult[agg.column]) {
+        aggregationsResult[agg.column] = {};
+      }
+      const values = group.items.map(item => item[agg.column]).filter(val => val != null);
+      switch (agg.function) {
+        case "count":
+          aggregationsResult[agg.column].count = group.items.length;
+          break;
+        case "sum":
+          {
+            aggregationsResult[agg.column].sum = values.reduce((sum, val) => sum + (Number(val) || 0), 0);
+            break;
+          }
+        case "avg":
+          {
+            const sum = values.reduce((sum2, val) => sum2 + (Number(val) || 0), 0);
+            aggregationsResult[agg.column].avg = values.length > 0 ? Math.round(sum / values.length * 100) / 100 : 0;
+            break;
+          }
+        case "min":
+          {
+            aggregationsResult[agg.column].min = values.length > 0 ? Math.min(...values.map(Number)) : 0;
+            break;
+          }
+        case "max":
+          {
+            aggregationsResult[agg.column].max = values.length > 0 ? Math.max(...values.map(Number)) : 0;
+            break;
+          }
+        case "custom":
+          aggregationsResult[agg.column].custom = agg.customFunction ? agg.customFunction(values) : null;
+          break;
+      }
+    });
+    const groupedItem = {
+      key,
+      value: group.key,
+      count: group.items.length,
+      aggregations: aggregationsResult,
+      items: group.items,
+      level: 0,
+      path: group.path
+    };
+    if (groupByColumns.length > 1 && groupedItem.level < maxDepth - 1) {
+      const childGroups = groupData(group.items, groupByColumns.slice(1), aggregations, maxDepth);
+      if (childGroups) {
+        groupedItem.children = childGroups.map(child => ({
+          ...child,
+          level: child.level + 1,
+          path: [group.key, ...child.path]
+        }));
+      }
+    }
+    return groupedItem;
+  });
+  return result;
+}
+function getGroupKey(group) {
+  return group.path.join(" \u2192 ");
+}
+function useGrouping({
+  data,
+  initialConfig = {}
+}) {
+  const [config, setConfig] = useState({
+    columns: [],
+    aggregations: [],
+    showEmptyGroups: false,
+    expandedByDefault: false,
+    maxDepth: 5,
+    ...initialConfig
+  });
+  const [expandedGroups, setExpandedGroups] = useState(/* @__PURE__ */new Set());
+  const groupedData = useMemo(() => {
+    if (!config.columns.length) return null;
+    return groupData(data, config.columns, config.aggregations, config.maxDepth);
+  }, [data, config]);
+  const toggleGroupExpansion = useCallback(groupKey => {
+    setExpandedGroups(prev => {
+      const newSet = new Set(prev);
+      if (newSet.has(groupKey)) {
+        newSet.delete(groupKey);
+      } else {
+        newSet.add(groupKey);
+      }
+      return newSet;
+    });
+  }, []);
+  const expandAll = useCallback(() => {
+    if (!groupedData) return;
+    const allKeys = /* @__PURE__ */new Set();
+    const collectKeys = groups => {
+      groups.forEach(group => {
+        allKeys.add(getGroupKey(group));
+        if (group.children) {
+          collectKeys(group.children);
+        }
+      });
+    };
+    collectKeys(groupedData);
+    setExpandedGroups(allKeys);
+  }, [groupedData]);
+  const collapseAll = useCallback(() => {
+    setExpandedGroups(/* @__PURE__ */new Set());
+  }, []);
+  return {
+    groupedData,
+    config,
+    setConfig,
+    expandedGroups,
+    setExpandedGroups,
+    toggleGroupExpansion,
+    expandAll,
+    collapseAll,
+    isGrouped: config.columns.length > 0
+  };
+}
+export { DataTableGrouping, DataTableGroupingConfig, groupData, useGrouping };
+//# sourceMappingURL=index.mjs.map