courthive-components 6.8.2 → 6.9.1

package/README.md

@@ -1,6 +1,6 @@
 # courthive-components
 
-Vanilla JavaScript UI components for tennis tournament management and competition displays.
+Framework-independent TypeScript UI components for tournament management and competition displays.
 
 [![Storybook](https://img.shields.io/badge/Storybook-Documentation-ff4785?logo=storybook)](https://courthive.github.io/courthive-components/)
 [![npm version](https://img.shields.io/npm/v/courthive-components.svg)](https://www.npmjs.com/package/courthive-components)
@@ -25,6 +25,16 @@ pnpm add courthive-components
 `yarn add courthive-components`. Inside the CourtHive monorepo,
 pnpm is the only supported manager.)
 
+## Feature imports
+
+SVG-only consumers such as a marketing hero can import from `courthive-components/courts`.
+The segmented bar is also available from `courthive-components/segmented-bar`.
+These additive ESM entries avoid loading the root editor, scoring and engine dependencies.
+Import `courthive-components/features.css` for their styles; it contains the small court/bar stylesheets.
+The existing root export and `dist/courthive-components.css` remain supported with their existing cascade.
+Run `pnpm build && pnpm verify:consumer-bundle` to check consumer JS and feature CSS budgets.
+Update a budget deliberately with `pnpm verify:consumer-bundle --update-baseline` after reviewing the measurements.
+
 ## Quick Start
 
 ```javascript
@@ -69,11 +79,11 @@ const element = renderMatchUp({
 Display a complete draw structure (bracket, round robin, etc.).
 
 ```javascript
-import { renderStructure } from 'courthive-components';
+import { renderStructure, compositions } from 'courthive-components';
 
 const element = renderStructure({
-  structure: drawStructure,
-  config: { showSeeds: true }
+  matchUps: drawMatchUps,
+  composition: compositions.Basic
 });
 ```
 
@@ -85,7 +95,7 @@ Display a single round of matches within a structure.
 import { renderRound } from 'courthive-components';
 
 const element = renderRound({
-  round: roundData,
+  matchUps: roundMatchUps,
   roundNumber: 1
 });
 ```
@@ -98,8 +108,7 @@ Display participant information (name, rating, country, etc.).
 import { renderParticipant } from 'courthive-components';
 
 const element = renderParticipant({
-  participant: participantData,
-  showRating: true
+  participant: participantData
 });
 ```
 
@@ -130,8 +139,10 @@ Autocomplete input for participant selection.
 import { renderParticipantInput } from 'courthive-components';
 
 const input = renderParticipantInput({
-  participants: participantsList,
-  onSelect: (participant) => console.log('Selected:', participant)
+  matchUp: matchUpData,
+  side: matchUpData.sides[0],
+  composition: { configuration: { participantProvider: () => participantsList } },
+  eventHandlers: { assignParticipant: ({ participant }) => console.log('Selected:', participant) }
 });
 ```
 
@@ -156,6 +167,11 @@ cModal.open({
 
 #### **scoringModal**
 
+Two scoring APIs remain supported. New integrations should use `openScoreEntryDialog`
+(the shared model/store-based card dialog); see `src/components/scoring/TMX_INTEGRATION.md`
+for its engine-outcome handoff. TMX chooses between it and `scoringModal` through a feature flag.
+`scoringModal` below is the existing configurable modal API. Their callback contracts differ.
+
 Interactive score entry with multiple input approaches.
 
 ```javascript
@@ -272,7 +288,7 @@ import { compositions } from 'courthive-components';
 compositions.Australian; // Australian Open colors
 compositions.French; // Roland Garros colors
 compositions.Wimbledon; // Wimbledon colors
-compositions.US; // US Open colors
+compositions['US Open']; // US Open colors
 ```
 
 ### Constants
@@ -284,7 +300,7 @@ Pre-defined match format codes.
 ```javascript
 import { MATCH_FORMATS } from 'courthive-components';
 
-console.log(MATCH_FORMATS.BEST_OF_3_TB7);
+console.log(MATCH_FORMATS.SET3_S6_TB7);
 // 'SET3-S:6/TB7'
 ```
 

package/dist/components/availability-grid/controller/availabilityGridControl.d.ts

@@ -1,8 +1,8 @@
 import { availability, AvailabilityEngine } from 'tods-competition-factory';
-import { AvailabilityViewState } from '../engine/viewState';
-import { DEFAULT_COLOR_SCHEME, ResourceGroupingMode } from './viewProjections';
 import { BlockPopoverManager } from '../ui/blockPopover';
+import { AvailabilityViewState } from '../engine/viewState';
 import { CourtTimeline } from '../timeline/CourtTimeline';
+import { DEFAULT_COLOR_SCHEME, ResourceGroupingMode } from './viewProjections';
 type BlockType = availability.BlockType;
 type CourtRef = availability.CourtRef;
 type DayId = availability.DayId;
@@ -61,6 +61,9 @@ export interface AvailabilityGridControlConfig {
 export declare class AvailabilityGridControl {
     private readonly engine;
     private timeline;
+    private disposed;
+    private mountTimer;
+    private popoverTimer;
     private readonly config;
     private unsubscribe;
     private currentItems;

package/dist/components/availability-grid/ui/availabilityGrid.d.ts

@@ -86,6 +86,7 @@ export declare class AvailabilityGrid {
     private statsBarInstance;
     private viewToolbarResult;
     private datepicker;
+    private courtVisibilityCustomized;
     private visibleCourts;
     private initialSnapshot;
     private isDirty;

package/dist/components/categories/ageCategory/ageCategory.d.ts

@@ -55,4 +55,5 @@ export declare function getAgeCategoryModal({ existingAgeCategoryCode, existingC
         disabled?: boolean;
         label?: string;
     }) => void;
+    close: () => void;
 };

package/dist/components/matchUpFormat/matchUpFormat.d.ts

@@ -129,4 +129,5 @@ export declare function getMatchUpFormatModal({ existingMatchUpFormat, callback,
         disabled?: boolean;
         label?: string;
     }) => void;
+    close: () => void;
 };

package/dist/components/modal/cmodal.d.ts

@@ -6,7 +6,7 @@ export declare function isArray(item: any): item is any[];
 export declare function isObject(item: any): item is object;
 export declare function removeAllChildNodes(parent: HTMLElement | null): void;
 export declare const cModal: {
-    close: (conditional?: boolean) => void;
+    close: (conditional?: boolean, ownedId?: number, cascade?: boolean) => void;
     open: ({ title, content, buttons, footer, config, onClose }?: ModalParams) => {
         setContent: ({ content: newContent, config }: {
             content?: ModalContent;
@@ -29,6 +29,7 @@ export declare const cModal: {
             disabled?: boolean;
             label?: string;
         }) => void;
+        close: () => void;
     };
 };
 export {};

package/dist/components/modal/scheduleCellConfigModal.d.ts

@@ -45,4 +45,5 @@ export declare function openScheduleCellConfigModal(options?: ScheduleCellConfig
         disabled?: boolean;
         label?: string;
     }) => void;
+    close: () => void;
 };

package/dist/components/scoring/scoreEntryCard.d.ts

@@ -174,6 +174,8 @@ export type ScoreEntryCard = {
      * Escape calls it first, wherever focus is, so one Escape closes the menu and a second one cancels.
      */
     closeMenus: () => boolean;
+    /** Release resources before removing an inline card or its modal. Safe to repeat. */
+    destroy: () => void;
     /** Re-render the band and the submit gate. Call when the score region's value changes. */
     refresh: () => void;
     /** Rebuild everything, including the region's cells. Call when the region's COLUMNS change. */