bbdata-cli 0.1.1 → 0.3.0

package/dist/src/index.d.ts

@@ -17,6 +17,7 @@ interface QueryOptions {
     format?: OutputFormat;
     source?: string;
     cache?: boolean;
+    stdin?: boolean;
 }
 interface QueryResult {
     data: Record<string, unknown>[];
@@ -44,6 +45,7 @@ interface ReportOptions {
     audience?: Audience;
     format?: 'markdown' | 'json';
     validate?: boolean;
+    stdin?: boolean;
 }
 interface ReportResult {
     content: string;
@@ -69,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"]>>;
@@ -207,7 +254,7 @@ type BbdataConfig = z.infer<typeof ConfigSchema>;
 declare function getConfig(): BbdataConfig;
 declare function setConfig(updates: Partial<BbdataConfig>): BbdataConfig;
 
-type DataSource = 'savant' | 'fangraphs' | 'mlb-stats-api' | 'baseball-reference';
+type DataSource = 'savant' | 'fangraphs' | 'mlb-stats-api' | 'baseball-reference' | 'stdin';
 declare const PitchDataSchema: z.ZodObject<{
     pitcher_id: z.ZodString;
     pitcher_name: z.ZodString;
@@ -223,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>;
@@ -245,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;
@@ -267,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;
@@ -344,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 };