courthive-components 1.10.1 → 2.0.0

package/dist/components/editor/notesEditor.d.ts

@@ -0,0 +1,13 @@
+import { Editor } from '@tiptap/core';
+export interface NotesEditorOptions {
+    initialHtml?: string;
+}
+export interface NotesEditorHandle {
+    toolbar: HTMLElement;
+    editorElement: HTMLElement;
+    editor: Editor | undefined;
+    getHtml(): string;
+    isEmpty(): boolean;
+    destroy(): void;
+}
+export declare function createNotesEditor(options?: NotesEditorOptions): NotesEditorHandle;

package/dist/components/hive-id-login/buildHiveIDLogin.d.ts

@@ -0,0 +1,4 @@
+import { HiveIDAuthenticatedDetail, HiveIDLoginConfig, HiveIDLoginShell } from './types';
+export declare function buildHiveIDLogin(config: HiveIDLoginConfig): HiveIDLoginShell;
+/** Magic-link consume helper for the courthive-public landing route. */
+export declare function completeMagicLink(cfsBaseUrl: string, code: string, fetchImpl?: typeof fetch): Promise<HiveIDAuthenticatedDetail>;

package/dist/components/hive-id-login/hiveIDClient.d.ts

@@ -0,0 +1,14 @@
+import { HiveIDClientError, MagicLinkConsumeRequest, MagicLinkConsumeResponse, MagicLinkRequest, MagicLinkResponse, SignupRequest, SignupResponse, VerifyExistingRequest, VerifyExistingResponse } from './types';
+type FetchLike = typeof fetch;
+export declare function signup(baseUrl: string, body: SignupRequest, fetchImpl?: FetchLike): Promise<SignupResponse>;
+export declare function verifyExisting(baseUrl: string, body: VerifyExistingRequest, fetchImpl?: FetchLike): Promise<VerifyExistingResponse>;
+export declare function requestMagicLink(baseUrl: string, body: MagicLinkRequest, fetchImpl?: FetchLike): Promise<MagicLinkResponse>;
+export declare function consumeMagicLink(baseUrl: string, body: MagicLinkConsumeRequest, fetchImpl?: FetchLike): Promise<MagicLinkConsumeResponse>;
+/**
+ * Helper: returns true when the error is a 409 with the existing-user
+ * redirect shape from CFS (`{ code: 'EXISTING_USER', ... }`). The
+ * component uses this to swap signup mode → verify-existing without
+ * re-typing the email.
+ */
+export declare function isExistingUserConflict(err: unknown): err is HiveIDClientError;
+export {};

package/dist/components/hive-id-login/index.d.ts

@@ -0,0 +1,3 @@
+export { buildHiveIDLogin, completeMagicLink } from './buildHiveIDLogin';
+export { consumeMagicLink, isExistingUserConflict, requestMagicLink, signup, verifyExisting } from './hiveIDClient';
+export type { CachedPersonFields, HiveIDAuthenticatedDetail, HiveIDClientError, HiveIDFederationId, HiveIDLoginConfig, HiveIDLoginShell, HiveIDMode, MagicLinkConsumeRequest, MagicLinkConsumeResponse, MagicLinkRequest, MagicLinkResponse, SignupCandidate, SignupRequest, SignupResolved, SignupResponse, VerifyExistingRequest, VerifyExistingResponse } from './types';

package/dist/components/hive-id-login/styles.d.ts

@@ -0,0 +1,16 @@
+export declare const hilContainerStyle: () => string;
+export declare const hilFormStyle: () => string;
+export declare const hilHeaderStyle: () => string;
+export declare const hilTitleStyle: () => string;
+export declare const hilTabsStyle: () => string;
+export declare const hilTabStyle: () => string;
+export declare const hilTabActiveStyle: () => string;
+export declare const hilFieldStyle: () => string;
+export declare const hilLabelStyle: () => string;
+export declare const hilInputStyle: () => string;
+export declare const hilRowStyle: () => string;
+export declare const hilSubmitStyle: () => string;
+export declare const hilMessageStyle: () => string;
+export declare const hilMessageErrorStyle: () => string;
+export declare const hilMessageSuccessStyle: () => string;
+export declare const hilSwitchModeStyle: () => string;

package/dist/components/hive-id-login/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * HiveID Login — types.
+ *
+ * Mirrors the response shapes from CFS `/auth/hiveid/*` (PR-G):
+ * - POST /auth/hiveid/signup
+ * - POST /auth/hiveid/verify-existing
+ * - POST /auth/hiveid/magic-link
+ * - POST /auth/hiveid/magic-link/consume
+ */
+export type HiveIDMode = 'signup' | 'login' | 'magic-link';
+export interface CachedPersonFields {
+    standardFamilyName: string | null;
+    standardGivenName: string | null;
+    birthDate: string | null;
+    sex: string | null;
+    nationalityCode: string | null;
+}
+export interface HiveIDFederationId {
+    provider: string;
+    externalId: string;
+}
+export interface HiveIDAuthenticatedDetail {
+    token: string;
+    refreshToken: string;
+    personId: string | null;
+    cached: CachedPersonFields;
+}
+export interface SignupRequest {
+    email: string;
+    firstName: string;
+    lastName: string;
+    federationIds?: HiveIDFederationId[];
+}
+export interface VerifyExistingRequest {
+    email: string;
+    password: string;
+}
+export interface MagicLinkRequest {
+    email: string;
+}
+export interface MagicLinkConsumeRequest {
+    code: string;
+}
+export interface SignupResolved {
+    status: 'created';
+    token: string;
+    refreshToken: string;
+    personId: string;
+    personRevision: number;
+    cached: CachedPersonFields;
+}
+export interface SignupCandidate {
+    status: 'candidate';
+    candidates: {
+        personId: string;
+        confidence: number;
+    }[];
+}
+export type SignupResponse = SignupResolved | SignupCandidate;
+export interface VerifyExistingResponse {
+    status: 'verified';
+    token: string;
+    refreshToken: string;
+    personId: string | null;
+    personRevision: number | null;
+    cached: CachedPersonFields | null;
+}
+export interface MagicLinkResponse {
+    ok: true;
+}
+export interface MagicLinkConsumeResponse {
+    status: 'authenticated';
+    token: string;
+    refreshToken: string;
+    personId: string | null;
+    personRevision: number | null;
+    cached: CachedPersonFields;
+}
+export interface HiveIDLoginConfig {
+    /** Which CFS instance to talk to (no trailing slash). */
+    cfsBaseUrl: string;
+    /** Starting mode. Defaults to 'signup'. The user can toggle inside the component. */
+    mode?: HiveIDMode;
+    /** Pre-fill email — useful when the consumer already knows the user. */
+    defaultEmail?: string;
+    /**
+     * Optional pre-existing federation IDs (e.g. a USTA id known to the
+     * consumer) appended to the signup resolve fragment to bump
+     * strong-match likelihood. Most callers leave this empty.
+     */
+    federationIds?: HiveIDFederationId[];
+    /** Optional fetch implementation (tests stub this). */
+    fetchImpl?: typeof fetch;
+}
+export interface HiveIDLoginShell {
+    /** Root DOM node — append to your container. */
+    root: HTMLElement;
+    /** Programmatically swap modes (signup ⇄ login ⇄ magic-link). */
+    setMode(mode: HiveIDMode): void;
+    /** Current mode. */
+    getMode(): HiveIDMode;
+    /** Convenience: subscribe to the success event without addEventListener. */
+    onAuthenticated(handler: (detail: HiveIDAuthenticatedDetail) => void): () => void;
+}
+export type HiveIDClientError = {
+    kind: 'http';
+    status: number;
+    body: any;
+} | {
+    kind: 'network';
+    cause: Error;
+} | {
+    kind: 'parse';
+    cause: Error;
+};

package/dist/components/interactive-scoring/types.d.ts

@@ -30,6 +30,14 @@ export interface InteractiveScoringShellConfig {
      * IndexedDB. If omitted, the shell starts at 0-0.
      */
     initialMatchUp?: MatchUp;
+    /**
+     * Hook to confirm a reset before the engine clears the matchUp. Return
+     * `true` to proceed, `false` to abort. Consumers wire this to whatever
+     * themed-modal primitive their app uses (e.g. cModal in
+     * courthive-public). When omitted, Reset fires immediately without any
+     * prompt — the shell NEVER falls back to a native browser dialog.
+     */
+    confirmReset?: () => boolean | Promise<boolean>;
 }
 /**
  * Detail payload for the `stateChanged` CustomEvent.

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

@@ -1,4 +1,15 @@
 import { CatalogMatchUpItem, CatalogFilters, MatchUpCatalogGroupBy, ScheduledBehavior } from '../types';
 export declare function isCompletedStatus(status?: string): boolean;
 export declare function filterMatchUpCatalog(catalog: CatalogMatchUpItem[], query: string, behavior?: ScheduledBehavior, filters?: CatalogFilters, showCompleted?: boolean): CatalogMatchUpItem[];
+/**
+ * For each event, returns the lowest `roundNumber` among items that are
+ * unscheduled and not completed. Drives the round-emphasis tier on each
+ * catalog card — offset 0 means "this round is what should be scheduled
+ * next within its event," offset >= 1 deemphasizes future rounds.
+ *
+ * Computed against the FULL catalog (not the filtered set) by the catalog
+ * widget's `update()` so a search / filter that narrows the visible items
+ * doesn't shift the priority assignment underneath the operator.
+ */
+export declare function computeBaseRoundByEvent(catalog: CatalogMatchUpItem[]): Map<string, number>;
 export declare function groupMatchUpCatalog(items: CatalogMatchUpItem[], mode: MatchUpCatalogGroupBy): Map<string, CatalogMatchUpItem[]>;

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

@@ -7,7 +7,7 @@ import { SchedulePageControl } from './controller/schedulePageControl';
  */
 export { SchedulePageControl } from './controller/schedulePageControl';
 export { SchedulePageStore } from './engine/schedulePageStore';
-export { filterMatchUpCatalog, groupMatchUpCatalog, isCompletedStatus } from './domain/matchUpCatalogProjections';
+export { filterMatchUpCatalog, groupMatchUpCatalog, computeBaseRoundByEvent, isCompletedStatus } from './domain/matchUpCatalogProjections';
 export { buildScheduleIssueIndex } from './domain/scheduleIssues';
 export { matchUpLabel, participantLabel, matchUpSearchKey, deepClone } from './domain/utils';
 export { computeActiveStrip, computeActiveStripCell, computeActiveStripDropTarget } from './domain/activeStrip';

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

@@ -17,6 +17,11 @@ export interface CatalogMatchUpItem {
     drawId: string;
     drawName?: string;
     structureId: string;
+    /** Draw stage — MAIN / CONSOLATION / PLAYOFF / QUALIFYING / ROUND_ROBIN /
+     *  etc. Rendered as a chip when present and not MAIN so a Quarterfinal in
+     *  the consolation bracket reads distinctly from a Quarterfinal in the
+     *  main draw of the same event. */
+    stage?: string;
     roundNumber: number;
     roundName?: string;
     matchUpFormat?: string;

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

@@ -7,5 +7,13 @@ export interface MatchUpCardOptions {
      *  (top-right) and suppress the standard time chip. Used by the schedule
      *  grid's Scheduled tab where the time is the card's primary signal. */
     prominentTime?: boolean;
+    /** Distance from the earliest unscheduled round within this card's event.
+     *  0 = this round is the next-to-schedule (highest emphasis on the title),
+     *  1 = one round behind, ≥ 2 = further out (lowest emphasis). Mapped to
+     *  `spl-card-title--round-current / next / later` classes so consumers can
+     *  re-theme via CSS without touching the JS. Omit to leave the title at
+     *  its default styling (used for non-catalog renders + scheduled / completed
+     *  cards where round priority is meaningless). */
+    roundOffset?: number;
 }
 export declare function buildMatchUpCard(item: CatalogMatchUpItem, callbacks: MatchUpCardCallbacks, options?: MatchUpCardOptions): HTMLElement;

package/dist/components/scoring/logic/dynamicSetsLogic.d.ts

@@ -15,6 +15,8 @@ export type SetFormat = {
     };
     timed?: boolean;
     minutes?: number;
+    noTiebreak?: boolean;
+    winBy?: number;
 };
 /**
  * Configuration for a matchUp

package/dist/components/team-card/buildTeamCard.d.ts

@@ -0,0 +1,2 @@
+import { TeamCardCallbacks, TeamCardData } from './types';
+export declare function buildTeamCard(data: TeamCardData, callbacks?: TeamCardCallbacks): HTMLElement;

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

@@ -0,0 +1,2 @@
+export { buildTeamCard } from './buildTeamCard';
+export type { TeamCardCallbacks, TeamCardData } from './types';

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

@@ -0,0 +1,13 @@
+/**
+ * Team Card — Class-name constants.
+ *
+ * One class per zone. CSS lives in `team-card.css` and is themed via
+ * `--chc-*` custom properties so consumers can re-skin without touching
+ * the primitive.
+ */
+export declare const tcCardClass: () => string;
+export declare const tcCardClickableClass: () => string;
+export declare const tcTitleRowClass: () => string;
+export declare const tcNameClass: () => string;
+export declare const tcNicknameClass: () => string;
+export declare const tcCountsClass: () => string;

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

@@ -0,0 +1,27 @@
+/**
+ * Team Card — Type Definitions
+ *
+ * Flat data + JSON-serializable config consumed by `buildTeamCard`.
+ *
+ * v1 surface is intentionally minimal: a card header that renders a team
+ * name, an optional nickname, and a `·`-separated summary line of
+ * pre-formatted count segments (e.g. "9 players · 1 coach · 1 physio").
+ * i18n / pluralization is the consumer's responsibility — the primitive
+ * stays locale-agnostic so it can ship in any CourtHive surface.
+ */
+export interface TeamCardData {
+    teamId?: string;
+    teamName: string;
+    /** Short alias shown in italic quotes next to the name. */
+    nickname?: string;
+    /**
+     * Pre-formatted summary segments joined with " · ".
+     * Empty values are dropped; falsy array → segment line is omitted entirely.
+     */
+    countSegments?: string[];
+}
+export interface TeamCardCallbacks {
+    /** Click handler. Mirrors the other card primitives' contract — sets
+     *  `tabindex` / `role=button` / keyboard activation automatically. */
+    onClick?: (data: TeamCardData) => void;
+}

package/dist/components/temporal-grid/controller/temporalGridControl.d.ts

@@ -1,11 +1,11 @@
-import { temporal, TemporalEngine } from 'tods-competition-factory';
+import { availability, AvailabilityEngine } from 'tods-competition-factory';
 import { TemporalViewState } from '../engine/viewState';
 import { DEFAULT_COLOR_SCHEME, ResourceGroupingMode } from './viewProjections';
 import { BlockPopoverManager } from '../ui/blockPopover';
 import { CourtTimeline } from '../timeline/CourtTimeline';
-type BlockType = temporal.BlockType;
-type CourtRef = temporal.CourtRef;
-type DayId = temporal.DayId;
+type BlockType = availability.BlockType;
+type CourtRef = availability.CourtRef;
+type DayId = availability.DayId;
 export interface TemporalGridControlConfig {
     /** Container element for the timeline */
     container: HTMLElement;
@@ -35,6 +35,14 @@ export interface TemporalGridControlConfig {
     onBlocksChanged?: () => void;
     /** Callback when a day label is double-clicked (for navigating to 1-Day view) */
     onDayNavigate?: (day: string) => void;
+    /**
+     * Callback invoked when an action can't complete because of scheduling
+     * conflicts. The controller never opens a dialog itself — the consumer
+     * wires this hook to its own themed-toast / modal system. When omitted,
+     * conflicts are written to console.warn only (NEVER falls back to a
+     * native browser alert).
+     */
+    onConflict?: (conflicts: any[]) => void;
 }
 export declare class TemporalGridControl {
     private readonly engine;
@@ -49,7 +57,7 @@ export declare class TemporalGridControl {
     private currentView;
     private selectedCourts;
     private visibleCourts;
-    constructor(engine: TemporalEngine, config: TemporalGridControlConfig);
+    constructor(engine: AvailabilityEngine, config: TemporalGridControlConfig);
     private initialize;
     /**
      * Ensure timeline exists. Defers creation to the next macro-task so the
@@ -123,15 +131,20 @@ export declare class TemporalGridControl {
      * toISOString() converts to UTC which shifts the time by the local offset.
      */
     private toLocalISO;
-    /** Show conflict dialog */
+    /**
+     * Surface scheduling conflicts to the consumer. We never open a dialog
+     * here — the consumer's `onConflict` hook routes them to whatever themed
+     * notification system the host app uses (TMX toast, AMS console modal,
+     * etc.). When no hook is wired, conflicts go to console.warn only.
+     */
     private showConflictDialog;
     /** Get timeline instance (for advanced usage) */
     getTimeline(): CourtTimeline | null;
     /** Get engine instance */
-    getEngine(): TemporalEngine;
+    getEngine(): AvailabilityEngine;
     /** Get view state (for external consumers to subscribe to view changes) */
     getViewState(): TemporalViewState;
 }
 /** Create a temporal grid controller */
-export declare function createTemporalGridControl(engine: TemporalEngine, config: TemporalGridControlConfig): TemporalGridControl;
+export declare function createTemporalGridControl(engine: AvailabilityEngine, config: TemporalGridControlConfig): TemporalGridControl;
 export {};

package/dist/components/temporal-grid/controller/viewProjections.d.ts

@@ -1,8 +1,8 @@
-import { temporal } from 'tods-competition-factory';
-type BlockType = temporal.BlockType;
-type CourtMeta = temporal.CourtMeta;
-type CourtRef = temporal.CourtRef;
-type VenueDayTimeline = temporal.VenueDayTimeline;
+import { availability } from 'tods-competition-factory';
+type BlockType = availability.BlockType;
+type CourtMeta = availability.CourtMeta;
+type CourtRef = availability.CourtRef;
+type VenueDayTimeline = availability.VenueDayTimeline;
 /**
  * Timeline Group (represents a court or facility group header)
  */

package/dist/components/temporal-grid/engine/viewState.d.ts

@@ -1,6 +1,6 @@
-import { temporal } from 'tods-competition-factory';
-type BlockType = temporal.BlockType;
-type DayId = temporal.DayId;
+import { availability } from 'tods-competition-factory';
+type BlockType = availability.BlockType;
+type DayId = availability.DayId;
 export interface ViewStateSnapshot {
     selectedDay: DayId | null;
     selectedVenue: string | null;

package/dist/components/temporal-grid/index.d.ts

@@ -4,7 +4,7 @@
  * Engine modules re-exported from tods-competition-factory via `temporal` namespace.
  * Controller, UI, and view state are local to courthive-components.
  */
-export { TemporalEngine, TemporalEngine as TemporalGridEngine, temporal } from 'tods-competition-factory';
+export { AvailabilityEngine, AvailabilityEngine as TemporalGridEngine, availability } from 'tods-competition-factory';
 export { TemporalViewState, type ViewChangeEvent, type ViewChangeListener, type ViewStateSnapshot } from './engine/viewState';
 export { createTemporalGridControl, TemporalGridControl, type TemporalGridControlConfig } from './controller/temporalGridControl';
 export { buildBlockEvents, buildCapacityVisualization, buildConflictEvents, buildEventsFromTimelines, buildVenueGroups, buildHiddenDates, buildResourcesFromTimelines, buildTimeSlotConfig, buildTimelineWindowConfig, DEFAULT_COLOR_SCHEME, filterEventsByTimeRange, filterResourcesByVenue, generateBlockPatternCSS, isBlockEvent, isConflictEvent, isSegmentEvent, parseBlockEventId, parseResourceId, sortResources, type BlockColorScheme, type CalendarEvent, type CalendarResource, type TimelineGroup, type TimelineItem, type ProjectionConfig, type ResourceGroupingMode } from './controller/viewProjections';

package/dist/components/temporal-grid/timeline/types.d.ts

@@ -1,5 +1,5 @@
-import { temporal } from 'tods-competition-factory';
-type CourtRef = temporal.CourtRef;
+import { availability } from 'tods-competition-factory';
+type CourtRef = availability.CourtRef;
 export interface TimelineGroupData {
     id: string;
     content: string;

package/dist/components/temporal-grid/ui/blockPopover.d.ts

@@ -1,4 +1,4 @@
-import { TemporalEngine } from 'tods-competition-factory';
+import { AvailabilityEngine } from 'tods-competition-factory';
 export interface BlockPopoverOptions {
     itemId: string;
     blockTypes: Array<{
@@ -16,7 +16,7 @@ export interface BlockPopoverOptions {
 export interface EngineBlockPopoverOptions {
     itemId: string;
     blockId: string;
-    engine: TemporalEngine;
+    engine: AvailabilityEngine;
     day: string;
     onBlockChanged: () => void;
 }

package/dist/components/temporal-grid/ui/temporalGrid.d.ts

@@ -1,6 +1,6 @@
-import { TemporalEngine, temporal } from 'tods-competition-factory';
+import { AvailabilityEngine, availability } from 'tods-competition-factory';
 import { TemporalGridControl, TemporalGridControlConfig } from '../controller/temporalGridControl';
-type DayId = temporal.DayId;
+type DayId = availability.DayId;
 /**
  * i18n labels for the temporal grid component.
  * All fields are optional — English defaults are used when omitted.
@@ -128,7 +128,7 @@ export declare class TemporalGrid {
     /**
      * Get the engine instance
      */
-    getEngine(): TemporalEngine;
+    getEngine(): AvailabilityEngine;
     /**
      * Get the controller instance
      */