courthive-components 1.5.0 → 1.7.0

package/dist/components/competitivenessBar/aggregateCompetitiveness.d.ts

@@ -0,0 +1,3 @@
+import { CompetitivenessBuckets } from './types';
+export declare function aggregateCompetitiveness(items: any[]): CompetitivenessBuckets;
+export declare function totalBuckets(buckets: CompetitivenessBuckets): number;

package/dist/components/competitivenessBar/buildCompetitivenessBar.d.ts

@@ -0,0 +1,6 @@
+import { CompetitivenessBuckets } from './types';
+export interface BuildCompetitivenessBarResult {
+    element: HTMLElement;
+    update: (buckets: CompetitivenessBuckets) => void;
+}
+export declare function buildCompetitivenessBar(): BuildCompetitivenessBarResult;

package/dist/components/competitivenessBar/buildCompetitivenessDonut.d.ts

@@ -0,0 +1,6 @@
+import { CompetitivenessBuckets } from './types';
+export interface BuildCompetitivenessDonutResult {
+    element: HTMLElement;
+    update: (buckets: CompetitivenessBuckets) => void;
+}
+export declare function buildCompetitivenessDonut(): BuildCompetitivenessDonutResult;

package/dist/components/competitivenessBar/index.d.ts

@@ -0,0 +1,7 @@
+export { buildCompetitivenessBar } from './buildCompetitivenessBar';
+export { buildCompetitivenessDonut } from './buildCompetitivenessDonut';
+export { aggregateCompetitiveness, totalBuckets } from './aggregateCompetitiveness';
+export { COMPETITIVENESS_BUCKETS } from './types';
+export type { BuildCompetitivenessBarResult } from './buildCompetitivenessBar';
+export type { BuildCompetitivenessDonutResult } from './buildCompetitivenessDonut';
+export type { CompetitivenessBucket, CompetitivenessBuckets } from './types';

package/dist/components/competitivenessBar/types.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Competitiveness Bar — Type Definitions.
+ */
+export declare const COMPETITIVENESS_BUCKETS: readonly ["COMPETITIVE", "ROUTINE", "DECISIVE", "WALKOVER"];
+export type CompetitivenessBucket = (typeof COMPETITIVENESS_BUCKETS)[number];
+export type CompetitivenessBuckets = Record<CompetitivenessBucket, number>;

package/dist/components/composition-editor/compositionEditorStore.d.ts

@@ -1,4 +1,4 @@
-import { Configuration } from '../../types';
+import { CompositionColors, Configuration } from '../../types';
 import { CompositionEditorConfig, CompositionEditorState, CompositionEditorListener, SectionId } from './compositionEditorTypes';
 export declare class CompositionEditorStore {
     private state;
@@ -9,14 +9,16 @@ export declare class CompositionEditorStore {
     subscribe(listener: CompositionEditorListener): () => void;
     toggleSection(sectionId: SectionId): void;
     setTheme(theme: string): void;
+    setColorField<K extends keyof CompositionColors>(key: K, value: CompositionColors[K] | undefined): void;
+    clearColors(): void;
     setCompositionName(name: string): void;
     setConfigField<K extends keyof Configuration>(key: K, value: Configuration[K]): void;
     /** Update a nested object field (e.g., gameScore, placeHolders, scaleAttributes) */
     setConfigNestedField<K extends keyof Configuration>(key: K, nestedKey: string, value: unknown): void;
     /** Replace the entire configuration (e.g., loading a preset) */
     setConfiguration(configuration: Configuration): void;
-    /** Load a full composition (theme + config + name) */
-    loadComposition(name: string, theme: string, configuration: Configuration): void;
+    /** Load a full composition (theme + config + name + colors) */
+    loadComposition(name: string, theme: string, configuration: Configuration, colors?: CompositionColors): void;
     resetToInitial(): void;
     private setState;
     private emit;

package/dist/components/composition-editor/compositionEditorTypes.d.ts

@@ -1,9 +1,10 @@
-import { Composition, Configuration } from '../../types';
+import { Composition, CompositionColors, Configuration } from '../../types';
 /** JSON-serializable snapshot of a composition (no functions/DOM refs) */
 export interface SavedComposition {
     compositionName: string;
     theme: string;
     configuration: Configuration;
+    colors?: CompositionColors;
     version?: number;
 }
 export interface CompositionEditorConfig {
@@ -20,11 +21,12 @@ export interface CompositionEditorConfig {
     /** Restrict available theme choices */
     availableThemes?: string[];
 }
-export type SectionId = 'theme' | 'display' | 'score' | 'participant' | 'placeholder' | 'scale' | 'layout';
+export type SectionId = 'theme' | 'colors' | 'display' | 'score' | 'participant' | 'placeholder' | 'scale' | 'layout';
 export interface CompositionEditorState {
     compositionName: string;
     theme: string;
     configuration: Configuration;
+    colors?: CompositionColors;
     expandedSections: Set<SectionId>;
     isDirty: boolean;
     readOnly: boolean;

package/dist/components/composition-editor/sections/colorsSection.d.ts

@@ -0,0 +1,3 @@
+import { CompositionEditorStore } from '../compositionEditorStore';
+import { EditorPanel } from '../compositionEditorTypes';
+export declare function buildColorsSection(store: CompositionEditorStore): EditorPanel;

package/dist/components/court-card/buildCourtCard.d.ts

@@ -0,0 +1,2 @@
+import { CourtCardCallbacks, CourtCardConfig, CourtCardData } from './types';
+export declare function buildCourtCard(data: CourtCardData, config?: Partial<CourtCardConfig>, callbacks?: CourtCardCallbacks): HTMLElement;

package/dist/components/court-card/buildSkeletonCard.d.ts

@@ -0,0 +1,2 @@
+import { CourtCardConfig } from './types';
+export declare function buildCourtSkeletonCard(config?: Partial<CourtCardConfig>): HTMLElement;

package/dist/components/court-card/defaultConfig.d.ts

@@ -0,0 +1,3 @@
+import { CourtCardConfig } from './types';
+export declare const DEFAULT_COURT_CARD_CONFIG: CourtCardConfig;
+export declare function mergeCourtCardConfig(override?: Partial<CourtCardConfig>): CourtCardConfig;

package/dist/components/court-card/index.d.ts

@@ -0,0 +1,6 @@
+export { buildCourtCard } from './buildCourtCard';
+export { buildCourtSkeletonCard } from './buildSkeletonCard';
+export { mapCourtToCardData } from './mapCourt';
+export { DEFAULT_COURT_CARD_CONFIG, mergeCourtCardConfig } from './defaultConfig';
+export type { MapCourtOptions } from './mapCourt';
+export type { CourtCardCallbacks, CourtCardConfig, CourtCardCornerField, CourtCardData, CourtCardField } from './types';

package/dist/components/court-card/mapCourt.d.ts

@@ -0,0 +1,7 @@
+import { CourtSport } from '../courts/courtSvgUtil';
+import { CourtCardData } from './types';
+export interface MapCourtOptions {
+    /** Parent tournament's resolved sport — used for the court-SVG fallback. */
+    sport?: CourtSport;
+}
+export declare function mapCourtToCardData(court: any, options?: MapCourtOptions): CourtCardData;

package/dist/components/court-card/styles.d.ts

@@ -0,0 +1,18 @@
+export declare const ccCardStyle: () => string;
+export declare const ccCardClickableStyle: () => string;
+export declare const ccImageStyle: () => string;
+export declare const ccImageSvgStyle: () => string;
+export declare const ccImagePlaceholderStyle: () => string;
+export declare const ccCornerBadgesStyle: () => string;
+export declare const ccIndoorBadgeStyle: () => string;
+export declare const ccFloodlitBadgeStyle: () => string;
+export declare const ccBodyStyle: () => string;
+export declare const ccTitleStyle: () => string;
+export declare const ccSurfaceStyle: () => string;
+export declare const ccAvailabilityStyle: () => string;
+export declare const ccAbbrStyle: () => string;
+export declare const ccFooterStyle: () => string;
+export declare const ccAmenityRowStyle: () => string;
+export declare const ccSkeletonStyle: () => string;
+export declare const ccSkeletonLineStyle: () => string;
+export declare const ccSkeletonBlockStyle: () => string;

package/dist/components/court-card/types.d.ts

@@ -0,0 +1,31 @@
+import { CourtSport } from '../courts/courtSvgUtil';
+export interface CourtCardData {
+    courtId: string;
+    courtName: string;
+    courtAbbreviation?: string;
+    /** Pre-formatted "Outdoor • Hard" string. */
+    surfaceLabel?: string;
+    /** Indoor / outdoor / undefined (unknown). */
+    indoorOutdoor?: 'INDOOR' | 'OUTDOOR';
+    /** Surface category (HARD/CLAY/GRASS/CARPET/...) — raw upper-case. */
+    surfaceCategory?: string;
+    /** True when the court has floodlights — drives the lit-pip badge. */
+    floodlit?: boolean;
+    /** Available hours/minutes today (optional summary). */
+    availabilitySummary?: string;
+    /** Sport identifier for the court-SVG image fallback. */
+    courtSvgSport?: CourtSport;
+    /** Free-form notes (rendered as title tooltip on the court name). */
+    notes?: string;
+}
+export type CourtCardField = 'title' | 'surface' | 'amenityRow' | 'availability' | 'abbreviation';
+export type CourtCardCornerField = 'indoorOutdoor' | 'floodlit';
+export interface CourtCardConfig {
+    showImage?: boolean;
+    cornerBadges: CourtCardCornerField[];
+    body: CourtCardField[];
+    footer: CourtCardField[];
+}
+export interface CourtCardCallbacks {
+    onClick?: (data: CourtCardData) => void;
+}

package/dist/components/draw-card/buildDrawCard.d.ts

@@ -0,0 +1,2 @@
+import { DrawCardCallbacks, DrawCardConfig, DrawCardData } from './types';
+export declare function buildDrawCard(data: DrawCardData, config?: Partial<DrawCardConfig>, callbacks?: DrawCardCallbacks): HTMLElement;

package/dist/components/draw-card/buildSkeletonCard.d.ts

@@ -0,0 +1,2 @@
+/** Placeholder card for loading states. Render 3–6 of these in the grid wrap. */
+export declare function buildDrawSkeletonCard(): HTMLElement;

package/dist/components/draw-card/defaultConfig.d.ts

@@ -0,0 +1,3 @@
+import { DrawCardConfig } from './types';
+export declare const DEFAULT_DRAW_CARD_CONFIG: DrawCardConfig;
+export declare function mergeDrawCardConfig(override?: Partial<DrawCardConfig>): DrawCardConfig;

package/dist/components/draw-card/index.d.ts

@@ -0,0 +1,6 @@
+export { buildDrawCard } from './buildDrawCard';
+export { buildDrawSkeletonCard } from './buildSkeletonCard';
+export { mapDrawDefinitionToCardData } from './mapDraw';
+export { DEFAULT_DRAW_CARD_CONFIG, mergeDrawCardConfig } from './defaultConfig';
+export type { MapDrawOptions } from './mapDraw';
+export type { DrawCardCallbacks, DrawCardConfig, DrawCardCornerField, DrawCardData, DrawCardField, DrawMatchUpCounts, DrawStatusKind, DrawStatusPill } from './types';

package/dist/components/draw-card/mapDraw.d.ts

@@ -0,0 +1,18 @@
+import { DrawCardData, DrawMatchUpCounts, DrawStatusPill } from './types';
+export interface MapDrawOptions {
+    lightMode?: boolean;
+    matchUpStats?: DrawMatchUpCounts;
+    /** Pre-computed averages (consumer might fetch via factory.getRatingsStats). */
+    utrAvg?: number;
+    wtnAvg?: number;
+    /** Pre-resolved publish flags from publishingGovernor. */
+    published?: boolean;
+    embargoActive?: boolean;
+    /** Pre-resolved entry count (consumer often has this via getAssignedParticipantIds). */
+    entryCount?: number;
+    /** Back-reference for click handlers. */
+    eventId?: string;
+    /** Override the resolved status. */
+    statusOverride?: DrawStatusPill | null;
+}
+export declare function mapDrawDefinitionToCardData(drawDefinition: any, options?: MapDrawOptions): DrawCardData;

package/dist/components/draw-card/styles.d.ts

@@ -0,0 +1,18 @@
+export declare const dcCardStyle: () => string;
+export declare const dcCardClickableStyle: () => string;
+export declare const dcCornerBadgesStyle: () => string;
+export declare const dcStatusPillStyle: () => string;
+export declare const dcSecondaryBadgeStyle: () => string;
+export declare const dcBodyStyle: () => string;
+export declare const dcVizZoneStyle: () => string;
+export declare const dcTitleRowStyle: () => string;
+export declare const dcTitleStyle: () => string;
+export declare const dcDrawTypeLabelStyle: () => string;
+export declare const dcMetaLineStyle: () => string;
+export declare const dcFooterStyle: () => string;
+export declare const dcChipStyle: () => string;
+export declare const dcProgressStyle: () => string;
+export declare const dcProgressBarStyle: () => string;
+export declare const dcProgressFillStyle: () => string;
+export declare const dcSkeletonStyle: () => string;
+export declare const dcSkeletonLineStyle: () => string;

package/dist/components/draw-card/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Draw Card — Type Definitions
+ *
+ * Flat data + JSON-serializable config consumed by buildDrawCard.
+ */
+export type DrawStatusKind = 'ungenerated' | 'ready' | 'in-progress' | 'completed' | 'cancelled';
+export interface DrawStatusPill {
+    kind: DrawStatusKind;
+    label: string;
+}
+export interface DrawMatchUpCounts {
+    total: number;
+    completed: number;
+    inProgress: number;
+    scheduled: number;
+}
+export interface DrawCardData {
+    drawId: string;
+    drawName: string;
+    /** TODS drawType code, e.g. 'SINGLE_ELIMINATION' / 'ROUND_ROBIN'. */
+    drawType?: string;
+    /** Human label derived from drawType (e.g. "Single Elimination"). */
+    drawTypeLabel?: string;
+    drawSize?: number;
+    entryCount?: number;
+    /** matchUpFormat code surfaced as a chip in the footer. */
+    matchUpFormat?: string;
+    flightNumber?: number;
+    /** undefined when the underlying flight hasn't been generated yet. */
+    matchUpCounts?: DrawMatchUpCounts;
+    /** True once `structures` have been created on the drawDefinition. */
+    generated: boolean;
+    published?: boolean;
+    embargoActive?: boolean;
+    /** Average ratings across the draw, when scaleValues are available. */
+    utrAvg?: number;
+    wtnAvg?: number;
+    status?: DrawStatusPill | null;
+    /** Back-reference for callers that need it on click; not rendered. */
+    eventId?: string;
+    /** Optional visualization element rendered above the body (e.g. histogram,
+     * competitiveness bar, sunburst). The card is intentionally agnostic about
+     * which viz lives here — the consumer instantiates it. Pair with
+     * `DrawCardConfig.showVisualization = true`. */
+    visualization?: HTMLElement | null;
+}
+export type DrawCardField = 'title' | 'drawTypeLabel' | 'drawSize' | 'matchUpFormat' | 'entries' | 'matchUpProgress' | 'ratings' | 'flightNumber';
+export type DrawCardCornerField = 'status' | 'publishedBadge' | 'embargoBadge';
+export interface DrawCardConfig {
+    cornerBadges: DrawCardCornerField[];
+    body: DrawCardField[];
+    footer: DrawCardField[];
+    /** When true and `DrawCardData.visualization` is set, the visualization
+     * element renders in a dedicated zone above the body. Default `false`. */
+    showVisualization?: boolean;
+}
+export interface DrawCardCallbacks {
+    onClick?: (data: DrawCardData) => void;
+}

package/dist/components/event-card/buildEventCard.d.ts

@@ -0,0 +1,2 @@
+import { EventCardCallbacks, EventCardConfig, EventCardData } from './types';
+export declare function buildEventCard(data: EventCardData, config?: Partial<EventCardConfig>, callbacks?: EventCardCallbacks): HTMLElement;

package/dist/components/event-card/buildSkeletonCard.d.ts

@@ -0,0 +1,2 @@
+import { EventCardConfig } from './types';
+export declare function buildEventSkeletonCard(config?: Partial<EventCardConfig>): HTMLElement;

package/dist/components/event-card/defaultConfig.d.ts

@@ -0,0 +1,6 @@
+import { EventCardConfig } from './types';
+export declare const DEFAULT_EVENT_CARD_CONFIG: EventCardConfig;
+/** Threshold matching TMX's existing `EVENT_COUNT_THRESHOLD` in createEventsTable.ts.
+ * Consumers reading many events should set `lightMode: true` when over this count. */
+export declare const EVENT_CARD_LIGHT_MODE_THRESHOLD = 15;
+export declare function mergeEventCardConfig(override?: Partial<EventCardConfig>): EventCardConfig;

package/dist/components/event-card/index.d.ts

@@ -0,0 +1,8 @@
+export { buildEventCard } from './buildEventCard';
+export { buildEventSkeletonCard } from './buildSkeletonCard';
+export { mapEventToCardData } from './mapEvent';
+export { resolveEventStatus } from './statusResolver';
+export { DEFAULT_EVENT_CARD_CONFIG, EVENT_CARD_LIGHT_MODE_THRESHOLD, mergeEventCardConfig } from './defaultConfig';
+export type { MapEventOptions } from './mapEvent';
+export type { EventStatusResolverInput } from './statusResolver';
+export type { EventCardCallbacks, EventCardConfig, EventCardCornerField, EventCardData, EventCardField, EventGenderKind, EventMatchUpCounts, EventStatusKind, EventStatusPill, EventTypeKind } from './types';

package/dist/components/event-card/mapEvent.d.ts

@@ -0,0 +1,14 @@
+import { EventCardData, EventMatchUpCounts, EventStatusPill } from './types';
+import { CourtSport } from '../courts/courtSvgUtil';
+export interface MapEventOptions {
+    /** Skip matchUp walk for large event counts (TMX uses threshold 15). */
+    lightMode?: boolean;
+    /** Override match counts (caller fetched via factory engine). */
+    matchUpStats?: EventMatchUpCounts;
+    /** Parent tournament's resolved sport — used for court-SVG fallback. */
+    sport?: CourtSport;
+    now?: Date;
+    /** Override the resolved status. */
+    statusOverride?: EventStatusPill | null;
+}
+export declare function mapEventToCardData(event: any, options?: MapEventOptions): EventCardData;

package/dist/components/event-card/statusResolver.d.ts

@@ -0,0 +1,14 @@
+import { EventMatchUpCounts, EventStatusPill } from './types';
+export interface EventStatusResolverInput {
+    allDrawsCancelled?: boolean;
+    drawCount?: number;
+    entryCount?: number;
+    startDate?: string;
+    endDate?: string;
+    matchUpCounts?: EventMatchUpCounts;
+    /** True when at least one drawDefinition carries the DRAFT_STATE extension. */
+    hasDraftState?: boolean;
+    /** True when at least one drawDefinition was generated with `automated.seedsOnly`. */
+    hasSeedsOnlyDraw?: boolean;
+}
+export declare function resolveEventStatus(input: EventStatusResolverInput, now?: Date): EventStatusPill | null;

package/dist/components/event-card/styles.d.ts

@@ -0,0 +1,22 @@
+export declare const ecCardStyle: () => string;
+export declare const ecCardClickableStyle: () => string;
+export declare const ecImageStyle: () => string;
+export declare const ecImageImgStyle: () => string;
+export declare const ecImageSvgStyle: () => string;
+export declare const ecImagePlaceholderStyle: () => string;
+export declare const ecCornerBadgesStyle: () => string;
+export declare const ecStatusPillStyle: () => string;
+export declare const ecEventTypeBadgeStyle: () => string;
+export declare const ecGenderBadgeStyle: () => string;
+export declare const ecBodyStyle: () => string;
+export declare const ecTitleStyle: () => string;
+export declare const ecCategoryStyle: () => string;
+export declare const ecDrawSummaryStyle: () => string;
+export declare const ecDateRangeStyle: () => string;
+export declare const ecFooterStyle: () => string;
+export declare const ecPlayerCountStyle: () => string;
+export declare const ecMatchUpProgressStyle: () => string;
+export declare const ecUpdatedAtStyle: () => string;
+export declare const ecSkeletonStyle: () => string;
+export declare const ecSkeletonLineStyle: () => string;
+export declare const ecSkeletonBlockStyle: () => string;

package/dist/components/event-card/types.d.ts

@@ -0,0 +1,49 @@
+import { CourtSport } from '../courts/courtSvgUtil';
+export type EventStatusKind = 'cancelled' | 'completed' | 'live' | 'drawing' | 'entries-open' | 'upcoming';
+export interface EventStatusPill {
+    kind: EventStatusKind;
+    label: string;
+}
+export interface EventMatchUpCounts {
+    total: number;
+    completed: number;
+    scheduled: number;
+    inProgress: number;
+}
+export type EventTypeKind = 'SINGLES' | 'DOUBLES' | 'TEAM' | 'HYBRID';
+export type EventGenderKind = 'MALE' | 'FEMALE' | 'MIXED';
+export interface EventCardData {
+    eventId: string;
+    eventName: string;
+    eventAbbreviation?: string;
+    /** Human label derived from event.category (name / age range / code). */
+    categoryLabel?: string;
+    /** Normalized event type for badge styling. */
+    eventType?: EventTypeKind;
+    /** Normalized gender for badge styling. */
+    gender?: EventGenderKind;
+    drawCount?: number;
+    /** Short summary like "32 SE" or "16 RR + Playoff". */
+    drawSummary?: string;
+    entryCount?: number;
+    /** undefined in lightMode (caller skipped the matchUp walk). */
+    matchUpCounts?: EventMatchUpCounts;
+    startDate?: string;
+    endDate?: string;
+    dateRangeFormatted?: string;
+    status?: EventStatusPill | null;
+    eventImageURL?: string;
+    courtSvgSport?: CourtSport;
+    updatedAt?: string;
+}
+export type EventCardField = 'title' | 'categoryLabel' | 'drawSummary' | 'dateRange' | 'playerCount' | 'matchUpProgress' | 'updatedAt';
+export type EventCardCornerField = 'status' | 'eventTypeBadge' | 'genderBadge';
+export interface EventCardConfig {
+    showImage?: boolean;
+    cornerBadges: EventCardCornerField[];
+    body: EventCardField[];
+    footer: EventCardField[];
+}
+export interface EventCardCallbacks {
+    onClick?: (data: EventCardData) => void;
+}

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

@@ -24,5 +24,5 @@ export type { ActiveStripPanel, ActiveStripPanelCallbacks, ActiveStripPanelData,
 export { buildScheduleGridCell, mapMatchUpToCellData, DEFAULT_SCHEDULE_CELL_CONFIG } from './ui/scheduleGridCell';
 export { activateScheduleCellTypeAhead } from './ui/scheduleCellTypeAhead';
 export type { ScheduleCellTypeAheadOptions } from './ui/scheduleCellTypeAhead';
-export type { CatalogMatchUpItem, CatalogFilters, MatchUpSide, ScheduleDate, ScheduleIssue, ScheduleIssueSeverity, ScheduleIssueIndex, ScheduleIssueCounts, MatchUpCatalogGroupBy, ScheduledBehavior, SchedulingMode, PendingScheduleAction, CatalogMatchUpDragPayload, GridMatchUpDragPayload, SchedulePageDragPayload, SchedulePageConfig, SchedulePageState, SchedulePageChangeListener, UIPanel, ScheduleCellConfig, ScheduleCellField, ParticipantDisplayConfig, ScheduleCellData, ScheduleCellSide } from './types';
+export type { CatalogMatchUpItem, CatalogFilters, MatchUpSide, ScheduleDate, ScheduleIssue, ScheduleIssueSeverity, ScheduleIssueIndex, ScheduleIssueCounts, MatchUpCatalogGroupBy, ScheduledBehavior, SchedulingMode, PendingScheduleAction, CatalogMatchUpDragPayload, GridMatchUpDragPayload, SchedulePageDragPayload, SchedulePageConfig, SchedulePageCatalogState, SchedulePageState, SchedulePageChangeListener, UIPanel, ScheduleCellConfig, ScheduleCellField, ParticipantDisplayConfig, ScheduleCellData, ScheduleCellSide } from './types';
 export declare function createSchedulePage(config: SchedulePageConfig, container: HTMLElement): SchedulePageControl;

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

@@ -82,11 +82,26 @@ export interface GridMatchUpDragPayload {
     sourceCourt?: string;
 }
 export type SchedulePageDragPayload = CatalogMatchUpDragPayload | GridMatchUpDragPayload;
+/**
+ * Persisted catalog filter state. The consumer can seed the store from a
+ * previously captured snapshot (e.g. when re-entering the schedule page
+ * within the same session) and subscribe to the store to write it back.
+ */
+export interface SchedulePageCatalogState {
+    catalogSearchQuery?: string;
+    catalogGroupBy?: MatchUpCatalogGroupBy;
+    catalogFilters?: CatalogFilters;
+    showCompleted?: boolean;
+    showScheduled?: boolean;
+}
 export interface SchedulePageConfig {
     matchUpCatalog: CatalogMatchUpItem[];
     scheduleDates: ScheduleDate[];
     issues?: ScheduleIssue[];
     courtGridElement?: HTMLElement;
+    /** Seed the store's catalog filter fields. Any field omitted falls back
+     *  to the built-in default. */
+    initialCatalogState?: SchedulePageCatalogState;
     /** Max height for the court grid viewport (e.g. '500px', '60vh'). Defaults to none (fills available space). */
     gridMaxHeight?: string;
     /** When true, the left column (date strip + issues panel) is not rendered at all. */
@@ -100,6 +115,15 @@ export interface SchedulePageConfig {
     /** Consumer-owned buttons rendered right-aligned in the court grid header.
      *  Consumer keeps live refs and mutates state (visibility, disabled, label) directly. */
     headerActions?: HTMLElement | HTMLElement[];
+    /** Consumer-owned buttons rendered immediately before the "Court Grid" title.
+     *  Use this slot for controls that act on content to the LEFT of the panel
+     *  (e.g. a catalog show/hide toggle when the catalog sits on the left). */
+    titleLeadingActions?: HTMLElement | HTMLElement[];
+    /** Optional element rendered in place of the default "Court Grid" title.
+     *  When set, replaces both the default text and the `.spl-center-title`
+     *  wrapper — consumer owns layout (e.g. inject a search input here so
+     *  the header reads as a single clean field). */
+    titleSlot?: HTMLElement;
     onDateSelected?: (date: string) => void;
     onMatchUpDrop?: (payload: SchedulePageDragPayload, event: DragEvent) => void;
     onMatchUpRemove?: (matchUpId: string) => void;

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

@@ -7,5 +7,14 @@ export interface CourtGridSlotOptions {
     /** Consumer-owned buttons rendered right-aligned in the header.
      *  Consumer keeps live refs and mutates state (visibility, disabled, label) directly. */
     headerActions?: HTMLElement | HTMLElement[];
+    /** Consumer-owned buttons rendered immediately before the "Court Grid" title.
+     *  Use this slot for controls that act on content to the LEFT of the panel
+     *  (e.g. a catalog show/hide toggle when the catalog sits on the left). */
+    titleLeadingActions?: HTMLElement | HTMLElement[];
+    /** Optional element rendered in place of the default "Court Grid" title.
+     *  When set, replaces both the default text and the `.spl-center-title`
+     *  wrapper — consumer is responsible for its own styling and any layout
+     *  growth it needs. */
+    titleSlot?: HTMLElement;
 }
 export declare function buildCourtGridSlot(courtGridElement: HTMLElement | undefined, callbacks: CourtGridSlotCallbacks, options?: CourtGridSlotOptions): UIPanel<SchedulePageState>;

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

@@ -5,6 +5,7 @@ export declare const splCenterStyle: () => string;
 export declare const splCenterHeaderStyle: () => string;
 export declare const splCenterTitleStyle: () => string;
 export declare const splCenterActionsStyle: () => string;
+export declare const splCenterLeadingStyle: () => string;
 export declare const splGridSlotStyle: () => string;
 export declare const splRightStyle: () => string;
 export declare const splMatchUpCardStyle: () => string;

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

@@ -186,6 +186,10 @@ export interface SchedulingProfileConfig {
     /** Consumer-owned buttons rendered right-aligned in the Day Plan header.
      *  Consumer keeps live refs and mutates state (visibility, disabled, label) directly. */
     headerActions?: HTMLElement | HTMLElement[];
+    /** Consumer-owned buttons rendered immediately before the "Day Plan" title.
+     *  Use this slot for controls that act on content to the LEFT of the panel
+     *  (e.g. a catalog show/hide toggle when the catalog sits on the left). */
+    titleLeadingActions?: HTMLElement | HTMLElement[];
     onProfileChanged?: (profile: SchedulingProfile) => void;
     onFixAction?: (action: FixAction) => void;
 }

package/dist/components/scheduling-profile/ui/styles.d.ts

@@ -5,6 +5,7 @@ export declare const spPanelHeaderStyle: () => string;
 export declare const spPanelTitleStyle: () => string;
 export declare const spPanelMetaStyle: () => string;
 export declare const spPanelActionsStyle: () => string;
+export declare const spPanelLeadingStyle: () => string;
 export declare const spPanelBodyStyle: () => string;
 export declare const spDateStripStyle: () => string;
 export declare const spDateChipStyle: () => string;

package/dist/components/scheduling-profile/ui/venueBoard.d.ts

@@ -8,5 +8,9 @@ export interface VenueBoardOptions {
     /** Consumer-owned buttons rendered right-aligned in the Day Plan header.
      *  Consumer keeps live refs and mutates state (visibility, disabled, label) directly. */
     headerActions?: HTMLElement | HTMLElement[];
+    /** Consumer-owned buttons rendered immediately before the "Day Plan" title.
+     *  Use this slot for controls that act on content to the LEFT of the panel
+     *  (e.g. a catalog show/hide toggle when the catalog sits on the left). */
+    titleLeadingActions?: HTMLElement | HTMLElement[];
 }
 export declare function buildVenueBoard(callbacks: VenueBoardCallbacks, options?: VenueBoardOptions): UIPanel<ProfileStoreState>;

package/dist/components/tournament-card/buildSkeletonCard.d.ts

@@ -0,0 +1,2 @@
+import { TournamentCardConfig } from './types';
+export declare function buildSkeletonCard(config?: Partial<TournamentCardConfig>): HTMLElement;

package/dist/components/tournament-card/buildTournamentCard.d.ts

@@ -0,0 +1,2 @@
+import { TournamentCardCallbacks, TournamentCardConfig, TournamentCardData } from './types';
+export declare function buildTournamentCard(data: TournamentCardData, config?: Partial<TournamentCardConfig>, callbacks?: TournamentCardCallbacks): HTMLElement;

package/dist/components/tournament-card/defaultConfig.d.ts

@@ -0,0 +1,7 @@
+import { TournamentCardConfig } from './types';
+export declare const DEFAULT_TOURNAMENT_CARD_CONFIG: TournamentCardConfig;
+/**
+ * Merge a partial provider config over the default.
+ * Arrays are replaced wholesale when present (no element-level merge).
+ */
+export declare function mergeTournamentCardConfig(override?: Partial<TournamentCardConfig>): TournamentCardConfig;

package/dist/components/tournament-card/feeFormatter.d.ts

@@ -0,0 +1,2 @@
+import { TournamentEntryFee } from './types';
+export declare function formatFeeRange(fees?: TournamentEntryFee[] | null): string | null;

package/dist/components/tournament-card/index.d.ts

@@ -0,0 +1,9 @@
+export { buildTournamentCard } from './buildTournamentCard';
+export { buildSkeletonCard } from './buildSkeletonCard';
+export { mapTournamentToCardData } from './mapTournament';
+export { resolveTournamentStatus } from './statusResolver';
+export { formatFeeRange } from './feeFormatter';
+export { DEFAULT_TOURNAMENT_CARD_CONFIG, mergeTournamentCardConfig } from './defaultConfig';
+export type { MapTournamentOptions } from './mapTournament';
+export type { StatusResolverInput } from './statusResolver';
+export type { TournamentCardCallbacks, TournamentCardConfig, TournamentCardCornerField, TournamentCardData, TournamentCardField, TournamentEntryFee, TournamentStatusKind, TournamentStatusPill } from './types';

package/dist/components/tournament-card/mapTournament.d.ts

@@ -0,0 +1,7 @@
+import { TournamentCardData, TournamentStatusPill } from './types';
+export interface MapTournamentOptions {
+    now?: Date;
+    /** Override the resolved status (e.g. surface a `Local Only` pill instead). */
+    statusOverride?: TournamentStatusPill | null;
+}
+export declare function mapTournamentToCardData(tournament: any, options?: MapTournamentOptions): TournamentCardData;

package/dist/components/tournament-card/statusResolver.d.ts

@@ -0,0 +1,9 @@
+import { TournamentStatusPill } from './types';
+export interface StatusResolverInput {
+    tournamentStatus?: string;
+    startDate?: string;
+    endDate?: string;
+    entriesOpen?: string;
+    entriesClose?: string;
+}
+export declare function resolveTournamentStatus(input: StatusResolverInput, now?: Date): TournamentStatusPill | null;

package/dist/components/tournament-card/styles.d.ts

@@ -0,0 +1,23 @@
+export declare const tcCardStyle: () => string;
+export declare const tcCardClickableStyle: () => string;
+export declare const tcCardOfflineStyle: () => string;
+export declare const tcImageStyle: () => string;
+export declare const tcImageImgStyle: () => string;
+export declare const tcImageSvgStyle: () => string;
+export declare const tcImagePlaceholderStyle: () => string;
+export declare const tcCornerBadgesStyle: () => string;
+export declare const tcStatusPillStyle: () => string;
+export declare const tcOfflineBadgeStyle: () => string;
+export declare const tcBodyStyle: () => string;
+export declare const tcTitleStyle: () => string;
+export declare const tcLocationStyle: () => string;
+export declare const tcDateRangeStyle: () => string;
+export declare const tcOrganizerStyle: () => string;
+export declare const tcUpdatedAtStyle: () => string;
+export declare const tcFooterStyle: () => string;
+export declare const tcFeeBadgeStyle: () => string;
+export declare const tcPlayerCountStyle: () => string;
+export declare const tcEventCountStyle: () => string;
+export declare const tcSkeletonStyle: () => string;
+export declare const tcSkeletonLineStyle: () => string;
+export declare const tcSkeletonBlockStyle: () => string;