@jmruthers/pace-core 0.5.53 → 0.5.55

package/src/utils/print/examples/PrintUtilitiesShowcase.tsx

@@ -1,397 +0,0 @@
-/**
- * @file Print Utilities Showcase Example
- * @package @jmruthers/pace-core
- * @module PrintUtilitiesShowcase
- * @since 0.4.38
- * 
- * Example showcasing print utilities usage.
- */
-
-import React, { useState } from 'react';
-import { 
-  PrintLayout,
-  PrintHeader,
-  PrintText,
-  PrintSection,
-  PrintDataTable,
-  PrintButton
-} from '../../../components/index';
-import { 
-  usePrintOptimization, 
-  usePrintPagination, 
-  usePrintGrouping, 
-  usePrintPreview, 
-  usePrintValidation 
-} from '../usePrintOptimization';
-
-// Sample data for demonstration
-const sampleData = [
-  { id: 1, name: 'John Doe', email: 'john@example.com', department: 'Engineering', salary: 75000, status: 'Active' },
-  { id: 2, name: 'Jane Smith', email: 'jane@example.com', department: 'Marketing', salary: 65000, status: 'Active' },
-  { id: 3, name: 'Bob Johnson', email: 'bob@example.com', department: 'Engineering', salary: 80000, status: 'Active' },
-  { id: 4, name: 'Alice Brown', email: 'alice@example.com', department: 'Sales', salary: 70000, status: 'Inactive' },
-  { id: 5, name: 'Charlie Wilson', email: 'charlie@example.com', department: 'Marketing', salary: 60000, status: 'Active' },
-  { id: 6, name: 'Diana Davis', email: 'diana@example.com', department: 'Engineering', salary: 85000, status: 'Active' },
-  { id: 7, name: 'Eve Miller', email: 'eve@example.com', department: 'Sales', salary: 72000, status: 'Active' },
-  { id: 8, name: 'Frank Garcia', email: 'frank@example.com', department: 'Marketing', salary: 68000, status: 'Inactive' },
-  { id: 9, name: 'Grace Lee', email: 'grace@example.com', department: 'Engineering', salary: 90000, status: 'Active' },
-  { id: 10, name: 'Henry Taylor', email: 'henry@example.com', department: 'Sales', salary: 75000, status: 'Active' }
-];
-
-const tableColumns = [
-  { key: 'id', header: 'ID', align: 'left' as const },
-  { key: 'name', header: 'Name', align: 'left' as const },
-  { key: 'email', header: 'Email', align: 'left' as const },
-  { key: 'department', header: 'Department', align: 'center' as const },
-  { key: 'salary', header: 'Salary', align: 'right' as const, render: (value: number) => `$${value.toLocaleString()}` },
-  { key: 'status', header: 'Status', align: 'center' as const }
-];
-
-export function PrintUtilitiesShowcase() {
-  const [optimizationLevel, setOptimizationLevel] = useState<'basic' | 'advanced' | 'maximum'>('basic');
-  const [itemsPerPage, setItemsPerPage] = useState(5);
-
-  // Print optimization hook
-  const optimization = usePrintOptimization({
-    data: sampleData,
-    options: {
-      optimizationLevel,
-      maxItemsPerPage: itemsPerPage,
-      maxCharactersPerLine: 80,
-      pageBreakStrategy: 'auto'
-    },
-    autoProcess: true
-  });
-
-  // Pagination hook
-  const pagination = usePrintPagination(sampleData, {
-    maxItemsPerPage: itemsPerPage
-  });
-
-  // Grouping hook
-  const grouping = usePrintGrouping(sampleData, 'department', {
-    maxItemsPerPage: itemsPerPage
-  });
-
-  // Preview hook
-  const preview = usePrintPreview(sampleData, {
-    maxItemsPerPage: itemsPerPage,
-    optimizationLevel
-  });
-
-  // Validation hook
-  const validation = usePrintValidation(sampleData, {
-    maxItemsPerPage: itemsPerPage
-  });
-
-  return (
-    <PrintLayout
-      orientation="portrait"
-      pageSize="A4"
-      firstPageHeader={
-        <PrintHeader
-          title="Print Utilities Showcase"
-          subtitle="Demonstrating data processing and optimization utilities"
-          branding={{
-            logo: "/pace_logo_square.svg",
-            companyName: "Pace Core"
-          }}
-          metadata={[
-            { label: 'Date', value: new Date().toLocaleDateString() },
-            { label: 'Page', value: "1" }
-          ]}
-        />
-      }
-    >
-      <div className="space-y-8">
-        {/* Print Optimization Controls */}
-        <PrintSection title="Print Optimization Controls" background="white" showBorder>
-          <PrintSection>
-            <PrintText>
-              Control print optimization settings and see real-time results.
-            </PrintText>
-            
-            <div className="grid grid-cols-1 md:grid-cols-2 gap-4 mt-4">
-              <div>
-                <PrintText variant="small" weight="semibold">Optimization Level</PrintText>
-                <select 
-                  value={optimizationLevel} 
-                  onChange={(e) => setOptimizationLevel(e.target.value as any)}
-                  className="w-full p-2 border border-border rounded"
-                >
-                  <option value="basic">Basic</option>
-                  <option value="advanced">Advanced</option>
-                  <option value="maximum">Maximum</option>
-                </select>
-              </div>
-              
-              <div>
-                <PrintText variant="small" weight="semibold">Items Per Page</PrintText>
-                <select 
-                  value={itemsPerPage} 
-                  onChange={(e) => setItemsPerPage(Number(e.target.value))}
-                  className="w-full p-2 border border-border rounded"
-                >
-                  <option value={3}>3</option>
-                  <option value={5}>5</option>
-                  <option value={10}>10</option>
-                  <option value={20}>20</option>
-                </select>
-              </div>
-            </div>
-
-            {optimization.result && (
-              <div className="mt-4 p-4 bg-muted rounded">
-                <PrintText variant="small" weight="semibold">Optimization Results</PrintText>
-                <div className="grid grid-cols-2 gap-4 mt-2">
-                  <div>
-                    <PrintText variant="small">Total Pages: {optimization.result.pagination.totalPages}</PrintText>
-                    <PrintText variant="small">Items Per Page: {optimization.result.pagination.itemsPerPage}</PrintText>
-                    <PrintText variant="small">Total Items: {optimization.result.pagination.totalItems}</PrintText>
-                  </div>
-                  <div>
-                    <PrintText variant="small">Estimated Print Time: {optimization.result.optimization.estimatedPrintTime.toFixed(1)} min</PrintText>
-                    <PrintText variant="small">Compression Ratio: {(optimization.result.optimization.compressionRatio * 100).toFixed(1)}%</PrintText>
-                    <PrintText variant="small">Readability Score: {(optimization.result.optimization.readabilityScore * 100).toFixed(1)}%</PrintText>
-                  </div>
-                </div>
-              </div>
-            )}
-
-            {optimization.result?.warnings && optimization.result.warnings.length > 0 && (
-              <div className="mt-4 p-4 bg-yellow-50 border border-yellow-200 rounded">
-                <PrintText variant="small" weight="semibold" color="primary">Warnings</PrintText>
-                <ul className="mt-2">
-                  {optimization.result?.warnings?.map((warning, index) => (
-                    <li key={index} className="text-sm text-yellow-800">• {warning}</li>
-                  ))}
-                </ul>
-              </div>
-            )}
-
-            {optimization.result?.suggestions && optimization.result.suggestions.length > 0 && (
-              <div className="mt-4 p-4 bg-blue-50 border border-blue-200 rounded">
-                <PrintText variant="small" weight="semibold" color="accent">Suggestions</PrintText>
-                <ul className="mt-2">
-                  {optimization.result?.suggestions?.map((suggestion, index) => (
-                    <li key={index} className="text-sm text-blue-800">• {suggestion}</li>
-                  ))}
-                </ul>
-              </div>
-            )}
-          </PrintSection>
-        </PrintSection>
-
-        {/* Pagination Demo */}
-        <PrintSection title="Pagination Demo" background="gray">
-          <PrintSection>
-            <PrintText>
-              Navigate through paginated data with print-optimized controls.
-            </PrintText>
-            
-            <div className="mt-4">
-              <PrintText variant="small" weight="semibold">
-                Page {pagination.currentPage} of {pagination.pagination.totalPages}
-              </PrintText>
-              
-              <div className="flex gap-2 mt-2">
-                <PrintButton
-                  variant="outline"
-                  size="sm"
-                  onClick={pagination.prevPage}
-                  disabled={pagination.currentPage === 1}
-                >
-                  Previous
-                </PrintButton>
-                
-                <PrintButton
-                  variant="outline"
-                  size="sm"
-                  onClick={pagination.nextPage}
-                  disabled={pagination.currentPage === pagination.pagination.totalPages}
-                >
-                  Next
-                </PrintButton>
-                
-                <PrintButton
-                  variant="outline"
-                  size="sm"
-                  onClick={() => pagination.goToPage(1)}
-                >
-                  First
-                </PrintButton>
-                
-                <PrintButton
-                  variant="outline"
-                  size="sm"
-                  onClick={() => pagination.goToPage(pagination.pagination.totalPages)}
-                >
-                  Last
-                </PrintButton>
-              </div>
-            </div>
-          </PrintSection>
-        </PrintSection>
-
-        {/* Grouping Demo */}
-        <PrintSection title="Grouping Demo" background="white" showBorder>
-          <PrintSection>
-            <PrintText>
-              Group data by department with expandable/collapsible sections.
-            </PrintText>
-            
-            <div className="mt-4">
-              <div className="flex gap-2 mb-4">
-                <PrintButton
-                  variant="outline"
-                  size="sm"
-                  onClick={grouping.expandAllGroups}
-                >
-                  Expand All
-                </PrintButton>
-                
-                <PrintButton
-                  variant="outline"
-                  size="sm"
-                  onClick={grouping.collapseAllGroups}
-                >
-                  Collapse All
-                </PrintButton>
-              </div>
-              
-              <div className="space-y-2">
-                {grouping.grouping.groups.map((group) => (
-                  <div key={group.key} className="border border-border rounded">
-                    <div 
-                      className="p-3 bg-muted cursor-pointer"
-                      onClick={() => grouping.toggleGroup(group.key)}
-                    >
-                      <PrintText weight="semibold">
-                        {group.key} ({group.items.length} items)
-                      </PrintText>
-                    </div>
-                    
-                    {grouping.isGroupExpanded(group.key) && (
-                      <div className="p-3">
-                        <PrintDataTable
-                          data={group.items}
-                          columns={tableColumns}
-                          printOptimized={true}
-                        />
-                      </div>
-                    )}
-                  </div>
-                ))}
-              </div>
-            </div>
-          </PrintSection>
-        </PrintSection>
-
-        {/* Preview Demo */}
-        <PrintSection title="Print Preview Demo" background="gray">
-          <PrintSection>
-            <PrintText>
-              Preview print metrics and estimated output before printing.
-            </PrintText>
-            
-            <div className="mt-4">
-              <PrintButton
-                variant="primary"
-                onClick={preview.togglePreview}
-              >
-                {preview.isPreviewVisible ? 'Hide Preview' : 'Show Preview'}
-              </PrintButton>
-              
-              {preview.isPreviewVisible && (
-                <div className="mt-4 p-4 bg-background border border-border rounded">
-                  <PrintText variant="small" weight="semibold">Print Preview</PrintText>
-                  <div className="grid grid-cols-2 gap-4 mt-2">
-                    <div>
-                      <PrintText variant="small">Estimated Pages: {preview.preview.estimatedPages}</PrintText>
-                      <PrintText variant="small">Print Time: {preview.preview.estimatedPrintTime.toFixed(1)} min</PrintText>
-                    </div>
-                    <div>
-                      <PrintText variant="small">Compression: {(preview.preview.compressionRatio * 100).toFixed(1)}%</PrintText>
-                      <PrintText variant="small">Readability: {(preview.preview.readabilityScore * 100).toFixed(1)}%</PrintText>
-                    </div>
-                  </div>
-                </div>
-              )}
-            </div>
-          </PrintSection>
-        </PrintSection>
-
-        {/* Validation Demo */}
-        <PrintSection title="Data Validation Demo" background="white" showBorder>
-          <PrintSection>
-            <PrintText>
-              Validate data for print compatibility and get recommendations.
-            </PrintText>
-            
-            <div className="mt-4">
-              <PrintButton
-                variant="secondary"
-                onClick={validation.validate}
-                disabled={validation.isValidating}
-              >
-                {validation.isValidating ? 'Validating...' : 'Validate Data'}
-              </PrintButton>
-              
-              <div className="mt-4 p-4 bg-muted rounded">
-                <PrintText variant="small" weight="semibold">Validation Results</PrintText>
-                <div className="mt-2">
-                  <PrintText variant="small">
-                    Status: {validation.validation.isValid ? '✅ Valid' : '❌ Invalid'}
-                  </PrintText>
-                  
-                  {validation.validation.errors.length > 0 && (
-                    <div className="mt-2">
-                      <PrintText variant="small" weight="semibold" color="primary">Errors:</PrintText>
-                      <ul className="mt-1">
-                        {validation.validation.errors.map((error, index) => (
-                          <li key={index} className="text-sm text-red-600">• {error}</li>
-                        ))}
-                      </ul>
-                    </div>
-                  )}
-                  
-                  {validation.validation.warnings.length > 0 && (
-                    <div className="mt-2">
-                      <PrintText variant="small" weight="semibold" color="accent">Warnings:</PrintText>
-                      <ul className="mt-1">
-                        {validation.validation.warnings.map((warning, index) => (
-                          <li key={index} className="text-sm text-yellow-600">• {warning}</li>
-                        ))}
-                      </ul>
-                    </div>
-                  )}
-                </div>
-              </div>
-            </div>
-          </PrintSection>
-        </PrintSection>
-
-        {/* Data Table with Print Optimization */}
-        <PrintSection title="Optimized Data Table" background="gray">
-          <PrintSection>
-            <PrintText>
-              Data table with print optimization applied based on current settings.
-            </PrintText>
-            
-            <div className="mt-4">
-              <PrintDataTable
-                data={pagination.paginatedData}
-                columns={tableColumns}
-                printOptimized={true}
-                grouping={{
-                  enabled: true,
-                  groupBy: 'department'
-                }}
-              />
-            </div>
-          </PrintSection>
-        </PrintSection>
-      </div>
-    </PrintLayout>
-  );
-}

package/src/utils/print/index.ts

@@ -1,29 +0,0 @@
-/**
- * @file Print Utilities Exports
- * @package @jmruthers/pace-core
- * @module PrintUtilities
- * @since 0.4.38
- * 
- * Exports for print data processing utilities.
- */
-
-export { PrintDataProcessorImpl, printDataProcessor } from './PrintDataProcessor';
-export { 
-  usePrintOptimization, 
-  usePrintPagination, 
-  usePrintGrouping, 
-  usePrintPreview, 
-  usePrintValidation 
-} from './usePrintOptimization';
-
-export type {
-  PrintDataProcessorOptions,
-  PrintDataProcessorResult,
-  PrintDataProcessorConfig,
-  PrintDataProcessor,
-  PrintDataProcessorHookOptions,
-  PrintDataProcessorHookResult,
-  PrintDataProcessorOptionsKey,
-  PrintDataProcessorResultKey,
-  PrintDataProcessorConfigKey,
-} from './types';

package/src/utils/print/types.ts

@@ -1,196 +0,0 @@
-/**
- * @file Print Data Processing Types
- * @package @jmruthers/pace-core
- * @module PrintDataProcessor
- * @since 0.4.38
- * 
- * Type definitions for print data processing utilities.
- */
-
-export interface PrintDataProcessorOptions {
-  /** Maximum items per page */
-  maxItemsPerPage?: number;
-  
-  /** Maximum characters per line */
-  maxCharactersPerLine?: number;
-  
-  /** Maximum lines per page */
-  maxLinesPerPage?: number;
-  
-  /** Page break strategy */
-  pageBreakStrategy?: 'auto' | 'avoid' | 'force' | 'smart';
-  
-  /** Grouping strategy */
-  groupingStrategy?: 'none' | 'auto' | 'manual' | 'smart';
-  
-  /** Text truncation strategy */
-  truncationStrategy?: 'none' | 'ellipsis' | 'word' | 'character';
-  
-  /** Print optimization level */
-  optimizationLevel?: 'none' | 'basic' | 'advanced' | 'maximum';
-  
-  /** Custom page size */
-  pageSize?: 'A4' | 'A3' | 'A5' | 'Letter' | 'Legal';
-  
-  /** Orientation */
-  orientation?: 'portrait' | 'landscape';
-  
-  /** Font size */
-  fontSize?: number;
-  
-  /** Line height */
-  lineHeight?: number;
-  
-  /** Margins */
-  margins?: {
-    top: number;
-    right: number;
-    bottom: number;
-    left: number;
-  };
-}
-
-export interface PrintDataProcessorResult<T = any> {
-  /** Processed data */
-  data: T[];
-  
-  /** Pagination information */
-  pagination: {
-    totalPages: number;
-    currentPage: number;
-    itemsPerPage: number;
-    totalItems: number;
-  };
-  
-  /** Grouping information */
-  grouping: {
-    groups: Array<{
-      key: string;
-      items: T[];
-      startPage: number;
-      endPage: number;
-    }>;
-    totalGroups: number;
-  };
-  
-  /** Optimization metrics */
-  optimization: {
-    estimatedPages: number;
-    estimatedPrintTime: number;
-    compressionRatio: number;
-    readabilityScore: number;
-  };
-  
-  /** Warnings and suggestions */
-  warnings: string[];
-  suggestions: string[];
-}
-
-export interface PrintDataProcessorConfig {
-  /** Default options */
-  defaultOptions: PrintDataProcessorOptions;
-  
-  /** Page size configurations */
-  pageSizes: Record<string, {
-    width: number;
-    height: number;
-    margin: {
-      top: number;
-      right: number;
-      bottom: number;
-      left: number;
-    };
-  }>;
-  
-  /** Font configurations */
-  fonts: Record<string, {
-    size: number;
-    lineHeight: number;
-    charactersPerLine: number;
-  }>;
-  
-  /** Optimization presets */
-  presets: Record<string, PrintDataProcessorOptions>;
-}
-
-export interface PrintDataProcessor {
-  /** Process data for print optimization */
-  process<T>(data: T[], options?: Partial<PrintDataProcessorOptions>): PrintDataProcessorResult<T>;
-  
-  /** Get pagination information */
-  getPagination<T>(data: T[], options?: Partial<PrintDataProcessorOptions>): {
-    totalPages: number;
-    itemsPerPage: number;
-    totalItems: number;
-  };
-  
-  /** Get grouping information */
-  getGrouping<T>(data: T[], groupBy: keyof T, options?: Partial<PrintDataProcessorOptions>): {
-    groups: Array<{
-      key: string;
-      items: T[];
-      startPage: number;
-      endPage: number;
-    }>;
-    totalGroups: number;
-  };
-  
-  /** Optimize data for print */
-  optimize<T>(data: T[], options?: Partial<PrintDataProcessorOptions>): T[];
-  
-  /** Validate data for print compatibility */
-  validate<T>(data: T[], options?: Partial<PrintDataProcessorOptions>): {
-    isValid: boolean;
-    errors: string[];
-    warnings: string[];
-  };
-  
-  /** Get print preview information */
-  getPreview<T>(data: T[], options?: Partial<PrintDataProcessorOptions>): {
-    estimatedPages: number;
-    estimatedPrintTime: number;
-    compressionRatio: number;
-    readabilityScore: number;
-  };
-}
-
-export interface PrintDataProcessorHookOptions {
-  /** Data to process */
-  data: any[];
-  
-  /** Processing options */
-  options?: Partial<PrintDataProcessorOptions>;
-  
-  /** Auto-process on data change */
-  autoProcess?: boolean;
-  
-  /** Debounce delay for auto-processing */
-  debounceDelay?: number;
-}
-
-export interface PrintDataProcessorHookResult<T = any> {
-  /** Processed data result */
-  result: PrintDataProcessorResult<T> | null;
-  
-  /** Processing state */
-  isProcessing: boolean;
-  
-  /** Error state */
-  error: string | null;
-  
-  /** Process data manually */
-  process: (options?: Partial<PrintDataProcessorOptions>) => void;
-  
-  /** Reset processing state */
-  reset: () => void;
-  
-  /** Update data */
-  updateData: (data: any[]) => void;
-  
-  /** Update options */
-  updateOptions: (options: Partial<PrintDataProcessorOptions>) => void;
-}
-
-export type PrintDataProcessorOptionsKey = keyof PrintDataProcessorOptions;
-export type PrintDataProcessorResultKey = keyof PrintDataProcessorResult;
-export type PrintDataProcessorConfigKey = keyof PrintDataProcessorConfig;