Merge development for v5.1.0

.github/workflows/split-packages.yml

@@ -46,6 +46,12 @@ jobs:
           - { local_path: 'packages/checkcards',  split_repository: 'checkcards'  }
           - { local_path: 'packages/number',      split_repository: 'number'      }
           - { local_path: 'packages/code',        split_repository: 'code'        }
+          - { local_path: 'packages/currency-input', split_repository: 'currency-input' }
+          - { local_path: 'packages/password-meter', split_repository: 'password-meter' }
+          - { local_path: 'packages/file-preview',   split_repository: 'file-preview'   }
+          - { local_path: 'packages/transfer-list',  split_repository: 'transfer-list'  }
+          - { local_path: 'packages/inline-edit',    split_repository: 'inline-edit'    }
+          - { local_path: 'packages/credit-card',    split_repository: 'credit-card'    }
 
           # ── Forms aggregate (metapackage) ─────────────────────────────────────
           - { local_path: 'packages/forms', split_repository: 'forms' }
@@ -69,6 +75,16 @@ jobs:
           - { local_path: 'packages/popover',              split_repository: 'popover'              }
           - { local_path: 'packages/sortable',             split_repository: 'sortable'             }
           - { local_path: 'packages/calendar',             split_repository: 'calendar'             }
+          - { local_path: 'packages/divider',              split_repository: 'divider'              }
+          - { local_path: 'packages/code-block',            split_repository: 'code-block'           }
+          - { local_path: 'packages/kbd',                   split_repository: 'kbd'                  }
+          - { local_path: 'packages/description-list',      split_repository: 'description-list'     }
+          - { local_path: 'packages/chat',                  split_repository: 'chat'                 }
+          - { local_path: 'packages/meter',                 split_repository: 'meter'                }
+          - { local_path: 'packages/copy-button',           split_repository: 'copy-button'          }
+          - { local_path: 'packages/carousel',              split_repository: 'carousel'             }
+          - { local_path: 'packages/kanban',                split_repository: 'kanban'               }
+          - { local_path: 'packages/scheduler',             split_repository: 'scheduler'            }
 
           # ── Content aggregate (metapackage) ───────────────────────────────────
           - { local_path: 'packages/content', split_repository: 'content' }
@@ -82,6 +98,7 @@ jobs:
           - { local_path: 'packages/dropmenu',      split_repository: 'dropmenu'      }
           - { local_path: 'packages/pagination',    split_repository: 'pagination'    }
           - { local_path: 'packages/theme-switcher',split_repository: 'theme-switcher'}
+          - { local_path: 'packages/context-menu',  split_repository: 'context-menu'  }
 
           # ── Navigation aggregate (metapackage) ────────────────────────────────
           - { local_path: 'packages/navigation', split_repository: 'navigation' }

.gitignore

@@ -10,3 +10,4 @@ node_modules
 /playwright-report
 /tests/E2E/public/*.html
 COMPONENT_BACKLOG.md
+COMPONENT_AUDIT.md

COMPONENT_BACKLOG.md

@@ -12,44 +12,50 @@ Status key: `[ ]` not started · `[~]` in progress · `[x]` complete · `[!]` re
 - [x] **Stepper / wizard** (`bladewind-stepper`, Navigation) — Horizontal and vertical steps with complete, current, error, and disabled states; allow clickable and linear workflows.
 - [x] **Sidebar navigation** (`bladewind-sidebar`, Navigation): Responsive nested application navigation with sections, icons, active states, badges, collapsible groups, and a mobile drawer mode.
 - [x] **Command palette** (`bladewind-command-palette`, Navigation) — Keyboard-first searchable action launcher with grouped actions, shortcuts, empty states, and asynchronous results.
-- [ ] **Tree view** (`bladewind-tree`, Content) — Expandable hierarchical data with single/multiple selection, checkboxes, lazy-loaded children, and full keyboard navigation.
+- [!] ~~**Tree view** (`bladewind-tree`, Content) — Expandable hierarchical data with single/multiple selection, checkboxes, lazy-loaded children, and full keyboard navigation.~~
 - [x] **Data grid / Table v2** (`bladewind-data-grid`, Content) — A higher-level companion to Table with column sorting, filtering, selection, sticky headers, pagination hooks, and server-driven state.
 - [x] **Calendar** (`bladewind-calendar`, Content) — Inline month/week calendar for displaying and selecting dates or events, distinct from the input-focused Datepicker.
-- [ ] **Context menu** (`bladewind-context-menu`, Navigation) — Pointer and keyboard-triggered action menu with nested items, separators, disabled actions, and viewport-aware placement.
-- [ ] **Segmented control** (`bladewind-segmented-control`, Forms) — Compact mutually exclusive choice control with text/icon options and form-compatible values.
+- [x] **Context menu** (`bladewind-context-menu`, Navigation) — Pointer and keyboard-triggered action menu with nested items, separators, disabled actions, and viewport-aware placement.
+- [!] ~~**Segmented control** (`bladewind-segmented-control`, Forms) — Compact mutually exclusive choice control with text/icon options and form-compatible values.~~
+- [x] **Divider / separator** (`bladewind-divider`, Content) — Horizontal or vertical rule with optional centered label, spacing variants, and decorative/semantic modes.
+- [!] ~~**Confirm / alert dialog** (`bladewind-confirm-dialog`, Content) — Purpose-built confirmation modal for destructive or consequential actions, with async pending state and cancel/confirm actions, distinct from the generic Modal.~~ Removed.
 
 ## Priority 2: forms and data entry
 
-- [ ] **Fieldset / form section** (`bladewind-fieldset`, Forms) — Accessible grouping with legend, description, required/optional state, validation summary, and collapsible sections.
-- [ ] **Masked input** (`bladewind-masked-input`, Forms) — Formatting and validation for phone numbers, currency, percentages, account numbers, and custom masks.
-- [ ] **Cascader** (`bladewind-cascader`, Forms) — Hierarchical selection for country/region, categories, and organisational structures with searchable levels.
-- [ ] **Transfer list** (`bladewind-transfer-list`, Forms) — Move one or many options between available and selected lists with search and select-all controls.
-- [ ] **Mention input** (`bladewind-mention`, Forms) — Textarea-like input with `@`/`#` suggestions, keyboard selection, custom result rendering, and serialisable values.
-- [ ] **Rich text editor** (`bladewind-editor`, Forms) — Opinionated, accessible editor with a deliberately small toolbar, sanitisation guidance, and pluggable upload handling.
-- [ ] **Signature pad** (`bladewind-signature`, Forms) — Draw, clear, undo, and export a signature with touch/pointer support and a hidden form value.
-- [ ] **Image cropper** (`bladewind-image-cropper`, Forms) — Preview, zoom, rotate, crop, and export an uploaded image; suitable for avatars and document capture.
-- [ ] **Editable text** (`bladewind-inline-edit`, Forms) — Display-to-input editing with save, cancel, validation, loading, and optimistic-update hooks.
+- [!] ~~**Fieldset / form section** (`bladewind-fieldset`, Forms) — Accessible grouping with legend, description, required/optional state, validation summary, and collapsible sections.~~
+- [!] ~~**Masked input** (`bladewind-masked-input`, Forms) — Formatting and validation for phone numbers, currency, percentages, account numbers, and custom masks.~~
+- [!] ~~**Cascader** (`bladewind-cascader`, Forms) — Hierarchical selection for country/region, categories, and organisational structures with searchable levels.~~
+- [x] **Transfer list** (`bladewind-transfer-list`, Forms) — Move one or many options between available and selected lists with search and select-all controls.
+- [!] ~~**Mention input** (`bladewind-mention`, Forms) — Textarea-like input with `@`/`#` suggestions, keyboard selection, custom result rendering, and serialisable values.~~
+- [!] ~~**Rich text editor** (`bladewind-editor`, Forms) — Opinionated, accessible editor with a deliberately small toolbar, sanitisation guidance, and pluggable upload handling.~~
+- [!] ~~**Signature pad** (`bladewind-signature`, Forms) — Draw, clear, undo, and export a signature with touch/pointer support and a hidden form value.~~
+- [!] ~~**Image cropper** (`bladewind-image-cropper`, Forms) — Preview, zoom, rotate, crop, and export an uploaded image; suitable for avatars and document capture.~~
+- [x] **Editable text** (`bladewind-inline-edit`, Forms) — Display-to-input editing with save, cancel, validation, loading, and optimistic-update hooks.
+- [x] **Password strength meter** (`bladewind-password-meter`, Forms) — Rules-based strength scoring and visual feedback for password fields, distinct from the generic Meter/gauge.
+- [x] **Currency / money input** (`bladewind-currency-input`, Forms) — Locale-aware currency formatting, symbol placement, and cents handling on top of the generic Number input.
+- [x] **Document / file preview** (`bladewind-file-preview`, Forms) — Read-only preview of an uploaded file (thumbnail, filename, size, download/remove actions) as the display counterpart to Filepicker.
 
 ## Priority 3: content and feedback
 
-- [ ] **Carousel** (`bladewind-carousel`, Content) — Responsive content/media slides with arrows, indicators, autoplay opt-in, swipe support, and reduced-motion handling.
-- [ ] **Lightbox / gallery** (`bladewind-gallery`, Content) — Thumbnail grid with full-screen preview, captions, keyboard navigation, zoom, and lazy loading.
-- [ ] **Guided tour / spotlight** (`bladewind-tour`, Content) — Anchored product walkthroughs with progress, skip/back controls, placement fallback, and persisted completion hooks.
-- [ ] **Split button** (`bladewind-split-button`, Content) — Primary action plus related action menu with loading, disabled, and destructive variants.
-- [ ] **Floating action button / speed dial** (`bladewind-speed-dial`, Content) — Fixed primary action that expands into labelled secondary actions with safe mobile positioning.
-- [ ] **Banner** (`bladewind-banner`, Content) — Page-level or global announcement bar with tone, icon, actions, dismissibility, and optional persistence.
-- [ ] **Code block** (`bladewind-code-block`, Content) — Syntax-highlighted code display with language label, line numbers/highlights, wrapping, and copy action; separate from the OTP Code component.
-- [ ] **Keyboard key** (`bladewind-kbd`, Content) — Small semantic key/shortcut display for help text, menus, and command documentation.
-- [ ] **Description list** (`bladewind-description-list`, Content) — Responsive label/value presentation for profiles, summaries, and record detail pages with action slots.
-- [ ] **Chat / message thread** (`bladewind-chat`, Content) — Message bubbles, sender/avatar metadata, timestamps, delivery states, attachments, and grouped messages.
-- [ ] **Meter / gauge** (`bladewind-meter`, Content) — Bounded value visualisation with thresholds and semantic low/medium/high states, distinct from progress completion.
+- [x] **Carousel** (`bladewind-carousel`, Content) — Responsive content/media slides with arrows, indicators, autoplay opt-in, swipe support, and reduced-motion handling.
+- [!] ~~**Lightbox / gallery** (`bladewind-gallery`, Content) — Thumbnail grid with full-screen preview, captions, keyboard navigation, zoom, and lazy loading.~~
+- [!] ~~**Guided tour / spotlight** (`bladewind-tour`, Content) — Anchored product walkthroughs with progress, skip/back controls, placement fallback, and persisted completion hooks.~~
+- [!] ~~**Split button** (`bladewind-split-button`, Content) — Primary action plus related action menu with loading, disabled, and destructive variants.~~
+- [!] ~~**Floating action button / speed dial** (`bladewind-speed-dial`, Content) — Fixed primary action that expands into labelled secondary actions with safe mobile positioning.~~
+- [!] ~~**Banner** (`bladewind-banner`, Content) — Page-level or global announcement bar with tone, icon, actions, dismissibility, and optional persistence.~~ Removed: duplicated Alert.
+- [x] **Code block** (`bladewind-code-block`, Content) — Syntax-highlighted code display with language label, line numbers/highlights, wrapping, and copy action; separate from the OTP Code component.
+- [x] **Keyboard key** (`bladewind-kbd`, Content) — Small semantic key/shortcut display for help text, menus, and command documentation.
+- [x] **Description list** (`bladewind-description-list`, Content) — Responsive label/value presentation for profiles, summaries, and record detail pages with action slots.
+- [x] **Chat / message thread** (`bladewind-chat`, Content) — Message bubbles, sender/avatar metadata, timestamps, delivery states, attachments, and grouped messages.
+- [x] **Meter / gauge** (`bladewind-meter`, Content) — Bounded value visualisation with thresholds and semantic low/medium/high states, distinct from progress completion.
+- [x] **Copy to clipboard button** (`bladewind-copy-button`, Content) — Copies a value or slot content to the clipboard with success/failure feedback and icon-only or labelled variants.
 
 ## Priority 4: specialised application widgets
 
-- [ ] **Kanban board** (`bladewind-kanban`, Content) — Columns and draggable cards with empty/loading states, movement hooks, and keyboard-accessible reordering.
-- [ ] **Scheduler** (`bladewind-scheduler`, Content) — Day/week resource schedule with time slots, event rendering, selection hooks, and timezone-aware values.
-- [ ] **Gantt chart** (`bladewind-gantt`, Content) — Project timeline with dependencies, milestones, zoom levels, progress, and horizontal virtualisation.
-- [ ] **Organisation chart** (`bladewind-org-chart`, Content) — Expandable reporting hierarchy with custom node slots, pan/zoom, and accessible list fallback.
+- [x] **Kanban board** (`bladewind-kanban`, Content) — Columns and draggable cards with empty/loading states, movement hooks, and keyboard-accessible reordering.
+- [x] **Scheduler** (`bladewind-scheduler`, Content) — Day/week resource schedule with time slots, event rendering, selection hooks, and timezone-aware values.
+- [!] ~~**Gantt chart** (`bladewind-gantt`, Content) — Project timeline with dependencies, milestones, zoom levels, progress, and horizontal virtualisation.~~
+- [!] ~~**Organisation chart** (`bladewind-org-chart`, Content) — Expandable reporting hierarchy with custom node slots, pan/zoom, and accessible list fallback.~~
 
 ## Deliberate non-duplicates
 
@@ -74,6 +80,7 @@ A component can be marked complete above only when all applicable items below ar
 - [ ] Every `config('bladewind.*')` key the component's view reads is also present in `packages/meta/config/bladewind.php`, with a matching default. See "Config surface" below.
 - [ ] The relevant group metapackage and root package dependencies/autoloading are updated.
 - [ ] Light mode, dark mode, responsive layout, RTL, disabled/loading/error states, and reduced motion are handled where relevant.
+- [ ] Livewire compatibility is considered: stateful JS-heavy components document a `wire:ignore` requirement so a Livewire re-render doesn't clobber client-side state, and form-bindable components fire native `input`/`change` events so `wire:model` picks up value changes.
 - [ ] Keyboard interaction, focus management, semantic markup, ARIA labelling, and screen-reader announcements are verified.
 - [ ] Unit/render tests and focused browser tests cover the component's important states and interactions.
 - [ ] Package README, website documentation, examples, prop tables, and upgrade notes are complete.