types.d.ts

// shim
import { DataItem } from "vis-timeline";

export interface Marker {
	start: string;
	content: string;
}

interface ChronosDataItem extends DataItem {
	cDescription?: string; // prefixed c for chronos - special prop for event tooltips
	cLink?: string; // optional link
	align?: "left" | "center" | "right";
}

export interface ChronosDataSetDataItem {
	content: string;
	start: Date;
	end: Date;
	cDescription?: string; // prefixed c for chronos - special prop for event tooltips
}

export interface ChronosPluginSettings {
	key?: string; // LEGACY - DEPRECATED
	aiKeys?: Record<string, string>; // LEGACY - DEPRECATED
	selectedLocale: string;
	aiProvider?: string;
	openaiSecretName?: string;
	geminiSecretName?: string;
	aiModels?: Record<string, string>;
	align: "left" | "center" | "right";
	clickToUse: boolean;
	roundRanges: boolean;
	useUtc: boolean;
	useAI: boolean;
	lastSeenVersion?: string;
	showChangelogOnUpdate?: boolean;
	enableCaching?: boolean;
}

export type Group = { id: number; content: string };

export type Flags = {
	orderBy?: string[];
	defaultView?: {
		start?: string;
		end?: string;
	};
	noToday?: boolean;
	height?: number;
};

export interface ParseResult {
	items: ChronosDataItem[];
	markers: Marker[];
	groups: Group[];
	flags: Flags;
}

interface ConstructItemParams {
	content: string;
	start: string;
	separator: string | undefined;
	end: string | undefined;
	groupName: string | undefined;
	color: string | undefined;
	lineNumber: number;
	type: "default" | "background" | "point";
	cLink?: string;
}

interface ChronosTimelineConstructor {
	container: HTMLElement;
	settings: ChronosPluginSettings;
}

declare module "vis-timeline" {
	/** Add method override bc this method exists and is documented, but not registered in type definitions from library */
	interface Timeline {
		setCustomTimeMarker(content: string, id: string, show: boolean): void;
	}
}