@mrck-labs/vanaheim-shared 0.4.0 → 0.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/date/index.d.mts +16 -3
- package/dist/date/index.d.ts +16 -3
- package/dist/date/index.js +48 -6
- package/dist/date/index.js.map +1 -1
- package/dist/date/index.mjs +46 -6
- package/dist/date/index.mjs.map +1 -1
- package/dist/index.d.mts +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +48 -6
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +46 -6
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/dist/date/index.d.mts
CHANGED
|
@@ -101,6 +101,19 @@ declare function getWeekStartString(baseDate?: Date): string;
|
|
|
101
101
|
* Get end of week (Sunday) as date string
|
|
102
102
|
*/
|
|
103
103
|
declare function getWeekEndString(baseDate?: Date): string;
|
|
104
|
+
/**
|
|
105
|
+
* Get all dates in a week as an array of date strings
|
|
106
|
+
* @param weekStart - Start of the week (Monday) in YYYY-MM-DD format
|
|
107
|
+
* @returns Array of 7 date strings from Monday to Sunday
|
|
108
|
+
* @example getWeekDates("2024-12-16") => ["2024-12-16", "2024-12-17", ..., "2024-12-22"]
|
|
109
|
+
*/
|
|
110
|
+
declare function getWeekDates(weekStart: string): string[];
|
|
111
|
+
/**
|
|
112
|
+
* Get all dates in a week as Date objects
|
|
113
|
+
* @param weekStart - Start of the week (Monday) as Date
|
|
114
|
+
* @returns Array of 7 Date objects from Monday to Sunday
|
|
115
|
+
*/
|
|
116
|
+
declare function getWeekDatesAsObjects(weekStart: Date): Date[];
|
|
104
117
|
/**
|
|
105
118
|
* Format a week range for display
|
|
106
119
|
* @example "Dec 2 - 8, 2024" or "Nov 25 - Dec 1, 2024"
|
|
@@ -176,8 +189,8 @@ declare function formatRelativeDueDate(dateStr: string, options?: {
|
|
|
176
189
|
* @example "Today", "Tomorrow", "In 3 days", "2 days ago"
|
|
177
190
|
*/
|
|
178
191
|
declare function formatRelativePayDate(dateStr: string): string;
|
|
179
|
-
type DateFormat =
|
|
180
|
-
type TimeFormat =
|
|
192
|
+
type DateFormat = "short" | "medium" | "long" | "weekday";
|
|
193
|
+
type TimeFormat = "short" | "withSeconds";
|
|
181
194
|
/**
|
|
182
195
|
* Format a date with various preset formats
|
|
183
196
|
*/
|
|
@@ -187,4 +200,4 @@ declare function formatDateLocalized(date: Date | string, format?: DateFormat):
|
|
|
187
200
|
*/
|
|
188
201
|
declare function formatTimeLocalized(date: Date | string, format?: TimeFormat): string;
|
|
189
202
|
|
|
190
|
-
export { type DateFormat, type TimeFormat, addDays, formatDateDisplay, formatDateHeader, formatDateLocalized, formatDateLong, formatDateString, formatDueDateString, formatFullDate, formatMonthYear, formatRelativeDueDate, formatRelativePayDate, formatRelativeTimeExtended, formatTimeHHMM, formatTimeLocalized, formatTimeShort, formatTimeWithSeconds, formatWeekRange, getEndOfDayISO, getNextWeek, getPreviousWeek, getStartOfDayISO, getTodayMidnight, getTodayString, getTomorrowString, getWeekEnd, getWeekEndString, getWeekStart, getWeekStartString, getYesterdayString, isDueSoon, isOverdue, isToday, normalizeToMidnight, parseLocalDate, subtractDays };
|
|
203
|
+
export { type DateFormat, type TimeFormat, addDays, formatDateDisplay, formatDateHeader, formatDateLocalized, formatDateLong, formatDateString, formatDueDateString, formatFullDate, formatMonthYear, formatRelativeDueDate, formatRelativePayDate, formatRelativeTimeExtended, formatTimeHHMM, formatTimeLocalized, formatTimeShort, formatTimeWithSeconds, formatWeekRange, getEndOfDayISO, getNextWeek, getPreviousWeek, getStartOfDayISO, getTodayMidnight, getTodayString, getTomorrowString, getWeekDates, getWeekDatesAsObjects, getWeekEnd, getWeekEndString, getWeekStart, getWeekStartString, getYesterdayString, isDueSoon, isOverdue, isToday, normalizeToMidnight, parseLocalDate, subtractDays };
|
package/dist/date/index.d.ts
CHANGED
|
@@ -101,6 +101,19 @@ declare function getWeekStartString(baseDate?: Date): string;
|
|
|
101
101
|
* Get end of week (Sunday) as date string
|
|
102
102
|
*/
|
|
103
103
|
declare function getWeekEndString(baseDate?: Date): string;
|
|
104
|
+
/**
|
|
105
|
+
* Get all dates in a week as an array of date strings
|
|
106
|
+
* @param weekStart - Start of the week (Monday) in YYYY-MM-DD format
|
|
107
|
+
* @returns Array of 7 date strings from Monday to Sunday
|
|
108
|
+
* @example getWeekDates("2024-12-16") => ["2024-12-16", "2024-12-17", ..., "2024-12-22"]
|
|
109
|
+
*/
|
|
110
|
+
declare function getWeekDates(weekStart: string): string[];
|
|
111
|
+
/**
|
|
112
|
+
* Get all dates in a week as Date objects
|
|
113
|
+
* @param weekStart - Start of the week (Monday) as Date
|
|
114
|
+
* @returns Array of 7 Date objects from Monday to Sunday
|
|
115
|
+
*/
|
|
116
|
+
declare function getWeekDatesAsObjects(weekStart: Date): Date[];
|
|
104
117
|
/**
|
|
105
118
|
* Format a week range for display
|
|
106
119
|
* @example "Dec 2 - 8, 2024" or "Nov 25 - Dec 1, 2024"
|
|
@@ -176,8 +189,8 @@ declare function formatRelativeDueDate(dateStr: string, options?: {
|
|
|
176
189
|
* @example "Today", "Tomorrow", "In 3 days", "2 days ago"
|
|
177
190
|
*/
|
|
178
191
|
declare function formatRelativePayDate(dateStr: string): string;
|
|
179
|
-
type DateFormat =
|
|
180
|
-
type TimeFormat =
|
|
192
|
+
type DateFormat = "short" | "medium" | "long" | "weekday";
|
|
193
|
+
type TimeFormat = "short" | "withSeconds";
|
|
181
194
|
/**
|
|
182
195
|
* Format a date with various preset formats
|
|
183
196
|
*/
|
|
@@ -187,4 +200,4 @@ declare function formatDateLocalized(date: Date | string, format?: DateFormat):
|
|
|
187
200
|
*/
|
|
188
201
|
declare function formatTimeLocalized(date: Date | string, format?: TimeFormat): string;
|
|
189
202
|
|
|
190
|
-
export { type DateFormat, type TimeFormat, addDays, formatDateDisplay, formatDateHeader, formatDateLocalized, formatDateLong, formatDateString, formatDueDateString, formatFullDate, formatMonthYear, formatRelativeDueDate, formatRelativePayDate, formatRelativeTimeExtended, formatTimeHHMM, formatTimeLocalized, formatTimeShort, formatTimeWithSeconds, formatWeekRange, getEndOfDayISO, getNextWeek, getPreviousWeek, getStartOfDayISO, getTodayMidnight, getTodayString, getTomorrowString, getWeekEnd, getWeekEndString, getWeekStart, getWeekStartString, getYesterdayString, isDueSoon, isOverdue, isToday, normalizeToMidnight, parseLocalDate, subtractDays };
|
|
203
|
+
export { type DateFormat, type TimeFormat, addDays, formatDateDisplay, formatDateHeader, formatDateLocalized, formatDateLong, formatDateString, formatDueDateString, formatFullDate, formatMonthYear, formatRelativeDueDate, formatRelativePayDate, formatRelativeTimeExtended, formatTimeHHMM, formatTimeLocalized, formatTimeShort, formatTimeWithSeconds, formatWeekRange, getEndOfDayISO, getNextWeek, getPreviousWeek, getStartOfDayISO, getTodayMidnight, getTodayString, getTomorrowString, getWeekDates, getWeekDatesAsObjects, getWeekEnd, getWeekEndString, getWeekStart, getWeekStartString, getYesterdayString, isDueSoon, isOverdue, isToday, normalizeToMidnight, parseLocalDate, subtractDays };
|
package/dist/date/index.js
CHANGED
|
@@ -44,6 +44,8 @@ __export(date_exports, {
|
|
|
44
44
|
getTodayMidnight: () => getTodayMidnight,
|
|
45
45
|
getTodayString: () => getTodayString,
|
|
46
46
|
getTomorrowString: () => getTomorrowString,
|
|
47
|
+
getWeekDates: () => getWeekDates,
|
|
48
|
+
getWeekDatesAsObjects: () => getWeekDatesAsObjects,
|
|
47
49
|
getWeekEnd: () => getWeekEnd,
|
|
48
50
|
getWeekEndString: () => getWeekEndString,
|
|
49
51
|
getWeekStart: () => getWeekStart,
|
|
@@ -66,7 +68,10 @@ function getTodayMidnight() {
|
|
|
66
68
|
return normalizeToMidnight(/* @__PURE__ */ new Date());
|
|
67
69
|
}
|
|
68
70
|
function formatDateString(date) {
|
|
69
|
-
return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(
|
|
71
|
+
return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(
|
|
72
|
+
2,
|
|
73
|
+
"0"
|
|
74
|
+
)}-${String(date.getDate()).padStart(2, "0")}`;
|
|
70
75
|
}
|
|
71
76
|
function getTodayString() {
|
|
72
77
|
return formatDateString(/* @__PURE__ */ new Date());
|
|
@@ -107,7 +112,11 @@ function getTomorrowString() {
|
|
|
107
112
|
}
|
|
108
113
|
function getStartOfDayISO(dateStr) {
|
|
109
114
|
const date = parseLocalDate(dateStr);
|
|
110
|
-
return new Date(
|
|
115
|
+
return new Date(
|
|
116
|
+
date.getFullYear(),
|
|
117
|
+
date.getMonth(),
|
|
118
|
+
date.getDate()
|
|
119
|
+
).toISOString();
|
|
111
120
|
}
|
|
112
121
|
function getEndOfDayISO(dateStr) {
|
|
113
122
|
const date = parseLocalDate(dateStr);
|
|
@@ -150,6 +159,22 @@ function getWeekStartString(baseDate = /* @__PURE__ */ new Date()) {
|
|
|
150
159
|
function getWeekEndString(baseDate = /* @__PURE__ */ new Date()) {
|
|
151
160
|
return formatDateString(getWeekEnd(getWeekStart(baseDate)));
|
|
152
161
|
}
|
|
162
|
+
function getWeekDates(weekStart) {
|
|
163
|
+
const dates = [];
|
|
164
|
+
for (let i = 0; i < 7; i++) {
|
|
165
|
+
dates.push(addDays(weekStart, i));
|
|
166
|
+
}
|
|
167
|
+
return dates;
|
|
168
|
+
}
|
|
169
|
+
function getWeekDatesAsObjects(weekStart) {
|
|
170
|
+
const dates = [];
|
|
171
|
+
for (let i = 0; i < 7; i++) {
|
|
172
|
+
const day = new Date(weekStart);
|
|
173
|
+
day.setDate(day.getDate() + i);
|
|
174
|
+
dates.push(day);
|
|
175
|
+
}
|
|
176
|
+
return dates;
|
|
177
|
+
}
|
|
153
178
|
function formatWeekRange(weekStart) {
|
|
154
179
|
const weekEnd = getWeekEnd(weekStart);
|
|
155
180
|
const startMonth = weekStart.toLocaleDateString("en-US", { month: "short" });
|
|
@@ -199,7 +224,11 @@ function formatDateDisplay(date) {
|
|
|
199
224
|
}
|
|
200
225
|
function formatTimeWithSeconds(date) {
|
|
201
226
|
const d = typeof date === "string" ? new Date(date) : date;
|
|
202
|
-
return d.toLocaleTimeString([], {
|
|
227
|
+
return d.toLocaleTimeString([], {
|
|
228
|
+
hour: "2-digit",
|
|
229
|
+
minute: "2-digit",
|
|
230
|
+
second: "2-digit"
|
|
231
|
+
});
|
|
203
232
|
}
|
|
204
233
|
function formatDateHeader(dateStr) {
|
|
205
234
|
const today = getTodayString();
|
|
@@ -226,7 +255,10 @@ function formatDueDateString(dateStr) {
|
|
|
226
255
|
const tomorrowStr = getTomorrowString();
|
|
227
256
|
if (dateStr < today) {
|
|
228
257
|
const date2 = parseLocalDate(dateStr);
|
|
229
|
-
return `Overdue \u2022 ${date2.toLocaleDateString("en-US", {
|
|
258
|
+
return `Overdue \u2022 ${date2.toLocaleDateString("en-US", {
|
|
259
|
+
month: "short",
|
|
260
|
+
day: "numeric"
|
|
261
|
+
})}`;
|
|
230
262
|
}
|
|
231
263
|
if (dateStr === today) {
|
|
232
264
|
return "Today";
|
|
@@ -291,7 +323,11 @@ function formatDateLocalized(date, format = "medium") {
|
|
|
291
323
|
case "short":
|
|
292
324
|
return d.toLocaleDateString("en-US", { month: "short", day: "numeric" });
|
|
293
325
|
case "medium":
|
|
294
|
-
return d.toLocaleDateString("en-US", {
|
|
326
|
+
return d.toLocaleDateString("en-US", {
|
|
327
|
+
month: "short",
|
|
328
|
+
day: "numeric",
|
|
329
|
+
year: "numeric"
|
|
330
|
+
});
|
|
295
331
|
case "long":
|
|
296
332
|
return d.toLocaleDateString("en-US", {
|
|
297
333
|
weekday: "long",
|
|
@@ -309,7 +345,11 @@ function formatTimeLocalized(date, format = "short") {
|
|
|
309
345
|
const d = typeof date === "string" ? new Date(date) : date;
|
|
310
346
|
switch (format) {
|
|
311
347
|
case "short":
|
|
312
|
-
return d.toLocaleTimeString("en-US", {
|
|
348
|
+
return d.toLocaleTimeString("en-US", {
|
|
349
|
+
hour: "2-digit",
|
|
350
|
+
minute: "2-digit",
|
|
351
|
+
hour12: true
|
|
352
|
+
});
|
|
313
353
|
case "withSeconds":
|
|
314
354
|
return d.toLocaleTimeString("en-US", {
|
|
315
355
|
hour: "2-digit",
|
|
@@ -347,6 +387,8 @@ function formatTimeLocalized(date, format = "short") {
|
|
|
347
387
|
getTodayMidnight,
|
|
348
388
|
getTodayString,
|
|
349
389
|
getTomorrowString,
|
|
390
|
+
getWeekDates,
|
|
391
|
+
getWeekDatesAsObjects,
|
|
350
392
|
getWeekEnd,
|
|
351
393
|
getWeekEndString,
|
|
352
394
|
getWeekStart,
|
package/dist/date/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/date/index.ts"],"sourcesContent":["/**\n * Date Utilities\n *\n * Pure functions for date manipulation and formatting.\n * Works in both Node.js and browser/React Native environments.\n *\n * @example\n * import { getTodayString, addDays, formatRelativeTime } from '@mrck-labs/vanaheim-shared/date'\n *\n * const today = getTodayString() // \"2024-12-16\"\n * const nextWeek = addDays(today, 7) // \"2024-12-23\"\n */\n\n// ============================================================================\n// Core Utilities\n// ============================================================================\n\n/**\n * Normalize a date to midnight (00:00:00.000)\n */\nexport function normalizeToMidnight(date: Date): Date {\n const d = new Date(date)\n d.setHours(0, 0, 0, 0)\n return d\n}\n\n/**\n * Get today's date normalized to midnight\n */\nexport function getTodayMidnight(): Date {\n return normalizeToMidnight(new Date())\n}\n\n/**\n * Format a Date object to YYYY-MM-DD string\n * @example formatDateString(new Date()) => \"2024-12-16\"\n */\nexport function formatDateString(date: Date): string {\n return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}-${String(date.getDate()).padStart(2, '0')}`\n}\n\n/**\n * Get today's local date string (YYYY-MM-DD)\n */\nexport function getTodayString(): string {\n return formatDateString(new Date())\n}\n\n/**\n * Parse a YYYY-MM-DD string to a local Date object\n * Avoids timezone issues by appending T00:00:00\n */\nexport function parseLocalDate(dateStr: string): Date {\n return new Date(dateStr + 'T00:00:00')\n}\n\n// ============================================================================\n// Date Checks\n// ============================================================================\n\n/**\n * Check if a date string is today\n */\nexport function isToday(dateStr: string | null): boolean {\n if (!dateStr) return false\n return dateStr === getTodayString()\n}\n\n/**\n * Check if a date string is in the past (before today)\n */\nexport function isOverdue(dateStr: string | null): boolean {\n if (!dateStr) return false\n return dateStr < getTodayString()\n}\n\n/**\n * Check if a date is due within a threshold of days\n * @param dateStr - Date in YYYY-MM-DD format\n * @param daysThreshold - Number of days to check (default: 7)\n */\nexport function isDueSoon(dateStr: string | null, daysThreshold: number = 7): boolean {\n if (!dateStr) return false\n if (isOverdue(dateStr)) return false\n\n const today = getTodayMidnight()\n const targetDate = parseLocalDate(dateStr)\n const diffMs = targetDate.getTime() - today.getTime()\n const diffDays = Math.ceil(diffMs / (1000 * 60 * 60 * 24))\n\n return diffDays >= 0 && diffDays <= daysThreshold\n}\n\n// ============================================================================\n// Date Arithmetic\n// ============================================================================\n\n/**\n * Add days to a date string\n * @param dateStr - Date in YYYY-MM-DD format\n * @param days - Number of days to add (can be negative)\n * @returns New date string in YYYY-MM-DD format\n */\nexport function addDays(dateStr: string, days: number): string {\n const date = parseLocalDate(dateStr)\n date.setDate(date.getDate() + days)\n return formatDateString(date)\n}\n\n/**\n * Subtract days from a date string\n */\nexport function subtractDays(dateStr: string, days: number): string {\n return addDays(dateStr, -days)\n}\n\n/**\n * Get yesterday's date string (YYYY-MM-DD)\n */\nexport function getYesterdayString(): string {\n return subtractDays(getTodayString(), 1)\n}\n\n/**\n * Get tomorrow's date string (YYYY-MM-DD)\n */\nexport function getTomorrowString(): string {\n return addDays(getTodayString(), 1)\n}\n\n// ============================================================================\n// ISO String Helpers (for database queries)\n// ============================================================================\n\n/**\n * Get start of day as ISO string\n * @param dateStr - Date in YYYY-MM-DD format\n * @returns ISO string like \"2024-12-15T00:00:00.000Z\"\n */\nexport function getStartOfDayISO(dateStr: string): string {\n const date = parseLocalDate(dateStr)\n return new Date(date.getFullYear(), date.getMonth(), date.getDate()).toISOString()\n}\n\n/**\n * Get end of day as ISO string\n * @param dateStr - Date in YYYY-MM-DD format\n * @returns ISO string like \"2024-12-15T23:59:59.999Z\"\n */\nexport function getEndOfDayISO(dateStr: string): string {\n const date = parseLocalDate(dateStr)\n return new Date(\n date.getFullYear(),\n date.getMonth(),\n date.getDate(),\n 23,\n 59,\n 59,\n 999\n ).toISOString()\n}\n\n// ============================================================================\n// Week Utilities\n// ============================================================================\n\n/**\n * Get the start of the week (Monday) for a given date\n */\nexport function getWeekStart(date: Date): Date {\n const d = new Date(date)\n const day = d.getDay()\n const diff = d.getDate() - day + (day === 0 ? -6 : 1) // Monday\n d.setDate(diff)\n d.setHours(0, 0, 0, 0)\n return d\n}\n\n/**\n * Get the end of the week (Sunday) for a given week start\n */\nexport function getWeekEnd(weekStart: Date): Date {\n const d = new Date(weekStart)\n d.setDate(d.getDate() + 6)\n return d\n}\n\n/**\n * Get the start of the previous week\n */\nexport function getPreviousWeek(weekStart: Date): Date {\n const d = new Date(weekStart)\n d.setDate(d.getDate() - 7)\n return d\n}\n\n/**\n * Get the start of the next week\n */\nexport function getNextWeek(weekStart: Date): Date {\n const d = new Date(weekStart)\n d.setDate(d.getDate() + 7)\n return d\n}\n\n/**\n * Get start of week (Monday) as date string\n */\nexport function getWeekStartString(baseDate: Date = new Date()): string {\n return formatDateString(getWeekStart(baseDate))\n}\n\n/**\n * Get end of week (Sunday) as date string\n */\nexport function getWeekEndString(baseDate: Date = new Date()): string {\n return formatDateString(getWeekEnd(getWeekStart(baseDate)))\n}\n\n/**\n * Format a week range for display\n * @example \"Dec 2 - 8, 2024\" or \"Nov 25 - Dec 1, 2024\"\n */\nexport function formatWeekRange(weekStart: Date): string {\n const weekEnd = getWeekEnd(weekStart)\n const startMonth = weekStart.toLocaleDateString('en-US', { month: 'short' })\n const endMonth = weekEnd.toLocaleDateString('en-US', { month: 'short' })\n\n if (startMonth === endMonth) {\n return `${startMonth} ${weekStart.getDate()} - ${weekEnd.getDate()}, ${weekStart.getFullYear()}`\n }\n\n return `${startMonth} ${weekStart.getDate()} - ${endMonth} ${weekEnd.getDate()}, ${weekStart.getFullYear()}`\n}\n\n// ============================================================================\n// Display Formatting\n// ============================================================================\n\n/**\n * Format a date string for display with full weekday\n * @example \"Monday, December 15, 2024\"\n */\nexport function formatFullDate(dateStr: string): string {\n const date = parseLocalDate(dateStr)\n return date.toLocaleDateString('en-US', {\n weekday: 'long',\n year: 'numeric',\n month: 'long',\n day: 'numeric',\n })\n}\n\n/**\n * Format date for display in long form\n * @example \"Monday, 9 December\"\n */\nexport function formatDateLong(dateStr: string): string {\n const date = parseLocalDate(dateStr)\n return date.toLocaleDateString('en-GB', {\n weekday: 'long',\n day: 'numeric',\n month: 'long',\n })\n}\n\n/**\n * Format month and year\n * @example \"December 2024\"\n */\nexport function formatMonthYear(date: Date): string {\n return date.toLocaleDateString('en-US', {\n month: 'long',\n year: 'numeric',\n })\n}\n\n/**\n * Format a date/time to HH:MM format\n * Use this for formatting Date objects or ISO strings to time display\n * @example formatTimeHHMM(new Date()) => \"14:30\"\n *\n * Note: For formatting seconds (e.g., timer display), use formatTime from utils\n */\nexport function formatTimeHHMM(date: Date | string): string {\n const d = typeof date === 'string' ? new Date(date) : date\n return d.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' })\n}\n\n/**\n * Format time in short format (12h without seconds)\n * @example formatTimeShort(new Date()) => \"2:30 PM\"\n */\nexport function formatTimeShort(date: Date | string): string {\n const d = typeof date === 'string' ? new Date(date) : date\n return d.toLocaleTimeString('en-US', { hour: 'numeric', minute: '2-digit' })\n}\n\n/**\n * Format a Date object for display in readable format\n * @example formatDateDisplay(new Date()) => \"Monday, Dec 22\"\n */\nexport function formatDateDisplay(date: Date): string {\n return date.toLocaleDateString('en-US', {\n weekday: 'long',\n month: 'short',\n day: 'numeric',\n })\n}\n\n/**\n * Format a date/time to HH:MM:SS format\n */\nexport function formatTimeWithSeconds(date: Date | string): string {\n const d = typeof date === 'string' ? new Date(date) : date\n return d.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit', second: '2-digit' })\n}\n\n// ============================================================================\n// Contextual Formatting\n// ============================================================================\n\n/**\n * Format a date string for display as a header\n * Returns \"Overdue\", \"Today\", \"Tomorrow\", or formatted date\n */\nexport function formatDateHeader(dateStr: string): string {\n const today = getTodayString()\n\n if (dateStr < today) {\n return 'Overdue'\n }\n\n if (dateStr === today) {\n return 'Today'\n }\n\n const tomorrowStr = getTomorrowString()\n if (dateStr === tomorrowStr) {\n return 'Tomorrow'\n }\n\n const date = parseLocalDate(dateStr)\n return date.toLocaleDateString('en-US', {\n weekday: 'long',\n month: 'short',\n day: 'numeric',\n })\n}\n\n/**\n * Format a due date for display in task items (simple string version)\n * Returns \"Overdue\", \"Today\", \"Tomorrow\", or formatted date\n *\n * Note: For version that returns { text, isOverdue }, use formatDueDate from utils/formatters\n */\nexport function formatDueDateString(dateStr: string | null): string {\n if (!dateStr) return 'No due date'\n\n const today = getTodayString()\n const tomorrowStr = getTomorrowString()\n\n if (dateStr < today) {\n const date = parseLocalDate(dateStr)\n return `Overdue • ${date.toLocaleDateString('en-US', { month: 'short', day: 'numeric' })}`\n }\n\n if (dateStr === today) {\n return 'Today'\n }\n\n if (dateStr === tomorrowStr) {\n return 'Tomorrow'\n }\n\n const date = parseLocalDate(dateStr)\n const currentYear = new Date().getFullYear()\n const dateYear = date.getFullYear()\n\n return date.toLocaleDateString('en-US', {\n month: 'short',\n day: 'numeric',\n year: dateYear !== currentYear ? 'numeric' : undefined,\n })\n}\n\n/**\n * Format a date/time as relative time string (extended version)\n * Accepts both Date objects and ISO strings\n * @example \"Just now\", \"5m ago\", \"2h ago\", \"3d ago\"\n *\n * Note: For simple string input, you can also use formatRelativeTime from utils/formatters\n */\nexport function formatRelativeTimeExtended(dateStr: string | Date): string {\n const date = typeof dateStr === 'string' ? new Date(dateStr) : dateStr\n const now = new Date()\n const diffMs = now.getTime() - date.getTime()\n const diffMins = Math.floor(diffMs / 60000)\n const diffHours = Math.floor(diffMins / 60)\n const diffDays = Math.floor(diffHours / 24)\n\n if (diffMins < 1) return 'Just now'\n if (diffMins < 60) return `${diffMins}m ago`\n if (diffHours < 24) return `${diffHours}h ago`\n if (diffDays < 7) return `${diffDays}d ago`\n return date.toLocaleDateString()\n}\n\n/**\n * Format a due date relative to today with contextual prefix\n * @example \"Due today\", \"Due tomorrow\", \"Due in 3 days\", \"2 days overdue\"\n */\nexport function formatRelativeDueDate(\n dateStr: string,\n options?: {\n duePrefix?: string\n overduePrefix?: string\n }\n): string {\n const { duePrefix = 'Due', overduePrefix = '' } = options || {}\n const date = parseLocalDate(dateStr)\n const now = normalizeToMidnight(new Date())\n\n const diffMs = date.getTime() - now.getTime()\n const diffDays = Math.round(diffMs / (1000 * 60 * 60 * 24))\n\n if (diffDays < 0) {\n const absDays = Math.abs(diffDays)\n return overduePrefix\n ? `${overduePrefix} ${absDays} day${absDays !== 1 ? 's' : ''} overdue`\n : `${absDays} day${absDays !== 1 ? 's' : ''} overdue`\n }\n if (diffDays === 0) return `${duePrefix} today`\n if (diffDays === 1) return `${duePrefix} tomorrow`\n if (diffDays <= 7) return `${duePrefix} in ${diffDays} days`\n\n return date.toLocaleDateString('en-GB', { day: 'numeric', month: 'short' })\n}\n\n/**\n * Format a pay/income date relative to today\n * @example \"Today\", \"Tomorrow\", \"In 3 days\", \"2 days ago\"\n */\nexport function formatRelativePayDate(dateStr: string): string {\n const date = parseLocalDate(dateStr)\n const now = normalizeToMidnight(new Date())\n\n const diffMs = date.getTime() - now.getTime()\n const diffDays = Math.round(diffMs / (1000 * 60 * 60 * 24))\n\n if (diffDays < 0) {\n const absDays = Math.abs(diffDays)\n return `${absDays} day${absDays !== 1 ? 's' : ''} ago`\n }\n if (diffDays === 0) return 'Today'\n if (diffDays === 1) return 'Tomorrow'\n if (diffDays <= 7) return `In ${diffDays} days`\n\n return date.toLocaleDateString('en-GB', { day: 'numeric', month: 'short' })\n}\n\n// ============================================================================\n// Localized Formatting\n// ============================================================================\n\nexport type DateFormat = 'short' | 'medium' | 'long' | 'weekday'\nexport type TimeFormat = 'short' | 'withSeconds'\n\n/**\n * Format a date with various preset formats\n */\nexport function formatDateLocalized(date: Date | string, format: DateFormat = 'medium'): string {\n const d = typeof date === 'string' ? new Date(date) : date\n\n switch (format) {\n case 'short':\n return d.toLocaleDateString('en-US', { month: 'short', day: 'numeric' })\n case 'medium':\n return d.toLocaleDateString('en-US', { month: 'short', day: 'numeric', year: 'numeric' })\n case 'long':\n return d.toLocaleDateString('en-US', {\n weekday: 'long',\n month: 'long',\n day: 'numeric',\n year: 'numeric',\n })\n case 'weekday':\n return d.toLocaleDateString('en-US', { weekday: 'short' })\n default:\n return d.toLocaleDateString()\n }\n}\n\n/**\n * Format a time with various preset formats\n */\nexport function formatTimeLocalized(date: Date | string, format: TimeFormat = 'short'): string {\n const d = typeof date === 'string' ? new Date(date) : date\n\n switch (format) {\n case 'short':\n return d.toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', hour12: true })\n case 'withSeconds':\n return d.toLocaleTimeString('en-US', {\n hour: '2-digit',\n minute: '2-digit',\n second: '2-digit',\n hour12: true,\n })\n default:\n return d.toLocaleTimeString()\n }\n}\n\n"],"mappings":"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","names":["date"]}
|
|
1
|
+
{"version":3,"sources":["../../src/date/index.ts"],"sourcesContent":["/**\n * Date Utilities\n *\n * Pure functions for date manipulation and formatting.\n * Works in both Node.js and browser/React Native environments.\n *\n * @example\n * import { getTodayString, addDays, formatRelativeTime } from '@mrck-labs/vanaheim-shared/date'\n *\n * const today = getTodayString() // \"2024-12-16\"\n * const nextWeek = addDays(today, 7) // \"2024-12-23\"\n */\n\n// ============================================================================\n// Core Utilities\n// ============================================================================\n\n/**\n * Normalize a date to midnight (00:00:00.000)\n */\nexport function normalizeToMidnight(date: Date): Date {\n const d = new Date(date);\n d.setHours(0, 0, 0, 0);\n return d;\n}\n\n/**\n * Get today's date normalized to midnight\n */\nexport function getTodayMidnight(): Date {\n return normalizeToMidnight(new Date());\n}\n\n/**\n * Format a Date object to YYYY-MM-DD string\n * @example formatDateString(new Date()) => \"2024-12-16\"\n */\nexport function formatDateString(date: Date): string {\n return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(\n 2,\n \"0\"\n )}-${String(date.getDate()).padStart(2, \"0\")}`;\n}\n\n/**\n * Get today's local date string (YYYY-MM-DD)\n */\nexport function getTodayString(): string {\n return formatDateString(new Date());\n}\n\n/**\n * Parse a YYYY-MM-DD string to a local Date object\n * Avoids timezone issues by appending T00:00:00\n */\nexport function parseLocalDate(dateStr: string): Date {\n return new Date(dateStr + \"T00:00:00\");\n}\n\n// ============================================================================\n// Date Checks\n// ============================================================================\n\n/**\n * Check if a date string is today\n */\nexport function isToday(dateStr: string | null): boolean {\n if (!dateStr) return false;\n return dateStr === getTodayString();\n}\n\n/**\n * Check if a date string is in the past (before today)\n */\nexport function isOverdue(dateStr: string | null): boolean {\n if (!dateStr) return false;\n return dateStr < getTodayString();\n}\n\n/**\n * Check if a date is due within a threshold of days\n * @param dateStr - Date in YYYY-MM-DD format\n * @param daysThreshold - Number of days to check (default: 7)\n */\nexport function isDueSoon(\n dateStr: string | null,\n daysThreshold: number = 7\n): boolean {\n if (!dateStr) return false;\n if (isOverdue(dateStr)) return false;\n\n const today = getTodayMidnight();\n const targetDate = parseLocalDate(dateStr);\n const diffMs = targetDate.getTime() - today.getTime();\n const diffDays = Math.ceil(diffMs / (1000 * 60 * 60 * 24));\n\n return diffDays >= 0 && diffDays <= daysThreshold;\n}\n\n// ============================================================================\n// Date Arithmetic\n// ============================================================================\n\n/**\n * Add days to a date string\n * @param dateStr - Date in YYYY-MM-DD format\n * @param days - Number of days to add (can be negative)\n * @returns New date string in YYYY-MM-DD format\n */\nexport function addDays(dateStr: string, days: number): string {\n const date = parseLocalDate(dateStr);\n date.setDate(date.getDate() + days);\n return formatDateString(date);\n}\n\n/**\n * Subtract days from a date string\n */\nexport function subtractDays(dateStr: string, days: number): string {\n return addDays(dateStr, -days);\n}\n\n/**\n * Get yesterday's date string (YYYY-MM-DD)\n */\nexport function getYesterdayString(): string {\n return subtractDays(getTodayString(), 1);\n}\n\n/**\n * Get tomorrow's date string (YYYY-MM-DD)\n */\nexport function getTomorrowString(): string {\n return addDays(getTodayString(), 1);\n}\n\n// ============================================================================\n// ISO String Helpers (for database queries)\n// ============================================================================\n\n/**\n * Get start of day as ISO string\n * @param dateStr - Date in YYYY-MM-DD format\n * @returns ISO string like \"2024-12-15T00:00:00.000Z\"\n */\nexport function getStartOfDayISO(dateStr: string): string {\n const date = parseLocalDate(dateStr);\n return new Date(\n date.getFullYear(),\n date.getMonth(),\n date.getDate()\n ).toISOString();\n}\n\n/**\n * Get end of day as ISO string\n * @param dateStr - Date in YYYY-MM-DD format\n * @returns ISO string like \"2024-12-15T23:59:59.999Z\"\n */\nexport function getEndOfDayISO(dateStr: string): string {\n const date = parseLocalDate(dateStr);\n return new Date(\n date.getFullYear(),\n date.getMonth(),\n date.getDate(),\n 23,\n 59,\n 59,\n 999\n ).toISOString();\n}\n\n// ============================================================================\n// Week Utilities\n// ============================================================================\n\n/**\n * Get the start of the week (Monday) for a given date\n */\nexport function getWeekStart(date: Date): Date {\n const d = new Date(date);\n const day = d.getDay();\n const diff = d.getDate() - day + (day === 0 ? -6 : 1); // Monday\n d.setDate(diff);\n d.setHours(0, 0, 0, 0);\n return d;\n}\n\n/**\n * Get the end of the week (Sunday) for a given week start\n */\nexport function getWeekEnd(weekStart: Date): Date {\n const d = new Date(weekStart);\n d.setDate(d.getDate() + 6);\n return d;\n}\n\n/**\n * Get the start of the previous week\n */\nexport function getPreviousWeek(weekStart: Date): Date {\n const d = new Date(weekStart);\n d.setDate(d.getDate() - 7);\n return d;\n}\n\n/**\n * Get the start of the next week\n */\nexport function getNextWeek(weekStart: Date): Date {\n const d = new Date(weekStart);\n d.setDate(d.getDate() + 7);\n return d;\n}\n\n/**\n * Get start of week (Monday) as date string\n */\nexport function getWeekStartString(baseDate: Date = new Date()): string {\n return formatDateString(getWeekStart(baseDate));\n}\n\n/**\n * Get end of week (Sunday) as date string\n */\nexport function getWeekEndString(baseDate: Date = new Date()): string {\n return formatDateString(getWeekEnd(getWeekStart(baseDate)));\n}\n\n/**\n * Get all dates in a week as an array of date strings\n * @param weekStart - Start of the week (Monday) in YYYY-MM-DD format\n * @returns Array of 7 date strings from Monday to Sunday\n * @example getWeekDates(\"2024-12-16\") => [\"2024-12-16\", \"2024-12-17\", ..., \"2024-12-22\"]\n */\nexport function getWeekDates(weekStart: string): string[] {\n const dates: string[] = [];\n for (let i = 0; i < 7; i++) {\n dates.push(addDays(weekStart, i));\n }\n return dates;\n}\n\n/**\n * Get all dates in a week as Date objects\n * @param weekStart - Start of the week (Monday) as Date\n * @returns Array of 7 Date objects from Monday to Sunday\n */\nexport function getWeekDatesAsObjects(weekStart: Date): Date[] {\n const dates: Date[] = [];\n for (let i = 0; i < 7; i++) {\n const day = new Date(weekStart);\n day.setDate(day.getDate() + i);\n dates.push(day);\n }\n return dates;\n}\n\n/**\n * Format a week range for display\n * @example \"Dec 2 - 8, 2024\" or \"Nov 25 - Dec 1, 2024\"\n */\nexport function formatWeekRange(weekStart: Date): string {\n const weekEnd = getWeekEnd(weekStart);\n const startMonth = weekStart.toLocaleDateString(\"en-US\", { month: \"short\" });\n const endMonth = weekEnd.toLocaleDateString(\"en-US\", { month: \"short\" });\n\n if (startMonth === endMonth) {\n return `${startMonth} ${weekStart.getDate()} - ${weekEnd.getDate()}, ${weekStart.getFullYear()}`;\n }\n\n return `${startMonth} ${weekStart.getDate()} - ${endMonth} ${weekEnd.getDate()}, ${weekStart.getFullYear()}`;\n}\n\n// ============================================================================\n// Display Formatting\n// ============================================================================\n\n/**\n * Format a date string for display with full weekday\n * @example \"Monday, December 15, 2024\"\n */\nexport function formatFullDate(dateStr: string): string {\n const date = parseLocalDate(dateStr);\n return date.toLocaleDateString(\"en-US\", {\n weekday: \"long\",\n year: \"numeric\",\n month: \"long\",\n day: \"numeric\",\n });\n}\n\n/**\n * Format date for display in long form\n * @example \"Monday, 9 December\"\n */\nexport function formatDateLong(dateStr: string): string {\n const date = parseLocalDate(dateStr);\n return date.toLocaleDateString(\"en-GB\", {\n weekday: \"long\",\n day: \"numeric\",\n month: \"long\",\n });\n}\n\n/**\n * Format month and year\n * @example \"December 2024\"\n */\nexport function formatMonthYear(date: Date): string {\n return date.toLocaleDateString(\"en-US\", {\n month: \"long\",\n year: \"numeric\",\n });\n}\n\n/**\n * Format a date/time to HH:MM format\n * Use this for formatting Date objects or ISO strings to time display\n * @example formatTimeHHMM(new Date()) => \"14:30\"\n *\n * Note: For formatting seconds (e.g., timer display), use formatTime from utils\n */\nexport function formatTimeHHMM(date: Date | string): string {\n const d = typeof date === \"string\" ? new Date(date) : date;\n return d.toLocaleTimeString([], { hour: \"2-digit\", minute: \"2-digit\" });\n}\n\n/**\n * Format time in short format (12h without seconds)\n * @example formatTimeShort(new Date()) => \"2:30 PM\"\n */\nexport function formatTimeShort(date: Date | string): string {\n const d = typeof date === \"string\" ? new Date(date) : date;\n return d.toLocaleTimeString(\"en-US\", { hour: \"numeric\", minute: \"2-digit\" });\n}\n\n/**\n * Format a Date object for display in readable format\n * @example formatDateDisplay(new Date()) => \"Monday, Dec 22\"\n */\nexport function formatDateDisplay(date: Date): string {\n return date.toLocaleDateString(\"en-US\", {\n weekday: \"long\",\n month: \"short\",\n day: \"numeric\",\n });\n}\n\n/**\n * Format a date/time to HH:MM:SS format\n */\nexport function formatTimeWithSeconds(date: Date | string): string {\n const d = typeof date === \"string\" ? new Date(date) : date;\n return d.toLocaleTimeString([], {\n hour: \"2-digit\",\n minute: \"2-digit\",\n second: \"2-digit\",\n });\n}\n\n// ============================================================================\n// Contextual Formatting\n// ============================================================================\n\n/**\n * Format a date string for display as a header\n * Returns \"Overdue\", \"Today\", \"Tomorrow\", or formatted date\n */\nexport function formatDateHeader(dateStr: string): string {\n const today = getTodayString();\n\n if (dateStr < today) {\n return \"Overdue\";\n }\n\n if (dateStr === today) {\n return \"Today\";\n }\n\n const tomorrowStr = getTomorrowString();\n if (dateStr === tomorrowStr) {\n return \"Tomorrow\";\n }\n\n const date = parseLocalDate(dateStr);\n return date.toLocaleDateString(\"en-US\", {\n weekday: \"long\",\n month: \"short\",\n day: \"numeric\",\n });\n}\n\n/**\n * Format a due date for display in task items (simple string version)\n * Returns \"Overdue\", \"Today\", \"Tomorrow\", or formatted date\n *\n * Note: For version that returns { text, isOverdue }, use formatDueDate from utils/formatters\n */\nexport function formatDueDateString(dateStr: string | null): string {\n if (!dateStr) return \"No due date\";\n\n const today = getTodayString();\n const tomorrowStr = getTomorrowString();\n\n if (dateStr < today) {\n const date = parseLocalDate(dateStr);\n return `Overdue • ${date.toLocaleDateString(\"en-US\", {\n month: \"short\",\n day: \"numeric\",\n })}`;\n }\n\n if (dateStr === today) {\n return \"Today\";\n }\n\n if (dateStr === tomorrowStr) {\n return \"Tomorrow\";\n }\n\n const date = parseLocalDate(dateStr);\n const currentYear = new Date().getFullYear();\n const dateYear = date.getFullYear();\n\n return date.toLocaleDateString(\"en-US\", {\n month: \"short\",\n day: \"numeric\",\n year: dateYear !== currentYear ? \"numeric\" : undefined,\n });\n}\n\n/**\n * Format a date/time as relative time string (extended version)\n * Accepts both Date objects and ISO strings\n * @example \"Just now\", \"5m ago\", \"2h ago\", \"3d ago\"\n *\n * Note: For simple string input, you can also use formatRelativeTime from utils/formatters\n */\nexport function formatRelativeTimeExtended(dateStr: string | Date): string {\n const date = typeof dateStr === \"string\" ? new Date(dateStr) : dateStr;\n const now = new Date();\n const diffMs = now.getTime() - date.getTime();\n const diffMins = Math.floor(diffMs / 60000);\n const diffHours = Math.floor(diffMins / 60);\n const diffDays = Math.floor(diffHours / 24);\n\n if (diffMins < 1) return \"Just now\";\n if (diffMins < 60) return `${diffMins}m ago`;\n if (diffHours < 24) return `${diffHours}h ago`;\n if (diffDays < 7) return `${diffDays}d ago`;\n return date.toLocaleDateString();\n}\n\n/**\n * Format a due date relative to today with contextual prefix\n * @example \"Due today\", \"Due tomorrow\", \"Due in 3 days\", \"2 days overdue\"\n */\nexport function formatRelativeDueDate(\n dateStr: string,\n options?: {\n duePrefix?: string;\n overduePrefix?: string;\n }\n): string {\n const { duePrefix = \"Due\", overduePrefix = \"\" } = options || {};\n const date = parseLocalDate(dateStr);\n const now = normalizeToMidnight(new Date());\n\n const diffMs = date.getTime() - now.getTime();\n const diffDays = Math.round(diffMs / (1000 * 60 * 60 * 24));\n\n if (diffDays < 0) {\n const absDays = Math.abs(diffDays);\n return overduePrefix\n ? `${overduePrefix} ${absDays} day${absDays !== 1 ? \"s\" : \"\"} overdue`\n : `${absDays} day${absDays !== 1 ? \"s\" : \"\"} overdue`;\n }\n if (diffDays === 0) return `${duePrefix} today`;\n if (diffDays === 1) return `${duePrefix} tomorrow`;\n if (diffDays <= 7) return `${duePrefix} in ${diffDays} days`;\n\n return date.toLocaleDateString(\"en-GB\", { day: \"numeric\", month: \"short\" });\n}\n\n/**\n * Format a pay/income date relative to today\n * @example \"Today\", \"Tomorrow\", \"In 3 days\", \"2 days ago\"\n */\nexport function formatRelativePayDate(dateStr: string): string {\n const date = parseLocalDate(dateStr);\n const now = normalizeToMidnight(new Date());\n\n const diffMs = date.getTime() - now.getTime();\n const diffDays = Math.round(diffMs / (1000 * 60 * 60 * 24));\n\n if (diffDays < 0) {\n const absDays = Math.abs(diffDays);\n return `${absDays} day${absDays !== 1 ? \"s\" : \"\"} ago`;\n }\n if (diffDays === 0) return \"Today\";\n if (diffDays === 1) return \"Tomorrow\";\n if (diffDays <= 7) return `In ${diffDays} days`;\n\n return date.toLocaleDateString(\"en-GB\", { day: \"numeric\", month: \"short\" });\n}\n\n// ============================================================================\n// Localized Formatting\n// ============================================================================\n\nexport type DateFormat = \"short\" | \"medium\" | \"long\" | \"weekday\";\nexport type TimeFormat = \"short\" | \"withSeconds\";\n\n/**\n * Format a date with various preset formats\n */\nexport function formatDateLocalized(\n date: Date | string,\n format: DateFormat = \"medium\"\n): string {\n const d = typeof date === \"string\" ? new Date(date) : date;\n\n switch (format) {\n case \"short\":\n return d.toLocaleDateString(\"en-US\", { month: \"short\", day: \"numeric\" });\n case \"medium\":\n return d.toLocaleDateString(\"en-US\", {\n month: \"short\",\n day: \"numeric\",\n year: \"numeric\",\n });\n case \"long\":\n return d.toLocaleDateString(\"en-US\", {\n weekday: \"long\",\n month: \"long\",\n day: \"numeric\",\n year: \"numeric\",\n });\n case \"weekday\":\n return d.toLocaleDateString(\"en-US\", { weekday: \"short\" });\n default:\n return d.toLocaleDateString();\n }\n}\n\n/**\n * Format a time with various preset formats\n */\nexport function formatTimeLocalized(\n date: Date | string,\n format: TimeFormat = \"short\"\n): string {\n const d = typeof date === \"string\" ? new Date(date) : date;\n\n switch (format) {\n case \"short\":\n return d.toLocaleTimeString(\"en-US\", {\n hour: \"2-digit\",\n minute: \"2-digit\",\n hour12: true,\n });\n case \"withSeconds\":\n return d.toLocaleTimeString(\"en-US\", {\n hour: \"2-digit\",\n minute: \"2-digit\",\n second: \"2-digit\",\n hour12: true,\n });\n default:\n return d.toLocaleTimeString();\n }\n}\n"],"mappings":"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","names":["date"]}
|
package/dist/date/index.mjs
CHANGED
|
@@ -8,7 +8,10 @@ function getTodayMidnight() {
|
|
|
8
8
|
return normalizeToMidnight(/* @__PURE__ */ new Date());
|
|
9
9
|
}
|
|
10
10
|
function formatDateString(date) {
|
|
11
|
-
return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(
|
|
11
|
+
return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(
|
|
12
|
+
2,
|
|
13
|
+
"0"
|
|
14
|
+
)}-${String(date.getDate()).padStart(2, "0")}`;
|
|
12
15
|
}
|
|
13
16
|
function getTodayString() {
|
|
14
17
|
return formatDateString(/* @__PURE__ */ new Date());
|
|
@@ -49,7 +52,11 @@ function getTomorrowString() {
|
|
|
49
52
|
}
|
|
50
53
|
function getStartOfDayISO(dateStr) {
|
|
51
54
|
const date = parseLocalDate(dateStr);
|
|
52
|
-
return new Date(
|
|
55
|
+
return new Date(
|
|
56
|
+
date.getFullYear(),
|
|
57
|
+
date.getMonth(),
|
|
58
|
+
date.getDate()
|
|
59
|
+
).toISOString();
|
|
53
60
|
}
|
|
54
61
|
function getEndOfDayISO(dateStr) {
|
|
55
62
|
const date = parseLocalDate(dateStr);
|
|
@@ -92,6 +99,22 @@ function getWeekStartString(baseDate = /* @__PURE__ */ new Date()) {
|
|
|
92
99
|
function getWeekEndString(baseDate = /* @__PURE__ */ new Date()) {
|
|
93
100
|
return formatDateString(getWeekEnd(getWeekStart(baseDate)));
|
|
94
101
|
}
|
|
102
|
+
function getWeekDates(weekStart) {
|
|
103
|
+
const dates = [];
|
|
104
|
+
for (let i = 0; i < 7; i++) {
|
|
105
|
+
dates.push(addDays(weekStart, i));
|
|
106
|
+
}
|
|
107
|
+
return dates;
|
|
108
|
+
}
|
|
109
|
+
function getWeekDatesAsObjects(weekStart) {
|
|
110
|
+
const dates = [];
|
|
111
|
+
for (let i = 0; i < 7; i++) {
|
|
112
|
+
const day = new Date(weekStart);
|
|
113
|
+
day.setDate(day.getDate() + i);
|
|
114
|
+
dates.push(day);
|
|
115
|
+
}
|
|
116
|
+
return dates;
|
|
117
|
+
}
|
|
95
118
|
function formatWeekRange(weekStart) {
|
|
96
119
|
const weekEnd = getWeekEnd(weekStart);
|
|
97
120
|
const startMonth = weekStart.toLocaleDateString("en-US", { month: "short" });
|
|
@@ -141,7 +164,11 @@ function formatDateDisplay(date) {
|
|
|
141
164
|
}
|
|
142
165
|
function formatTimeWithSeconds(date) {
|
|
143
166
|
const d = typeof date === "string" ? new Date(date) : date;
|
|
144
|
-
return d.toLocaleTimeString([], {
|
|
167
|
+
return d.toLocaleTimeString([], {
|
|
168
|
+
hour: "2-digit",
|
|
169
|
+
minute: "2-digit",
|
|
170
|
+
second: "2-digit"
|
|
171
|
+
});
|
|
145
172
|
}
|
|
146
173
|
function formatDateHeader(dateStr) {
|
|
147
174
|
const today = getTodayString();
|
|
@@ -168,7 +195,10 @@ function formatDueDateString(dateStr) {
|
|
|
168
195
|
const tomorrowStr = getTomorrowString();
|
|
169
196
|
if (dateStr < today) {
|
|
170
197
|
const date2 = parseLocalDate(dateStr);
|
|
171
|
-
return `Overdue \u2022 ${date2.toLocaleDateString("en-US", {
|
|
198
|
+
return `Overdue \u2022 ${date2.toLocaleDateString("en-US", {
|
|
199
|
+
month: "short",
|
|
200
|
+
day: "numeric"
|
|
201
|
+
})}`;
|
|
172
202
|
}
|
|
173
203
|
if (dateStr === today) {
|
|
174
204
|
return "Today";
|
|
@@ -233,7 +263,11 @@ function formatDateLocalized(date, format = "medium") {
|
|
|
233
263
|
case "short":
|
|
234
264
|
return d.toLocaleDateString("en-US", { month: "short", day: "numeric" });
|
|
235
265
|
case "medium":
|
|
236
|
-
return d.toLocaleDateString("en-US", {
|
|
266
|
+
return d.toLocaleDateString("en-US", {
|
|
267
|
+
month: "short",
|
|
268
|
+
day: "numeric",
|
|
269
|
+
year: "numeric"
|
|
270
|
+
});
|
|
237
271
|
case "long":
|
|
238
272
|
return d.toLocaleDateString("en-US", {
|
|
239
273
|
weekday: "long",
|
|
@@ -251,7 +285,11 @@ function formatTimeLocalized(date, format = "short") {
|
|
|
251
285
|
const d = typeof date === "string" ? new Date(date) : date;
|
|
252
286
|
switch (format) {
|
|
253
287
|
case "short":
|
|
254
|
-
return d.toLocaleTimeString("en-US", {
|
|
288
|
+
return d.toLocaleTimeString("en-US", {
|
|
289
|
+
hour: "2-digit",
|
|
290
|
+
minute: "2-digit",
|
|
291
|
+
hour12: true
|
|
292
|
+
});
|
|
255
293
|
case "withSeconds":
|
|
256
294
|
return d.toLocaleTimeString("en-US", {
|
|
257
295
|
hour: "2-digit",
|
|
@@ -288,6 +326,8 @@ export {
|
|
|
288
326
|
getTodayMidnight,
|
|
289
327
|
getTodayString,
|
|
290
328
|
getTomorrowString,
|
|
329
|
+
getWeekDates,
|
|
330
|
+
getWeekDatesAsObjects,
|
|
291
331
|
getWeekEnd,
|
|
292
332
|
getWeekEndString,
|
|
293
333
|
getWeekStart,
|
package/dist/date/index.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/date/index.ts"],"sourcesContent":["/**\n * Date Utilities\n *\n * Pure functions for date manipulation and formatting.\n * Works in both Node.js and browser/React Native environments.\n *\n * @example\n * import { getTodayString, addDays, formatRelativeTime } from '@mrck-labs/vanaheim-shared/date'\n *\n * const today = getTodayString() // \"2024-12-16\"\n * const nextWeek = addDays(today, 7) // \"2024-12-23\"\n */\n\n// ============================================================================\n// Core Utilities\n// ============================================================================\n\n/**\n * Normalize a date to midnight (00:00:00.000)\n */\nexport function normalizeToMidnight(date: Date): Date {\n const d = new Date(date)\n d.setHours(0, 0, 0, 0)\n return d\n}\n\n/**\n * Get today's date normalized to midnight\n */\nexport function getTodayMidnight(): Date {\n return normalizeToMidnight(new Date())\n}\n\n/**\n * Format a Date object to YYYY-MM-DD string\n * @example formatDateString(new Date()) => \"2024-12-16\"\n */\nexport function formatDateString(date: Date): string {\n return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}-${String(date.getDate()).padStart(2, '0')}`\n}\n\n/**\n * Get today's local date string (YYYY-MM-DD)\n */\nexport function getTodayString(): string {\n return formatDateString(new Date())\n}\n\n/**\n * Parse a YYYY-MM-DD string to a local Date object\n * Avoids timezone issues by appending T00:00:00\n */\nexport function parseLocalDate(dateStr: string): Date {\n return new Date(dateStr + 'T00:00:00')\n}\n\n// ============================================================================\n// Date Checks\n// ============================================================================\n\n/**\n * Check if a date string is today\n */\nexport function isToday(dateStr: string | null): boolean {\n if (!dateStr) return false\n return dateStr === getTodayString()\n}\n\n/**\n * Check if a date string is in the past (before today)\n */\nexport function isOverdue(dateStr: string | null): boolean {\n if (!dateStr) return false\n return dateStr < getTodayString()\n}\n\n/**\n * Check if a date is due within a threshold of days\n * @param dateStr - Date in YYYY-MM-DD format\n * @param daysThreshold - Number of days to check (default: 7)\n */\nexport function isDueSoon(dateStr: string | null, daysThreshold: number = 7): boolean {\n if (!dateStr) return false\n if (isOverdue(dateStr)) return false\n\n const today = getTodayMidnight()\n const targetDate = parseLocalDate(dateStr)\n const diffMs = targetDate.getTime() - today.getTime()\n const diffDays = Math.ceil(diffMs / (1000 * 60 * 60 * 24))\n\n return diffDays >= 0 && diffDays <= daysThreshold\n}\n\n// ============================================================================\n// Date Arithmetic\n// ============================================================================\n\n/**\n * Add days to a date string\n * @param dateStr - Date in YYYY-MM-DD format\n * @param days - Number of days to add (can be negative)\n * @returns New date string in YYYY-MM-DD format\n */\nexport function addDays(dateStr: string, days: number): string {\n const date = parseLocalDate(dateStr)\n date.setDate(date.getDate() + days)\n return formatDateString(date)\n}\n\n/**\n * Subtract days from a date string\n */\nexport function subtractDays(dateStr: string, days: number): string {\n return addDays(dateStr, -days)\n}\n\n/**\n * Get yesterday's date string (YYYY-MM-DD)\n */\nexport function getYesterdayString(): string {\n return subtractDays(getTodayString(), 1)\n}\n\n/**\n * Get tomorrow's date string (YYYY-MM-DD)\n */\nexport function getTomorrowString(): string {\n return addDays(getTodayString(), 1)\n}\n\n// ============================================================================\n// ISO String Helpers (for database queries)\n// ============================================================================\n\n/**\n * Get start of day as ISO string\n * @param dateStr - Date in YYYY-MM-DD format\n * @returns ISO string like \"2024-12-15T00:00:00.000Z\"\n */\nexport function getStartOfDayISO(dateStr: string): string {\n const date = parseLocalDate(dateStr)\n return new Date(date.getFullYear(), date.getMonth(), date.getDate()).toISOString()\n}\n\n/**\n * Get end of day as ISO string\n * @param dateStr - Date in YYYY-MM-DD format\n * @returns ISO string like \"2024-12-15T23:59:59.999Z\"\n */\nexport function getEndOfDayISO(dateStr: string): string {\n const date = parseLocalDate(dateStr)\n return new Date(\n date.getFullYear(),\n date.getMonth(),\n date.getDate(),\n 23,\n 59,\n 59,\n 999\n ).toISOString()\n}\n\n// ============================================================================\n// Week Utilities\n// ============================================================================\n\n/**\n * Get the start of the week (Monday) for a given date\n */\nexport function getWeekStart(date: Date): Date {\n const d = new Date(date)\n const day = d.getDay()\n const diff = d.getDate() - day + (day === 0 ? -6 : 1) // Monday\n d.setDate(diff)\n d.setHours(0, 0, 0, 0)\n return d\n}\n\n/**\n * Get the end of the week (Sunday) for a given week start\n */\nexport function getWeekEnd(weekStart: Date): Date {\n const d = new Date(weekStart)\n d.setDate(d.getDate() + 6)\n return d\n}\n\n/**\n * Get the start of the previous week\n */\nexport function getPreviousWeek(weekStart: Date): Date {\n const d = new Date(weekStart)\n d.setDate(d.getDate() - 7)\n return d\n}\n\n/**\n * Get the start of the next week\n */\nexport function getNextWeek(weekStart: Date): Date {\n const d = new Date(weekStart)\n d.setDate(d.getDate() + 7)\n return d\n}\n\n/**\n * Get start of week (Monday) as date string\n */\nexport function getWeekStartString(baseDate: Date = new Date()): string {\n return formatDateString(getWeekStart(baseDate))\n}\n\n/**\n * Get end of week (Sunday) as date string\n */\nexport function getWeekEndString(baseDate: Date = new Date()): string {\n return formatDateString(getWeekEnd(getWeekStart(baseDate)))\n}\n\n/**\n * Format a week range for display\n * @example \"Dec 2 - 8, 2024\" or \"Nov 25 - Dec 1, 2024\"\n */\nexport function formatWeekRange(weekStart: Date): string {\n const weekEnd = getWeekEnd(weekStart)\n const startMonth = weekStart.toLocaleDateString('en-US', { month: 'short' })\n const endMonth = weekEnd.toLocaleDateString('en-US', { month: 'short' })\n\n if (startMonth === endMonth) {\n return `${startMonth} ${weekStart.getDate()} - ${weekEnd.getDate()}, ${weekStart.getFullYear()}`\n }\n\n return `${startMonth} ${weekStart.getDate()} - ${endMonth} ${weekEnd.getDate()}, ${weekStart.getFullYear()}`\n}\n\n// ============================================================================\n// Display Formatting\n// ============================================================================\n\n/**\n * Format a date string for display with full weekday\n * @example \"Monday, December 15, 2024\"\n */\nexport function formatFullDate(dateStr: string): string {\n const date = parseLocalDate(dateStr)\n return date.toLocaleDateString('en-US', {\n weekday: 'long',\n year: 'numeric',\n month: 'long',\n day: 'numeric',\n })\n}\n\n/**\n * Format date for display in long form\n * @example \"Monday, 9 December\"\n */\nexport function formatDateLong(dateStr: string): string {\n const date = parseLocalDate(dateStr)\n return date.toLocaleDateString('en-GB', {\n weekday: 'long',\n day: 'numeric',\n month: 'long',\n })\n}\n\n/**\n * Format month and year\n * @example \"December 2024\"\n */\nexport function formatMonthYear(date: Date): string {\n return date.toLocaleDateString('en-US', {\n month: 'long',\n year: 'numeric',\n })\n}\n\n/**\n * Format a date/time to HH:MM format\n * Use this for formatting Date objects or ISO strings to time display\n * @example formatTimeHHMM(new Date()) => \"14:30\"\n *\n * Note: For formatting seconds (e.g., timer display), use formatTime from utils\n */\nexport function formatTimeHHMM(date: Date | string): string {\n const d = typeof date === 'string' ? new Date(date) : date\n return d.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' })\n}\n\n/**\n * Format time in short format (12h without seconds)\n * @example formatTimeShort(new Date()) => \"2:30 PM\"\n */\nexport function formatTimeShort(date: Date | string): string {\n const d = typeof date === 'string' ? new Date(date) : date\n return d.toLocaleTimeString('en-US', { hour: 'numeric', minute: '2-digit' })\n}\n\n/**\n * Format a Date object for display in readable format\n * @example formatDateDisplay(new Date()) => \"Monday, Dec 22\"\n */\nexport function formatDateDisplay(date: Date): string {\n return date.toLocaleDateString('en-US', {\n weekday: 'long',\n month: 'short',\n day: 'numeric',\n })\n}\n\n/**\n * Format a date/time to HH:MM:SS format\n */\nexport function formatTimeWithSeconds(date: Date | string): string {\n const d = typeof date === 'string' ? new Date(date) : date\n return d.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit', second: '2-digit' })\n}\n\n// ============================================================================\n// Contextual Formatting\n// ============================================================================\n\n/**\n * Format a date string for display as a header\n * Returns \"Overdue\", \"Today\", \"Tomorrow\", or formatted date\n */\nexport function formatDateHeader(dateStr: string): string {\n const today = getTodayString()\n\n if (dateStr < today) {\n return 'Overdue'\n }\n\n if (dateStr === today) {\n return 'Today'\n }\n\n const tomorrowStr = getTomorrowString()\n if (dateStr === tomorrowStr) {\n return 'Tomorrow'\n }\n\n const date = parseLocalDate(dateStr)\n return date.toLocaleDateString('en-US', {\n weekday: 'long',\n month: 'short',\n day: 'numeric',\n })\n}\n\n/**\n * Format a due date for display in task items (simple string version)\n * Returns \"Overdue\", \"Today\", \"Tomorrow\", or formatted date\n *\n * Note: For version that returns { text, isOverdue }, use formatDueDate from utils/formatters\n */\nexport function formatDueDateString(dateStr: string | null): string {\n if (!dateStr) return 'No due date'\n\n const today = getTodayString()\n const tomorrowStr = getTomorrowString()\n\n if (dateStr < today) {\n const date = parseLocalDate(dateStr)\n return `Overdue • ${date.toLocaleDateString('en-US', { month: 'short', day: 'numeric' })}`\n }\n\n if (dateStr === today) {\n return 'Today'\n }\n\n if (dateStr === tomorrowStr) {\n return 'Tomorrow'\n }\n\n const date = parseLocalDate(dateStr)\n const currentYear = new Date().getFullYear()\n const dateYear = date.getFullYear()\n\n return date.toLocaleDateString('en-US', {\n month: 'short',\n day: 'numeric',\n year: dateYear !== currentYear ? 'numeric' : undefined,\n })\n}\n\n/**\n * Format a date/time as relative time string (extended version)\n * Accepts both Date objects and ISO strings\n * @example \"Just now\", \"5m ago\", \"2h ago\", \"3d ago\"\n *\n * Note: For simple string input, you can also use formatRelativeTime from utils/formatters\n */\nexport function formatRelativeTimeExtended(dateStr: string | Date): string {\n const date = typeof dateStr === 'string' ? new Date(dateStr) : dateStr\n const now = new Date()\n const diffMs = now.getTime() - date.getTime()\n const diffMins = Math.floor(diffMs / 60000)\n const diffHours = Math.floor(diffMins / 60)\n const diffDays = Math.floor(diffHours / 24)\n\n if (diffMins < 1) return 'Just now'\n if (diffMins < 60) return `${diffMins}m ago`\n if (diffHours < 24) return `${diffHours}h ago`\n if (diffDays < 7) return `${diffDays}d ago`\n return date.toLocaleDateString()\n}\n\n/**\n * Format a due date relative to today with contextual prefix\n * @example \"Due today\", \"Due tomorrow\", \"Due in 3 days\", \"2 days overdue\"\n */\nexport function formatRelativeDueDate(\n dateStr: string,\n options?: {\n duePrefix?: string\n overduePrefix?: string\n }\n): string {\n const { duePrefix = 'Due', overduePrefix = '' } = options || {}\n const date = parseLocalDate(dateStr)\n const now = normalizeToMidnight(new Date())\n\n const diffMs = date.getTime() - now.getTime()\n const diffDays = Math.round(diffMs / (1000 * 60 * 60 * 24))\n\n if (diffDays < 0) {\n const absDays = Math.abs(diffDays)\n return overduePrefix\n ? `${overduePrefix} ${absDays} day${absDays !== 1 ? 's' : ''} overdue`\n : `${absDays} day${absDays !== 1 ? 's' : ''} overdue`\n }\n if (diffDays === 0) return `${duePrefix} today`\n if (diffDays === 1) return `${duePrefix} tomorrow`\n if (diffDays <= 7) return `${duePrefix} in ${diffDays} days`\n\n return date.toLocaleDateString('en-GB', { day: 'numeric', month: 'short' })\n}\n\n/**\n * Format a pay/income date relative to today\n * @example \"Today\", \"Tomorrow\", \"In 3 days\", \"2 days ago\"\n */\nexport function formatRelativePayDate(dateStr: string): string {\n const date = parseLocalDate(dateStr)\n const now = normalizeToMidnight(new Date())\n\n const diffMs = date.getTime() - now.getTime()\n const diffDays = Math.round(diffMs / (1000 * 60 * 60 * 24))\n\n if (diffDays < 0) {\n const absDays = Math.abs(diffDays)\n return `${absDays} day${absDays !== 1 ? 's' : ''} ago`\n }\n if (diffDays === 0) return 'Today'\n if (diffDays === 1) return 'Tomorrow'\n if (diffDays <= 7) return `In ${diffDays} days`\n\n return date.toLocaleDateString('en-GB', { day: 'numeric', month: 'short' })\n}\n\n// ============================================================================\n// Localized Formatting\n// ============================================================================\n\nexport type DateFormat = 'short' | 'medium' | 'long' | 'weekday'\nexport type TimeFormat = 'short' | 'withSeconds'\n\n/**\n * Format a date with various preset formats\n */\nexport function formatDateLocalized(date: Date | string, format: DateFormat = 'medium'): string {\n const d = typeof date === 'string' ? new Date(date) : date\n\n switch (format) {\n case 'short':\n return d.toLocaleDateString('en-US', { month: 'short', day: 'numeric' })\n case 'medium':\n return d.toLocaleDateString('en-US', { month: 'short', day: 'numeric', year: 'numeric' })\n case 'long':\n return d.toLocaleDateString('en-US', {\n weekday: 'long',\n month: 'long',\n day: 'numeric',\n year: 'numeric',\n })\n case 'weekday':\n return d.toLocaleDateString('en-US', { weekday: 'short' })\n default:\n return d.toLocaleDateString()\n }\n}\n\n/**\n * Format a time with various preset formats\n */\nexport function formatTimeLocalized(date: Date | string, format: TimeFormat = 'short'): string {\n const d = typeof date === 'string' ? new Date(date) : date\n\n switch (format) {\n case 'short':\n return d.toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', hour12: true })\n case 'withSeconds':\n return d.toLocaleTimeString('en-US', {\n hour: '2-digit',\n minute: '2-digit',\n second: '2-digit',\n hour12: true,\n })\n default:\n return d.toLocaleTimeString()\n }\n}\n\n"],"mappings":"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","names":["date"]}
|
|
1
|
+
{"version":3,"sources":["../../src/date/index.ts"],"sourcesContent":["/**\n * Date Utilities\n *\n * Pure functions for date manipulation and formatting.\n * Works in both Node.js and browser/React Native environments.\n *\n * @example\n * import { getTodayString, addDays, formatRelativeTime } from '@mrck-labs/vanaheim-shared/date'\n *\n * const today = getTodayString() // \"2024-12-16\"\n * const nextWeek = addDays(today, 7) // \"2024-12-23\"\n */\n\n// ============================================================================\n// Core Utilities\n// ============================================================================\n\n/**\n * Normalize a date to midnight (00:00:00.000)\n */\nexport function normalizeToMidnight(date: Date): Date {\n const d = new Date(date);\n d.setHours(0, 0, 0, 0);\n return d;\n}\n\n/**\n * Get today's date normalized to midnight\n */\nexport function getTodayMidnight(): Date {\n return normalizeToMidnight(new Date());\n}\n\n/**\n * Format a Date object to YYYY-MM-DD string\n * @example formatDateString(new Date()) => \"2024-12-16\"\n */\nexport function formatDateString(date: Date): string {\n return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(\n 2,\n \"0\"\n )}-${String(date.getDate()).padStart(2, \"0\")}`;\n}\n\n/**\n * Get today's local date string (YYYY-MM-DD)\n */\nexport function getTodayString(): string {\n return formatDateString(new Date());\n}\n\n/**\n * Parse a YYYY-MM-DD string to a local Date object\n * Avoids timezone issues by appending T00:00:00\n */\nexport function parseLocalDate(dateStr: string): Date {\n return new Date(dateStr + \"T00:00:00\");\n}\n\n// ============================================================================\n// Date Checks\n// ============================================================================\n\n/**\n * Check if a date string is today\n */\nexport function isToday(dateStr: string | null): boolean {\n if (!dateStr) return false;\n return dateStr === getTodayString();\n}\n\n/**\n * Check if a date string is in the past (before today)\n */\nexport function isOverdue(dateStr: string | null): boolean {\n if (!dateStr) return false;\n return dateStr < getTodayString();\n}\n\n/**\n * Check if a date is due within a threshold of days\n * @param dateStr - Date in YYYY-MM-DD format\n * @param daysThreshold - Number of days to check (default: 7)\n */\nexport function isDueSoon(\n dateStr: string | null,\n daysThreshold: number = 7\n): boolean {\n if (!dateStr) return false;\n if (isOverdue(dateStr)) return false;\n\n const today = getTodayMidnight();\n const targetDate = parseLocalDate(dateStr);\n const diffMs = targetDate.getTime() - today.getTime();\n const diffDays = Math.ceil(diffMs / (1000 * 60 * 60 * 24));\n\n return diffDays >= 0 && diffDays <= daysThreshold;\n}\n\n// ============================================================================\n// Date Arithmetic\n// ============================================================================\n\n/**\n * Add days to a date string\n * @param dateStr - Date in YYYY-MM-DD format\n * @param days - Number of days to add (can be negative)\n * @returns New date string in YYYY-MM-DD format\n */\nexport function addDays(dateStr: string, days: number): string {\n const date = parseLocalDate(dateStr);\n date.setDate(date.getDate() + days);\n return formatDateString(date);\n}\n\n/**\n * Subtract days from a date string\n */\nexport function subtractDays(dateStr: string, days: number): string {\n return addDays(dateStr, -days);\n}\n\n/**\n * Get yesterday's date string (YYYY-MM-DD)\n */\nexport function getYesterdayString(): string {\n return subtractDays(getTodayString(), 1);\n}\n\n/**\n * Get tomorrow's date string (YYYY-MM-DD)\n */\nexport function getTomorrowString(): string {\n return addDays(getTodayString(), 1);\n}\n\n// ============================================================================\n// ISO String Helpers (for database queries)\n// ============================================================================\n\n/**\n * Get start of day as ISO string\n * @param dateStr - Date in YYYY-MM-DD format\n * @returns ISO string like \"2024-12-15T00:00:00.000Z\"\n */\nexport function getStartOfDayISO(dateStr: string): string {\n const date = parseLocalDate(dateStr);\n return new Date(\n date.getFullYear(),\n date.getMonth(),\n date.getDate()\n ).toISOString();\n}\n\n/**\n * Get end of day as ISO string\n * @param dateStr - Date in YYYY-MM-DD format\n * @returns ISO string like \"2024-12-15T23:59:59.999Z\"\n */\nexport function getEndOfDayISO(dateStr: string): string {\n const date = parseLocalDate(dateStr);\n return new Date(\n date.getFullYear(),\n date.getMonth(),\n date.getDate(),\n 23,\n 59,\n 59,\n 999\n ).toISOString();\n}\n\n// ============================================================================\n// Week Utilities\n// ============================================================================\n\n/**\n * Get the start of the week (Monday) for a given date\n */\nexport function getWeekStart(date: Date): Date {\n const d = new Date(date);\n const day = d.getDay();\n const diff = d.getDate() - day + (day === 0 ? -6 : 1); // Monday\n d.setDate(diff);\n d.setHours(0, 0, 0, 0);\n return d;\n}\n\n/**\n * Get the end of the week (Sunday) for a given week start\n */\nexport function getWeekEnd(weekStart: Date): Date {\n const d = new Date(weekStart);\n d.setDate(d.getDate() + 6);\n return d;\n}\n\n/**\n * Get the start of the previous week\n */\nexport function getPreviousWeek(weekStart: Date): Date {\n const d = new Date(weekStart);\n d.setDate(d.getDate() - 7);\n return d;\n}\n\n/**\n * Get the start of the next week\n */\nexport function getNextWeek(weekStart: Date): Date {\n const d = new Date(weekStart);\n d.setDate(d.getDate() + 7);\n return d;\n}\n\n/**\n * Get start of week (Monday) as date string\n */\nexport function getWeekStartString(baseDate: Date = new Date()): string {\n return formatDateString(getWeekStart(baseDate));\n}\n\n/**\n * Get end of week (Sunday) as date string\n */\nexport function getWeekEndString(baseDate: Date = new Date()): string {\n return formatDateString(getWeekEnd(getWeekStart(baseDate)));\n}\n\n/**\n * Get all dates in a week as an array of date strings\n * @param weekStart - Start of the week (Monday) in YYYY-MM-DD format\n * @returns Array of 7 date strings from Monday to Sunday\n * @example getWeekDates(\"2024-12-16\") => [\"2024-12-16\", \"2024-12-17\", ..., \"2024-12-22\"]\n */\nexport function getWeekDates(weekStart: string): string[] {\n const dates: string[] = [];\n for (let i = 0; i < 7; i++) {\n dates.push(addDays(weekStart, i));\n }\n return dates;\n}\n\n/**\n * Get all dates in a week as Date objects\n * @param weekStart - Start of the week (Monday) as Date\n * @returns Array of 7 Date objects from Monday to Sunday\n */\nexport function getWeekDatesAsObjects(weekStart: Date): Date[] {\n const dates: Date[] = [];\n for (let i = 0; i < 7; i++) {\n const day = new Date(weekStart);\n day.setDate(day.getDate() + i);\n dates.push(day);\n }\n return dates;\n}\n\n/**\n * Format a week range for display\n * @example \"Dec 2 - 8, 2024\" or \"Nov 25 - Dec 1, 2024\"\n */\nexport function formatWeekRange(weekStart: Date): string {\n const weekEnd = getWeekEnd(weekStart);\n const startMonth = weekStart.toLocaleDateString(\"en-US\", { month: \"short\" });\n const endMonth = weekEnd.toLocaleDateString(\"en-US\", { month: \"short\" });\n\n if (startMonth === endMonth) {\n return `${startMonth} ${weekStart.getDate()} - ${weekEnd.getDate()}, ${weekStart.getFullYear()}`;\n }\n\n return `${startMonth} ${weekStart.getDate()} - ${endMonth} ${weekEnd.getDate()}, ${weekStart.getFullYear()}`;\n}\n\n// ============================================================================\n// Display Formatting\n// ============================================================================\n\n/**\n * Format a date string for display with full weekday\n * @example \"Monday, December 15, 2024\"\n */\nexport function formatFullDate(dateStr: string): string {\n const date = parseLocalDate(dateStr);\n return date.toLocaleDateString(\"en-US\", {\n weekday: \"long\",\n year: \"numeric\",\n month: \"long\",\n day: \"numeric\",\n });\n}\n\n/**\n * Format date for display in long form\n * @example \"Monday, 9 December\"\n */\nexport function formatDateLong(dateStr: string): string {\n const date = parseLocalDate(dateStr);\n return date.toLocaleDateString(\"en-GB\", {\n weekday: \"long\",\n day: \"numeric\",\n month: \"long\",\n });\n}\n\n/**\n * Format month and year\n * @example \"December 2024\"\n */\nexport function formatMonthYear(date: Date): string {\n return date.toLocaleDateString(\"en-US\", {\n month: \"long\",\n year: \"numeric\",\n });\n}\n\n/**\n * Format a date/time to HH:MM format\n * Use this for formatting Date objects or ISO strings to time display\n * @example formatTimeHHMM(new Date()) => \"14:30\"\n *\n * Note: For formatting seconds (e.g., timer display), use formatTime from utils\n */\nexport function formatTimeHHMM(date: Date | string): string {\n const d = typeof date === \"string\" ? new Date(date) : date;\n return d.toLocaleTimeString([], { hour: \"2-digit\", minute: \"2-digit\" });\n}\n\n/**\n * Format time in short format (12h without seconds)\n * @example formatTimeShort(new Date()) => \"2:30 PM\"\n */\nexport function formatTimeShort(date: Date | string): string {\n const d = typeof date === \"string\" ? new Date(date) : date;\n return d.toLocaleTimeString(\"en-US\", { hour: \"numeric\", minute: \"2-digit\" });\n}\n\n/**\n * Format a Date object for display in readable format\n * @example formatDateDisplay(new Date()) => \"Monday, Dec 22\"\n */\nexport function formatDateDisplay(date: Date): string {\n return date.toLocaleDateString(\"en-US\", {\n weekday: \"long\",\n month: \"short\",\n day: \"numeric\",\n });\n}\n\n/**\n * Format a date/time to HH:MM:SS format\n */\nexport function formatTimeWithSeconds(date: Date | string): string {\n const d = typeof date === \"string\" ? new Date(date) : date;\n return d.toLocaleTimeString([], {\n hour: \"2-digit\",\n minute: \"2-digit\",\n second: \"2-digit\",\n });\n}\n\n// ============================================================================\n// Contextual Formatting\n// ============================================================================\n\n/**\n * Format a date string for display as a header\n * Returns \"Overdue\", \"Today\", \"Tomorrow\", or formatted date\n */\nexport function formatDateHeader(dateStr: string): string {\n const today = getTodayString();\n\n if (dateStr < today) {\n return \"Overdue\";\n }\n\n if (dateStr === today) {\n return \"Today\";\n }\n\n const tomorrowStr = getTomorrowString();\n if (dateStr === tomorrowStr) {\n return \"Tomorrow\";\n }\n\n const date = parseLocalDate(dateStr);\n return date.toLocaleDateString(\"en-US\", {\n weekday: \"long\",\n month: \"short\",\n day: \"numeric\",\n });\n}\n\n/**\n * Format a due date for display in task items (simple string version)\n * Returns \"Overdue\", \"Today\", \"Tomorrow\", or formatted date\n *\n * Note: For version that returns { text, isOverdue }, use formatDueDate from utils/formatters\n */\nexport function formatDueDateString(dateStr: string | null): string {\n if (!dateStr) return \"No due date\";\n\n const today = getTodayString();\n const tomorrowStr = getTomorrowString();\n\n if (dateStr < today) {\n const date = parseLocalDate(dateStr);\n return `Overdue • ${date.toLocaleDateString(\"en-US\", {\n month: \"short\",\n day: \"numeric\",\n })}`;\n }\n\n if (dateStr === today) {\n return \"Today\";\n }\n\n if (dateStr === tomorrowStr) {\n return \"Tomorrow\";\n }\n\n const date = parseLocalDate(dateStr);\n const currentYear = new Date().getFullYear();\n const dateYear = date.getFullYear();\n\n return date.toLocaleDateString(\"en-US\", {\n month: \"short\",\n day: \"numeric\",\n year: dateYear !== currentYear ? \"numeric\" : undefined,\n });\n}\n\n/**\n * Format a date/time as relative time string (extended version)\n * Accepts both Date objects and ISO strings\n * @example \"Just now\", \"5m ago\", \"2h ago\", \"3d ago\"\n *\n * Note: For simple string input, you can also use formatRelativeTime from utils/formatters\n */\nexport function formatRelativeTimeExtended(dateStr: string | Date): string {\n const date = typeof dateStr === \"string\" ? new Date(dateStr) : dateStr;\n const now = new Date();\n const diffMs = now.getTime() - date.getTime();\n const diffMins = Math.floor(diffMs / 60000);\n const diffHours = Math.floor(diffMins / 60);\n const diffDays = Math.floor(diffHours / 24);\n\n if (diffMins < 1) return \"Just now\";\n if (diffMins < 60) return `${diffMins}m ago`;\n if (diffHours < 24) return `${diffHours}h ago`;\n if (diffDays < 7) return `${diffDays}d ago`;\n return date.toLocaleDateString();\n}\n\n/**\n * Format a due date relative to today with contextual prefix\n * @example \"Due today\", \"Due tomorrow\", \"Due in 3 days\", \"2 days overdue\"\n */\nexport function formatRelativeDueDate(\n dateStr: string,\n options?: {\n duePrefix?: string;\n overduePrefix?: string;\n }\n): string {\n const { duePrefix = \"Due\", overduePrefix = \"\" } = options || {};\n const date = parseLocalDate(dateStr);\n const now = normalizeToMidnight(new Date());\n\n const diffMs = date.getTime() - now.getTime();\n const diffDays = Math.round(diffMs / (1000 * 60 * 60 * 24));\n\n if (diffDays < 0) {\n const absDays = Math.abs(diffDays);\n return overduePrefix\n ? `${overduePrefix} ${absDays} day${absDays !== 1 ? \"s\" : \"\"} overdue`\n : `${absDays} day${absDays !== 1 ? \"s\" : \"\"} overdue`;\n }\n if (diffDays === 0) return `${duePrefix} today`;\n if (diffDays === 1) return `${duePrefix} tomorrow`;\n if (diffDays <= 7) return `${duePrefix} in ${diffDays} days`;\n\n return date.toLocaleDateString(\"en-GB\", { day: \"numeric\", month: \"short\" });\n}\n\n/**\n * Format a pay/income date relative to today\n * @example \"Today\", \"Tomorrow\", \"In 3 days\", \"2 days ago\"\n */\nexport function formatRelativePayDate(dateStr: string): string {\n const date = parseLocalDate(dateStr);\n const now = normalizeToMidnight(new Date());\n\n const diffMs = date.getTime() - now.getTime();\n const diffDays = Math.round(diffMs / (1000 * 60 * 60 * 24));\n\n if (diffDays < 0) {\n const absDays = Math.abs(diffDays);\n return `${absDays} day${absDays !== 1 ? \"s\" : \"\"} ago`;\n }\n if (diffDays === 0) return \"Today\";\n if (diffDays === 1) return \"Tomorrow\";\n if (diffDays <= 7) return `In ${diffDays} days`;\n\n return date.toLocaleDateString(\"en-GB\", { day: \"numeric\", month: \"short\" });\n}\n\n// ============================================================================\n// Localized Formatting\n// ============================================================================\n\nexport type DateFormat = \"short\" | \"medium\" | \"long\" | \"weekday\";\nexport type TimeFormat = \"short\" | \"withSeconds\";\n\n/**\n * Format a date with various preset formats\n */\nexport function formatDateLocalized(\n date: Date | string,\n format: DateFormat = \"medium\"\n): string {\n const d = typeof date === \"string\" ? new Date(date) : date;\n\n switch (format) {\n case \"short\":\n return d.toLocaleDateString(\"en-US\", { month: \"short\", day: \"numeric\" });\n case \"medium\":\n return d.toLocaleDateString(\"en-US\", {\n month: \"short\",\n day: \"numeric\",\n year: \"numeric\",\n });\n case \"long\":\n return d.toLocaleDateString(\"en-US\", {\n weekday: \"long\",\n month: \"long\",\n day: \"numeric\",\n year: \"numeric\",\n });\n case \"weekday\":\n return d.toLocaleDateString(\"en-US\", { weekday: \"short\" });\n default:\n return d.toLocaleDateString();\n }\n}\n\n/**\n * Format a time with various preset formats\n */\nexport function formatTimeLocalized(\n date: Date | string,\n format: TimeFormat = \"short\"\n): string {\n const d = typeof date === \"string\" ? new Date(date) : date;\n\n switch (format) {\n case \"short\":\n return d.toLocaleTimeString(\"en-US\", {\n hour: \"2-digit\",\n minute: \"2-digit\",\n hour12: true,\n });\n case \"withSeconds\":\n return d.toLocaleTimeString(\"en-US\", {\n hour: \"2-digit\",\n minute: \"2-digit\",\n second: \"2-digit\",\n hour12: true,\n });\n default:\n return d.toLocaleTimeString();\n }\n}\n"],"mappings":"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","names":["date"]}
|
package/dist/index.d.mts
CHANGED
|
@@ -4,5 +4,5 @@ export { API_URLS, CLOUD_AGENT_STATUSES, CLOUD_AGENT_STATUS_COLORS, CLOUD_AGENT_
|
|
|
4
4
|
export { WeeklyProgressItem, calculateFocusStats, calculateLieuBalance, calculateMonthlyExpenses, calculateMonthlyIncome, calculateMonthlySavings, calculateSavingsRate, calculateWeeklyProgress, formatCurrency, formatDate, formatDueDate, formatDuration, formatRelativeTime, formatTime, formatTotalTime, generateId, generateRandomColor, generateShortId, getFrequencyDescription, getRepoName, isNonEmptyString, isPositiveNumber, isValidCurrency, isValidEmail, isValidFrequency, isValidISODate, isValidUrl, parseFrequencyConfig, shouldDoOnDate, shouldDoToday, stringifyFrequencyConfig, toMonthlyAmount, toYearlyAmount, truncate } from './utils/index.mjs';
|
|
5
5
|
export { QueryKeys, queryKeys } from './query/index.mjs';
|
|
6
6
|
export { ActiveSession, TimerStatus, activeSessionAtom, elapsedSecondsAtom, formattedElapsedAtom, formattedRemainingAtom, progressAtom, progressPercentAtom, remainingSecondsAtom, targetSecondsAtom, timerStatusAtom } from './atoms/index.mjs';
|
|
7
|
-
export { DateFormat, TimeFormat, addDays, formatDateDisplay, formatDateHeader, formatDateLocalized, formatDateLong, formatDateString, formatDueDateString, formatFullDate, formatMonthYear, formatRelativeDueDate, formatRelativePayDate, formatRelativeTimeExtended, formatTimeHHMM, formatTimeLocalized, formatTimeShort, formatTimeWithSeconds, formatWeekRange, getEndOfDayISO, getNextWeek, getPreviousWeek, getStartOfDayISO, getTodayMidnight, getTodayString, getTomorrowString, getWeekEnd, getWeekEndString, getWeekStart, getWeekStartString, getYesterdayString, isDueSoon, isOverdue, isToday, normalizeToMidnight, parseLocalDate, subtractDays } from './date/index.mjs';
|
|
7
|
+
export { DateFormat, TimeFormat, addDays, formatDateDisplay, formatDateHeader, formatDateLocalized, formatDateLong, formatDateString, formatDueDateString, formatFullDate, formatMonthYear, formatRelativeDueDate, formatRelativePayDate, formatRelativeTimeExtended, formatTimeHHMM, formatTimeLocalized, formatTimeShort, formatTimeWithSeconds, formatWeekRange, getEndOfDayISO, getNextWeek, getPreviousWeek, getStartOfDayISO, getTodayMidnight, getTodayString, getTomorrowString, getWeekDates, getWeekDatesAsObjects, getWeekEnd, getWeekEndString, getWeekStart, getWeekStartString, getYesterdayString, isDueSoon, isOverdue, isToday, normalizeToMidnight, parseLocalDate, subtractDays } from './date/index.mjs';
|
|
8
8
|
import 'jotai';
|
package/dist/index.d.ts
CHANGED
|
@@ -4,5 +4,5 @@ export { API_URLS, CLOUD_AGENT_STATUSES, CLOUD_AGENT_STATUS_COLORS, CLOUD_AGENT_
|
|
|
4
4
|
export { WeeklyProgressItem, calculateFocusStats, calculateLieuBalance, calculateMonthlyExpenses, calculateMonthlyIncome, calculateMonthlySavings, calculateSavingsRate, calculateWeeklyProgress, formatCurrency, formatDate, formatDueDate, formatDuration, formatRelativeTime, formatTime, formatTotalTime, generateId, generateRandomColor, generateShortId, getFrequencyDescription, getRepoName, isNonEmptyString, isPositiveNumber, isValidCurrency, isValidEmail, isValidFrequency, isValidISODate, isValidUrl, parseFrequencyConfig, shouldDoOnDate, shouldDoToday, stringifyFrequencyConfig, toMonthlyAmount, toYearlyAmount, truncate } from './utils/index.js';
|
|
5
5
|
export { QueryKeys, queryKeys } from './query/index.js';
|
|
6
6
|
export { ActiveSession, TimerStatus, activeSessionAtom, elapsedSecondsAtom, formattedElapsedAtom, formattedRemainingAtom, progressAtom, progressPercentAtom, remainingSecondsAtom, targetSecondsAtom, timerStatusAtom } from './atoms/index.js';
|
|
7
|
-
export { DateFormat, TimeFormat, addDays, formatDateDisplay, formatDateHeader, formatDateLocalized, formatDateLong, formatDateString, formatDueDateString, formatFullDate, formatMonthYear, formatRelativeDueDate, formatRelativePayDate, formatRelativeTimeExtended, formatTimeHHMM, formatTimeLocalized, formatTimeShort, formatTimeWithSeconds, formatWeekRange, getEndOfDayISO, getNextWeek, getPreviousWeek, getStartOfDayISO, getTodayMidnight, getTodayString, getTomorrowString, getWeekEnd, getWeekEndString, getWeekStart, getWeekStartString, getYesterdayString, isDueSoon, isOverdue, isToday, normalizeToMidnight, parseLocalDate, subtractDays } from './date/index.js';
|
|
7
|
+
export { DateFormat, TimeFormat, addDays, formatDateDisplay, formatDateHeader, formatDateLocalized, formatDateLong, formatDateString, formatDueDateString, formatFullDate, formatMonthYear, formatRelativeDueDate, formatRelativePayDate, formatRelativeTimeExtended, formatTimeHHMM, formatTimeLocalized, formatTimeShort, formatTimeWithSeconds, formatWeekRange, getEndOfDayISO, getNextWeek, getPreviousWeek, getStartOfDayISO, getTodayMidnight, getTodayString, getTomorrowString, getWeekDates, getWeekDatesAsObjects, getWeekEnd, getWeekEndString, getWeekStart, getWeekStartString, getYesterdayString, isDueSoon, isOverdue, isToday, normalizeToMidnight, parseLocalDate, subtractDays } from './date/index.js';
|
|
8
8
|
import 'jotai';
|