@object-ui/plugin-charts 3.3.0 → 3.3.2

package/src/__tests__/ObjectChart.labelResolution.test.ts

@@ -1,329 +0,0 @@
-/**
- * Tests for ObjectChart groupBy value→label resolution.
- *
- * Verifies that resolveGroupByLabels():
- * - Maps select field values to their option labels
- * - Handles string-only options (value === label)
- * - Falls back to humanizeLabel() when no options match
- * - Resolves lookup field IDs to referenced record names
- * - Gracefully handles missing metadata or dataSource errors
- * - Falls back to humanizeLabel() for unknown field types
- */
-
-import { describe, it, expect, vi } from 'vitest';
-import { resolveGroupByLabels, humanizeLabel } from '../ObjectChart';
-
-describe('humanizeLabel', () => {
-  it('should convert snake_case to Title Case', () => {
-    expect(humanizeLabel('closed_won')).toBe('Closed Won');
-  });
-
-  it('should convert kebab-case to Title Case', () => {
-    expect(humanizeLabel('high-priority')).toBe('High Priority');
-  });
-
-  it('should handle single word', () => {
-    expect(humanizeLabel('active')).toBe('Active');
-  });
-
-  it('should handle empty string', () => {
-    expect(humanizeLabel('')).toBe('');
-  });
-});
-
-describe('resolveGroupByLabels', () => {
-  // ---- select fields ----
-
-  it('should map select field values to option labels', async () => {
-    const data = [
-      { stage: 'closed_won', amount: 500 },
-      { stage: 'prospecting', amount: 200 },
-      { stage: 'closed_lost', amount: 100 },
-    ];
-
-    const objectSchema = {
-      fields: {
-        stage: {
-          type: 'select',
-          options: [
-            { value: 'prospecting', label: 'Prospecting' },
-            { value: 'closed_won', label: 'Closed Won' },
-            { value: 'closed_lost', label: 'Closed Lost' },
-          ],
-        },
-      },
-    };
-
-    const result = await resolveGroupByLabels(data, 'stage', objectSchema);
-
-    expect(result).toEqual([
-      { stage: 'Closed Won', amount: 500 },
-      { stage: 'Prospecting', amount: 200 },
-      { stage: 'Closed Lost', amount: 100 },
-    ]);
-  });
-
-  it('should handle string-only options where value equals label', async () => {
-    const data = [
-      { lead_source: 'Web', count: 10 },
-      { lead_source: 'Phone', count: 5 },
-    ];
-
-    const objectSchema = {
-      fields: {
-        lead_source: {
-          type: 'select',
-          options: ['Web', 'Phone', 'Partner'],
-        },
-      },
-    };
-
-    const result = await resolveGroupByLabels(data, 'lead_source', objectSchema);
-
-    expect(result).toEqual([
-      { lead_source: 'Web', count: 10 },
-      { lead_source: 'Phone', count: 5 },
-    ]);
-  });
-
-  it('should humanize unmatched select values', async () => {
-    const data = [
-      { status: 'not_yet_started', count: 3 },
-    ];
-
-    const objectSchema = {
-      fields: {
-        status: {
-          type: 'select',
-          options: [
-            { value: 'active', label: 'Active' },
-          ],
-        },
-      },
-    };
-
-    const result = await resolveGroupByLabels(data, 'status', objectSchema);
-
-    expect(result[0].status).toBe('Not Yet Started');
-  });
-
-  it('should humanize values when select field has empty options', async () => {
-    const data = [
-      { status: 'in_progress', count: 1 },
-    ];
-
-    const objectSchema = {
-      fields: {
-        status: {
-          type: 'select',
-          options: [],
-        },
-      },
-    };
-
-    const result = await resolveGroupByLabels(data, 'status', objectSchema);
-    expect(result[0].status).toBe('In Progress');
-  });
-
-  // ---- lookup fields ----
-
-  it('should resolve lookup field IDs to record names', async () => {
-    const data = [
-      { account: '1', amount: 500 },
-      { account: '2', amount: 300 },
-    ];
-
-    const objectSchema = {
-      fields: {
-        account: {
-          type: 'lookup',
-          reference_to: 'accounts',
-        },
-      },
-    };
-
-    const mockFind = vi.fn().mockResolvedValue([
-      { id: '1', name: 'Acme Corp' },
-      { id: '2', name: 'Globex Inc' },
-    ]);
-
-    const dataSource = { find: mockFind };
-
-    const result = await resolveGroupByLabels(data, 'account', objectSchema, dataSource);
-
-    expect(result).toEqual([
-      { account: 'Acme Corp', amount: 500 },
-      { account: 'Globex Inc', amount: 300 },
-    ]);
-
-    expect(mockFind).toHaveBeenCalledWith('accounts', {
-      $filter: { id: { $in: ['1', '2'] } },
-      $top: 2,
-    });
-  });
-
-  it('should use display_field from metadata for lookup label', async () => {
-    const data = [
-      { project: 'p1', hours: 40 },
-    ];
-
-    const objectSchema = {
-      fields: {
-        project: {
-          type: 'lookup',
-          reference_to: 'projects',
-          display_field: 'title',
-        },
-      },
-    };
-
-    const mockFind = vi.fn().mockResolvedValue([
-      { id: 'p1', title: 'Website Redesign', name: 'PRJ-001' },
-    ]);
-
-    const result = await resolveGroupByLabels(data, 'project', objectSchema, { find: mockFind });
-
-    expect(result[0].project).toBe('Website Redesign');
-  });
-
-  it('should use id_field from metadata for lookup query', async () => {
-    const data = [
-      { owner: 'uid_42', count: 5 },
-    ];
-
-    const objectSchema = {
-      fields: {
-        owner: {
-          type: 'lookup',
-          reference_to: 'users',
-          id_field: 'uid',
-        },
-      },
-    };
-
-    const mockFind = vi.fn().mockResolvedValue([
-      { uid: 'uid_42', name: 'Jane Doe' },
-    ]);
-
-    const result = await resolveGroupByLabels(data, 'owner', objectSchema, { find: mockFind });
-
-    expect(result[0].owner).toBe('Jane Doe');
-    expect(mockFind).toHaveBeenCalledWith('users', {
-      $filter: { uid: { $in: ['uid_42'] } },
-      $top: 1,
-    });
-  });
-
-  it('should handle lookup with reference property (ObjectStack convention)', async () => {
-    const data = [
-      { customer: '10', total: 100 },
-    ];
-
-    const objectSchema = {
-      fields: {
-        customer: {
-          type: 'master_detail',
-          reference: 'customers',
-        },
-      },
-    };
-
-    const mockFind = vi.fn().mockResolvedValue([
-      { id: '10', name: 'Big Client' },
-    ]);
-
-    const result = await resolveGroupByLabels(data, 'customer', objectSchema, { find: mockFind });
-
-    expect(result[0].customer).toBe('Big Client');
-  });
-
-  it('should keep raw values when lookup fetch fails', async () => {
-    const data = [
-      { account: '1', amount: 500 },
-    ];
-
-    const objectSchema = {
-      fields: {
-        account: {
-          type: 'lookup',
-          reference_to: 'accounts',
-        },
-      },
-    };
-
-    const dataSource = {
-      find: vi.fn().mockRejectedValue(new Error('Network error')),
-    };
-
-    const result = await resolveGroupByLabels(data, 'account', objectSchema, dataSource);
-
-    // Should gracefully return original data
-    expect(result[0].account).toBe('1');
-  });
-
-  it('should keep raw values when no dataSource is available for lookup', async () => {
-    const data = [
-      { account: '1', amount: 500 },
-    ];
-
-    const objectSchema = {
-      fields: {
-        account: {
-          type: 'lookup',
-          reference_to: 'accounts',
-        },
-      },
-    };
-
-    const result = await resolveGroupByLabels(data, 'account', objectSchema);
-
-    expect(result[0].account).toBe('1');
-  });
-
-  // ---- fallback / edge cases ----
-
-  it('should humanize values when no field metadata exists', async () => {
-    const data = [
-      { category: 'high_priority', count: 5 },
-    ];
-
-    const objectSchema = { fields: {} };
-
-    const result = await resolveGroupByLabels(data, 'category', objectSchema);
-
-    expect(result[0].category).toBe('High Priority');
-  });
-
-  it('should humanize values for unknown field types', async () => {
-    const data = [
-      { region: 'north_america', revenue: 1000 },
-    ];
-
-    const objectSchema = {
-      fields: {
-        region: { type: 'text' },
-      },
-    };
-
-    const result = await resolveGroupByLabels(data, 'region', objectSchema);
-
-    expect(result[0].region).toBe('North America');
-  });
-
-  it('should return empty array for empty data', async () => {
-    const result = await resolveGroupByLabels([], 'stage', { fields: {} });
-    expect(result).toEqual([]);
-  });
-
-  it('should return data as-is when groupByField is empty', async () => {
-    const data = [{ stage: 'a', count: 1 }];
-    const result = await resolveGroupByLabels(data, '', { fields: {} });
-    expect(result).toEqual(data);
-  });
-
-  it('should handle null objectSchema gracefully', async () => {
-    const data = [{ stage: 'closed_won', count: 1 }];
-    const result = await resolveGroupByLabels(data, 'stage', null);
-    expect(result[0].stage).toBe('Closed Won');
-  });
-});

package/src/index.test.ts

@@ -1,136 +0,0 @@
-/**
- * ObjectUI
- * Copyright (c) 2024-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-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');
-  }, 60000);
-
-  describe('bar-chart component', () => {
-    it('should be registered in ComponentRegistry', () => {
-      const chartBarRenderer = ComponentRegistry.get('bar-chart');
-      expect(chartBarRenderer).toBeDefined();
-    });
-
-    it('should have proper metadata', () => {
-      const config = ComponentRegistry.getConfig('bar-chart');
-      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('bar-chart');
-      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('bar-chart');
-      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('bar-chart');
-      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);
-    });
-  });
-});

package/src/index.tsx

@@ -1,172 +0,0 @@
-/**
- * ObjectUI
- * Copyright (c) 2024-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-import { ComponentRegistry } from '@object-ui/core';
-import { ChartBarRenderer, ChartRenderer } from './ChartRenderer';
-import { ObjectChart } from './ObjectChart';
-
-// Export types for external use
-export type { BarChartSchema } from './types';
-export { ChartBarRenderer, ChartRenderer };
-export { ObjectChart } from './ObjectChart';
-
-// Standard Export Protocol - for manual integration
-export const chartComponents = {
-  'bar-chart': ChartBarRenderer,
-  'chart': ChartRenderer,
-};
-
-// Register the component with the ComponentRegistry
-ComponentRegistry.register(
-  'bar-chart',
-  ChartBarRenderer,
-  {
-    namespace: 'plugin-charts',
-    label: 'Bar Chart',
-    category: 'plugin',
-    inputs: [
-      { name: 'data', type: 'array', label: 'Data', required: true },
-      { name: 'dataKey', type: 'string', label: 'Data Key', defaultValue: 'value' },
-      { name: 'xAxisKey', type: 'string', label: 'X-Axis Key', defaultValue: 'name' },
-      { name: 'height', type: 'number', label: 'Height', defaultValue: 400 },
-      { name: 'color', type: 'color', label: 'Color', defaultValue: '#8884d8' },
-    ],
-    defaultProps: {
-      data: [
-        { name: 'Jan', value: 400 },
-        { name: 'Feb', value: 300 },
-        { name: 'Mar', value: 600 },
-        { name: 'Apr', value: 800 },
-        { name: 'May', value: 500 },
-      ],
-      dataKey: 'value',
-      xAxisKey: 'name',
-      height: 400,
-      color: '#8884d8',
-    },
-  }
-);
-// Alias for generic view
-ComponentRegistry.register('chart', ObjectChart, {
-  namespace: 'view',
-  category: 'view',
-  label: 'Chart',
-  inputs: [
-    { name: 'objectName', type: 'string', label: 'Object Name', required: true },
-    { name: 'type', type: 'string', label: 'Chart Type' },
-    { name: 'categoryField', type: 'string', label: 'Category Field' },
-    { name: 'valueField', type: 'string', label: 'Value Field' },
-  ]
-});
-// Register the advanced chart component
-ComponentRegistry.register(
-  'chart',
-  ChartRenderer,
-  {
-    namespace: 'plugin-charts',
-    label: 'Chart',
-    category: 'plugin',
-    inputs: [
-      { 
-        name: 'chartType', 
-        type: 'enum', 
-        label: 'Chart Type',
-        enum: [
-          { label: 'Bar', value: 'bar' },
-          { label: 'Line', value: 'line' },
-          { label: 'Area', value: 'area' },
-          { label: 'Pie', value: 'pie' },
-          { label: 'Donut', value: 'donut' },
-          { label: 'Radar', value: 'radar' },
-          { label: 'Scatter', value: 'scatter' }
-        ],
-        defaultValue: 'bar'
-      },
-      { name: 'data', type: 'code', label: 'Data (JSON)', required: true },
-      { name: 'config', type: 'code', label: 'Config (JSON)' },
-      { name: 'xAxisKey', type: 'string', label: 'X Axis Key', defaultValue: 'name' },
-      { name: 'series', type: 'code', label: 'Series (JSON Array)', required: true },
-      { name: 'className', type: 'string', label: 'CSS Class' }
-    ],
-    defaultProps: {
-      chartType: 'bar',
-      data: [
-        { name: 'Jan', sales: 400, revenue: 240 },
-        { name: 'Feb', sales: 300, revenue: 139 },
-        { name: 'Mar', sales: 600, revenue: 380 },
-        { name: 'Apr', sales: 800, revenue: 430 },
-        { name: 'May', sales: 500, revenue: 220 },
-      ],
-      config: {
-        sales: { label: 'Sales', color: '#8884d8' },
-        revenue: { label: 'Revenue', color: '#82ca9d' }
-      },
-      xAxisKey: 'name',
-      series: [
-        { dataKey: 'sales' },
-        { dataKey: 'revenue' }
-      ]
-    }
-  }
-);
-
-// Alias for CRM App compatibility
-ComponentRegistry.register(
-  'chart:bar',
-  ChartRenderer, 
-  {
-    namespace: 'plugin-charts',
-    label: 'Bar Chart (Alias)',
-    category: 'plugin',
-    defaultProps: { chartType: 'bar' }
-  }
-);
-
-ComponentRegistry.register(
-  'pie-chart',
-  ChartRenderer,
-  {
-    namespace: 'plugin-charts',
-    label: 'Pie Chart',
-    category: 'plugin',
-    defaultProps: { chartType: 'pie' }
-  }
-);
-
-ComponentRegistry.register(
-  'donut-chart',
-  ChartRenderer,
-  {
-    namespace: 'plugin-charts',
-    label: 'Donut Chart',
-    category: 'plugin',
-    defaultProps: { chartType: 'donut' }
-  }
-);
-
-ComponentRegistry.register(
-  'radar-chart',
-  ChartRenderer,
-  {
-    namespace: 'plugin-charts',
-    label: 'Radar Chart',
-    category: 'plugin',
-    defaultProps: { chartType: 'radar' }
-  }
-);
-
-ComponentRegistry.register(
-  'scatter-chart',
-  ChartRenderer,
-  {
-    namespace: 'plugin-charts',
-    label: 'Scatter Chart',
-    category: 'plugin',
-    defaultProps: { chartType: 'scatter' }
-  }
-);

package/src/types.ts

@@ -1,68 +0,0 @@
-/**
- * ObjectUI
- * Copyright (c) 2024-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-/**
- * TypeScript type definitions for @object-ui/plugin-charts
- * 
- * These types can be imported by applications using this plugin
- * to get full TypeScript support for chart schemas.
- */
-
-import type { BaseSchema } from '@object-ui/types';
-
-/**
- * Bar Chart component schema.
- * Renders a bar chart using Recharts library.
- * 
- * @example
- * ```typescript
- * import type { BarChartSchema } from '@object-ui/plugin-charts';
- * 
- * const chartSchema: BarChartSchema = {
- *   type: 'bar-chart',
- *   data: [
- *     { name: 'Jan', value: 400 },
- *     { name: 'Feb', value: 300 }
- *   ],
- *   dataKey: 'value',
- *   xAxisKey: 'name'
- * }
- * ```
- */
-export interface BarChartSchema extends BaseSchema {
-  type: 'bar-chart';
-  
-  /**
-   * Array of data points to display in the chart.
-   */
-  data?: Array<Record<string, any>>;
-  
-  /**
-   * Key in the data object for the Y-axis values.
-   * @default 'value'
-   */
-  dataKey?: string;
-  
-  /**
-   * Key in the data object for the X-axis labels.
-   * @default 'name'
-   */
-  xAxisKey?: string;
-  
-  /**
-   * Height of the chart in pixels.
-   * @default 400
-   */
-  height?: number;
-  
-  /**
-   * Color of the bars.
-   * @default '#8884d8'
-   */
-  color?: string;
-}