Files
metabuilder/hooks
johndoe6345789 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
..

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 state
  • useRegisterLogic.ts - Registration form logic and state
  • usePasswordValidation.ts - Password validation rules and feedback
  • useAuthForm.ts - Generic authentication form handling

Dashboard & UI

  • useDashboardLogic.ts - Dashboard state and layout management
  • useResponsiveSidebar.ts - Responsive sidebar state
  • useHeaderLogic.ts - Header navigation and state
  • useProjectSidebarLogic.ts - Project sidebar logic

Storage & Data

  • useStorageDataHandlers.ts - Data storage operations
  • useStorageSettingsHandlers.ts - Settings storage handlers
  • useStorageSwitchHandlers.ts - Storage mode switching

Design Tools

  • useFaviconDesigner.ts - Favicon design functionality
  • useDragResize.ts - Drag and resize interactions

Keyboard & Events (NEW - Jan 23, 2026)

  • useKeyboardShortcuts.ts - Unified keyboard shortcut handling with meta keys
  • useClickOutside.ts - Detect clicks outside elements (modals, dropdowns)
  • useHotkeys.ts - Global hotkey registration with combo support
  • useEventListener.ts - Generic event listener with proper cleanup
  • KEYBOARD_EVENT_HOOKS.md - Complete documentation with examples
  • INTEGRATION_EXAMPLES.ts - Real-world integration examples

Development & Build

  • use-github-build-status.ts - GitHub build status monitoring

Utilities

  • I18nNavigation.ts - Internationalization navigation
  • ToastContext.tsx - Toast notification context

Store & Redux

  • hooks.ts - Redux store hooks
  • index.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:

  1. Create the hook in its feature directory
  2. Export it from that location
  3. 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)