@dcrackel/hematournamentui 1.0.706 → 1.0.707

package/.prettierignore

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

package/.storybook/main.js

@@ -1,19 +1,12 @@
 /** @type { import('@storybook/vue3-vite').StorybookConfig } */
 const config = {
-  stories: [
-    "../src/**/*.mdx",
-    "../src/**/*.stories.@(js|jsx|ts|tsx|vue)"
-  ],
-  addons: [
-    "@storybook/addon-links",
-    "@chromatic-com/storybook",
-    "@storybook/addon-docs"
-  ],
+  stories: ['../src/**/*.mdx', '../src/**/*.stories.@(js|jsx|ts|tsx|vue)'],
+  addons: ['@storybook/addon-links', '@chromatic-com/storybook', '@storybook/addon-docs'],
   framework: {
-    name: "@storybook/vue3-vite",
-    options: {},
+    name: '@storybook/vue3-vite',
+    options: {}
   },
-  docs: {},
+  docs: {}
 };
 
 export default config;

package/.storybook/preview-head.html

@@ -1,4 +1,11 @@
 <!--<link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css" rel="stylesheet">-->
-<link href="https://pro.fontawesome.com/releases/v6.0.0-beta3/css/all.css?token=F0476B93-4907-4573-807B-E10E4A0A78FA" rel="stylesheet">
-<script src="https://maps.googleapis.com/maps/api/js?key=AIzaSyC5kuJeMLopgjHDqsQPjRZ6Fkg3PFydw9Q&libraries=places&callback=initMap" async defer></script>
-<script src="https://kit.fontawesome.com/3bd5f7e934.js" crossorigin="anonymous"></script>
+<link
+  href="https://pro.fontawesome.com/releases/v6.0.0-beta3/css/all.css?token=F0476B93-4907-4573-807B-E10E4A0A78FA"
+  rel="stylesheet"
+/>
+<script
+  src="https://maps.googleapis.com/maps/api/js?key=AIzaSyC5kuJeMLopgjHDqsQPjRZ6Fkg3PFydw9Q&libraries=places&callback=initMap"
+  async
+  defer
+></script>
+<script src="https://kit.fontawesome.com/3bd5f7e934.js" crossorigin="anonymous"></script>

package/.storybook/preview.js

@@ -7,20 +7,12 @@ const preview = {
     controls: {
       matchers: {
         color: /(background|color)$/i,
-        date: /Date$/,
-      },
-    },
+        date: /Date$/
+      }
+    }
   },
 
-  tags: [
-    'autodocs',
-    'autodocs',
-    'autodocs',
-    'autodocs',
-    'autodocs',
-    'autodocs',
-    'autodocs'
-  ]
+  tags: ['autodocs', 'autodocs', 'autodocs', 'autodocs', 'autodocs', 'autodocs', 'autodocs']
 };
 
-export default preview;
+export default preview;

package/AGENTS.md

@@ -37,7 +37,8 @@ This project is `@dcrackel/hematournamentui`, the shared Vue 3 Storybook/UI pack
 
 ## Interaction Pattern
 
-- Prefer optimistic UI for direct user edits: update the visible component state right away, then emit the change upward.
+- Prefer optimistic UI for presentation-only edits: update the visible component state right away, then emit the change upward.
+- Do not optimistically change authoritative workflow fields such as bout status, referee identity, sequence data, or completion timestamps.
 - The parent should perform persistence/API work and pass authoritative data back down through props.
 - Reconcile prop updates cleanly so the component reflects parent-owned truth after save, refresh, or rollback.
 - Do not block simple visual feedback on API completion unless the user action cannot be represented safely before confirmation.
@@ -70,6 +71,33 @@ This project is `@dcrackel/hematournamentui`, the shared Vue 3 Storybook/UI pack
 - Keep tournament domain rules explicit when they are needed for rendering. Name conditions that depend on pool vs DE, completed vs active, visible vs hidden, or editable vs read-only.
 - If a rule requires backend knowledge or app workflow context, prefer making it a prop or emitted decision rather than embedding the rule in a shared component.
 
+## Pool And Direct Elimination Boundaries
+
+- Pool and Direct Elimination workflows are intentionally different. Confirm the domain rule before reusing assignment behavior between them.
+- Pools may display available directors and emit pool, ring, or pool-work assignment intent. The consuming application persists that intent.
+- Do not change pool assignment behavior while implementing bracket behavior.
+- DE uses one shared collection of available bouts. The signed-in director claims a scheduled bout by selecting or starting it.
+- Bracket components must not accept `directors` or `currentUserId` for assignment behavior.
+- Bracket components must not expose director-selection modals, assignment buttons, or Assigned Bouts sections.
+- The consuming application supplies `RefereeId` and `RefName` from the signed-in user.
+
+## Authoritative Bout Fields
+
+- The consuming application owns `Status`, `RefereeId`, `RefName`, `RingName`, `Seq`, `LastUpdateSeq`, `Ended`, `SubmissionId`, persistence, and socket broadcasts.
+- UI components may display authoritative fields and emit intent, but must not fabricate or authoritatively change them.
+- Clicking a bout must not mark it Active. Submitting presentation data must not mark it Completed or create `Ended`.
+- Closing a modal must not reset a bout to Scheduled or erase scores.
+- Sequence freshness, stale-update rejection, recovery, and broadcast behavior belong in the consuming application.
+
+## Bracket Event Contract
+
+- Scheduled and active bout selections emit `update:directing-bout`.
+- Completed bout selections emit edit intent.
+- BYE and incomplete bouts cannot be directed.
+- List and tableau views must provide equivalent behavior.
+- Do not introduce `assign:director` or `action:assignBout` into bracket components.
+- Before adding a prop or event, search all component consumers and Storybook stories.
+
 ## Package Boundary
 
 - `src/index.js` is the package export surface. Keep exports intentional and stable.
@@ -84,5 +112,7 @@ This project is `@dcrackel/hematournamentui`, the shared Vue 3 Storybook/UI pack
 - Useful commands include `npm run lint`, `npm run build-storybook`, `npm run build:tailwind`, and `npm run test`.
 - For component behavior changes, verify emitted events, optimistic display updates, prop reconciliation, empty states, disabled states, and responsive layout.
 - For public API changes, update Storybook stories and check the consuming app contract.
+- For bracket changes, test scheduled directing, active resume, completed editing, BYE rejection, modal-close state preservation, list/tableau consistency, and the absence of director-assignment UI.
 - Keep Storybook args aligned with component props. Stories should use `{ args: { ... } }`, include required props in every variant, and use correct control types for arrays, objects, booleans, and text.
 - Avoid running package version/publish flows unless explicitly requested. `npm run build` currently patches the package version as part of the script.
+- Use `npm run build:check` for routine package validation without changing the package version.

package/README.md

@@ -6,32 +6,31 @@ This template should help get you started developing with Vue 3 in Vite. The tem
 
 - [VS Code](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur) + [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin).
 
+## Publishing a Storybook Library to NPM
 
+Follow this guide to publish your Storybook library to NPM, making it available for others to easily npm install.
 
+## Shared CSS
 
+Build the package stylesheet as a separate step:
+
+```bash
+npm run build:package-css
+```
+
+The generated file is `dist/hematournamentui-tailwind.css`. Consuming apps should import it from the package instead of manually copying `tailwind/output.css`:
+
+```js
+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.
+
+# 1. Setup & Prerequisites
+
+Ensure you have an account on npm. If not, you can create one for free.
+Verify node and npm installations:
 
-## Publishing a Storybook Library to NPM
-Follow this guide to publish your Storybook library to NPM, making it available for others to easily npm install.
-
-## Shared CSS
-
-Build the package stylesheet as a separate step:
-
-```bash
-npm run build:package-css
-```
-
-The generated file is `dist/hematournamentui-tailwind.css`. Consuming apps should import it from the package instead of manually copying `tailwind/output.css`:
-
-```js
-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.
-
-# 1. Setup & Prerequisites
-Ensure you have an account on npm. If not, you can create one for free.
-Verify node and npm installations:
 ```
 Copy code
 node -v
@@ -39,6 +38,7 @@ npm -v
 ```
 
 # 2. Preparing Your Storybook Library
+
 a. Building the Library
 Compile your library with Vite or your bundler:
 
@@ -55,20 +55,24 @@ main: Main entry file (e.g., dist/index.js).
 files: Files to include, e.g., ["dist"].
 
 # 3. Logging in to NPM
+
 Login to npm (if you haven't already):
 
 ```
 npm login
 ```
+
 Provide your username, password, and email.
 
 # 4. Publishing to NPM
+
 a. Default (Private Package)
 For scoped private packages (@username/project-name):
 
 ```
 npm publish
 ```
+
 b. Public Package
 For public packages:
 
@@ -77,14 +81,17 @@ npm publish --access=public
 ```
 
 # 5. Verifying Your Package
+
 Check on the npm website to verify your package's publication.
 
 Check the registry name
+
 ```
 npm get registry
 ```
 
 # 6. Installing and Using the Library
+
 To install the library:
 
 ```