courthive-components 1.5.0 → 1.7.0

package/dist/helpers/cards/buildCardSkeleton.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Generic skeleton card builder shared by tournament-card, event-card, venue-card.
+ *
+ * Each card's own skeleton wrapper calls this with its zone counts + the CSS
+ * class names it owns, so the visual placeholder always matches the card's
+ * outer shape (no grid reflow when real data lands).
+ */
+export interface CardSkeletonConfig {
+    /** Whether to render the image zone */
+    showImage: boolean;
+    /** Number of body skeleton lines (0 = body zone omitted) */
+    bodyLines: number;
+    /** Whether to render a footer skeleton line (false = footer zone omitted) */
+    showFooter: boolean;
+    /** CSS class for the card outer element. */
+    cardClass: string;
+    /** CSS class for the image zone. */
+    imageClass: string;
+    /** CSS class for the body zone. */
+    bodyClass: string;
+    /** CSS class for the footer zone. */
+    footerClass: string;
+    /** CSS class for shimmer fill (block). */
+    blockClass: string;
+    /** CSS class for a single shimmer line. */
+    lineClass: string;
+}
+export declare function buildCardSkeleton(cfg: CardSkeletonConfig): HTMLElement;

package/dist/helpers/cards/formatAddress.d.ts

@@ -0,0 +1,3 @@
+import { CardAddress, CardVenueLike } from './types';
+export declare function formatAddress(address?: CardAddress | null): string | undefined;
+export declare function formatVenueLocation(venues?: CardVenueLike[] | null): string | undefined;

package/dist/helpers/cards/formatDateRange.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Pure ISO-date range formatter shared by card primitives.
+ *
+ *   "May 22, 2026"                  (single date)
+ *   "May 22 – May 24, 2026"         (same-year range)
+ *   "Dec 30, 2025 – Jan 2, 2026"    (cross-year range)
+ *
+ * Returns undefined when neither bound is present or both parse as NaN.
+ */
+export declare function formatDateRange(startISO?: string, endISO?: string): string | undefined;

package/dist/helpers/cards/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared utilities for card primitives (tournament-card, event-card, venue-card).
+ *
+ * Exported through `courthive-components` so consumers can build their own
+ * card variants without re-implementing extraction + formatting.
+ */
+export { formatAddress, formatVenueLocation } from './formatAddress';
+export { formatDateRange } from './formatDateRange';
+export { extractImageURL, extractCourtSvgSport } from './resourceExtraction';
+export { buildCardSkeleton } from './buildCardSkeleton';
+export type { CardSkeletonConfig } from './buildCardSkeleton';
+export type { CardAddress, CardOnlineResource, CardVenueLike } from './types';

package/dist/helpers/cards/resourceExtraction.d.ts

@@ -0,0 +1,4 @@
+import { CourtSport } from '../../components/courts/courtSvgUtil';
+import { CardOnlineResource } from './types';
+export declare function extractImageURL(resources: CardOnlineResource[] | undefined, name: string): string | undefined;
+export declare function extractCourtSvgSport(resources: CardOnlineResource[] | undefined, name?: string): CourtSport | undefined;

package/dist/helpers/cards/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shared types used by card primitives (tournament-card, event-card, venue-card).
+ */
+export interface CardOnlineResource {
+    name?: string;
+    resourceType?: string;
+    resourceSubType?: string;
+    url?: string;
+    identifier?: string;
+}
+export interface CardAddress {
+    city?: string;
+    state?: string;
+    region?: string;
+    countryCode?: string;
+    country?: string;
+    latitude?: number;
+    longitude?: number;
+}
+export interface CardVenueLike {
+    venueName?: string;
+    venueAbbreviation?: string;
+    addresses?: CardAddress[];
+}

package/dist/helpers/searchClearButton.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Wraps an `<input>` in a relative-positioned container with an absolutely
+ * positioned (×) clear button that shows whenever the input has a value
+ * and clears it on click.
+ *
+ * Visual is matched to the controlBar's built-in clear icon so search
+ * fields look consistent across the platform.
+ *
+ * Returns the wrapping element. Callers append the wrapper (not the raw
+ * input) into the toolbar. When the input value is set programmatically
+ * (state sync, etc.) call `syncClearVisibility(wrap)` so the button
+ * toggles correctly — the `input` event fires for user typing but not
+ * for direct `.value =` assignments.
+ */
+export declare function wrapSearchWithClear(input: HTMLInputElement, onClear: () => void): HTMLElement;
+export declare function syncClearVisibility(wrap: HTMLElement): void;

package/dist/index.d.ts

@@ -38,6 +38,20 @@ export type { NotesToolbarOptions } from './components/notes-toolbar/notesToolba
 export { tipster, destroyTipster } from './components/popover/tipster';
 export { tennisCourt, basketballCourt, baseballDiamond, hockeyRink, pickleballCourt, badmintonCourt, padelCourt, createCourtSvg, resolveCourtSport, sportFromMatchUpFormat, COURT_SVG_RESOURCE_SUB_TYPE } from './components/courts';
 export type { CourtSport } from './components/courts';
+export { formatAddress, formatVenueLocation, formatDateRange, extractImageURL, extractCourtSvgSport, buildCardSkeleton } from './helpers/cards';
+export type { CardAddress, CardOnlineResource, CardVenueLike, CardSkeletonConfig } from './helpers/cards';
+export { buildTournamentCard, buildSkeletonCard, mapTournamentToCardData, resolveTournamentStatus, formatFeeRange, DEFAULT_TOURNAMENT_CARD_CONFIG, mergeTournamentCardConfig } from './components/tournament-card';
+export type { MapTournamentOptions, StatusResolverInput, TournamentCardCallbacks, TournamentCardConfig, TournamentCardCornerField, TournamentCardData, TournamentCardField, TournamentEntryFee, TournamentStatusKind, TournamentStatusPill } from './components/tournament-card';
+export { buildVenueCard, buildVenueSkeletonCard, mapVenueToCardData, DEFAULT_VENUE_CARD_CONFIG, mergeVenueCardConfig } from './components/venue-card';
+export type { MapVenueOptions, VenueCardCallbacks, VenueCardConfig, VenueCardCornerField, VenueCardData, VenueCardField } from './components/venue-card';
+export { buildCourtCard, buildCourtSkeletonCard, mapCourtToCardData, DEFAULT_COURT_CARD_CONFIG, mergeCourtCardConfig } from './components/court-card';
+export type { CourtCardCallbacks, CourtCardConfig, CourtCardCornerField, CourtCardData, CourtCardField, MapCourtOptions } from './components/court-card';
+export { buildCompetitivenessBar, buildCompetitivenessDonut, aggregateCompetitiveness, totalBuckets, COMPETITIVENESS_BUCKETS } from './components/competitivenessBar';
+export type { BuildCompetitivenessBarResult, BuildCompetitivenessDonutResult, CompetitivenessBucket, CompetitivenessBuckets } from './components/competitivenessBar';
+export { buildDrawCard, buildDrawSkeletonCard, mapDrawDefinitionToCardData, DEFAULT_DRAW_CARD_CONFIG, mergeDrawCardConfig } from './components/draw-card';
+export type { DrawCardCallbacks, DrawCardConfig, DrawCardCornerField, DrawCardData, DrawCardField, DrawMatchUpCounts, DrawStatusKind, DrawStatusPill, MapDrawOptions } from './components/draw-card';
+export { buildEventCard, buildEventSkeletonCard, mapEventToCardData, resolveEventStatus, DEFAULT_EVENT_CARD_CONFIG, EVENT_CARD_LIGHT_MODE_THRESHOLD, mergeEventCardConfig } from './components/event-card';
+export type { EventCardCallbacks, EventCardConfig, EventCardCornerField, EventCardData, EventCardField, EventGenderKind, EventMatchUpCounts, EventStatusKind, EventStatusPill, EventStatusResolverInput, EventTypeKind, MapEventOptions } from './components/event-card';
 export { courthiveComponentsVersion } from './version';
 export { MATCH_FORMATS } from './constants/matchUpFormats';
 export type { MatchUpFormatCode } from './constants/matchUpFormats';
@@ -49,6 +63,7 @@ export { validator } from './components/forms/renderValidator';
 export * as validators from './validators';
 export { DrawStateManager } from './helpers/drawStateManager';
 export type { RenderCallback } from './helpers/drawStateManager';
+export { wrapSearchWithClear, syncClearVisibility } from './helpers/searchClearButton';
 export { burstChart } from './components/burstChart/burstChart';
 export type { SunburstDrawData, SunburstMatchUp, SunburstSide, SegmentData, BurstChartEventHandlers, BurstChartOptions, BurstChartInstance } from './components/burstChart/burstChart';
 export { fromFactoryDrawData, fromLegacyDraw } from './components/burstChart/matchUpTransform';
@@ -67,7 +82,7 @@ export { TopologyBuilderControl, TopologyStore, topologyToDrawOptions, validateT
 export type { TopologyNode, TopologyEdge, TopologyState, TopologyChangeListener, TopologyBuilderConfig, TopologyTemplate, DrawOptionsResult, ValidationError } from './components/topology-builder';
 export type { SchedulingProfile, ScheduleDay, VenueSchedule, RoundProfile, RoundSegment, VenueInfo, CatalogRoundItem, CatalogGroupBy, RoundKey, RoundLocator, DragPayload, DropTarget, DropResult, Severity, ValidationCode, FixAction, ValidationResult, IssueIndex, ProfileStoreState, SchedulingProfileConfig, TemporalAdapter, DemandAdapter, DependencyAdapter, UIPanel } from './components/scheduling-profile';
 export { SchedulePageControl, SchedulePageStore, createSchedulePage, filterMatchUpCatalog, groupMatchUpCatalog, isCompletedStatus, buildScheduleIssueIndex, matchUpLabel, participantLabel, matchUpSearchKey, buildScheduleDateStrip, buildScheduleIssuesPanel, buildMatchUpCatalog, buildMatchUpCard, buildScheduleInspectorPanel, buildCourtGridSlot, buildSchedulePageLayout, buildScheduleGridCell, mapMatchUpToCellData, DEFAULT_SCHEDULE_CELL_CONFIG, activateScheduleCellTypeAhead, buildActiveStripPanel } from './components/schedule-page';
-export type { CatalogMatchUpItem, CatalogFilters, MatchUpSide, ScheduleDate, ScheduleIssue, ScheduleIssueSeverity, ScheduleIssueIndex, ScheduleIssueCounts, MatchUpCatalogGroupBy, ScheduledBehavior, SchedulingMode, PendingScheduleAction, CatalogMatchUpDragPayload, GridMatchUpDragPayload, SchedulePageDragPayload, SchedulePageConfig, SchedulePageState, SchedulePageChangeListener, ScheduleCellConfig, ScheduleCellField, ParticipantDisplayConfig, ScheduleCellData, ScheduleCellSide, ScheduleCellTypeAheadOptions, ActiveStripPanel, ActiveStripPanelCallbacks, ActiveStripPanelData, ActiveStripPanelOptions, ActiveStripCourtMeta } from './components/schedule-page';
+export type { CatalogMatchUpItem, CatalogFilters, MatchUpSide, ScheduleDate, ScheduleIssue, ScheduleIssueSeverity, ScheduleIssueIndex, ScheduleIssueCounts, MatchUpCatalogGroupBy, ScheduledBehavior, SchedulingMode, PendingScheduleAction, CatalogMatchUpDragPayload, GridMatchUpDragPayload, SchedulePageDragPayload, SchedulePageConfig, SchedulePageCatalogState, SchedulePageState, SchedulePageChangeListener, ScheduleCellConfig, ScheduleCellField, ParticipantDisplayConfig, ScheduleCellData, ScheduleCellSide, ScheduleCellTypeAheadOptions, ActiveStripPanel, ActiveStripPanelCallbacks, ActiveStripPanelData, ActiveStripPanelOptions, ActiveStripCourtMeta } from './components/schedule-page';
 export { createCompositionEditor } from './components/composition-editor/compositionEditor';
 export { CompositionEditorStore } from './components/composition-editor/compositionEditorStore';
 export type { CompositionEditorConfig, SavedComposition, CompositionEditorState, CompositionEditorListener, SectionId as CompositionEditorSectionId, EditorPanel as CompositionEditorPanel } from './components/composition-editor/compositionEditorTypes';

package/dist/styles/applyCompositionColors.d.ts

@@ -0,0 +1,9 @@
+import { CompositionColors } from '../types';
+/**
+ * Apply per-composition color overrides as inline CSS custom properties on a container.
+ * Values cascade to `.chc-matchup` borders and `.chc-link` connector pseudo-elements without
+ * touching their style rules. Unspecified fields are left to the theme class default.
+ */
+export declare function applyCompositionColors(element: HTMLElement, colors?: CompositionColors): void;
+/** Remove every CSS custom property managed by `applyCompositionColors` from a container. */
+export declare function clearCompositionColors(element: HTMLElement): void;

package/dist/styles/themes/index.d.ts

@@ -4,4 +4,5 @@ export { wimbledonTheme } from './wimbledonTheme';
 export { frenchTheme } from './frenchTheme';
 export { usOpenTheme } from './usOpenTheme';
 export { basicTheme } from './basicTheme';
+export { typtiTheme } from './typtiTheme';
 export { itfTheme } from './itfTheme';

package/dist/styles/themes/typtiTheme.d.ts

@@ -0,0 +1 @@
+export declare const typtiTheme: string;

package/dist/types.d.ts

@@ -220,9 +220,34 @@ export interface Configuration {
         close?: string;
     };
 }
+export interface CompositionColors {
+    /** matchUp border color — sets `--chc-color-border` on the draw container */
+    border?: string;
+    /** matchUp border color on hover — sets `--chc-color-border-hover` */
+    borderHover?: string;
+    /** inline-start (left) border color — sets `--chc-color-border-inline-start`. Falls back to `border` when unset. */
+    borderInlineStart?: string;
+    /** inline-start (left) border width, e.g. '10px' — sets `--chc-border-width-inline-start` */
+    borderInlineStartWidth?: string;
+    /** connector line color between matchUps — sets `--chc-color-connector` */
+    connector?: string;
+    /** matchUp background color — sets `--chc-color-matchup` */
+    matchUpBackground?: string;
+    /** divider color between participants within a matchUp — sets `--chc-color-internal-dividers` */
+    internalDividers?: string;
+    /** placeholder "[Score]" text color — sets `--chc-color-score`. Falls back to `--chc-status-info`. */
+    score?: string;
+    /** round header text + underline color — sets `--chc-color-round-header`.
+     * Underline falls back to `--chc-text-primary`; text falls back to inherit. */
+    roundHeader?: string;
+}
 export interface Composition {
     theme: string;
     configuration?: Configuration;
+    /** Per-composition color overrides. Applied as inline CSS custom properties on the draw root,
+     * cascading to `.chc-matchup` borders and `.chc-link` connector pseudo-elements. Unspecified
+     * fields fall back to the theme's defaults. */
+    colors?: CompositionColors;
 }
 export interface EventHandlers {
     matchUpClick?: (params: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "courthive-components",
-  "packageManager": "pnpm@11.1.2",
-  "version": "1.5.0",
+  "packageManager": "pnpm@11.1.3",
+  "version": "1.7.0",
   "engines": {
     "node": ">=22"
   },
@@ -69,8 +69,8 @@
   },
   "devDependencies": {
     "@chromatic-com/storybook": "^5.0.0",
-    "@commitlint/cli": "21.0.0",
-    "@commitlint/config-conventional": "21.0.0",
+    "@commitlint/cli": "21.0.1",
+    "@commitlint/config-conventional": "21.0.1",
     "@eslint/js": "^10.0.1",
     "@fortawesome/fontawesome-free": "^7.2.0",
     "@storybook/addon-docs": "^10.2.17",
@@ -83,21 +83,21 @@
     "@vitest/browser-playwright": "^4.0.16",
     "@vitest/coverage-v8": "^4.0.16",
     "@vitest/ui": "^4.0.16",
-    "eslint": "10.3.0",
+    "eslint": "10.4.0",
     "eslint-plugin-sonarjs": "4.0.3",
     "eslint-plugin-storybook": "^10.2.17",
     "gh-pages": "6.3.0",
     "globals": "^17.3.0",
     "happy-dom": "^20.8.3",
     "husky": "9.1.7",
-    "lint-staged": "17.0.4",
+    "lint-staged": "17.0.5",
     "playwright": "^1.57.0",
     "prettier": "^3.8.1",
-    "semver": "7.7.4",
+    "semver": "7.8.0",
     "storybook": "^10.2.17",
     "tabulator-tables": "6.4.0",
     "typescript": "^6.0.2",
-    "vite": "8.0.12",
+    "vite": "8.0.13",
     "vite-plugin-dts": "^5.0.0",
     "vitest": "^4.0.16"
   },
@@ -110,7 +110,7 @@
     "focus-trap": "^8.0.0",
     "timepicker-ui": "^4.1.2",
     "tippy.js": "6.3.7",
-    "tods-competition-factory": ">=3.6.0",
+    "tods-competition-factory": "3.9.0",
     "vanillajs-datepicker": "1.3.4"
   }
 }