semiotic 2.0.3 → 3.0.0-beta.2

package/ai/dist/src/components/charts/xy/AreaChart.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.AreaChart = AreaChart;
+const React = __importStar(require("react"));
+const react_1 = require("react");
+const StreamXYFrame_1 = __importDefault(require("../../stream/StreamXYFrame"));
+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 tooltipUtils_1 = require("../shared/tooltipUtils");
+const ChartError_1 = __importDefault(require("../shared/ChartError"));
+const validateChartData_1 = require("../shared/validateChartData");
+const selectionUtils_1 = require("../shared/selectionUtils");
+const useSelection_1 = require("../../store/useSelection");
+const useSelection_2 = require("../../store/useSelection");
+/**
+ * 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 = {}, selection, linkedHover } = props;
+    const safeData = data || [];
+    // ── Selection hooks (always called, conditional logic inside) ──────────
+    const hoverConfig = (0, selectionUtils_1.normalizeLinkedHover)(linkedHover, colorBy ? [typeof colorBy === "string" ? colorBy : ""] : []);
+    const selectionHook = (0, useSelection_1.useSelection)({
+        name: selection?.name || "__unused__",
+        fields: []
+    });
+    const linkedHoverHook = (0, useSelection_2.useLinkedHover)({
+        name: hoverConfig?.name || "hover",
+        fields: hoverConfig?.fields || []
+    });
+    // Only use the hooks when the corresponding props are provided
+    const activeSelectionHook = selection ? { isActive: selectionHook.isActive, predicate: selectionHook.predicate } : null;
+    // ── Core chart logic ───────────────────────────────────────────────────
+    // 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);
+    // Area/line style function
+    const baseLineStyle = (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]);
+    const lineStyle = (0, react_1.useMemo)(() => (0, selectionUtils_1.wrapStyleWithSelection)(baseLineStyle, activeSelectionHook, selection), [baseLineStyle, activeSelectionHook, selection]);
+    // 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]);
+    // ── Hover behavior ─────────────────────────────────────────────────────
+    const customHoverBehavior = (0, react_1.useCallback)((d) => {
+        if (linkedHover) {
+            linkedHoverHook.onHover(d);
+        }
+    }, [linkedHover, linkedHoverHook]);
+    // Default tooltip showing all configured fields
+    const groupField = areaBy || colorBy;
+    const defaultTooltipContent = (0, react_1.useMemo)(() => (0, tooltipUtils_1.buildDefaultTooltip)([
+        { label: xLabel || (0, tooltipUtils_1.accessorName)(xAccessor), accessor: xAccessor, role: "x" },
+        { label: yLabel || (0, tooltipUtils_1.accessorName)(yAccessor), accessor: yAccessor, role: "y" },
+        ...(groupField ? [{ label: (0, tooltipUtils_1.accessorName)(groupField), accessor: groupField, role: "group" }] : []),
+    ]), [xAccessor, yAccessor, xLabel, yLabel, groupField]);
+    // 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 });
+    // Flatten area data into a single array for StreamXYFrame
+    const flattenedData = (0, react_1.useMemo)(() => {
+        if (isAreaObjectFormat || areaBy) {
+            return areaData.flatMap((area) => {
+                const coords = area[lineDataAccessor] || [];
+                if (areaBy && typeof areaBy === "string") {
+                    return coords.map((c) => ({ ...c, [areaBy]: area[areaBy] }));
+                }
+                return coords;
+            });
+        }
+        return safeData;
+    }, [areaData, lineDataAccessor, isAreaObjectFormat, areaBy, safeData]);
+    // Build StreamXYFrame props
+    const streamProps = {
+        chartType: "area",
+        data: flattenedData,
+        xAccessor,
+        yAccessor,
+        groupAccessor: areaBy || undefined,
+        curve,
+        lineStyle,
+        size: [width, height],
+        margin,
+        showAxes: true,
+        xLabel,
+        yLabel,
+        xFormat,
+        yFormat,
+        enableHover,
+        showGrid,
+        ...(legend && { legend }),
+        ...(title && { title }),
+        ...(className && { className }),
+        tooltipContent: (tooltip ? (0, Tooltip_1.normalizeTooltip)(tooltip) : defaultTooltipContent),
+        ...(linkedHover && { customHoverBehavior }),
+        ...frameProps
+    };
+    return React.createElement(StreamXYFrame_1.default, { ...streamProps });
+}
+AreaChart.displayName = "AreaChart";

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

@@ -0,0 +1,251 @@
+"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 StreamXYFrame_1 = __importDefault(require("../../stream/StreamXYFrame"));
+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 tooltipUtils_1 = require("../shared/tooltipUtils");
+const ChartError_1 = __importDefault(require("../shared/ChartError"));
+const validateChartData_1 = require("../shared/validateChartData");
+const selectionUtils_1 = require("../shared/selectionUtils");
+const useSelection_1 = require("../../store/useSelection");
+const useSelection_2 = require("../../store/useSelection");
+const useSelection_3 = require("../../store/useSelection");
+/**
+ * BubbleChart - Visualize three dimensions of data using x, y, and size
+ *
+ * A simplified wrapper around StreamXYFrame 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 StreamXYFrame props
+ * <BubbleChart
+ *   data={data}
+ *   sizeBy="value"
+ *   frameProps={{
+ *     customPointMark: ({ d }) => <circle r={d.r} fill="gold" />
+ *   }}
+ * />
+ * ```
+ *
+ * @remarks
+ * This component wraps {@link StreamXYFrame} with sensible defaults for bubble charts.
+ * For more advanced features like custom marks, annotations, or complex interactions,
+ * use StreamXYFrame directly.
+ *
+ * **Breadcrumb to advanced usage:**
+ * - Use the `frameProps` prop to pass any StreamXYFrame prop
+ * - See StreamXYFrame documentation: https://semiotic.nteract.io/guides/xy-frame
+ * - All StreamXYFrame 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, marginalGraphics, frameProps = {}, selection, linkedHover, linkedBrush } = props;
+    const safeData = data || [];
+    // ── Selection hooks (always called, conditional logic inside) ──────────
+    const hoverConfig = (0, selectionUtils_1.normalizeLinkedHover)(linkedHover, colorBy ? [typeof colorBy === "string" ? colorBy : ""] : []);
+    const brushConfig = (0, selectionUtils_1.normalizeLinkedBrush)(linkedBrush);
+    const selectionHook = (0, useSelection_1.useSelection)({
+        name: selection?.name || "__unused__",
+        fields: []
+    });
+    const linkedHoverHook = (0, useSelection_2.useLinkedHover)({
+        name: hoverConfig?.name || "hover",
+        fields: hoverConfig?.fields || []
+    });
+    const brushHook = (0, useSelection_3.useBrushSelection)({
+        name: brushConfig?.name || "__unused_brush__",
+        xField: brushConfig?.xField || (typeof xAccessor === "string" ? xAccessor : undefined),
+        yField: brushConfig?.yField || (typeof yAccessor === "string" ? yAccessor : undefined)
+    });
+    // Only use the hooks when the corresponding props are provided
+    const activeSelectionHook = selection ? { isActive: selectionHook.isActive, predicate: selectionHook.predicate } : null;
+    // ── Core chart logic ───────────────────────────────────────────────────
+    // 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 basePointStyle = (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]);
+    const pointStyle = (0, react_1.useMemo)(() => (0, selectionUtils_1.wrapStyleWithSelection)(basePointStyle, activeSelectionHook, selection), [basePointStyle, activeSelectionHook, selection]);
+    // 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]);
+    // ── Hover behavior ─────────────────────────────────────────────────────
+    const customHoverBehavior = (0, react_1.useCallback)((d) => {
+        if (linkedHover) {
+            linkedHoverHook.onHover(d);
+        }
+    }, [linkedHover, linkedHoverHook]);
+    // Default tooltip showing all configured fields
+    const defaultTooltipContent = (0, react_1.useMemo)(() => (0, tooltipUtils_1.buildDefaultTooltip)([
+        { label: xLabel || (0, tooltipUtils_1.accessorName)(xAccessor), accessor: xAccessor, role: "x" },
+        { label: yLabel || (0, tooltipUtils_1.accessorName)(yAccessor), accessor: yAccessor, role: "y" },
+        { label: (0, tooltipUtils_1.accessorName)(sizeBy), accessor: sizeBy, role: "size" },
+        ...(colorBy ? [{ label: (0, tooltipUtils_1.accessorName)(colorBy), accessor: colorBy, role: "color" }] : []),
+    ]), [xAccessor, yAccessor, xLabel, yLabel, sizeBy, colorBy]);
+    // 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 StreamXYFrame props
+    const streamProps = {
+        chartType: "bubble",
+        data: safeData,
+        xAccessor,
+        yAccessor,
+        colorAccessor: colorBy || undefined,
+        sizeAccessor: sizeBy,
+        sizeRange,
+        pointStyle,
+        colorScheme,
+        size: [width, height],
+        margin,
+        showAxes: true,
+        xLabel,
+        yLabel,
+        xFormat,
+        yFormat,
+        enableHover,
+        showGrid,
+        ...(legend && { legend }),
+        ...(title && { title }),
+        ...(className && { className }),
+        tooltipContent: (tooltip ? (0, Tooltip_1.normalizeTooltip)(tooltip) : defaultTooltipContent),
+        ...(linkedHover && { customHoverBehavior }),
+        ...(marginalGraphics && { marginalGraphics }),
+        ...frameProps
+    };
+    return React.createElement(StreamXYFrame_1.default, { ...streamProps });
+}
+BubbleChart.displayName = "BubbleChart";