courthive-components 1.5.0 → 1.7.0

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

@@ -0,0 +1,57 @@
+import { CourtSport } from '../courts/courtSvgUtil';
+export type TournamentStatusKind = 'cancelled' | 'completed' | 'live' | 'closing-soon' | 'registration-opens' | 'registration-open';
+export interface TournamentStatusPill {
+    kind: TournamentStatusKind;
+    label: string;
+}
+export interface TournamentEntryFee {
+    amount: number;
+    currencyCode?: string;
+    category?: string;
+    eventType?: string;
+}
+export interface TournamentCardData {
+    tournamentId: string;
+    tournamentName: string;
+    /** ISO date */
+    startDate?: string;
+    /** ISO date */
+    endDate?: string;
+    /** Pre-formatted date range (e.g. "May 22 – May 24, 2026"). Mapper provides; consumer may override. */
+    dateRangeFormatted?: string;
+    /** "City, REGION, Country" or similar — already formatted */
+    location?: string;
+    /** URL pointing to a hosted tournament image (preferred over court SVG). */
+    tournamentImageURL?: string;
+    /** Court sport identifier — used to render a court SVG when no URL image is present. */
+    courtSvgSport?: CourtSport;
+    /** Number of registered participants */
+    participantCount?: number;
+    /** Number of events (for table view; not in default card) */
+    eventCount?: number;
+    /** Organizer / club name (for table view; not in default card) */
+    organizerName?: string;
+    /** Pre-resolved status pill (mapper computes — consumer may override) */
+    status?: TournamentStatusPill | null;
+    /** Pre-formatted fee string (e.g. "USD $40 – $85") */
+    feeFormatted?: string | null;
+    /** ISO last-updated timestamp (for table view) */
+    updatedAt?: string;
+    /** When true, render an offline/local indicator */
+    offline?: boolean;
+}
+export type TournamentCardField = 'title' | 'location' | 'dateRange' | 'feeBadge' | 'playerCount' | 'eventCount' | 'organizerName' | 'updatedAt';
+export type TournamentCardCornerField = 'status' | 'offline';
+export interface TournamentCardConfig {
+    /** Whether to render the image zone. Defaults to true. */
+    showImage?: boolean;
+    /** Corner badges anchored over the image (top-left). */
+    cornerBadges: TournamentCardCornerField[];
+    /** Body fields (rendered in order, between image and footer). */
+    body: TournamentCardField[];
+    /** Footer fields (rendered as a row at the bottom). */
+    footer: TournamentCardField[];
+}
+export interface TournamentCardCallbacks {
+    onClick?: (data: TournamentCardData) => void;
+}

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

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

package/dist/components/venue-card/buildVenueCard.d.ts

@@ -0,0 +1,2 @@
+import { VenueCardCallbacks, VenueCardConfig, VenueCardData } from './types';
+export declare function buildVenueCard(data: VenueCardData, config?: Partial<VenueCardConfig>, callbacks?: VenueCardCallbacks): HTMLElement;

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

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

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

@@ -0,0 +1,6 @@
+export { buildVenueCard } from './buildVenueCard';
+export { buildVenueSkeletonCard } from './buildSkeletonCard';
+export { mapVenueToCardData } from './mapVenue';
+export { DEFAULT_VENUE_CARD_CONFIG, mergeVenueCardConfig } from './defaultConfig';
+export type { MapVenueOptions } from './mapVenue';
+export type { VenueCardCallbacks, VenueCardConfig, VenueCardCornerField, VenueCardData, VenueCardField } from './types';

package/dist/components/venue-card/mapVenue.d.ts

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

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

@@ -0,0 +1,19 @@
+export declare const vcCardStyle: () => string;
+export declare const vcCardClickableStyle: () => string;
+export declare const vcImageStyle: () => string;
+export declare const vcImageImgStyle: () => string;
+export declare const vcImageSvgStyle: () => string;
+export declare const vcImageMapStyle: () => string;
+export declare const vcImagePlaceholderStyle: () => string;
+export declare const vcCornerBadgesStyle: () => string;
+export declare const vcPrimaryBadgeStyle: () => string;
+export declare const vcBodyStyle: () => string;
+export declare const vcTitleStyle: () => string;
+export declare const vcAddressStyle: () => string;
+export declare const vcCourtBreakdownStyle: () => string;
+export declare const vcFooterStyle: () => string;
+export declare const vcAmenityRowStyle: () => string;
+export declare const vcAmenityStyle: () => string;
+export declare const vcSkeletonStyle: () => string;
+export declare const vcSkeletonLineStyle: () => string;
+export declare const vcSkeletonBlockStyle: () => string;

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

@@ -0,0 +1,44 @@
+import { CourtSport } from '../courts/courtSvgUtil';
+export interface VenueCardData {
+    venueId: string;
+    venueName: string;
+    venueAbbreviation?: string;
+    /** Pre-formatted "City, REGION, Country" */
+    addressFormatted?: string;
+    /** GPS coordinates — when present, the image zone renders a map by default. */
+    latitude?: number;
+    longitude?: number;
+    /** Number of courts attached to this venue. */
+    courtCount?: number;
+    /** Pre-formatted "6 outdoor hard, 2 indoor" string. */
+    courtBreakdown?: string;
+    /** Subset signals for the amenity row. */
+    indoorCount?: number;
+    outdoorCount?: number;
+    floodlitCount?: number;
+    /** True when this is the primary/default venue for its parent tournament. */
+    isPrimary?: boolean;
+    /** Hosted image URL (preferred over map / court-SVG fallback). */
+    venueImageURL?: string;
+    /** Sport identifier for the court-SVG fallback (caller supplies). */
+    courtSvgSport?: CourtSport;
+    /** Free-form notes (rendered as title tooltip on the venue name). */
+    notes?: string;
+}
+export type VenueCardField = 'title' | 'address' | 'courtBreakdown' | 'amenityRow' | 'venueAbbreviation';
+export type VenueCardCornerField = 'primaryBadge';
+export interface VenueCardConfig {
+    /** Whether to render the image zone. Defaults to true. */
+    showImage?: boolean;
+    /** Whether to use OSM map preview when venue has lat/lng. Defaults to true. */
+    showMap?: boolean;
+    /** Corner badges anchored over the image. */
+    cornerBadges: VenueCardCornerField[];
+    /** Body fields (rendered in order). */
+    body: VenueCardField[];
+    /** Footer fields. */
+    footer: VenueCardField[];
+}
+export interface VenueCardCallbacks {
+    onClick?: (data: VenueCardData) => void;
+}

package/dist/compositions/resolvePublishedComposition.d.ts

@@ -1,12 +1,23 @@
-import { Composition, Configuration } from '../types';
+import { Composition, CompositionColors, Configuration } from '../types';
 export interface DisplayExtensionValue {
     compositionName?: string;
     theme?: string;
     configuration?: Partial<Configuration>;
+    /** Per-composition color overrides snapshot. When present, wins over the
+     * named-composition's theme defaults. Set by TMX when applying a user
+     * composition so the colors travel with published draws even when the
+     * `compositionName` isn't a builtin known to this package. */
+    colors?: CompositionColors;
 }
 /**
  * Resolves a published composition from a DISPLAY extension value.
  * Returns a new composition object (never mutates the built-in singletons).
  * Falls back to 'National' if the named composition is not found.
+ *
+ * For user compositions (names not in the builtin map), the named lookup
+ * falls back to the default, but `display.theme`, `display.configuration`,
+ * and `display.colors` from the extension still apply — so TMX-side custom
+ * compositions render correctly in courthive-public as long as TMX persists
+ * the full snapshot.
  */
 export declare function resolvePublishedComposition(display?: DisplayExtensionValue, fallbackName?: string): Composition;