@jmruthers/pace-core 0.4.1 → 0.5.3

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@jmruthers/pace-core",
-  "version": "0.4.01",
+  "version": "0.5.3",
   "description": "Clean, modern React component library with Tailwind v4 styling and native utilities",
   "private": false,
   "publishConfig": {
-    "access": "restricted"
+    "access": "public"
   },
   "type": "module",
   "main": "dist/index.js",
@@ -57,42 +57,61 @@
       "import": "./dist/rbac/eslint-rules.js",
       "default": "./dist/rbac/eslint-rules.js"
     },
-    "./styles/base.css": {
-      "import": "./dist/styles/base.css",
-      "default": "./dist/styles/base.css"
-    },
-    "./styles/theme.css": {
-      "import": "./dist/styles/theme.css",
-      "default": "./dist/styles/theme.css"
-    },
-    "./styles/dark.css": {
-      "import": "./dist/styles/dark.css",
-      "default": "./dist/styles/dark.css"
+    "./styles/core.css": "./dist/styles/core.css",
+    "./styles": {
+      "import": "./dist/styles/index.js",
+      "default": "./dist/styles/index.js"
     },
     "./theming/runtime": {
       "types": "./dist/theming/runtime.d.ts",
       "import": "./dist/theming/runtime.js",
       "default": "./dist/theming/runtime.js"
     },
-    "./styles": {
-      "import": "./dist/styles/index.js",
-      "default": "./dist/styles/index.js"
-    },
     "./vite-plugin-tailwind-v4": {
       "import": "./vite-plugin-tailwind-v4.js",
       "default": "./vite-plugin-tailwind-v4.js"
     },
     "./docs": "./docs/README.md",
-    "./docs/architecture": "./docs/architecture.md",
-    "./docs/styling": "./docs/styling-architecture.md",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./source": {
+      "import": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./source/components": {
+      "import": "./src/components/index.ts",
+      "default": "./src/components/index.ts"
+    },
+    "./source/providers": {
+      "import": "./src/providers/index.ts",
+      "default": "./src/providers/index.ts"
+    },
+    "./source/hooks": {
+      "import": "./src/hooks/index.ts",
+      "default": "./src/hooks/index.ts"
+    },
+    "./source/utils": {
+      "import": "./src/utils/index.ts",
+      "default": "./src/utils/index.ts"
+    },
+    "./source/types": {
+      "import": "./src/types/index.ts",
+      "default": "./src/types/index.ts"
+    },
+    "./source/validation": {
+      "import": "./src/validation/index.ts",
+      "default": "./src/validation/index.ts"
+    },
+    "./source/rbac": {
+      "import": "./src/rbac/index.ts",
+      "default": "./src/rbac/index.ts"
+    }
   },
   "files": [
     "dist",
+    "src",
     "README.md",
     "CHANGELOG.md",
-    "docs",
-    "src/fonts"
+    "docs"
   ],
   "scripts": {
     "_comment_build": "Build package and documentation",
@@ -103,10 +122,14 @@
     "prepublishOnly": "npm run build:all",
     "clean": "rimraf dist",
     "_comment_test": "Test suite with various configurations",
-    "test": "NODE_OPTIONS='--max-old-space-size=4096' vitest run --config ../../vitest.config.ts",
+    "test": "NODE_OPTIONS='--max-old-space-size=8192 --max-semi-space-size=128' vitest run --config ../../vitest.config.ts",
+    "test:memory-optimized": "node ../../scripts/run-tests-memory-optimized.js",
     "test:watch": "vitest --watch --config ../../vitest.config.ts",
-    "test:coverage": "NODE_OPTIONS='--max-old-space-size=4096' vitest run --coverage --config ../../vitest.config.ts",
+    "test:coverage": "NODE_OPTIONS='--max-old-space-size=8192 --max-semi-space-size=128' vitest run --coverage --config ../../vitest.config.ts",
     "test:ui": "vitest --ui --config ../../vitest.config.ts",
+    "test:new": "NODE_OPTIONS='--max-old-space-size=8192 --max-semi-space-size=128' vitest run --config vitest.new.config.ts",
+    "test:new:watch": "vitest --watch --config vitest.new.config.ts",
+    "migrate-tests": "node scripts/migrate-tests.js",
     "test:unit": "vitest src/**/*.test.{ts,tsx} --config ../../vitest.config.ts",
     "test:integration": "vitest tests/integration --config ../../vitest.config.ts",
     "_comment_quality": "Code quality and formatting checks",
@@ -145,7 +168,6 @@
     "@radix-ui/react-avatar": "^1.0.0",
     "@radix-ui/react-checkbox": "^1.0.0",
     "@radix-ui/react-dialog": "^1.0.0",
-    "@radix-ui/react-dropdown-menu": "^2.0.0",
     "@radix-ui/react-label": "^2.0.0",
     "@radix-ui/react-progress": "^1.0.0",
     "@radix-ui/react-slot": "^1.0.0",

package/src/__mocks__/lucide-react.ts

@@ -0,0 +1,181 @@
+/**
+ * Mock for lucide-react icons
+ * @package @jmruthers/pace-core
+ * @module Mocks/LucideReact
+ * @since 1.0.0
+ */
+
+import React from 'react';
+
+// Create a generic icon component
+const createIcon = (name: string) => 
+  React.forwardRef<SVGSVGElement, React.SVGProps<SVGSVGElement>>(({ className, ...props }, ref) => 
+    React.createElement('svg', { 
+      ref, 
+      className, 
+      'data-testid': `lucide-${name.toLowerCase()}`,
+      width: '24',
+      height: '24',
+      viewBox: '0 0 24 24',
+      fill: 'none',
+      stroke: 'currentColor',
+      strokeWidth: '2',
+      strokeLinecap: 'round',
+      strokeLinejoin: 'round',
+      ...props 
+    })
+  );
+
+// Export all the icons we need
+export const ChevronDown = createIcon('ChevronDown');
+export const ChevronUp = createIcon('ChevronUp');
+export const ChevronLeft = createIcon('ChevronLeft');
+export const ChevronRight = createIcon('ChevronRight');
+export const Search = createIcon('Search');
+export const X = createIcon('X');
+export const Check = createIcon('Check');
+export const Plus = createIcon('Plus');
+export const Minus = createIcon('Minus');
+export const Edit = createIcon('Edit');
+export const Pencil = createIcon('Pencil');
+export const Trash = createIcon('Trash');
+export const Trash2 = createIcon('Trash2');
+export const Eye = createIcon('Eye');
+export const EyeOff = createIcon('EyeOff');
+export const Lock = createIcon('Lock');
+export const Unlock = createIcon('Unlock');
+export const User = createIcon('User');
+export const Users = createIcon('Users');
+export const Settings = createIcon('Settings');
+export const Home = createIcon('Home');
+export const Menu = createIcon('Menu');
+export const MoreHorizontal = createIcon('MoreHorizontal');
+export const MoreVertical = createIcon('MoreVertical');
+export const Filter = createIcon('Filter');
+export const Download = createIcon('Download');
+export const Upload = createIcon('Upload');
+export const RefreshCw = createIcon('RefreshCw');
+export const AlertCircle = createIcon('AlertCircle');
+export const CheckCircle = createIcon('CheckCircle');
+export const Info = createIcon('Info');
+export const Warning = createIcon('Warning');
+export const FileText = createIcon('FileText');
+export const ChevronsLeft = createIcon('ChevronsLeft');
+export const ChevronsRight = createIcon('ChevronsRight');
+export const KeyRound = createIcon('KeyRound');
+export const LogOut = createIcon('LogOut');
+export const ChevronsUp = createIcon('ChevronsUp');
+export const ChevronsDown = createIcon('ChevronsDown');
+export const ChevronsUpDown = createIcon('ChevronsUpDown');
+export const ArrowUpDown = createIcon('ArrowUpDown');
+export const ArrowUp = createIcon('ArrowUp');
+export const ArrowDown = createIcon('ArrowDown');
+export const RotateCcw = createIcon('RotateCcw');
+export const RotateCw = createIcon('RotateCw');
+export const Copy = createIcon('Copy');
+export const ExternalLink = createIcon('ExternalLink');
+export const Calendar = createIcon('Calendar');
+export const Clock = createIcon('Clock');
+export const Database = createIcon('Database');
+export const File = createIcon('File');
+export const Folder = createIcon('Folder');
+export const Globe = createIcon('Globe');
+export const HardDrive = createIcon('HardDrive');
+export const HelpCircle = createIcon('HelpCircle');
+export const Image = createIcon('Image');
+export const Link = createIcon('Link');
+export const Mail = createIcon('Mail');
+export const MapPin = createIcon('MapPin');
+export const Phone = createIcon('Phone');
+export const PieChart = createIcon('PieChart');
+export const Play = createIcon('Play');
+export const Save = createIcon('Save');
+export const Share = createIcon('Share');
+export const Star = createIcon('Star');
+export const Tag = createIcon('Tag');
+export const Target = createIcon('Target');
+export const TrendingUp = createIcon('TrendingUp');
+export const Volume2 = createIcon('Volume2');
+export const Wifi = createIcon('Wifi');
+export const Zap = createIcon('Zap');
+export const Circle = createIcon('Circle');
+export const Group = createIcon('Group');
+export const Settings2 = createIcon('Settings2');
+
+// Default export for compatibility
+export default {
+  ChevronDown,
+  ChevronUp,
+  ChevronLeft,
+  ChevronRight,
+  Search,
+  X,
+  Check,
+  Plus,
+  Minus,
+  Edit,
+  Pencil,
+  Trash,
+  Trash2,
+  Eye,
+  EyeOff,
+  Lock,
+  Unlock,
+  User,
+  Users,
+  Settings,
+  Home,
+  Menu,
+  MoreHorizontal,
+  MoreVertical,
+  Filter,
+  Download,
+  Upload,
+  RefreshCw,
+  AlertCircle,
+  CheckCircle,
+  Info,
+  Warning,
+  FileText,
+  ChevronsLeft,
+  ChevronsRight,
+  KeyRound,
+  LogOut,
+  ChevronsUp,
+  ChevronsDown,
+  ChevronsUpDown,
+  ArrowUpDown,
+  ArrowUp,
+  ArrowDown,
+  RotateCcw,
+  RotateCw,
+  Copy,
+  ExternalLink,
+  Calendar,
+  Clock,
+  Database,
+  File,
+  Folder,
+  Globe,
+  HardDrive,
+  HelpCircle,
+  Image,
+  Link,
+  Mail,
+  MapPin,
+  Phone,
+  PieChart,
+  Play,
+  Save,
+  Share,
+  Star,
+  Tag,
+  Target,
+  TrendingUp,
+  Volume2,
+  Wifi,
+  Zap,
+  Circle,
+  Group,
+  Settings2,
+};

package/src/__tests__/REBUILD_PLAN.md

@@ -0,0 +1,223 @@
+# 🚀 Test Suite Rebuild Plan
+
+## 📊 Current Status
+- ✅ **193 broken test files deleted**
+- ✅ **World-class test architecture created**
+- ✅ **Comprehensive utilities and helpers ready**
+- ✅ **Excellent examples and templates provided**
+- ✅ **Testing guidelines and guardrails established**
+
+## 🎯 Rebuild Strategy
+
+### Phase 1: Foundation (Week 1)
+**Priority: Critical Components**
+
+#### 1.1 Core UI Components
+- [ ] **Button** - Already completed ✅
+- [ ] **Input** - Form input component
+- [ ] **Card** - Content container
+- [ ] **Modal** - Overlay component
+- [ ] **LoadingSpinner** - Loading indicator
+
+#### 1.2 Essential Hooks
+- [ ] **useDebounce** - Input debouncing
+- [ ] **useLocalStorage** - Local storage management
+- [ ] **useToggle** - Boolean state management
+- [ ] **useAsync** - Async operation handling
+
+#### 1.3 Utility Functions
+- [ ] **formatDate** - Date formatting
+- [ ] **validateEmail** - Email validation
+- [ ] **generateId** - ID generation
+- [ ] **deepClone** - Object cloning
+
+### Phase 2: Business Logic (Week 2)
+**Priority: High-Value Components**
+
+#### 2.1 Authentication Components
+- [ ] **LoginForm** - User authentication
+- [ ] **UserMenu** - User profile menu
+- [ ] **AuthGuard** - Route protection
+- [ ] **PasswordReset** - Password recovery
+
+#### 2.2 Data Management
+- [ ] **DataTable** - Data display
+- [ ] **Pagination** - Data pagination
+- [ ] **Search** - Data filtering
+- [ ] **Export** - Data export
+
+#### 2.3 Business Hooks
+- [ ] **useAuth** - Authentication state
+- [ ] **useApi** - API calls
+- [ ] **usePermissions** - Access control
+- [ ] **useCache** - Data caching
+
+### Phase 3: Advanced Features (Week 3)
+**Priority: Complex Components**
+
+#### 3.1 Advanced UI Components
+- [ ] **DataTable** - Complex data display
+- [ ] **FormBuilder** - Dynamic forms
+- [ ] **FileUpload** - File handling
+- [ ] **RichTextEditor** - Text editing
+
+#### 3.2 Integration Components
+- [ ] **Dashboard** - Main dashboard
+- [ ] **Settings** - Configuration
+- [ ] **Reports** - Data visualization
+- [ ] **Notifications** - User alerts
+
+#### 3.3 Advanced Hooks
+- [ ] **useForm** - Form management
+- [ ] **usePagination** - Pagination logic
+- [ ] **useInfiniteScroll** - Infinite loading
+- [ ] **useWebSocket** - Real-time updates
+
+### Phase 4: Integration & E2E (Week 4)
+**Priority: End-to-End Testing**
+
+#### 4.1 Integration Tests
+- [ ] **User Authentication Flow**
+- [ ] **Data CRUD Operations**
+- [ ] **File Upload Process**
+- [ ] **Report Generation**
+
+#### 4.2 E2E Test Scenarios
+- [ ] **Complete User Journey**
+- [ ] **Admin Workflow**
+- [ ] **Error Handling**
+- [ ] **Performance Testing**
+
+## 📋 Implementation Guidelines
+
+### Test Creation Process
+1. **Identify Component Priority** - Use the phase-based approach
+2. **Copy Template** - Use provided templates
+3. **Write Tests** - Follow testing guidelines
+4. **Verify Coverage** - Ensure 80%+ coverage
+5. **Review & Refactor** - Code review and optimization
+
+### Quality Gates
+- ✅ **All tests pass** - No failing tests
+- ✅ **80%+ coverage** - Meet coverage thresholds
+- ✅ **Fast execution** - Tests run in <5 seconds
+- ✅ **Clear naming** - Descriptive test names
+- ✅ **No flaky tests** - Reliable test results
+
+### File Structure
+```
+src/__tests__/
+├── components/
+│   ├── Button.test.tsx ✅
+│   ├── Input.test.tsx
+│   ├── Card.test.tsx
+│   └── ...
+├── hooks/
+│   ├── useDebounce.test.ts
+│   ├── useLocalStorage.test.ts
+│   └── ...
+├── utils/
+│   ├── formatDate.test.ts
+│   ├── validateEmail.test.ts
+│   └── ...
+├── integration/
+│   ├── auth-flow.test.tsx
+│   ├── data-crud.test.tsx
+│   └── ...
+└── templates/
+    ├── component.test.template.tsx
+    ├── hook.test.template.ts
+    └── ...
+```
+
+## 🛠️ Development Workflow
+
+### Daily Process
+1. **Start with Template** - Copy appropriate template
+2. **Write Tests First** - TDD approach
+3. **Run Tests Frequently** - `npm test -- --watch`
+4. **Check Coverage** - `npm test -- --coverage`
+5. **Commit Often** - Small, focused commits
+
+### Weekly Review
+1. **Coverage Report** - Review coverage metrics
+2. **Test Performance** - Check execution time
+3. **Code Quality** - Review test quality
+4. **Plan Next Week** - Prioritize next components
+
+## 📊 Success Metrics
+
+### Week 1 Targets
+- [ ] 5 core components tested
+- [ ] 4 essential hooks tested
+- [ ] 4 utility functions tested
+- [ ] 80%+ coverage on tested components
+
+### Week 2 Targets
+- [ ] 4 authentication components tested
+- [ ] 4 data management components tested
+- [ ] 4 business hooks tested
+- [ ] 2 integration tests completed
+
+### Week 3 Targets
+- [ ] 4 advanced UI components tested
+- [ ] 4 integration components tested
+- [ ] 4 advanced hooks tested
+- [ ] Performance tests added
+
+### Week 4 Targets
+- [ ] 4 integration test suites completed
+- [ ] 4 E2E test scenarios completed
+- [ ] 90%+ overall coverage
+- [ ] All tests passing consistently
+
+## 🚨 Risk Mitigation
+
+### Common Pitfalls
+1. **Over-testing** - Focus on user behavior
+2. **Under-testing** - Ensure critical paths covered
+3. **Flaky tests** - Use proper async handling
+4. **Slow tests** - Optimize test performance
+
+### Solutions
+1. **Follow templates** - Use provided patterns
+2. **Review guidelines** - Check testing best practices
+3. **Use utilities** - Leverage test helpers
+4. **Monitor performance** - Track test execution time
+
+## 📚 Resources
+
+### Quick Reference
+- [Testing Guidelines](./TESTING_GUIDELINES.md)
+- [Component Template](./templates/component.test.template.tsx)
+- [Hook Template](./templates/hook.test.template.ts)
+- [Test Utilities](./helpers/test-utils.tsx)
+
+### Commands
+```bash
+# Run all tests
+npm test
+
+# Run specific component
+npm test -- Button.test.tsx
+
+# Run with coverage
+npm test -- --coverage
+
+# Run in watch mode
+npm test -- --watch
+```
+
+## 🎉 Expected Outcomes
+
+After 4 weeks, you'll have:
+- ✅ **Comprehensive test suite** - 50+ test files
+- ✅ **High code coverage** - 90%+ overall
+- ✅ **Fast test execution** - <10 seconds total
+- ✅ **Reliable tests** - No flaky tests
+- ✅ **Maintainable code** - Clear patterns and guidelines
+- ✅ **Developer confidence** - Safe refactoring and changes
+
+---
+
+**Ready to start? Begin with Phase 1, Week 1, and work through the components systematically!** 🚀