courthive-components 6.0.1 → 6.1.0

package/dist/components/scoring/scoreEntryCard.d.ts

@@ -0,0 +1,83 @@
+import { ScoreEntryState, SideNumber } from './logic/scoreEntryState';
+import { StatusCodeGroups } from './logic/statusCodes';
+/**
+ * One column the region contributes to the participant rows.
+ *
+ * `heading` and `width` travel TOGETHER deliberately. The header row and the participant rows are
+ * built from this one array, so a heading can never end up over a column it does not describe — the
+ * correspondence is structural rather than two lists that have to be kept the same length by hand.
+ * CA asked for that alignment explicitly (2026-09-27) and this is what makes it hold rather than a
+ * rule someone has to remember.
+ *
+ * A column with no `heading` renders no header cell, and a region whose columns are all unheaded gets
+ * no header row at all — which is what Free Score and the Dial Pad want, since their single readout
+ * column needs no label.
+ */
+export type ScoreColumn = {
+    /** The heading above this column, e.g. `1st`. Omit for an unlabelled column. */
+    heading?: string;
+    /** A CSS grid track size. Defaults to the standard score-column width. */
+    width?: string;
+};
+export type ScoreRegion = {
+    /** The columns this region contributes to each participant row. */
+    columns?: () => ScoreColumn[];
+    /** The cells to place in one side's row. Must return one per column. */
+    rowCells?: (sideNumber: SideNumber) => HTMLElement[];
+    /** A block beneath the rows — a text field, or a keypad. */
+    block?: () => HTMLElement;
+    /** The score as it currently stands, for the result band. */
+    scoreString?: () => string | undefined;
+    /** Whether that score is a finished result. The region's judgement, never the card's. */
+    isComplete?: () => boolean;
+    /** The winner the score implies, when no ending overrides it. */
+    winningSide?: () => SideNumber | undefined;
+    /**
+     * A matchUpStatus the region itself parsed out of what was typed — Free Score only.
+     *
+     * Used ONLY when the operator has selected no ending. See `resolveReportedEnding` for why that
+     * precedence and not the other.
+     */
+    matchUpStatus?: () => string | undefined;
+};
+export type ScoreEntryCardParams = {
+    sides: [{
+        participantName: string;
+        seed?: string;
+    }, {
+        participantName: string;
+        seed?: string;
+    }];
+    matchUpFormat?: string;
+    /** e.g. `'R16 · Court 3'`. */
+    context?: string;
+    title?: string;
+    /** The score region for the active approach. */
+    region: ScoreRegion;
+    /** The policy's reason-code groups, if the tournament has a scoring policy attached. */
+    statusCodeGroups?: StatusCodeGroups;
+    /** Ending labels, so a locale can supply them. */
+    labels?: Record<string, string>;
+    /** The approach switcher's current label, e.g. `'Dynamic Sets'`. Omit to hide the switcher. */
+    approachLabel?: string;
+    onSwitchApproach?: () => void;
+    onCancel?: () => void;
+    onClear?: () => void;
+    onSubmit?: (outcome: {
+        matchUpStatus?: string;
+        winningSide?: number;
+        reasonCode?: string;
+    }) => void;
+    onClose?: () => void;
+};
+/** A card instance: its element, plus the handle the host needs to react to score-region changes. */
+export type ScoreEntryCard = {
+    element: HTMLElement;
+    /** Re-render the band and the submit gate. Call when the score region's value changes. */
+    refresh: () => void;
+    /** Rebuild everything, including the region's cells. Call when the region's COLUMNS change. */
+    rerender: () => void;
+    /** The current ending state, for a host that needs to inspect it. */
+    getState: () => ScoreEntryState;
+};
+export declare function renderScoreEntryCard(params: ScoreEntryCardParams): ScoreEntryCard;

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

@@ -37,6 +37,10 @@ export type ScoringModalLabels = {
     incomplete?: string;
     walkover?: string;
     defaulted?: string;
+    suspended?: string;
+    deadRubber?: string;
+    inProgress?: string;
+    awaitingResult?: string;
     validScore?: string;
     scoreIncomplete?: string;
     invalidScore?: string;