@object-ui/react 3.1.5 → 3.3.1

package/src/hooks/__tests__/usePerformanceBudget.test.ts

@@ -1,157 +0,0 @@
-/**
- * Tests for usePerformanceBudget hook
- */
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { renderHook, act } from '@testing-library/react';
-import { usePerformanceBudget } from '../usePerformanceBudget';
-
-describe('usePerformanceBudget', () => {
-  beforeEach(() => {
-    vi.useFakeTimers();
-  });
-
-  afterEach(() => {
-    vi.useRealTimers();
-    vi.restoreAllMocks();
-  });
-
-  it('returns default budget config when no config provided', () => {
-    const { result } = renderHook(() => usePerformanceBudget());
-
-    // Default snapshot values
-    expect(result.current.snapshot).toEqual({
-      lcp: null,
-      fcp: null,
-      memoryMB: null,
-    });
-    expect(result.current.clearViolations).toBeTypeOf('function');
-    expect(result.current.checkMetric).toBeTypeOf('function');
-    expect(result.current.trackRender).toBeTypeOf('function');
-  });
-
-  it('isWithinBudget is true initially (no violations)', () => {
-    const { result } = renderHook(() => usePerformanceBudget());
-
-    expect(result.current.isWithinBudget).toBe(true);
-    expect(result.current.violations).toEqual([]);
-  });
-
-  it('trackRender records a violation when render exceeds maxRenderTime', () => {
-    const { result } = renderHook(() =>
-      usePerformanceBudget({ maxRenderTime: 16, warnOnViolation: false }),
-    );
-
-    act(() => {
-      result.current.trackRender(50);
-    });
-
-    expect(result.current.violations).toHaveLength(1);
-    expect(result.current.violations[0].metric).toBe('renderTime');
-    expect(result.current.violations[0].actual).toBe(50);
-    expect(result.current.violations[0].budget).toBe(16);
-    expect(result.current.isWithinBudget).toBe(false);
-  });
-
-  it('trackRender does NOT record when render is within budget', () => {
-    const { result } = renderHook(() =>
-      usePerformanceBudget({ maxRenderTime: 16, warnOnViolation: false }),
-    );
-
-    let withinBudget: boolean = false;
-    act(() => {
-      withinBudget = result.current.trackRender(10);
-    });
-
-    expect(withinBudget).toBe(true);
-    expect(result.current.violations).toHaveLength(0);
-    expect(result.current.isWithinBudget).toBe(true);
-  });
-
-  it('checkMetric returns false for metrics exceeding budget', () => {
-    const { result } = renderHook(() =>
-      usePerformanceBudget({ maxLCP: 600, warnOnViolation: false }),
-    );
-
-    let withinBudget: boolean = true;
-    act(() => {
-      withinBudget = result.current.checkMetric('lcp', 800);
-    });
-
-    expect(withinBudget).toBe(false);
-    expect(result.current.violations).toHaveLength(1);
-    expect(result.current.violations[0].metric).toBe('lcp');
-  });
-
-  it('checkMetric returns true for metrics within budget', () => {
-    const { result } = renderHook(() =>
-      usePerformanceBudget({ maxLCP: 600, warnOnViolation: false }),
-    );
-
-    let withinBudget: boolean = false;
-    act(() => {
-      withinBudget = result.current.checkMetric('lcp', 400);
-    });
-
-    expect(withinBudget).toBe(true);
-    expect(result.current.violations).toHaveLength(0);
-  });
-
-  it('clearViolations removes all violations', () => {
-    const { result } = renderHook(() =>
-      usePerformanceBudget({ maxRenderTime: 16, warnOnViolation: false }),
-    );
-
-    act(() => {
-      result.current.trackRender(50);
-    });
-    expect(result.current.violations).toHaveLength(1);
-
-    act(() => {
-      result.current.clearViolations();
-    });
-
-    expect(result.current.violations).toHaveLength(0);
-    expect(result.current.isWithinBudget).toBe(true);
-  });
-
-  it('deduplication: same metric type only recorded once', () => {
-    const { result } = renderHook(() =>
-      usePerformanceBudget({ maxRenderTime: 16, warnOnViolation: false }),
-    );
-
-    act(() => {
-      result.current.trackRender(50);
-    });
-    act(() => {
-      result.current.trackRender(100);
-    });
-
-    // Only one violation for 'renderTime' due to deduplication
-    expect(result.current.violations).toHaveLength(1);
-    expect(result.current.violations[0].metric).toBe('renderTime');
-  });
-
-  it('onViolation callback is called on budget violation', () => {
-    const onViolation = vi.fn();
-    const { result } = renderHook(() =>
-      usePerformanceBudget({
-        maxRenderTime: 16,
-        warnOnViolation: false,
-        onViolation,
-      }),
-    );
-
-    act(() => {
-      result.current.trackRender(50);
-    });
-
-    expect(onViolation).toHaveBeenCalledTimes(1);
-    expect(onViolation).toHaveBeenCalledWith(
-      expect.objectContaining({
-        metric: 'renderTime',
-        budget: 16,
-        actual: 50,
-      }),
-    );
-  });
-});

package/src/hooks/__tests__/useReducedMotion.test.ts

@@ -1,104 +0,0 @@
-/**
- * Tests for useReducedMotion hook
- */
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { renderHook, act } from '@testing-library/react';
-import { useReducedMotion } from '../useReducedMotion';
-
-describe('useReducedMotion', () => {
-  let originalMatchMedia: typeof window.matchMedia;
-  let listeners: Map<string, ((event: MediaQueryListEvent) => void)[]>;
-
-  beforeEach(() => {
-    originalMatchMedia = window.matchMedia;
-    listeners = new Map();
-
-    window.matchMedia = vi.fn((query: string) => {
-      const mediaQueryList = {
-        matches: false,
-        media: query,
-        onchange: null,
-        addEventListener: vi.fn((event: string, handler: (event: MediaQueryListEvent) => void) => {
-          const key = `${query}:${event}`;
-          if (!listeners.has(key)) {
-            listeners.set(key, []);
-          }
-          listeners.get(key)!.push(handler);
-        }),
-        removeEventListener: vi.fn(),
-        addListener: vi.fn(),
-        removeListener: vi.fn(),
-        dispatchEvent: vi.fn(),
-      } as unknown as MediaQueryList;
-      return mediaQueryList;
-    });
-  });
-
-  afterEach(() => {
-    window.matchMedia = originalMatchMedia;
-    listeners.clear();
-  });
-
-  it('returns false when prefers-reduced-motion is not set', () => {
-    const { result } = renderHook(() => useReducedMotion());
-    expect(result.current).toBe(false);
-  });
-
-  it('returns true when prefers-reduced-motion is set', () => {
-    window.matchMedia = vi.fn((query: string) => ({
-      matches: true,
-      media: query,
-      onchange: null,
-      addEventListener: vi.fn(),
-      removeEventListener: vi.fn(),
-      addListener: vi.fn(),
-      removeListener: vi.fn(),
-      dispatchEvent: vi.fn(),
-    })) as unknown as typeof window.matchMedia;
-
-    const { result } = renderHook(() => useReducedMotion());
-    expect(result.current).toBe(true);
-  });
-
-  it('registers a change event listener', () => {
-    renderHook(() => useReducedMotion());
-
-    const key = '(prefers-reduced-motion: reduce):change';
-    expect(listeners.has(key)).toBe(true);
-    expect(listeners.get(key)!.length).toBe(1);
-  });
-
-  it('updates when media query changes', () => {
-    const { result } = renderHook(() => useReducedMotion());
-
-    expect(result.current).toBe(false);
-
-    const key = '(prefers-reduced-motion: reduce):change';
-    const handler = listeners.get(key)![0];
-
-    act(() => {
-      handler({ matches: true } as MediaQueryListEvent);
-    });
-
-    expect(result.current).toBe(true);
-  });
-
-  it('cleans up event listener on unmount', () => {
-    const removeEventListener = vi.fn();
-    window.matchMedia = vi.fn((query: string) => ({
-      matches: false,
-      media: query,
-      onchange: null,
-      addEventListener: vi.fn(),
-      removeEventListener,
-      addListener: vi.fn(),
-      removeListener: vi.fn(),
-      dispatchEvent: vi.fn(),
-    })) as unknown as typeof window.matchMedia;
-
-    const { unmount } = renderHook(() => useReducedMotion());
-    unmount();
-
-    expect(removeEventListener).toHaveBeenCalledWith('change', expect.any(Function));
-  });
-});

package/src/hooks/__tests__/useSchemaPersistence.test.ts

@@ -1,220 +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, vi, beforeEach, afterEach } from 'vitest';
-import { renderHook, act } from '@testing-library/react';
-import {
-  useSchemaPersistence,
-  createLocalStorageAdapter,
-} from '../useSchemaPersistence';
-import type { SchemaPersistenceAdapter } from '../useSchemaPersistence';
-
-// Mock localStorage
-const localStorageMock = (() => {
-  let store: Record<string, string> = {};
-  return {
-    getItem: (key: string) => store[key] ?? null,
-    setItem: (key: string, value: string) => { store[key] = value; },
-    removeItem: (key: string) => { delete store[key]; },
-    clear: () => { store = {}; },
-  };
-})();
-
-Object.defineProperty(window, 'localStorage', { value: localStorageMock });
-
-describe('useSchemaPersistence', () => {
-  beforeEach(() => {
-    localStorageMock.clear();
-  });
-
-  it('should initialize with default state', () => {
-    const { result } = renderHook(() => useSchemaPersistence());
-    expect(result.current.loading).toBe(false);
-    expect(result.current.error).toBeNull();
-    expect(result.current.isDirty).toBe(false);
-    expect(result.current.lastSavedAt).toBeNull();
-  });
-
-  it('should save and load a schema with default localStorage adapter', async () => {
-    const { result } = renderHook(() => useSchemaPersistence());
-    const testSchema = { type: 'page', title: 'My Page', regions: [] };
-
-    let savedId: string | null = null;
-    await act(async () => {
-      savedId = await result.current.save('test-page', testSchema);
-    });
-
-    expect(savedId).toBe('test-page');
-    expect(result.current.isDirty).toBe(false);
-    expect(result.current.lastSavedAt).not.toBeNull();
-
-    let loaded: Record<string, unknown> | null = null;
-    await act(async () => {
-      loaded = await result.current.load('test-page');
-    });
-
-    expect(loaded).toEqual(testSchema);
-  });
-
-  it('should list saved schemas', async () => {
-    const { result } = renderHook(() => useSchemaPersistence());
-
-    await act(async () => {
-      await result.current.save('schema-1', { type: 'page' });
-      await result.current.save('schema-2', { type: 'form' });
-    });
-
-    let items: Array<{ id: string }> = [];
-    await act(async () => {
-      items = await result.current.list();
-    });
-
-    expect(items).toHaveLength(2);
-    expect(items.map((i) => i.id)).toEqual(['schema-1', 'schema-2']);
-  });
-
-  it('should delete a schema', async () => {
-    const { result } = renderHook(() => useSchemaPersistence());
-
-    await act(async () => {
-      await result.current.save('to-delete', { type: 'grid' });
-    });
-
-    let success = false;
-    await act(async () => {
-      success = await result.current.remove('to-delete');
-    });
-
-    expect(success).toBe(true);
-
-    let loaded: Record<string, unknown> | null = null;
-    await act(async () => {
-      loaded = await result.current.load('to-delete');
-    });
-
-    expect(loaded).toBeNull();
-  });
-
-  it('should track dirty state', () => {
-    const { result } = renderHook(() => useSchemaPersistence());
-
-    expect(result.current.isDirty).toBe(false);
-
-    act(() => {
-      result.current.markDirty();
-    });
-
-    expect(result.current.isDirty).toBe(true);
-  });
-
-  it('should clear dirty state after save', async () => {
-    const { result } = renderHook(() => useSchemaPersistence());
-
-    act(() => {
-      result.current.markDirty();
-    });
-    expect(result.current.isDirty).toBe(true);
-
-    await act(async () => {
-      await result.current.save('test', { type: 'page' });
-    });
-    expect(result.current.isDirty).toBe(false);
-  });
-
-  it('should handle save errors gracefully', async () => {
-    const failingAdapter: SchemaPersistenceAdapter = {
-      save: () => Promise.reject(new Error('Network error')),
-      load: () => Promise.resolve(null),
-    };
-
-    const { result } = renderHook(() => useSchemaPersistence(failingAdapter));
-
-    await act(async () => {
-      await result.current.save('test', { type: 'page' });
-    });
-
-    expect(result.current.error).not.toBeNull();
-    expect(result.current.error?.message).toBe('Network error');
-  });
-
-  it('should clear errors', async () => {
-    const failingAdapter: SchemaPersistenceAdapter = {
-      save: () => Promise.reject(new Error('fail')),
-      load: () => Promise.resolve(null),
-    };
-
-    const { result } = renderHook(() => useSchemaPersistence(failingAdapter));
-
-    await act(async () => {
-      await result.current.save('test', { type: 'page' });
-    });
-    expect(result.current.error).not.toBeNull();
-
-    act(() => {
-      result.current.clearError();
-    });
-    expect(result.current.error).toBeNull();
-  });
-
-  it('should work with custom adapter', async () => {
-    const mockStore: Record<string, Record<string, unknown>> = {};
-    const customAdapter: SchemaPersistenceAdapter = {
-      save: async (id, schema) => { mockStore[id] = schema; return id; },
-      load: async (id) => mockStore[id] ?? null,
-      list: async () => Object.keys(mockStore).map((id) => ({ id })),
-      delete: async (id) => { delete mockStore[id]; },
-    };
-
-    const { result } = renderHook(() => useSchemaPersistence(customAdapter));
-
-    await act(async () => {
-      await result.current.save('custom-1', { type: 'dashboard' });
-    });
-
-    let loaded: Record<string, unknown> | null = null;
-    await act(async () => {
-      loaded = await result.current.load('custom-1');
-    });
-
-    expect(loaded).toEqual({ type: 'dashboard' });
-  });
-});
-
-describe('createLocalStorageAdapter', () => {
-  beforeEach(() => {
-    localStorageMock.clear();
-  });
-
-  it('should create an adapter with custom prefix', async () => {
-    const adapter = createLocalStorageAdapter('my-prefix');
-
-    await adapter.save('test', { hello: 'world' });
-    const result = await adapter.load('test');
-    expect(result).toEqual({ hello: 'world' });
-  });
-
-  it('should maintain an index of saved schemas', async () => {
-    const adapter = createLocalStorageAdapter('test-prefix');
-
-    await adapter.save('a', { type: 'a' });
-    await adapter.save('b', { type: 'b' });
-
-    const items = await adapter.list!();
-    expect(items).toHaveLength(2);
-  });
-
-  it('should not duplicate IDs in index', async () => {
-    const adapter = createLocalStorageAdapter('test-prefix');
-
-    await adapter.save('same-id', { v: 1 });
-    await adapter.save('same-id', { v: 2 });
-
-    const items = await adapter.list!();
-    expect(items).toHaveLength(1);
-  });
-});

package/src/hooks/__tests__/useViewSharing.test.ts

@@ -1,121 +0,0 @@
-/**
- * Tests for useViewSharing hook
- */
-import { describe, it, expect } from 'vitest';
-import { renderHook, act } from '@testing-library/react';
-import { useViewSharing } from '../useViewSharing';
-import type { SavedView } from '../useViewSharing';
-
-const createView = (overrides?: Partial<SavedView>): SavedView => ({
-  id: 'test-1',
-  name: 'Test View',
-  config: { filters: [] },
-  visibility: 'private',
-  updatedAt: new Date(),
-  ...overrides,
-});
-
-describe('useViewSharing', () => {
-  it('starts with empty views by default', () => {
-    const { result } = renderHook(() => useViewSharing());
-    expect(result.current.views).toEqual([]);
-    expect(result.current.activeView).toBeNull();
-  });
-
-  it('starts with provided initial views', () => {
-    const initial = [createView()];
-    const { result } = renderHook(() => useViewSharing(initial));
-    expect(result.current.views).toHaveLength(1);
-    expect(result.current.activeView?.id).toBe('test-1');
-  });
-
-  it('saves a new view', () => {
-    const { result } = renderHook(() => useViewSharing());
-
-    act(() => {
-      result.current.saveView({
-        name: 'My View',
-        config: { sort: 'name' },
-        visibility: 'private',
-      });
-    });
-
-    expect(result.current.views).toHaveLength(1);
-    expect(result.current.views[0].name).toBe('My View');
-  });
-
-  it('returns ID when saving a view', () => {
-    const { result } = renderHook(() => useViewSharing());
-
-    let id: string = '';
-    act(() => {
-      id = result.current.saveView({
-        name: 'My View',
-        config: {},
-        visibility: 'private',
-      });
-    });
-
-    expect(id).toBeTruthy();
-    expect(id).toContain('view-');
-  });
-
-  it('deletes a view', () => {
-    const initial = [createView()];
-    const { result } = renderHook(() => useViewSharing(initial));
-
-    act(() => {
-      result.current.deleteView('test-1');
-    });
-
-    expect(result.current.views).toHaveLength(0);
-  });
-
-  it('sets active view', () => {
-    const initial = [
-      createView({ id: 'v1', name: 'View 1' }),
-      createView({ id: 'v2', name: 'View 2' }),
-    ];
-    const { result } = renderHook(() => useViewSharing(initial));
-
-    act(() => {
-      result.current.setActiveView('v2');
-    });
-
-    expect(result.current.activeView?.id).toBe('v2');
-  });
-
-  it('duplicates a view', () => {
-    const initial = [createView()];
-    const { result } = renderHook(() => useViewSharing(initial));
-
-    act(() => {
-      result.current.duplicateView('test-1', 'Copy of Test');
-    });
-
-    expect(result.current.views).toHaveLength(2);
-    expect(result.current.views[1].name).toBe('Copy of Test');
-    expect(result.current.views[1].isDefault).toBe(false);
-  });
-
-  it('updates view visibility', () => {
-    const initial = [createView()];
-    const { result } = renderHook(() => useViewSharing(initial));
-
-    act(() => {
-      result.current.setVisibility('test-1', 'organization');
-    });
-
-    expect(result.current.views[0].visibility).toBe('organization');
-  });
-
-  it('selects default view as active', () => {
-    const initial = [
-      createView({ id: 'v1', name: 'View 1' }),
-      createView({ id: 'v2', name: 'View 2', isDefault: true }),
-    ];
-    const { result } = renderHook(() => useViewSharing(initial));
-
-    expect(result.current.activeView?.id).toBe('v2');
-  });
-});

package/src/hooks/__tests__/useViewTransition.test.ts

@@ -1,61 +0,0 @@
-/**
- * Tests for useViewTransition hook
- */
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { renderHook, act } from '@testing-library/react';
-import { useViewTransition } from '../useViewTransition';
-
-describe('useViewTransition', () => {
-  beforeEach(() => {
-    vi.restoreAllMocks();
-  });
-
-  afterEach(() => {
-    vi.restoreAllMocks();
-  });
-
-  it('returns isSupported as false when document.startViewTransition is not available', () => {
-    const { result } = renderHook(() => useViewTransition());
-
-    // happy-dom does not implement startViewTransition
-    expect(result.current.isSupported).toBe(false);
-  });
-
-  it('returns isTransitioning as false initially', () => {
-    const { result } = renderHook(() => useViewTransition());
-
-    expect(result.current.isTransitioning).toBe(false);
-  });
-
-  it('startTransition calls callback without transition API (fallback behavior)', async () => {
-    const { result } = renderHook(() => useViewTransition());
-
-    const callback = vi.fn();
-
-    await act(async () => {
-      await result.current.startTransition(callback);
-    });
-
-    expect(callback).toHaveBeenCalledTimes(1);
-  });
-
-  it('respects enabled: false by calling callback directly', async () => {
-    const { result } = renderHook(() =>
-      useViewTransition({ enabled: false }),
-    );
-
-    const callback = vi.fn();
-
-    await act(async () => {
-      await result.current.startTransition(callback);
-    });
-
-    expect(callback).toHaveBeenCalledTimes(1);
-  });
-
-  it('transitionClass is empty initially', () => {
-    const { result } = renderHook(() => useViewTransition());
-
-    expect(result.current.transitionClass).toBe('');
-  });
-});

package/src/hooks/index.ts

@@ -1,35 +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.
- */
-
-export * from './useExpression';
-export * from './useActionRunner';
-export * from './useNavigationOverlay';
-export * from './usePageVariables';
-export * from './useViewData';
-export * from './useDynamicApp';
-export * from './useDiscovery';
-export * from './useFocusTrap';
-export * from './useFocusManagement';
-export * from './useKeyboardShortcuts';
-export * from './useCrudShortcuts';
-export * from './useReducedMotion';
-export * from './useAnimation';
-export * from './useColumnSummary';
-export * from './useDensityMode';
-export * from './useViewSharing';
-export * from './useClientNotifications';
-export * from './useOffline';
-export * from './usePerformance';
-export * from './usePerformanceBudget';
-export * from './usePageTransition';
-export * from './useViewTransition';
-export * from './useETagCache';
-export * from './useSchemaPersistence';
-export * from './useGlobalUndo';
-export * from './useDebugMode';
-export * from './useActionEngine';