@object-ui/react 3.3.0 → 3.3.1

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

@@ -1,153 +0,0 @@
-/**
- * Tests for useETagCache hook
- */
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { renderHook, act } from '@testing-library/react';
-import { useETagCache } from '../useETagCache';
-
-describe('useETagCache', () => {
-  beforeEach(() => {
-    vi.restoreAllMocks();
-    // Clear the module-scoped memory cache between tests
-    const { result } = renderHook(() => useETagCache());
-    act(() => {
-      result.current.clearCache();
-    });
-  });
-
-  afterEach(() => {
-    vi.restoreAllMocks();
-  });
-
-  it('returns initial state with cacheSize: 0', () => {
-    const { result } = renderHook(() => useETagCache());
-
-    expect(result.current.cacheSize).toBe(0);
-    expect(result.current.serviceWorkerActive).toBe(false);
-    expect(result.current.fetchWithETag).toBeTypeOf('function');
-    expect(result.current.invalidate).toBeTypeOf('function');
-    expect(result.current.clearCache).toBeTypeOf('function');
-  });
-
-  it('fetchWithETag makes a network request and caches the response', async () => {
-    const mockData = { id: 1, name: 'Test' };
-    const mockHeaders = new Headers({ etag: '"abc123"' });
-    vi.spyOn(globalThis, 'fetch').mockResolvedValueOnce(
-      new Response(JSON.stringify(mockData), {
-        status: 200,
-        headers: mockHeaders,
-      }),
-    );
-
-    const { result } = renderHook(() => useETagCache());
-
-    let response: { data: unknown; fromCache: boolean; etag?: string } | undefined;
-    await act(async () => {
-      response = await result.current.fetchWithETag('/api/test');
-    });
-
-    expect(response!.data).toEqual(mockData);
-    expect(response!.fromCache).toBe(false);
-    expect(response!.etag).toBe('"abc123"');
-    expect(result.current.cacheSize).toBe(1);
-  });
-
-  it('fetchWithETag sends If-None-Match header on subsequent requests', async () => {
-    const mockData = { id: 1 };
-    const fetchSpy = vi.spyOn(globalThis, 'fetch');
-
-    // First request — returns data with ETag
-    fetchSpy.mockResolvedValueOnce(
-      new Response(JSON.stringify(mockData), {
-        status: 200,
-        headers: new Headers({ etag: '"etag-1"' }),
-      }),
-    );
-
-    const { result } = renderHook(() => useETagCache());
-
-    await act(async () => {
-      await result.current.fetchWithETag('/api/data');
-    });
-
-    // Second request — server returns 304
-    fetchSpy.mockResolvedValueOnce(
-      new Response(null, { status: 304 }),
-    );
-
-    let response: { data: unknown; fromCache: boolean; etag?: string } | undefined;
-    await act(async () => {
-      response = await result.current.fetchWithETag('/api/data');
-    });
-
-    // Verify If-None-Match was sent
-    const secondCallArgs = fetchSpy.mock.calls[1];
-    const headers = secondCallArgs[1]?.headers as Headers;
-    expect(headers.get('If-None-Match')).toBe('"etag-1"');
-    expect(response!.fromCache).toBe(true);
-    expect(response!.data).toEqual(mockData);
-  });
-
-  it('invalidate removes a specific cache entry', async () => {
-    const mockData = { id: 1 };
-    vi.spyOn(globalThis, 'fetch').mockResolvedValueOnce(
-      new Response(JSON.stringify(mockData), {
-        status: 200,
-        headers: new Headers({ etag: '"etag-x"' }),
-      }),
-    );
-
-    const { result } = renderHook(() => useETagCache());
-
-    await act(async () => {
-      await result.current.fetchWithETag('/api/item');
-    });
-    expect(result.current.cacheSize).toBe(1);
-
-    act(() => {
-      result.current.invalidate('/api/item');
-    });
-
-    expect(result.current.cacheSize).toBe(0);
-  });
-
-  it('clearCache removes all entries', async () => {
-    const fetchSpy = vi.spyOn(globalThis, 'fetch');
-
-    fetchSpy.mockResolvedValueOnce(
-      new Response(JSON.stringify({ a: 1 }), {
-        status: 200,
-        headers: new Headers({ etag: '"e1"' }),
-      }),
-    );
-    fetchSpy.mockResolvedValueOnce(
-      new Response(JSON.stringify({ b: 2 }), {
-        status: 200,
-        headers: new Headers({ etag: '"e2"' }),
-      }),
-    );
-
-    const { result } = renderHook(() => useETagCache());
-
-    await act(async () => {
-      await result.current.fetchWithETag('/api/a');
-    });
-    await act(async () => {
-      await result.current.fetchWithETag('/api/b');
-    });
-
-    expect(result.current.cacheSize).toBe(2);
-
-    act(() => {
-      result.current.clearCache();
-    });
-
-    expect(result.current.cacheSize).toBe(0);
-  });
-
-  it('serviceWorkerActive is false initially', () => {
-    const { result } = renderHook(() => useETagCache());
-
-    expect(result.current.serviceWorkerActive).toBe(false);
-  });
-});

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

@@ -1,86 +0,0 @@
-/**
- * Tests for useExpression and useCondition hooks
- */
-
-import { describe, it, expect } from 'vitest';
-import { renderHook } from '@testing-library/react';
-import { useExpression, useCondition } from '../useExpression';
-
-describe('useExpression', () => {
-  it('returns string value directly for non-expression strings', () => {
-    const { result } = renderHook(() => useExpression('hello'));
-
-    expect(result.current).toBe('hello');
-  });
-
-  it('returns number value directly', () => {
-    const { result } = renderHook(() => useExpression(42));
-
-    expect(result.current).toBe(42);
-  });
-
-  it('returns boolean value directly', () => {
-    const { result } = renderHook(() => useExpression(true));
-
-    expect(result.current).toBe(true);
-  });
-
-  it('returns null for null expressions', () => {
-    const { result } = renderHook(() => useExpression(null));
-
-    expect(result.current).toBeNull();
-  });
-
-  it('returns undefined for undefined expressions', () => {
-    const { result } = renderHook(() => useExpression(undefined));
-
-    expect(result.current).toBeUndefined();
-  });
-
-  it('evaluates expressions with ${...} syntax', () => {
-    const context = { data: { name: 'John' } };
-    const { result } = renderHook(() =>
-      useExpression('${data.name}', context),
-    );
-
-    expect(result.current).toBe('John');
-  });
-
-  it('evaluates expressions with context data', () => {
-    const context = { data: { age: 25 } };
-    const { result } = renderHook(() =>
-      useExpression('${data.age > 18}', context),
-    );
-
-    expect(result.current).toBe(true);
-  });
-});
-
-describe('useCondition', () => {
-  it('returns true for boolean true', () => {
-    const { result } = renderHook(() => useCondition(true));
-
-    expect(result.current).toBe(true);
-  });
-
-  it('returns false for boolean false', () => {
-    const { result } = renderHook(() => useCondition(false));
-
-    expect(result.current).toBe(false);
-  });
-
-  it('returns true for undefined', () => {
-    const { result } = renderHook(() => useCondition(undefined));
-
-    expect(result.current).toBe(true);
-  });
-
-  it('evaluates string conditions with context', () => {
-    const context = { data: { status: 'active' } };
-    const { result } = renderHook(() =>
-      useCondition('${data.status === "active"}', context),
-    );
-
-    expect(result.current).toBe(true);
-  });
-});

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

@@ -1,294 +0,0 @@
-/**
- * Tests for useFocusTrap hook
- */
-import { describe, it, expect, vi } from 'vitest';
-import { renderHook, act } from '@testing-library/react';
-import { useFocusTrap } from '../useFocusTrap';
-
-describe('useFocusTrap', () => {
-  it('returns a ref object', () => {
-    const { result } = renderHook(() => useFocusTrap());
-    expect(result.current).toBeDefined();
-    expect(result.current).toHaveProperty('current');
-  });
-
-  it('returns a ref with null initial value', () => {
-    const { result } = renderHook(() => useFocusTrap());
-    expect(result.current.current).toBeNull();
-  });
-
-  it('accepts disabled option', () => {
-    const { result } = renderHook(() =>
-      useFocusTrap({ enabled: false })
-    );
-    expect(result.current).toBeDefined();
-  });
-
-  it('accepts all options without error', () => {
-    const onEscape = vi.fn();
-    const { result } = renderHook(() =>
-      useFocusTrap({
-        enabled: true,
-        autoFocus: true,
-        restoreFocus: true,
-        escapeDeactivates: true,
-        onEscape,
-        initialFocus: '.first-input',
-      })
-    );
-    expect(result.current).toBeDefined();
-  });
-
-  it('defaults to enabled when no options provided', () => {
-    const { result } = renderHook(() => useFocusTrap());
-    // Should not throw
-    expect(result.current.current).toBeNull();
-  });
-
-  it('auto-focuses the first focusable element when enabled', () => {
-    const container = document.createElement('div');
-    const button = document.createElement('button');
-    button.textContent = 'Click me';
-    container.appendChild(button);
-    document.body.appendChild(container);
-
-    const { result } = renderHook(() =>
-      useFocusTrap<HTMLDivElement>({ enabled: true, autoFocus: true })
-    );
-
-    act(() => {
-      (result.current as any).current = container;
-    });
-
-    // Re-render to trigger effect with the ref set
-    const { result: result2 } = renderHook(() =>
-      useFocusTrap<HTMLDivElement>({ enabled: true, autoFocus: true })
-    );
-
-    document.body.removeChild(container);
-  });
-
-  it('focuses initialFocus selector when provided', () => {
-    const container = document.createElement('div');
-    const input1 = document.createElement('input');
-    const input2 = document.createElement('input');
-    input2.className = 'target-input';
-    container.appendChild(input1);
-    container.appendChild(input2);
-    document.body.appendChild(container);
-
-    const focusSpy = vi.spyOn(input2, 'focus');
-
-    const { result, rerender } = renderHook(
-      ({ enabled }) =>
-        useFocusTrap<HTMLDivElement>({
-          enabled,
-          autoFocus: true,
-          initialFocus: '.target-input',
-        }),
-      { initialProps: { enabled: false } }
-    );
-
-    // Set the ref
-    (result.current as any).current = container;
-
-    // Enable the trap to trigger the effect
-    rerender({ enabled: true });
-
-    expect(focusSpy).toHaveBeenCalled();
-
-    document.body.removeChild(container);
-  });
-
-  it('handles Escape key when escapeDeactivates is true', () => {
-    const container = document.createElement('div');
-    const button = document.createElement('button');
-    container.appendChild(button);
-    document.body.appendChild(container);
-
-    const onEscape = vi.fn();
-
-    const { result, rerender } = renderHook(
-      ({ enabled }) =>
-        useFocusTrap<HTMLDivElement>({
-          enabled,
-          escapeDeactivates: true,
-          onEscape,
-        }),
-      { initialProps: { enabled: false } }
-    );
-
-    (result.current as any).current = container;
-    rerender({ enabled: true });
-
-    act(() => {
-      const event = new KeyboardEvent('keydown', { key: 'Escape', bubbles: true });
-      container.dispatchEvent(event);
-    });
-
-    expect(onEscape).toHaveBeenCalled();
-
-    document.body.removeChild(container);
-  });
-
-  it('traps Tab focus at the end of focusable elements', () => {
-    const container = document.createElement('div');
-    const button1 = document.createElement('button');
-    button1.textContent = 'First';
-    const button2 = document.createElement('button');
-    button2.textContent = 'Last';
-    container.appendChild(button1);
-    container.appendChild(button2);
-    document.body.appendChild(container);
-
-    const { result, rerender } = renderHook(
-      ({ enabled }) =>
-        useFocusTrap<HTMLDivElement>({
-          enabled,
-          autoFocus: false,
-        }),
-      { initialProps: { enabled: false } }
-    );
-
-    (result.current as any).current = container;
-    rerender({ enabled: true });
-
-    // Focus the last element
-    button2.focus();
-
-    act(() => {
-      const event = new KeyboardEvent('keydown', {
-        key: 'Tab',
-        bubbles: true,
-      });
-      container.dispatchEvent(event);
-    });
-
-    document.body.removeChild(container);
-  });
-
-  it('traps Shift+Tab focus at the start of focusable elements', () => {
-    const container = document.createElement('div');
-    const button1 = document.createElement('button');
-    button1.textContent = 'First';
-    const button2 = document.createElement('button');
-    button2.textContent = 'Last';
-    container.appendChild(button1);
-    container.appendChild(button2);
-    document.body.appendChild(container);
-
-    const { result, rerender } = renderHook(
-      ({ enabled }) =>
-        useFocusTrap<HTMLDivElement>({
-          enabled,
-          autoFocus: false,
-        }),
-      { initialProps: { enabled: false } }
-    );
-
-    (result.current as any).current = container;
-    rerender({ enabled: true });
-
-    // Focus the first element
-    button1.focus();
-
-    act(() => {
-      const event = new KeyboardEvent('keydown', {
-        key: 'Tab',
-        shiftKey: true,
-        bubbles: true,
-      });
-      container.dispatchEvent(event);
-    });
-
-    document.body.removeChild(container);
-  });
-
-  it('restores focus on unmount when restoreFocus is true', () => {
-    const outsideButton = document.createElement('button');
-    outsideButton.textContent = 'Outside';
-    document.body.appendChild(outsideButton);
-    outsideButton.focus();
-
-    const container = document.createElement('div');
-    const innerButton = document.createElement('button');
-    innerButton.textContent = 'Inside';
-    container.appendChild(innerButton);
-    document.body.appendChild(container);
-
-    const { result, rerender, unmount } = renderHook(
-      ({ enabled }) =>
-        useFocusTrap<HTMLDivElement>({
-          enabled,
-          autoFocus: true,
-          restoreFocus: true,
-        }),
-      { initialProps: { enabled: false } }
-    );
-
-    (result.current as any).current = container;
-    rerender({ enabled: true });
-
-    unmount();
-
-    document.body.removeChild(container);
-    document.body.removeChild(outsideButton);
-  });
-
-  it('ignores non-Tab and non-Escape keys', () => {
-    const container = document.createElement('div');
-    const button = document.createElement('button');
-    container.appendChild(button);
-    document.body.appendChild(container);
-
-    const { result, rerender } = renderHook(
-      ({ enabled }) =>
-        useFocusTrap<HTMLDivElement>({
-          enabled,
-          autoFocus: false,
-        }),
-      { initialProps: { enabled: false } }
-    );
-
-    (result.current as any).current = container;
-    rerender({ enabled: true });
-
-    act(() => {
-      const event = new KeyboardEvent('keydown', {
-        key: 'a',
-        bubbles: true,
-      });
-      container.dispatchEvent(event);
-    });
-
-    document.body.removeChild(container);
-  });
-
-  it('handles container with no focusable elements', () => {
-    const container = document.createElement('div');
-    container.innerHTML = '<span>No focusable elements</span>';
-    document.body.appendChild(container);
-
-    const { result, rerender } = renderHook(
-      ({ enabled }) =>
-        useFocusTrap<HTMLDivElement>({
-          enabled,
-          autoFocus: true,
-        }),
-      { initialProps: { enabled: false } }
-    );
-
-    (result.current as any).current = container;
-    rerender({ enabled: true });
-
-    act(() => {
-      const event = new KeyboardEvent('keydown', {
-        key: 'Tab',
-        bubbles: true,
-      });
-      container.dispatchEvent(event);
-    });
-
-    document.body.removeChild(container);
-  });
-});

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

@@ -1,144 +0,0 @@
-/**
- * Tests for useKeyboardShortcuts hook
- */
-import { describe, it, expect, vi } from 'vitest';
-import { renderHook } from '@testing-library/react';
-import { useKeyboardShortcuts, getShortcutDescriptions } from '../useKeyboardShortcuts';
-import type { KeyboardShortcutDefinition } from '../useKeyboardShortcuts';
-
-describe('useKeyboardShortcuts', () => {
-  it('registers shortcuts without error', () => {
-    const handler = vi.fn();
-    const shortcuts: KeyboardShortcutDefinition[] = [
-      { key: 'k', ctrlOrMeta: true, handler, description: 'Search' },
-    ];
-
-    expect(() => {
-      renderHook(() => useKeyboardShortcuts(shortcuts));
-    }).not.toThrow();
-  });
-
-  it('handles empty shortcuts array', () => {
-    expect(() => {
-      renderHook(() => useKeyboardShortcuts([]));
-    }).not.toThrow();
-  });
-
-  it('respects enabled option', () => {
-    const handler = vi.fn();
-    const shortcuts: KeyboardShortcutDefinition[] = [
-      { key: 'k', handler },
-    ];
-
-    expect(() => {
-      renderHook(() => useKeyboardShortcuts(shortcuts, { enabled: false }));
-    }).not.toThrow();
-  });
-
-  it('fires handler on matching keyboard event', () => {
-    const handler = vi.fn();
-    const shortcuts: KeyboardShortcutDefinition[] = [
-      { key: 'Escape', handler },
-    ];
-
-    renderHook(() => useKeyboardShortcuts(shortcuts));
-
-    // Simulate keydown
-    const event = new KeyboardEvent('keydown', {
-      key: 'Escape',
-      bubbles: true,
-    });
-    document.dispatchEvent(event);
-
-    expect(handler).toHaveBeenCalledTimes(1);
-  });
-
-  it('does not fire handler for non-matching key', () => {
-    const handler = vi.fn();
-    const shortcuts: KeyboardShortcutDefinition[] = [
-      { key: 'k', ctrlOrMeta: true, handler },
-    ];
-
-    renderHook(() => useKeyboardShortcuts(shortcuts));
-
-    const event = new KeyboardEvent('keydown', {
-      key: 'k',
-      bubbles: true,
-      // No ctrl or meta
-    });
-    document.dispatchEvent(event);
-
-    expect(handler).not.toHaveBeenCalled();
-  });
-
-  it('fires handler when modifier keys match', () => {
-    const handler = vi.fn();
-    const shortcuts: KeyboardShortcutDefinition[] = [
-      { key: 'k', ctrlOrMeta: true, handler },
-    ];
-
-    renderHook(() => useKeyboardShortcuts(shortcuts));
-
-    const event = new KeyboardEvent('keydown', {
-      key: 'k',
-      ctrlKey: true,
-      bubbles: true,
-    });
-    document.dispatchEvent(event);
-
-    expect(handler).toHaveBeenCalledTimes(1);
-  });
-
-  it('skips disabled shortcuts', () => {
-    const handler = vi.fn();
-    const shortcuts: KeyboardShortcutDefinition[] = [
-      { key: 'k', handler, enabled: false },
-    ];
-
-    renderHook(() => useKeyboardShortcuts(shortcuts));
-
-    const event = new KeyboardEvent('keydown', {
-      key: 'k',
-      bubbles: true,
-    });
-    document.dispatchEvent(event);
-
-    expect(handler).not.toHaveBeenCalled();
-  });
-});
-
-describe('getShortcutDescriptions', () => {
-  it('returns formatted descriptions', () => {
-    const shortcuts: KeyboardShortcutDefinition[] = [
-      { key: 'k', ctrlOrMeta: true, handler: vi.fn(), description: 'Search' },
-      { key: 'n', ctrlOrMeta: true, shift: true, handler: vi.fn(), description: 'New' },
-      { key: 'Escape', handler: vi.fn(), description: 'Close' },
-    ];
-
-    const descriptions = getShortcutDescriptions(shortcuts);
-
-    expect(descriptions).toHaveLength(3);
-    expect(descriptions[0]).toEqual({ keys: '⌘/Ctrl + K', description: 'Search' });
-    expect(descriptions[1]).toEqual({ keys: '⌘/Ctrl + Shift + N', description: 'New' });
-    expect(descriptions[2]).toEqual({ keys: 'Escape', description: 'Close' });
-  });
-
-  it('excludes shortcuts without descriptions', () => {
-    const shortcuts: KeyboardShortcutDefinition[] = [
-      { key: 'k', handler: vi.fn() },
-      { key: 'n', handler: vi.fn(), description: 'New' },
-    ];
-
-    const descriptions = getShortcutDescriptions(shortcuts);
-    expect(descriptions).toHaveLength(1);
-  });
-
-  it('excludes disabled shortcuts', () => {
-    const shortcuts: KeyboardShortcutDefinition[] = [
-      { key: 'k', handler: vi.fn(), description: 'Search', enabled: false },
-    ];
-
-    const descriptions = getShortcutDescriptions(shortcuts);
-    expect(descriptions).toHaveLength(0);
-  });
-});