courthive-components 3.9.0 → 3.11.0

package/dist/components/burstChart/matchUpTransform.d.ts

@@ -1,4 +1,13 @@
 import { SunburstDrawData } from './burstChart';
+/**
+ * Pick the structure the progression sunburst should render from a draw's
+ * `getEventData().drawsData[i].structures`. A composite draw (round-robin
+ * qualifying → single-elimination main, or round-robin main → elimination
+ * playoff) must render its ELIMINATION structure, never the round-robin one.
+ * Returns the elimination structure (MAIN preferred, else the first), or
+ * `undefined` when the draw has no bracket (pure round-robin).
+ */
+export declare function pickProgressionStructure(structures?: any[]): any | undefined;
 /**
  * Convert a tods-competition-factory `getEventData().drawsData[i].structures[0]`
  * object into the TODS-aligned SunburstDrawData that the sunburst consumes.

package/dist/components/forms/renderForm.d.ts

@@ -1 +1,16 @@
-export declare function renderForm(elem: HTMLElement, items: any[], relationships?: any[]): any;
+export interface RenderFormOptions {
+    /**
+     * Wrap the fields in a real `<form>` so password managers and native
+     * Enter-to-submit have an unambiguous target. `true` uses defaults; pass an
+     * object to wire an `onSubmit` handler. Omitted (the default) keeps the
+     * historical `<div>` container, so existing callers are unaffected.
+     */
+    form?: boolean | {
+        onSubmit?: (args: {
+            e: Event;
+            inputs: any;
+            fields: any;
+        }) => void;
+    };
+}
+export declare function renderForm(elem: HTMLElement, items: any[], relationships?: any[], options?: RenderFormOptions): any;

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

@@ -1,4 +1,23 @@
-import { HiveIDAuthenticatedDetail, HiveIDLoginConfig, HiveIDLoginShell } from './types';
+import { HiveIDAuthenticatedDetail, HiveIDFederationId, 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>;
+/**
+ * Merge a user-entered federation id (from the signup capture field) with any
+ * consumer-supplied `config.federationIds`, de-duped by `provider::externalId`.
+ * Returns undefined when there is nothing to send (so the signup fragment stays
+ * name-only, matching prior behavior).
+ */
+export declare function mergeFederationIds(entered: HiveIDFederationId | null, configIds?: HiveIDFederationId[]): HiveIDFederationId[] | undefined;
+/**
+ * Normalize the raw DOB + sex captured on the signup form: trim, and drop empty
+ * values (so an untouched field stays `undefined` and the signup fragment omits
+ * it rather than sending an empty string). Pure — unit-tested without the DOM.
+ */
+export declare function normalizeSignupPii(raw: {
+    birthDate?: string;
+    sex?: string;
+}): {
+    birthDate?: string;
+    sex?: string;
+};

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

@@ -30,6 +30,12 @@ export interface SignupRequest {
     firstName: string;
     lastName: string;
     federationIds?: HiveIDFederationId[];
+    /** Date of birth (YYYY-MM-DD), collected behind a consent gate. */
+    birthDate?: string;
+    /** Sex ('M' | 'F'), collected behind a consent gate. */
+    sex?: string;
+    /** Provider context — anchors a fresh mint to the registering tournament's tenant. */
+    provider?: string;
 }
 export interface VerifyExistingRequest {
     email: string;
@@ -76,6 +82,54 @@ export interface MagicLinkConsumeResponse {
     personRevision: number | null;
     cached: CachedPersonFields;
 }
+export interface FederationIdCaptureProvider {
+    /** Provider key sent to the registry, e.g. 'BOBOCA'. */
+    value: string;
+    /** Display label, e.g. 'BOBOCA'. */
+    label: string;
+}
+/**
+ * Opt-in federation-id capture on the signup form. When present, the signup
+ * form shows an optional "player id" field (+ a provider select when more than
+ * one provider is offered). A person who quotes an id that matches a
+ * `(provider, externalId)` alias in courthive-persons is strong-match RESOLVED
+ * at signup — the only way the name-only signup fragment can acquire a
+ * `personId` today. This is the "claim your existing (e.g. BOBOCA) identity" path.
+ */
+export interface FederationIdCaptureConfig {
+    /** One or more providers to offer. A single entry renders no select (fixed provider). */
+    providers: FederationIdCaptureProvider[];
+    /** Label for the id input. Default: 'Player ID'. */
+    idLabel?: string;
+    /** Optional helper text shown above the field. */
+    note?: string;
+}
+export interface SignupSexOption {
+    /** Value sent verbatim to courthive-persons — 'M' / 'F' (the backfill encoding). */
+    value: string;
+    /** Display label, e.g. 'Male'. */
+    label: string;
+}
+/**
+ * Opt-in date-of-birth + sex capture on the signup form. When present (and the
+ * consumer has already gated collection behind a consent notice — decision #4 of
+ * PUBLIC_REGISTRATION_AND_ONBOARDING), the signup form shows a DOB field and a sex
+ * select. Together with a `provider` context these let courthive-persons dedupe on
+ * name+DOB+sex, or MINT a canonical person when no match exists (the only path a
+ * brand-new public person can acquire a personId without a pre-existing provider id).
+ */
+export interface DobSexCaptureConfig {
+    /** Sex options offered. Defaults to Male→'M' / Female→'F' (persons encoding). */
+    sexOptions?: SignupSexOption[];
+    /** Label for the DOB input. Default: 'Date of birth'. */
+    dobLabel?: string;
+    /** Label for the sex select. Default: 'Sex'. */
+    sexLabel?: string;
+    /** Optional helper text shown above the fields. */
+    note?: string;
+    /** Require both DOB and sex before signup can proceed. Default: true. */
+    required?: boolean;
+}
 export interface HiveIDLoginConfig {
     /** Which CFS instance to talk to (no trailing slash). */
     cfsBaseUrl: string;
@@ -89,6 +143,23 @@ export interface HiveIDLoginConfig {
      * strong-match likelihood. Most callers leave this empty.
      */
     federationIds?: HiveIDFederationId[];
+    /**
+     * Opt-in: show an optional federation-id field on the signup form so a person
+     * can quote an existing provider id and be RESOLVED to their canonical
+     * person. Merged with `federationIds`. See FederationIdCaptureConfig.
+     */
+    federationIdCapture?: FederationIdCaptureConfig;
+    /**
+     * Opt-in: show DOB + sex fields on the signup form so a brand-new person can be
+     * deduped-or-MINTED. The consumer is responsible for the consent gate that must
+     * precede collection (decision #4). See DobSexCaptureConfig.
+     */
+    dobSexCapture?: DobSexCaptureConfig;
+    /**
+     * Provider context forwarded on signup (e.g. the registering tournament's
+     * provider). Anchors a fresh mint to that tenant. Paired with `dobSexCapture`.
+     */
+    provider?: string;
     /** Optional fetch implementation (tests stub this). */
     fetchImpl?: typeof fetch;
 }

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

@@ -272,4 +272,17 @@ export interface ScheduleCellData {
          */
         registrations?: string[];
     };
+    /**
+     * Reserved cell (alternative to matchUp) — a court slot occupied by ANOTHER, facility-sharing
+     * tournament that the viewer does not author. Read-only and opaque: it carries no matchUp/participant
+     * detail, only the slim information the consumer chooses to surface from a schedule projection. The
+     * consumer renders it non-interactive (no drag/move) — the widget only handles its appearance.
+     */
+    isReserved?: boolean;
+    reservation?: {
+        /** Display label for the occupying tournament (e.g. its name), pre-formatted by the consumer. */
+        tournamentName?: string;
+        /** Optional scheduled time to show on the cell. */
+        scheduledTime?: string;
+    };
 }