@thebuoyant-tsdev/mui-ts-library 2.4.0 → 2.6.0

package/README.de.md

@@ -4,6 +4,8 @@
 
 Eine typsichere React-Komponentenbibliothek auf Basis von **TypeScript** und **MUI (Material UI v9)**. Die Komponenten folgen MUI's Design-Sprache, unterstützen Dark Mode und Theming von Haus aus und werden mit vollständigen TypeScript-Typen, Storybook-Stories und Unit-Tests ausgeliefert.
 
+**[→ Live-Storybook](https://thebuoyant.github.io/mui-ts-library/)** — alle Komponenten interaktiv erkunden, ohne Installation.
+
 ---
 
 ## Komponenten
@@ -18,8 +20,10 @@ Eine typsichere React-Komponentenbibliothek auf Basis von **TypeScript** und **M
 | [`SqlEditor`](#sqleditor) | SQL-Code-Editor (CodeMirror 6) mit Syntax-Highlighting, Multi-Dialekt, Autocomplete, Linting und `Cmd+Enter`-Ausführen-Shortcut | [Vollständiges Manual →](user-manuals/SqlEditor.de.md) |
 | [`JsonEditor`](#jsoneditor) | JSON-Code-Editor (CodeMirror 6) mit Echtzeit-Validierung, Format- und Komprimieren-Schaltfläche sowie optionaler Minimap | [Vollständiges Manual →](user-manuals/JsonEditor.de.md) |
 | [`SunburstChart`](#sunburstchart) | D3 v7 hierarchisches Chart — konzentrische Ringe, Ctrl / Cmd ⌘+Click Drill-Down, Ctrl / Cmd ⌘+Scroll Zoom, Donut-Modus, eigene Farben, MUI-Theme-Integration. Erste der D3-Chart-Familie. | [Vollständiges Manual →](user-manuals/SunburstChart.de.md) |
-| [`ChordChart`](#chordchart) | D3 v7 Fluss-Chart — Arc-Gruppen verbunden durch Bänder, Hover-Highlight, gerichtet/ungerichtet, MUI-Theme-Integration | [Vollständiges Manual →](user-manuals/ChordChart.de.md) |
+| [`ChordChart`](#chordchart) | D3 v7 Fluss-Chart — Arc-Gruppen, Bänder, Hover-Highlight, Ctrl / Cmd ⌘+Scroll-Zoom, gerichtet/ungerichtet, MUI-Theme-Integration | [Vollständiges Manual →](user-manuals/ChordChart.de.md) |
 | [`RadialTreeChart`](#radialtreedchart) | D3 v7 radialer Baum — Knoten auf konzentrischen Ringen, MUI-Icons, Ctrl / Cmd ⌘+Click Drill-Down, Ctrl / Cmd ⌘+Scroll Zoom, MUI-Theme-Integration | [Vollständiges Manual →](user-manuals/RadialTreeChart.de.md) |
+| [`CirclePackingChart`](#circlepackingchart) | D3 v7 Circle Packing — verschachtelte Kreise, animierter D3-Zoom, Ctrl / Cmd ⌘+Scroll-Zoom, Tiefen-Gradient oder Palette, MUI-Theme-Integration | [Vollständiges Manual →](user-manuals/CirclePackingChart.de.md) |
+| [`HorizontalTreeChart`](#horizontaltreechart) | D3 v7 Baum-Chart — 4 Orientierungen (LR/RL/TB/BT), geschwungene Links, Drill-Down, Ctrl / Cmd ⌘+Scroll-Zoom, MUI-Icons und Theme-Integration | [Vollständiges Manual →](user-manuals/HorizontalTreeChart.de.md) |
 
 ---
 
@@ -315,6 +319,12 @@ import type {
 
   // RadialTreeChart
   RadialTreeChartData, RadialTreeNodeInfo, RadialTreeNodeIconSpec, RadialTreeSortBy,
+
+  // CirclePackingChart
+  CirclePackingData, CirclePackingNodeInfo, CirclePackingZoomInfo, CirclePackingSortBy,
+
+  // HorizontalTreeChart
+  HorizontalTreeData, HorizontalTreeNodeInfo, HorizontalTreeOrientation,
 } from '@thebuoyant-tsdev/mui-ts-library';
 ```
 

package/README.md

@@ -4,6 +4,8 @@
 
 A type-safe React component library built on **TypeScript** and **MUI (Material UI v9)**. Components follow MUI's design language, support dark mode and theming out of the box, and ship with complete TypeScript types, Storybook stories, and unit tests.
 
+**[→ Live Storybook](https://thebuoyant.github.io/mui-ts-library/)** — explore all components interactively, no installation needed.
+
 ---
 
 ## Components
@@ -18,8 +20,10 @@ A type-safe React component library built on **TypeScript** and **MUI (Material
 | [`SqlEditor`](#sqleditor) | SQL code editor (CodeMirror 6) with syntax highlighting, multi-dialect, autocomplete, linting, and `Cmd+Enter` execute shortcut | [Full Manual →](user-manuals/SqlEditor.md) |
 | [`JsonEditor`](#jsoneditor) | JSON code editor (CodeMirror 6) with real-time validation, Format, Compact buttons, and optional minimap | [Full Manual →](user-manuals/JsonEditor.md) |
 | [`SunburstChart`](#sunburstchart) | D3 v7 hierarchical chart — concentric rings, Ctrl / Cmd ⌘+Click drill-down, Ctrl / Cmd ⌘+Scroll zoom, donut mode, MUI theme integration | [Full Manual →](user-manuals/SunburstChart.md) |
-| [`ChordChart`](#chordchart) | D3 v7 flow chart — arc groups connected by ribbons, hover highlight, directed/undirected, MUI theme integration | [Full Manual →](user-manuals/ChordChart.md) |
+| [`ChordChart`](#chordchart) | D3 v7 flow chart — arc groups, ribbons, hover highlight, Ctrl / Cmd ⌘+Scroll zoom, directed/undirected, MUI theme integration | [Full Manual →](user-manuals/ChordChart.md) |
 | [`RadialTreeChart`](#radialtreedchart) | D3 v7 radial tree — hierarchical nodes on concentric rings, MUI icons, Ctrl / Cmd ⌘+Click drill-down, Ctrl / Cmd ⌘+Scroll zoom, MUI theme integration | [Full Manual →](user-manuals/RadialTreeChart.md) |
+| [`CirclePackingChart`](#circlepackingchart) | D3 v7 circle packing — nested circles, animated D3 zoom, Ctrl / Cmd ⌘+Scroll zoom, depth gradient or palette, MUI theme integration | [Full Manual →](user-manuals/CirclePackingChart.md) |
+| [`HorizontalTreeChart`](#horizontaltreechart) | D3 v7 tree chart — 4 orientations (LR/RL/TB/BT), curved links, drill-down, Ctrl / Cmd ⌘+Scroll zoom, MUI icons and theme integration | [Full Manual →](user-manuals/HorizontalTreeChart.md) |
 
 ---
 
@@ -315,6 +319,12 @@ import type {
 
   // RadialTreeChart
   RadialTreeChartData, RadialTreeNodeInfo, RadialTreeNodeIconSpec, RadialTreeSortBy,
+
+  // CirclePackingChart
+  CirclePackingData, CirclePackingNodeInfo, CirclePackingZoomInfo, CirclePackingSortBy,
+
+  // HorizontalTreeChart
+  HorizontalTreeData, HorizontalTreeNodeInfo, HorizontalTreeOrientation,
 } from '@thebuoyant-tsdev/mui-ts-library';
 ```
 

package/dist/components/chord-chart/ChordChart.d.ts

@@ -1,5 +1,5 @@
 import { type ChordChartProps } from "./ChordChart.types";
-export declare function ChordChart({ data, size, innerRadius, ringThickness, padAngle, ribbonPadAngle, sortSubgroups, sortChords, chartColors, showGroupLabels, labelOffset, ribbonOpacity, ribbonBlendMode, directed, valueDecimalCount, valueDecimalSeparator, valueThousandsSeparator, onGroupClick, onChordClick, disabled, }: ChordChartProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChordChart({ data, size, innerRadius, ringThickness, padAngle, ribbonPadAngle, sortSubgroups, sortChords, chartColors, groupColorConfigs, showGroupLabels, labelOffset, ribbonOpacity, ribbonBlendMode, directed, valueDecimalCount, valueDecimalSeparator, valueThousandsSeparator, onGroupClick, onChordClick, zoomable, disabled, }: ChordChartProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace ChordChart {
     var displayName: string;
 }

package/dist/components/chord-chart/ChordChart.types.d.ts

@@ -5,6 +5,17 @@ export type ChordChartData = {
     target: string;
     value: number;
 };
+/**
+ * Per-group color overrides for ChordChart.
+ * Key = group name (same as `source` / `target` in the data).
+ * Value = color config — null / omit keys = use chart default palette.
+ * Example: `{ Engineering: { fill: '#1565C0' }, Sales: { fill: '#6A1B9A' } }`
+ */
+export type ChordGroupColorConfigs = Record<string, {
+    fill?: string;
+    textColor?: string;
+    stroke?: string;
+} | null>;
 /** Callback payload for a click on a group arc */
 export type ChordGroupInfo = {
     /** Group name */
@@ -53,6 +64,8 @@ export type ChordChartProps = {
     sortChords?: ChordSortBy;
     /** Custom color palette — falls back to MUI theme palette when omitted */
     chartColors?: string[];
+    /** Per-group color overrides keyed by group name — overrides `chartColors` for specific groups */
+    groupColorConfigs?: ChordGroupColorConfigs;
     /** Show group name labels outside the arc ring (default: true) */
     showGroupLabels?: boolean;
     /** Gap between arc outer edge and label text in px (default: 6) */
@@ -73,6 +86,8 @@ export type ChordChartProps = {
     onGroupClick?: (info: ChordGroupInfo, event: React.MouseEvent<SVGGElement>) => void;
     /** Fired on click of a ribbon */
     onChordClick?: (info: ChordInfo, event: React.MouseEvent<SVGPathElement>) => void;
+    /** Enable Ctrl / Cmd ⌘ + Scroll visual zoom — clips content at `size` boundary (default: false) */
+    zoomable?: boolean;
     /** Disables all interactions (default: false) */
     disabled?: boolean;
     /** Override translation strings */

package/dist/components/circle-packing-chart/CirclePackingChart.d.ts

@@ -0,0 +1,5 @@
+import { type CirclePackingChartProps } from "./CirclePackingChart.types";
+export declare function CirclePackingChart({ data, size, padding, sortBy, showLabels, showAllLabels, labelFontSize, innerLabelFontSize, labelColor, chartColors, depthColorStart, depthColorEnd, background, duration, zoomable, disabled, onCircleClick, onZoomChange, }: CirclePackingChartProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace CirclePackingChart {
+    var displayName: string;
+}

package/dist/components/circle-packing-chart/CirclePackingChart.types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Per-node color overrides — takes priority over the chart's depth palette.
+ * Set any key to override; omit or set to null to fall back to chart defaults.
+ * Shared across all D3 charts (SunburstChart, ChordChart, RadialTreeChart, CirclePackingChart).
+ */
+export type NodeColorConfig = {
+    /** Fill / background color of the circle or arc segment */
+    fill?: string;
+    /** Label text color (overrides chart-level `labelColor`) */
+    textColor?: string;
+    /** Stroke / border color */
+    stroke?: string;
+};
+export type CirclePackingData = {
+    /** Optional ID for backend linking */
+    id?: string;
+    name: string;
+    value?: number;
+    /** Per-node color overrides — null / omit = use chart default palette */
+    colorConfig?: NodeColorConfig | null;
+    children?: CirclePackingData[];
+};
+export type CirclePackingSortBy = 'value' | 'name';
+/** Clean callback payload — no D3 types exposed */
+export type CirclePackingNodeInfo = {
+    /** Node id — same as data.id when provided */
+    id: string | null;
+    name: string;
+    /** D3 aggregate value — sum of all descendant leaf values */
+    value: number | null;
+    /** Percentage of root total — (value / root.value) * 100 */
+    percentage: number;
+    depth: number;
+    /** Breadcrumb from root to this node — array of names */
+    path: string[];
+    childrenCount: number;
+    data: CirclePackingData;
+};
+export type CirclePackingZoomInfo = {
+    previousName: string;
+    currentName: string;
+    currentDepth: number;
+    /** true when zoomed back to root */
+    isRoot: boolean;
+};
+export type CirclePackingTranslation = {
+    noData: string;
+};
+export declare const DEFAULT_CIRCLE_PACKING_TRANSLATION: CirclePackingTranslation;
+export type CirclePackingChartProps = {
+    /** Root node of the hierarchy */
+    data: CirclePackingData;
+    /** Width and height of the SVG in pixels — always square (default: 600) */
+    size?: number;
+    /** Padding between nested circles in px (default: 3) */
+    padding?: number;
+    /** Sort children by value or alphabetically (default: 'value') */
+    sortBy?: CirclePackingSortBy;
+    /** Show name labels on the outer (focused) ring circles (default: true) */
+    showLabels?: boolean;
+    /**
+     * Show labels on ALL visible inner circles too — truncated with "…" when the
+     * text doesn't fit inside the circle. Outer-ring labels stay bold; inner labels
+     * use a smaller font. (default: false)
+     */
+    showAllLabels?: boolean;
+    /** Outer-ring label font size in px (default: 13, bold) */
+    labelFontSize?: number;
+    /** Inner circle label font size in px — used when `showAllLabels` is true (default: 9) */
+    innerLabelFontSize?: number;
+    /** Label text color — defaults to `theme.palette.text.primary` */
+    labelColor?: string;
+    /**
+     * Custom depth-based color palette — overrides the default MUI theme palette.
+     * colors[depth % length] per node. Falls back to MUI palette when not set.
+     */
+    chartColors?: string[];
+    /**
+     * HCL gradient start color — when set together with `depthColorEnd`,
+     * overrides `chartColors` and the MUI palette with a smooth gradient.
+     */
+    depthColorStart?: string;
+    /**
+     * HCL gradient end color — see `depthColorStart`.
+     */
+    depthColorEnd?: string;
+    /** SVG background fill. Default: `theme.palette.background.default` */
+    background?: string;
+    /**
+     * Zoom animation duration in ms (default: 750).
+     * Alt+Ctrl / Alt+Cmd+Click uses 10× for slow-motion demos.
+     */
+    duration?: number;
+    /** Enable Ctrl / Cmd ⌘ + Scroll visual zoom — clips content at `size` boundary (default: false) */
+    zoomable?: boolean;
+    /** Disables all interactions (default: false) */
+    disabled?: boolean;
+    /** Fires on regular click — immediately, no delay */
+    onCircleClick?: (info: CirclePackingNodeInfo, event: React.MouseEvent<SVGCircleElement>) => void;
+    /** Fires when the zoom focus changes */
+    onZoomChange?: (zoom: CirclePackingZoomInfo) => void;
+    /** Override translation strings */
+    translation?: Partial<CirclePackingTranslation>;
+};

package/dist/components/horizontal-tree-chart/HorizontalTreeChart.d.ts

@@ -0,0 +1,5 @@
+import { type HorizontalTreeChartProps } from "./HorizontalTreeChart.types";
+export declare function HorizontalTreeChart({ data, orientation, width, height, levelSpacing, nodeRadius, sortBy, showLabels, labelFontSize, labelColor, showIcons, chartColors, linkStrokeOpacity, linkStrokeWidth, linkColor, zoomable, drillable, onFocusChange, showNodePopover, renderNodePopoverContent, onNodeClick, disabled, translation, }: HorizontalTreeChartProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace HorizontalTreeChart {
+    var displayName: string;
+}

package/dist/components/horizontal-tree-chart/HorizontalTreeChart.types.d.ts

@@ -0,0 +1,95 @@
+/** Tree orientation — defines the direction the tree grows */
+export type HorizontalTreeOrientation = 'LR' | 'RL' | 'TB' | 'BT';
+export type HorizontalTreeData = {
+    id?: string;
+    name: string;
+    subname?: string;
+    value?: number;
+    specialValueA?: string | number;
+    specialValueB?: string | number;
+    /** Per-node color overrides */
+    colorConfig?: {
+        fill?: string;
+        textColor?: string;
+        stroke?: string;
+    } | null;
+    children?: HorizontalTreeData[];
+};
+/** Clean callback payload — no D3 types exposed */
+export type HorizontalTreeNodeInfo = {
+    id: string | null;
+    name: string;
+    subname: string | null;
+    value: number | null;
+    specialValueA: string | number | null;
+    specialValueB: string | number | null;
+    depth: number;
+    /** Breadcrumb from root */
+    path: string[];
+    childrenCount: number;
+    data: HorizontalTreeData;
+};
+export type HorizontalTreeZoomInfo = {
+    focusedNode: HorizontalTreeNodeInfo;
+    isRoot: boolean;
+};
+export type HorizontalTreeTranslation = {
+    noData: string;
+    specialValueA?: string;
+    specialValueB?: string;
+};
+export declare const DEFAULT_HORIZONTAL_TREE_TRANSLATION: HorizontalTreeTranslation;
+export type HorizontalTreeChartProps = {
+    /** Root node of the hierarchy */
+    data: HorizontalTreeData;
+    /**
+     * Tree growth direction (default: 'LR')
+     * - 'LR' left → right
+     * - 'RL' right → left
+     * - 'TB' top → bottom
+     * - 'BT' bottom → top
+     */
+    orientation?: HorizontalTreeOrientation;
+    /** Chart width in px (default: 800) */
+    width?: number;
+    /** Chart height in px (default: 500) */
+    height?: number;
+    /** Horizontal distance between depth levels in px (default: 200) */
+    levelSpacing?: number;
+    /** Node circle radius in px (default: 10) */
+    nodeRadius?: number;
+    /** Sort children alphabetically or by value (default: 'name') */
+    sortBy?: 'name' | 'value';
+    /** Show name labels on nodes (default: true) */
+    showLabels?: boolean;
+    /** Label font size in px (default: 12) */
+    labelFontSize?: number;
+    /** Label color — defaults to theme.palette.text.primary */
+    labelColor?: string;
+    /** Show icons inside node circles (default: true) */
+    showIcons?: boolean;
+    /** Per-depth color palette — falls back to MUI theme palette */
+    chartColors?: string[];
+    /** Link stroke opacity (default: 0.4) */
+    linkStrokeOpacity?: number;
+    /** Link stroke width in px (default: 1.5) */
+    linkStrokeWidth?: number;
+    /** Link color — defaults to theme.palette.text.secondary */
+    linkColor?: string;
+    /** Enable Ctrl / Cmd ⌘ + Scroll visual zoom (default: false) */
+    zoomable?: boolean;
+    /** Enable Ctrl / Cmd ⌘ + Click drill-down into subtrees (default: false) */
+    drillable?: boolean;
+    /** Fires when drill-down focus changes */
+    onFocusChange?: (info: HorizontalTreeZoomInfo) => void;
+    /** Show built-in MUI Popover on node click (default: false) */
+    showNodePopover?: boolean;
+    /** Custom popover content */
+    renderNodePopoverContent?: (info: HorizontalTreeNodeInfo) => React.ReactNode;
+    /** Fires on every node click */
+    onNodeClick?: (info: HorizontalTreeNodeInfo, event: React.MouseEvent<SVGGElement>) => void;
+    /** Disables all interactions (default: false) */
+    disabled?: boolean;
+    /** Override translation strings */
+    translation?: Partial<HorizontalTreeTranslation>;
+};

package/dist/components/radial-tree-chart/RadialTreeChart.types.d.ts

@@ -9,6 +9,12 @@ export type RadialTreeChartData = {
     specialValueA?: string | number;
     /** Custom field B — shown in the built-in node popover */
     specialValueB?: string | number;
+    /** Per-node color overrides — null / omit = use chart default palette */
+    colorConfig?: {
+        fill?: string;
+        textColor?: string;
+        stroke?: string;
+    } | null;
     children?: RadialTreeChartData[];
 };
 /** Clean payload passed to `onNodeClick` — no D3 or Fluent UI types exposed */

package/dist/components/sunburst-chart/SunburstChart.types.d.ts

@@ -3,6 +3,12 @@ export type SunburstChartData = {
     id: string;
     name: string;
     value?: number;
+    /** Per-node color overrides — null / omit = use chart default palette */
+    colorConfig?: {
+        fill?: string;
+        textColor?: string;
+        stroke?: string;
+    } | null;
     children?: SunburstChartData[];
 };
 export type SunburstSegmentInfo = {