courthive-components 4.3.0 → 4.4.0

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,6 +22,22 @@ 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;
@@ -31,6 +47,23 @@ export interface ActiveStripPanelData {
      * 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[];
     /**