bbdata-cli 0.2.0 → 0.3.0

package/dist/src/index.d.ts

@@ -71,6 +71,51 @@ interface ValidationResult {
  */
 declare function report(options: ReportOptions): Promise<ReportResult>;
 
+type ChartType = 'movement' | 'spray' | 'zone' | 'rolling';
+type VizFormat = 'svg' | 'png' | 'pdf' | 'html';
+/**
+ * Audience vocabulary for visualization styling.
+ * This is a superset of the report Audience type. The report layer uses
+ * 'gm'/'scout' as role labels; the viz layer uses 'frontoffice'/'presentation'
+ * as presentation-style labels. `resolveVizAudience` maps between them.
+ */
+type VizAudience = 'coach' | 'analyst' | 'frontoffice' | 'presentation';
+interface VizOptions {
+    type: ChartType;
+    player?: string;
+    players?: string[];
+    season?: number;
+    audience?: Audience | VizAudience;
+    format?: VizFormat;
+    width?: number;
+    height?: number;
+    colorblind?: boolean;
+    output?: string;
+    source?: string;
+    stdin?: boolean;
+    cache?: boolean;
+    title?: string;
+}
+interface VizResult {
+    svg: string;
+    spec: object;
+    meta: {
+        chartType: ChartType;
+        player: string;
+        season: number;
+        audience: VizAudience;
+        rowCount: number;
+        source: string;
+        width: number;
+        height: number;
+    };
+}
+
+/**
+ * Programmatic API — skills and agents call this directly.
+ */
+declare function viz(options: VizOptions): Promise<VizResult>;
+
 declare const ConfigSchema: z.ZodObject<{
     defaultTeam: z.ZodOptional<z.ZodString>;
     defaultFormat: z.ZodDefault<z.ZodEnum<["json", "table", "csv", "markdown"]>>;
@@ -225,6 +270,8 @@ declare const PitchDataSchema: z.ZodObject<{
     plate_z: z.ZodNumber;
     launch_speed: z.ZodNullable<z.ZodNumber>;
     launch_angle: z.ZodNullable<z.ZodNumber>;
+    hc_x: z.ZodNullable<z.ZodNumber>;
+    hc_y: z.ZodNullable<z.ZodNumber>;
     description: z.ZodString;
     events: z.ZodNullable<z.ZodString>;
     bb_type: z.ZodNullable<z.ZodString>;
@@ -247,6 +294,8 @@ declare const PitchDataSchema: z.ZodObject<{
     plate_z: number;
     launch_speed: number | null;
     launch_angle: number | null;
+    hc_x: number | null;
+    hc_y: number | null;
     description: string;
     events: string | null;
     bb_type: string | null;
@@ -269,6 +318,8 @@ declare const PitchDataSchema: z.ZodObject<{
     plate_z: number;
     launch_speed: number | null;
     launch_angle: number | null;
+    hc_x: number | null;
+    hc_y: number | null;
     description: string;
     events: string | null;
     bb_type: string | null;
@@ -346,4 +397,4 @@ interface DataAdapter {
     resolvePlayer(name: string): Promise<PlayerId | null>;
 }
 
-export { type AdapterQuery, type BbdataConfig, type DataAdapter, type OutputFormat, type PitchData, type PlayerStats, type QueryOptions, type QueryResult, type ReportOptions, type ReportResult, getConfig, query, report, setConfig };
+export { type AdapterQuery, type BbdataConfig, type ChartType, type DataAdapter, type OutputFormat, type PitchData, type PlayerStats, type QueryOptions, type QueryResult, type ReportOptions, type ReportResult, type VizAudience, type VizOptions, type VizResult, getConfig, query, report, setConfig, viz };