@jmruthers/pace-core 0.5.54 → 0.5.56

package/dist/chunk-WJARTBCT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils/debugLogger.ts","../src/utils/cn.ts","../src/utils/organisationContext.ts"],"sourcesContent":["/**\n * @file Debug Logger Utility\n * @package @jmruthers/pace-core\n * @module Utils/DebugLogger\n * @since 0.4.76\n */\n\n/**\n * Debug logger that respects environment settings\n * Only logs in development mode to prevent production console spam\n */\nexport class DebugLogger {\n  private static isDevelopment = process.env.NODE_ENV === 'development';\n\n  /**\n   * Log debug information only in development mode\n   */\n  static log(component: string, message: string, ...args: any[]): void {\n    if (this.isDevelopment) {\n      console.log(`[${component}] ${message}`, ...args);\n    }\n  }\n\n  /**\n   * Log error information (always logged)\n   */\n  static error(component: string, message: string, ...args: any[]): void {\n    console.error(`[${component}] ${message}`, ...args);\n  }\n\n  /**\n   * Log warning information (always logged)\n   */\n  static warn(component: string, message: string, ...args: any[]): void {\n    console.warn(`[${component}] ${message}`, ...args);\n  }\n\n  /**\n   * Log info information only in development mode\n   */\n  static info(component: string, message: string, ...args: any[]): void {\n    if (this.isDevelopment) {\n      console.info(`[${component}] ${message}`, ...args);\n    }\n  }\n}\n","\nimport { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}","/**\n * @file Organisation Context Utility\n * @package @jmruthers/pace-core\n * @module Utils/OrganisationContext\n * @since 0.4.0\n *\n * Utility functions for managing organisation context in database sessions.\n * Provides fallback mechanisms for when database functions are not available.\n */\n\nimport type { SupabaseClient } from '@supabase/supabase-js';\n\n/**\n * Set organisation context in the database session\n * \n * This function attempts to set the organisation context using a database function.\n * If the function is not available, it falls back gracefully without throwing errors.\n * \n * @param supabase - Supabase client instance\n * @param organisationId - The organisation ID to set as context\n * @returns Promise that resolves when context is set (or falls back gracefully)\n */\nexport async function setOrganisationContext(\n  supabase: SupabaseClient,\n  organisationId: string\n): Promise<void> {\n  if (!supabase || !organisationId) {\n    // TODO: Replace with proper logging service integration\n    return;\n  }\n\n  try {\n    // Try to call the database function to set organisation context\n    const { error } = await supabase.rpc('set_organisation_context', {\n      org_id: organisationId\n    });\n\n    if (error) {\n      // Function might not exist yet - this is expected during migration\n      // Silent fail - will fall back to client-side filtering\n      // TODO: Replace with proper logging service integration\n    } else {\n      // TODO: Replace with proper logging service integration\n    }\n  } catch (error) {\n    // Handle any other errors gracefully\n    // Silent fail - will fall back to client-side filtering\n    // TODO: Replace with proper logging service integration\n  }\n}\n\n/**\n * Clear organisation context from the database session\n * \n * @param supabase - Supabase client instance\n * @returns Promise that resolves when context is cleared\n */\nexport async function clearOrganisationContext(\n  supabase: SupabaseClient\n): Promise<void> {\n  if (!supabase) {\n    // TODO: Replace with proper logging service integration\n    return;\n  }\n\n  try {\n    const { error } = await supabase.rpc('clear_organisation_context');\n    \n    if (error) {\n      // Silent fail - function not available\n      // TODO: Replace with proper logging service integration\n    } else {\n      // TODO: Replace with proper logging service integration\n    }\n  } catch (error) {\n    // Silent fail - error occurred\n    // TODO: Replace with proper logging service integration\n  }\n}\n\n/**\n * Get current organisation context from the database session\n * \n * @param supabase - Supabase client instance\n * @returns Promise that resolves to the current organisation ID or null\n */\nexport async function getOrganisationContext(\n  supabase: SupabaseClient\n): Promise<string | null> {\n  if (!supabase) {\n    // TODO: Replace with proper logging service integration\n    return null;\n  }\n\n  try {\n    const { data, error } = await supabase.rpc('get_organisation_context');\n    \n    if (error) {\n      // TODO: Replace with proper logging service integration\n      return null;\n    }\n    \n    // TODO: Replace with proper logging service integration\n    return data;\n  } catch (error) {\n    // TODO: Replace with proper logging service integration\n    return null;\n  }\n}\n\n/**\n * Check if organisation context functions are available in the database\n * \n * @param supabase - Supabase client instance\n * @returns Promise that resolves to true if functions are available\n */\nexport async function isOrganisationContextAvailable(\n  supabase: SupabaseClient\n): Promise<boolean> {\n  if (!supabase) {\n    return false;\n  }\n\n  try {\n    const { error } = await supabase.rpc('get_organisation_context');\n    \n    if (error) {\n      return false;\n    }\n    \n    return true;\n  } catch (error) {\n    return false;\n  }\n} "],"mappings":";;;;;AAAA,IAWa;AAXb;AAAA;AAAA;AAWO,IAAM,cAAN,MAAkB;AAAA;AAAA;AAAA;AAAA,MAMvB,OAAO,IAAI,WAAmB,YAAoB,MAAmB;AACnE,YAAI,KAAK,eAAe;AACtB,kBAAQ,IAAI,IAAI,SAAS,KAAK,OAAO,IAAI,GAAG,IAAI;AAAA,QAClD;AAAA,MACF;AAAA;AAAA;AAAA;AAAA,MAKA,OAAO,MAAM,WAAmB,YAAoB,MAAmB;AACrE,gBAAQ,MAAM,IAAI,SAAS,KAAK,OAAO,IAAI,GAAG,IAAI;AAAA,MACpD;AAAA;AAAA;AAAA;AAAA,MAKA,OAAO,KAAK,WAAmB,YAAoB,MAAmB;AACpE,gBAAQ,KAAK,IAAI,SAAS,KAAK,OAAO,IAAI,GAAG,IAAI;AAAA,MACnD;AAAA;AAAA;AAAA;AAAA,MAKA,OAAO,KAAK,WAAmB,YAAoB,MAAmB;AACpE,YAAI,KAAK,eAAe;AACtB,kBAAQ,KAAK,IAAI,SAAS,KAAK,OAAO,IAAI,GAAG,IAAI;AAAA,QACnD;AAAA,MACF;AAAA,IACF;AAjCE,IADW,YACI,gBAAgB;AAAA;AAAA;;;ACXjC,SAA0B,YAAY;AACtC,SAAS,eAAe;AAEjB,SAAS,MAAM,QAAsB;AAC1C,SAAO,QAAQ,KAAK,MAAM,CAAC;AAC7B;AANA;AAAA;AAAA;AAAA;AAAA;;;ACsBA,eAAsB,uBACpB,UACA,gBACe;AACf,MAAI,CAAC,YAAY,CAAC,gBAAgB;AAEhC;AAAA,EACF;AAEA,MAAI;AAEF,UAAM,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,4BAA4B;AAAA,MAC/D,QAAQ;AAAA,IACV,CAAC;AAED,QAAI,OAAO;AAAA,IAIX,OAAO;AAAA,IAEP;AAAA,EACF,SAAS,OAAO;AAAA,EAIhB;AACF;AAQA,eAAsB,yBACpB,UACe;AACf,MAAI,CAAC,UAAU;AAEb;AAAA,EACF;AAEA,MAAI;AACF,UAAM,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,4BAA4B;AAEjE,QAAI,OAAO;AAAA,IAGX,OAAO;AAAA,IAEP;AAAA,EACF,SAAS,OAAO;AAAA,EAGhB;AACF;AAQA,eAAsB,uBACpB,UACwB;AACxB,MAAI,CAAC,UAAU;AAEb,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,EAAE,MAAM,MAAM,IAAI,MAAM,SAAS,IAAI,0BAA0B;AAErE,QAAI,OAAO;AAET,aAAO;AAAA,IACT;AAGA,WAAO;AAAA,EACT,SAAS,OAAO;AAEd,WAAO;AAAA,EACT;AACF;AAQA,eAAsB,+BACpB,UACkB;AAClB,MAAI,CAAC,UAAU;AACb,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,0BAA0B;AAE/D,QAAI,OAAO;AACT,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT,SAAS,OAAO;AACd,WAAO;AAAA,EACT;AACF;AAtIA;AAAA;AAAA;AAAA;AAAA;","names":[]}

package/dist/chunk-YDJW5XTN.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types/unified.ts"],"sourcesContent":["/**\n * @file Unified types for PACE Core\n * @package @jmruthers/pace-core\n * @module unified\n * @since 0.1.0\n */\n\n/**\n * @file Unified Types for DataTable\n * @package @jmruthers/pace-core\n * @module Types\n * @since 0.3.0\n */\n\n// Authentication Error Codes\nexport enum AuthErrorCode {\n  UNKNOWN_ERROR = 'UNKNOWN_ERROR',\n  INVALID_CREDENTIALS = 'INVALID_CREDENTIALS',\n  USER_NOT_FOUND = 'USER_NOT_FOUND',\n  EMAIL_NOT_CONFIRMED = 'EMAIL_NOT_CONFIRMED',\n  PASSWORD_TOO_WEAK = 'PASSWORD_TOO_WEAK',\n  WEAK_PASSWORD = 'WEAK_PASSWORD',\n  RATE_LIMITED = 'RATE_LIMITED',\n  RATE_LIMIT_EXCEEDED = 'RATE_LIMIT_EXCEEDED',\n  SESSION_EXPIRED = 'SESSION_EXPIRED',\n  PERMISSION_DENIED = 'PERMISSION_DENIED',\n  NETWORK_ERROR = 'NETWORK_ERROR'\n}\n\n// Permission Error Codes\nexport enum PermissionErrorCode {\n  INSUFFICIENT_PERMISSIONS = 'INSUFFICIENT_PERMISSIONS',\n  INVALID_PERMISSION = 'INVALID_PERMISSION',\n  PERMISSION_CHECK_FAILED = 'PERMISSION_CHECK_FAILED',\n  ACCESS_DENIED = 'ACCESS_DENIED'\n}\n\n// Access Levels - using lowercase to match test expectations\nexport enum AccessLevel {\n  NONE = 'none',\n  VIEWER = 'viewer',\n  PARTICIPANT = 'participant',\n  EDITOR = 'editor',\n  PLANNER = 'planner',\n  ADMIN = 'admin',\n  SUPER_ADMIN = 'super_admin',\n  SUPER = 'super'\n}\n\n// Branded Types\nexport type UserId = string & { __brand: 'UserId' };\nexport type SessionToken = string & { __brand: 'SessionToken' };\nexport type PermissionString = string & { __brand: 'PermissionString' };\nexport type RequestId = string & { __brand: 'RequestId' };\n\n// Branded Type Creators\nexport function createUserId(id: string): UserId {\n  return id as UserId;\n}\n\nexport function createSessionToken(token: string): SessionToken {\n  return token as SessionToken;\n}\n\nexport function createPermissionString(permission: string): PermissionString {\n  return permission as PermissionString;\n}\n\nexport function createRequestId(id: string): RequestId {\n  return id as RequestId;\n}\n\n// Type Guards for branded types\nexport function isUserId(value: unknown): value is UserId {\n  return typeof value === 'string' && value.length > 0;\n}\n\nexport function isSessionToken(value: unknown): value is SessionToken {\n  return typeof value === 'string' && value.length > 0;\n}\n\nexport function isPermissionString(value: unknown): value is PermissionString {\n  if (typeof value !== 'string' || value.length === 0) return false;\n  // Basic validation for permission format (resource:action)\n  return value.includes(':') && value.split(':').length === 2;\n}\n\nexport function isRequestId(value: unknown): value is RequestId {\n  return typeof value === 'string' && value.length > 0;\n}\n\n// Permission Types\nexport type PermissionMap = Record<string, boolean>;\n\n// Permission Context\nexport interface PermissionContext {\n  eventId?: string;\n  appName?: string;\n  userId?: string;\n}\n\n// Auth Error Interface - Define locally to avoid circular dependency\nexport interface AuthError extends Error {\n  __isAuthError: true;\n  name: 'AuthError';\n  message: string;\n  code: AuthErrorCode;\n  user_message: string;\n  timestamp: number;\n}\n\n// Permission Error Interface\nexport interface PermissionError extends Error {\n  __isPermissionError: true;\n  name: 'PermissionError';\n  message: string;\n  code: PermissionErrorCode;\n  timestamp: number;\n}\n\n// Theme Types - Consolidated from theme.ts\nexport interface ThemeColors {\n  primary: string;\n  secondary: string;\n  hover?: string;\n  active?: string;\n  bgSoft?: string;\n}\n\nexport interface EventTheme {\n  mid: ThemeColors;\n  light: ThemeColors;\n}\n\n// Event Types - Updated to match database schema exactly with organisation context\nexport interface Event {\n  // Primary identification\n  id: string;\n  event_id: string;\n  event_name: string;\n  event_code?: string;\n  \n  // Organisation context - MANDATORY for security\n  organisation_id: string;\n  \n  // Event details\n  event_date?: string; // Use event_date from database for proper sorting\n  event_days?: number;\n  event_venue?: string;\n  event_participants?: number;\n  is_visible?: boolean;\n  \n  // Visual branding\n  event_logo?: string;\n  event_colours?: Record<string, unknown> | null; // JSONB field for theme colors\n  event_col_d1?: string;\n  event_col_d2?: string;\n  event_col_m1?: string;\n  event_col_m2?: string;\n  event_col_l1?: string;\n  event_col_l2?: string;\n  \n  // Additional metadata\n  event_news?: string;\n  event_billing?: string;\n  event_catering_email?: string;\n  event_email?: string;\n  event_footer?: string;\n  event_rounddown?: number;\n  event_youthmultiplier?: number;\n  event_typicalunit?: number;\n  \n  // Timestamps\n  created_at: string;\n  updated_at: string;\n  created_by?: string;\n  updated_by?: string;\n  \n  // Legacy compatibility\n  name?: string; // Alias for event_name\n  description?: string;\n  start_date?: string; // Alias for event_date\n  end_date?: string;\n  theme_colors?: EventTheme;\n}\n\n// Event Context Type\nexport interface EventContextType {\n  selectedEvent: Event | null;\n  currentEvent: Event | null; // Added missing property\n  events: Event[];\n  isLoading: boolean;\n  error: string | null;\n  selectEvent: (event: Event) => void;\n  setCurrentEvent: (event: Event | null) => void; // Added missing property\n  clearSelection: () => void;\n  refreshEvents: () => Promise<void>;\n  createEvent: (event: Partial<Event>) => Promise<Event>;\n  updateEvent: (id: string, updates: Partial<Event>) => Promise<Event>;\n  deleteEvent: (id: string) => Promise<void>;\n}\n\n// RBAC Types\nexport interface UserPermissions {\n  user_id: UserId;\n  accessLevel: AccessLevel;\n  permissions: PermissionMap;\n  roles: string[];\n}\n\n// Re-export standard Supabase types for consistency\n// Note: These are the same as what's in @supabase/supabase-js\nexport interface User {\n  id: string;\n  email?: string;\n  created_at: string;\n  updated_at: string;\n  email_confirmed_at?: string;\n  last_sign_in_at?: string;\n  user_metadata?: Record<string, unknown>;\n  app_metadata?: Record<string, unknown>;\n}\n\nexport interface Session {\n  access_token: string;\n  refresh_token?: string;\n  expires_in: number;\n  expires_at: number;\n  token_type: string;\n  user: User;\n  provider_token?: string;\n  provider_refresh_token?: string;\n}\n\nexport interface DataRecord {\n  id: string | number;\n  [key: string]: unknown;\n}\n\nexport interface DataTableAction<T = unknown> {\n  label: string;\n  onClick: (row: T) => void;\n  testId?: string;\n  disabled?: boolean | ((row: T) => boolean);\n  variant?: 'primary' | 'secondary' | 'destructive';\n}\n\nexport interface DataTableColumn<T = unknown> {\n  id?: string;\n  key: string;\n  label: string;\n  sortable?: boolean;\n  filterable?: boolean;\n  accessorKey?: keyof T;\n  accessorFn?: (row: T) => unknown;\n  cell?: (value: unknown, row: T) => React.ReactNode;\n  header?: React.ReactNode;\n  enableSorting?: boolean;\n  enableColumnFilter?: boolean;\n  enableGrouping?: boolean;\n  enableHiding?: boolean;\n}\n"],"mappings":";;;;;AAwDO,SAAS,aAAa,IAAoB;AAC/C,SAAO;AACT;AAEO,SAAS,mBAAmB,OAA6B;AAC9D,SAAO;AACT;AAEO,SAAS,uBAAuB,YAAsC;AAC3E,SAAO;AACT;AAEO,SAAS,gBAAgB,IAAuB;AACrD,SAAO;AACT;AAGO,SAAS,SAAS,OAAiC;AACxD,SAAO,OAAO,UAAU,YAAY,MAAM,SAAS;AACrD;AAEO,SAAS,eAAe,OAAuC;AACpE,SAAO,OAAO,UAAU,YAAY,MAAM,SAAS;AACrD;AAEO,SAAS,mBAAmB,OAA2C;AAC5E,MAAI,OAAO,UAAU,YAAY,MAAM,WAAW,EAAG,QAAO;AAE5D,SAAO,MAAM,SAAS,GAAG,KAAK,MAAM,MAAM,GAAG,EAAE,WAAW;AAC5D;AAEO,SAAS,YAAY,OAAoC;AAC9D,SAAO,OAAO,UAAU,YAAY,MAAM,SAAS;AACrD;AAzFA,IAeY,eAeA,qBAQA;AAtCZ;AAAA;AAAA;AAeO,IAAK,gBAAL,kBAAKA,mBAAL;AACL,MAAAA,eAAA,mBAAgB;AAChB,MAAAA,eAAA,yBAAsB;AACtB,MAAAA,eAAA,oBAAiB;AACjB,MAAAA,eAAA,yBAAsB;AACtB,MAAAA,eAAA,uBAAoB;AACpB,MAAAA,eAAA,mBAAgB;AAChB,MAAAA,eAAA,kBAAe;AACf,MAAAA,eAAA,yBAAsB;AACtB,MAAAA,eAAA,qBAAkB;AAClB,MAAAA,eAAA,uBAAoB;AACpB,MAAAA,eAAA,mBAAgB;AAXN,aAAAA;AAAA,OAAA;AAeL,IAAK,sBAAL,kBAAKC,yBAAL;AACL,MAAAA,qBAAA,8BAA2B;AAC3B,MAAAA,qBAAA,wBAAqB;AACrB,MAAAA,qBAAA,6BAA0B;AAC1B,MAAAA,qBAAA,mBAAgB;AAJN,aAAAA;AAAA,OAAA;AAQL,IAAK,cAAL,kBAAKC,iBAAL;AACL,MAAAA,aAAA,UAAO;AACP,MAAAA,aAAA,YAAS;AACT,MAAAA,aAAA,iBAAc;AACd,MAAAA,aAAA,YAAS;AACT,MAAAA,aAAA,aAAU;AACV,MAAAA,aAAA,WAAQ;AACR,MAAAA,aAAA,iBAAc;AACd,MAAAA,aAAA,WAAQ;AARE,aAAAA;AAAA,OAAA;AAAA;AAAA;","names":["AuthErrorCode","PermissionErrorCode","AccessLevel"]}

package/docs/print-components/README.md

@@ -1,258 +0,0 @@
-# Print Components
-
-> **🎨 Print-Optimized Layout System** | [Quick Start](./quick-start.md) | [API Reference](./api-reference.md) | [Examples](./examples/)
-
-A comprehensive suite of print-optimized React components designed for creating professional reports, documents, and printable content. Built with print-first design principles and A4 page optimization.
-
-## 🚀 Quick Start
-
-```bash
-npm install @jmruthers/pace-core
-```
-
-```tsx
-import { 
-  PrintLayout, 
-  PrintHeader, 
-  PrintDataTable, 
-  PrintText 
-} from '@jmruthers/pace-core';
-
-// Import the core CSS file
-import '@jmruthers/pace-core/styles/core.css';
-
-function ReportPage() {
-  return (
-    <PrintLayout orientation="portrait" pageSize="A4">
-      <PrintHeader 
-        title="Monthly Report"
-        branding={{
-          companyName: "Your Company",
-          projectName: "Q4 Analytics"
-        }}
-      />
-      <PrintDataTable 
-        data={reportData}
-        columns={columns}
-        title="Sales Summary"
-      />
-    </PrintLayout>
-  );
-}
-```
-
-## 📋 Overview
-
-The print components system provides everything you need to create professional, print-optimized documents:
-
-### **Core Components**
-- **`PrintLayout`** - Base layout with page size and orientation control
-- **`PrintHeader`** - Flexible headers with branding and metadata
-- **`PrintCoverHeader`** - Cover page headers for first pages
-- **`PrintFooter`** - Page footers with numbering and content
-- **`PrintText`** - Print-optimized typography system
-
-### **Data Components**
-- **`PrintDataTable`** - Print-optimized data tables with grouping
-- **`PrintCard`** - Flexible card layouts for content
-- **`PrintSection`** - Content organization with columns
-- **`PrintGrid`** - Responsive grid system
-
-### **Utility Components**
-- **`PrintButton`** - Print functionality with callbacks
-- **`PrintPageBreak`** - Explicit page break controls
-- **`PrintDivider`** - Visual separators
-
-## 🎯 Use Cases
-
-### **1. Business Reports**
-Create professional reports with data tables, charts, and executive summaries.
-
-```tsx
-<PrintLayout orientation="landscape" pageSize="A4">
-  <PrintCoverHeader 
-    title="Q4 Financial Report"
-    subtitle="Performance Analysis & Strategic Overview"
-    branding={{
-      logo: "/logo.png",
-      companyName: "Acme Corp",
-      version: "v2024.1"
-    }}
-  />
-  <PrintDataTable 
-    data={financialData}
-    columns={financialColumns}
-    grouping={{ enabled: true, groupBy: 'quarter' }}
-  />
-</PrintLayout>
-```
-
-### **2. Document Generation**
-Build user guides, technical documentation, and manuals.
-
-```tsx
-<PrintLayout orientation="portrait" pageSize="A4">
-  <PrintHeader title="User Manual" />
-  <PrintSection title="Getting Started">
-    <PrintText variant="heading">Installation</PrintText>
-    <PrintText variant="body">
-      Follow these steps to install the application...
-    </PrintText>
-  </PrintSection>
-  <PrintPageBreak type="before" />
-  <PrintSection title="Configuration">
-    {/* More content */}
-  </PrintSection>
-</PrintLayout>
-```
-
-### **3. Card-Based Layouts**
-Create catalogs, directories, and reference materials.
-
-```tsx
-<PrintGrid columns={3} printColumns={2}>
-  {products.map(product => (
-    <PrintCard
-      key={product.id}
-      title={product.name}
-      subtitle={product.category}
-      image={{ src: product.image, alt: product.name }}
-      metadata={[
-        { label: "Price", value: product.price },
-        { label: "Stock", value: product.stock }
-      ]}
-    />
-  ))}
-</PrintGrid>
-```
-
-## 🎨 Design System
-
-### **Print Optimization**
-- **A4 Page Support** - Optimized for A4 portrait and landscape
-- **Print Media Queries** - Automatic print-specific styling
-- **High Contrast** - Optimized colors for print readability
-- **Page Breaks** - Intelligent page break management
-- **Margins** - Proper print margins and safe areas
-
-### **Typography**
-- **Print-Optimized Fonts** - 12pt base size for readability
-- **Consistent Hierarchy** - Heading, subheading, body, caption variants
-- **High Contrast** - Black text on white background for print
-
-### **Layout Principles**
-- **Print-First Design** - Optimized for print, works on screen
-- **Responsive Breakpoints** - Different layouts for screen vs print
-- **Consistent Spacing** - Standardized spacing system
-- **Clear Hierarchy** - Visual hierarchy optimized for print
-
-## 🔧 Configuration
-
-### **Page Sizes**
-```tsx
-// A4 Portrait (default)
-<PrintLayout pageSize="A4" orientation="portrait" />
-
-// A4 Landscape
-<PrintLayout pageSize="A4" orientation="landscape" />
-
-// Future: A3, A5 support
-<PrintLayout pageSize="A3" orientation="portrait" />
-```
-
-### **Headers & Footers**
-```tsx
-// Different headers for first page vs subsequent pages
-<PrintLayout 
-  firstPageHeader={<PrintCoverHeader title="Annual Report" />}
-  subsequentPageHeader={<PrintHeader title="Annual Report" />}
->
-  {/* Content */}
-</PrintLayout>
-```
-
-### **Print Optimization**
-```tsx
-// Enable print optimization (default: true)
-<PrintDataTable 
-  data={data}
-  columns={columns}
-  printOptimized={true}
-/>
-
-// Disable for screen-only layouts
-<PrintCard printOptimized={false}>
-  Content
-</PrintCard>
-```
-
-## 📚 Documentation
-
-### **Getting Started**
-- **[Quick Start Guide](./quick-start.md)** - 5-minute setup
-- **[Installation Guide](./installation.md)** - Detailed setup
-- **[Examples](./examples/)** - Complete working examples
-
-### **Component Reference**
-- **[API Reference](./api-reference.md)** - Complete component APIs
-- **[Props Reference](./props-reference.md)** - Detailed prop documentation
-- **[Type Definitions](./types.md)** - TypeScript interfaces
-
-### **Advanced Usage**
-- **[Customization Guide](./customization.md)** - Styling and theming
-- **[Performance Guide](./performance.md)** - Optimization tips
-- **[Troubleshooting](./troubleshooting.md)** - Common issues and solutions
-
-### **Integration**
-- **[React Integration](./react-integration.md)** - Using with React apps
-- **[Next.js Integration](./nextjs-integration.md)** - Next.js specific setup
-- **[Vite Integration](./vite-integration.md)** - Vite configuration
-
-## 🎯 Best Practices
-
-### **1. Use Print-First Design**
-Design your layouts with print in mind, then adapt for screen.
-
-### **2. Test Print Output**
-Always test your layouts using browser print preview (Ctrl+P / Cmd+P).
-
-### **3. Optimize for A4**
-Design for A4 page size as the primary target format.
-
-### **4. Use Semantic Components**
-Choose the right component for your content type:
-- `PrintDataTable` for tabular data
-- `PrintCard` for item summaries
-- `PrintSection` for content organization
-
-### **5. Leverage Grouping**
-Use data grouping for better print organization:
-
-```tsx
-<PrintDataTable 
-  data={data}
-  columns={columns}
-  grouping={{
-    enabled: true,
-    groupBy: 'department',
-    groupHeader: (group) => <DepartmentHeader group={group} />
-  }}
-/>
-```
-
-## 🔗 Related Documentation
-
-- **[Main Documentation](../README.md)** - Complete pace-core documentation
-- **[Styling Guide](../styles/README.md)** - Design system and theming
-- **[Component Library](../api-reference/components.md)** - All available components
-- **[Migration Guide](../migration/README.md)** - Upgrading from previous versions
-
-## 📞 Support
-
-- **Issues**: [GitHub Issues](https://github.com/jmruthers/pace-core/issues)
-- **Discussions**: [GitHub Discussions](https://github.com/jmruthers/pace-core/discussions)
-- **Documentation**: [Full Documentation](../README.md)
-
----
-
-**Ready to get started?** Check out the [Quick Start Guide](./quick-start.md) to build your first print-optimized document in 5 minutes! 🚀