courthive-components 4.2.0 → 4.4.0

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

@@ -52,7 +52,7 @@ export interface ActiveStripCourtColumn {
 export interface ActiveStripGrid {
     columns: ActiveStripCourtColumn[];
 }
-export type ActiveStripCellState = 'free' | 'in-progress' | 'suspended' | 'next' | 'completed';
+export type ActiveStripCellState = 'free' | 'in-progress' | 'suspended' | 'next' | 'due' | 'completed';
 export interface ActiveStripCell {
     courtId: string;
     state: ActiveStripCellState;
@@ -73,6 +73,18 @@ export interface ActiveStripStatusOptions {
     inProgressStatuses?: ReadonlySet<string>;
     suspendedStatuses?: ReadonlySet<string>;
     completedStatuses?: ReadonlySet<string>;
+    /**
+     * MatchUps that should have started by now and have not been called.
+     *
+     * The consumer decides — the rule needs a venue-local clock and knowledge of
+     * the schedule annotations (a "followed by" matchUp was never promised its
+     * `scheduledTime`), neither of which this component has.
+     *
+     * Only consulted for a court with nothing live and nothing called, which is
+     * the case where the `free` state was lying: the court is not free-and-fine,
+     * it is idle with work waiting on it.
+     */
+    dueMatchUpIds?: ReadonlySet<string>;
 }
 export declare function computeActiveStripCell(column: ActiveStripCourtColumn, options?: ActiveStripStatusOptions): ActiveStripCell;
 export declare function computeActiveStrip(grid: ActiveStripGrid, options?: ActiveStripStatusOptions): ActiveStripCell[];

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

@@ -23,7 +23,7 @@ export type { ScheduleInspectorPanelOptions } 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, ActiveStripCourtBlock } from './ui/activeStrip';
+export type { ActiveStripPanel, ActiveStripPanelCallbacks, ActiveStripPanelData, ActiveStripPanelOptions, ActiveStripCourtMeta, ActiveStripCourtBlock, ActiveStripUpcomingBlock } 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/ui/activeStrip.d.ts

@@ -22,9 +22,48 @@ export interface ActiveStripCourtBlock {
     /** Optional short note (block.reason, registrant name from a future practice-registration system, etc.). */
     detail?: string;
 }
+/**
+ * A block that has not started yet on a court that is free right now.
+ *
+ * Distinct from `ActiveStripCourtBlock`, which is a block in force. This one is
+ * about the runway left before it: the question a director asks of an idle court
+ * is "can I still put something on it", and the answer is a duration, not a
+ * banner.
+ */
+export interface ActiveStripUpcomingBlock {
+    /** Block type, for the colour — same vocabulary as `ActiveStripCourtBlock.type`. */
+    type: string;
+    /** Pre-formatted by the consumer, e.g. "40m → MAINTENANCE". */
+    label: string;
+    /** Hover text — the consumer owns the wording. */
+    title?: string;
+}
 export interface ActiveStripPanelData {
     /** Court columns, in display order. The strip computes one cell per column. */
     grid: ActiveStripGrid;
+    /**
+     * MatchUps that should have started by now and have not been called — see
+     * `ActiveStripStatusOptions.dueMatchUpIds`. Supplied per refresh because it
+     * moves with the clock.
+     */
+    dueMatchUpIds?: readonly string[];
+    /**
+     * courtId → the block bearing down on a court that is currently FREE. The
+     * consumer decides when one is worth showing; the strip only paints it.
+     *
+     * Ignored for a court that has a block in force (`courtBlocks` wins — a banner
+     * about now beats a countdown to later) and for one with a matchUp on it,
+     * where `courtBlockEdges` carries the same fact in the form that suits an
+     * occupied court.
+     */
+    courtUpcomingBlocks?: Record<string, ActiveStripUpcomingBlock>;
+    /**
+     * courtId → a block that will come into force while the matchUp currently on
+     * that court is still expected to be playing. Painted as a top-edge stripe:
+     * a separate axis from the left-border state language, so a LIVE match on a
+     * court about to close shows both rather than one hiding the other.
+     */
+    courtBlockEdges?: Record<string, ActiveStripUpcomingBlock>;
     /** Optional display labels per courtId. Falls back to courtId. */
     courts?: ActiveStripCourtMeta[];
     /**