v5.1.0 (#2970)

* chore(release): v5.1.0

* feat: implement resume thumbnails

* fix: remove unused mcp tools

* docs: fix formatting of docs

packages/utils/src/date.ts

@@ -0,0 +1,57 @@
+const MONTH_NAMES = [
+	"January",
+	"February",
+	"March",
+	"April",
+	"May",
+	"June",
+	"July",
+	"August",
+	"September",
+	"October",
+	"November",
+	"December",
+];
+
+/**
+ * Formats a partial ISO 8601 date string (YYYY, YYYY-MM, or YYYY-MM-DD)
+ * into a human-readable format like "January 2024" or "January 15, 2024".
+ */
+export function formatDate(date: string, includeDay = false): string {
+	const parts = date.split("-");
+
+	if (parts.length >= 2) {
+		const [year, month] = parts;
+		const monthName = MONTH_NAMES[Number.parseInt(month ?? "1", 10) - 1];
+
+		if (parts.length === 3 && includeDay) {
+			return `${monthName} ${parts[2]}, ${year}`;
+		}
+
+		return `${monthName} ${year}`;
+	}
+
+	// YYYY only
+	return date;
+}
+
+/**
+ * Formats a date range from start and end dates.
+ * Returns "Start - End", "Start - Present" if no end, or just the end date if no start.
+ */
+export function formatPeriod(startDate?: string, endDate?: string): string {
+	if (!startDate && !endDate) return "";
+	if (!startDate) return endDate || "";
+	if (!endDate) return `${formatDate(startDate)} - Present`;
+
+	return `${formatDate(startDate)} - ${formatDate(endDate)}`;
+}
+
+/**
+ * Formats a single date with day included (e.g., "January 15, 2024").
+ * Falls back to month-year or year-only for partial dates.
+ */
+export function formatSingleDate(date?: string): string {
+	if (!date) return "";
+	return formatDate(date, true);
+}