semiotic 2.0.3 → 3.0.0-beta.2

package/ai/dist/src/components/charts/ordinal/SwarmPlot.js

@@ -0,0 +1,147 @@
+"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.SwarmPlot = SwarmPlot;
+const React = __importStar(require("react"));
+const react_1 = require("react");
+const StreamOrdinalFrame_1 = __importDefault(require("../../stream/StreamOrdinalFrame"));
+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");
+const selectionUtils_1 = require("../shared/selectionUtils");
+const useSelection_1 = require("../../store/useSelection");
+const useSelection_2 = require("../../store/useSelection");
+function SwarmPlot(props) {
+    const { data, width = 600, height = 400, margin: userMargin, className, title, categoryAccessor = "category", valueAccessor = "value", orientation = "vertical", categoryLabel, valueLabel, valueFormat, colorBy, colorScheme = "category10", sizeBy, sizeRange = [3, 8], pointRadius = 4, pointOpacity = 0.7, categoryPadding = 20, enableHover = true, showGrid = false, showLegend, tooltip, frameProps = {}, selection, linkedHover } = props;
+    const safeData = data || [];
+    const hoverConfig = (0, selectionUtils_1.normalizeLinkedHover)(linkedHover, colorBy ? [typeof colorBy === "string" ? colorBy : ""] : [typeof categoryAccessor === "string" ? categoryAccessor : ""]);
+    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 activeSelectionHook = selection ? { isActive: selectionHook.isActive, predicate: selectionHook.predicate } : null;
+    const colorScale = (0, hooks_1.useColorScale)(safeData, colorBy, colorScheme);
+    const sizeDomain = (0, react_1.useMemo)(() => {
+        if (!sizeBy)
+            return undefined;
+        const sizes = safeData.map((d) => typeof sizeBy === "function" ? sizeBy(d) : d[sizeBy]);
+        return [Math.min(...sizes), Math.max(...sizes)];
+    }, [safeData, sizeBy]);
+    const basePieceStyle = (0, react_1.useMemo)(() => {
+        return (d) => {
+            const baseStyle = { fillOpacity: pointOpacity };
+            baseStyle.fill = colorBy ? (0, colorUtils_1.getColor)(d, colorBy, colorScale) : hooks_1.DEFAULT_COLOR;
+            baseStyle.r = sizeBy ? (0, colorUtils_1.getSize)(d, sizeBy, sizeRange, sizeDomain) : pointRadius;
+            return baseStyle;
+        };
+    }, [colorBy, colorScale, sizeBy, sizeRange, sizeDomain, pointRadius, pointOpacity]);
+    const pieceStyle = (0, react_1.useMemo)(() => (0, selectionUtils_1.wrapStyleWithSelection)(basePieceStyle, activeSelectionHook, selection), [basePieceStyle, activeSelectionHook, selection]);
+    const shouldShowLegend = showLegend !== undefined ? showLegend : !!colorBy;
+    const legend = (0, react_1.useMemo)(() => {
+        if (!shouldShowLegend || !colorBy)
+            return undefined;
+        return (0, legendUtils_1.createLegend)({ data: safeData, colorBy, colorScale, getColor: colorUtils_1.getColor });
+    }, [shouldShowLegend, colorBy, safeData, colorScale]);
+    const margin = (0, react_1.useMemo)(() => {
+        const finalMargin = { top: 50, bottom: 60, left: 70, right: 40, ...userMargin };
+        if (legend && finalMargin.right < 120)
+            finalMargin.right = 120;
+        return finalMargin;
+    }, [userMargin, legend]);
+    const customHoverBehavior = (0, react_1.useCallback)((d) => { if (linkedHover)
+        linkedHoverHook.onHover(d); }, [linkedHover, linkedHoverHook]);
+    const defaultTooltipContent = (0, react_1.useMemo)(() => {
+        const getVal = (0, hooks_1.resolveAccessor)(valueAccessor);
+        const getCat = (0, hooks_1.resolveAccessor)(categoryAccessor);
+        return (d) => {
+            const datum = d.data || d;
+            const cat = getCat(datum);
+            const val = getVal(datum);
+            const colorVal = colorBy
+                ? (typeof colorBy === "function" ? colorBy(datum) : datum[colorBy])
+                : null;
+            const sizeVal = sizeBy
+                ? (typeof sizeBy === "function" ? sizeBy(datum) : datum[sizeBy])
+                : null;
+            return (React.createElement("div", { className: "semiotic-tooltip", style: Tooltip_1.defaultTooltipStyle },
+                React.createElement("div", { style: { fontWeight: "bold" } }, String(cat)),
+                React.createElement("div", { style: { marginTop: "4px" } }, typeof val === "number" ? val.toLocaleString() : String(val)),
+                colorVal != null && (React.createElement("div", { style: { marginTop: "2px", opacity: 0.8 } },
+                    typeof colorBy === "string" ? colorBy : "color",
+                    ": ",
+                    String(colorVal))),
+                sizeVal != null && (React.createElement("div", { style: { marginTop: "2px", opacity: 0.8 } },
+                    typeof sizeBy === "string" ? sizeBy : "size",
+                    ": ",
+                    typeof sizeVal === "number" ? sizeVal.toLocaleString() : String(sizeVal)))));
+        };
+    }, [categoryAccessor, valueAccessor, colorBy, sizeBy]);
+    const error = (0, validateChartData_1.validateArrayData)({
+        componentName: "SwarmPlot", data: safeData,
+        accessors: { categoryAccessor, valueAccessor },
+    });
+    if (error)
+        return React.createElement(ChartError_1.default, { componentName: "SwarmPlot", message: error, width: width, height: height });
+    const streamProps = {
+        chartType: "swarm",
+        data: safeData,
+        oAccessor: categoryAccessor,
+        rAccessor: valueAccessor,
+        projection: orientation === "horizontal" ? "horizontal" : "vertical",
+        pieceStyle,
+        size: [width, height],
+        margin,
+        barPadding: categoryPadding,
+        enableHover,
+        showAxes: true,
+        oLabel: categoryLabel,
+        rLabel: valueLabel,
+        rFormat: valueFormat,
+        showGrid,
+        ...(legend && { legend }),
+        ...(title && { title }),
+        ...(className && { className }),
+        tooltipContent: (tooltip ? (0, Tooltip_1.normalizeTooltip)(tooltip) : defaultTooltipContent),
+        ...(linkedHover && { customHoverBehavior }),
+        ...frameProps
+    };
+    return React.createElement(StreamOrdinalFrame_1.default, { ...streamProps });
+}
+SwarmPlot.displayName = "SwarmPlot";

package/ai/dist/src/components/charts/ordinal/ViolinPlot.js

@@ -0,0 +1,138 @@
+"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.ViolinPlot = ViolinPlot;
+const React = __importStar(require("react"));
+const react_1 = require("react");
+const StreamOrdinalFrame_1 = __importDefault(require("../../stream/StreamOrdinalFrame"));
+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");
+const selectionUtils_1 = require("../shared/selectionUtils");
+const useSelection_1 = require("../../store/useSelection");
+const useSelection_2 = require("../../store/useSelection");
+function ViolinPlot(props) {
+    const { data, width = 600, height = 400, margin: userMargin, className, title, categoryAccessor = "category", valueAccessor = "value", orientation = "vertical", bins = 25, curve = "catmullRom", showIQR = true, categoryLabel, valueLabel, valueFormat, colorBy, colorScheme = "category10", categoryPadding = 20, enableHover = true, showGrid = false, showLegend, tooltip, frameProps = {}, selection, linkedHover } = props;
+    const safeData = data || [];
+    const hoverConfig = (0, selectionUtils_1.normalizeLinkedHover)(linkedHover, colorBy ? [typeof colorBy === "string" ? colorBy : ""] : [typeof categoryAccessor === "string" ? categoryAccessor : ""]);
+    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 activeSelectionHook = selection ? { isActive: selectionHook.isActive, predicate: selectionHook.predicate } : null;
+    const colorScale = (0, hooks_1.useColorScale)(safeData, colorBy, colorScheme);
+    const baseSummaryStyle = (0, react_1.useMemo)(() => {
+        return (d) => {
+            const color = colorBy ? (0, colorUtils_1.getColor)(d, colorBy, colorScale) : hooks_1.DEFAULT_COLOR;
+            return { fill: color, stroke: color, fillOpacity: 0.6 };
+        };
+    }, [colorBy, colorScale]);
+    const summaryStyle = (0, react_1.useMemo)(() => (0, selectionUtils_1.wrapStyleWithSelection)(baseSummaryStyle, activeSelectionHook, selection), [baseSummaryStyle, activeSelectionHook, selection]);
+    const shouldShowLegend = showLegend !== undefined ? showLegend : !!colorBy;
+    const legend = (0, react_1.useMemo)(() => {
+        if (!shouldShowLegend || !colorBy)
+            return undefined;
+        return (0, legendUtils_1.createLegend)({ data: safeData, colorBy, colorScale, getColor: colorUtils_1.getColor });
+    }, [shouldShowLegend, colorBy, safeData, colorScale]);
+    const margin = (0, react_1.useMemo)(() => {
+        const finalMargin = { top: 50, bottom: 60, left: 70, right: 40, ...userMargin };
+        if (legend && finalMargin.right < 120)
+            finalMargin.right = 120;
+        return finalMargin;
+    }, [userMargin, legend]);
+    const customHoverBehavior = (0, react_1.useCallback)((d) => { if (linkedHover)
+        linkedHoverHook.onHover(d); }, [linkedHover, linkedHoverHook]);
+    const defaultTooltipContent = (0, react_1.useMemo)(() => {
+        const getVal = (0, hooks_1.resolveAccessor)(valueAccessor);
+        return (d) => {
+            const datum = d.data || d;
+            const category = datum.category || d.category || "";
+            // datum is the array of piece data for the column
+            const pieces = Array.isArray(datum) ? datum : [];
+            const values = pieces.map((p) => {
+                const v = typeof valueAccessor === "function" ? valueAccessor(p) : p[valueAccessor];
+                return Number(v);
+            }).filter((v) => !isNaN(v)).sort((a, b) => a - b);
+            const n = values.length;
+            const median = n > 0 ? values[Math.floor(n / 2)] : null;
+            return (React.createElement("div", { className: "semiotic-tooltip", style: Tooltip_1.defaultTooltipStyle },
+                category && React.createElement("div", { style: { fontWeight: "bold" } }, String(category)),
+                n > 0 && React.createElement("div", null,
+                    "n = ",
+                    n),
+                median != null && React.createElement("div", null,
+                    "Median: ",
+                    median.toLocaleString())));
+        };
+    }, [valueAccessor]);
+    const error = (0, validateChartData_1.validateArrayData)({
+        componentName: "ViolinPlot", data: safeData,
+        accessors: { categoryAccessor, valueAccessor },
+    });
+    if (error)
+        return React.createElement(ChartError_1.default, { componentName: "ViolinPlot", message: error, width: width, height: height });
+    const streamProps = {
+        chartType: "violin",
+        data: safeData,
+        oAccessor: categoryAccessor,
+        rAccessor: valueAccessor,
+        projection: orientation === "horizontal" ? "horizontal" : "vertical",
+        summaryStyle,
+        bins,
+        showIQR,
+        size: [width, height],
+        margin,
+        barPadding: categoryPadding,
+        enableHover,
+        showAxes: true,
+        oLabel: categoryLabel,
+        rLabel: valueLabel,
+        rFormat: valueFormat,
+        showGrid,
+        ...(legend && { legend }),
+        ...(title && { title }),
+        ...(className && { className }),
+        tooltipContent: (tooltip ? (0, Tooltip_1.normalizeTooltip)(tooltip) : defaultTooltipContent),
+        ...(linkedHover && { customHoverBehavior }),
+        ...frameProps
+    };
+    return React.createElement(StreamOrdinalFrame_1.default, { ...streamProps });
+}
+ViolinPlot.displayName = "ViolinPlot";

package/ai/dist/src/components/charts/realtime/RealtimeHeatmap.js

@@ -0,0 +1,79 @@
+"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.RealtimeHeatmap = void 0;
+const React = __importStar(require("react"));
+const react_1 = require("react");
+const StreamXYFrame_1 = __importDefault(require("../../stream/StreamXYFrame"));
+/**
+ * RealtimeHeatmap - Streaming heatmap with 2D grid binning.
+ *
+ * Wraps StreamXYFrame with `chartType="heatmap"` and `runtimeMode="streaming"`,
+ * providing configurable bin counts and aggregation modes.
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef<RealtimeFrameHandle>(null)
+ * ref.current.push({ time: Date.now(), x: 42, y: 7 })
+ *
+ * <RealtimeHeatmap
+ *   ref={ref}
+ *   timeAccessor="time"
+ *   valueAccessor="y"
+ *   heatmapXBins={30}
+ *   heatmapYBins={20}
+ *   aggregation="count"
+ * />
+ * ```
+ */
+exports.RealtimeHeatmap = (0, react_1.forwardRef)(function RealtimeHeatmap(props, ref) {
+    const { size, width, height, margin, className, arrowOfTime = "right", windowMode = "sliding", windowSize = 200, data, timeAccessor, valueAccessor, categoryAccessor, timeExtent, valueExtent, extentPadding, heatmapXBins = 20, heatmapYBins = 20, aggregation = "count", showAxes = true, background, enableHover, tooltipContent, tooltip, onHover, annotations, svgAnnotationRules, tickFormatTime, tickFormatValue, decay, pulse, staleness } = props;
+    const resolvedSize = width != null && height != null
+        ? [width, height]
+        : size || [500, 300];
+    const resolvedTooltip = tooltipContent ?? tooltip;
+    const frameRef = (0, react_1.useRef)(null);
+    (0, react_1.useImperativeHandle)(ref, () => ({
+        push: (point) => frameRef.current?.push(point),
+        pushMany: (points) => frameRef.current?.pushMany(points),
+        clear: () => frameRef.current?.clear(),
+        getData: () => frameRef.current?.getData() ?? []
+    }));
+    return (React.createElement(StreamXYFrame_1.default, { ref: frameRef, chartType: "heatmap", runtimeMode: "streaming", size: resolvedSize, margin: margin, className: className, arrowOfTime: arrowOfTime, windowMode: windowMode, windowSize: windowSize, data: data, timeAccessor: timeAccessor, valueAccessor: valueAccessor, categoryAccessor: categoryAccessor, xExtent: timeExtent, yExtent: valueExtent, extentPadding: extentPadding, heatmapXBins: heatmapXBins, heatmapYBins: heatmapYBins, heatmapAggregation: aggregation, showAxes: showAxes, background: background, hoverAnnotation: enableHover, tooltipContent: resolvedTooltip, customHoverBehavior: onHover, annotations: annotations, svgAnnotationRules: svgAnnotationRules, tickFormatTime: tickFormatTime, tickFormatValue: tickFormatValue, decay: decay, pulse: pulse, staleness: staleness }));
+});
+exports.RealtimeHeatmap.displayName = "RealtimeHeatmap";

package/ai/dist/src/components/charts/realtime/RealtimeHistogram.js

@@ -0,0 +1,114 @@
+"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.RealtimeHistogram = exports.RealtimeTemporalHistogram = void 0;
+const React = __importStar(require("react"));
+const react_1 = require("react");
+const StreamXYFrame_1 = __importDefault(require("../../stream/StreamXYFrame"));
+const selectionUtils_1 = require("../shared/selectionUtils");
+const useSelection_1 = require("../../store/useSelection");
+/**
+ * RealtimeTemporalHistogram - Streaming temporal histogram.
+ *
+ * Wraps StreamXYFrame with `chartType="bar"` and `runtimeMode="streaming"`,
+ * binning pushed data points into time-windowed bars. Supports both simple
+ * and stacked (categorical) modes.
+ *
+ * Edge bins that only partially fall within the visible time window are
+ * rendered at proportionally narrower widths (Datadog-style).
+ *
+ * @example
+ * ```tsx
+ * // Simple histogram
+ * <RealtimeTemporalHistogram
+ *   ref={ref}
+ *   binSize={20}
+ *   fill="#007bff"
+ *   enableHover
+ * />
+ *
+ * // Stacked by category
+ * <RealtimeTemporalHistogram
+ *   ref={ref}
+ *   binSize={25}
+ *   categoryAccessor="category"
+ *   colors={{ errors: "#dc3545", warnings: "#fd7e14", info: "#007bff" }}
+ *   enableHover
+ * />
+ * ```
+ */
+exports.RealtimeTemporalHistogram = (0, react_1.forwardRef)(function RealtimeTemporalHistogram(props, ref) {
+    const { binSize, size, width, height, margin, className, arrowOfTime = "right", windowMode = "sliding", windowSize = 200, data, timeAccessor, valueAccessor, timeExtent, valueExtent, extentPadding, categoryAccessor, colors, fill, stroke, strokeWidth, gap, showAxes = true, background, enableHover, tooltipContent, tooltip, onHover, annotations, svgAnnotationRules, tickFormatTime, tickFormatValue, linkedHover } = props;
+    const resolvedSize = width != null && height != null
+        ? [width, height]
+        : size || [500, 300];
+    const resolvedTooltip = tooltipContent ?? tooltip;
+    const frameRef = (0, react_1.useRef)(null);
+    // ── Linked hover hooks (always called, conditional logic inside) ──
+    const hoverConfig = (0, selectionUtils_1.normalizeLinkedHover)(linkedHover);
+    const linkedHoverHook = (0, useSelection_1.useLinkedHover)({
+        name: hoverConfig?.name || "hover",
+        fields: hoverConfig?.fields || []
+    });
+    const combinedHoverBehavior = (0, react_1.useCallback)((d) => {
+        if (onHover)
+            onHover(d);
+        if (linkedHover) {
+            linkedHoverHook.onHover(d ? (d.data || d) : null);
+        }
+    }, [onHover, linkedHover, linkedHoverHook]);
+    (0, react_1.useImperativeHandle)(ref, () => ({
+        push: (point) => frameRef.current?.push(point),
+        pushMany: (points) => frameRef.current?.pushMany(points),
+        clear: () => frameRef.current?.clear(),
+        getData: () => frameRef.current?.getData() ?? []
+    }));
+    const barStyle = {};
+    if (fill != null)
+        barStyle.fill = fill;
+    if (stroke != null)
+        barStyle.stroke = stroke;
+    if (strokeWidth != null)
+        barStyle.strokeWidth = strokeWidth;
+    if (gap != null)
+        barStyle.gap = gap;
+    return (React.createElement(StreamXYFrame_1.default, { ref: frameRef, chartType: "bar", runtimeMode: "streaming", size: resolvedSize, margin: margin, className: className, arrowOfTime: arrowOfTime, windowMode: windowMode, windowSize: windowSize, data: data, timeAccessor: timeAccessor, valueAccessor: valueAccessor, xExtent: timeExtent, yExtent: valueExtent, extentPadding: extentPadding, binSize: binSize, categoryAccessor: categoryAccessor, barColors: colors, barStyle: barStyle, showAxes: showAxes, background: background, hoverAnnotation: enableHover, tooltipContent: resolvedTooltip, customHoverBehavior: combinedHoverBehavior, annotations: annotations, svgAnnotationRules: svgAnnotationRules, tickFormatTime: tickFormatTime, tickFormatValue: tickFormatValue }));
+});
+exports.RealtimeTemporalHistogram.displayName = "RealtimeTemporalHistogram";
+/** @deprecated Use RealtimeTemporalHistogram instead */
+exports.RealtimeHistogram = exports.RealtimeTemporalHistogram;

package/ai/dist/src/components/charts/realtime/RealtimeLineChart.js

@@ -0,0 +1,93 @@
+"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.RealtimeLineChart = void 0;
+const React = __importStar(require("react"));
+const react_1 = require("react");
+const StreamXYFrame_1 = __importDefault(require("../../stream/StreamXYFrame"));
+const selectionUtils_1 = require("../shared/selectionUtils");
+const useSelection_1 = require("../../store/useSelection");
+/**
+ * RealtimeLineChart - Simplified wrapper for streaming line charts.
+ *
+ * Wraps StreamXYFrame with `chartType="line"` and `runtimeMode="streaming"`,
+ * exposing stroke/strokeWidth as top-level props instead of requiring a `lineStyle` object.
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef<RealtimeFrameHandle>(null)
+ *
+ * <RealtimeLineChart
+ *   ref={ref}
+ *   stroke="#007bff"
+ *   strokeWidth={2}
+ *   windowSize={200}
+ *   enableHover
+ * />
+ * ```
+ */
+exports.RealtimeLineChart = (0, react_1.forwardRef)(function RealtimeLineChart(props, ref) {
+    const { size, width, height, margin, className, arrowOfTime = "right", windowMode = "sliding", windowSize = 200, data, timeAccessor, valueAccessor, timeExtent, valueExtent, extentPadding, stroke = "#007bff", strokeWidth = 2, strokeDasharray, showAxes = true, background, enableHover, tooltipContent, tooltip, onHover, annotations, svgAnnotationRules, tickFormatTime, tickFormatValue, decay, pulse, staleness, transition, linkedHover } = props;
+    const resolvedSize = width != null && height != null
+        ? [width, height]
+        : size || [500, 300];
+    const resolvedTooltip = tooltipContent ?? tooltip;
+    const frameRef = (0, react_1.useRef)(null);
+    // ── Linked hover hooks (always called, conditional logic inside) ──
+    const hoverConfig = (0, selectionUtils_1.normalizeLinkedHover)(linkedHover);
+    const linkedHoverHook = (0, useSelection_1.useLinkedHover)({
+        name: hoverConfig?.name || "hover",
+        fields: hoverConfig?.fields || []
+    });
+    const combinedHoverBehavior = (0, react_1.useCallback)((d) => {
+        if (onHover)
+            onHover(d);
+        if (linkedHover) {
+            linkedHoverHook.onHover(d ? (d.data || d) : null);
+        }
+    }, [onHover, linkedHover, linkedHoverHook]);
+    (0, react_1.useImperativeHandle)(ref, () => ({
+        push: (point) => frameRef.current?.push(point),
+        pushMany: (points) => frameRef.current?.pushMany(points),
+        clear: () => frameRef.current?.clear(),
+        getData: () => frameRef.current?.getData() ?? []
+    }));
+    const lineStyle = { stroke, strokeWidth, strokeDasharray };
+    return (React.createElement(StreamXYFrame_1.default, { ref: frameRef, chartType: "line", runtimeMode: "streaming", size: resolvedSize, margin: margin, className: className, arrowOfTime: arrowOfTime, windowMode: windowMode, windowSize: windowSize, data: data, timeAccessor: timeAccessor, valueAccessor: valueAccessor, xExtent: timeExtent, yExtent: valueExtent, extentPadding: extentPadding, lineStyle: lineStyle, showAxes: showAxes, background: background, hoverAnnotation: enableHover, tooltipContent: resolvedTooltip, customHoverBehavior: combinedHoverBehavior, annotations: annotations, svgAnnotationRules: svgAnnotationRules, tickFormatTime: tickFormatTime, tickFormatValue: tickFormatValue, decay: decay, pulse: pulse, staleness: staleness, transition: transition }));
+});
+exports.RealtimeLineChart.displayName = "RealtimeLineChart";