refactor(ui): comprehensive combobox component optimization

.changeset/angry-windows-melt.md

@@ -0,0 +1,26 @@
+---
+"@cloudoperators/juno-ui-components": patch
+---
+
+- **Removed redundant state management:** Eliminated unnecessary `useState` and `useEffect` patterns that were causing performance bottlenecks
+- **Memoized context values:** Implemented proper memoization to prevent unnecessary re-renders
+- **Optimized filtering and event handlers:** Enhanced callback performance and filtering logic efficiency
+- **Added configurable debounce delay:** Made debounce timing configurable as a parameter for better flexibility
+
+- **Custom hooks extraction:** Broke down the monolithic combobox into focused, reusable custom hooks:
+
+  - Combobox options initialization logic
+  - Floating UI logic
+  - Filtering logic
+  - State management logic
+  - Context management logic
+  - Validation logic
+
+- **Sub-component extraction:** Separated complex component into smaller, focused sub-components
+- **Type definitions:** Extracted reusable TypeScript types for better type safety
+
+- **Added comprehensive documentation:** Included description comments and explanation comments throughout the codebase
+- **Utility functions:** Added CSS class merging utility for better Tailwind CSS handling
+- **Style management:** Implemented consistent style management approach
+- **License headers:** Added proper license headers to all files
+- **Code organization:** Moved utilities to appropriate locations in the source structure

packages/ui-components/package.json

@@ -46,6 +46,7 @@
     "add": "2.0.6",
     "autoprefixer": "10.4.21",
     "css-loader": "6.11.0",
+    "clsx": "^2.1.1",
     "eslint-plugin-storybook": "^9.0.10",
     "flatpickr": "4.6.13",
     "focus-trap-react": "11.0.3",
@@ -62,6 +63,7 @@
     "storybook": "^9.0.10",
     "style-loader": "3.3.4",
     "tailwindcss": "^4.1.7",
+    "tailwind-merge": "^3.2.0",
     "ts-loader": "9.5.2",
     "typescript": "^5.8.3",
     "vite": "6.3.5",