@object-ui/plugin-charts 0.3.0

package/src/ChartContainerImpl.tsx

@@ -0,0 +1,345 @@
+"use client"
+
+import * as React from "react"
+import { ResponsiveContainer, Tooltip, Legend } from "recharts"
+
+// Utility function to merge class names (inline to avoid external dependency)
+const cn = (...classes: (string | undefined)[]) => classes.filter(Boolean).join(' ')
+
+// Format: { THEME_NAME: CSS_SELECTOR }
+const THEMES = { light: "", dark: ".dark" } as const
+
+export type ChartConfig = {
+  [k in string]: {
+    label?: React.ReactNode
+    icon?: React.ComponentType
+  } & (
+    | { color?: string; theme?: never }
+    | { color?: never; theme: Record<keyof typeof THEMES, string> }
+  )
+}
+
+type ChartContextProps = {
+  config: ChartConfig
+}
+
+const ChartContext = React.createContext<ChartContextProps | null>(null)
+
+function useChart() {
+  const context = React.useContext(ChartContext)
+
+  if (!context) {
+    throw new Error("useChart must be used within a <ChartContainer />")
+  }
+
+  return context
+}
+
+function ChartContainer({
+  id,
+  className,
+  children,
+  config,
+  ...props
+}: React.ComponentProps<"div"> & {
+  config: ChartConfig
+  children: React.ComponentProps<
+    typeof ResponsiveContainer
+  >["children"]
+}) {
+  const uniqueId = React.useId()
+  const chartId = `chart-${id || uniqueId.replace(/:/g, "")}`
+
+  return (
+    <ChartContext.Provider value={{ config }}>
+      <div
+        data-slot="chart"
+        data-chart={chartId}
+        className={cn(
+          "flex w-full h-[350px] justify-center text-xs [&_.recharts-cartesian-axis-tick_text]:fill-muted-foreground",
+          className
+        )}
+        {...props}
+      >
+        <ChartStyle id={chartId} config={config} />
+        <ResponsiveContainer width="100%" height="100%">
+          {children}
+        </ResponsiveContainer>
+      </div>
+    </ChartContext.Provider>
+  )
+}
+
+const ChartStyle = ({ id, config }: { id: string; config: ChartConfig }) => {
+  const colorConfig = Object.entries(config).filter(
+    ([, config]) => config.theme || config.color
+  )
+
+  if (!colorConfig.length) {
+    return null
+  }
+
+  return (
+    <style
+      dangerouslySetInnerHTML={{
+        __html: Object.entries(THEMES)
+          .map(
+            ([theme, prefix]) => `
+${prefix} [data-chart=${id}] {
+${colorConfig
+  .map(([key, itemConfig]) => {
+    const color =
+      itemConfig.theme?.[theme as keyof typeof itemConfig.theme] ||
+      itemConfig.color
+    return color ? `  --color-${key}: ${color};` : null
+  })
+  .join("\n")}
+}
+`
+          )
+          .join("\n"),
+      }}
+    />
+  )
+}
+
+const ChartTooltip = Tooltip
+
+function ChartTooltipContent({
+  active,
+  payload,
+  className,
+  indicator = "dot",
+  hideLabel = false,
+  hideIndicator = false,
+  label,
+  labelFormatter,
+  labelClassName,
+  formatter,
+  color,
+  nameKey,
+  labelKey,
+}: any) {
+  const { config } = useChart()
+
+  const tooltipLabel = React.useMemo(() => {
+    if (hideLabel || !payload?.length) {
+      return null
+    }
+
+    const [item] = payload
+    const key = `${labelKey || item?.dataKey || item?.name || "value"}`
+    const itemConfig = getPayloadConfigFromPayload(config, item, key)
+    const value =
+      !labelKey && typeof label === "string"
+        ? config[label as keyof typeof config]?.label || label
+        : itemConfig?.label
+
+    if (labelFormatter) {
+      return (
+        <div className={cn("font-medium", labelClassName)}>
+          {labelFormatter(value, payload)}
+        </div>
+      )
+    }
+
+    if (!value) {
+      return null
+    }
+
+    return <div className={cn("font-medium", labelClassName)}>{value}</div>
+  }, [
+    label,
+    labelFormatter,
+    payload,
+    hideLabel,
+    labelClassName,
+    config,
+    labelKey,
+  ])
+
+  if (!active || !payload?.length) {
+    return null
+  }
+
+  const nestLabel = payload.length === 1 && indicator !== "dot"
+
+  return (
+    <div
+      className={cn(
+        "border-border/50 bg-background grid min-w-[8rem] items-start gap-1.5 rounded-lg border px-2.5 py-1.5 text-xs shadow-xl",
+        className
+      )}
+    >
+      {!nestLabel ? tooltipLabel : null}
+      <div className="grid gap-1.5">
+        {payload
+          .filter((item: any) => item.type !== "none")
+          .map((item: any, index: number) => {
+            const key = `${nameKey || item.name || item.dataKey || "value"}`
+            const itemConfig = getPayloadConfigFromPayload(config, item, key)
+            const indicatorColor = color || item.payload.fill || item.color
+
+            return (
+              <div
+                key={item.dataKey}
+                className={cn(
+                  "[&>svg]:text-muted-foreground flex w-full flex-wrap items-stretch gap-2 [&>svg]:h-2.5 [&>svg]:w-2.5",
+                  indicator === "dot" ? "items-center" : ""
+                )}
+              >
+                {formatter && item?.value !== undefined && item.name ? (
+                  formatter(item.value, item.name, item, index, item.payload)
+                ) : (
+                  <>
+                    {itemConfig?.icon ? (
+                      <itemConfig.icon />
+                    ) : (
+                      !hideIndicator && (
+                        <div
+                          className={cn(
+                            "shrink-0 rounded-[2px] border-(--color-border) bg-(--color-bg)",
+                            indicator === "dot" ? "h-2.5 w-2.5" : "",
+                            indicator === "line" ? "w-1" : "",
+                            indicator === "dashed" ? "w-0 border-[1.5px] border-dashed bg-transparent" : "",
+                            (nestLabel && indicator === "dashed") ? "my-0.5" : "",
+                          )}
+                          style={
+
+                            {
+                              "--color-bg": indicatorColor,
+                              "--color-border": indicatorColor,
+                            } as React.CSSProperties
+                          }
+                        />
+                      )
+                    )}
+                    <div
+                      className={cn(
+                        "flex flex-1 justify-between leading-none",
+                        nestLabel ? "items-end" : "items-center"
+                      )}
+                    >
+                      <div className="grid gap-1.5">
+                        {nestLabel ? tooltipLabel : null}
+                        <span className="text-muted-foreground">
+                          {itemConfig?.label || item.name}
+                        </span>
+                      </div>
+                      {item.value && (
+                        <span className="text-foreground font-mono font-medium tabular-nums">
+                          {item.value.toLocaleString()}
+                        </span>
+                      )}
+                    </div>
+                  </>
+                )}
+              </div>
+            )
+          })}
+      </div>
+    </div>
+  )
+}
+
+const ChartLegend = Legend
+
+function ChartLegendContent({
+  className,
+  hideIcon = false,
+  payload,
+  verticalAlign = "bottom",
+  nameKey,
+}: any) {
+  const { config } = useChart()
+
+  if (!payload?.length) {
+    return null
+  }
+
+  return (
+    <div
+      className={cn(
+        "flex items-center justify-center gap-4",
+        verticalAlign === "top" ? "pb-3" : "pt-3",
+        className
+      )}
+    >
+      {payload
+        .filter((item: any) => item.type !== "none")
+        .map((item: any) => {
+          const key = `${nameKey || item.dataKey || "value"}`
+          const itemConfig = getPayloadConfigFromPayload(config, item, key)
+
+          return (
+            <div
+              key={item.value}
+              className={cn(
+                "[&>svg]:text-muted-foreground flex items-center gap-1.5 [&>svg]:h-3 [&>svg]:w-3"
+              )}
+            >
+              {itemConfig?.icon && !hideIcon ? (
+                <itemConfig.icon />
+              ) : (
+                <div
+                  className="h-2 w-2 shrink-0 rounded-[2px]"
+                  style={{
+                    backgroundColor: item.color,
+                  }}
+                />
+              )}
+              {itemConfig?.label}
+            </div>
+          )
+        })}
+    </div>
+  )
+}
+
+// Helper to extract item config from a payload.
+function getPayloadConfigFromPayload(
+  config: ChartConfig,
+  payload: unknown,
+  key: string
+) {
+  if (typeof payload !== "object" || payload === null) {
+    return undefined
+  }
+
+  const payloadPayload =
+    "payload" in payload &&
+    typeof payload.payload === "object" &&
+    payload.payload !== null
+      ? payload.payload
+      : undefined
+
+  let configLabelKey: string = key
+
+  if (
+    key in payload &&
+    typeof payload[key as keyof typeof payload] === "string"
+  ) {
+    configLabelKey = payload[key as keyof typeof payload] as string
+  } else if (
+    payloadPayload &&
+    key in payloadPayload &&
+    typeof payloadPayload[key as keyof typeof payloadPayload] === "string"
+  ) {
+    configLabelKey = payloadPayload[
+      key as keyof typeof payloadPayload
+    ] as string
+  }
+
+  return configLabelKey in config
+    ? config[configLabelKey]
+    : config[key as keyof typeof config]
+}
+
+export {
+  ChartContainer,
+  ChartTooltip,
+  ChartTooltipContent,
+  ChartLegend,
+  ChartLegendContent,
+  ChartStyle,
+}

package/src/ChartImpl.tsx

@@ -0,0 +1,83 @@
+import { BarChart, Bar, XAxis, YAxis, CartesianGrid, Tooltip, Legend, ResponsiveContainer } from 'recharts';
+
+export interface ChartImplProps {
+  data?: Array<Record<string, any>>;
+  dataKey?: string;
+  xAxisKey?: string;
+  height?: number;
+  className?: string;
+  color?: string;
+}
+
+/**
+ * ChartImpl - The heavy implementation that imports Recharts
+ * This component is lazy-loaded to avoid including Recharts in the initial bundle
+ */
+export default function ChartImpl({
+  data = [],
+  dataKey = 'value',
+  xAxisKey = 'name',
+  height = 400,
+  className = '',
+  // Default to standard primary color
+  color = 'hsl(var(--primary))',
+}: ChartImplProps) {
+  return (
+    <div className={`p-4 rounded-xl border border-border bg-card/40 backdrop-blur-sm shadow-lg shadow-background/5 ${className}`}>
+      <ResponsiveContainer width="100%" height={height}>
+        <BarChart data={data} margin={{ top: 20, right: 30, left: 20, bottom: 5 }}>
+          <defs>
+            <linearGradient id="barGradient" x1="0" y1="0" x2="0" y2="1">
+              <stop offset="0%" stopColor={color} stopOpacity={1} />
+              <stop offset="90%" stopColor={color} stopOpacity={0.6} />
+              <stop offset="100%" stopColor={color} stopOpacity={0.3} />
+            </linearGradient>
+            <filter id="glow" height="130%">
+              <feGaussianBlur in="SourceAlpha" stdDeviation="3" result="blur" />
+              <feOffset in="blur" dx="0" dy="0" result="offsetBlur" />
+              <feFlood floodColor={color} floodOpacity="0.5" result="offsetColor" />
+              <feComposite in="offsetColor" in2="offsetBlur" operator="in" result="offsetBlur" />
+              <feMerge>
+                <feMergeNode in="offsetBlur" />
+                <feMergeNode in="SourceGraphic" />
+              </feMerge>
+            </filter>
+          </defs>
+          <CartesianGrid strokeDasharray="3 3" stroke="hsl(var(--border))" vertical={false} />
+          <XAxis 
+            dataKey={xAxisKey} 
+            tick={{ fill: 'hsl(var(--muted-foreground))', fontSize: 12, fontFamily: 'monospace' }} 
+            tickLine={false}
+            axisLine={{ stroke: 'hsl(var(--border))' }}
+            dy={10}
+          />
+          <YAxis 
+            tick={{ fill: 'hsl(var(--muted-foreground))', fontSize: 12, fontFamily: 'monospace' }} 
+            tickLine={false}
+            axisLine={false}
+          />
+          <Tooltip 
+            cursor={{ fill: 'hsl(var(--muted))', opacity: 0.2 }}
+            contentStyle={{ 
+              backgroundColor: 'hsl(var(--popover))', 
+              borderColor: 'hsl(var(--border))', 
+              color: 'hsl(var(--popover-foreground))',
+              borderRadius: '8px',
+              fontFamily: 'monospace',
+              boxShadow: '0 4px 6px -1px rgb(0 0 0 / 0.1)'
+            }}
+            itemStyle={{ color: 'hsl(var(--primary))' }}
+          />
+          <Legend wrapperStyle={{ paddingTop: '20px', fontFamily: 'monospace' }} />
+          <Bar 
+            dataKey={dataKey} 
+            fill="url(#barGradient)" 
+            radius={[4, 4, 0, 0]}
+            filter="url(#glow)"
+            animationDuration={1500}
+          />
+        </BarChart>
+      </ResponsiveContainer>
+    </div>
+  );
+}

package/src/index.test.ts

@@ -0,0 +1,128 @@
+import { describe, it, expect, beforeAll } from 'vitest';
+import { ComponentRegistry } from '@object-ui/core';
+
+describe('Plugin Charts', () => {
+  // Import all renderers to register them
+  beforeAll(async () => {
+    await import('./index');
+  });
+
+  describe('chart-bar component', () => {
+    it('should be registered in ComponentRegistry', () => {
+      const chartBarRenderer = ComponentRegistry.get('chart-bar');
+      expect(chartBarRenderer).toBeDefined();
+    });
+
+    it('should have proper metadata', () => {
+      const config = ComponentRegistry.getConfig('chart-bar');
+      expect(config).toBeDefined();
+      expect(config?.label).toBe('Bar Chart');
+      expect(config?.category).toBe('plugin');
+      expect(config?.inputs).toBeDefined();
+      expect(config?.defaultProps).toBeDefined();
+    });
+
+    it('should have expected inputs', () => {
+      const config = ComponentRegistry.getConfig('chart-bar');
+      const inputNames = config?.inputs?.map((input: any) => input.name) || [];
+      
+      expect(inputNames).toContain('data');
+      expect(inputNames).toContain('dataKey');
+      expect(inputNames).toContain('xAxisKey');
+      expect(inputNames).toContain('height');
+      expect(inputNames).toContain('color');
+    });
+
+    it('should have data as required input', () => {
+      const config = ComponentRegistry.getConfig('chart-bar');
+      const dataInput = config?.inputs?.find((input: any) => input.name === 'data');
+      
+      expect(dataInput).toBeDefined();
+      expect(dataInput?.required).toBe(true);
+      expect(dataInput?.type).toBe('array');
+    });
+
+    it('should have sensible default props', () => {
+      const config = ComponentRegistry.getConfig('chart-bar');
+      const defaults = config?.defaultProps;
+      
+      expect(defaults).toBeDefined();
+      expect(defaults?.dataKey).toBe('value');
+      expect(defaults?.xAxisKey).toBe('name');
+      expect(defaults?.height).toBe(400);
+      expect(defaults?.color).toBe('#8884d8');
+      expect(defaults?.data).toBeDefined();
+      expect(Array.isArray(defaults?.data)).toBe(true);
+      expect(defaults?.data.length).toBeGreaterThan(0);
+    });
+  });
+
+  describe('chart (advanced) component', () => {
+    it('should be registered in ComponentRegistry', () => {
+      const chartRenderer = ComponentRegistry.get('chart');
+      expect(chartRenderer).toBeDefined();
+    });
+
+    it('should have proper metadata', () => {
+      const config = ComponentRegistry.getConfig('chart');
+      expect(config).toBeDefined();
+      expect(config?.label).toBe('Chart');
+      expect(config?.category).toBe('plugin');
+      expect(config?.inputs).toBeDefined();
+      expect(config?.defaultProps).toBeDefined();
+    });
+
+    it('should have expected inputs', () => {
+      const config = ComponentRegistry.getConfig('chart');
+      const inputNames = config?.inputs?.map((input: any) => input.name) || [];
+      
+      expect(inputNames).toContain('chartType');
+      expect(inputNames).toContain('data');
+      expect(inputNames).toContain('config');
+      expect(inputNames).toContain('xAxisKey');
+      expect(inputNames).toContain('series');
+      expect(inputNames).toContain('className');
+    });
+
+    it('should have chartType as enum input', () => {
+      const config = ComponentRegistry.getConfig('chart');
+      const chartTypeInput = config?.inputs?.find((input: any) => input.name === 'chartType');
+      
+      expect(chartTypeInput).toBeDefined();
+      expect(chartTypeInput?.type).toBe('enum');
+      expect(chartTypeInput?.enum).toBeDefined();
+      expect(Array.isArray(chartTypeInput?.enum)).toBe(true);
+      
+      const enumValues = chartTypeInput?.enum?.map((e: any) => e.value) || [];
+      expect(enumValues).toContain('bar');
+      expect(enumValues).toContain('line');
+      expect(enumValues).toContain('area');
+    });
+
+    it('should have data and series as required inputs', () => {
+      const config = ComponentRegistry.getConfig('chart');
+      const dataInput = config?.inputs?.find((input: any) => input.name === 'data');
+      const seriesInput = config?.inputs?.find((input: any) => input.name === 'series');
+      
+      expect(dataInput?.required).toBe(true);
+      expect(seriesInput?.required).toBe(true);
+    });
+
+    it('should have sensible default props', () => {
+      const config = ComponentRegistry.getConfig('chart');
+      const defaults = config?.defaultProps;
+      
+      expect(defaults).toBeDefined();
+      expect(defaults?.chartType).toBe('bar');
+      expect(defaults?.xAxisKey).toBe('name');
+      expect(defaults?.data).toBeDefined();
+      expect(Array.isArray(defaults?.data)).toBe(true);
+      expect(defaults?.data.length).toBeGreaterThan(0);
+      expect(defaults?.config).toBeDefined();
+      expect(typeof defaults?.config).toBe('object');
+      expect(defaults?.series).toBeDefined();
+      expect(Array.isArray(defaults?.series)).toBe(true);
+      expect(defaults?.series.length).toBeGreaterThan(0);
+    });
+  });
+});