Every analytics tool wants a subscription. And your data. I built Twiligent instead. YouTube stats. Instagram stats. One dashboard. Runs locally on your machine.
// Ranking for the command palette. Pure so it can be unit tested without a DOM.
// the command fields ranking and grouping read; callers add their own
export interface SearchCommand {
label: string;
group?: string;
keywords?: string[];
}
export interface CommandGroup<T extends SearchCommand> {
group: string;
items: T[];
}
function normalize(text: string | null | undefined): string {
return String(text || '').toLowerCase().normalize('NFKD').replace(/[̀-ͯ]/g, '').trim();
}
// Higher is better; 0 means no match. Every query word must appear in the label or keywords.
export function scoreCommand(command: SearchCommand, query: string): number {
const needle = normalize(query);
if (!needle) return 1;
const label = normalize(command.label);
const haystack = `${label} ${normalize(command.group)} ${(command.keywords || []).map(normalize).join(' ')}`;
const words = needle.split(/\s+/);
if (!words.every(w => haystack.includes(w))) return 0;
if (label === needle) return 100;
if (label.startsWith(needle)) return 80;
if (label.split(/\s+/).some(part => part.startsWith(words[0]))) return 60;
if (label.includes(needle)) return 40;
return 20;
}
export function filterCommands<T extends SearchCommand>(commands: T[], query: string, limit = 50): T[] {
return commands
.map((command, index) => ({ command, index, score: scoreCommand(command, query) }))
.filter(entry => entry.score > 0)
.sort((a, b) => b.score - a.score || a.index - b.index)
.slice(0, limit)
.map(entry => entry.command);
}
// Groups in first-seen order so the palette keeps a stable layout while typing
export function groupCommands<T extends SearchCommand>(commands: T[]): CommandGroup<T>[] {
const groups = new Map<string, T[]>();
for (const command of commands) {
const key = command.group || 'Other';
if (!groups.has(key)) groups.set(key, []);
groups.get(key)!.push(command);
}
return [...groups.entries()].map(([group, items]) => ({ group, items }));
}