add explicit type for string-based datetimes, replacing third-party datetime type with internal DateTime type

src/components/desktop/DateSelect.vue

@@ -44,13 +44,13 @@ import { useI18n } from '@/locales/helpers.ts';
 
 import { useUserStore } from '@/stores/user.ts';
 
-import { type WeekDayValue } from '@/core/datetime.ts';
+import { type TextualYearMonthDay, type WeekDayValue } from '@/core/datetime.ts';
 import { ThemeType } from '@/core/theme.ts';
 import { arrangeArrayWithNewStartIndex } from '@/lib/common.ts';
-import { getCurrentYear } from '@/lib/datetime.ts';
+import { getAllowedYearRange } from '@/lib/datetime.ts';
 
 const props = defineProps<{
-    modelValue?: string;
+    modelValue?: TextualYearMonthDay;
     disabled?: boolean;
     readonly?: boolean;
     clearable?: boolean;
@@ -59,22 +59,19 @@ const props = defineProps<{
 }>();
 
 const emit = defineEmits<{
-    (e: 'update:modelValue', value: string): void;
+    (e: 'update:modelValue', value: TextualYearMonthDay): void;
 }>();
 
 const theme = useTheme();
-const { tt, getAllMinWeekdayNames, getMonthShortName, formatDateToLongDate, isLongDateMonthAfterYear } = useI18n();
+const { tt, getAllMinWeekdayNames, getMonthShortName, formatGregorianCalendarYearDashMonthDashDayToLongDate, isLongDateMonthAfterYear } = useI18n();
 
 const userStore = useUserStore();
 
-const yearRange = ref<number[]>([
-    2000,
-    getCurrentYear() + 1
-]);
+const yearRange = ref<number[]>(getAllowedYearRange());
 
 const dateTime = computed<string>({
     get: () => props.modelValue ?? '',
-    set: (value: string) => emit('update:modelValue', value)
+    set: (value: string) => emit('update:modelValue', value as TextualYearMonthDay)
 });
 
 const isDarkMode = computed<boolean>(() => theme.global.name.value === ThemeType.Dark);
@@ -83,7 +80,7 @@ const dayNames = computed<string[]>(() => arrangeArrayWithNewStartIndex(getAllMi
 const isYearFirst = computed<boolean>(() => isLongDateMonthAfterYear());
 const displayTime = computed<string>(() => {
     if (props.modelValue) {
-        return formatDateToLongDate(props.modelValue);
+        return formatGregorianCalendarYearDashMonthDashDayToLongDate(props.modelValue);
     } else if (props.noDataText) {
         return props.noDataText;
     } else {

src/components/desktop/DateTimeSelect.vue

@@ -105,7 +105,7 @@ import {
     getBrowserTimezoneOffsetMinutes,
     getLocalDatetimeFromUnixTime,
     getActualUnixTimeForStore,
-    getUnixTime,
+    getUnixTimeFromLocalDatetime,
     getAMOrPM,
     getCombinedDateAndTimeValues
 } from '@/lib/datetime.ts';
@@ -154,7 +154,7 @@ const dateTime = computed<Date>({
         return getLocalDatetimeFromUnixTime(props.modelValue);
     },
     set: (value: Date) => {
-        const unixTime = getUnixTime(value);
+        const unixTime = getUnixTimeFromLocalDatetime(value);
 
         if (unixTime < 0) {
             emit('error', 'Date is too early');
@@ -225,7 +225,7 @@ const currentSecond = computed<string>({
 });
 
 const isDarkMode = computed<boolean>(() => theme.global.name.value === ThemeType.Dark);
-const displayTime = computed<string>(() => formatUnixTimeToLongDateTime(getActualUnixTimeForStore(getUnixTime(dateTime.value), getTimezoneOffsetMinutes(), getBrowserTimezoneOffsetMinutes())));
+const displayTime = computed<string>(() => formatUnixTimeToLongDateTime(getActualUnixTimeForStore(getUnixTimeFromLocalDatetime(dateTime.value), getTimezoneOffsetMinutes(), getBrowserTimezoneOffsetMinutes())));
 
 function toggleMeridiemIndicator(): void {
     if (currentMeridiemIndicator.value === MeridiemIndicator.AM.name) {

src/components/desktop/MonthRangeSelectionDialog.vue

@@ -71,6 +71,7 @@ import { useI18n } from '@/locales/helpers.ts';
 import { type CommonMonthRangeSelectionProps, useMonthRangeSelectionBase } from '@/components/base/MonthRangeSelectionBase.ts';
 
 import { ThemeType } from '@/core/theme.ts';
+import { type TextualYearMonth } from '@/core/datetime.ts';
 
 interface DesktopMonthRangeSelectionProps extends CommonMonthRangeSelectionProps {
     persistent?: boolean;
@@ -79,7 +80,7 @@ interface DesktopMonthRangeSelectionProps extends CommonMonthRangeSelectionProps
 const props = defineProps<DesktopMonthRangeSelectionProps>();
 const emit = defineEmits<{
     (e: 'update:show', value: boolean): void;
-    (e: 'dateRange:change', minYearMonth: string, maxYearMonth: string): void;
+    (e: 'dateRange:change', minYearMonth: TextualYearMonth | '', maxYearMonth: TextualYearMonth | ''): void;
     (e: 'error', message: string): void;
 }>();
 

src/components/desktop/MonthSelectionDialog.vue

@@ -50,6 +50,7 @@ import { useI18n } from '@/locales/helpers.ts';
 import { type CommonMonthSelectionProps, useMonthSelectionBase } from '@/components/base/MonthSelectionBase.ts';
 
 import { ThemeType } from '@/core/theme.ts';
+import type { Year0BasedMonth } from '@/core/datetime.ts';
 
 interface DesktopMonthSelectionProps extends CommonMonthSelectionProps {
     persistent?: boolean;
@@ -57,7 +58,7 @@ interface DesktopMonthSelectionProps extends CommonMonthSelectionProps {
 
 const props = defineProps<DesktopMonthSelectionProps>();
 const emit = defineEmits<{
-    (e: 'update:modelValue', value: string): void;
+    (e: 'update:modelValue', value: Year0BasedMonth): void;
     (e: 'update:show', value: boolean): void;
     (e: 'error', message: string): void;
 }>();
@@ -65,7 +66,7 @@ const emit = defineEmits<{
 const theme = useTheme();
 
 const { tt, getMonthShortName } = useI18n();
-const { yearRange, monthValue, isYearFirst, getMonthSelectionValue, getTextualYearMonth } = useMonthSelectionBase(props);
+const { yearRange, monthValue, isYearFirst, getMonthSelectionValue, getYear0BasedMonth } = useMonthSelectionBase(props);
 
 const isDarkMode = computed<boolean>(() => theme.global.name.value === ThemeType.Dark);
 const showState = computed<boolean>({
@@ -75,7 +76,7 @@ const showState = computed<boolean>({
 
 function confirm(): void {
     try {
-        const finalMonthRange = getTextualYearMonth();
+        const finalMonthRange = getYear0BasedMonth();
 
         if (!finalMonthRange) {
             return;