@thebuoyant-tsdev/mui-ts-library 2.3.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
@@ -11,14 +13,17 @@ Eine typsichere React-Komponentenbibliothek auf Basis von **TypeScript** und **M
 | Komponente | Beschreibung | Docs |
 |---|---|---|
 | [`ConfirmDialog`](#confirmdialog) | Deklarativer Async-Bestätigungs-Dialog — `await confirm({ title, severity })` von überall in der App. Unterstützt Countdown-Auto-Confirm und `Enter` = Bestätigen. | [Vollständiges Manual →](user-manuals/ConfirmDialog.de.md) |
-| [`GanttChart`](#ganttchart) | Projekt-Timeline mit hierarchischen Aufgaben, Meilensteinen, Drag & Drop, Ctrl+Scroll-Zoom, Heute-Chip und integrierten CRUD-Dialogen | [Vollständiges Manual →](user-manuals/GanttChart.de.md) |
+| [`GanttChart`](#ganttchart) | Projekt-Timeline mit hierarchischen Aufgaben, Meilensteinen, Drag & Drop, Ctrl / Cmd ⌘+Scroll-Zoom, Heute-Chip und integrierten CRUD-Dialogen | [Vollständiges Manual →](user-manuals/GanttChart.de.md) |
 | [`TagSelection`](#tagselection) | Multi-Tag-Auswahlfeld mit Autocomplete, freier Tag-Erstellung, Overflow-Chips und MUI-Theme-Farben | [Vollständiges Manual →](user-manuals/TagSelection.de.md) |
 | [`PasswordStrengthMeter`](#passwordstrengthmeter) | Passwort-Eingabe mit animiertem Stärke-Meter, segmentierter Balkenanzeige, eigenen Anforderungen und Anforderungsliste | [Vollständiges Manual →](user-manuals/PasswordStrengthMeter.de.md) |
 | [`RichTextEditor`](#richtexteditor) | WYSIWYG-Editor (TipTap v3) mit Toolbar, Link-Dialog, Textfarbe, Hervorhebung, Wörter-Zähler, Vollbild-Modus, Markdown-Einfügen, Tabellen-Bearbeitung, Bild-Embed und Emoji-Picker | [Vollständiges Manual →](user-manuals/RichTextEditor.de.md) |
 | [`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+Click-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) |
+| [`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, 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) |
 
 ---
 
@@ -76,7 +81,7 @@ if (ok) handleDelete();
 
 ### GanttChart
 
-Interaktive Projekt-Timeline für Planung und Aufgaben-Tracking. Einsetzbar in Projektmanagement-Dashboards, Sprint-Planern und Ressourcenansichten — mit Drag & Drop, Größenänderung, Ctrl+Scroll-Zoom, Meilensteinen, Abhängigkeiten und Heute-Chip.
+Interaktive Projekt-Timeline für Planung und Aufgaben-Tracking. Einsetzbar in Projektmanagement-Dashboards, Sprint-Planern und Ressourcenansichten — mit Drag & Drop, Größenänderung, Ctrl / Cmd ⌘+Scroll-Zoom, Meilensteinen, Abhängigkeiten und Heute-Chip.
 
 ```tsx
 import { GanttChart } from '@thebuoyant-tsdev/mui-ts-library';
@@ -213,7 +218,7 @@ const data: SunburstChartData = {
 />
 ```
 
-**Zoom:** `Ctrl+Click` → Drill-down · `Ctrl+Doppelklick` → Zoom out · `Escape` → Reset
+**Zoom:** `Ctrl+Click` → Drill-down · `Ctrl / Cmd ⌘+Doppelklick` → Zoom out · `Escape` → Reset
 
 → [Vollständige Dokumentation](user-manuals/SunburstChart.de.md)
 
@@ -245,6 +250,40 @@ const data: ChordChartData[] = [
 
 ---
 
+### RadialTreeChart
+
+Hierarchische Daten als radialer Baum — Knoten auf konzentrischen Ringen, verbunden durch geschwungene Links. Ideal für Org-Charts, Skill-Taxonomien und Abhängigkeitsbäume. `Ctrl / Cmd ⌘+Click` bohrt in Teilbäume, `Ctrl / Cmd ⌘+Scroll` zoomt.
+
+```tsx
+import { RadialTreeChart } from '@thebuoyant-tsdev/mui-ts-library';
+import type { RadialTreeChartData } from '@thebuoyant-tsdev/mui-ts-library';
+
+const data: RadialTreeChartData = {
+  id: 'ceo', name: 'CEO', subname: 'Führung',
+  children: [
+    { id: 'cto', name: 'CTO', subname: 'Technologie',
+      children: [
+        { id: 'fe', name: 'Frontend Lead' },
+        { id: 'be', name: 'Backend Lead'  },
+      ]},
+    { id: 'cpo', name: 'CPO', subname: 'Produkt' },
+  ],
+};
+
+<RadialTreeChart
+  data={data}
+  size={600}
+  drillable    // Ctrl / Cmd ⌘+Click zum Drill-in, DblClick zurück
+  zoomable     // Ctrl / Cmd ⌘+Scroll zum Zoomen
+  showNodePopover
+  onNodeClick={(info) => console.log(info.name, info.depth)}
+/>
+```
+
+→ [Vollständige Dokumentation](user-manuals/RadialTreeChart.de.md)
+
+---
+
 ## TypeScript
 
 Alle Typen und Defaults werden direkt exportiert — kein separates `@types/...`-Paket nötig.
@@ -277,6 +316,15 @@ import type {
 
   // ChordChart
   ChordChartData, ChordGroupInfo, ChordInfo, ChordSortBy,
+
+  // 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
@@ -11,14 +13,17 @@ A type-safe React component library built on **TypeScript** and **MUI (Material
 | Component | Description | Docs |
 |---|---|---|
 | [`ConfirmDialog`](#confirmdialog) | Declarative async confirmation dialog — `await confirm({ title, severity })` from anywhere in the app. Supports countdown auto-confirm and `Enter` = confirm shortcut. | [Full Manual →](user-manuals/ConfirmDialog.md) |
-| [`GanttChart`](#ganttchart) | Project timeline with hierarchical tasks, milestones, drag & drop, Ctrl+Scroll zoom, today chip, and built-in CRUD dialogs | [Full Manual →](user-manuals/GanttChart.md) |
+| [`GanttChart`](#ganttchart) | Project timeline with hierarchical tasks, milestones, drag & drop, Ctrl / Cmd ⌘+Scroll zoom, today chip, and built-in CRUD dialogs | [Full Manual →](user-manuals/GanttChart.md) |
 | [`TagSelection`](#tagselection) | Multi-tag selector with autocomplete, free tag creation, overflow chips, and MUI theme colors | [Full Manual →](user-manuals/TagSelection.md) |
 | [`PasswordStrengthMeter`](#passwordstrengthmeter) | Password input with animated strength meter, segmented bar, custom requirements, and requirements checklist | [Full Manual →](user-manuals/PasswordStrengthMeter.md) |
 | [`RichTextEditor`](#richtexteditor) | WYSIWYG editor (TipTap v3) with toolbar, link dialog, text color, highlight, word count, fullscreen mode, Markdown paste, table editing, image embed, and emoji picker | [Full Manual →](user-manuals/RichTextEditor.md) |
 | [`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+Click zoom, donut mode, custom colors, MUI theme integration. First of the D3 Charts family. | [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) |
+| [`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, 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) |
 
 ---
 
@@ -76,7 +81,7 @@ if (ok) handleDelete();
 
 ### GanttChart
 
-An interactive project timeline for planning and tracking tasks. Use it in project management dashboards, sprint planners, or resource views where teams need to see schedules, milestones, dependencies, and progress at a glance — with drag & drop, resize, and Ctrl+Scroll zoom built in.
+An interactive project timeline for planning and tracking tasks. Use it in project management dashboards, sprint planners, or resource views where teams need to see schedules, milestones, dependencies, and progress at a glance — with drag & drop, resize, and Ctrl / Cmd ⌘+Scroll zoom built in.
 
 ```tsx
 import { GanttChart } from '@thebuoyant-tsdev/mui-ts-library';
@@ -189,7 +194,7 @@ import { JsonEditor } from '@thebuoyant-tsdev/mui-ts-library';
 
 ### SunburstChart
 
-Hierarchical data visualization as concentric rings — root at the center, each depth level forms one ring. Perfect for budget breakdowns, org charts, file system usage, and any data that is both hierarchical and proportional. Ctrl+Click to drill down into any segment.
+Hierarchical data visualization as concentric rings — root at the center, each depth level forms one ring. Perfect for budget breakdowns, org charts, file system usage, and any data that is both hierarchical and proportional. `Ctrl / Cmd ⌘+Click` to drill down, `Ctrl / Cmd ⌘+Scroll` to zoom.
 
 ```tsx
 import { SunburstChart } from '@thebuoyant-tsdev/mui-ts-library';
@@ -213,7 +218,7 @@ const data: SunburstChartData = {
 />
 ```
 
-**Zoom:** `Ctrl+Click` → drill down · `Ctrl+Double-click` → zoom out · `Escape` → reset
+**Drill-down:** `Ctrl+Click` / `Cmd ⌘+Click` · **Zoom out:** `Ctrl+DblClick` / `Cmd ⌘+DblClick` · **Reset:** `Escape`
 
 → [Full documentation](user-manuals/SunburstChart.md)
 
@@ -245,6 +250,40 @@ const data: ChordChartData[] = [
 
 ---
 
+### RadialTreeChart
+
+Hierarchical data as a radial tree — nodes on concentric rings connected by curved links. Use `RadialTreeChart` for org charts, skill taxonomies, dependency trees, or any hierarchy where you want both structure and spatial layout. Hover for a tooltip, click for a popover with node details. `Ctrl / Cmd ⌘+Click` drills into subtrees, `Ctrl / Cmd ⌘+Scroll` zooms.
+
+```tsx
+import { RadialTreeChart } from '@thebuoyant-tsdev/mui-ts-library';
+import type { RadialTreeChartData } from '@thebuoyant-tsdev/mui-ts-library';
+
+const data: RadialTreeChartData = {
+  id: 'ceo', name: 'CEO', subname: 'Leadership',
+  children: [
+    { id: 'cto', name: 'CTO', subname: 'Technology',
+      children: [
+        { id: 'fe', name: 'Frontend Lead' },
+        { id: 'be', name: 'Backend Lead'  },
+      ]},
+    { id: 'cpo', name: 'CPO', subname: 'Product' },
+  ],
+};
+
+<RadialTreeChart
+  data={data}
+  size={600}
+  drillable    // Ctrl / Cmd ⌘+Click to drill in, DblClick to go back
+  zoomable     // Ctrl / Cmd ⌘+Scroll to zoom
+  showNodePopover
+  onNodeClick={(info) => console.log(info.name, info.depth)}
+/>
+```
+
+→ [Full documentation](user-manuals/RadialTreeChart.md)
+
+---
+
 ## TypeScript
 
 All types and defaults are exported directly — no separate `@types/...` package needed.
@@ -277,6 +316,15 @@ import type {
 
   // ChordChart
   ChordChartData, ChordGroupInfo, ChordInfo, ChordSortBy,
+
+  // 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.d.ts

@@ -0,0 +1,5 @@
+import { type RadialTreeChartProps } from "./RadialTreeChart.types";
+export declare function RadialTreeChart({ data, size, autoFit, sortBy, showLabels, showIcons, chartColors, rootNodeRadius, branchNodeRadius, leafNodeRadius, linkColor, linkStrokeOpacity, linkStrokeWidth, labelFontSize, labelColor, separationSibling, separationCousin, zoomable, drillable, onFocusChange, showNodePopover, renderNodePopoverContent, onNodeClick, disabled, translation, }: RadialTreeChartProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace RadialTreeChart {
+    var displayName: string;
+}

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

@@ -0,0 +1,94 @@
+export type RadialTreeSortBy = 'name' | 'value';
+export type RadialTreeChartData = {
+    id: string;
+    name: string;
+    /** Subtitle shown below the name in the built-in node popover */
+    subname?: string;
+    value?: number;
+    /** Custom field A — shown in the built-in node popover */
+    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 */
+export type RadialTreeNodeInfo = {
+    id: string;
+    name: string;
+    subname: string | null;
+    value: number | null;
+    specialValueA: string | number | null;
+    specialValueB: string | number | null;
+    depth: number;
+    /** Breadcrumb from root to this node */
+    path: string[];
+    childrenCount: number;
+    data: RadialTreeChartData;
+};
+export type RadialTreeChartTranslation = {
+    /** Shown when data is empty */
+    noData: string;
+    /** Label for specialValueA in the built-in node popover */
+    specialValueA?: string;
+    /** Label for specialValueB in the built-in node popover */
+    specialValueB?: string;
+};
+export declare const DEFAULT_RADIAL_TREE_CHART_TRANSLATION: RadialTreeChartTranslation;
+export type RadialTreeChartProps = {
+    /** Root node of the hierarchy */
+    data: RadialTreeChartData;
+    /** Width and height of the SVG in pixels (default: 600) */
+    size?: number;
+    /** Auto-fit viewBox to the rendered content (default: true) */
+    autoFit?: boolean;
+    /** Sort child nodes alphabetically ('name') or by value ('value') — default: 'name' */
+    sortBy?: RadialTreeSortBy;
+    /** Show node name labels (default: true) */
+    showLabels?: boolean;
+    /** Per-depth node colors — falls back to MUI theme palette when omitted */
+    chartColors?: string[];
+    /** Root node circle radius in px (default: 22) */
+    rootNodeRadius?: number;
+    /** Branch node circle radius in px (default: 16) */
+    branchNodeRadius?: number;
+    /** Leaf node circle radius in px (default: 11) */
+    leafNodeRadius?: number;
+    /** Link line color — defaults to `theme.palette.text.secondary` */
+    linkColor?: string;
+    /** Link line opacity — 0 to 1 (default: 1) */
+    linkStrokeOpacity?: number;
+    /** Link line width in px (default: 1.5) */
+    linkStrokeWidth?: number;
+    /** Label font size in px (default: 12) */
+    labelFontSize?: number;
+    /** Label text color — defaults to `theme.palette.text.primary` */
+    labelColor?: string;
+    /** Separation factor between sibling nodes (default: 1) */
+    separationSibling?: number;
+    /** Separation factor between cousin nodes (default: 2) */
+    separationCousin?: number;
+    /** Show white icons (folder/person) inside the node circles (default: true) */
+    showIcons?: boolean;
+    /** Show a built-in MUI Popover with node details on click (default: false) */
+    showNodePopover?: boolean;
+    /** Render custom content inside the built-in node popover */
+    renderNodePopoverContent?: (info: RadialTreeNodeInfo) => React.ReactNode;
+    /** Fired on every node click */
+    onNodeClick?: (info: RadialTreeNodeInfo, event: React.MouseEvent<SVGGElement>) => void;
+    /** Enable Ctrl+Scroll zoom — Ctrl+Wheel zooms in/out, Escape resets (default: false) */
+    zoomable?: boolean;
+    /** Enable Ctrl+Click drill-down into subtrees, Ctrl+DblClick zoom out (default: false) */
+    drillable?: boolean;
+    /** Fired when drill-down focus changes — null when reset to root */
+    onFocusChange?: (focusedNode: RadialTreeNodeInfo | null) => void;
+    /** Disables all interactions (default: false) */
+    disabled?: boolean;
+    /** Override translation strings */
+    translation?: Partial<RadialTreeChartTranslation>;
+};

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

@@ -1,5 +1,5 @@
 import { type SunburstChartProps } from "./SunburstChart.types";
-export declare function SunburstChart({ data, size, showSegmentLabels, innerRadius, sortBy, chartColors, showRootLabel, onSegmentClick, onZoomChange, valueDecimalCount, valueDecimalSeparator, valueThousandsSeparator, disabled, }: SunburstChartProps): import("react/jsx-runtime").JSX.Element;
+export declare function SunburstChart({ data, size, showSegmentLabels, innerRadius, sortBy, chartColors, showRootLabel, onSegmentClick, onZoomChange, valueDecimalCount, valueDecimalSeparator, valueThousandsSeparator, zoomable, disabled, }: SunburstChartProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace SunburstChart {
     var displayName: string;
 }

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 = {
@@ -58,6 +64,8 @@ export type SunburstChartProps = {
     valueDecimalSeparator?: string;
     /** Thousands separator for values (default: ',') */
     valueThousandsSeparator?: string;
+    /** Enable Ctrl+Scroll zoom — content outside `size` is clipped (default: false) */
+    zoomable?: boolean;
     /** Disables all interactions (default: false) */
     disabled?: boolean;
     /** Override any translation string */