semiotic 2.0.2 → 3.0.0-beta.1

package/ai/dist/src/components/charts/xy/AreaChart.js

@@ -0,0 +1,220 @@
+"use client";
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AreaChart = AreaChart;
+const React = __importStar(require("react"));
+const react_1 = require("react");
+const d3_shape_1 = require("d3-shape");
+const XYFrame_1 = __importDefault(require("../../XYFrame"));
+const colorUtils_1 = require("../shared/colorUtils");
+const hooks_1 = require("../shared/hooks");
+const legendUtils_1 = require("../shared/legendUtils");
+const Tooltip_1 = require("../../Tooltip/Tooltip");
+const ChartError_1 = __importDefault(require("../shared/ChartError"));
+const validateChartData_1 = require("../shared/validateChartData");
+/** Map of curve name strings to d3-shape curve functions */
+const CURVE_MAP = {
+    linear: d3_shape_1.curveLinear,
+    monotoneX: d3_shape_1.curveMonotoneX,
+    monotoneY: d3_shape_1.curveMonotoneY,
+    step: d3_shape_1.curveStep,
+    stepAfter: d3_shape_1.curveStepAfter,
+    stepBefore: d3_shape_1.curveStepBefore,
+    basis: d3_shape_1.curveBasis,
+    cardinal: d3_shape_1.curveCardinal,
+    catmullRom: d3_shape_1.curveCatmullRom
+};
+/**
+ * AreaChart - Visualize quantities over continuous intervals with overlapping filled areas
+ *
+ * Each series fills from its line down to the baseline. Multiple series overlap
+ * with transparency so all shapes remain visible.
+ *
+ * For stacked areas use {@link StackedAreaChart}.
+ *
+ * @example
+ * ```tsx
+ * <AreaChart
+ *   data={[
+ *     {x: 1, y: 10, category: 'A'},
+ *     {x: 2, y: 20, category: 'A'},
+ *     {x: 1, y: 15, category: 'B'},
+ *     {x: 2, y: 25, category: 'B'}
+ *   ]}
+ *   areaBy="category"
+ *   colorBy="category"
+ *   xLabel="Time"
+ *   yLabel="Value"
+ * />
+ * ```
+ */
+function AreaChart(props) {
+    const { data, width = 600, height = 400, margin: userMargin, className, title, xLabel, yLabel, xFormat, yFormat, xAccessor = "x", yAccessor = "y", areaBy, lineDataAccessor = "coordinates", colorBy, colorScheme = "category10", curve = "monotoneX", areaOpacity = 0.7, showLine = true, lineWidth = 2, enableHover = true, showGrid = false, showLegend, tooltip, frameProps = {} } = props;
+    const safeData = data || [];
+    // Check if data is in area objects format (has lineDataAccessor field)
+    const isAreaObjectFormat = safeData[0]?.[lineDataAccessor] !== undefined;
+    // Transform data to line/area format if needed
+    const areaData = (0, react_1.useMemo)(() => {
+        if (isAreaObjectFormat) {
+            // Data is already in area objects format
+            return safeData;
+        }
+        if (areaBy) {
+            // Group data by areaBy field
+            const grouped = safeData.reduce((acc, d) => {
+                const key = typeof areaBy === "function" ? areaBy(d) : d[areaBy];
+                if (!acc[key]) {
+                    const areaObj = { [lineDataAccessor]: [] };
+                    // Add the grouping field
+                    if (typeof areaBy === "string") {
+                        areaObj[areaBy] = key;
+                    }
+                    acc[key] = areaObj;
+                }
+                acc[key][lineDataAccessor].push(d);
+                return acc;
+            }, {});
+            return Object.values(grouped);
+        }
+        // Single area - wrap in area object
+        return [{ [lineDataAccessor]: safeData }];
+    }, [safeData, areaBy, lineDataAccessor, isAreaObjectFormat]);
+    // Create color scale if colorBy is specified
+    const colorScale = (0, hooks_1.useColorScale)(safeData, colorBy, colorScheme);
+    // Curve function from module-level map
+    const curveFunction = CURVE_MAP[curve] || d3_shape_1.curveMonotoneX;
+    // Area/line style function
+    const lineStyle = (0, react_1.useMemo)(() => {
+        return (d) => {
+            const baseStyle = {};
+            // Apply color
+            const color = colorBy ? (0, colorUtils_1.getColor)(d, colorBy, colorScale) : hooks_1.DEFAULT_COLOR;
+            baseStyle.fill = color;
+            baseStyle.fillOpacity = areaOpacity;
+            if (showLine) {
+                baseStyle.stroke = color;
+                baseStyle.strokeWidth = lineWidth;
+            }
+            else {
+                baseStyle.stroke = "none";
+            }
+            return baseStyle;
+        };
+    }, [colorBy, colorScale, areaOpacity, showLine, lineWidth]);
+    // Build axes configuration
+    const axes = (0, react_1.useMemo)(() => {
+        const axesConfig = [];
+        // Y axis (left)
+        axesConfig.push({
+            orient: "left",
+            label: yLabel,
+            tickFormat: yFormat,
+            ...(showGrid && { tickLineGenerator: () => null })
+        });
+        // X axis (bottom)
+        axesConfig.push({
+            orient: "bottom",
+            label: xLabel,
+            tickFormat: xFormat,
+            ...(showGrid && { tickLineGenerator: () => null })
+        });
+        return axesConfig;
+    }, [xLabel, yLabel, xFormat, yFormat, showGrid]);
+    // Determine line type — always overlapping areas
+    const lineType = (0, react_1.useMemo)(() => ({
+        type: "area",
+        interpolator: curveFunction
+    }), [curveFunction]);
+    // Determine if we should show legend
+    const shouldShowLegend = showLegend !== undefined ? showLegend : areaData.length > 1;
+    // Build legend if needed
+    const legend = (0, react_1.useMemo)(() => {
+        if (!shouldShowLegend || !colorBy)
+            return undefined;
+        return (0, legendUtils_1.createLegend)({
+            data: areaData,
+            colorBy,
+            colorScale,
+            getColor: colorUtils_1.getColor
+        });
+    }, [shouldShowLegend, colorBy, areaData, colorScale]);
+    // Adjust margin for legend if present
+    const margin = (0, react_1.useMemo)(() => {
+        const defaultMargin = { top: 50, bottom: 60, left: 70, right: 40 };
+        const finalMargin = { ...defaultMargin, ...userMargin };
+        // If legend is present and right margin is too small, increase it
+        if (legend && finalMargin.right < 120) {
+            finalMargin.right = 120;
+        }
+        return finalMargin;
+    }, [userMargin, legend]);
+    // Validate data (after all hooks)
+    const error = (0, validateChartData_1.validateArrayData)({
+        componentName: "AreaChart",
+        data: safeData,
+        accessors: {
+            xAccessor,
+            yAccessor,
+        },
+    });
+    if (error)
+        return React.createElement(ChartError_1.default, { componentName: "AreaChart", message: error, width: width, height: height });
+    // Build XYFrame props
+    const xyFrameProps = {
+        size: [width, height],
+        lines: areaData,
+        xAccessor,
+        yAccessor,
+        lineDataAccessor,
+        lineType,
+        lineStyle,
+        axes: axes,
+        hoverAnnotation: enableHover,
+        margin,
+        ...(legend && { legend }),
+        ...(className && { className }),
+        ...(title && { title }),
+        // Add tooltip support
+        ...(tooltip && { tooltipContent: (0, Tooltip_1.normalizeTooltip)(tooltip) }),
+        // Allow frameProps to override defaults
+        transition: true,
+        ...frameProps
+    };
+    return React.createElement(XYFrame_1.default, { ...xyFrameProps });
+}

package/ai/dist/src/components/charts/xy/BubbleChart.js

@@ -0,0 +1,222 @@
+"use client";
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BubbleChart = BubbleChart;
+const React = __importStar(require("react"));
+const react_1 = require("react");
+const XYFrame_1 = __importDefault(require("../../XYFrame"));
+const colorUtils_1 = require("../shared/colorUtils");
+const hooks_1 = require("../shared/hooks");
+const legendUtils_1 = require("../shared/legendUtils");
+const Tooltip_1 = require("../../Tooltip/Tooltip");
+const ChartError_1 = __importDefault(require("../shared/ChartError"));
+const validateChartData_1 = require("../shared/validateChartData");
+/**
+ * BubbleChart - Visualize three dimensions of data using x, y, and size
+ *
+ * A simplified wrapper around XYFrame for creating bubble charts. Perfect for
+ * showing relationships between three continuous variables or comparing
+ * magnitudes across categories.
+ *
+ * @example
+ * ```tsx
+ * // Simple bubble chart
+ * <BubbleChart
+ *   data={[
+ *     {x: 1, y: 10, size: 50, name: 'A'},
+ *     {x: 2, y: 20, size: 30, name: 'B'},
+ *     {x: 3, y: 15, size: 70, name: 'C'}
+ *   ]}
+ *   sizeBy="size"
+ *   xLabel="Time"
+ *   yLabel="Value"
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With color encoding
+ * <BubbleChart
+ *   data={data}
+ *   sizeBy="population"
+ *   colorBy="continent"
+ *   sizeRange={[5, 50]}
+ *   bubbleOpacity={0.7}
+ *   xLabel="GDP per Capita"
+ *   yLabel="Life Expectancy"
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Advanced: Override XYFrame props
+ * <BubbleChart
+ *   data={data}
+ *   sizeBy="value"
+ *   frameProps={{
+ *     customPointMark: ({ d }) => <circle r={d.r} fill="gold" />
+ *   }}
+ * />
+ * ```
+ *
+ * @remarks
+ * This component wraps {@link XYFrame} with sensible defaults for bubble charts.
+ * For more advanced features like custom marks, annotations, or complex interactions,
+ * use XYFrame directly.
+ *
+ * **Breadcrumb to advanced usage:**
+ * - Use the `frameProps` prop to pass any XYFrame prop
+ * - See XYFrame documentation: https://semiotic.nteract.io/guides/xy-frame
+ * - All XYFrame props are available via `frameProps`
+ *
+ * @param props - BubbleChart configuration
+ * @returns Rendered bubble chart
+ */
+function BubbleChart(props) {
+    const { data, width = 600, height = 400, margin: userMargin, className, title, xLabel, yLabel, xFormat, yFormat, xAccessor = "x", yAccessor = "y", sizeBy, sizeRange = [5, 40], colorBy, colorScheme = "category10", bubbleOpacity = 0.6, bubbleStrokeWidth = 1, bubbleStrokeColor = "white", enableHover = true, showGrid = false, showLegend, tooltip, frameProps = {} } = props;
+    const safeData = data || [];
+    // Create color scale if colorBy is specified
+    const colorScale = (0, hooks_1.useColorScale)(safeData, colorBy, colorScheme);
+    // Calculate size domain
+    const sizeDomain = (0, react_1.useMemo)(() => {
+        const sizes = safeData.map((d) => {
+            if (typeof sizeBy === "function") {
+                return sizeBy(d);
+            }
+            return d[sizeBy];
+        });
+        return [Math.min(...sizes), Math.max(...sizes)];
+    }, [safeData, sizeBy]);
+    // Point style function
+    const pointStyle = (0, react_1.useMemo)(() => {
+        return (d) => {
+            const baseStyle = {
+                fillOpacity: bubbleOpacity,
+                strokeWidth: bubbleStrokeWidth,
+                stroke: bubbleStrokeColor
+            };
+            // Apply color
+            if (colorBy) {
+                baseStyle.fill = (0, colorUtils_1.getColor)(d, colorBy, colorScale);
+            }
+            else {
+                baseStyle.fill = hooks_1.DEFAULT_COLOR;
+            }
+            // Apply size
+            baseStyle.r = (0, colorUtils_1.getSize)(d, sizeBy, sizeRange, sizeDomain);
+            return baseStyle;
+        };
+    }, [colorBy, colorScale, sizeBy, sizeRange, sizeDomain, bubbleOpacity, bubbleStrokeWidth, bubbleStrokeColor]);
+    // Build axes configuration
+    const axes = (0, react_1.useMemo)(() => {
+        const axesConfig = [];
+        // Y axis (left)
+        axesConfig.push({
+            orient: "left",
+            label: yLabel,
+            tickFormat: yFormat,
+            ...(showGrid && { tickLineGenerator: () => null })
+        });
+        // X axis (bottom)
+        axesConfig.push({
+            orient: "bottom",
+            label: xLabel,
+            tickFormat: xFormat,
+            ...(showGrid && { tickLineGenerator: () => null })
+        });
+        return axesConfig;
+    }, [xLabel, yLabel, xFormat, yFormat, showGrid]);
+    // Determine if we should show legend
+    const shouldShowLegend = showLegend !== undefined ? showLegend : !!colorBy;
+    // Build legend if needed
+    const legend = (0, react_1.useMemo)(() => {
+        if (!shouldShowLegend || !colorBy)
+            return undefined;
+        return (0, legendUtils_1.createLegend)({
+            data: safeData,
+            colorBy,
+            colorScale,
+            getColor: colorUtils_1.getColor,
+            strokeColor: bubbleStrokeColor,
+            strokeWidth: bubbleStrokeWidth
+        });
+    }, [shouldShowLegend, colorBy, safeData, colorScale, bubbleStrokeColor, bubbleStrokeWidth]);
+    // Adjust margin for legend if present
+    const margin = (0, react_1.useMemo)(() => {
+        const defaultMargin = { top: 50, bottom: 60, left: 70, right: 40 };
+        const finalMargin = { ...defaultMargin, ...userMargin };
+        // If legend is present and right margin is too small, increase it
+        if (legend && finalMargin.right < 120) {
+            finalMargin.right = 120;
+        }
+        return finalMargin;
+    }, [userMargin, legend]);
+    // Validate data (after all hooks)
+    const error = (0, validateChartData_1.validateArrayData)({
+        componentName: "BubbleChart",
+        data: safeData,
+        accessors: {
+            xAccessor,
+            yAccessor,
+        },
+        requiredProps: { sizeBy },
+    });
+    if (error)
+        return React.createElement(ChartError_1.default, { componentName: "BubbleChart", message: error, width: width, height: height });
+    // Build XYFrame props
+    const xyFrameProps = {
+        size: [width, height],
+        points: safeData,
+        xAccessor,
+        yAccessor,
+        pointStyle,
+        axes: axes,
+        hoverAnnotation: enableHover,
+        margin,
+        ...(legend && { legend }),
+        ...(className && { className }),
+        ...(title && { title }),
+        // Add tooltip support
+        ...(tooltip && { tooltipContent: (0, Tooltip_1.normalizeTooltip)(tooltip) }),
+        // Allow frameProps to override defaults
+        transition: true,
+        ...frameProps
+    };
+    return React.createElement(XYFrame_1.default, { ...xyFrameProps });
+}

package/ai/dist/src/components/charts/xy/Heatmap.js

@@ -0,0 +1,230 @@
+"use client";
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Heatmap = Heatmap;
+const React = __importStar(require("react"));
+const react_1 = require("react");
+const d3_scale_1 = require("d3-scale");
+const d3_scale_chromatic_1 = require("d3-scale-chromatic");
+const XYFrame_1 = __importDefault(require("../../XYFrame"));
+const hooks_1 = require("../shared/hooks");
+const Tooltip_1 = require("../../Tooltip/Tooltip");
+const ChartError_1 = __importDefault(require("../shared/ChartError"));
+const validateChartData_1 = require("../shared/validateChartData");
+/**
+ * Heatmap - Visualize matrix data with color-encoded cells
+ *
+ * A simplified wrapper around XYFrame for creating heatmaps. Perfect for
+ * showing patterns, correlations, and distributions in 2D data.
+ *
+ * @example
+ * ```tsx
+ * // Simple heatmap
+ * <Heatmap
+ *   data={[
+ *     {x: 1, y: 1, value: 10},
+ *     {x: 1, y: 2, value: 20},
+ *     {x: 2, y: 1, value: 15},
+ *     {x: 2, y: 2, value: 25}
+ *   ]}
+ *   xLabel="Time"
+ *   yLabel="Category"
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With custom color scheme and value labels
+ * <Heatmap
+ *   data={data}
+ *   colorScheme="viridis"
+ *   showValues={true}
+ *   valueFormat={d => d.toFixed(1)}
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Advanced: Custom color scale
+ * <Heatmap
+ *   data={data}
+ *   colorScheme="custom"
+ *   customColorScale={
+ *     scaleSequential(interpolatePlasma).domain([0, 100])
+ *   }
+ * />
+ * ```
+ *
+ * @remarks
+ * This component wraps {@link XYFrame} with sensible defaults for heatmaps.
+ * For more advanced features like hexbins, contours, or custom summaries,
+ * use XYFrame directly.
+ *
+ * **Breadcrumb to advanced usage:**
+ * - Use the `frameProps` prop to pass any XYFrame prop
+ * - See XYFrame documentation: https://semiotic.nteract.io/guides/xy-frame
+ * - All XYFrame props are available via `frameProps`
+ *
+ * @param props - Heatmap configuration
+ * @returns Rendered heatmap
+ */
+function Heatmap(props) {
+    const { data, width = 600, height = 400, margin = { top: 50, bottom: 60, left: 70, right: 80 }, className, title, xAccessor = "x", yAccessor = "y", valueAccessor = "value", xLabel, yLabel, xFormat, yFormat, colorScheme = "blues", customColorScale, showValues = false, valueFormat, cellBorderColor = "#fff", cellBorderWidth = 1, enableHover = true, tooltip, frameProps = {} } = props;
+    const safeData = data || [];
+    // Get value accessor function
+    const getValueFn = (0, react_1.useMemo)(() => {
+        return typeof valueAccessor === "function"
+            ? (d) => valueAccessor(d)
+            : (d) => d[valueAccessor];
+    }, [valueAccessor]);
+    // Calculate value domain
+    const valueDomain = (0, react_1.useMemo)(() => {
+        const values = safeData.map(getValueFn);
+        return [Math.min(...values), Math.max(...values)];
+    }, [safeData, getValueFn]);
+    // Create color scale
+    const colorScale = (0, react_1.useMemo)(() => {
+        if (colorScheme === "custom" && customColorScale) {
+            return customColorScale;
+        }
+        const interpolators = {
+            blues: d3_scale_chromatic_1.interpolateBlues,
+            reds: d3_scale_chromatic_1.interpolateReds,
+            greens: d3_scale_chromatic_1.interpolateGreens,
+            viridis: d3_scale_chromatic_1.interpolateViridis
+        };
+        const interpolator = interpolators[colorScheme] || d3_scale_chromatic_1.interpolateBlues;
+        return (0, d3_scale_1.scaleSequential)(interpolator).domain(valueDomain);
+    }, [colorScheme, customColorScale, valueDomain]);
+    // Get unique x and y values for bin sizing
+    const { xBinCount, yBinCount } = (0, react_1.useMemo)(() => {
+        const getX = (0, hooks_1.resolveAccessor)(xAccessor);
+        const getY = (0, hooks_1.resolveAccessor)(yAccessor);
+        return {
+            xBinCount: new Set(safeData.map(getX)).size,
+            yBinCount: new Set(safeData.map(getY)).size
+        };
+    }, [safeData, xAccessor, yAccessor]);
+    // Transform data to summary format for XYFrame
+    const summaryData = (0, react_1.useMemo)(() => {
+        return { coordinates: safeData };
+    }, [safeData]);
+    // Summary style function
+    const summaryStyle = (0, react_1.useMemo)(() => {
+        return (d) => {
+            const value = getValueFn(d);
+            return {
+                fill: colorScale(value),
+                stroke: cellBorderColor,
+                strokeWidth: cellBorderWidth
+            };
+        };
+    }, [getValueFn, colorScale, cellBorderColor, cellBorderWidth]);
+    // Summary render function (for value labels)
+    const summaryRenderMode = (0, react_1.useMemo)(() => {
+        if (!showValues)
+            return undefined;
+        const midpoint = (valueDomain[0] + valueDomain[1]) / 2;
+        return (d, i) => {
+            const value = getValueFn(d);
+            const displayValue = valueFormat ? valueFormat(value) : String(value);
+            return (React.createElement("text", { textAnchor: "middle", dominantBaseline: "middle", fill: getValueFn(d) > midpoint ? "#fff" : "#000", fontSize: "12px" }, displayValue));
+        };
+    }, [showValues, getValueFn, valueFormat, valueDomain]);
+    // Build axes configuration
+    const axes = (0, react_1.useMemo)(() => {
+        const axesConfig = [];
+        // Y axis (left)
+        axesConfig.push({
+            orient: "left",
+            label: yLabel,
+            tickFormat: yFormat
+        });
+        // X axis (bottom)
+        axesConfig.push({
+            orient: "bottom",
+            label: xLabel,
+            tickFormat: xFormat
+        });
+        return axesConfig;
+    }, [xLabel, yLabel, xFormat, yFormat]);
+    // Validate data (after all hooks)
+    const error = (0, validateChartData_1.validateArrayData)({
+        componentName: "Heatmap",
+        data: safeData,
+        accessors: {
+            xAccessor,
+            yAccessor,
+            valueAccessor,
+        },
+    });
+    if (error)
+        return React.createElement(ChartError_1.default, { componentName: "Heatmap", message: error, width: width, height: height });
+    // Build XYFrame props
+    const xyFrameProps = {
+        size: [width, height],
+        summaries: summaryData,
+        xAccessor,
+        yAccessor,
+        summaryType: {
+            type: "heatmap",
+            xBins: xBinCount,
+            yBins: yBinCount,
+            binValue: (items) => {
+                if (items.length === 0)
+                    return 0;
+                const sum = items.reduce((acc, item) => acc + getValueFn(item), 0);
+                return sum / items.length;
+            }
+        },
+        summaryStyle,
+        axes: axes,
+        hoverAnnotation: enableHover,
+        margin,
+        ...(summaryRenderMode && { summaryRenderMode }),
+        ...(className && { className }),
+        ...(title && { title }),
+        // Add tooltip support
+        ...(tooltip && { tooltipContent: (0, Tooltip_1.normalizeTooltip)(tooltip) }),
+        // Allow frameProps to override defaults
+        transition: true,
+        ...frameProps
+    };
+    return React.createElement(XYFrame_1.default, { ...xyFrameProps });
+}