4 Commits

Author SHA1 Message Date
862cc29457 various changes 2026-03-09 22:30:41 +00:00
5aabff44cd refactor(fakemui): flatten QML components directory structure and update documentation
Directory Restructuring:
- qml/qml-components/qml-components/* → qml/components/ (flattens nesting)
- All 104 QML files moved with git history preserved
- Eliminates redundant qml-components nesting

Documentation Updates:
- ARCHITECTURE.md: Updated qml/components references (2 locations)
- GETTING_STARTED.md: Updated qml/components path (1 location, end of file)
- README.md: Updated qml/components references (3 locations)
- CODE_REVIEW.md: Updated qml/components file paths (4 locations)
- docs/ARCHITECTURE.md: Complete refactor with qml/components paths

Verification:
-  No remaining qml-components/ references in documentation
-  All 104 QML files present in flattened structure
-  Directory structure verified (12 component categories)
-  First-class directory naming convention

Structure Post-Refactor:
qml/
├── components/
│   ├── atoms/ (16 files)
│   ├── core/ (11 files)
│   ├── data-display/ (10 files)
│   ├── feedback/ (11 files)
│   ├── form/ (19 files)
│   ├── lab/ (11 files)
│   ├── layout/ (12 files)
│   ├── navigation/ (12 files)
│   ├── surfaces/ (7 files)
│   ├── theming/ (4 files)
│   └── utils/ (13 files)
├── hybrid/
└── widgets/

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-01-23 19:54:21 +00:00
593d7259f8 docs(hooks): Add comprehensive documentation for utility hooks
Added detailed README files and CLAUDE.md updates:

1. redux/hooks-utils/README.md
   - Complete API reference for useTableState, useAsyncOperation, useDebounced, useThrottled
   - Code examples for each hook
   - Best practices and use cases

2. redux/hooks-forms/README.md
   - Complete API reference for useFormBuilder
   - Examples: login form, field arrays, multi-step forms, conditional fields
   - Best practices and validation patterns

3. CLAUDE.md updates
   - New "Utility Hooks" section documenting both packages
   - Impact analysis (eliminates ~1,500 lines of duplicate code)
   - Usage examples and integration patterns
   - Updated Redux packages count (12 total)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-01-23 19:25:24 +00:00
f2ebe17f02 feat(hooks): Add high-priority utility hooks
Created comprehensive hook packages addressing identified code duplication:

1. **@metabuilder/hooks-utils** (NEW)
   - useDebounced: Value debouncing with leading/trailing options
   - useThrottled: Value throttling for continuous updates
   - useTableState: Unified data grid with pagination, sorting, filtering, search
   - useAsyncOperation: Non-Redux async management with retry and caching

2. **@metabuilder/hooks-forms** (NEW)
   - useFormBuilder: Complete form state with validation and field arrays
   - Field-level and form-level validation
   - Touched/dirty tracking, submit state management
   - Strongly typed with TypeScript generics

Features:
- All hooks fully typed with TypeScript
- Comprehensive JSDoc with examples
- No external dependencies (React only)
- Memory-efficient implementations
- Chainable operations for data manipulation

Impact: Eliminates ~1,500 lines of duplicate code across workflowui,
codegen, and pastebin projects

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-01-23 19:24:18 +00:00