@zvoove/unity-ui 2.36.0 → 2.37.1

package/dist/unity-ui.d.ts

@@ -1019,7 +1019,9 @@ export declare interface DatePickerProps extends Omit<TextFieldProps, 'onChange'
      */
     label: string;
     /**
-     * The value of the date picker.
+     * The value of the date picker. <br />
+     * For `mode="month"`, this must be ISO format: `YYYY-MM` or
+     * `YYYY-MM-DD` (e.g. `"2022-05"`) — the day, if present, is ignored.
      */
     value?: string;
     /**
@@ -1077,15 +1079,31 @@ export declare interface DatePickerProps extends Omit<TextFieldProps, 'onChange'
      * - `week` — a whole ISO 8601 calendar week. The input becomes read-only (the
      *   week can only be chosen from the popup), clicking any day selects its week,
      *   and the selected week is highlighted as a full row.
+     * - `month` — a single month/year pair. The input becomes read-only, and the
+     *   popup shows only a month picker (list or card, per `monthView`) with its
+     *   own year navigation.
      *
      * @default 'date'
      */
-    mode?: 'date' | 'week';
+    mode?: 'date' | 'week' | 'month';
     /**
      * The placeholder shown when `mode="week"` and no week is selected. <br/>
      * If not provided, a locale-aware default is used (e.g. 'KW auswählen' for 'de-DE').
      */
     weekPlaceholder?: string;
+    /**
+     * The placeholder shown when `mode="month"` and no month is selected. <br/>
+     * If not provided, a locale-aware default is used (e.g. 'Monat auswählen' for 'de-DE').
+     */
+    monthPlaceholder?: string;
+    /**
+     * When provided, selecting a month in `mode="month"` calls this callback
+     * with the chosen month/year, as `{ month, year }` where `month` is
+     * 0-indexed (0 = January, 11 = December), matching `Date#getMonth()`.
+     * The dialog closes after selection.
+     * Called with `null` when the selection is cleared via Backspace/Delete.
+     */
+    onMonthChange?: (value: MonthYear | null) => void;
     /**
      * When true, a "KW" column is prepended to the calendar grid showing ISO 8601
      * week numbers. The grid switches from 7 to 8 columns.
@@ -1095,8 +1113,9 @@ export declare interface DatePickerProps extends Omit<TextFieldProps, 'onChange'
      * When provided, clicking any day in a calendar row (or the KW cell) calls this
      * callback with the ISO 8601 week of that row instead of the normal day selection.
      * The dialog closes after selection.
+     * Called with `null` when the selection is cleared via Backspace/Delete.
      */
-    onWeekChange?: (week: IsoWeek) => void;
+    onWeekChange?: (week: IsoWeek | null) => void;
     /**
      * Forces the calendar dialog to open above or below the input.
      * When not set, the dialog auto-detects based on available viewport space.
@@ -1112,6 +1131,15 @@ export declare interface DatePickerProps extends Omit<TextFieldProps, 'onChange'
      * @default 'calendar'
      */
     weekView?: 'calendar' | 'list' | 'strip';
+    /**
+     * Controls how the month picker is presented
+     *
+     * - `list` — scrollable list of month names (default).
+     * - `card` — grid of clickable month options.
+     *
+     * @default 'list'
+     */
+    monthView?: 'list' | 'card';
 }
 
 export declare const DEFAULT_ANNOUNCEMENTS: {
@@ -2574,6 +2602,11 @@ export declare type MidSectionMenusProps<T extends ElementType = 'a'> = {
     onItemClick?: (item: ListMenuItem<T>) => void;
 };
 
+export declare type MonthYear = {
+    month: number;
+    year: number;
+};
+
 declare type NonNullable_2<T> = Exclude<T, null | undefined>;
 export { NonNullable_2 as NonNullable }