mirror of
https://github.com/johndoe6345789/metabuilder.git
synced 2026-04-24 13:54:57 +00:00
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>
React Hooks Collection
This folder contains all custom React hooks from across the MetaBuilder codebase, consolidated for easy discovery and reuse.
Hooks by Category
Authentication
useLoginLogic.ts- Login form logic and stateuseRegisterLogic.ts- Registration form logic and stateusePasswordValidation.ts- Password validation rules and feedbackuseAuthForm.ts- Generic authentication form handling
Dashboard & UI
useDashboardLogic.ts- Dashboard state and layout managementuseResponsiveSidebar.ts- Responsive sidebar stateuseHeaderLogic.ts- Header navigation and stateuseProjectSidebarLogic.ts- Project sidebar logic
Storage & Data
useStorageDataHandlers.ts- Data storage operationsuseStorageSettingsHandlers.ts- Settings storage handlersuseStorageSwitchHandlers.ts- Storage mode switching
Design Tools
useFaviconDesigner.ts- Favicon design functionalityuseDragResize.ts- Drag and resize interactions
Keyboard & Events (NEW - Jan 23, 2026)
useKeyboardShortcuts.ts- Unified keyboard shortcut handling with meta keysuseClickOutside.ts- Detect clicks outside elements (modals, dropdowns)useHotkeys.ts- Global hotkey registration with combo supportuseEventListener.ts- Generic event listener with proper cleanupKEYBOARD_EVENT_HOOKS.md- Complete documentation with examplesINTEGRATION_EXAMPLES.ts- Real-world integration examples
Development & Build
use-github-build-status.ts- GitHub build status monitoring
Utilities
I18nNavigation.ts- Internationalization navigationToastContext.tsx- Toast notification context
Store & Redux
hooks.ts- Redux store hooksindex.ts- Hook exports
Usage
To use a hook, import it directly:
import { useDashboardLogic } from '@/hooks/useDashboardLogic'
Or configure your build tool to alias the hooks folder:
{
"compilerOptions": {
"paths": {
"@hooks/*": ["./hooks/*"]
}
}
}
Then use:
import { useLoginLogic } from '@hooks/useLoginLogic'
Adding New Hooks
When creating new hooks, add them here for centralized management:
- Create the hook in its feature directory
- Export it from that location
- Copy it to this folder for centralized discovery
Source Locations
Hooks are sourced from:
workflowui/src/hooks/codegen/src/hooks/codegen/src/components/(component-specific hooks)redux/hooks-*/src/redux/hooks/src/pastebin/src/store/fakemui/react/components/(component utilities)