courthive-components 2.0.0 → 3.0.0

package/dist/components/{temporal-grid/controller/temporalGridControl.d.ts → availability-grid/controller/availabilityGridControl.d.ts}

@@ -1,12 +1,12 @@
 import { availability, AvailabilityEngine } from 'tods-competition-factory';
-import { TemporalViewState } from '../engine/viewState';
+import { AvailabilityViewState } from '../engine/viewState';
 import { DEFAULT_COLOR_SCHEME, ResourceGroupingMode } from './viewProjections';
 import { BlockPopoverManager } from '../ui/blockPopover';
 import { CourtTimeline } from '../timeline/CourtTimeline';
 type BlockType = availability.BlockType;
 type CourtRef = availability.CourtRef;
 type DayId = availability.DayId;
-export interface TemporalGridControlConfig {
+export interface AvailabilityGridControlConfig {
     /** Container element for the timeline */
     container: HTMLElement;
     /** Initial selected day */
@@ -43,8 +43,22 @@ export interface TemporalGridControlConfig {
      * native browser alert).
      */
     onConflict?: (conflicts: any[]) => void;
+    /**
+     * Optional callback rendered as a "Manage Registrations" menu item on
+     * the block popover for PRACTICE blocks. The argument carries the
+     * resolved block descriptor — consumers use it to open their practice-
+     * registration management surface (e.g. a cModal in TMX).
+     */
+    onManageRegistrations?: (args: {
+        blockId: string;
+        courtId: string;
+        venueId: string;
+        date: string;
+        startTime: string;
+        endTime: string;
+    }) => void;
 }
-export declare class TemporalGridControl {
+export declare class AvailabilityGridControl {
     private readonly engine;
     private timeline;
     private readonly config;
@@ -57,7 +71,7 @@ export declare class TemporalGridControl {
     private currentView;
     private selectedCourts;
     private visibleCourts;
-    constructor(engine: AvailabilityEngine, config: TemporalGridControlConfig);
+    constructor(engine: AvailabilityEngine, config: AvailabilityGridControlConfig);
     private initialize;
     /**
      * Ensure timeline exists. Defers creation to the next macro-task so the
@@ -143,8 +157,8 @@ export declare class TemporalGridControl {
     /** Get engine instance */
     getEngine(): AvailabilityEngine;
     /** Get view state (for external consumers to subscribe to view changes) */
-    getViewState(): TemporalViewState;
+    getViewState(): AvailabilityViewState;
 }
-/** Create a temporal grid controller */
-export declare function createTemporalGridControl(engine: AvailabilityEngine, config: TemporalGridControlConfig): TemporalGridControl;
+/** Create a availability grid controller */
+export declare function createAvailabilityGridControl(engine: AvailabilityEngine, config: AvailabilityGridControlConfig): AvailabilityGridControl;
 export {};

package/dist/components/{temporal-grid → availability-grid}/engine/viewState.d.ts

@@ -12,7 +12,7 @@ export interface ViewChangeEvent {
     payload: Partial<ViewStateSnapshot>;
 }
 export type ViewChangeListener = (event: ViewChangeEvent) => void;
-export declare class TemporalViewState {
+export declare class AvailabilityViewState {
     private selectedDay;
     private selectedVenue;
     private selectedCourt;

package/dist/components/{temporal-grid → availability-grid}/index.d.ts

@@ -1,14 +1,14 @@
 /**
- * Temporal Grid - Main Entry Point
+ * Availability Grid - Main Entry Point
  *
- * Engine modules re-exported from tods-competition-factory via `temporal` namespace.
+ * Engine modules re-exported from tods-competition-factory via `availability` namespace.
  * Controller, UI, and view state are local to courthive-components.
  */
-export { AvailabilityEngine, AvailabilityEngine as TemporalGridEngine, availability } from 'tods-competition-factory';
-export { TemporalViewState, type ViewChangeEvent, type ViewChangeListener, type ViewStateSnapshot } from './engine/viewState';
-export { createTemporalGridControl, TemporalGridControl, type TemporalGridControlConfig } from './controller/temporalGridControl';
+export { AvailabilityEngine, AvailabilityEngine as AvailabilityGridEngine, availability } from 'tods-competition-factory';
+export { AvailabilityViewState, type ViewChangeEvent, type ViewChangeListener, type ViewStateSnapshot } from './engine/viewState';
+export { createAvailabilityGridControl, AvailabilityGridControl, type AvailabilityGridControlConfig } from './controller/availabilityGridControl';
 export { buildBlockEvents, buildCapacityVisualization, buildConflictEvents, buildEventsFromTimelines, buildVenueGroups, buildHiddenDates, buildResourcesFromTimelines, buildTimeSlotConfig, buildTimelineWindowConfig, DEFAULT_COLOR_SCHEME, filterEventsByTimeRange, filterResourcesByVenue, generateBlockPatternCSS, isBlockEvent, isConflictEvent, isSegmentEvent, parseBlockEventId, parseResourceId, sortResources, type BlockColorScheme, type CalendarEvent, type CalendarResource, type TimelineGroup, type TimelineItem, type ProjectionConfig, type ResourceGroupingMode } from './controller/viewProjections';
-export { createTemporalGrid, TemporalGrid, type TemporalGridCallbacks, type TemporalGridConfig, type TemporalGridLabels } from './ui/temporalGrid';
+export { createAvailabilityGrid, AvailabilityGrid, type AvailabilityGridCallbacks, type AvailabilityGridConfig, type AvailabilityGridLabels } from './ui/availabilityGrid';
 export { ModernTimePicker, showModernTimePicker, type TimePickerConfig } from './ui/modernTimePicker';
 export { createBlockPopoverManager, type BlockPopoverManager, type BlockPopoverOptions, type EngineBlockPopoverOptions } from './ui/blockPopover';
 export { buildStatsBar, type StatsBarUpdate } from './ui/statsBar';

package/dist/components/{temporal-grid/ui/temporalGrid.d.ts → availability-grid/ui/availabilityGrid.d.ts}

@@ -1,11 +1,11 @@
 import { AvailabilityEngine, availability } from 'tods-competition-factory';
-import { TemporalGridControl, TemporalGridControlConfig } from '../controller/temporalGridControl';
+import { AvailabilityGridControl, AvailabilityGridControlConfig } from '../controller/availabilityGridControl';
 type DayId = availability.DayId;
 /**
- * i18n labels for the temporal grid component.
+ * i18n labels for the availability grid component.
  * All fields are optional — English defaults are used when omitted.
  */
-export interface TemporalGridLabels {
+export interface AvailabilityGridLabels {
     view?: string;
     day1?: string;
     days3?: string;
@@ -19,13 +19,13 @@ export interface TemporalGridLabels {
     setDefaultAvailability?: string;
     saveToTournament?: string;
 }
-export interface TemporalGridCallbacks {
+export interface AvailabilityGridCallbacks {
     /**
      * Called when dirty state changes (blocks/availability modified vs initial)
      */
     onDirtyChange?: (isDirty: boolean) => void;
 }
-export interface TemporalGridConfig extends Partial<TemporalGridControlConfig>, TemporalGridCallbacks {
+export interface AvailabilityGridConfig extends Partial<AvailabilityGridControlConfig>, AvailabilityGridCallbacks {
     /**
      * Tournament record (TODS format)
      */
@@ -57,7 +57,7 @@ export interface TemporalGridConfig extends Partial<TemporalGridControlConfig>,
     /**
      * i18n labels
      */
-    labels?: TemporalGridLabels;
+    labels?: AvailabilityGridLabels;
     /**
      * Language code for datepicker localization (e.g. 'en', 'fr', 'de')
      */
@@ -75,7 +75,7 @@ export interface TemporalGridConfig extends Partial<TemporalGridControlConfig>,
      */
     onMutationsApplied?: (mutations: any[]) => void;
 }
-export declare class TemporalGrid {
+export declare class AvailabilityGrid {
     private engine;
     private control;
     private config;
@@ -89,7 +89,7 @@ export declare class TemporalGrid {
     private visibleCourts;
     private initialSnapshot;
     private isDirty;
-    constructor(config: TemporalGridConfig);
+    constructor(config: AvailabilityGridConfig);
     /**
      * Render the component into a container
      */
@@ -132,7 +132,7 @@ export declare class TemporalGrid {
     /**
      * Get the controller instance
      */
-    getControl(): TemporalGridControl | null;
+    getControl(): AvailabilityGridControl | null;
     /**
      * Set the selected day
      */
@@ -143,7 +143,7 @@ export declare class TemporalGrid {
     refresh(): void;
 }
 /**
- * Create and render a temporal grid
+ * Create and render a availability grid
  */
-export declare function createTemporalGrid(config: TemporalGridConfig, container: HTMLElement): TemporalGrid;
+export declare function createAvailabilityGrid(config: AvailabilityGridConfig, container: HTMLElement): AvailabilityGrid;
 export {};

package/dist/components/{temporal-grid → availability-grid}/ui/blockPopover.d.ts

@@ -19,6 +19,21 @@ export interface EngineBlockPopoverOptions {
     engine: AvailabilityEngine;
     day: string;
     onBlockChanged: () => void;
+    /**
+     * Optional callback rendered as a "Manage Registrations" menu item for
+     * PRACTICE blocks. Provides the resolved block descriptor (courtId, date,
+     * sub-window times) so the consumer can resolve to its bookingId without
+     * a round trip — the factory derives bookingId from `${courtId}-${date}-${startTime}`
+     * when the booking lacks an explicit one.
+     */
+    onManageRegistrations?: (args: {
+        blockId: string;
+        courtId: string;
+        venueId: string;
+        date: string;
+        startTime: string;
+        endTime: string;
+    }) => void;
 }
 export interface BlockPopoverManager {
     show(target: HTMLElement, options: BlockPopoverOptions): void;

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

@@ -54,7 +54,7 @@ export interface MockParticipantsConfig {
  *
  * Features:
  * - Gender selection (Any/Male/Female)
- * - Participant count (8-256)
+ * - Participant count (8-128)
  * - Age range with automatic validation (ageMax >= ageMin)
  * - Number of countries to limit nationality diversity
  * - Optional WTN/UTR ratings

package/dist/components/renderStructure/renderStructureMinimap.d.ts

@@ -0,0 +1,7 @@
+import { MatchUp } from '../../types';
+export interface StructureMinimapOptions {
+    matchUps: MatchUp[];
+    width?: number;
+    quarterCount?: number;
+}
+export declare function buildStructureMinimap({ matchUps, width, quarterCount }: StructureMinimapOptions): HTMLDivElement | null;

package/dist/components/schedule-page/domain/activeStrip.d.ts

@@ -13,7 +13,7 @@
  *
  *   - computeActiveStripDropTarget(grid, courtId, dragged)
  *       Picks a row when a matchUp is dropped onto a court's strip cell.
- *       It infers a "temporal floor" from the existing grid:
+ *       It infers a "scheduled floor" from the existing grid:
  *         (a) any row across all courts where the dragged matchUp's
  *             participants already appear — the dragged matchUp must land
  *             below those rows;

package/dist/components/schedule-page/index.d.ts

@@ -20,7 +20,7 @@ export { buildScheduleInspectorPanel } from './ui/inspectorPanel';
 export { buildCourtGridSlot } from './ui/courtGridSlot';
 export { buildSchedulePageLayout } from './ui/schedulePageLayout';
 export { buildActiveStripPanel } from './ui/activeStrip';
-export type { ActiveStripPanel, ActiveStripPanelCallbacks, ActiveStripPanelData, ActiveStripPanelOptions, ActiveStripCourtMeta } from './ui/activeStrip';
+export type { ActiveStripPanel, ActiveStripPanelCallbacks, ActiveStripPanelData, ActiveStripPanelOptions, ActiveStripCourtMeta, ActiveStripCourtBlock } from './ui/activeStrip';
 export { buildScheduleGridCell, mapMatchUpToCellData, DEFAULT_SCHEDULE_CELL_CONFIG } from './ui/scheduleGridCell';
 export { activateScheduleCellTypeAhead } from './ui/scheduleCellTypeAhead';
 export type { ScheduleCellTypeAheadOptions } from './ui/scheduleCellTypeAhead';

package/dist/components/schedule-page/types.d.ts

@@ -249,5 +249,19 @@ export interface ScheduleCellData {
         bookingType?: string;
         rowCount?: number;
         notes?: string;
+        /**
+         * Participant labels to render below the booking type. Pre-formatted
+         * by the consumer so the cell stays display-only — e.g.
+         * `["Smith / Jones (14:00–14:30)", "Ortiz (14:30–15:00)"]`.
+         *
+         * NOTE: as of 2026-06-01 there is no expected consumer. The Now/Live
+         * strip uses a separate banner path (`ActiveStripCourtBlock.detail`),
+         * and PRACTICE bookings are time-windowed — they don't currently
+         * surface as grid cells, which have fixed row positions, not fixed
+         * times. The field is kept available for future use (e.g. if a
+         * tournament chooses to materialize PRACTICE bookings as cells) but
+         * no production callsite populates it today.
+         */
+        registrations?: string[];
     };
 }

package/dist/components/schedule-page/ui/activeStrip.d.ts

@@ -4,11 +4,34 @@ export interface ActiveStripCourtMeta {
     courtId: string;
     label: string;
 }
+/**
+ * Active availability block surfaced on a court for the current clock time.
+ * When present, the strip renders a labeled banner inside the court's cell
+ * (e.g. "PRACTICE 14:00–16:00") so the TD sees at a glance that the court
+ * has a non-matchUp time reservation in effect.
+ *
+ * The strip itself is data-driven and does NOT poll the clock; consumers
+ * are expected to refresh `ActiveStripPanelData` periodically (e.g. every
+ * 30s) with the blocks active at "now".
+ */
+export interface ActiveStripCourtBlock {
+    /** Block type label, used as the banner intent class (e.g. "PRACTICE", "MAINTENANCE"). */
+    type: string;
+    /** Banner text. Caller controls formatting — e.g. "PRACTICE 14:00–16:00". */
+    label: string;
+    /** Optional short note (block.reason, registrant name from a future practice-registration system, etc.). */
+    detail?: string;
+}
 export interface ActiveStripPanelData {
     /** Court columns, in display order. The strip computes one cell per column. */
     grid: ActiveStripGrid;
     /** Optional display labels per courtId. Falls back to courtId. */
     courts?: ActiveStripCourtMeta[];
+    /**
+     * Optional map of courtId → active availability block. When provided, the
+     * strip renders a colored banner inside the court's active cell.
+     */
+    courtBlocks?: Record<string, ActiveStripCourtBlock>;
     /**
      * CSS grid-template-columns applied to the strip root. When provided, the
      * strip lays out as `display: grid` with a leading spacer occupying the

package/dist/components/scheduling-profile/domain/validateProfile.d.ts

@@ -1,11 +1,12 @@
-import { SchedulingProfile, ValidationResult, TemporalAdapter, DependencyAdapter, FlattenedRound } from '../types';
+import { SchedulingProfile, ValidationResult, AvailabilityAdapter, DemandAdapter, DependencyAdapter, FlattenedRound } from '../types';
 export interface ValidateProfileParams {
     profile: SchedulingProfile;
-    temporal?: TemporalAdapter;
+    availability?: AvailabilityAdapter;
+    demand?: DemandAdapter;
     dependencies?: DependencyAdapter;
     venueOrder?: string[];
 }
-export declare function validateProfile({ profile, temporal, dependencies, venueOrder }: ValidateProfileParams): ValidationResult[];
+export declare function validateProfile({ profile, availability, demand, dependencies, venueOrder }: ValidateProfileParams): ValidationResult[];
 export declare function validateRoundPrecedenceLocal({ profile }: {
     profile: SchedulingProfile;
     venueOrder?: string[];

package/dist/components/scheduling-profile/index.d.ts

@@ -20,5 +20,5 @@ export { buildIssuesPanel } from './ui/issuesPanel';
 export { buildRoundCard } from './ui/roundCard';
 export { createCardPopoverManager } from './ui/cardPopover';
 export { buildSchedulingProfileLayout } from './ui/schedulingProfileLayout';
-export type { SchedulingProfile, ScheduleDay, VenueSchedule, RoundProfile, RoundSegment, VenueInfo, CatalogRoundItem, CatalogGroupBy, RoundKey, RoundLocator, DragPayload, CatalogDragPayload, PlannedDragPayload, DropTarget, DropResult, Severity, ValidationCode, FixActionKind, FixAction, ValidationResult, SeverityCounts, IssueIndex, ProfileStoreState, ProfileChangeListener, TemporalAdapter, DemandAdapter, DependencyAdapter, SchedulingProfileConfig, UIPanel, FlattenedRound, PlannedRoundBehavior } from './types';
+export type { SchedulingProfile, ScheduleDay, VenueSchedule, RoundProfile, RoundSegment, VenueInfo, CatalogRoundItem, CatalogGroupBy, RoundKey, RoundLocator, DragPayload, CatalogDragPayload, PlannedDragPayload, DropTarget, DropResult, Severity, ValidationCode, FixActionKind, FixAction, ValidationResult, SeverityCounts, IssueIndex, ProfileStoreState, ProfileChangeListener, AvailabilityAdapter, DemandAdapter, DependencyAdapter, SchedulingProfileConfig, UIPanel, FlattenedRound, PlannedRoundBehavior } from './types';
 export declare function createSchedulingProfile(config: SchedulingProfileConfig, container: HTMLElement): SchedulingProfileControl;

package/dist/components/scheduling-profile/types.d.ts

@@ -85,7 +85,7 @@ export interface DropResult {
 }
 export type Severity = 'ERROR' | 'WARN' | 'INFO';
 export type ValidationCode = 'DATE_UNAVAILABLE' | 'DUPLICATE_ROUND' | 'DUPLICATE_SEGMENT' | 'INVALID_SEGMENT_CONFIG' | 'ROUND_ORDER_VIOLATION' | 'DEPENDENCY_VIOLATION' | 'DAY_OVERLOAD' | 'DROP_REJECTED';
-export type FixActionKind = 'JUMP_TO_ITEM' | 'OPEN_TEMPORAL_GRID' | 'MOVE_ITEM_AFTER' | 'MOVE_ITEM_BEFORE';
+export type FixActionKind = 'JUMP_TO_ITEM' | 'OPEN_AVAILABILITY_GRID' | 'MOVE_ITEM_AFTER' | 'MOVE_ITEM_BEFORE';
 export interface FixAction {
     kind: FixActionKind;
     label: string;
@@ -150,7 +150,7 @@ export interface ProfileStoreState {
     plannedRoundBehavior: PlannedRoundBehavior;
 }
 export type ProfileChangeListener = (state: ProfileStoreState) => void;
-export interface TemporalAdapter {
+export interface AvailabilityAdapter {
     isDateAvailable: (date: string) => {
         ok: boolean;
         reason?: string;
@@ -179,7 +179,7 @@ export interface SchedulingProfileConfig {
     catalogSide?: 'left' | 'right';
     initialProfile?: SchedulingProfile;
     selectedDate?: string;
-    temporalAdapter?: TemporalAdapter;
+    availabilityAdapter?: AvailabilityAdapter;
     demandAdapter?: DemandAdapter;
     dependencyAdapter?: DependencyAdapter;
     venueOrder?: string[];