semiotic 2.0.3 → 3.0.0-beta.1

package/ai/dist/src/components/charts/shared/legendUtils.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLegend = createLegend;
+/**
+ * Create a legend configuration for HOC components
+ *
+ * @param data - Array of data points
+ * @param colorBy - Field or function to determine color categories
+ * @param colorScale - Optional d3 color scale function
+ * @param getColor - Function to get color for a data point
+ * @param strokeColor - Optional stroke color for legend items
+ * @param strokeWidth - Optional stroke width for legend items
+ * @returns Legend configuration object for Semiotic frames
+ */
+function createLegend({ data, colorBy, colorScale, getColor, strokeColor, strokeWidth }) {
+    // Get unique category values
+    const uniqueValues = Array.from(new Set(data.map((d) => {
+        if (typeof colorBy === "function") {
+            return colorBy(d);
+        }
+        return d[colorBy];
+    })));
+    // Create items array for the legend
+    const items = uniqueValues.map((value) => {
+        const sampleData = typeof colorBy === "function"
+            ? data.find((d) => colorBy(d) === value)
+            : data.find((d) => d[colorBy] === value);
+        const color = sampleData
+            ? getColor(sampleData, colorBy, colorScale)
+            : colorScale
+                ? colorScale(value)
+                : "#000000";
+        return {
+            label: String(value),
+            color
+        };
+    });
+    return {
+        legendGroups: [
+            {
+                styleFn: (d) => {
+                    const style = { fill: d.color, stroke: d.color };
+                    if (strokeColor !== undefined) {
+                        style.stroke = strokeColor;
+                    }
+                    if (strokeWidth !== undefined) {
+                        style.strokeWidth = strokeWidth;
+                    }
+                    return style;
+                },
+                type: "fill",
+                items,
+                label: "" // Required by LegendGroup interface
+            }
+        ]
+    };
+}

package/ai/dist/src/components/charts/shared/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/ai/dist/src/components/charts/shared/validateChartData.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Validates chart data and accessors at render time.
+ * Returns null if data is valid, or an error message string if not.
+ *
+ * Validation is intentionally lightweight — it checks the first data point
+ * to catch common mistakes (wrong field names, missing data) without
+ * iterating the entire dataset.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateArrayData = validateArrayData;
+exports.validateObjectData = validateObjectData;
+exports.validateNetworkData = validateNetworkData;
+/**
+ * Validate array-based chart data (LineChart, BarChart, Scatterplot, etc.)
+ */
+function validateArrayData({ componentName, data, accessors, requiredProps, }) {
+    // Check required props first
+    if (requiredProps) {
+        for (const [name, value] of Object.entries(requiredProps)) {
+            if (value === undefined || value === null) {
+                return `${name} is required. Provide a field name or function.`;
+            }
+        }
+    }
+    // Check data exists and is non-empty
+    if (!data || !Array.isArray(data) || data.length === 0) {
+        return "No data provided. Pass a non-empty array to the data prop.";
+    }
+    // Check accessors against the first data point
+    if (accessors) {
+        const sample = data[0];
+        if (sample && typeof sample === "object") {
+            for (const [label, accessor] of Object.entries(accessors)) {
+                if (!accessor)
+                    continue;
+                if (typeof accessor === "string" && !(accessor in sample)) {
+                    return (`${label} "${accessor}" not found in data. ` +
+                        `Available fields: ${Object.keys(sample).join(", ")}.`);
+                }
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Validate object/hierarchical data (TreeDiagram, Treemap, CirclePack)
+ */
+function validateObjectData({ componentName, data, dataLabel = "data", }) {
+    if (data === undefined || data === null) {
+        return `No ${dataLabel} provided. Pass a hierarchical data object to the ${dataLabel} prop.`;
+    }
+    return null;
+}
+/**
+ * Validate network data (ForceDirectedGraph, ChordDiagram, SankeyDiagram)
+ */
+function validateNetworkData({ componentName, nodes, edges, nodesRequired = false, edgesRequired = true, accessors, }) {
+    if (edgesRequired && (!edges || !Array.isArray(edges) || edges.length === 0)) {
+        return "No edges provided. Pass a non-empty array to the edges prop.";
+    }
+    if (nodesRequired && (!nodes || !Array.isArray(nodes) || nodes.length === 0)) {
+        return "No nodes provided. Pass a non-empty array to the nodes prop.";
+    }
+    // Check accessors against first data point
+    if (accessors) {
+        if (nodes && nodes.length > 0) {
+            const sample = nodes[0];
+            if (sample && typeof sample === "object") {
+                for (const [label, accessor] of Object.entries(accessors)) {
+                    if (!accessor)
+                        continue;
+                    if (typeof accessor === "string" && !(accessor in sample)) {
+                        return (`${label} "${accessor}" not found in node data. ` +
+                            `Available fields: ${Object.keys(sample).join(", ")}.`);
+                    }
+                }
+            }
+        }
+    }
+    return null;
+}