mirror of
https://github.com/InvoiceShelf/InvoiceShelf.git
synced 2026-04-15 17:24:10 +00:00
991b716b33
Create the complete TypeScript foundation for the Vue 3 migration in a parallel scripts-v2/ directory. 72 files, 5430 lines, zero any types, strict mode. - types/ (21 files): Domain interfaces for all 17 entities derived from actual Laravel models and API resources. Enums for all statuses. Generic API response wrappers. - api/ (29 files): Typed axios client with interceptors, endpoint constants from routes/api.php, 25 typed service classes covering every API endpoint. - composables/ (14 files): Vue 3 composition functions for auth, notifications, dialogs, modals, pagination, filters, currency, dates, theme, sidebar, company context, and permissions. - utils/ (5 files): Pure typed utilities for money formatting, date formatting (date-fns), localStorage, and error handling. - config/ (3 files): Typed ability constants, app constants. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
93 lines
2.4 KiB
TypeScript
93 lines
2.4 KiB
TypeScript
import {
|
|
formatDate as formatDateUtil,
|
|
relativeTime as relativeTimeUtil,
|
|
parseDate as parseDateUtil,
|
|
DEFAULT_DATE_FORMAT,
|
|
DEFAULT_DATETIME_FORMAT,
|
|
} from '../utils/format-date'
|
|
import type { Locale } from 'date-fns'
|
|
|
|
export interface UseDateReturn {
|
|
formatDate: (
|
|
date: Date | string | number,
|
|
formatStr?: string,
|
|
options?: { locale?: Locale }
|
|
) => string
|
|
formatDateTime: (
|
|
date: Date | string | number,
|
|
options?: { locale?: Locale }
|
|
) => string
|
|
relativeTime: (
|
|
date: Date | string | number,
|
|
options?: { addSuffix?: boolean; locale?: Locale }
|
|
) => string
|
|
parseDate: (date: Date | string | number) => Date | null
|
|
}
|
|
|
|
/**
|
|
* Composable for date formatting and parsing using date-fns.
|
|
* Provides convenient wrappers around utility functions for use within Vue components.
|
|
*/
|
|
export function useDate(): UseDateReturn {
|
|
/**
|
|
* Format a date using a format pattern.
|
|
*
|
|
* @param date - A Date object, ISO string, or timestamp
|
|
* @param formatStr - date-fns format pattern (default: 'yyyy-MM-dd')
|
|
* @param options - Optional locale
|
|
* @returns Formatted date string, or empty string if invalid
|
|
*/
|
|
function formatDate(
|
|
date: Date | string | number,
|
|
formatStr: string = DEFAULT_DATE_FORMAT,
|
|
options?: { locale?: Locale }
|
|
): string {
|
|
return formatDateUtil(date, formatStr, options)
|
|
}
|
|
|
|
/**
|
|
* Format a date with date and time.
|
|
*
|
|
* @param date - A Date object, ISO string, or timestamp
|
|
* @param options - Optional locale
|
|
* @returns Formatted datetime string
|
|
*/
|
|
function formatDateTime(
|
|
date: Date | string | number,
|
|
options?: { locale?: Locale }
|
|
): string {
|
|
return formatDateUtil(date, DEFAULT_DATETIME_FORMAT, options)
|
|
}
|
|
|
|
/**
|
|
* Get a human-readable relative time string (e.g. "3 days ago").
|
|
*
|
|
* @param date - A Date object, ISO string, or timestamp
|
|
* @param options - Optional addSuffix and locale settings
|
|
* @returns Relative time string
|
|
*/
|
|
function relativeTime(
|
|
date: Date | string | number,
|
|
options?: { addSuffix?: boolean; locale?: Locale }
|
|
): string {
|
|
return relativeTimeUtil(date, options)
|
|
}
|
|
|
|
/**
|
|
* Parse a date value into a Date object.
|
|
*
|
|
* @param date - A Date object, ISO string, or timestamp
|
|
* @returns Parsed Date or null
|
|
*/
|
|
function parseDate(date: Date | string | number): Date | null {
|
|
return parseDateUtil(date)
|
|
}
|
|
|
|
return {
|
|
formatDate,
|
|
formatDateTime,
|
|
relativeTime,
|
|
parseDate,
|
|
}
|
|
}
|