96 lines
3.0 KiB
TypeScript
96 lines
3.0 KiB
TypeScript
/**
|
|
* Utility functions for report identification and helpers.
|
|
* Extracted for testability.
|
|
*/
|
|
|
|
/** Check if a filename is a report file (.report.json). */
|
|
export function isReportFile(filename: string): boolean {
|
|
return filename.endsWith(".report.json");
|
|
}
|
|
|
|
/**
|
|
* Classify a file's type for the tree display.
|
|
* Returns "report", "database", "document", or "file".
|
|
*/
|
|
export function classifyFileType(
|
|
name: string,
|
|
isDatabaseFile: (n: string) => boolean,
|
|
): "report" | "database" | "document" | "file" {
|
|
if (isReportFile(name)) {return "report";}
|
|
if (isDatabaseFile(name)) {return "database";}
|
|
const ext = name.split(".").pop()?.toLowerCase();
|
|
if (ext === "md" || ext === "mdx") {return "document";}
|
|
return "file";
|
|
}
|
|
|
|
/**
|
|
* Generate a slug from a report title for use as a filename.
|
|
*/
|
|
export function reportTitleToSlug(title: string): string {
|
|
return title
|
|
.toLowerCase()
|
|
.replace(/[^a-z0-9]+/g, "-")
|
|
.replace(/^-+|-+$/g, "")
|
|
.slice(0, 40);
|
|
}
|
|
|
|
/**
|
|
* Determine the CSS grid column span class for a panel size.
|
|
*/
|
|
export function panelColSpan(size?: string): string {
|
|
switch (size) {
|
|
case "full":
|
|
return "col-span-6";
|
|
case "third":
|
|
return "col-span-2";
|
|
case "half":
|
|
default:
|
|
return "col-span-3";
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Format a numeric value for chart display.
|
|
*/
|
|
export function formatChartValue(val: unknown): string {
|
|
if (val === null || val === undefined) {return "";}
|
|
if (typeof val === "number") {
|
|
if (Math.abs(val) >= 1_000_000) {return `${(val / 1_000_000).toFixed(1)}M`;}
|
|
if (Math.abs(val) >= 1_000) {return `${(val / 1_000).toFixed(1)}K`;}
|
|
return Number.isInteger(val) ? String(val) : val.toFixed(2);
|
|
}
|
|
return String(val);
|
|
}
|
|
|
|
/**
|
|
* Format a label for chart display (truncates long strings, shortens dates).
|
|
*/
|
|
export function formatChartLabel(val: unknown): string {
|
|
if (val === null || val === undefined) {return "";}
|
|
const str = String(val);
|
|
if (str.length > 16 && !isNaN(Date.parse(str))) {
|
|
return str.slice(0, 10);
|
|
}
|
|
if (str.length > 20) {return str.slice(0, 18) + "...";}
|
|
return str;
|
|
}
|
|
|
|
/**
|
|
* Validate a report config structure. Returns error message or null if valid.
|
|
*/
|
|
export function validateReportConfig(config: unknown): string | null {
|
|
if (!config || typeof config !== "object") {return "Config must be an object";}
|
|
const c = config as Record<string, unknown>;
|
|
if (typeof c.title !== "string" || !c.title) {return "Missing title";}
|
|
if (!Array.isArray(c.panels)) {return "panels must be an array";}
|
|
for (let i = 0; i < c.panels.length; i++) {
|
|
const p = c.panels[i] as Record<string, unknown>;
|
|
if (!p.id || typeof p.id !== "string") {return `Panel ${i}: missing id`;}
|
|
if (!p.title || typeof p.title !== "string") {return `Panel ${i}: missing title`;}
|
|
if (!p.type || typeof p.type !== "string") {return `Panel ${i}: missing type`;}
|
|
if (!p.sql || typeof p.sql !== "string") {return `Panel ${i}: missing sql`;}
|
|
if (!p.mapping || typeof p.mapping !== "object") {return `Panel ${i}: missing mapping`;}
|
|
}
|
|
return null;
|
|
}
|