courthive-components 3.1.0 → 3.3.0

package/dist/components/ladderChart/index.d.ts

@@ -0,0 +1,2 @@
+export { buildLadderChart } from './ladderChart';
+export type { LadderChartDatum, LadderChartConfig, LadderChartMargins, LadderChartInstance, } from './types';

package/dist/components/ladderChart/ladderChart.d.ts

@@ -0,0 +1,2 @@
+import { LadderChartConfig, LadderChartInstance } from './types';
+export declare function buildLadderChart(container: HTMLElement, initialConfig: LadderChartConfig): LadderChartInstance;

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

@@ -0,0 +1,72 @@
+/**
+ * LadderChart — public types.
+ *
+ * Visualizes a player's (or any subject's) ordinal progression across a
+ * time series. Each datum places a mark at (date, rung), connected
+ * chronologically by an optional line.
+ *
+ * Originally a D3v3 "Ladder chart" in tennisvisuals. Rewritten for
+ * D3v7 + TypeScript + the courthive-components vanilla-component
+ * pattern (returns SVG element via factory function; no framework).
+ */
+export interface LadderChartDatum {
+    /** Mark X position. Pass a Date or an ISO-8601 string. */
+    date: Date | string;
+    /** Mark Y position: 0-based index into `rungs[]`. 0 is the bottom rung. */
+    rung: number;
+    /** Optional mark color override (CSS color string). Falls back to `markColor`. */
+    color?: string;
+    /** Optional mark radius override (px). Falls back to `markRadius`. */
+    radius?: number;
+    /** Optional label for the mark (used in tooltip/aria). Examples: tournament name. */
+    label?: string;
+    /** Optional secondary label (used in tooltip body). Examples: result string. */
+    detail?: string;
+    /** Arbitrary attached data, forwarded to onClick/onHover callbacks. */
+    meta?: Record<string, unknown>;
+}
+export interface LadderChartMargins {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
+export interface LadderChartConfig {
+    /** Ordinal rung labels, ordered bottom → top. Example: ['R128','R64','R32','R16','QF','SF','F','W']. */
+    rungs: string[];
+    /** Mark data. May be unsorted; the renderer sorts by date for the connector. */
+    data: LadderChartDatum[];
+    /** Chart width in px. Defaults to container's clientWidth (or 600). */
+    width?: number;
+    /** Chart height in px. Defaults to 240. */
+    height?: number;
+    margins?: LadderChartMargins;
+    /** Optional chart title rendered above the plot. */
+    title?: string;
+    /** Optional subtitle / source text rendered below the plot. */
+    source?: string;
+    /** Draw a connector line between marks in chronological order. Default: true. */
+    showConnector?: boolean;
+    /** Default mark color when datum has no `color` override. Default: `var(--sp-accent)` → `#3366cc`. */
+    markColor?: string;
+    /** Default mark radius in px when datum has no `radius`. Default: 6. */
+    markRadius?: number;
+    /** Connector line color. Default: `var(--sp-muted)` → `#94a3b8`. */
+    connectorColor?: string;
+    /** X-axis date format token (d3-time-format). Auto-selected if absent. */
+    xTickFormat?: string;
+    /** Maximum number of X-axis ticks. Default: 8. */
+    xMaxTicks?: number;
+    /** Click handler for a mark. */
+    onMarkClick?: (datum: LadderChartDatum, event: MouseEvent) => void;
+    /** Hover handler; receives null when the cursor leaves all marks. */
+    onMarkHover?: (datum: LadderChartDatum | null, event: MouseEvent | null) => void;
+}
+export interface LadderChartInstance {
+    /** The mounted SVG element (already inside the container). */
+    element: SVGSVGElement;
+    /** Re-render with new partial config (e.g. swap data on player change). */
+    update(next: Partial<LadderChartConfig>): void;
+    /** Remove the chart from its parent + detach listeners. */
+    destroy(): void;
+}

package/dist/components/policy-catalog/engine/policyCatalogStore.d.ts

@@ -10,6 +10,7 @@ export declare class PolicyCatalogStore {
     setCatalogGroupBy(mode: CatalogGroupBy): void;
     selectPolicy(id: string): void;
     clearSelection(): void;
+    renamePolicy(name: string): void;
     updateEditorDraft(data: Record<string, unknown>): void;
     markDirty(): void;
     markClean(): void;
@@ -18,8 +19,18 @@ export declare class PolicyCatalogStore {
     applyPolicy(): void;
     addNewPolicy(policyType: string): string;
     duplicatePolicy(sourceId: string): string | null;
+    /**
+     * Swap a placeholder id (returned from addNewPolicy/duplicatePolicy) for a
+     * canonical id assigned by the persistence backend. Idempotent and a no-op
+     * when the placeholder is gone (e.g. user deleted before reconciliation).
+     */
+    reconcilePolicyId(localId: string, serverId: string): void;
     deletePolicy(id: string): void;
     subscribe(listener: PolicyCatalogChangeListener): () => void;
     private setState;
     private emit;
+    private localIdCounter;
+    private nextLocalId;
+    private appendAndSelect;
+    private runCreateAndReconcile;
 }

package/dist/components/policy-catalog/types.d.ts

@@ -25,6 +25,12 @@ export interface PolicyCatalogState {
     groupBy: CatalogGroupBy;
     selectedId: string | null;
     editorDraft: Record<string, unknown> | null;
+    /**
+     * Live name buffer for the selected policy. Populated on selection from the
+     * catalog item and mutated by the rename input so renames survive across
+     * editor remounts. `savePolicy` writes this back to the catalog item.
+     */
+    editedName: string | null;
     dirty: boolean;
 }
 export type PolicyCatalogChangeListener = (state: PolicyCatalogState) => void;
@@ -47,7 +53,13 @@ export interface PolicyCatalogConfig {
     editorPlugins?: PolicyEditorPlugin[];
     onPolicySaved?: (item: PolicyCatalogItem) => void;
     onPolicyApplied?: (item: PolicyCatalogItem) => void;
-    onPolicyCreated?: (item: PolicyCatalogItem) => void;
+    /**
+     * Fired when "+" creates a new policy. If the host persists the new policy
+     * to a backend that mints its own canonical id, return that id (sync or
+     * Promise) — the store will reconcile the local placeholder id so subsequent
+     * Save calls hit the right backend record. Return void to keep the local id.
+     */
+    onPolicyCreated?: (item: PolicyCatalogItem) => string | void | Promise<string | void>;
     onPolicyDeleted?: (id: string) => void;
     onSelectionChanged?: (item: PolicyCatalogItem | null) => void;
 }

package/dist/components/policy-catalog/ui/editorShell.d.ts

@@ -4,6 +4,7 @@ export interface EditorShellCallbacks {
     onReset: () => void;
     onApply: () => void;
     onDuplicate: () => void;
+    onRename: (name: string) => void;
 }
 export interface EditorShellPanel extends UIPanel<PolicyCatalogState> {
     bodyElement: HTMLElement;

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

@@ -18,6 +18,7 @@ export declare const tcFooterStyle: () => string;
 export declare const tcFeeBadgeStyle: () => string;
 export declare const tcPlayerCountStyle: () => string;
 export declare const tcEventCountStyle: () => string;
+export declare const tcTierBadgeStyle: () => string;
 export declare const tcSkeletonStyle: () => string;
 export declare const tcSkeletonLineStyle: () => string;
 export declare const tcSkeletonBlockStyle: () => string;

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

@@ -4,6 +4,23 @@ export interface TournamentStatusPill {
     kind: TournamentStatusKind;
     label: string;
 }
+/**
+ * Federation-specific competitive tier. Mirrors the factory's
+ * `TierClassification` shape (kept in lockstep but duplicated here to
+ * avoid pulling tods-competition-factory into the component's runtime
+ * dependency graph).
+ *
+ * - `system`: federation namespace, e.g. `'ITF_JUNIOR'`, `'ATP'`, `'PPA'`.
+ * - `value`: the tier within that system, e.g. `'J500'`, `'Masters 1000'`, `'Gold'`.
+ * - `numericRank`: optional sort key — lower = more prestigious. Used by
+ *   the card / table column to sort tournaments without round-tripping
+ *   through a ranking policy.
+ */
+export interface TierClassification {
+    system: string;
+    value: string;
+    numericRank?: number;
+}
 export interface TournamentEntryFee {
     amount: number;
     currencyCode?: string;
@@ -39,8 +56,16 @@ export interface TournamentCardData {
     updatedAt?: string;
     /** When true, render an offline/local indicator */
     offline?: boolean;
+    /**
+     * Competitive tier classification (federation-specific). When present
+     * and the `'tier'` field is in `TournamentCardConfig.body` (default), the
+     * card renders a small chip displaying `tournamentTier.value`. The
+     * Tabulator list view sorts on `numericRank` ascending with `value`
+     * lex fallback.
+     */
+    tournamentTier?: TierClassification;
 }
-export type TournamentCardField = 'title' | 'location' | 'dateRange' | 'feeBadge' | 'playerCount' | 'eventCount' | 'organizerName' | 'updatedAt';
+export type TournamentCardField = 'title' | 'tier' | 'location' | 'dateRange' | 'feeBadge' | 'playerCount' | 'eventCount' | 'organizerName' | 'updatedAt';
 export type TournamentCardCornerField = 'status' | 'offline';
 export interface TournamentCardConfig {
     /** Whether to render the image zone. Defaults to true. */