@dcrackel/hematournamentui 1.0.712 → 1.0.714

package/.prettierignore

@@ -1,7 +1,7 @@
-node_modules/
-dist/
-storybook-static/
-coverage/
-tailwind/output.css
-package-lock.json
-*.log
+node_modules/
+dist/
+storybook-static/
+coverage/
+tailwind/output.css
+package-lock.json
+*.log

package/.storybook/main.js

@@ -4,7 +4,9 @@ const config = {
   addons: ['@storybook/addon-links', '@chromatic-com/storybook', '@storybook/addon-docs'],
   framework: {
     name: '@storybook/vue3-vite',
-    options: {}
+    options: {
+      docgen: 'vue-component-meta'
+    }
   },
   docs: {}
 };

package/README.md

@@ -26,6 +26,48 @@ import '@dcrackel/hematournamentui/tailwind.css';
 
 Use `npm run build:tailwind` for Storybook's local `tailwind/output.css` workflow. Use `npm run build:package-css` when preparing CSS for the parent app or package publish.
 
+## Single bracket bout director assignment
+
+Hover over a bracket pairing for a compact action dropdown; clicking the pairing still opens the bout directly. The dropdown offers Open bout, Resume bout, or Edit bout according to status. Assign director is enabled by default for scheduled bouts except the final and grand final; a parent can explicitly disable `showBoutDirectorAssignment` when needed. When a director is assigned, the hover menu shows their name as static text in the assigned ring/connector color above Assign Director, with bright blue as a fallback when no color is supplied. Active and completed bouts show their saved director above Resume bout or Edit bout. Unassigned bouts omit the name. No permanent icon is rendered.
+
+```vue
+<Bracket
+  v-bind="bracketProps"
+  :showBoutDirectorAssignment="canManageAssignments"
+  @request:bout-director="openStaffDirectorPicker"
+/>
+```
+
+`request:bout-director` carries a detached copy of the current bout, including `BoutId` and `DEBoutId` when supplied. The app opens its Staff-based picker, saves the choice, and passes updated planned coverage through `plannedDirectingStations` and `plannedBoutAssignments`. This action does not start the bout or change referee, score, sequence, or completion fields. Active, completed, and unidentified bouts have no assignment action. Planning is independent of directing eligibility, so future slots represented as BYE placeholders can also be assigned. Scheduled future bouts can be assigned before both competitors are known.
+
+The dropdown opens after a short hover delay and stays open while moving into it. Keyboard focus reveals it immediately; Arrow Down enters its actions, arrows move between actions, and Escape dismisses it and restores focus. It closes on outside clicks or scrolling. The `HoverBoutActions` Storybook example includes a mock parent picker. Production distribution and section assignment remain app-owned. For standalone `TableauBoutCard` usage, pass `plannedDirectorName` and `plannedDirectorColor` to display planned assignment context without changing the bout's saved referee fields. `TableauColumn` accepts the `plannedStationByBout` lookup used by `Tableau` and forwards each planned director name and color. Each complete connector uses the receiving bout's planned director/ring color, including both feeders and the joining line. A receiving bout with no planned director has a neutral connector.
+
+## Storybook planned coverage
+
+All bracket stories enable director assignment. The default examples start with two directors. The story parent splits scheduled main-bracket bouts into contiguous halves for two directors and quarters for four, through the semifinals, inclusive. Finals, placement, and consolation rounds receive no automatic assignments; eligible bouts there remain available for anyone to claim, including a fresh director.
+
+Three, five, and six directors use near-equal contiguous groups within each round. Known opening BYEs add no work; future empty slots remain plannable. With two or four directors, section boundaries stay aligned with bracket halves or quarters even when BYEs make workloads uneven. With other counts, boundaries can shift as rounds narrow. Adding a director redistributes scheduled coverage and preserves existing plans for active and completed bouts. Manual bout assignment remains available through the semifinals. Finals cannot be preassigned and remain available to claim when both competitors are known.
+
+The ThreeDirectors, FourDirectors, FiveDirectors, and SixDirectors stories demonstrate the counts. Distribution lives in the story parent simulation; reusable components still receive explicit `plannedDirectingStations` and `plannedBoutAssignments` from the consuming app.
+
+The right-column director cards include a remove control. `Bracket` emits `request:remove-planned-director` with the selected station, including its `RingId` and `Director`. The consuming app removes that station from planned coverage, redistributes scheduled work as needed, and supplies the updated props. Removing planned coverage does not clear saved referee fields or change active/completed bouts. The story demonstrates removal, redistribution, removing the last director, and adding a removed director again.
+
+## DE director roster contract
+
+Supply `availableDirectors` and `rings` to `Bracket` to enable the roster modal. Add director and Manage open a list with selection checkboxes and a ring dropdown per person. The parent prepares eligible staff and optional default rings from Staff and pool assignments; staff who only help in DE need no pool assignment. This package does not read or change the Staff screen or pool data.
+
+`availableDirectors` contains `{ PersonId, DisplayName, Color, PortraitUrl?, DefaultRingId? }`. `rings` contains `{ RingId, RingName, Color?, Disabled? }`. Saved `plannedDirectingStations` keep the existing `{ RingId, RingName, Color, Director: { PersonId, DisplayName, PortraitUrl? } }` shape. Director IDs identify people; ring IDs identify coverage stations. One selected director per ring matches the current station and bout-assignment contract. The modal permits changing both draft rows before saving a ring swap and reports duplicate or missing rings.
+
+Saving emits `update:planned-directing-stations` with a detached full station list. Unchecking a person removes them from DE coverage. Ring changes are made in the modal; right-column cards display the selected ring as plain text. The parent saves the intent, redistributes scheduled coverage as appropriate, and returns authoritative props. Existing active/completed bout fields and pool assignments remain parent-owned. Each director keeps their supplied color when changing rings.
+
+If those new data props are omitted, the existing `request:add-planned-director` callback remains available for parent-owned add UI. `BracketDirectorsModal` is also exported for standalone use with `show`, `availableDirectors`, `rings`, and `stations`; it emits `update:show` and `submit:stations`.
+
+## Phone directing view
+
+Below 768px, the bracket shows the bout list with connection status and planned ring suggestions. The organising panel and assignment actions are unavailable on phones, even when their props are enabled. Completed bouts sit in a collapsed section for score corrections. Returning to desktop restores the selected List View or Tableau.
+
+Phone event navigation keeps Pools, Pool Results, Bracket, Final Results, and Penalties accessible in a scrolling row. Edit, Staff, Displays, and Checkin remain in the desktop organiser menu. Selecting List View on desktop does not change the navigation. The PhoneDirector bracket story demonstrates this responsive layout; use a viewport narrower than 768px.
+
 ## Event waitlist setting
 
 The event wizard exposes an Enable Waitlist toggle beneath Max Fencers on Basic Info. The boolean event field `WaitlistEnabled` defaults to `true` when absent and preserves an explicit `false`. Both `update:submit` and `save:step` include the field on the event payload, separately from `rules`. The consuming app persists it and returns the saved value through the `event` prop; registration availability and capacity enforcement remain app-owned.