courthive-components 1.1.1 → 1.2.0

package/dist/components/schedule-page/controller/schedulePageControl.d.ts

@@ -11,6 +11,9 @@ export declare class SchedulePageControl {
     setMatchUpCatalog(catalog: CatalogMatchUpItem[]): void;
     setScheduleDates(dates: ScheduleDate[]): void;
     setIssues(issues: ScheduleIssue[]): void;
+    setActiveStripVisible(visible: boolean): void;
+    toggleActiveStrip(): void;
+    get activeStripVisible(): boolean;
     save(): PendingScheduleAction[];
     discardPending(): void;
     get hasUnsavedChanges(): boolean;

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

@@ -0,0 +1,72 @@
+/**
+ * Schedule Page — Active Strip
+ *
+ * The active strip is a one-row summary that sits above the court grid and
+ * shows, for each court, what is "actively" happening: the in-progress
+ * matchUp if any, otherwise the next pending matchUp, otherwise the most
+ * recent completed matchUp, otherwise free.
+ *
+ * Two pure functions:
+ *
+ *   - computeActiveStrip(grid)
+ *       Picks the cell to surface per court column.
+ *
+ *   - 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:
+ *         (a) any row across all courts where the dragged matchUp's
+ *             participants already appear — the dragged matchUp must land
+ *             below those rows;
+ *         (b) within the same draw, any row holding a lower-round matchUp —
+ *             the dragged matchUp must land below those rows too.
+ *       The dragged matchUp's own existing cell is ignored (relocation).
+ *
+ * Both functions are framework-free and DOM-free; tests do not require a UI.
+ */
+export interface ActiveStripGridMatchUp {
+    matchUpId: string;
+    drawId?: string;
+    roundNumber?: number;
+    matchUpStatus?: string;
+    winningSide?: number;
+    /** True when at least one set/score has been entered. */
+    hasScore?: boolean;
+    participantIds: string[];
+    /**
+     * Consumer-defined opaque payload, passed through unchanged.
+     * Useful so the cell renderer can reach the full grid-cell data.
+     */
+    payload?: unknown;
+}
+export interface ActiveStripCourtColumn {
+    courtId: string;
+    /** Ordered cells from row 0 (top) downward. `null` marks an empty row. */
+    cells: (ActiveStripGridMatchUp | null)[];
+}
+export interface ActiveStripGrid {
+    columns: ActiveStripCourtColumn[];
+}
+export type ActiveStripCellState = 'free' | 'in-progress' | 'next' | 'completed';
+export interface ActiveStripCell {
+    courtId: string;
+    state: ActiveStripCellState;
+    matchUp?: ActiveStripGridMatchUp;
+    rowIndex?: number;
+}
+export interface ActiveStripDropCandidate {
+    matchUpId: string;
+    drawId?: string;
+    roundNumber?: number;
+    participantIds: string[];
+}
+export interface ActiveStripDropTarget {
+    courtId: string;
+    rowIndex: number;
+}
+export interface ActiveStripStatusOptions {
+    inProgressStatuses?: ReadonlySet<string>;
+    completedStatuses?: ReadonlySet<string>;
+}
+export declare function computeActiveStripCell(column: ActiveStripCourtColumn, options?: ActiveStripStatusOptions): ActiveStripCell;
+export declare function computeActiveStrip(grid: ActiveStripGrid, options?: ActiveStripStatusOptions): ActiveStripCell[];
+export declare function computeActiveStripDropTarget(grid: ActiveStripGrid, targetCourtId: string, dragged: ActiveStripDropCandidate): ActiveStripDropTarget;

package/dist/components/schedule-page/engine/schedulePageStore.d.ts

@@ -28,6 +28,8 @@ export declare class SchedulePageStore {
     setShowCompleted(show: boolean): void;
     setShowScheduled(show: boolean): void;
     toggleLeftPanel(): void;
+    setActiveStripVisible(visible: boolean): void;
+    toggleActiveStrip(): void;
     subscribe(listener: SchedulePageChangeListener): () => void;
     private setState;
     private emit;

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

@@ -10,6 +10,8 @@ export { SchedulePageStore } from './engine/schedulePageStore';
 export { filterMatchUpCatalog, groupMatchUpCatalog, isCompletedStatus } from './domain/matchUpCatalogProjections';
 export { buildScheduleIssueIndex } from './domain/scheduleIssues';
 export { matchUpLabel, participantLabel, matchUpSearchKey, deepClone } from './domain/utils';
+export { computeActiveStrip, computeActiveStripCell, computeActiveStripDropTarget } from './domain/activeStrip';
+export type { ActiveStripCell, ActiveStripCellState, ActiveStripCourtColumn, ActiveStripDropCandidate, ActiveStripDropTarget, ActiveStripGrid, ActiveStripGridMatchUp, ActiveStripStatusOptions } from './domain/activeStrip';
 export { buildScheduleDateStrip } from './ui/dateStrip';
 export { buildScheduleIssuesPanel } from './ui/issuesPanel';
 export { buildMatchUpCatalog } from './ui/matchUpCatalog';
@@ -17,6 +19,8 @@ export { buildMatchUpCard } from './ui/matchUpCard';
 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 { 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

@@ -95,6 +95,8 @@ export interface SchedulePageConfig {
     catalogSide?: 'left' | 'right';
     scheduledBehavior?: ScheduledBehavior;
     schedulingMode?: SchedulingMode;
+    /** Initial visibility of the active strip (one-row court summary above the grid). Defaults to true. */
+    activeStripVisible?: boolean;
     onDateSelected?: (date: string) => void;
     onMatchUpDrop?: (payload: SchedulePageDragPayload, event: DragEvent) => void;
     onMatchUpRemove?: (matchUpId: string) => void;
@@ -119,6 +121,7 @@ export interface SchedulePageState {
     hasUnsavedChanges: boolean;
     leftCollapsed: boolean;
     hideLeft: boolean;
+    activeStripVisible: boolean;
 }
 export type SchedulePageChangeListener = (state: SchedulePageState) => void;
 export interface ScheduleIssueCounts {

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

@@ -0,0 +1,46 @@
+import { SchedulePageDragPayload, SchedulePageState, UIPanel } from '../types';
+import { ActiveStripDropTarget, ActiveStripGrid, ActiveStripGridMatchUp, ActiveStripStatusOptions } from '../domain/activeStrip';
+export interface ActiveStripCourtMeta {
+    courtId: string;
+    label: 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[];
+    /**
+     * CSS grid-template-columns applied to the strip root. When provided, the
+     * strip lays out as `display: grid` with a leading spacer occupying the
+     * first column, so its court cells align with the grid below.
+     */
+    gridTemplateColumns?: string;
+    /**
+     * Explicit min-width applied to the strip root, e.g. to match the grid
+     * below so both scroll horizontally as one when wrapped in a shared
+     * scroll container.
+     */
+    minWidth?: string;
+}
+export interface ActiveStripPanelCallbacks {
+    /**
+     * Called when a matchUp is dropped onto a court's strip cell.
+     * The target carries the courtId and the inferred rowIndex.
+     * Consumer is responsible for committing the schedule mutation.
+     */
+    onMatchUpDrop?: (payload: SchedulePageDragPayload, target: ActiveStripDropTarget, event: DragEvent) => void;
+}
+export type ActiveStripCellRenderer = (matchUp: ActiveStripGridMatchUp) => HTMLElement | null;
+export interface ActiveStripPanelOptions {
+    statusOptions?: ActiveStripStatusOptions;
+    /** Min-height applied to each strip cell. Match the grid row height for visual parity. */
+    cellHeight?: string;
+    /** Optional renderer for cells with a matchUp. Receives the cell's matchUp (incl. opaque payload). */
+    renderCell?: ActiveStripCellRenderer;
+    /** Small label rendered inside the leading spacer (e.g. "Now"). Hidden when omitted. */
+    spacerLabel?: string;
+}
+export interface ActiveStripPanel extends UIPanel<SchedulePageState> {
+    setData: (data: ActiveStripPanelData) => void;
+}
+export declare function buildActiveStripPanel(callbacks?: ActiveStripPanelCallbacks, options?: ActiveStripPanelOptions): ActiveStripPanel;