@mantine-vue/dates 3.0.0 → 3.2.0

package/lib/utils/index.d.ts

@@ -0,0 +1,91 @@
+import type { ControlKeydownPayload, DateFormatter, DatePickerType, DatePickerValueType, DatesRangeValue, DateStringValue } from '../types';
+export declare function toDateString(value: Date | string | null | undefined): DateStringValue | null;
+/** Compatibility helper. Date values are already timezone-independent ISO strings in v3. */
+export declare function shiftTimezone<T>(direction: 'add' | 'remove', date: T, timezone?: string): T;
+/** Returns the browser offset for a date; `timezone` is retained for API compatibility. */
+export declare function getTimezoneOffset(date: Date | string, timezone?: string): number;
+export declare function clampDate(date: DateStringValue, minDate?: Date | string, maxDate?: Date | string): string;
+export declare function getDefaultClampedDate({ minDate, maxDate, defaultDate, }?: {
+    minDate?: Date | string;
+    maxDate?: Date | string;
+    defaultDate?: Date | string;
+}): string;
+export declare function assignTime(date: Date | string, time: Date | string): Date;
+export declare function getFormattedDate({ date, format, locale, }: {
+    date: Date | string;
+    format?: string;
+    locale?: string;
+}): string;
+export declare function isSameDate(a: Date | string | null | undefined, b: Date | string | null | undefined): boolean;
+export declare function isSameMonth(a: Date | string, b: Date | string): boolean;
+export declare function isSameYear(a: Date | string, b: Date | string): boolean;
+export declare function getStartOfWeek(date: Date | string, firstDayOfWeek?: number): string;
+export declare function getEndOfWeek(date: Date | string, firstDayOfWeek?: number): string;
+export declare function getWeekNumber(date: Date | string): number;
+export declare function handleControlKeyDown({ rowIndex, cellIndex, event, controlsRef, }: ControlKeydownPayload): void;
+export declare function focusAdjacentControl(refs: (HTMLElement | null | undefined)[][], rowIndex: number, cellIndex: number, direction: 'up' | 'down' | 'left' | 'right'): void;
+export declare function keyToDirection(key: string): 'up' | 'down' | 'left' | 'right' | null;
+export declare function setGridRef(refs: (HTMLElement | null | undefined)[][], rowIndex: number, cellIndex: number, node: any): void;
+export declare function getMonthDays(month: DateStringValue, firstDayOfWeek: number, consistentWeeks?: boolean): string[][];
+export declare function isBeforeMin(date: DateStringValue, minDate?: Date | string): boolean;
+export declare function isAfterMax(date: DateStringValue, maxDate?: Date | string): boolean;
+export declare function getMonthLabel(date: DateStringValue, format?: string, locale?: string): string;
+export declare function getYearRange(date: DateStringValue): string[];
+export declare function getDecadeLabel(date: DateStringValue): string;
+export declare function formatValue(value: DatePickerValueType, type: DatePickerType, format: string, locale?: string, labelSeparator?: string, valueFormatter?: DateFormatter): string;
+export declare function isInRangeGranular(date: DateStringValue, range: [DateStringValue, DateStringValue], unit: 'month' | 'year'): boolean;
+export declare function getNextPickerValue(value: DatePickerValueType, date: DateStringValue, type: DatePickerType, sortDates?: boolean): string | string[] | DatesRangeValue;
+export declare function dateStringParser(value: string, format?: string, locale?: string): string | null;
+export declare function isDateValid({ date, minDate, maxDate, }: {
+    date: string;
+    minDate?: string | Date;
+    maxDate?: string | Date;
+}): boolean;
+export declare function padTime(value: number | string): string;
+export declare function getParsedTime({ time, format, amPmLabels, }: {
+    time: string;
+    format: '12h' | '24h';
+    amPmLabels?: {
+        am: string;
+        pm: string;
+    };
+}): {
+    hours: null;
+    minutes: null;
+    seconds: null;
+    amPm: null;
+} | {
+    hours: number;
+    minutes: number;
+    seconds: number;
+    amPm: string;
+} | {
+    hours: number;
+    minutes: number;
+    seconds: number;
+    amPm: null;
+};
+export declare function getTimeString({ hours, minutes, seconds, format, withSeconds, amPm, amPmLabels, }: {
+    hours: number | null;
+    minutes: number | null;
+    seconds?: number | null;
+    format?: '12h' | '24h';
+    withSeconds?: boolean;
+    amPm?: string | null;
+    amPmLabels?: {
+        am: string;
+        pm: string;
+    };
+}): {
+    valid: boolean;
+    value: string;
+};
+export declare function timeToSeconds(value: string): number;
+export declare function isSameTime(a?: string, b?: string): boolean;
+export declare function compareTime(a: string, b: string): number;
+export declare function clampTime(value: string, min?: string, max?: string): string;
+export declare function getTimeRange(start: string, end: string, step?: number): string[];
+export declare const getFormattedTime: ({ value, format, }: {
+    value: string | Date;
+    format?: string;
+}) => string;

package/lib/utils/use-forwarded-props.d.ts

@@ -0,0 +1,7 @@
+import { type ComputedRef } from 'vue';
+/**
+ * Forwards only props that were actually supplied by the consumer. This is important for
+ * adapter components because Vue casts absent Boolean props to `false`, which must not shadow
+ * defaults owned by the implementation component.
+ */
+export declare function useForwardedProps<Props extends object>(props: Props): ComputedRef<Props>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mantine-vue/dates",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "Vue date and time picker components equivalent to @mantine/dates",
   "license": "MIT",
   "files": [
@@ -40,8 +40,8 @@
     "vue": "^3.5.0"
   },
   "peerDependencies": {
-    "@mantine-vue/core": "3.0.0",
-    "@mantine-vue/hooks": "3.0.0",
+    "@mantine-vue/core": "3.2.0",
+    "@mantine-vue/hooks": "3.2.0",
     "dayjs": ">=1.0.0",
     "vue": "^3.5.0"
   }