Files
bookhoard/web
john-okeefe 08b7f13079 feat(collections): add HTMX auth, icon picker, and navigation helpers
Add comprehensive TypeScript utilities for collections page functionality.

1. HTMX Authentication (setupHTMXAuth):
   - Adds Authorization header to all HTMX requests automatically
   - Listens for htmx:configRequest event on document.body
   - Injects Bearer token from localStorage
   - Eliminates need for hx-headers attributes on individual elements

2. Smart Card Navigation (navigateToCollection):
   - Implements event delegation to distinguish button clicks from card clicks
   - Checks event.target to determine what user clicked
   - Returns early if button clicked (lets HTMX handle button actions)
   - Navigates to collection detail page only when card body clicked
   - Uses data-href attribute for navigation target

3. Color Selection Helpers:
   - selectColor(): Updates hidden input and visual selection state
   - closeCollectionModal(): Removes modal from DOM after HTMX swap
   - initColorSelection(): Applies border color classes to collection cards
     using borderClasses mapping (blue→border-blue-500, etc.)

4. Icon Picker with Search:
   - Hardcoded iconData object: 30 emojis with searchable keywords
     (e.g., "📚": ["book", "books", "library", "read", "reading"])
   - populateIconGrid(): Dynamically generates icon buttons from iconData
   - selectIcon(): Updates hidden input with selected emoji
   - filterIcons(): Real-time search filtering by emoji OR keywords
   - showAllIcons(): Clears search filter
   - initIconSelection(): Auto-initializes after HTMX modal swap
     (listens for htmx:afterSwap event on #modal-container)

5. HTMX Modal Initialization:
   - setupHTMXModalInit(): Listens for modal loads via HTMX
   - Auto-initializes icon picker when modal content swapped into
     #modal-container

All functions exported to window object for onclick attribute access.
Auto-initializes on DOMContentLoaded or immediately if DOM ready.

Pattern consistency:
- Follows same pattern as toast.js (global exports, auto-init)
- Uses TypeScript type annotations
- No OOP (functional style per project guidelines)
- Server-side rendering with HTMX (no AJAX data fetching)
2026-03-01 21:00:28 -05:00
..