vft 0.0.249 → 0.0.252

package/es/components/time-picker/common/props.d.ts

@@ -1,9 +1,10 @@
+import { type __ExtractPublicPropTypes, type Component, type ExtractPropTypes } from 'vue';
 import type { Options } from '@popperjs/core';
 import type { Dayjs } from 'dayjs';
-import type { Component, ExtractPropTypes } from 'vue';
+import type { Placement } from 'vft/es/components/popper';
 export type SingleOrRange<T> = T | [T, T];
 export type DateModelType = number | string | Date;
-export type ModelValueType = SingleOrRange<DateModelType>;
+export type ModelValueType = SingleOrRange<DateModelType> | string[];
 export type DayOrDays = SingleOrRange<Dayjs>;
 export type DateOrDates = SingleOrRange<Date>;
 export type UserInput = SingleOrRange<string | null>;
@@ -24,25 +25,31 @@ export declare const timePickerDefaultProps: {
         __epPropKey: true;
     };
     readonly shortcuts: import("vft/es/utils").EpPropFinalized<ArrayConstructor, unknown, unknown, () => never[], boolean>;
-    readonly arrowControl: import("vft/es/utils").EpPropFinalized<BooleanConstructor, unknown, unknown, false, boolean>;
-    readonly label: import("vft/es/utils").EpPropFinalized<StringConstructor, unknown, unknown, undefined, boolean>;
+    readonly arrowControl: BooleanConstructor;
     readonly tabindex: import("vft/es/utils").EpPropFinalized<(new (...args: any[]) => string | number) | (() => string | number) | (((new (...args: any[]) => string | number) | (() => string | number)) | null)[], unknown, unknown, 0, boolean>;
     readonly validateEvent: import("vft/es/utils").EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
     readonly unlinkPanels: BooleanConstructor;
+    readonly placement: import("vft/es/utils").EpPropFinalized<(new (...args: any[]) => "auto" | "left" | "right" | "bottom" | "top" | "auto-start" | "auto-end" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "right-start" | "right-end" | "left-start" | "left-end") | (() => Placement) | (((new (...args: any[]) => "auto" | "left" | "right" | "bottom" | "top" | "auto-start" | "auto-end" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "right-start" | "right-end" | "left-start" | "left-end") | (() => Placement)) | null)[], Placement, unknown, "bottom", boolean>;
+    readonly fallbackPlacements: import("vft/es/utils").EpPropFinalized<(new (...args: any[]) => Placement[]) | (() => Placement[]) | (((new (...args: any[]) => Placement[]) | (() => Placement[])) | null)[], unknown, unknown, readonly ["bottom", "top", "right", "left"], boolean>;
+    readonly emptyValues: ArrayConstructor;
+    readonly valueOnClear: import("vft/es/utils").EpPropFinalized<readonly [StringConstructor, NumberConstructor, BooleanConstructor, FunctionConstructor], unknown, unknown, undefined, boolean>;
+    readonly ariaLabel: StringConstructor;
+    readonly showNow: import("vft/es/utils").EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+    readonly showWeekNumber: BooleanConstructor;
     readonly disabledHours: {
-        readonly type: import("vue").PropType<import("../props/shared").GetDisabledHours>;
+        readonly type: import("vue").PropType<GetDisabledHours>;
         readonly required: false;
         readonly validator: ((val: unknown) => boolean) | undefined;
         __epPropKey: true;
     };
     readonly disabledMinutes: {
-        readonly type: import("vue").PropType<import("../props/shared").GetDisabledMinutes>;
+        readonly type: import("vue").PropType<GetDisabledMinutes>;
         readonly required: false;
         readonly validator: ((val: unknown) => boolean) | undefined;
         __epPropKey: true;
     };
     readonly disabledSeconds: {
-        readonly type: import("vue").PropType<import("../props/shared").GetDisabledSeconds>;
+        readonly type: import("vue").PropType<GetDisabledSeconds>;
         readonly required: false;
         readonly validator: ((val: unknown) => boolean) | undefined;
         __epPropKey: true;
@@ -53,10 +60,17 @@ export declare const timePickerDefaultProps: {
         readonly validator: ((val: unknown) => boolean) | undefined;
         __epPropKey: true;
     };
-    readonly name: import("vft/es/utils").EpPropFinalized<(new (...args: any[]) => string | [string, string]) | (() => SingleOrRange<string>) | (((new (...args: any[]) => string | [string, string]) | (() => SingleOrRange<string>)) | null)[], unknown, unknown, "", boolean>;
+    readonly name: {
+        readonly type: import("vue").PropType<import("vft/es/utils").EpPropMergeType<(new (...args: any[]) => string | [string, string]) | (() => SingleOrRange<string>) | (((new (...args: any[]) => string | [string, string]) | (() => SingleOrRange<string>)) | null)[], unknown, unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
     readonly popperClass: import("vft/es/utils").EpPropFinalized<StringConstructor, unknown, unknown, "", boolean>;
     readonly format: StringConstructor;
     readonly valueFormat: StringConstructor;
+    readonly dateFormat: StringConstructor;
+    readonly timeFormat: StringConstructor;
     readonly type: import("vft/es/utils").EpPropFinalized<StringConstructor, unknown, unknown, "", boolean>;
     readonly clearable: import("vft/es/utils").EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
     readonly clearIcon: import("vft/es/utils").EpPropFinalized<(new (...args: any[]) => (string | Component) & {}) | (() => string | Component) | (((new (...args: any[]) => (string | Component) & {}) | (() => string | Component)) | null)[], unknown, unknown, "icon-circle-close", boolean>;
@@ -68,11 +82,11 @@ export declare const timePickerDefaultProps: {
         readonly validator: ((val: unknown) => boolean) | undefined;
         __epPropKey: true;
     };
-    readonly readonly: import("vft/es/utils").EpPropFinalized<BooleanConstructor, unknown, unknown, false, boolean>;
-    readonly disabled: import("vft/es/utils").EpPropFinalized<BooleanConstructor, unknown, unknown, false, boolean>;
+    readonly readonly: BooleanConstructor;
+    readonly disabled: BooleanConstructor;
     readonly placeholder: import("vft/es/utils").EpPropFinalized<StringConstructor, unknown, unknown, "", boolean>;
     readonly popperOptions: import("vft/es/utils").EpPropFinalized<(new (...args: any[]) => Partial<Options>) | (() => Partial<Options>) | (((new (...args: any[]) => Partial<Options>) | (() => Partial<Options>)) | null)[], unknown, unknown, () => {}, boolean>;
-    readonly modelValue: import("vft/es/utils").EpPropFinalized<(new (...args: any[]) => string | number | Date | [DateModelType, DateModelType]) | (() => ModelValueType) | (((new (...args: any[]) => string | number | Date | [DateModelType, DateModelType]) | (() => ModelValueType)) | null)[], unknown, unknown, "", boolean>;
+    readonly modelValue: import("vft/es/utils").EpPropFinalized<(new (...args: any[]) => string | number | string[] | Date | [DateModelType, DateModelType]) | (() => ModelValueType) | (((new (...args: any[]) => string | number | string[] | Date | [DateModelType, DateModelType]) | (() => ModelValueType)) | null)[], unknown, unknown, "", boolean>;
     readonly rangeSeparator: import("vft/es/utils").EpPropFinalized<StringConstructor, unknown, unknown, "-", boolean>;
     readonly startPlaceholder: StringConstructor;
     readonly endPlaceholder: StringConstructor;
@@ -88,9 +102,10 @@ export declare const timePickerDefaultProps: {
         readonly validator: ((val: unknown) => boolean) | undefined;
         __epPropKey: true;
     };
-    readonly isRange: import("vft/es/utils").EpPropFinalized<BooleanConstructor, unknown, unknown, false, boolean>;
+    readonly isRange: BooleanConstructor;
 };
 export type TimePickerDefaultProps = ExtractPropTypes<typeof timePickerDefaultProps>;
+export type TimePickerDefaultPropsPublic = __ExtractPublicPropTypes<typeof timePickerDefaultProps>;
 export interface PickerOptions {
     isValidValue: (date: DayOrDays) => boolean;
     handleKeydownInput: (event: KeyboardEvent) => void;
@@ -102,3 +117,52 @@ export interface PickerOptions {
     handleClear: () => void;
     handleFocusPicker?: () => void;
 }
+export declare const timePickerRangeTriggerProps: {
+    readonly id: {
+        readonly type: import("vue").PropType<string[]>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    readonly name: {
+        readonly type: import("vue").PropType<string[]>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    readonly modelValue: {
+        readonly type: import("vue").PropType<import("vft/es/utils").EpPropMergeType<(new (...args: any[]) => string | [string | null, string | null]) | (() => UserInput) | (((new (...args: any[]) => string | [string | null, string | null]) | (() => UserInput)) | null)[], unknown, unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    readonly startPlaceholder: StringConstructor;
+    readonly endPlaceholder: StringConstructor;
+    readonly disabled: BooleanConstructor;
+};
+/**
+ * @deprecated Use `timePickerRangeTriggerProps` instead. This will be removed in future versions.
+ */
+export declare const timePickerRngeTriggerProps: {
+    readonly id: {
+        readonly type: import("vue").PropType<string[]>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    readonly name: {
+        readonly type: import("vue").PropType<string[]>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    readonly modelValue: {
+        readonly type: import("vue").PropType<import("vft/es/utils").EpPropMergeType<(new (...args: any[]) => string | [string | null, string | null]) | (() => UserInput) | (((new (...args: any[]) => string | [string | null, string | null]) | (() => UserInput)) | null)[], unknown, unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    readonly startPlaceholder: StringConstructor;
+    readonly endPlaceholder: StringConstructor;
+    readonly disabled: BooleanConstructor;
+};

package/es/components/time-picker/common/props.js

@@ -1,11 +1,12 @@
-import { componentSizes as t } from "../../../constants/size.js";
+import { placements as a } from "@popperjs/core";
+import { componentSizes as o } from "../../../constants/size.js";
 import "@vueuse/core";
-import "@vft/utils";
+import { isFunction as l } from "@vft/utils";
 import "../../../utils/ns-cover.js";
-import { buildProps as a, definePropType as e } from "../../../utils/vue/props/runtime.js";
+import { buildProps as r, definePropType as e } from "../../../utils/vue/props/runtime.js";
 import "vue";
-import { disabledTimeListsProps as r } from "../props/shared.js";
-const y = a({
+import { disabledTimeListsProps as i } from "../props/shared.js";
+const f = r({
   /**
    * @description same as `id` in native input
    */
@@ -16,8 +17,7 @@ const y = a({
    * @description same as `name` in native input
    */
   name: {
-    type: e([Array, String]),
-    default: ""
+    type: e([Array, String])
   },
   /**
    * @description custom class name for TimePicker's dropdown
@@ -34,6 +34,14 @@ const y = a({
    * @description optional, format of binding value. If not specified, the binding value will be a Date object
    */
   valueFormat: String,
+  /**
+   * @description optional, format of the date displayed value in TimePicker's dropdown
+   */
+  dateFormat: String,
+  /**
+   * @description optional, format of the time displayed value in TimePicker's dropdown
+   */
+  timeFormat: String,
   /**
    * @description type of the picker
    */
@@ -74,23 +82,17 @@ const y = a({
    */
   size: {
     type: String,
-    values: t,
+    values: o,
     required: !1
   },
   /**
    * @description whether TimePicker is read only
    */
-  readonly: {
-    type: Boolean,
-    default: !1
-  },
+  readonly: Boolean,
   /**
    * @description whether TimePicker is disabled
    */
-  disabled: {
-    type: Boolean,
-    default: !1
-  },
+  disabled: Boolean,
   /**
    * @description placeholder in non-range mode
    */
@@ -142,11 +144,8 @@ const y = a({
   /**
    * @description whether to pick a time range
    */
-  isRange: {
-    type: Boolean,
-    default: !1
-  },
-  ...r,
+  isRange: Boolean,
+  ...i,
   /**
    * @description a function determining if a date is disabled with that date as its parameter. Should return a Boolean
    */
@@ -169,17 +168,7 @@ const y = a({
   /**
    * @description whether to pick time using arrow buttons
    */
-  arrowControl: {
-    type: Boolean,
-    default: !1
-  },
-  /**
-   * @description same as `aria-label` in native input
-   */
-  label: {
-    type: String,
-    default: void 0
-  },
+  arrowControl: Boolean,
   /**
    * @description input tabindex
    */
@@ -197,8 +186,62 @@ const y = a({
   /**
    * @description unlink two date-panels in range-picker
    */
-  unlinkPanels: Boolean
-});
+  unlinkPanels: Boolean,
+  /**
+   * @description position of dropdown
+   */
+  placement: {
+    type: e(String),
+    values: a,
+    default: "bottom"
+  },
+  /**
+   * @description list of possible positions for dropdown
+   */
+  fallbackPlacements: {
+    type: e(Array),
+    default: ["bottom", "top", "right", "left"]
+  },
+  /**
+   * @description empty values supported by the component
+   */
+  emptyValues: Array,
+  /**
+   * @description return value when cleared, if you want to set `undefined`, use `() => undefined`
+   */
+  valueOnClear: {
+    type: [String, Number, Boolean, Function],
+    default: void 0,
+    validator: (t) => l(t) ? !t() : !t
+  },
+  ariaLabel: String,
+  /**
+   * @description whether to show the now button
+   */
+  showNow: {
+    type: Boolean,
+    default: !0
+  },
+  /**
+   * @description whether to show the number of the calendar week
+   */
+  showWeekNumber: Boolean
+}), n = r({
+  id: {
+    type: e(Array)
+  },
+  name: {
+    type: e(Array)
+  },
+  modelValue: {
+    type: e([Array, String])
+  },
+  startPlaceholder: String,
+  endPlaceholder: String,
+  disabled: Boolean
+}), S = n;
 export {
-  y as timePickerDefaultProps
+  f as timePickerDefaultProps,
+  n as timePickerRangeTriggerProps,
+  S as timePickerRngeTriggerProps
 };

package/es/components/time-picker/composables/use-time-panel.d.ts

@@ -1,9 +1,9 @@
 import type { Dayjs } from 'dayjs';
-import type { GetDisabledHoursState, GetDisabledMinutesState, GetDisabledSecondsState } from '../types';
+import type { GetDisabledHours, GetDisabledMinutes, GetDisabledSeconds } from '../common/props';
 type UseTimePanelProps = {
-    getAvailableHours: GetDisabledHoursState;
-    getAvailableMinutes: GetDisabledMinutesState;
-    getAvailableSeconds: GetDisabledSecondsState;
+    getAvailableHours: GetDisabledHours;
+    getAvailableMinutes: GetDisabledMinutes;
+    getAvailableSeconds: GetDisabledSeconds;
 };
 export declare const useTimePanel: ({ getAvailableHours, getAvailableMinutes, getAvailableSeconds, }: UseTimePanelProps) => {
     timePickerOptions: Record<string, (...args: any[]) => void>;

package/es/components/time-picker/composables/use-time-picker.d.ts

@@ -1,15 +1,14 @@
 import type { Dayjs } from 'dayjs';
-import type { GetDisabledHours, GetDisabledMinutes, GetDisabledSeconds } from '../props/shared';
-import type { GetDisabledHoursState, GetDisabledMinutesState, GetDisabledSecondsState } from '../types';
+import type { GetDisabledHours, GetDisabledMinutes, GetDisabledSeconds } from '../common/props';
 export declare const getTimeLists: (disabledHours?: GetDisabledHours, disabledMinutes?: GetDisabledMinutes, disabledSeconds?: GetDisabledSeconds) => {
     getHoursList: (role: string, compare?: Dayjs) => boolean[];
     getMinutesList: (hour: number, role: string, compare?: Dayjs) => boolean[];
     getSecondsList: (hour: number, minute: number, role: string, compare?: Dayjs) => boolean[];
 };
 export declare const buildAvailableTimeSlotGetter: (disabledHours: GetDisabledHours, disabledMinutes: GetDisabledMinutes, disabledSeconds: GetDisabledSeconds) => {
-    getAvailableHours: GetDisabledHoursState;
-    getAvailableMinutes: GetDisabledMinutesState;
-    getAvailableSeconds: GetDisabledSecondsState;
+    getAvailableHours: GetDisabledHours;
+    getAvailableMinutes: GetDisabledMinutes;
+    getAvailableSeconds: GetDisabledSeconds;
 };
 export declare const useOldValue: (props: {
     parsedValue?: string | Dayjs | Dayjs[];
@@ -72,18 +71,18 @@ export declare const useOldValue: (props: {
         (): string;
         (preset: string | ILocale, object?: Partial<ILocale>): Dayjs;
     };
-    dayOfYear: {
-        (): number;
-        (value: number): Dayjs;
-    };
-    isSameOrAfter: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
-    isSameOrBefore: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
     localeData: () => import("dayjs").InstanceLocaleDataReturn;
     week: {
         (): number;
         (value: number): Dayjs;
     };
     weekYear: () => number;
+    dayOfYear: {
+        (): number;
+        (value: number): Dayjs;
+    };
+    isSameOrAfter: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
+    isSameOrBefore: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
 } | {
     clone: () => Dayjs;
     isValid: () => boolean;
@@ -142,18 +141,18 @@ export declare const useOldValue: (props: {
         (): string;
         (preset: string | ILocale, object?: Partial<ILocale>): Dayjs;
     };
-    dayOfYear: {
-        (): number;
-        (value: number): Dayjs;
-    };
-    isSameOrAfter: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
-    isSameOrBefore: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
     localeData: () => import("dayjs").InstanceLocaleDataReturn;
     week: {
         (): number;
         (value: number): Dayjs;
     };
     weekYear: () => number;
+    dayOfYear: {
+        (): number;
+        (value: number): Dayjs;
+    };
+    isSameOrAfter: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
+    isSameOrBefore: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
 }[] | undefined, string | Dayjs | Dayjs[] | {
     clone: () => Dayjs;
     isValid: () => boolean;
@@ -212,18 +211,18 @@ export declare const useOldValue: (props: {
         (): string;
         (preset: string | ILocale, object?: Partial<ILocale>): Dayjs;
     };
-    dayOfYear: {
-        (): number;
-        (value: number): Dayjs;
-    };
-    isSameOrAfter: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
-    isSameOrBefore: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
     localeData: () => import("dayjs").InstanceLocaleDataReturn;
     week: {
         (): number;
         (value: number): Dayjs;
     };
     weekYear: () => number;
+    dayOfYear: {
+        (): number;
+        (value: number): Dayjs;
+    };
+    isSameOrAfter: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
+    isSameOrBefore: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
 } | {
     clone: () => Dayjs;
     isValid: () => boolean;
@@ -282,16 +281,16 @@ export declare const useOldValue: (props: {
         (): string;
         (preset: string | ILocale, object?: Partial<ILocale>): Dayjs;
     };
-    dayOfYear: {
-        (): number;
-        (value: number): Dayjs;
-    };
-    isSameOrAfter: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
-    isSameOrBefore: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
     localeData: () => import("dayjs").InstanceLocaleDataReturn;
     week: {
         (): number;
         (value: number): Dayjs;
     };
     weekYear: () => number;
+    dayOfYear: {
+        (): number;
+        (value: number): Dayjs;
+    };
+    isSameOrAfter: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
+    isSameOrBefore: (date?: import("dayjs").ConfigType, unit?: import("dayjs").OpUnitType) => boolean;
 }[] | undefined>;

package/es/components/time-picker/constants.d.ts

@@ -1,4 +1,6 @@
 export declare const timeUnits: readonly ["hours", "minutes", "seconds"];
+export declare const PICKER_BASE_INJECTION_KEY = "EP_PICKER_BASE";
+export declare const PICKER_POPPER_OPTIONS_INJECTION_KEY = "ElPopperOptions";
 export declare const DEFAULT_FORMATS_TIME = "HH:mm:ss";
 export declare const DEFAULT_FORMATS_DATE = "YYYY-MM-DD";
 export declare const DEFAULT_FORMATS_DATEPICKER: {
@@ -6,9 +8,12 @@ export declare const DEFAULT_FORMATS_DATEPICKER: {
     dates: string;
     week: string;
     year: string;
+    years: string;
     month: string;
+    months: string;
     datetime: string;
     monthrange: string;
+    yearrange: string;
     daterange: string;
     datetimerange: string;
 };

package/es/components/time-picker/constants.js

@@ -1,17 +1,22 @@
-const Y = ["hours", "minutes", "seconds"], t = "HH:mm:ss", e = "YYYY-MM-DD", n = {
-  date: e,
-  dates: e,
+const t = ["hours", "minutes", "seconds"], E = "EP_PICKER_BASE", n = "ElPopperOptions", e = "HH:mm:ss", Y = "YYYY-MM-DD", s = {
+  date: Y,
+  dates: Y,
   week: "gggg[w]ww",
   year: "YYYY",
+  years: "YYYY",
   month: "YYYY-MM",
-  datetime: `${e} ${t}`,
+  months: "YYYY-MM",
+  datetime: `${Y} ${e}`,
   monthrange: "YYYY-MM",
-  daterange: e,
-  datetimerange: `${e} ${t}`
+  yearrange: "YYYY",
+  daterange: Y,
+  datetimerange: `${Y} ${e}`
 };
 export {
-  e as DEFAULT_FORMATS_DATE,
-  n as DEFAULT_FORMATS_DATEPICKER,
-  t as DEFAULT_FORMATS_TIME,
-  Y as timeUnits
+  Y as DEFAULT_FORMATS_DATE,
+  s as DEFAULT_FORMATS_DATEPICKER,
+  e as DEFAULT_FORMATS_TIME,
+  E as PICKER_BASE_INJECTION_KEY,
+  n as PICKER_POPPER_OPTIONS_INJECTION_KEY,
+  t as timeUnits
 };