@jmruthers/pace-core 0.2.7 → 0.4.1

package/src/components/PrintHeader/__tests__/PrintHeader.unit.test.tsx

@@ -1,202 +0,0 @@
-/**
- * @file PrintHeader Unit Tests
- * @package @jmruthers/pace-core
- * @module PrintHeader
- * @since 0.4.38
- * 
- * Unit tests for PrintHeader component.
- */
-import { errorTestingUtils, TestErrorBoundary } from '../../__tests__/ErrorTesting.enhanced.test';
-import { userEvent } from '@testing-library/user-event';
-
-import React from 'react';
-import { screen, waitFor } from '@testing-library/react';
-import { renderWithProviders  } from "../../../__tests__/shared";
-import { PrintHeader } from '../PrintHeader';
-
-// Mock icons
-const MockIcon = ({ className }: { className?: string }) => (
-  <div data-testid="mock-icon" className={className}>Icon</div>
-);
-
-describe('PrintHeader', () => {
-  it('renders title correctly', () => {
-    renderWithProviders(<PrintHeader title="Test Report" />);
-    expect(screen.getByText('Test Report')).toBeInTheDocument();
-  });
-
-  it('renders subtitle when provided', () => {
-    renderWithProviders(<PrintHeader title="Test Report" subtitle="Q4 Analytics" />);
-    expect(screen.getByText('Q4 Analytics')).toBeInTheDocument();
-  });
-
-  it('renders branding information when provided', () => {
-    const branding = {
-      companyName: 'Test Company',
-      projectName: 'Test Project',
-      version: 'v1.0',
-      tagline: 'Test Tagline'
-    };
-
-    renderWithProviders(<PrintHeader title="Test Report" branding={branding} />);
-    
-    expect(screen.getByText('Test Company')).toBeInTheDocument();
-    expect(screen.getByText('Test Project')).toBeInTheDocument();
-    expect(screen.getByText('v1.0')).toBeInTheDocument();
-    expect(screen.getByText('Test Tagline')).toBeInTheDocument();
-  });
-
-  it('renders logo when provided in branding', () => {
-    const branding = {
-      logo: '/test-logo.png',
-      companyName: 'Test Company'
-    };
-
-    renderWithProviders(<PrintHeader title="Test Report" branding={branding} />);
-    
-    const logo = screen.getByAltText('Test Company');
-    expect(logo).toBeInTheDocument();
-    expect(logo).toHaveAttribute('src', '/test-logo.png');
-  });
-
-  it('renders metadata when provided', () => {
-    const metadata = [
-      { label: 'Status', value: 'Complete', icon: MockIcon },
-      { label: 'Date', value: '2024-01-15', icon: MockIcon }
-    ];
-
-    renderWithProviders(<PrintHeader title="Test Report" metadata={metadata} />);
-    
-    expect(screen.getByText('Status')).toBeInTheDocument();
-    expect(screen.getByText('Complete')).toBeInTheDocument();
-    expect(screen.getByText('Date')).toBeInTheDocument();
-    expect(screen.getByText('2024-01-15')).toBeInTheDocument();
-    expect(screen.getAllByTestId('mock-icon')).toHaveLength(2);
-  });
-
-  it('renders print date by default', () => {
-    renderWithProviders(<PrintHeader title="Test Report" />);
-    expect(screen.getByText(/Printed on/)).toBeInTheDocument();
-  });
-
-  it('does not render print date when disabled', () => {
-    renderWithProviders(<PrintHeader title="Test Report" printDate={false} />);
-    expect(screen.queryByText(/Printed on/)).not.toBeInTheDocument();
-  });
-
-  it('applies custom className', () => {
-    renderWithProviders(<PrintHeader title="Test Report" className="custom-class" />);
-    const header = screen.getByRole('banner');
-    expect(header).toHaveClass('custom-class');
-  });
-
-  it('renders without branding when not provided', () => {
-    renderWithProviders(<PrintHeader title="Test Report" />);
-    expect(screen.getByText('Test Report')).toBeInTheDocument();
-    expect(screen.queryByText('Test Company')).not.toBeInTheDocument();
-  });
-
-  it('renders without metadata when not provided', () => {
-    renderWithProviders(<PrintHeader title="Test Report" />);
-    expect(screen.getByText('Test Report')).toBeInTheDocument();
-    expect(screen.queryByText('Status')).not.toBeInTheDocument();
-  });
-
-  it('renders with empty metadata array', () => {
-    renderWithProviders(<PrintHeader title="Test Report" metadata={[]} />);
-    expect(screen.getByText('Test Report')).toBeInTheDocument();
-  });
-describe('PrintHeader Error Handling', () => {
-  const user = userEvent.setup();
-  let restoreConsole: (() => void) | null = null;
-
-  beforeEach(() => {
-    restoreConsole = errorTestingUtils.suppressConsoleErrors();
-  });
-
-  afterEach(() => {
-    if (restoreConsole) {
-      restoreConsole();
-    }
-  });
-
-  it('should handle component errors gracefully', () => {
-    const ErrorComponent = () => {
-      throw new Error('PrintHeader component error');
-    };
-
-    renderWithProviders(
-      <TestErrorBoundary>
-        <ErrorComponent />
-      </TestErrorBoundary>
-    );
-
-    expect(screen.getByTestId('error-boundary')).toBeInTheDocument();
-    expect(screen.getByText('Error: PrintHeader component error')).toBeInTheDocument();
-  });
-
-  it('should handle async errors', async () => {
-    const AsyncErrorComponent = ({ shouldFail }: { shouldFail: boolean }) => {
-      const [error, setError] = React.useState<Error | null>(null);
-
-      React.useEffect(() => {
-        if (shouldFail) {
-          setError(new Error('Async error'));
-        }
-      }, [shouldFail]);
-
-      if (error) {
-        throw error;
-      }
-
-      return <div>Async component</div>;
-    };
-
-    renderWithProviders(
-      <TestErrorBoundary>
-        <AsyncErrorComponent shouldFail={true} />
-      </TestErrorBoundary>
-    );
-
-    await waitFor(() => {
-      expect(screen.getByTestId('error-boundary')).toBeInTheDocument();
-    });
-  });
-
-  it('should handle user interaction errors', async () => {
-    const ErrorComponent = errorTestingUtils.createErrorThrowingComponent(
-      'PrintHeader interaction error',
-      'click'
-    );
-
-    renderWithProviders(
-      <TestErrorBoundary>
-        <ErrorComponent />
-      </TestErrorBoundary>
-    );
-
-    await user.click(screen.getByTestId('error-button'));
-
-    await waitFor(() => {
-      expect(screen.getByTestId('error-display')).toBeInTheDocument();
-    });
-  });
-
-  it('should recover from errors when props change', async () => {
-    const TestComponent = ({ shouldError }: { shouldError: boolean }) => {
-      if (shouldError) {
-        throw new Error('PrintHeader prop error');
-      }
-      return <div>Normal content</div>;
-    };
-
-    await errorTestingUtils.testErrorRecovery(
-      TestComponent,
-      { shouldError: true },
-      { shouldError: false }
-    );
-
-    expect(screen.getByText('Normal content')).toBeInTheDocument();
-  });
-});
-});

package/src/components/PrintHeader/index.ts

@@ -1,17 +0,0 @@
-/**
- * @file PrintHeader Component Exports
- * @package @jmruthers/pace-core
- * @module PrintHeader
- * @since 0.4.38
- * 
- * Exports for PrintHeader and PrintCoverHeader components.
- */
-
-export { PrintHeader } from './PrintHeader';
-export { PrintCoverHeader } from './PrintCoverHeader';
-export type { 
-  PrintHeaderProps, 
-  PrintCoverHeaderProps,
-  PrintBranding,
-  PrintMetadata 
-} from './types';

package/src/components/PrintHeader/types.ts

@@ -1,42 +0,0 @@
-/**
- * @file PrintHeader Types
- * @package @jmruthers/pace-core
- * @module PrintHeader
- * @since 0.4.38
- * 
- * Type definitions for PrintHeader and PrintCoverHeader components.
- */
-
-import { ReactNode, ComponentType } from 'react';
-
-export interface PrintBranding {
-  logo?: string;
-  companyName?: string;
-  projectName?: string;
-  version?: string;
-  tagline?: string;
-}
-
-export interface PrintMetadata {
-  label: string;
-  value: string;
-  icon?: ComponentType<{ className?: string }>;
-}
-
-export interface PrintHeaderProps {
-  title: string;
-  subtitle?: string;
-  branding?: PrintBranding;
-  metadata?: PrintMetadata[];
-  printDate?: boolean;
-  className?: string;
-}
-
-export interface PrintCoverHeaderProps extends PrintHeaderProps {
-  coverStyle?: boolean;
-  logoSize?: 'small' | 'medium' | 'large';
-  titleSize?: 'small' | 'medium' | 'large' | 'xl';
-  showDivider?: boolean;
-  backgroundImage?: string;
-  backgroundColor?: string;
-}

package/src/components/PrintLayout/PrintLayout.tsx

@@ -1,122 +0,0 @@
-/**
- * @file PrintLayout Component
- * @package @jmruthers/pace-core
- * @module PrintLayout
- * @since 0.4.38
- * 
- * Base print-optimized layout component with A4 support and first page header management.
- * 
- * Features:
- * - Print-optimized base layout
- * - A4 page size support (portrait/landscape)
- * - First page vs subsequent page header management
- * - Print media query integration
- * - Page break controls
- * 
- * @example
- * ```tsx
- * <PrintLayout orientation="portrait" pageSize="A4">
- *   <PrintHeader title="Report" />
- *   <PrintSection title="Data">
- *     <PrintDataTable data={data} columns={columns} />
- *   </PrintSection>
- * </PrintLayout>
- * ```
- * 
- * @example
- * ```tsx
- * <PrintLayout 
- *   orientation="landscape" 
- *   pageSize="A4"
- *   firstPageHeader={<PrintCoverHeader title="Annual Report" />}
- *   subsequentPageHeader={<PrintHeader title="Annual Report" />}
- * >
- *   <PrintSection title="Executive Summary">
- *     Content goes here
- *   </PrintSection>
- * </PrintLayout>
- * ```
- */
-
-import React from 'react';
-import { cn } from '../../utils/cn';
-import { PrintLayoutProvider } from './PrintLayoutContext';
-import type { PrintLayoutProps } from './types';
-
-/**
- * PrintLayout component provides a print-optimized base layout with support for
- * different page sizes, orientations, and header management.
- */
-export function PrintLayout({
-  children,
-  orientation = 'portrait',
-  pageSize = 'A4',
-  showHeader = true,
-  showFooter = true,
-  firstPageHeader,
-  subsequentPageHeader,
-  className,
-  ...props
-}: PrintLayoutProps) {
-  const hasFirstPageHeader = Boolean(firstPageHeader);
-  const hasSubsequentPageHeader = Boolean(subsequentPageHeader);
-
-  const getPageSizeClass = () => {
-    if (pageSize === 'A4') {
-      return orientation === 'landscape' ? 'print-a4-landscape' : 'print-a4-portrait';
-    }
-    // Future: Add A3, A5 support
-    return 'print-a4-portrait';
-  };
-
-  const getHeaderClass = () => {
-    if (hasFirstPageHeader && hasSubsequentPageHeader) {
-      return 'print-first-page-header print-subsequent-header';
-    }
-    if (hasFirstPageHeader) {
-      return 'print-first-page-header';
-    }
-    if (hasSubsequentPageHeader) {
-      return 'print-subsequent-header';
-    }
-    return '';
-  };
-
-  return (
-    <PrintLayoutProvider
-      pageSize={pageSize}
-      orientation={orientation}
-      hasFirstPageHeader={hasFirstPageHeader}
-      hasSubsequentPageHeader={hasSubsequentPageHeader}
-    >
-      <div
-        className={cn(
-          'print-layout',
-          getPageSizeClass(),
-          getHeaderClass(),
-          className
-        )}
-        {...props}
-      >
-        {/* First page header */}
-        {hasFirstPageHeader && (
-          <div className="print-first-page-only">
-            {firstPageHeader}
-          </div>
-        )}
-
-        {/* Subsequent page header */}
-        {hasSubsequentPageHeader && (
-          <div className="print-subsequent-pages-only">
-            {subsequentPageHeader}
-          </div>
-        )}
-
-        {/* Main content */}
-        <div className="print-text">
-          {children}
-        </div>
-      </div>
-    </PrintLayoutProvider>
-  );
-}

package/src/components/PrintLayout/PrintLayoutContext.tsx

@@ -1,66 +0,0 @@
-/**
- * @file PrintLayout Context
- * @package @jmruthers/pace-core
- * @module PrintLayout
- * @since 0.4.38
- * 
- * Context for managing print layout state and page detection.
- */
-
-import React, { createContext, useContext, useState, useEffect } from 'react';
-import type { PrintLayoutContextType, PageSize, Orientation } from './types';
-
-const PrintLayoutContext = createContext<PrintLayoutContextType | undefined>(undefined);
-
-export interface PrintLayoutProviderProps {
-  children: React.ReactNode;
-  pageSize: PageSize;
-  orientation: Orientation;
-  hasFirstPageHeader: boolean;
-  hasSubsequentPageHeader: boolean;
-}
-
-export function PrintLayoutProvider({
-  children,
-  pageSize,
-  orientation,
-  hasFirstPageHeader,
-  hasSubsequentPageHeader,
-}: PrintLayoutProviderProps) {
-  const [isFirstPage, setIsFirstPage] = useState(true);
-
-  useEffect(() => {
-    // Simple page detection - in a real implementation, this would be more sophisticated
-    // For now, we'll assume first page until content overflows
-    const handleResize = () => {
-      // This is a simplified implementation
-      // In a real scenario, you'd measure content height vs page height
-      setIsFirstPage(true);
-    };
-
-    window.addEventListener('resize', handleResize);
-    return () => window.removeEventListener('resize', handleResize);
-  }, []);
-
-  const value: PrintLayoutContextType = {
-    isFirstPage,
-    pageSize,
-    orientation,
-    hasFirstPageHeader,
-    hasSubsequentPageHeader,
-  };
-
-  return (
-    <PrintLayoutContext.Provider value={value}>
-      {children}
-    </PrintLayoutContext.Provider>
-  );
-}
-
-export function usePrintLayout(): PrintLayoutContextType {
-  const context = useContext(PrintLayoutContext);
-  if (context === undefined) {
-    throw new Error('usePrintLayout must be used within a PrintLayoutProvider');
-  }
-  return context;
-}

package/src/components/PrintLayout/PrintPageBreak.tsx

@@ -1,52 +0,0 @@
-/**
- * @file PrintPageBreak Component
- * @package @jmruthers/pace-core
- * @module PrintLayout
- * @since 0.4.38
- * 
- * Component for controlling page breaks in print layouts.
- */
-
-import React from 'react';
-import { cn } from '../../utils/cn';
-import type { PrintPageBreakProps } from './types';
-
-/**
- * PrintPageBreak component for controlling page breaks in print layouts.
- * 
- * @example
- * ```tsx
- * <PrintPageBreak type="before" />
- * <PrintPageBreak type="after" />
- * <PrintPageBreak type="avoid" />
- * ```
- */
-export function PrintPageBreak({ 
-  type = 'after', 
-  className,
-  ...props
-}: PrintPageBreakProps) {
-  const getBreakClass = () => {
-    switch (type) {
-      case 'before':
-        return 'print-break-before';
-      case 'after':
-        return 'print-break-after';
-      case 'avoid':
-        return 'print-break-avoid';
-      default:
-        return '';
-    }
-  };
-
-  return (
-    <div 
-      className={cn(
-        getBreakClass(),
-        className
-      )}
-      aria-hidden="true"
-      {...props}
-    />
-  );
-}