semiotic 3.0.0-beta.2 → 3.0.0-beta.4

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

@@ -1,230 +0,0 @@
-"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

@@ -1,251 +0,0 @@
-"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";