@jmruthers/pace-core 0.4.1 → 0.5.1

package/dist/validation.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export { g as changePasswordSchema, w as combineSchemas, i as contactFormSchema, d as dateSchema, e as emailSchema, l as loginSchema, n as nameSchema, f as passwordResetSchema, b as passwordSchema, p as phoneSchema, v as pickSchema, r as registrationSchema, c as secureLoginSchema, s as securePasswordSchema, u as urlSchema, h as userProfileSchema } from './validation-D2-NNCCE.js';
+export { g as changePasswordSchema, w as combineSchemas, i as contactFormSchema, d as dateSchema, e as emailSchema, l as loginSchema, n as nameSchema, f as passwordResetSchema, b as passwordSchema, p as phoneSchema, v as pickSchema, r as registrationSchema, c as secureLoginSchema, s as securePasswordSchema, u as urlSchema, h as userProfileSchema } from './validation-PM_iOaTI.js';
 
 /**
  * @file Input sanitization and validation schemas

package/dist/validation.js

@@ -19,7 +19,7 @@ import {
 import {
   secureStorage
 } from "./chunk-5CDJCTOO.js";
-import "./chunk-DC5AMYBS.js";
+import "./chunk-PLDDJCW6.js";
 
 // src/validation/sanitization.ts
 import { z } from "zod";

package/docs/INDEX.md

@@ -0,0 +1,192 @@
+# PACE Core Documentation Index
+
+> **📚 Complete Documentation Reference** | [Quick Start](./getting-started/quick-start.md) | [API Reference](./api-reference/components.md) | [Troubleshooting](./troubleshooting/README.md)
+
+Complete index of all PACE Core documentation organized by topic and use case.
+
+## 🚀 Getting Started
+
+### First Time Users
+- **[Installation](./getting-started/installation.md)** - Package installation and basic setup
+- **[Quick Start](./getting-started/quick-start.md)** - Build your first app in 10 minutes
+- **[Examples](./getting-started/examples/README.md)** - Complete working examples
+
+### Configuration
+- **[Vite Configuration](./consuming-app-vite-config.md)** - **CRITICAL** Tailwind v4 setup
+- **[Environment Setup](./getting-started/environment-setup.md)** - Environment variables
+- **[Build Configuration](./getting-started/build-configuration.md)** - Build tool setup
+
+## 🏗️ Core Features
+
+### Authentication & Security
+- **[Authentication Overview](./core-concepts/authentication.md)** - User management and sessions
+- **[RBAC System](./rbac/README.md)** - Role-based access control
+- **[Security Best Practices](./best-practices/security.md)** - Security guidelines
+- **[Permission Enforcement](./implementation-guides/permission-enforcement.md)** - Implementing permissions
+
+### Data Management
+- **[Data Tables](./implementation-guides/data-tables.md)** - Interactive data management
+- **[Forms](./implementation-guides/forms.md)** - Form handling and validation
+- **[Event Management](./core-concepts/event-management.md)** - Event selection and context
+- **[Organisation Management](./core-concepts/organisation-management.md)** - Multi-tenant support
+- **[Public Pages](./implementation-guides/public-pages.md)** - **NEW** Public pages without authentication
+
+### UI & Layout
+- **[Components API](./api-reference/components.md)** - Complete component reference
+- **[App Layout](./implementation-guides/app-layout.md)** - Application structure
+- **[Navigation](./implementation-guides/navigation.md)** - Navigation patterns
+- **[Print Components](./print-components/README.md)** - Print-optimized layouts
+
+## 🎨 Styling & Theming
+
+### Design System
+- **[Styling Overview](./styles/README.md)** - Complete design system
+- **[Color Palettes](./styles/color-palettes.md)** - Main, secondary, accent colors
+- **[Typography](./styles/typography.md)** - Font families and text styles
+- **[Component Styling](./styles/component-styling.md)** - How components are styled
+
+### Customization
+- **[Custom Themes](./styles/custom-themes.md)** - Creating custom themes
+- **[Dynamic Theming](./styles/dynamic-theming.md)** - Runtime theme switching
+- **[CSS Architecture](./styles/css-architecture.md)** - Single-file CSS approach
+
+## 🔧 API Reference
+
+### Components
+- **[UI Components](./api-reference/components.md)** - Button, Card, Input, etc.
+- **[Data Components](./api-reference/components.md#data-table)** - DataTable, Form, etc.
+- **[Layout Components](./api-reference/components.md#layout-components)** - PaceAppLayout, Header, etc.
+- **[Print Components](./api-reference/components.md#print-components)** - Print-optimized components
+
+### Hooks & Utilities
+- **[React Hooks](./api-reference/hooks.md)** - useUnifiedAuth, useCan, etc.
+- **[RBAC Hooks](./rbac/README.md#hooks)** - Permission checking hooks
+- **[Utilities](./api-reference/utilities.md)** - Helper functions
+
+## 🎯 Best Practices
+
+### Development
+- **[Best Practices Overview](./best-practices/README.md)** - Comprehensive guide
+- **[Performance](./best-practices/performance.md)** - Optimization strategies
+- **[Testing](./best-practices/testing.md)** - Testing patterns
+- **[Code Quality](./best-practices/README.md#code-quality)** - TypeScript, organization
+
+### Production
+- **[Deployment](./best-practices/deployment.md)** - Production deployment
+- **[Security](./best-practices/security.md)** - Security guidelines
+- **[Monitoring](./best-practices/README.md#monitoring)** - Performance monitoring
+
+## 🐛 Troubleshooting
+
+### Common Issues
+- **[Troubleshooting Overview](./troubleshooting/README.md)** - Complete guide
+- **[Common Issues](./troubleshooting/common-issues.md)** - Frequent problems
+- **[Styling Issues](./troubleshooting/styling-issues.md)** - Component styling
+- **[Authentication Issues](./troubleshooting/authentication-issues.md)** - Auth problems
+
+### Debugging
+- **[Debugging Guide](./troubleshooting/debugging.md)** - Debug techniques
+- **[Performance Issues](./troubleshooting/performance-issues.md)** - Performance problems
+- **[Build Issues](./troubleshooting/build-issues.md)** - Build and deployment
+
+## 🔄 Migration & Updates
+
+### Version Updates
+- **[Migration Overview](./migration/README.md)** - Upgrade guides
+- **[v0.4.17 Source Path Fix](./migration/v0.4.17-source-path-fix.md)** - **CRITICAL** Fix
+- **[v0.4.16 CSS-First Migration](./migration/v0.4.16-css-first-approach.md)** - Simplified config
+- **[v0.4.15 Tailwind Scanning](./migration/v0.4.15-tailwind-scanning.md)** - Legacy approach
+
+### Breaking Changes
+- **[v0.x to v1.x](./migration/v0-to-v1.md)** - Major version upgrade
+- **[RBAC Migration](./migration/rbac-migration.md)** - RBAC system updates
+- **[Component Updates](./migration/component-updates.md)** - Component API changes
+
+## 📖 Core Concepts
+
+### Understanding PACE Core
+- **[Architecture](./architecture/README.md)** - System architecture
+- **[Design Principles](./core-concepts/design-principles.md)** - Core design philosophy
+- **[Security Model](./core-concepts/security-model.md)** - Security architecture
+- **[Performance Model](./core-concepts/performance-model.md)** - Performance considerations
+
+### Key Concepts
+- **[Permissions](./core-concepts/permissions.md)** - Permission system
+- **[Events](./core-concepts/events.md)** - Event management
+- **[Organisations](./core-concepts/organisations.md)** - Multi-tenancy
+- **[Context Management](./core-concepts/context-management.md)** - React context usage
+
+## 🛠️ Implementation Guides
+
+### Application Structure
+- **[App Layout](./implementation-guides/app-layout.md)** - Layout patterns
+- **[Navigation](./implementation-guides/navigation.md)** - Navigation systems
+- **[Routing](./implementation-guides/routing.md)** - URL routing
+- **[State Management](./implementation-guides/state-management.md)** - Application state
+
+### Data & Forms
+- **[Data Tables](./implementation-guides/data-tables.md)** - Data management
+- **[Forms](./implementation-guides/forms.md)** - Form implementation
+- **[Validation](./implementation-guides/validation.md)** - Input validation
+- **[File Upload](./implementation-guides/file-upload.md)** - File handling
+
+### Advanced Features
+- **[Permission Enforcement](./implementation-guides/permission-enforcement.md)** - Security implementation
+- **[Event Management](./implementation-guides/event-management.md)** - Event handling
+- **[Organisation Management](./implementation-guides/organisation-management.md)** - Multi-tenancy
+- **[Print Reports](./implementation-guides/print-reports.md)** - Report generation
+
+## 🎨 Styling Guides
+
+### Design System
+- **[Design Tokens](./styles/design-tokens.md)** - Design system tokens
+- **[Color System](./styles/color-system.md)** - Color management
+- **[Typography](./styles/typography.md)** - Text styling
+- **[Spacing](./styles/spacing.md)** - Layout spacing
+
+### Customization
+- **[Theme Customization](./styles/theme-customization.md)** - Custom themes
+- **[Component Customization](./styles/component-customization.md)** - Styling components
+- **[CSS Architecture](./styles/css-architecture.md)** - CSS organization
+- **[Responsive Design](./styles/responsive-design.md)** - Mobile-first approach
+
+## 🔍 Search by Use Case
+
+### I want to...
+- **Build a new app** → [Quick Start](./getting-started/quick-start.md)
+- **Add authentication** → [Authentication Guide](./core-concepts/authentication.md)
+- **Implement permissions** → [RBAC System](./rbac/README.md)
+- **Create data tables** → [Data Tables Guide](./implementation-guides/data-tables.md)
+- **Style my app** → [Styling Overview](./styles/README.md)
+- **Fix styling issues** → [Troubleshooting - Styling](./troubleshooting/styling-issues.md)
+- **Optimize performance** → [Performance Best Practices](./best-practices/performance.md)
+- **Deploy to production** → [Deployment Guide](./best-practices/deployment.md)
+- **Migrate from v0.x** → [Migration Guide](./migration/README.md)
+- **Debug an issue** → [Troubleshooting Overview](./troubleshooting/README.md)
+
+### I'm looking for...
+- **Component documentation** → [Components API](./api-reference/components.md)
+- **Hook reference** → [Hooks API](./api-reference/hooks.md)
+- **Code examples** → [Examples](./getting-started/examples/README.md)
+- **Best practices** → [Best Practices](./best-practices/README.md)
+- **Security guidelines** → [Security Best Practices](./best-practices/security.md)
+- **Performance tips** → [Performance Best Practices](./best-practices/performance.md)
+- **Testing strategies** → [Testing Best Practices](./best-practices/testing.md)
+
+## 📚 Additional Resources
+
+### External Links
+- **[Supabase Documentation](https://supabase.com/docs)** - Backend services
+- **[Tailwind CSS Documentation](https://tailwindcss.com/docs)** - CSS framework
+- **[React Documentation](https://react.dev)** - React framework
+- **[TypeScript Documentation](https://www.typescriptlang.org/docs)** - Type system
+
+### Community
+- **[GitHub Repository](https://github.com/jmruthers/pace-core)** - Source code
+- **[Issue Tracker](https://github.com/jmruthers/pace-core/issues)** - Bug reports
+- **[Discussions](https://github.com/jmruthers/pace-core/discussions)** - Community help
+- **[Changelog](./CHANGELOG.md)** - Version history
+
+---
+
+**Need help?** Check the [Troubleshooting Guide](./troubleshooting/README.md) or [ask for help](https://github.com/jmruthers/pace-core/discussions).

package/docs/README.md

@@ -1,9 +1,11 @@
 # @jmruthers/pace-core
 
-> **⚡ Get Started in 5 Minutes** | [Quick Reference](./quick-reference.md) | [Examples](./getting-started/examples/)
+> **⚡ Get Started in 5 Minutes** | [📚 Complete Index](./INDEX.md) | [Quick Reference](./quick-reference.md) | [Examples](./getting-started/examples/)
 
 A comprehensive React component library with built-in authentication, RBAC, and event management.
 
+> **📚 New to PACE Core?** Start with the [Complete Documentation Index](./INDEX.md) for a comprehensive overview of all available documentation.
+
 ## ⚡ Quick Start
 
 ```bash
@@ -12,7 +14,9 @@ npm install @jmruthers/pace-core
 
 ```tsx
 import { UnifiedAuthProvider, DataTable } from '@jmruthers/pace-core';
-import '@jmruthers/pace-core/styles/tokens';
+
+// Import the core CSS file
+import '@jmruthers/pace-core/styles/core.css';
 
 function App() {
   return (
@@ -29,12 +33,22 @@ function App() {
 - **[Quick Start](./getting-started/quick-start.md)** - Build your first app
 - **[Examples](./getting-started/examples/)** - Complete working examples
 
+## 🚀 **NEW: v0.4.17 Source Path Fix**
+
+**Important**: v0.4.17 fixes the @source directive paths for proper Tailwind v4 content scanning.
+
+- **[Source Path Fix Guide](./migration/v0.4.17-source-path-fix.md)** - **CRITICAL** Fix for @source directive paths
+- **[CSS-First Migration Guide](./migration/v0.4.16-css-first-approach.md)** - Simplified configuration
+- **[Legacy Migration Guide](./migration/v0.4.15-tailwind-scanning.md)** - For v0.4.15 source file approach
+- **[Tailwind Content Scanning](./troubleshooting/tailwind-content-scanning.md)** - Comprehensive scanning solutions
+
 ## 📚 Documentation
 
 ### 🔧 **Core Features**
 - **[Authentication](./core-concepts/authentication.md)** - User management and session handling
 - **[RBAC System](./rbac/README.md)** - Complete role-based access control
 - **[UI Components](./api-reference/components.md)** - Modern, accessible component library
+- **[Print Components](./print-components/README.md)** - **NEW** Print-optimized layout system
 - **[Styling](./styles/README.md)** - Design system and theming
 
 ### 🛠️ **Implementation**
@@ -42,41 +56,42 @@ function App() {
 - **[Data Tables](./implementation-guides/data-tables.md)** - Interactive data management
 - **[Forms](./implementation-guides/forms.md)** - Form handling and validation
 - **[Navigation](./implementation-guides/navigation.md)** - Navigation patterns and routing
+- **[Public Pages](./implementation-guides/public-pages.md)** - **NEW** Public pages without authentication
 - **[Permission Enforcement](./implementation-guides/permission-enforcement.md)** - Security implementation
 
 ### 📖 **Core Concepts**
 - **[Permissions](./core-concepts/permissions.md)** - Permission checking and enforcement
 - **[Events](./core-concepts/events.md)** - Event management and selection
-- **[Organisations](./core-concepts/organisations.md)** - Multi-tenant organisation support
-
-## 📋 Reference
-
-### **API Documentation**
-- **[Components](./api-reference/components.md)** - UI components with examples
-- **[Hooks](./api-reference/hooks.md)** - React hooks with examples
-- **[Types](./api-reference/types.md)** - TypeScript types and interfaces
-- **[Utilities](./api-reference/utilities.md)** - Utility functions with examples
-- **[Providers](./api-reference/providers.md)** - React providers with examples
-- **[Auto-generated API](./api/modules.md)** - Complete technical reference
-
-### **RBAC Reference**
-- **[RBAC Quick Start](./rbac/quick-start.md)** - Build your first RBAC-enabled app
-- **[RBAC API Reference](./rbac/api-reference.md)** - Complete RBAC API documentation
-- **[RBAC Examples](./rbac/examples.md)** - Practical usage examples
-- **[Advanced Patterns](./rbac/advanced-patterns.md)** - Complex scenarios and optimizations
-- **[Super Admin Guide](./rbac/super-admin-guide.md)** - Super admin access implementation
-
-## 🎯 Best Practices & Production
-
-### **Production Ready**
+- **[Organisations](./core-concepts/organisations.md)** - Multi-tenant organisation management
+- **[Security](./core-concepts/security.md)** - Security-first design principles
+
+### 🎨 **Styling & Theming**
+- **[Design System](./styles/README.md)** - Complete design system overview
+- **[Color Palettes](./styles/color-palettes.md)** - Main, secondary, and accent colors
+- **[Typography](./styles/typography.md)** - Font families and text styles
+- **[Component Styling](./styles/component-styling.md)** - How components are styled
+- **[Custom Themes](./styles/custom-themes.md)** - Creating custom themes
+
+### 🔧 **Configuration**
+- **[Vite Configuration](./consuming-app-vite-config.md)** - **CRITICAL** Tailwind scanning setup
+- **[Environment Setup](./getting-started/environment-setup.md)** - Environment variables and configuration
+- **[Build Configuration](./getting-started/build-configuration.md)** - Build tool configuration
+- **[Deployment](./getting-started/deployment.md)** - Production deployment guide
+
+### 🎯 **Best Practices**
+- **[Best Practices Overview](./best-practices/README.md)** - Comprehensive best practices guide
 - **[Security](./best-practices/security.md)** - Security best practices and guidelines
-- **[Performance](./best-practices/performance.md)** - Performance optimization techniques
+- **[Performance](./best-practices/performance.md)** - Performance optimization strategies
 - **[Testing](./best-practices/testing.md)** - Testing strategies and patterns
-- **[Deployment](./best-practices/deployment.md)** - Production deployment guide
-
-### **Migration & Troubleshooting**
-- **[Migration Guide](./migration/)** - Upgrade and migration guides
-- **[Common Issues](./troubleshooting/common-issues.md)** - Solutions to frequent problems
+- **[Deployment](./best-practices/deployment.md)** - Deployment guidelines and best practices
+
+### 🐛 **Troubleshooting**
+- **[Troubleshooting Overview](./troubleshooting/README.md)** - Complete troubleshooting guide
+- **[Common Issues](./troubleshooting/common-issues.md)** - Frequently encountered problems
+- **[Styling Issues](./troubleshooting/styling-issues.md)** - Fix component styling problems
+- **[Tailwind Content Scanning](./troubleshooting/tailwind-content-scanning.md)** - **NEW** Comprehensive scanning solutions
+- **[Authentication Issues](./troubleshooting/authentication-issues.md)** - Auth-related problems
+- **[Database Issues](./troubleshooting/database-issues.md)** - Database connection and setup
 - **[Organisation Context Setup](./troubleshooting/organisation-context-setup.md)** - Database setup for organisation context
 - **[Debugging](./troubleshooting/debugging.md)** - Debugging techniques and tools
 
@@ -125,7 +140,6 @@ For detailed architecture information, see the [PACE Core Architecture Guide](./
 - And many more...
 
 ### Utilities
-- `useTheme` - Theme management
 - `useToast` - Toast notifications
 - `useDebounce` - Debounced values
 - `useZodForm` - Form validation
@@ -148,4 +162,4 @@ npm run build
 
 ## 📄 License
 
-MIT License - see [LICENSE](../../LICENSE) for details. 
+MIT License - see [LICENSE](../../LICENSE) for details.