@principal-ai/principal-view-core 0.26.12 → 0.26.14

package/dist/dashboard/DashboardValidator.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Dashboard File Validator
+ *
+ * Validates dashboard definition files (.dashboard.json) that define metrics,
+ * layout, and data sources for observability dashboards.
+ */
+import type { DashboardDefinition } from '../types/dashboard';
+/**
+ * Validation error details
+ */
+export interface DashboardValidationError {
+    path: string;
+    message: string;
+    severity: 'error' | 'warning';
+    suggestion?: string;
+}
+/**
+ * Validation result
+ */
+export interface DashboardValidationResult {
+    valid: boolean;
+    errors: DashboardValidationError[];
+    warnings: DashboardValidationError[];
+}
+/**
+ * Context for cross-reference validation (optional)
+ */
+export interface DashboardValidationContext {
+    /** Known storyboard names for source validation */
+    storyboards?: string[];
+    /** Known workflow names per storyboard */
+    workflows?: Record<string, string[]>;
+    /** Known event names */
+    events?: string[];
+}
+/**
+ * Validator for dashboard definition files
+ */
+export declare class DashboardValidator {
+    /**
+     * Validate dashboard definition structure
+     */
+    validate(data: unknown, filePath?: string, context?: DashboardValidationContext): DashboardValidationResult;
+    /**
+     * Validate a single metric definition
+     */
+    private validateMetric;
+    /**
+     * Validate a metric source
+     */
+    private validateSource;
+    /**
+     * Validate a metric query
+     */
+    private validateQuery;
+    /**
+     * Validate metric display options
+     */
+    private validateDisplay;
+    /**
+     * Validate dashboard layout
+     */
+    private validateLayout;
+    /**
+     * Validate a layout row
+     */
+    private validateRow;
+    /**
+     * Validate a panel placement
+     */
+    private validatePanel;
+    /**
+     * Validate and throw if invalid
+     */
+    validateOrThrow(data: unknown, filePath?: string, context?: DashboardValidationContext): DashboardDefinition;
+    /**
+     * Format validation result as human-readable report
+     */
+    formatReport(result: DashboardValidationResult): string;
+}
+/**
+ * Create a new dashboard validator instance
+ */
+export declare function createDashboardValidator(): DashboardValidator;
+//# sourceMappingURL=DashboardValidator.d.ts.map

package/dist/dashboard/DashboardValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DashboardValidator.d.ts","sourceRoot":"","sources":["../../src/dashboard/DashboardValidator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EAYpB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAqCD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B;;OAEG;IACH,QAAQ,CACN,IAAI,EAAE,OAAO,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,0BAA0B,GACnC,yBAAyB;IAmJ5B;;OAEG;IACH,OAAO,CAAC,cAAc;IA+JtB;;OAEG;IACH,OAAO,CAAC,cAAc;IA0GtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkErB;;OAEG;IACH,OAAO,CAAC,eAAe;IAsCvB;;OAEG;IACH,OAAO,CAAC,cAAc;IA2DtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAwDnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqFrB;;OAEG;IACH,eAAe,CACb,IAAI,EAAE,OAAO,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,0BAA0B,GACnC,mBAAmB;IAatB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM;CAkCxD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D"}